This document outlines how configuring RPCs works, either through RPC providers, or custom RPCs.
Two RPC providers are currently supported: Infura and Alchemy.
Selecting which one to use is done via the following environment variable:
NEXT_PUBLIC_RPC_PROVIDER
The accepted values (case insensitive) are infura
and alchemy
. The default is infura
.
The Infura key is provided through the following environment variable:
NEXT_PUBLIC_INFURA_KEY
The key will be used for all chains. However, if you need to have different keys for each chain, you can do so through the following environment variables:
NEXT_PUBLIC_INFURA_KEY_ETHEREUM
NEXT_PUBLIC_INFURA_KEY_SEPOLIA
NEXT_PUBLIC_INFURA_KEY_HOLESKY
NEXT_PUBLIC_INFURA_KEY_ARBITRUM_ONE
NEXT_PUBLIC_INFURA_KEY_BASE
NEXT_PUBLIC_INFURA_KEY_ARBITRUM_SEPOLIA
NEXT_PUBLIC_INFURA_KEY_BASE_SEPOLIA
Note
Arbitrum Nova is currently not supported on Infura, so the public RPC will be used instead.
The Alchemy key is provided through the following environment variable:
NEXT_PUBLIC_ALCHEMY_KEY
The key will be used for all chains.
If you need to override the RPC for a chain, you can do so through the following environment variables:
NEXT_PUBLIC_RPC_URL_ETHEREUM
NEXT_PUBLIC_RPC_URL_SEPOLIA
NEXT_PUBLIC_RPC_URL_HOLESKY
NEXT_PUBLIC_RPC_URL_ARBITRUM_ONE
NEXT_PUBLIC_RPC_URL_ARBITRUM_NOVA
NEXT_PUBLIC_RPC_URL_BASE
NEXT_PUBLIC_RPC_URL_ARBITRUM_SEPOLIA
NEXT_PUBLIC_RPC_URL_BASE_SEPOLIA
For Nitro Testnode chains:
NEXT_PUBLIC_RPC_URL_NITRO_TESTNODE_L1
NEXT_PUBLIC_RPC_URL_NITRO_TESTNODE_L2
NEXT_PUBLIC_RPC_URL_NITRO_TESTNODE_L3