erpc.yaml

logLevel: debug

database:
  evmJsonRpcCache:
    connectors:
      - id: redis-cache
        driver: redis
        redis:
          addr: $REDIS_ADDR
          password: $REDIS_PASSWORD
          db: 0
          connPoolSize: 128
          initTimeout: 5s
          getTimeout: 1s
          setTimeout: 2s
      - id: postgres-cache
        driver: postgresql
        postgresql:
          connectionUri: $DATABASE_URL
          table: rpc_cache
    policies:
      - network: '*'
        method: '*'
        finality: finalized
        connector: redis-cache
        ttl: 0
      - network: '*'
        method: '*'
        finality: unknown
        connector: redis-cache
        ttl: 5s
      - network: '*' # supports * as wildcard and | as OR operator
        method: 'eth_getLogs|trace_*' # supports * as wildcard and | as OR operator
        finality: finalized
        connector: postgres-cache
        ttl: 0
      - network: 'evm:42161|evm:421614' # supports * as wildcard and | as OR operator
        method: 'arbtrace_*' # supports * as wildcard and | as OR operator
        finality: finalized
        connector: postgres-cache
        ttl: 86400s

server:
  listenV4: true
  httpHostV4: '0.0.0.0'
  listenV6: true
  httpHostV6: '[::]'
  httpPort: 4000
  maxTimeout: 30s
  enableGzip: true
  readTimeout: 10s
  writeTimeout: 20s

metrics:
  enabled: true
  listenV4: true
  hostV4: '0.0.0.0'
  listenV6: true
  hostV6: '[::]'
  port: 4001

projects:
  - id: main
    auth:
      strategies:
        - type: secret
          ignoreMethods:
            - eth_getLogs
            - alchemy_*
            - trace_*
            - debug_*
          secret:
            value: $RPC_API_SECRET
    cors:
      # List of allowed origins. Use ["*"] to allow any origin
      allowedOrigins:
        - '*'
        - 'localhost'
        - 'http://localhost:3000'
        - 'http://localhost:4000'
        - 'http://127.0.0.1:3000'
        - 'http://0.0.0.0:3000'
        - 'http://0.0.0.0:4000'
        - 'https://*.premia.finance'
        - 'https://premia.blue'
        - 'https://*.premia.blue'
        - 'https://archetype.blue'
        - 'https://*.archetype.blue'
        - 'https://kyan.blue'
        - 'https://*.kyan.blue'
        - 'https://kevlar.blue'
        - 'https://*.kevlar.blue'
      allowedMethods:
        - 'GET'
        - 'POST'
        - 'OPTIONS'
      allowedHeaders:
        - '*'
        - 'Content-Type'
        - 'Authorization'
      exposedHeaders:
        - 'X-Request-ID'
      allowCredentials: true
      maxAge: 3600
    networks:
      - architecture: evm
        evm:
          chainId: 42161
        # Refer to "Failsafe" section for more details.
        # On network-level "timeout" is applied for the whole lifecycle of the request (including however many retries)
        failsafe:
          timeout:
            # Network-level timeout applies to the whole lifecycle of the request,
            # this includes retries on network and/or upstream level.
            duration: 30s
          # Defining a "hedge" is highly-recommended on network-level because if upstream A is being slow for
          # a specific request, it can start a new parallel hedged request to upstream B, for whichever responds faster.
          hedge:
            # Recommended: Use quantile-based hedging, e.g. p99:
            quantile: 0.99
            # This fixed-delay is always added to whatever is the quantile-based delay.
            delay: 0ms
            # Minimum delay to wait before trigger next hedge.
            minDelay: 100ms
            # Maximum delay to wait before trigger next hedge.
            maxDelay: 2s
            # Maximum number of hedges to trigger.
            maxCount: 1
          retry:
            # Total retries besides the initial request:
            maxAttempts: 3
            # Min delay between retries:
            delay: 250ms
            # Maximum delay between retries:
            backoffMaxDelay: 5s
            # Multiplier for each retry for exponential backoff:
            backoffFactor: 0.3
            # Random jitter to avoid thundering herd, e.g. add between 0 to 500ms to each retry delay:
            jitter: 50ms

    upstreams:
      - id: envio
        endpoint: envio://rpc.hypersync.xyz
      - id: tenderly-arb-private
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum.gateway.tenderly.co/$TENDERLY_ARB_API_KEY
        ignoreMethods:
          - 'alchemy_*'
        allowMethods:
          - 'tenderly_*'
      - id: tenderly-arb-public
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum.gateway.tenderly.co
        ignoreMethods:
          - 'alchemy_*'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: tenderly-arb-nova-private
        type: evm
        evm:
          chainId: 42170
        endpoint: https://arbitrum-nova.gateway.tenderly.co/$TENDERLY_ARB_NOVA_API_KEY
        ignoreMethods:
          - 'alchemy_*'
        allowMethods:
          - 'tenderly_*'
      - id: tenderly-arb-nova-public
        type: evm
        evm:
          chainId: 42170
        endpoint: https://arbitrum-nova.gateway.tenderly.co
        ignoreMethods:
          - 'alchemy_*'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: tenderly-arb-sepolia-private
        type: evm
        evm:
          chainId: 421614
        endpoint: https://arbitrum-sepolia.gateway.tenderly.co/$TENDERLY_ARB_SEP_API_KEY
        ignoreMethods:
          - 'alchemy_*'
        allowMethods:
          - 'tenderly_*'
      - id: tenderly-arb-sepolia-public
        type: evm
        evm:
          chainId: 421614
        endpoint: https://arbitrum-sepolia.gateway.tenderly.co/
        ignoreMethods:
          - 'alchemy_*'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: alchemy
        endpoint: alchemy://$ALCHEMY_API_KEY
        rateLimitAutoTune:
          enabled: true # Enable auto-tuning (default: true)
          adjustmentPeriod: '1m' # How often to adjust the rate limit (default: "1m")
          errorRateThreshold: 0.1 # Maximum acceptable error rate (default: 0.1)
          increaseFactor: 1.05 # Factor to increase the limit by (default: 1.05)
          decreaseFactor: 0.9 # Factor to decrease the limit by (default: 0.9)
          minBudget: 1 # Minimum rate limit (default: 0)
          maxBudget: 10000
        failsafe:
          timeout:
            duration: 15s
          retry:
            maxAttempts: 2
            delay: 1000ms
            backoffMaxDelay: 10s
            backoffFactor: 0.3
            jitter: 500ms
      - id: infura
        endpoint: infura://$INFURA_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: onerpc-arb-private
        type: evm
        evm:
          chainId: 42161
        endpoint: https://1rpc.io/$ONERPC_API_KEY/arb
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: onerpc-eth-holesky-public
        type: evm
        evm:
          chainId: 17000
        endpoint: https://1rpc.io/holesky
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: onerpc-eth-sepolia-public
        type: evm
        evm:
          chainId: 11155111
        endpoint: https://1rpc.io/sepolia
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: onerpc-arb-public
        type: evm
        evm:
          chainId: 42161
        endpoint: https://1rpc.io/arb
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: onerpc-eth-public
        type: evm
        evm:
          chainId: 1
        endpoint: https://1rpc.io/eth
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: llama-arb-private
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum.llamarpc.com/$LLAMA_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: llama-eth-private
        type: evm
        evm:
          chainId: 1
        endpoint: https://eth.llamarpc.com/$LLAMA_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: llama-eth-public
        type: evm
        evm:
          chainId: 1
        endpoint: https://eth.llamarpc.com
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: llama-arb-public
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum.llamarpc.com
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: chainstack-arb
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum-mainnet.core.chainstack.com/$CS_ARB_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: chainstack-eth
        type: evm
        evm:
          chainId: 1
        endpoint: https://ethereum-mainnet.core.chainstack.com/$CS_ETH_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: moralis-arb-one
        type: evm
        evm:
          chainId: 42161
        endpoint: https://site1.moralis-nodes.com/arbitrum/$MORALIS_ARB_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: moralis-arb-sep
        type: evm
        evm:
          chainId: 421614
        endpoint: https://site1.moralis-nodes.com/arbitrum-sepolia/$MORALIS_ARBSEP_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: moralis-arb-backup
        type: evm
        evm:
          chainId: 42161
        endpoint: https://site2.moralis-nodes.com/arbitrum/$MORALIS_ARB_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: moralis-arb-sep-backup
        type: evm
        evm:
          chainId: 421614
        endpoint: https://site2.moralis-nodes.com/arbitrum-sepolia/$MORALIS_ARBSEP_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: chainstack-arb-backup
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum-mainnet.core.chainstack.com/$CS_ARB2_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: chainstack-arb-test
        type: evm
        evm:
          chainId: 42161
        endpoint: https://arbitrum-sepolia.core.chainstack.com/$CS_ARB_API_KEY_TEST
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: chainstack-arb-sep-test
        type: evm
        evm:
          chainId: 421614
        endpoint: https://arbitrum-sepolia.core.chainstack.com/$CS_ARBSEP_API_KEY_TEST
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-arb-sep
        type: evm
        evm:
          chainId: 421614
        endpoint: https://ancient-wild-surf.arbitrum-sepolia.quiknode.pro/$QN_ARBSEP_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-arb
        type: evm
        evm:
          chainId: 42161
        endpoint: https://wandering-shy-mansion.arbitrum-mainnet.quiknode.pro/$QN_ARB_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-arb-nova
        type: evm
        evm:
          chainId: 42170
        endpoint: https://wispy-alien-cloud.nova-mainnet.quiknode.pro/$QN_ARB_NOVA_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-eth-holesky
        type: evm
        evm:
          chainId: 17000
        endpoint: https://side-silent-tab.ethereum-holesky.quiknode.pro/$QN_ETH_HOLESKY_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-eth-mainnet
        type: evm
        evm:
          chainId: 1
        endpoint: https://bold-palpable-wave.quiknode.pro/$QN_ETH_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: quicknode-eth-sepolia
        type: evm
        evm:
          chainId: 1
        endpoint: https://blue-proportionate-mansion.ethereum-sepolia.quiknode.pro/$QN_ETH_SEP_API_KEY
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
      - id: drpc-eth-sep
        type: evm
        evm:
          chainId: 11155111
        endpoint: https://sepolia.drpc.org
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: drpc-eth-holesky
        type: evm
        evm:
          chainId: 17000
        endpoint: https://holesky.drpc.org
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: panda-eth-sep
        type: evm
        evm:
          chainId: 11155111
        endpoint: https://rpc.sepolia.ethpandaops.io
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
      - id: offchain-arb-nova
        type: evm
        evm:
          chainId: 42170
        endpoint: https://nova.arbitrum.io/rpc
        ignoreMethods:
          - 'alchemy_*'
          - 'trace_*'
          - 'eth_traceTransaction'
        failsafe:
          circuitBreaker:
            # e.g. if 30 requests have failed out of last 100 requests, circuit breaker on:
            failureThresholdCount: 5
            failureThresholdCapacity: 100
            # How long to wait before trying to re-enable the upstream after circuit breaker was opened.
            halfOpenAfter: 60s
            # e.g. after 8/10 requests have succeeded, kill circuit breaker:
            successThresholdCount: 8
            successThresholdCapacity: 10
# Rate limiter allows you to create "shared" budgets for upstreams.
# For example upstream A and B can use the same budget, which means both of them together must not exceed the defined limits.
# rateLimiters:
#   budgets:
#     - id: default-budget
#       rules:
#         - method: "*"
#           maxCount: 10000
#           period: 1s
#     - id: global-blast
#       rules:
#         - method: "*"
#           maxCount: 1000
#           period: 1s
#     - id: global-quicknode
#       rules:
#         - method: "*"
#           maxCount: 300
#           period: 1s
#     - id: frontend-budget
#       rules:
#         - method: "*"
#           maxCount: 500
#           period: 1s