Skip to main content


Web3Modal SDK has support for Wagmi, Ethers v5 and Ethers v6. Choose one of these ethereum libraries to get started.


npm install @web3modal/wagmi wagmi viem

Don't have a project ID?

Head over to WalletConnect Cloud and create a new project now!

Get startedcloud illustration


You can start Web3Modal configuration using either default or custom mode.

Default mode will implement WalletConnect, Browser Wallets (injected) and Coinbase options in addition to Wagmi's public provider and WalletConnect's provider.

On top of your app set up the following configuration, making sure that all functions are called outside any React component to avoid unwanted rerenders.

import { createWeb3Modal, defaultWagmiConfig } from '@web3modal/wagmi/react'

import { WagmiConfig } from 'wagmi'
import { arbitrum, mainnet } from 'viem/chains'

// 1. Get projectId at
const projectId = 'YOUR_PROJECT_ID'

// 2. Create wagmiConfig
const metadata = {
name: 'Web3Modal',
description: 'Web3Modal Example',
url: '',
icons: ['']

const chains = [mainnet, arbitrum]
const wagmiConfig = defaultWagmiConfig({ chains, projectId, metadata })

// 3. Create modal
createWeb3Modal({ wagmiConfig, projectId, chains })

export default function App() {
return (
<WagmiConfig config={wagmiConfig}>
// Rest of your app...

Trigger the modal

To open Web3Modal you can use our default web components or build your own logic using Web3Modal hooks.

export default function ConnectButton() {
return <w3m-button />

Learn more about the Web3Modal web components here


Web components are global html elements that don't require importing.

Smart Contract Interaction

import { useContractRead } from 'wagmi'
import { USDTAbi } from '../abi/USDTAbi'

const USDTAddress = '0x...'

function App() {
const { data, isError, isLoading } = useContractRead({
address: USDTAddress,
abi: USDTAbi,
functionName: 'symbol',

Read more about Wagmi hooks for smart contract interaction here.