wallet_switchEthereumChain

MetaMask

Requests that the wallet switches its active Ethereum chain. Introduced by EIP-3326.

Params

(1)

chainId

string

required

The chain ID as a 0x-prefixed hexadecimal string, per the eth_chainId method.

(SwitchEthereumChainResult)

null

Code	Message
4902	Unrecognized chain ID. Try adding the chain using wallet_addEthereumChain first.

await window.ethereum.request({
  "method": "wallet_switchEthereumChain",
  "params": [
    {
      "chainId": "0x64"
    }
  ]
});

"null"

Install MetaMask for your platform and refresh the page. The interactive features in this documentation require installing MetaMask.

await window.ethereum.request({
  "method": "wallet_switchEthereumChain",
  "params": [
    null
  ]
});