Overview

@namera-ai/templates turns a spending budget, network selection and expiry into session permissions. The dashboard and your application use the same built-in definitions. Build permissions locally, inspect the output, then pass it to the SDK's existing sessionKeys.create() method.

Use Node.js 24.14+ or a modern browser with native bigint support. Building permissions is synchronous and needs no account, API key or network connection. Keep API keys on your backend when creating sessions.

Create a managed session that can transfer up to 100 USDC on Arc testnet for seven days. Registration creates the session; onchain activation requires the account owner's approval.

InstallCopy Anchor Link

npm install @namera-ai/templates @namera-ai/sdk

Prepare Your WorkspaceCopy Anchor Link

In the dashboard, create or choose an account and issue a workspace API key with wallet:read, session-key:create and session-key:read. Add session-key:install if the integration will manage installation. Set NAMERA_API_KEY and NAMERA_WALLET_ID in your backend environment.

Build and Create the SessionCopy Anchor Link

Save this as index.ts. The amount is a decimal string in USDC units.

import { NameraClient } from "@namera-ai/sdk";
import { usdcAllowanceTemplate } from "@namera-ai/templates";

const namera = new NameraClient({ apiKey: process.env.NAMERA_API_KEY! });
const now = Math.floor(Date.now() / 1000);
const permissions = usdcAllowanceTemplate.build(
  {
    networks: ["eip155:5042002"],
    allowance: "100",
    expiresAt: new Date((now + 7 * 86_400) * 1000).toISOString(),
  },
  { now },
);

const session = await namera.sessionKeys.create({
  namespace: "eip155",
  walletId: process.env.NAMERA_WALLET_ID!,
  metadata: { version: 1, name: "USDC test agent" },
  signer: {
    custody: "namera-managed",
    provider: "1claw",
    algorithm: "secp256k1",
  },
  ...permissions,
});
if (!session.success) throw new Error(session.error.message);

console.log(session.data);

Run node --env-file=.env index.ts on Node.js 24.14+. The SDK returns the complete registered session, including its per-network installation state. See session creation for the response shape. Local signers use the same permissions; pass their public key with custody: "local" as shown in the local session guide. Never send a local private key to Namera.

Install and ConfirmCopy Anchor Link

Registration leaves the installation pending. For every selected network:

1. Call sessionKeys.prepareOperation() with the returned session ID, network and kind: "install".
2. Review the prepared operation against your chosen account, permissions and gas consent.
3. Call sessionKeys.approveOperation() using the account owner's managed approval or passkey assertion.
4. Poll sessionKeys.getOperation() until confirmation before executing with the session.

Follow Install Session Keys for the complete review and approval flow. The signer custody selected above does not change the account owner's approval requirements.

Use the Granted AuthorityCopy Anchor Link

The template allows ERC-20 USDC transfers to any recipient, up to the lifetime budget. It grants no message signatures, general contract access or native-value transfers. Fund the account with test USDC before sending a transfer. Sponsorship covers gas independently of this spending permission.

The USDC template reference documents exact units, multiple-network budgets and validation errors. Build failures throw locally; SDK calls return the usual result envelope.

Discover Built-in TemplatesCopy Anchor Link

import { getTemplate, templates } from "@namera-ai/templates";

console.log(templates.map(({ id, display }) => ({ id, name: display.name })));
console.log(getTemplate("usdc-lifetime-allowance")?.version);

The registry currently contains one built-in template. getTemplate(id) returns undefined for an unknown ID. Each template's page documents its inputs, permissions and supported networks.

To define permissions in your own application, follow Create a Custom Template and Test a Custom Template.