• Core
• Chains

Chains

@wagmi/core exports the Mainnet (mainnet) & Goerli (goerli) chains out-of-the-box.

import { mainnet, goerli } from '@wagmi/core'

If you wish to extend to other EVM-compatible chains (like Polygon, Optimism, BSC, Avalanche, etc), you can either import the chain directly from the @wagmi/core/chains entrypoint, or build it yourself.

@wagmi/core/chains

The @wagmi/core/chains entrypoint proxies the @wagmi/chains NPM package, an official wagmi package which contains references to popular EVM-compatible chains such as: Polygon, Optimism, Avalanche, and more.

Usage

Import your chains from the entrypoint and use them in your wagmi app:

import { configureChains } from '@wagmi/core'
import { avalanche, bsc, mainnet } from '@wagmi/core/chains'
 
const { chains, provider } = configureChains(
  [mainnet, avalanche, bsc],
  ...
)

Read more on configuring chains

Supported chains

• mainnet
• goerli
• arbitrum
• arbitrumGoerli
• aurora
• auroraTestnet
• avalanche
• avalancheFuji
• baseGoerli
• boba
• bronos
• bronosTestnet
• bsc
• bscTestnet
• canto
• celo
• celoAlfajores
• chronos
• crossbell
• crossbell
• dfk
• dogechain
• evmos
• evmosTestnet
• fantom
• fantomTestnet
• filecoin
• filecoinCalibration
• filecoinHyperspace
• flare
• flareTestnet
• gnosis
• gnosisChiado
• harmonyOne
• iotex
• iotexTestnet
• klaytn
• metis
• metisGoerli
• moonbaseAlpha
• moonbeam
• moonriver
• okc
• optimism
• optimismGoerli
• polygon
• polygonMumbai
• polygonZkEvmTestnet
• scrollTestnet
• sepolia
• shardeumSphinx
• skaleCalypso
• skaleCalypsoTestnet
• skaleChaosTestnet
• skaleCryptoBlades
• skaleCryptoColosseum
• skaleEuropa
• skaleEuropaTestnet
• skaleExorde
• skaleHumanProtocol
• skaleNebula
• skaleNebulaTestnet
• skaleRazor
• skaleTitan
• skaleTitanTestnet
• songbird
• songbirdTestnet
• taraxa
• taraxaTestnet
• telos
• telosTestnet
• titan
• titanTestnet
• wanchain
• wanchainTestnet
• zkSync
• zkSyncTestnet
• foundry
• hardhat
• localhost

Want to add a chain that's not listed here? Head to the wagmi References monorepo and read the Contributing Guide before opening a pull request.

Build your own

You can also extend wagmi to support other EVM-compatible chains by building your own chain object that inherits the Chain type.

import { Chain } from '@wagmi/core'
 
export const avalanche = {
  id: 43_114,
  name: 'Avalanche',
  network: 'avalanche',
  nativeCurrency: {
    decimals: 18,
    name: 'Avalanche',
    symbol: 'AVAX',
  },
  rpcUrls: {
    public: { http: ['https://api.avax.network/ext/bc/C/rpc'] },
    default: { http: ['https://api.avax.network/ext/bc/C/rpc'] },
  },
  blockExplorers: {
    etherscan: { name: 'SnowTrace', url: 'https://snowtrace.io' },
    default: { name: 'SnowTrace', url: 'https://snowtrace.io' },
  },
  contracts: {
    multicall3: {
      address: '0xca11bde05977b3631167028862be2a173976ca11',
      blockCreated: 11_907_934,
    },
  },
} as const satisfies Chain