WalletConnect

Official vagmi Connector for WalletConnect.


import { Callout } from 'nextra-theme-docs'

WalletConnect v1 has been sunset. You must migrate to the [WalletConnect v2 Connector](/react/connectors/walletConnect) before June 28, after which, this Connector will be removed.

WalletConnect Legacy

The WalletConnectLegacyConnector uses WalletConnect v1 by default and wraps the WalletConnect Ethereum Provider and supports its configuration options. This is a great option for adding support for many wallets to your app.

import { WalletConnectLegacyConnector } from 'vagmi/connectors/walletConnectLegacy'

Usage

import { WalletConnectLegacyConnector } from 'vagmi/connectors/walletConnectLegacy'const connector = new WalletConnectLegacyConnector({  options: {    qrcode: true,  },})

Configuration

chains (optional)

Chains supported by app. Defaults to defaultChains.

import { mainnet, optimism } from 'vagmi/chains'import { WalletConnectLegacyConnector } from 'vagmi/connectors/walletConnectLegacy'const connector = new WalletConnectLegacyConnector({  chains: [mainnet, optimism],  options: {    qrcode: true,  },})

Note: Upon connection, the connector will connect to the previously connected chain unless otherwise specified by a chainId config on useConnect.

options

projectId (optional)

WalletConnect Cloud Project ID. Required for WalletConnect v2. You can find your Project ID here.

import { WalletConnectLegacyConnector } from 'vagmi/connectors/walletConnectLegacy'const connector = new WalletConnectLegacyConnector({  options: {    qrcode: true,    projectId: '...',  },})

Other options

You can pass through options supported by the WalletConnect v1 WalletConnectProvider or the WalletConnect v2 UniversalProvider:

import { WalletConnectLegacyConnector } from 'vagmi/connectors/walletConnectLegacy'const connector = new WalletConnectLegacyConnector({  options: {    qrcode: true,    rpc: {      1: 'https://eth-mainnet.alchemyapi.io/v2/yourAlchemyId',    },  },})