Quickstart

In this guide, you'll wire up viem's bundler client to Alchemy's bundler with a Modular Account V2 from @alchemy/smart-accounts and send a user operation. This is the advanced path; if you don't need this level of control, use @alchemy/wallet-apis instead.

API key from your dashboard
A gas sponsorship policy from your dashboard, if you want to sponsor gas
TypeScript 5+ and the packages below

Installation

yarn add @alchemy/common @alchemy/aa-infra @alchemy/smart-accounts viem

Replace YOUR_API_KEY and POLICY_ID with the values from the prerequisites above.

config.ts

import { sepolia } from "viem/chains";
 
export const chain = sepolia;
export const ALCHEMY_API_KEY = "<YOUR_API_KEY>";
export const policyId = "<POLICY_ID>";

client.ts

import { createBundlerClient, createPaymasterClient } from "viem/account-abstraction";
import { createClient } from "viem";
import { privateKeyToAccount, generatePrivateKey } from "viem/accounts";
import { alchemyTransport } from "@alchemy/common";
import { toModularAccountV2 } from "@alchemy/smart-accounts";
import { estimateFeesPerGas } from "@alchemy/aa-infra";
import { chain, ALCHEMY_API_KEY, policyId } from "./config";
 
const transport = alchemyTransport({ apiKey: ALCHEMY_API_KEY });
 
const rpcClient = createClient({ chain, transport });
 
export async function getClient() {
  const owner = privateKeyToAccount(generatePrivateKey());
  const account = await toModularAccountV2({ client: rpcClient, owner });
 
  return createBundlerClient({
    account,
    client: rpcClient,
    chain,
    transport,
    // Drop the next two lines if you don't want gas sponsorship.
    paymaster: createPaymasterClient({ transport }),
    paymasterContext: { policyId },
    userOperation: { estimateFeesPerGas },
  });
}

import { getClient } from "./client";
 
const client = await getClient();
 
const hash = await client.sendUserOperation({
  calls: [
    {
      to: "0x0000000000000000000000000000000000000000",
      value: 0n,
      data: "0x",
    },
  ],
});
 
const receipt = await client.waitForUserOperationReceipt({ hash });
console.log("Mined:", receipt.receipt.transactionHash);

Quickstart

Prerequisites

Create a client

Send a user operation