Vue Composition for Ethereum based on wagmi

npm (tag) NPM


Vue Composition for Ethereum

Support for Vue 2.x via vue-demi

Based on wagmi


  • 🚀 Composables for working with wallets, ENS, contracts, transactions, signing, etc.
  • 💼 Built-in wallet connectors for MetaMask, WalletConnect, Coinbase Wallet, and Injected
  • 👟 Caching, request deduplication, multicall, batching, and persistence
  • 🌀 Auto-refresh data on wallet, block, and network changes
  • 🦄 TypeScript ready

...and a lot more.


use-wagmi docs visit wagmi docs as most of the concepts and APIs are the same.


Install use-wagmi and its viem peer dependency.

npm install use-wagmi viem

Quick Start

Connect a wallet in under 60 seconds.

import { UseWagmiPlugin, createConfig, mainnet } from 'use-wagmi'
import { createPublicClient, http } from 'viem'
import App from './App.vue'

const config = createConfig({
  autoConnect: true,
  publicClient: createPublicClient({
    chain: mainnet,
    transport: http(),

const app = createApp(App);
app.use(UseWagmiPlugin, config);
<script setup>
import { useAccount, useConnect, useDisconnect } from 'use-wagmi'
import { InjectedConnector } from 'use-wagmi/connectors/injected'

const { address, isConnected } = useAccount()
const { connect } = useConnect({
  connector: new InjectedConnector(),
const { disconnect } = useDisconnect()

  <div v-if="isConnected">
    Connected to {{ address }}
    <button @click="disconnect">Disconnect</button>
  <button v-else @click="connect">
    Connect Wallet

In this example, we create a use-wagmi and pass it to the Vue plugin. The client is set up to use the ethers Default Provider and automatically connect to previously connected wallets.

Next, we use the useConnect composable to connect an injected wallet (e.g. MetaMask) to the app. Finally, we show the connected account's address with useAccount and allow them to disconnect with useDisconnect.

We've only scratched the surface for what you can do with use-wagmi!


we shipped a Nuxt module to enable auto importing for Nuxt 3 and Nuxt Bridge.

npm install @use-wagmi/nuxt -D
// nuxt.config.ts
export default defineNuxtConfig({
  modules: [

And then use use-wagmi function anywhere in your Nuxt app. For example:

<script setup lang="ts">
const { address } = useAccount()

  <div>{{ address }}</div>