For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

switchChain

Function to switch blockchain networks with Web3Auth.

Usage

await web3auth.switchChain({ chainId: '0xaa36a7' })

Parameters

ParameterDescriptionTypeRequired
{ chainId: string }Chain ID of the chain to switch to, for example, { chainId: "0xaa36a7" }ObjectYes

Example

switchChain.js
async function onConnected() {
const chains = web3auth.coreOptions.chains ?? []
const chainId = web3auth.currentChainId
// Update UI with chainId and available chains
}

// Initialize Web3Auth first
await web3auth.init()

// Switch to Sepolia Testnet
try {
await web3auth.switchChain({ chainId: '0xaa36a7' })
await onConnected()
console.log('Successfully switched to Sepolia Testnet')
} catch (error) {
console.error('Error switching chain:', error)
}