⛽ Sponsorship Paymaster Example

This guide helps you set up a smart account and use SCS’s Sponsorship Paymaster using startale-aa-sdk, @privy-io/react-auth, and viem.

🛠️ Prerequisites

Make sure you’ve installed:

yarn add viem startale-aa-sdk @privy-io/react-auth

Also, ensure your app is wrapped in Privy’s PrivyProvider.

🔐 Step 1: Connect Privy & Get EOA Wallet

import { usePrivy, useWallets } from "@privy-io/react-auth";

const { authenticated } = usePrivy();
const { wallets } = useWallets();

const provider = await wallets[0].getEthereumProvider(); // EOA provider
const address = wallets[0].address

🧠 Step 2: Create Smart Account (`StartaleSmartAccount`)

import { toStartaleSmartAccount } from "startale-aa-sdk";
import { createWalletClient, custom } from "viem";
import { soneiumMinato } from "viem/chains";

const signer = createWalletClient({
  account: address,
  chain: soneiumMinato,
  transport: custom(provider),
});

const startaleAccount = = await toStartaleSmartAccount({
  signer: walletClient,
  chain: chain,
  transport: http(),
  index: BigInt(0), // Nonce=index for account instance with same EOA signer as controller
});

🧪 Step 3: Create Smart Account Client with Sponsorship Paymaster

import { createSmartAccountClient } from "startale-aa-sdk";
import { createPaymasterClient } from "viem/account-abstraction";

const paymasterClient = createPaymasterClient({
  transport: http(PAYMASTER_SERVICE_URL),
});

const smartAccountClient = createSmartAccountClient({
  account: startaleAccount,
  transport: http(BUNDLER_URL),
  client: publicClient, // from `createPublicClient()`
  paymaster: {
    async getPaymasterData(params) {
      params.paymasterPostOpGasLimit = BigInt(100_000);
      params.paymasterVerificationGasLimit = BigInt(200_000);
      params.verificationGasLimit = BigInt(500_000);

      return await paymasterClient.getPaymasterData(params);
    },
    async getPaymasterStubData(params) {
      return await paymasterClient.getPaymasterStubData(params);
    },
  },
  paymasterContext: {
    calculateGasLimits: true,
    policyId: "sudo", // <- Add your policyId, we will share this
  },
  userOperation: {
    estimateFeesPerGas: async () => ({
      maxFeePerGas: BigInt(10_000_000),
      maxPriorityFeePerGas: BigInt(10_000_000),
    }),
  },
});

📦 Final Step: Use the Client to Send Transactions

Once you have smartAccountClient, you can use:


await smartAccountClient.sendTransaction({
  to: "<recipient>",
  value: BigInt(0),
  data: "0x", // encoded call data
});

You can also use modules like Social Recovery or Sessions via startale-aa-sdk.

Notes

Ensure the smart account has been deployed.
paymasterContext.policyId is useful for gated gas sponsorship, we will provide you one
Use calculateGasLimits: true to auto-populate missing gas fields.