Wagmi, Viem, and Ethers Quickstart

To maximize flexibility, Wagmi, Ethers, and Viem packages are decoupled from the core SDKs. Therefore, to add support you'll need to install the relevant packages. These packages follow the naming convention @usecapsule/{NAME}-{VERSION}-integration (eg @usecapsule/wagmi-v2-integration)

Add the SDK to your project using the following command:

# Example illustrates ethers v6
npm install @usecapsule/ethers-v6-integration
pnpm install @usecapsule/ethers-v6-integration
yarn add @usecapsule/ethers-v6-integration


If you’re looking to get started with Capsule as quickly as possible and you already use wagmi within your web application, we have built a wagmi connector, called the CapsuleConnector

NOTE: Capsule has support for Wagmi v1 and v2. The example below indicates v2 integration instructions. To use v1, replace the wagmi package name with @usecapsule/wagmi-v1-integration

NOTE: CapsuleConnector is not yet supported for mobile. If this is needed for your use case, please get in touch!

import { capsuleConnector } from "@usecapsule/wagmi-v2-integration";
import { configureChains, createConfig, WagmiConfig } from "wagmi";

const { chains, publicClient, webSocketPublicClient } = configureChains(

const config = createConfig({
  autoConnect: true,
  connectors: [
    // ... other connectors
      options: {},
      appName: "Your App",
      disableModal: true,

return <WagmiConfig config={config}>...</WagmiConfig>;


NOTE: Capsule has support for Ethers v5 and v6. The example below indicates v6 integration instructions. To use v5, replace the ethers package name with @usecapsule/ethers-v5-integration

import { CapsuleEthersSigner } from '@usecapsule/ethers-v6-integration';
import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider(
const ethersSigner = new CapsuleEthersSigner(capsule, provider);

await ethersSigner.signMessage("Hello Capsule!")


NOTE: Capsule has support for Viem v1 and v2. The example below indicates v2 integration instructions. To use v1, replace the viem package name with @usecapsule/viem-v1-integration

import { createCapsuleViemClient } from '@usecapsule/viem-v2-integration';
import { http } from 'viem';

const viemClient = createCapsuleViemClient(capsule, {
  chain: CHAIN,
  transport: http(CHAIN_PROVIDER),

await viemClient.signMessage("Hello Capsule!");

Last updated