@web3-onboard/wagmi

Module to configure, connect and return web3-onboard wallets as wagmi wallets and wagmi-config to be used with wagmi-core methods
19,073 922
Install
npm install @web3-onboard/wagmi
Latest Version:2.0.1
License:MIT
Last Updated:May 28, 2026
Links: GitHub  ·  npm
Maintainer: jake-thirdweb

@web3-onboard/wagmi

A module for connecting wallets using WAGMI which returns a WAGMI config object to be used with @wagmi/core functions.

Install

NPM npm i @web3-onboard/wagmi

Yarn yarn add @web3-onboard/wagmi

Usage

This example assumes you have already setup web3-onboard to connect wallets to your dapp. For more information see web3-onboard docs.

wagmiConnector and Connectors

wagmiConnector is a property returned as part of the wallet state object and can be used to interact with the WAGMI API returned from this module or an external WAGMI instance. Please see examples below...

import Onboard from '@web3-onboard/core'
import injectedModule from '@web3-onboard/injected-wallets'
import wagmi from '@web3-onboard/wagmi'
import {
  sendTransaction as wagmiSendTransaction,
  switchChain,
  disconnect,
  getConnectors
} from '@web3-onboard/wagmi'
import { parseEther, isHex, fromHex } from 'viem'

const injected = injectedModule()

const onboard = Onboard({
  // This javascript object is unordered meaning props do not require a certain order
  wagmi,
  wallets: [injected],
  chains: [
    {
      id: '0x1',
      token: 'ETH',
      label: 'Ethereum',
      rpcUrl: 'https://mainnet.infura.io/v3/17c1e1500e384acfb6a72c5d2e67742e'
    }
  ]
  // ... other Onboard options
})

const sendTransaction = async () => {
  // current primary wallet - as multiple wallets can connect this value is the currently active
  const [activeWallet] = onboard.state.get().wallets
  const { wagmiConnector } = activeWallet
  const wagmiConfig = onboard.state.get().wagmiConfig
  const result = await wagmiSendTransaction(wagmiConfig, {
    to: toAddress,
    // desired connector to send txn from
    connector: wagmiConnector,
    value: parseEther('0.001')
  })
  console.log(result)
}

async function signMessage(chainId) {
  // current primary wallet - as multiple wallets can connect this value is the currently active
  const [activeWallet] = onboard.state.get().wallets
  const wagmiConfig = onboard.state.get().wagmiConfig
  await wagmiSignMessage(wagmiConfig, {
    message: 'This is my message to you',
    connector: activeWallet.wagmiConnector
  })
}

async function disconnectWallet() {
  const wagmiConfig = onboard.state.get().wagmiConfig
  const [activeWallet] = onboard.state.get().wallets
  const { wagmiConnector } = activeWallet
  disconnect(wagmiConfig, { connector: wagmiConnector })
}

Related Packages

@web3-onboard/common

Web3-Onboard makes it simple to connect Ethereum hardware and software wallets t...

553,389 922
@web3-onboard/walletconnect

WalletConnect SDK module for connecting to Web3-Onboard. Web3-Onboard makes it s...

340,306 922
@web3-onboard/hw-common

Web3-Onboard makes it simple to connect Ethereum hardware and software wallets t...

161,695 922
@web3-onboard/ledger

Ledger hardware wallet module for connecting to Web3-Onboard. Web3-Onboard makes...

83,146 922
@web3-onboard/metamask

MetaMask SDK wallet module for connecting to Web3-Onboard. Web3-Onboard makes it...

67,024 922

Version History

Version Released License
2.0.1 MIT
2.0.0 MIT
Pre-releases (7)
Version Released License
2.0.0-alpha.6 MIT
2.0.0-alpha.5 MIT
2.0.0-alpha.4 MIT
2.0.0-wagmi.4 MIT
2.0.0-wagmi.3 MIT