/ Docs
7.5
/

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:

dipdup.yaml
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

Warning
We do not recommend any specific node provider. Providers mentioned below were tested with DipDup on a free tier and listed for informational purposes only.

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

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/arbitrum-one
abi.etherscan🟒 workshttps://api.arbiscan.io/api
evm.node🟒 workshttps://arb-mainnet.g.alchemy.com/v2
wss://arb-mainnet.g.alchemy.com/v2

Arbitrum Goerli

datasourcestatusURLs
evm.subsquid⚰️ deprecatedhttps://v2.archive.subsquid.io/network/arbitrum-goerli
abi.etherscan⚰️ deprecated
evm.node⚰️ deprecated

Arbitrum Nova

Explorer: Arbiscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/arbitrum-nova
abi.etherscan🟒 workshttps://api-nova.arbiscan.io/api
evm.nodeπŸ€” WS not testedhttps://nova.arbitrum.io/rpc

Arbitrum Sepolia

Explorer: Arbiscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/arbitrum-sepolia
abi.etherscan🟒 workshttps://api-sepolia.arbiscan.io/api
evm.node🟒 workshttps://arb-sepolia.g.alchemy.com/v2
wss://arb-sepolia.g.alchemy.com/v2

Astar

Astar Mainnet

Explorers: Blockscout, Subscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/astar-mainnet
abi.etherscan🟒 workshttps://astar.blockscout.com/api
evm.node🟑 HTTP onlyhttps://astar-mainnet.g.alchemy.com/v2

Astar zkEVM Mainnet

Explorer: Blockscout

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/astar-zkevm-mainnet
abi.etherscan🟒 workshttps://astar-zkevm.explorer.startale.com/
evm.node🟑 HTTP onlyhttps://rpc.startale.com/astar-zkevm

Astar zKatana

Explorer: Blockscout

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/astar-zkatana
abi.etherscan🟒 workshttps://zkatana.explorer.startale.com/api
evm.node🟑 HTTP onlyhttps://rpc.startale.com/zkatana

Avalanche

Avalanche Mainnet

Explorer: Snowtrace

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/avalanche-mainnet
abi.etherscan🟒 workshttps://api.routescan.io/v2/network/mainnet/evm/43114/etherscan/api
evm.node🟑 HTTP onlyhttps://avalanche-mainnet.infura.io/v3

Avalanche Testnet

Explorer: Snowtrace

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/avalanche-testnet
abi.etherscanπŸ€” not testedhttps://api.routescan.io/v2/network/testnet/evm/43114/etherscan/api
evm.nodeπŸ€” not tested

Base

Base Mainnet

Explorer: Basescan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/base-mainnet
abi.etherscan🟒 workshttps://api.basescan.org/api
evm.node🟑 HTTP onlyhttps://base-mainnet.g.alchemy.com/v2

Base Goerli

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/base-goerli
abi.etherscanπŸ€” not testedhttps://api-goerli.basescan.org/api
evm.nodeπŸ€” not tested

Base Sepolia

Explorer: Basescan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/base-sepolia
abi.etherscanπŸ€” not testedhttps://api-sepolia.basescan.org/api
evm.nodeπŸ€” not tested

Berachain

Berachain Artio

Explorer: Beratrail

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/berachain-artio
abi.etherscan🟒 workshttps://api.routescan.io/v2/network/testnet/evm/80085/etherscan/api
evm.nodeπŸ€” not tested

Binance Smart Chain

Binance Smart Chain Mainnet

Explorer: Bscscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/binance-mainnet
abi.etherscan🟒 workshttps://api.bscscan.com/api
evm.node🟒 workshttps://go.getblock.io/
wss://go.getblock.io/

Binance Smart Chain Testnet

Explorer: Bscscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/binance-testnet
abi.etherscan🟒 workshttps://api-testnet.bscscan.com/api
evm.node🟒 workshttps://go.getblock.io/
wss://go.getblock.io/

Bitgert

Bitgert Mainnet

Explorer: Brisescan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/bitgert-mainnet
abi.etherscan🟒 workshttps://scan.brisescan.com/api
evm.node🟑 HTTP onlyhttps://mainnet-rpc.brisescan.com/

Bitgert Testnet

Explorer: Brisescan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/bitgert-testnet
abi.etherscan🟒 workshttp://testnet-explorer.brisescan.com/api
evm.node🟑 HTTP onlyhttp://testnet-explorer.brisescan.com/api/eth-rpc

Blast

Explorer: Blast Explorer

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/blast-l2-mainnet
abi.etherscan🟒 workshttps://api.routescan.io/v2/network/mainnet/evm/43114/etherscan/api
evm.node🟒 workshttps://rpc.blast.io¹
wss://rpc.blast.io

ΒΉ ratelimited to 10 RPS

DFK Chain

Explorer: Avascan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/dfk-chain
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not tested

Dogechain

Explorers: Dogechain, Blockscout

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/dogechain
abi.etherscanπŸ€” not testedhttps://explorer.dogechain.dog/api
evm.nodeπŸ€” not tested

Ethereum

Ethereum Mainnet

Explorer: Etherscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/ethereum-mainnet
abi.etherscan🟒 workshttps://api.etherscan.io/api
evm.node🟒 workshttps://eth-mainnet.g.alchemy.com/v2
wss://eth-mainnet.g.alchemy.com/v2

Ethereum Goerli

Explorer: Etherscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/ethereum-goerli
abi.etherscanπŸ€” not testedhttps://api-goerli.etherscan.io/api
evm.nodeπŸ€” not tested

Ethereum Holesky

Explorer: Etherscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/ethereum-holesky
abi.etherscanπŸ€” not testedhttps://api-holesky.etherscan.io/api
evm.nodeπŸ€” not tested

Ethereum Sepolia

Explorer: Etherscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/ethereum-sepolia
abi.etherscanπŸ€” not testedhttps://api-sepolia.etherscan.io/api
evm.nodeπŸ€” not tested

Etherlink

Etherlink Testnet

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/etherlink-testnet
abi.etherscanπŸ€” not testedhttps://testnet-explorer.etherlink.com/api
evm.nodeπŸ€” not tested

Exosama

Explorer: Blockscout

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/exosama
abi.etherscanπŸ€” not testedhttps://explorer.exosama.com/api
evm.nodeπŸ€” not tested

Fantom

Fantom Mainnet

Explorer: Ftmscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/fantom-mainnet
abi.etherscan🟒 workshttps://api.ftmscan.com/api
evm.nodeπŸ€” not tested

Fantom Testnet

Explorer: Ftmscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/fantom-testnet
abi.etherscanπŸ€” not testedhttps://api-testnet.ftmscan.com/api
evm.nodeπŸ€” not tested

Flare

Explorer: Flarescan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/flare-mainnet
abi.etherscanπŸ€” not testedhttps://api.routescan.io/v2/network/mainnet/evm/43114/etherscan/api
evm.nodeπŸ€” not tested

Gnosis

Explorer: Gnosisscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/gnosis-mainnet
abi.etherscan🟒 workshttps://api.gnosisscan.io/api
evm.nodeπŸ€” not tested

Immutable zkEVM

Immutable zkEVM Mainnet

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/immutable-zkevm-mainnet
abi.etherscanπŸ€” not testedhttps://explorer.immutable.com/
evm.nodeπŸ€” not tested

Immutable zkEVM Testnet

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/immutable-zkevm-testnet
abi.etherscanπŸ€” not testedhttps://explorer.testnet.immutable.com/api
evm.nodeπŸ€” not tested

Hokum

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ”΄ no APIN/A
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not testedhttps://mainnet.hokum.gg

Karak

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ”΄ no APIN/A
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not testedhttps://rpc.karak.network

Linea

Explorer: Lineascan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/linea-mainnet
abi.etherscan🟒 workshttps://api.lineascan.build/api
evm.node🟒 workshttps://linea-mainnet.infura.io/v3
wss://linea-mainnet.infura.io/ws/v3

Mineplex

Mineplex Testnet

Explorer: Mineplex

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/mineplex-testnet
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not tested

Mode

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ”΄ no APIN/A
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not testedhttps://mainnet.mode.network

Moonbeam

Moonbeam Mainnet

Explorer: Moonscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/moonbeam-mainnet
abi.etherscan🟒 workshttps://api-moonbeam.moonscan.io/api
evm.nodeπŸ€” not tested

Moonbeam Moonbase

Explorer: Moonscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/moonbase-testnet
abi.etherscanπŸ€” not testedhttps://api-moonbase.moonscan.io/api
evm.nodeπŸ€” not tested

Moonriver

Explorer: Moonscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/moonriver-mainnet
abi.etherscanπŸ€” not testedhttps://api-moonriver.moonscan.io/api
evm.nodeπŸ€” not tested

Moonsama

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/moonsama
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not tested

Neon

Neon Devnet

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/neon-devnet
abi.etherscanπŸ€” not testedhttps://neon-devnet.blockscout.com/api
evm.nodeπŸ€” not tested

opBNB

opBNB Mainnet

Explorers: Bscscan, Opbnbscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/opbnb-mainnet
abi.etherscanπŸ€” not testedhttps://api-opbnb.bscscan.com/api
evm.nodeπŸ€” not tested

opBNB Testnet

Explorers: Bscscan, Opbnbscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/opbnb-testnet
abi.etherscanπŸ€” not testedhttps://api-opbnb-testnet.bscscan.com/api
evm.nodeπŸ€” not tested

Optimism

Optimism Mainnet

Explorer: Etherscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/optimism-mainnet
abi.etherscan🟒 workshttps://api-optimistic.etherscan.io/api
evm.node🟒 workshttps://opt-mainnet.g.alchemy.com/v2
wss://opt-mainnet.g.alchemy.com/v2

Optimism Goerli

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/optimism-goerli
abi.etherscanπŸ€” not testedhttps://api-goerli-optimistic.etherscan.io/api
evm.nodeπŸ€” not tested

Optimism Sepolia

Explorer: Etherscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/optimism-sepolia
abi.etherscanπŸ€” not testedhttps://api-sepolia-optimistic.etherscan.io/api
evm.nodeπŸ€” not tested

Polygon

Polygon Mainnet

Explorer: Polygonscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/polygon-mainnet
abi.etherscan🟒 workshttps://api.polygonscan.com/api
evm.node🟒 workshttps://polygon-mainnet.g.alchemy.com/v2
wss://polygon-mainnet.g.alchemy.com/v2

Polygon Mumbai

Explorer: Polygonscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/polygon-mumbai
abi.etherscanπŸ€” not testedhttps://api-testnet.polygonscan.com/api
evm.nodeπŸ€” not tested

Polygon zkEVM

Polygon zkEVM Mainnet

Explorer: Polygonscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/polygon-zkevm-mainnet
abi.etherscan🟒 workshttps://api-zkevm.polygonscan.com/api
evm.node🟑 HTTP onlyhttps://polygonzkevm-mainnet.g.alchemy.com/v2

Polygon zkEVM Testnet

Explorer: Polygonscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/polygon-zkevm-testnet
abi.etherscan🟒 workshttps://api-testnet-zkevm.polygonscan.com/api
evm.nodeπŸ€” not tested

Scroll

Explorer: Scrollscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/scroll-mainnet
abi.etherscan🟒 workshttps://api.scrollscan.com/api
evm.node🟑 HTTP onlyhttps://rpc.scroll.io

Shibuya Testnet

Explorer: Subscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/shibuya-testnet
abi.etherscanπŸ”΄ no APIN/A
evm.nodeπŸ€” not tested

Shiden

Explorer: Subscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/shiden-mainnet
abi.etherscanπŸ”΄ no APIN/A
evm.nodeπŸ€” not tested

Skale Nebula

Explorers: Blockscout, Skalescan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/skale-nebula
abi.etherscan🟒 workshttps://green-giddy-denebola.explorer.mainnet.skalenodes.com/api
evm.node🟒 workshttps://mainnet.skalenodes.com/v1/green-giddy-denebola
wss://mainnet.skalenodes.com/v1/ws/green-giddy-denebola

Taiko Katla

Explorer: Blockscout

datasourcestatusURLs
evm.subsquidπŸ”΄ no APIN/A
abi.etherscan🟒 workshttps://explorer.katla.taiko.xyz/api
evm.node🟑 HTTP onlyhttps://rpc.katla.taiko.xyz

Tanssi

Explorer: Blockscout

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/tanssi
abi.etherscanπŸ€” not testedhttps://3001-blockscout.a.dancebox.tanssi.network/api
evm.nodeπŸ€” not tested

zkSync

See also: RPC Providers | zkSync docs

zkSync Mainnet

Explorer: Zkscan

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/zksync-mainnet
abi.etherscanπŸ€” not testedhttps://block-explorer-api.mainnet.zksync.io/api
evm.nodeπŸ€” not tested

zkSync Sepolia

Explorer: Zkscan

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/zksync-sepolia
abi.etherscanπŸ€” not testedhttps://block-explorer-api.testnet.zksync.io/api
evm.nodeπŸ€” not tested

Zora

Zora Mainnet

Explorer: zora.superscan.network

datasourcestatusURLs
evm.subsquid🟒 workshttps://v2.archive.subsquid.io/network/zora-mainnet
abi.etherscan🟒 workshttps://api.routescan.io/v2/network/mainnet/evm/7777777/etherscan/api
evm.nodeπŸ€” not tested

Zora Goerli

datasourcestatusURLs
evm.subsquidπŸ€” not testedhttps://v2.archive.subsquid.io/network/zora-goerli
abi.etherscanπŸ€” not tested
evm.nodeπŸ€” not tested
Help and tips -> Join our Discord
Ideas or suggestions -> Issue Tracker