Skip to main content

Sponsored paymaster

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.