DEV Community

Jerome Barton
Jerome Barton

Posted on

What Is Chainlist in Crypto: How Adding a Network Works

Chainlist is a directory of Ethereum Virtual Machine (EVM) networks that gives you the settings a compatible wallet needs to connect to a chain and sends an add-network request for your approval. The Chainlist site is useful background for this process because it pairs network details with the request to add them. Your wallet needs the correct settings to connect to the intended chain; the request alone does not add it.

What Goes Into the Wallet Request

A compatible wallet uses these details to identify a network and communicate with it:

  • Chain ID: the number identifying the chain. Ethereum mainnet uses 1.
  • RPC endpoint: an address the wallet uses to communicate with the chain.
  • Native currency: the coin used to pay transaction fees on that chain.
  • Block explorer: a site where you can look up transactions and addresses.

These details work together. The chain ID tells the wallet which chain it is dealing with, while the RPC endpoint gives it a way to reach that chain. EIP-155 introduced chain IDs for transaction signing, helping distinguish transactions meant for different chains. The currency name and explorer address help the wallet present the network clearly to you.

When you choose to add a network, the directory sends a wallet_addEthereumChain request. That specification covers the request and the wallet’s confirmation: the wallet can accept or reject it, and adding a chain does not necessarily switch your active network.

Arbitrum One and a Request That Seems Stuck

Arbitrum One makes the process concrete. Search for it and you get chain ID 42161, ETH as its native currency, and several RPC endpoints. The ethereum-lists/chains GitHub record also contains those network details. Choosing Add to Wallet asks a connected wallet such as MetaMask to review the addition. Approval puts the network in the wallet’s available networks.

At chainlist.cc, have your compatible wallet ready and know the network name you want to add. The workflow asks the wallet to receive a network request, then asks you to approve it there.

The directory never holds your keys or funds. Adding a network is a settings change in your wallet, not a transfer of crypto. That distinction matters when a button seems to do nothing: the approval may be waiting inside the wallet extension rather than on the page.

Open the extension and look for a pending request. If there is none, connect your wallet and try the add action again. Once approved, select the new network in your wallet if it did not switch automatically; that lets you connect to the chain you meant to use.

Top comments (0)