En esta página

wallet_switchEthereumChain

Solicita a la cartera que cambie a la cadena especificada. Si la cadena aún no está configurada en la cartera, se lanza un error.

Parámetros

Array que contiene un único objeto:

Campo	Tipo	Obligatorio	Descripción
`chainId`	`string`	Sí	ID de cadena (cadena hexadecimal con prefijo 0x)

Devuelve

null si la operación tiene éxito

Ejemplo


try {
  await window.$onekey.ethereum.request({
    method: 'wallet_switchEthereumChain',
    params: [{ chainId: '0x89' }] // Polygon
  })
  console.log('Switched to Polygon')
} catch (error) {
  if (error.code === 4902) {
    // Chain not added, try adding it
    await window.$onekey.ethereum.request({
      method: 'wallet_addEthereumChain',
      params: [chainConfig] // Define the full configuration for this chain first.
    })
    await window.$onekey.ethereum.request({
      method: "wallet_switchEthereumChain",
      params: [{ chainId: "0x89" }]
    })
  } else {
    throw error
  }
}

Identificadores de cadena habituales

Cadena	ID de cadena (hexadecimal)	ID de cadena (decimal)
Ethereum	`0x1`	1
Polygon	`0x89`	137
BSC	`0x38`	56
Arbitrum	`0xa4b1`	42161
Optimism	`0xa`	10
Base	`0x2105`	8453
Avalanche	`0xa86a`	43114

Errores

Código	Mensaje	Descripción
4001	El usuario rechazó la solicitud	El usuario denegó el cambio
4902	ID de cadena no reconocido	Cadena no configurada en la cartera

Notas

Si la cadena no está configurada, usa wallet_addEthereumChain primero
Puede que el usuario deba aprobar el cambio
Escucha el evento chainChanged para detectar cuándo se completa el cambio
Definido por EIP-3326


window.$onekey.ethereum.on('chainChanged', (chainId) => {
  console.log('Chain changed to:', chainId)
  // Recommended: reload the page
  window.location.reload()
})