Simulate Transactions
Preview calls and check installed permissions before submitting.
Use executions.simulate() to inspect a transaction without signing or
submitting it. Simulation does not reserve billing allowance.
Simulate a Transfer
Use an authenticated client and a session key installed on Base Sepolia. The account needs the test ETH being transferred. Replace the example IDs and recipient with your own.
npm install @namera-ai/sdk viemimport { NameraClient, type SimulateExecutionRequest } from "@namera-ai/sdk";
import { parseEther } from "viem";
const namera = new NameraClient({ apiKey: process.env.NAMERA_API_KEY! });
const request = {
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",
},
],
} satisfies SimulateExecutionRequest;
const simulation = await namera.executions.simulate(request);
if (!simulation.success) throw new Error(simulation.error.message);
console.log(simulation.data);{
"namespace": "eip155",
"walletId": "0199dfe1-0000-7000-8000-000000000001",
"chainId": "eip155:84532",
"account": "0x1111111111111111111111111111111111111111",
"callsSucceeded": true,
"simulation": {
"userOperation": {
"source": "eth_estimateUserOperationGas",
"callGasLimit": "50000",
"verificationGasLimit": "100000",
"preVerificationGas": "50000",
"maxFeePerGas": "1000000000",
"maxPriorityFeePerGas": "1000000"
},
"calls": {
"source": "viem.simulateCalls",
"results": [{ "status": "success", "returnData": "0x", "gasUsed": "21000" }],
"assetChanges": [],
"transfers": [
{
"callIndex": 0,
"from": "0x1111111111111111111111111111111111111111",
"to": "0x2222222222222222222222222222222222222222",
"value": "1000000000000000"
}
]
}
},
"allowed": true,
"sessionKeyId": "0199dfe1-0000-7000-8000-000000000002"
}Gas estimates are illustrative. Quantities shown as decimal strings in JSON
are bigint values in the SDK.
Read the Result
callsSucceededreports whether the simulated calls succeeded.allowedreports point-in-time eligibility for the selected session key.simulation.callscontains per-call results, detected asset changes, and native transfers.
If simulation itself fails, the SDK returns success: false; handle it as an
error.
Execute the Same Calls
After reviewing the result, submit the same request with sponsorship enabled:
if (!simulation.data.callsSucceeded || !simulation.data.allowed) {
throw new Error("Review the simulation before executing.");
}
const execution = await namera.executions.execute({ ...request, sponsor: true });
if (!execution.success) throw new Error(execution.error.message);
console.log(execution.data);{
"namespace": "eip155",
"submissionId": "0199dfe1-0000-7000-8000-000000000003",
"status": "prepared",
"userOperationHash": "0x1111111111111111111111111111111111111111111111111111111111111111"
}A preview is not a guarantee
Balances, permissions, and available budgets can change after simulation. Execution checks them again. The second snippet submits a real testnet transaction.
Next, track the submission.