Chains ​
Import ​
Import via the '@wagmi/core/chains' entrypoint (proxies all chains from 'viem/chains').
ts
import { mainnet } from '@wagmi/core/chains'import { mainnet } from '@wagmi/core/chains'Available Chains ​
173 Chains
Ethereum
mainnet1 - ETH
Goerli
goerli5 - ETH
OP Mainnet
optimism10 - ETH
Flare Mainnet
flare14 - FLR
Coston
songbirdTestnet16 - CFLR
Songbird Mainnet
songbird19 - SGB
Cronos Mainnet
cronos25 - CRO
Rootstock Mainnet
rootstock30 - RBTC
Telos
telos40 - TLOS
Telos
telosTestnet41 - TLOS
LUKSO
lukso42 - LYX
XinFin Network
xdc50 - XDC
Apothem Network
xdcTestnet51 - TXDC
BNB Smart Chain
bsc56 - BNB
Syscoin Mainnet
syscoin57 - SYS
Ethereum Classic
classic61 - ETC
OKC
okc66 - OKT
Conflux eSpace Testnet
confluxESpaceTestnet71 - CFX
Meter
meter82 - MTR
Meter Testnet
meterTestnet83 - MTR
Binance Smart Chain Testnet
bscTestnet97 - tBNB
Gnosis
gnosis100 - xDAI
Shibarium
shibarium109 - BONE
Coston2
flareTestnet114 - C2FLR
Fuse
fuse122 - FUSE
Fuse Sparknet
fuseSparknet123 - SPARK
Polygon
polygon137 - MATIC
Shimmer
shimmer148 - SMR
Manta Pacific Mainnet
manta169 - ETH
opBNB
opBNB204 - BNB
Nexilix Smart Chain
nexilix240 - NEXILIX
Plinga
plinga242 - PLINGA
Oasys
oasys248 - OAS
Fantom
fantom250 - FTM
Kroma
kroma255 - ETH
zkSync Era Testnet
zkSyncTestnet280 - ETH
Boba Network
boba288 - BOBA
zkSync Sepolia Testnet
zkSyncSepoliaTestnet300 - ETH
Filecoin Mainnet
filecoin314 - FIL
zkSync Era
zkSync324 - ETH
Cronos Testnet
cronosTestnet338 - tCRO
PulseChain
pulsechain369 - PLS
Optimism Goerli
optimismGoerli420 - ETH
PGN
pgn424 - ETH
Rollux Mainnet
rollux570 - SYS
Astar
astar592 - ASTR
Metis Goerli
metisGoerli599 - METIS
Taraxa Mainnet
taraxa841 - TARA
Taraxa Testnet
taraxaTestnet842 - TARA
Wanchain
wanchain888 - WAN
Mode Testnet
modeTestnet919 - ETH
PulseChain V4
pulsechainV4943 - v4PLS
5ireChain Thunder Testnet
thunderTestnet997 - 5IRE
Wanchain Testnet
wanchainTestnet999 - WANt
Zora Goerli Testnet
zoraTestnet999 - ETH
Klaytn Baobab Testnet
klaytnBaobab1001 - KLAY
Ekta Testnet
ektaTestnet1004 - EKTA
Conflux eSpace
confluxESpace1030 - CFX
Bronos Testnet
bronosTestnet1038 - tBRO
Bronos
bronos1039 - BRO
Shimmer Testnet
shimmerTestnet1073 - SMR
Metis
metis1088 - METIS
Polygon zkEVM
polygonZkEvm1101 - ETH
Core Dao
coreDao1116 - CORE
Moonbeam Development Node
moonbeamDev1281 - DEV
Moonbeam
moonbeam1284 - GLMR
Moonriver
moonriver1285 - MOVR
Moonbase Alpha
moonbaseAlpha1287 - DEV
Localhost
localhost1337 - ETH
Polygon zkEVM Testnet
polygonZkEvmTestnet1442 - ETH
Tenet
tenet1559 - TENET
Horizen Gobi Testnet
gobi1663 - tZEN
Ekta
ekta1994 - EKTA
Dogechain
dogechain2000 - DC
Ronin
ronin2020 - RON
Edgeware EdgeEVM Mainnet
edgeware2021 - EDG
Saigon Testnet
saigon2021 - RON
Beresheet BereEVM Testnet
edgewareTestnet2022 - tEDG
Kava EVM Testnet
kavaTestnet2221 - KAVA
Kava EVM
kava2222 - KAVA
Kroma Sepolia
kromaSepolia2358 - ETH
Filecoin Hyperspace
filecoinHyperspace3141 - tFIL
Crossbell
crossbell3737 - CSB
Fantom Testnet
fantomTestnet4002 - FTM
Nexi
nexi4242 - NEXI
IoTeX
iotex4689 - IOTX
IoTeX Testnet
iotexTestnet4690 - IOTX
MEVerse Chain Testnet
mevTestnet4759 - MEV
BlackFort Exchange Network Testnet
bxnTestnet4777 - TBXN
BlackFort Exchange Network
bxn4999 - BXN
Mantle
mantle5000 - MNT
Mantle Testnet
mantleTestnet5001 - MNT
opBNB Testnet
opBNBTestnet5611 - tBNB
Syscoin Tanenbaum Testnet
syscoinTestnet5700 - SYS
ZetaChain Athens Testnet
zetachainAthensTestnet7001 - aZETA
MEVerse Chain Mainnet
mev7518 - MEV
Canto
canto7700 - CANTO
Shardeum Sphinx
shardeumSphinx8082 - SHM
Klaytn
klaytn8217 - KLAY
Base
base8453 - ETH
Evmos Testnet
evmosTestnet9000 - EVMOS
Evmos
evmos9001 - EVMOS
Gnosis Chiado
gnosisChiado10200 - xDAI
HAQQ Mainnet
haqqMainnet11235 - ISLM
Fibo Chain
fibo12306 - FIBO
EOS EVM Testnet
eosTestnet15557 - EOS
Holesky
holesky17000 - ETH
Cannoli
celoCannoli17323 - C-CELO
EOS EVM
eos17777 - EOS
Oasis Sapphire
sapphire23294 - ROSE
Oasis Sapphire Testnet
sapphireTestnet23295 - TEST
Foundry
foundry31337 - ETH
Hardhat
hardhat31337 - ETH
Zilliqa
zilliqa32769 - ZIL
Zilliqa Testnet
zilliqaTestnet33101 - ZIL
Q Mainnet
qMainnet35441 - Q
Q Testnet
qTestnet35443 - Q
Arbitrum One
arbitrum42161 - ETH
Arbitrum Nova
arbitrumNova42170 - ETH
Celo
celo42220 - CELO
Avalanche Fuji
avalancheFuji43113 - AVAX
Avalanche
avalanche43114 - AVAX
Alfajores
celoAlfajores44787 - A-CELO
DFK Chain
dfk53935 - JEWEL
HAQQ Testedge 2
haqqTestedge254211 - ISLMT
Rollux Testnet
rolluxTestnet57000 - SYS
PGN
pgnTestnet58008 - ETH
Linea Goerli Testnet
lineaTestnet59140 - ETH
Linea Mainnet
linea59144 - ETH
Fantom Sonic Open Testnet
fantomSonicTestnet64240 - FTM
Polygon Mumbai
polygonMumbai80001 - MATIC
Base Goerli
baseGoerli84531 - ETH
Base Sepolia
baseSepolia84532 - ETH
Chiliz Spicy Testnet
spicy88882 - CHZ
Chiliz Chain
chiliz88888 - CHZ
Vechain
vechain100009 - VET
Taiko (Alpha-3 Testnet)
taikoTestnetSepolia167005 - ETH
Taiko Jolnir L2
taikoJolnir167007 - ETH
Filecoin Calibration
filecoinCalibration314159 - tFIL
Arbitrum Goerli
arbitrumGoerli421613 - ETH
Arbitrum Sepolia
arbitrumSepolia421614 - ETH
Scroll Sepolia
scrollSepolia534351 - ETH
Scroll
scroll534352 - ETH
Scroll Testnet
scrollTestnet534353 - ETH
Bear Network Chain Mainnet
bearNetworkChainMainnet641230 - BRNKC
Bear Network Chain Testnet
bearNetworkChainTestnet751230 - tBRNKC
Astar zkEVM Testnet zKatana
astarZkatana1261120 - ETH
Zhejiang
zhejiang1337803 - ZhejETH
Manta Pacific Testnet
mantaTestnet3441005 - ETH
Zora
zora7777777 - ETH
Sepolia
sepolia11155111 - SEP
Optimism Sepolia
optimismSepolia11155420 - ETH
Neon EVM DevNet
neonDevnet245022926 - NEON
Neon EVM MainNet
neonMainnet245022934 - NEON
SKALE | Razor Network
skaleRazor278611351 - sFUEL
SKALE | Calypso NFT Hub Testnet
skaleCalypsoTestnet344106930 - sFUEL
SKALE | Block Brawlers
skaleBlockBrawlers391845894 - BRAWL
SKALE | Europa Liquidity Hub Testnet
skaleEuropaTestnet476158412 - sFUEL
SKALE | Nebula Gaming Hub Testnet
skaleNebulaTestnet503129905 - sFUEL
Zora Sepolia
zoraSepolia999999999 - ETH
SKALE | CryptoBlades
skaleCryptoBlades1026062157 - sFUEL
SKALE | Human Protocol
skaleHumanProtocol1273227453 - sFUEL
Aurora
aurora1313161554 - ETH
Aurora Testnet
auroraTestnet1313161555 - ETH
SKALE | Titan Community Hub
skaleTitan1350216234 - sFUEL
SKALE | Chaos Testnet
skaleChaosTestnet1351057110 - sFUEL
SKALE | Nebula Gaming Hub
skaleNebula1482601649 - sFUEL
SKALE | Titan Community Hub Testnet
skaleTitanTestnet1517929550 - sFUEL
SKALE | Calypso NFT Hub
skaleCalypso1564830818 - sFUEL
Harmony One
harmonyOne1666600000 - ONE
SKALE | Crypto Colosseum
skaleCryptoColosseum2046399126 - sFUEL
SKALE | Europa Liquidity Hub
skaleEuropa2046399126 - sFUEL
SKALE | Exorde
skaleExorde2139927552 - sFUEL
Create Chain ​
Import the Chain type from Viem and create a new object that is asserted as const and satisfies the type. You can also use the defineChain function from Viem.
ts
tsimport { typeChain } from 'viem'Âexport constType '{}' does not satisfy the expected type 'Chain'. Type '{}' is missing the following properties from type 'Chain': id, name, nativeCurrency, rpcUrls1360Type '{}' does not satisfy the expected type 'Chain'. Type '{}' is missing the following properties from type 'Chain': id, name, nativeCurrency, rpcUrlsmainnet = {} asconst satisfies Chain
tsimport { typeChain } from 'viem'Âexport constType '{}' does not satisfy the expected type 'Chain'. Type '{}' is missing the following properties from type 'Chain': id, name, nativeCurrency, rpcUrls1360Type '{}' does not satisfy the expected type 'Chain'. Type '{}' is missing the following properties from type 'Chain': id, name, nativeCurrency, rpcUrlsmainnet = {} asconst satisfies Chain
ts
tsimport {defineChain } from 'viem'Âexport constArgument of type '{}' is not assignable to parameter of type 'Chain<ChainFormatters>'. Type '{}' is missing the following properties from type 'Chain<ChainFormatters>': id, name, nativeCurrency, rpcUrls2345Argument of type '{}' is not assignable to parameter of type 'Chain<ChainFormatters>'. Type '{}' is missing the following properties from type 'Chain<ChainFormatters>': id, name, nativeCurrency, rpcUrlsmainnet =defineChain ({} )
tsimport {defineChain } from 'viem'Âexport constArgument of type '{}' is not assignable to parameter of type 'Chain<ChainFormatters>'. Type '{}' is missing the following properties from type 'Chain<ChainFormatters>': id, name, nativeCurrency, rpcUrls2345Argument of type '{}' is not assignable to parameter of type 'Chain<ChainFormatters>'. Type '{}' is missing the following properties from type 'Chain<ChainFormatters>': id, name, nativeCurrency, rpcUrlsmainnet =defineChain ({} )
Now, add the missing required properties to the object until the error goes away.
ts
tsimport { typeChain } from 'viem'Âexport constmainnet = {id : 1,name : 'Ethereum',nativeCurrency : {name : 'Ether',symbol : 'ETH',decimals : 18 },rpcUrls : {default : {http : ['https://cloudflare-eth.com'] },},blockExplorers : {default : {name : 'Etherscan',url : 'https://etherscan.io' },},contracts : {ensRegistry : {address : '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',},ensUniversalResolver : {address : '0xE4Acdd618deED4e6d2f03b9bf62dc6118FC9A4da',blockCreated : 16773775,},multicall3 : {address : '0xca11bde05977b3631167028862be2a173976ca11',blockCreated : 14353601,},},} asconst satisfiesChain
tsimport { typeChain } from 'viem'Âexport constmainnet = {id : 1,name : 'Ethereum',nativeCurrency : {name : 'Ether',symbol : 'ETH',decimals : 18 },rpcUrls : {default : {http : ['https://cloudflare-eth.com'] },},blockExplorers : {default : {name : 'Etherscan',url : 'https://etherscan.io' },},contracts : {ensRegistry : {address : '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',},ensUniversalResolver : {address : '0xE4Acdd618deED4e6d2f03b9bf62dc6118FC9A4da',blockCreated : 16773775,},multicall3 : {address : '0xca11bde05977b3631167028862be2a173976ca11',blockCreated : 14353601,},},} asconst satisfiesChain
ts
tsimport {defineChain } from 'viem'Âexport constmainnet =defineChain ({id : 1,name : 'Ethereum',nativeCurrency : {name : 'Ether',symbol : 'ETH',decimals : 18 },rpcUrls : {default : {http : ['https://cloudflare-eth.com'] },},blockExplorers : {default : {name : 'Etherscan',url : 'https://etherscan.io' },},contracts : {ensRegistry : {address : '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',},ensUniversalResolver : {address : '0xE4Acdd618deED4e6d2f03b9bf62dc6118FC9A4da',blockCreated : 16773775,},multicall3 : {address : '0xca11bde05977b3631167028862be2a173976ca11',blockCreated : 14353601,},},})
tsimport {defineChain } from 'viem'Âexport constmainnet =defineChain ({id : 1,name : 'Ethereum',nativeCurrency : {name : 'Ether',symbol : 'ETH',decimals : 18 },rpcUrls : {default : {http : ['https://cloudflare-eth.com'] },},blockExplorers : {default : {name : 'Etherscan',url : 'https://etherscan.io' },},contracts : {ensRegistry : {address : '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',},ensUniversalResolver : {address : '0xE4Acdd618deED4e6d2f03b9bf62dc6118FC9A4da',blockCreated : 16773775,},multicall3 : {address : '0xca11bde05977b3631167028862be2a173976ca11',blockCreated : 14353601,},},})
The more properties you add, the better the chain will be to use with Wagmi. Most of these attributes exist within the ethereum-lists/chains repository.
id: The chain ID for the network. This can be found by typing the network name into ChainList. Example: "Ethereum Mainnet" has a Chain ID of1.name: Human-readable name for the chain. Example: "Ethereum Mainnet"nativeCurrency: The native currency of the chain. Found fromethereum-lists/chains.rpcUrls: At least one public, credible RPC URL. Found fromethereum-lists/chains.blockExplorers: A set of block explorers for the chain. Found fromethereum-lists/chains.contracts: A set of deployed contracts for the chain. If you are deploying one of the following contracts yourself, make sure it is verified.multicall3is optional, but it's address is most likely0xca11bde05977b3631167028862be2a173976ca11– you can find the deployed block number on the block explorer. Check outmds1/multicallfor more info.ensRegistryis optional – not all Chains have a ENS Registry. See ENS Deployments for more info.ensUniversalResolveris optional – not all Chains have a ENS Universal Resolver.
sourceId: Source Chain ID (e.g. the L1 chain).testnet: Whether or not the chain is a testnet.