Batch Transactions

Put multiple calls in the calls array to submit them together. A batch uses one account, one session key, and one network, with a single submission ID to track.

Before You StartCopy Anchor Link

Set up authentication. Your session key must be installed on Base Sepolia, allow both recipients, and permit the combined 0.002 ETH transfer. Fund the account with 0.002 test ETH.

npm install @namera-ai/sdk viem

Submit a BatchCopy Anchor Link

Replace the IDs and both recipients with your own. Calls are executed in array order.

import { NameraClient } from "@namera-ai/sdk";
import { parseEther } from "viem";

const namera = new NameraClient({ apiKey: process.env.NAMERA_API_KEY! });

const batch = await namera.executions.execute({
  namespace: "eip155",
  walletId: "0199dfe1-0000-7000-8000-000000000001",
  sessionKeyId: "0199dfe1-0000-7000-8000-000000000002",
  chainId: "eip155:84532",
  calls: [
    {
      to: "0x2222222222222222222222222222222222222222",
      value: parseEther("0.001"),
      data: "0x",
    },
    {
      to: "0x4444444444444444444444444444444444444444",
      value: parseEther("0.001"),
      data: "0x",
    },
  ],
  sponsor: true,
});

if (!batch.success) throw new Error(batch.error.message);

console.log(batch.data);

{
  "namespace": "eip155",
  "submissionId": "0199dfe1-0000-7000-8000-000000000003",
  "status": "prepared",
  "userOperationHash": "0x1111111111111111111111111111111111111111111111111111111111111111"
}

Every call must pass the selected session key's permissions and policies. Native spending limits apply to the sum of all call values, not each transfer individually. A batch cannot combine authority from different session keys.

Combine Different CallsCopy Anchor Link

The array can contain native transfers and encoded contract calls. For dependent calls, such as approval followed by a contract interaction, put the prerequisite first and ensure both calls are permitted.

Simulate the full batch before submitting it, then track its submission.