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
// Initialize Web3Auth first
// ...

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

// Later, switch to Ethereum Mainnet
try {
await web3auth.switchChain({ chainId: '0x1' })
console.log('Successfully switched to Ethereum Mainnet')
} catch (error) {
console.error('Error switching chain:', error)
}