EVM networks

DipDup can index any EVM-compatible network as long as there's enough historical data. This page contains a list of supported networks and instructions on how to configure your indexer for them.

Configuring datasources

If you've created a new project using dipdup new command and used one of the EVM templates, datasources section in your config file should look like this:

datasources:
  subsquid:
    kind: evm.subsquid
    url: ${SUBSQUID_URL:-https://v2.archive.subsquid.io/network/ethereum-mainnet}
    node: evm_node
  etherscan:
    kind: abi.etherscan
    url: ${ETHERSCAN_URL:-https://api.etherscan.io/api}
    api_key: ${ETHERSCAN_API_KEY:-''}
  evm_node:
    kind: evm.node
    url: ${NODE_URL:-https://eth-mainnet.g.alchemy.com/v2}/${NODE_API_KEY:-''}
    ws_url: ${NODE_WS_URL:-wss://eth-mainnet.g.alchemy.com/v2}/${NODE_API_KEY:-''}

To configure datasources for other networks, you need to change URLs and API keys. You can do it in the config file directly, but it's better to use environment variables. Check the deploy/.env.default file in your project directory; it contains all the variables used in config.

evm.subsquid - Subsquid Network is the main source of historical data for EVM-compatible networks. It's free and available for many networks.

abi.etherscan - Etherscan is a source of contract ABIs, which are used to generate types for the indexer. Many explorers have Etherscan-like API which could be used to retrieve ABIs. Some of them require an API key, which you can get on their website. If there's no Etherscan-like API available, you need to obtain contract ABI JSON somewhere and put it to the abi/<typename>/abi.json path. Don't forget to run dipdup init after that to generate all necessary types.

evm.node - EVM node datasource can be used to fetch recent data not yet in Subsquid Network. API methods could vary a lot across different networks, but DipDup only uses a few of them, so most of the nodes will work. WebSocket URL can be specified to get real-time updates. This option can save you some requests to the node, but otherwise, it's not required. If Subsquid for your network is not available yet, you can use this datasource to fetch historical data, but it's significantly slower.

Supported networks

Updated 2024-03-20.

We aim to support all EVM-compatible networks available in Subsquid Network, and several other networks in node-only mode.

If you want to share your test results or something on this page is missing or wrong, please open an issue on GitHub.

Arbitrum

See also: RPC endpoints and providers | Arbitrum Docs

Arbitrum One

Explorer: Arbiscan

Arbitrum Goerli

Arbitrum Nova

Explorer: Arbiscan

Arbitrum Sepolia

Explorer: Arbiscan

Astar

Astar Mainnet

Explorers: Blockscout, Subscan

Astar zkEVM Mainnet

Explorer: Blockscout

Astar zKatana

Explorer: Blockscout

Avalanche

Avalanche Mainnet

Explorer: Snowtrace

Avalanche Testnet

Explorer: Snowtrace

Base

Base Mainnet

Explorer: Basescan

Base Goerli

Base Sepolia

Explorer: Basescan

Berachain

Berachain Artio

Explorer: Beratrail

Binance Smart Chain

Binance Smart Chain Mainnet

Explorer: Bscscan

Binance Smart Chain Testnet

Explorer: Bscscan

Bitgert

Bitgert Mainnet

Explorer: Brisescan

Bitgert Testnet

Explorer: Brisescan

Blast

Explorer: Blast Explorer

^{¹ ratelimited to 10 RPS}

DFK Chain

Explorer: Avascan

Dogechain

Explorers: Dogechain, Blockscout

Ethereum

Ethereum Mainnet

Explorer: Etherscan

Ethereum Goerli

Explorer: Etherscan

Ethereum Holesky

Explorer: Etherscan

Ethereum Sepolia

Explorer: Etherscan

Etherlink

Etherlink Testnet

Explorer: Blockscout

Exosama

Explorer: Blockscout

Fantom

Fantom Mainnet

Explorer: Ftmscan

Fantom Testnet

Explorer: Ftmscan

Flare

Explorer: Flarescan

Gnosis

Explorer: Gnosisscan

Immutable zkEVM

Immutable zkEVM Mainnet

Explorer: Blockscout

Immutable zkEVM Testnet

Explorer: Blockscout

Hokum

Explorer: Blockscout

Karak

Explorer: Blockscout

Linea

Explorer: Lineascan

Mineplex

Mineplex Testnet

Explorer: Mineplex

Mode

Explorer: Blockscout

Moonbeam

Moonbeam Mainnet

Explorer: Moonscan

Moonbeam Moonbase

Explorer: Moonscan

Moonriver

Explorer: Moonscan

Moonsama

Neon

Neon Devnet

Explorer: Blockscout

opBNB

opBNB Mainnet

Explorers: Bscscan, Opbnbscan

opBNB Testnet

Explorers: Bscscan, Opbnbscan

Optimism

Optimism Mainnet

Explorer: Etherscan

Optimism Goerli

Optimism Sepolia

Explorer: Etherscan

Polygon

Polygon Mainnet

Explorer: Polygonscan

Polygon Mumbai

Explorer: Polygonscan

Polygon zkEVM

Polygon zkEVM Mainnet

Explorer: Polygonscan

Polygon zkEVM Testnet

Explorer: Polygonscan

Scroll

Explorer: Scrollscan

Shibuya Testnet

Explorer: Subscan

Shiden

Explorer: Subscan

Skale Nebula

Explorers: Blockscout, Skalescan

Taiko Katla

Explorer: Blockscout

Tanssi

Explorer: Blockscout

zkSync

See also: RPC Providers | zkSync docs

zkSync Mainnet

Explorer: Zkscan

zkSync Sepolia

Explorer: Zkscan

Zora

Zora Mainnet

Explorer: zora.superscan.network

Zora Goerli