Chains

Viem Chain objects. More info at the Viem docs.

Import

Import via the 'wagmi/chains' entrypoint (proxies all chains from 'viem/chains').

import { mainnet } from 'wagmi/chains'

Available Chains

Chain definitions as of viem@2.21.28. For viem@latest, visit the Viem repo.

266 Chains

Ethereum

mainnet

1 - ETH

Goerli

goerli

5 - ETH

OP Mainnet

optimism

10 - ETH

Flare Mainnet

flare

14 - FLR

Coston

songbirdTestnet

16 - CFLR

Songbird Mainnet

songbird

19 - SGB

Cronos Mainnet

cronos

25 - CRO

Rootstock Mainnet

rootstock

30 - RBTC

Rootstock Testnet

rootstockTestnet

31 - tRBTC

Telos

telos

40 - TLOS

Telos

telosTestnet

41 - TLOS

LUKSO

lukso

42 - LYX

Darwinia Network

darwinia

46 - RING

XinFin Network

xdc

50 - XDC

Apothem Network

xdcTestnet

51 - TXDC

BNB Smart Chain

bsc

56 - BNB

Syscoin Mainnet

syscoin

57 - SYS

Ethereum Classic

classic

61 - ETC

OKC

okc

66 - OKT

Conflux eSpace Testnet

confluxESpaceTestnet

71 - CFX

Meter

meter

82 - MTR

Meter Testnet

meterTestnet

83 - MTR

Binance Smart Chain Testnet

bscTestnet

97 - tBNB

Gnosis

gnosis

100 - xDAI

Shibarium

shibarium

109 - BONE

Coston2

flareTestnet

114 - C2FLR

Fuse

fuse

122 - FUSE

Fuse Sparknet

fuseSparknet

123 - SPARK

Polygon

polygon

137 - MATIC

Shimmer

shimmer

148 - SMR

Manta Pacific Mainnet

manta

169 - ETH

X1 Testnet

x1Testnet

195 - OKB

X1 Testnet

xLayerTestnet

195 - OKB

X Layer Mainnet

xLayer

196 - OKB

BitTorrent

bitTorrent

199 - BTT

Edgeless Testnet

edgelessTestnet

202 - EwETH

opBNB

opBNB

204 - BNB

Nexilix Smart Chain

nexilix

240 - NEXILIX

Plinga

plinga

242 - PLINGA

Oasys

oasys

248 - OAS

Fantom

fantom

250 - FTM

Fraxtal

fraxtal

252 - frxETH

Kroma

kroma

255 - ETH

zkSync InMemory Node

zkSyncInMemoryNode

260 - ETH

zkSync CLI Local Node

zkSyncLocalNode

270 - ETH

zkSync Era Testnet

zkSyncTestnet

280 - ETH

Boba Network

boba

288 - ETH

Hedera Mainnet

hedera

295 - HBAR

Hedera Testnet

hederaTestnet

296 - HBAR

Hedera Previewnet

hederaPreviewnet

297 - HBAR

zkSync Sepolia Testnet

zkSyncSepoliaTestnet

300 - ETH

Filecoin Mainnet

filecoin

314 - FIL

KCC Mainnet

kcc

321 - KCS

zkSync Era

zkSync

324 - ETH

Cronos Testnet

cronosTestnet

338 - tCRO

PulseChain

pulsechain

369 - PLS

Optimism Goerli

optimismGoerli

420 - ETH

PGN

pgn

424 - ETH

Areon Network Testnet

areonNetworkTestnet

462 - TAREA

Areon Network

areonNetwork

463 - AREA

FlowEVM Testnet

flowTestnet

545 - FLOW

Rollux Mainnet

rollux

570 - SYS

MetaChain Mainnet

metachain

571 - MTC

Astar

astar

592 - ASTR

Mandala TC9

mandala

595 - mACA

Metis Goerli

metisGoerli

599 - METIS

FlowEVM Previewnet

flowPreviewnet

646 - FLOW

Karura

karura

686 - KAR

FlowEVM Mainnet

flowMainnet

747 - FLOW

Acala

acala

787 - ACA

Taraxa Mainnet

taraxa

841 - TARA

Taraxa Testnet

taraxaTestnet

842 - TARA

Wanchain

wanchain

888 - WAN

Mode Testnet

modeTestnet

919 - ETH

PulseChain V4

pulsechainV4

943 - v4PLS

5ireChain Thunder Testnet

thunderTestnet

997 - 5IRE

Wanchain Testnet

wanchainTestnet

999 - WANt

Zora Goerli Testnet

zoraTestnet

999 - ETH

Klaytn Baobab Testnet

klaytnBaobab

1001 - KLAY

Ekta Testnet

ektaTestnet

1004 - EKTA

BNB Greenfield Chain

bscGreenfield

1017 - BNB

BitTorrent Chain Testnet

bitTorrentTestnet

1028 - BTT

Conflux eSpace

confluxESpace

1030 - CFX

Bronos Testnet

bronosTestnet

1038 - tBRO

Bronos

bronos

1039 - BRO

Shimmer Testnet

shimmerTestnet

1073 - SMR

Metis

metis

1088 - METIS

Polygon zkEVM

polygonZkEvm

1101 - ETH

WEMIX

wemix

1111 - WEMIX

WEMIX Testnet

wemixTestnet

1112 - tWEMIX

Core Dao

coreDao

1116 - CORE

DeFiChain EVM Mainnet

defichainEvm

1130 - DFI

DeFiChain EVM Testnet

defichainEvmTestnet

1131 - DFI

Moonbeam Development Node

moonbeamDev

1281 - DEV

Moonbeam

moonbeam

1284 - GLMR

Moonriver

moonriver

1285 - MOVR

Moonbase Alpha

moonbaseAlpha

1287 - DEV

Localhost

localhost

1337 - ETH

Polygon zkEVM Testnet

polygonZkEvmTestnet

1442 - ETH

MetaChain Istanbul

metachainIstanbul

1453 - MTC

Tenet

tenet

1559 - TENET

Horizen Gobi Testnet

gobi

1663 - tZEN

Mint Sepolia Testnet

mintSepoliaTestnet

1686 - ETH

Reya Network

reyaNetwork

1729 - ETH

LightLink Phoenix Mainnet

lightlinkPhoenix

1890 - ETH

LightLink Pegasus Testnet

lightlinkPegasus

1891 - ETH

Ekta

ekta

1994 - EKTA

Dogechain

dogechain

2000 - DC

Telcoin Adiri Testnet

telcoinTestnet

2017 - TEL

Ronin

ronin

2020 - RON

Edgeware EdgeEVM Mainnet

edgeware

2021 - EDG

Saigon Testnet

saigon

2021 - RON

Beresheet BereEVM Testnet

edgewareTestnet

2022 - tEDG

Edgeless Network

edgeless

2026 - EwETH

Kava EVM Testnet

kavaTestnet

2221 - KAVA

Kava EVM

kava

2222 - KAVA

RSS3 VSL Sepolia Testnet

rss3Sepolia

2331 - RSS3

Kroma Sepolia

kromaSepolia

2358 - ETH

Polygon zkEVM Cardona

polygonZkEvmCardona

2442 - ETH

Fraxtal Testnet

fraxtalTestnet

2522 - frxETH

inEVM Mainnet

inEVM

2525 - INJ

Morph Sepolia

morphSepolia

2710 - ETH

Filecoin Hyperspace

filecoinHyperspace

3141 - tFIL

Crossbell

crossbell

3737 - CSB

Astar zkEVM

astarZkEVM

3776 - ETH

APEX Testnet

apexTestnet

3993 - ETH

Fantom Testnet

fantomTestnet

4002 - FTM

Oasis Testnet

oasisTestnet

4090 - FTN

Merlin

merlin

4200 - BTC

LUKSO Testnet

luksoTestnet

4201 - LYXt

Lisk Sepolia

liskSepolia

4202 - ETH

Nexi

nexi

4242 - NEXI

Beam

beam

4337 - BEAM

IoTeX

iotex

4689 - IOTX

IoTeX Testnet

iotexTestnet

4690 - IOTX

MEVerse Chain Testnet

mevTestnet

4759 - MEV

BlackFort Exchange Network Testnet

bxnTestnet

4777 - TBXN

BlackFort Exchange Network

bxn

4999 - BXN

Mantle

mantle

5000 - MNT

Mantle Testnet

mantleTestnet

5001 - MNT

Mantle Sepolia Testnet

mantleSepoliaTestnet

5003 - MNT

Bahamut

bahamut

5165 - FTN

opBNB Testnet

opBNBTestnet

5611 - tBNB

Syscoin Tanenbaum Testnet

syscoinTestnet

5700 - SYS

ZetaChain

zetachain

7000 - ZETA

ZetaChain Athens Testnet

zetachainAthensTestnet

7001 - aZETA

Horizen EON

eon

7332 - ZEN

MEVerse Chain Mainnet

mev

7518 - MEV

Cyber

cyber

7560 - ETH

Canto

canto

7700 - CANTO

Shardeum Sphinx

shardeumSphinx

8082 - SHM

Klaytn

klaytn

8217 - KLAY

Base

base

8453 - ETH

JIBCHAIN L1

jbc

8899 - JBC

Evmos Testnet

evmosTestnet

9000 - EVMOS

Evmos

evmos

9001 - EVMOS

OORT MainnetDev

oortMainnetDev

9700 - OORT

Gnosis Chiado

gnosisChiado

10200 - xDAI

HAQQ Mainnet

haqqMainnet

11235 - ISLM

BEVM Mainnet

bevmMainnet

11501 - BTC

Fibo Chain

fibo

12306 - FIBO

RSS3 VSL Mainnet

rss3

12553 - RSS3

Beam Testnet

beamTestnet

13337 - BEAM

Immutable zkEVM

immutableZkEvm

13371 - IMX

Phoenix Blockchain

phoenix

13381 - PHX

Immutable zkEVM Testnet

immutableZkEvmTestnet

13473 - IMX

EOS EVM Testnet

eosTestnet

15557 - EOS

Holesky

holesky

17000 - ETH

EOS EVM

eos

17777 - EOS

Oasis Sapphire

sapphire

23294 - ROSE

Oasis Sapphire Testnet

sapphireTestnet

23295 - TEST

DreyerX Mainnet

dreyerxMainnet

23451 - DRX

Anvil

anvil

31337 - ETH

Foundry

foundry

31337 - ETH

Hardhat

hardhat

31337 - ETH

Zilliqa

zilliqa

32769 - ZIL

Zilliqa Testnet

zilliqaTestnet

33101 - ZIL

Mode Mainnet

mode

34443 - ETH

Q Mainnet

qMainnet

35441 - Q

Q Testnet

qTestnet

35443 - Q

Arbitrum One

arbitrum

42161 - ETH

Arbitrum Nova

arbitrumNova

42170 - ETH

Celo

celo

42220 - CELO

ZKFair Mainnet

zkFair

42766 - USDC

Avalanche Fuji

avalancheFuji

43113 - AVAX

Avalanche

avalanche

43114 - AVAX

ZKFair Testnet

zkFairTestnet

43851 - USDC

Alfajores

celoAlfajores

44787 - A-CELO

Yooldo Verse

yooldoVerse

50005 - OAS

Yooldo Verse Testnet

yooldoVerseTestnet

50006 - OAS

DODOchain Testnet

dodochainTestnet

53457 - DODO

DFK Chain

dfk

53935 - JEWEL

HAQQ Testedge 2

haqqTestedge2

54211 - ISLMT

Rollux Testnet

rolluxTestnet

57000 - SYS

PGN

pgnTestnet

58008 - ETH

Linea Goerli Testnet

lineaGoerli

59140 - ETH

Linea Goerli Testnet

lineaTestnet

59140 - ETH

Linea Sepolia Testnet

lineaSepolia

59141 - ETH

Linea Mainnet

linea

59144 - ETH

Fantom Sonic Open Testnet

fantomSonicTestnet

64240 - FTM

Polygon Mumbai

polygonMumbai

80001 - MATIC

Polygon Amoy

polygonAmoy

80002 - MATIC

Berachain Artio

berachainTestnet

80085 - BERA

Blast

blast

81457 - ETH

Base Goerli

baseGoerli

84531 - ETH

Base Sepolia

baseSepolia

84532 - ETH

Chiliz Spicy Testnet

spicy

88882 - CHZ

Chiliz Chain

chiliz

88888 - CHZ

Jibchain Testnet

jbcTestnet

88991 - tJBC

Vechain

vechain

100009 - VET

Stratis Mainnet

stratis

105105 - STRAX

Etherlink Testnet

etherlinkTestnet

128123 - XTZ

Taiko (Alpha-3 Testnet)

taikoTestnetSepolia

167005 - ETH

Taiko Jolnir (Alpha-5 Testnet)

taikoJolnir

167007 - ETH

Taiko Katla (Alpha-6 Testnet)

taikoKatla

167008 - ETH

Taiko Hekla L2

taikoHekla

167009 - ETH

Bitlayer Testnet

btrTestnet

200810 - ETH

Bitlayer

btr

200901 - ETH

Auroria Testnet

auroria

205205 - tSTRAX

Filecoin Calibration

filecoinCalibration

314159 - tFIL

Arbitrum Goerli

arbitrumGoerli

421613 - ETH

Arbitrum Sepolia

arbitrumSepolia

421614 - ETH

Scroll Sepolia

scrollSepolia

534351 - ETH

Scroll

scroll

534352 - ETH

Scroll Testnet

scrollTestnet

534353 - ETH

Bear Network Chain Mainnet

bearNetworkChainMainnet

641230 - BRNKC

Sei Devnet

seiDevnet

713715 - SEI

Bear Network Chain Testnet

bearNetworkChainTestnet

751230 - tBRNKC

Zhejiang

zhejiang

1337803 - ZhejETH

PlayFi Albireo Testnet

playfiAlbireo

1612127 - ETH

Manta Pacific Testnet

mantaTestnet

3441005 - ETH

Manta Pacific Sepolia Testnet

mantaSepoliaTestnet

3441006 - ETH

Astar zkEVM Testnet zKyoto

astarZkyoto

6038361 - ETH

Zora

zora

7777777 - ETH

Sepolia

sepolia

11155111 - ETH

OP Sepolia

optimismSepolia

11155420 - ETH

Ancient8 Testnet

ancient8Sepolia

28122024 - ETH

SKALE Nebula Testnet

skaleNebulaTestnet

37084624 - sFUEL

Otim Devnet

otimDevnet

41144114 - ETH

Cyber Testnet

cyberTestnet

111557560 - ETH

Plume Testnet

plumeTestnet

161221135 - ETH

Blast Sepolia

blastSepolia

168587773 - ETH

Neon EVM DevNet

neonDevnet

245022926 - NEON

Neon EVM MainNet

neonMainnet

245022934 - NEON

SKALE | Razor Network

skaleRazor

278611351 - sFUEL

SKALE | Block Brawlers

skaleBlockBrawlers

391845894 - BRAWL

Degen

degen

666666666 - DEGEN

Ancient8

ancient8

888888888 - ETH

SKALE Calypso Testnet

skaleCalypsoTestnet

974399131 - sFUEL

Zora Sepolia

zoraSepolia

999999999 - ETH

SKALE Titan Hub

skaleTitanTestnet

1020352220 - sFUEL

SKALE | CryptoBlades

skaleCryptoBlades

1026062157 - sFUEL

SKALE | Crypto Colosseum

skaleCryptoColosseum

1032942172 - sFUEL

SKALE | Human Protocol

skaleHumanProtocol

1273227453 - sFUEL

Aurora

aurora

1313161554 - ETH

Aurora Testnet

auroraTestnet

1313161555 - ETH

SKALE | Titan Community Hub

skaleTitan

1350216234 - sFUEL

SKALE Europa Testnet

skaleEuropaTestnet

1444673419 - sFUEL

SKALE | Nebula Gaming Hub

skaleNebula

1482601649 - sFUEL

SKALE | Calypso NFT Hub

skaleCalypso

1564830818 - sFUEL

Harmony One

harmonyOne

1666600000 - ONE

SKALE | Europa Liquidity Hub

skaleEuropa

2046399126 - sFUEL

SKALE | Exorde

skaleExorde

2139927552 - sFUEL

Palm Testnet

palmTestnet

11297108099 - PALM

Palm

palm

11297108109 - PALM

Kakarot Sepolia

kakarotSepolia

107107114116 - ETH

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.

as const satisfies Chain

import { type Chain } from 'viem'

export const mainnet = {} as const satisfies Chain
Type '{}' does not satisfy the expected type 'Chain'.
  Type '{}' is missing the following properties from type 'Chain': id, name, nativeCurrency, rpcUrls

defineChain

import { defineChain } from 'viem'

export const mainnet = defineChain({})
Argument of type '{}' is not assignable to parameter of type 'Chain<ChainFormatters>'.
  Type '{}' is missing the following properties from type 'Chain<ChainFormatters>': id, name, nativeCurrency, rpcUrls

Now, add the missing required properties to the object until the error goes away.

as const satisfies Chain

import { type Chain } from 'viem'

export const mainnet = {
  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,
    },
  },
} as const satisfies Chain

defineChain

import { defineChain } from 'viem'

export const mainnet = 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 of 1.
• name: Human-readable name for the chain. Example: "Ethereum Mainnet"
• nativeCurrency: The native currency of the chain. Found from ethereum-lists/chains.
• rpcUrls: At least one public, credible RPC URL. Found from ethereum-lists/chains.
• blockExplorers: A set of block explorers for the chain. Found from ethereum-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.
  • multicall3 is optional, but it's address is most likely 0xca11bde05977b3631167028862be2a173976ca11 – you can find the deployed block number on the block explorer. Check out mds1/multicall for more info.
  • ensRegistry is optional – not all Chains have a ENS Registry. See ENS Deployments for more info.
  • ensUniversalResolver is 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.