switchConnection

Action for switching the current account.

Import

import { switchConnection } from '@wagmi/core'

Usage

index.ts

import { getConnections, switchConnection } from '@wagmi/core'
import { config } from './config'

const connections = getConnections(config)
const result = await switchConnection(config, {
  connector: connections[0]?.connector,
})

config.ts

import { createConfig, http } from '@wagmi/core'
import { mainnet, sepolia } from '@wagmi/core/chains'

export const config = createConfig({
  chains: [mainnet, sepolia],
  transports: {
    [mainnet.id]: http(),
    [sepolia.id]: http(),
  },
})

Parameters

import { type SwitchConnectionParameters } from '@wagmi/core'

connector

Connector

Connector to switch to.

index.ts

import { getConnections, switchConnection } from '@wagmi/core'
import { config } from './config'

const connections = getConnections(config)
const result = await switchConnection(config, {
  connector: connections[0]?.connector, 
})

config.ts

import { createConfig, http } from '@wagmi/core'
import { mainnet, sepolia } from '@wagmi/core/chains'

export const config = createConfig({
  chains: [mainnet, sepolia],
  transports: {
    [mainnet.id]: http(),
    [sepolia.id]: http(),
  },
})

Return Type

import { type SwitchConnectionReturnType } from '@wagmi/core'

accounts

readonly [Address, ...Address[]]

Connected accounts from connector.

chainId

number

Connected chain ID from connector.

Error

import { type SwitchConnectionErrorType } from '@wagmi/core'

TanStack Query

import {
  type SwitchConnectionData,
  type SwitchConnectionVariables,
  type SwitchConnectionMutate,
  type SwitchConnectionMutateAsync,
  switchConnectionMutationOptions,
} from '@wagmi/core/query'