Accounts and Session Keys

An account holds assets. A session key lets your application act on that account within its permissions. Create both in the Namera dashboard, then use the SDK to find them.

List AccountsCopy Anchor Link

Use a client configured with your API key:

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

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

const wallets = await namera.wallets.list();
if (!wallets.success) throw new Error(wallets.error.message);

console.log(wallets.data);

Each account includes its id, address, and metadata. Use the account's id as walletId in SDK calls, not its address.

Find Session Keys for an AccountCopy Anchor Link

Replace the example ID with an account ID from the list:

const walletId = "0199dfe1-0000-7000-8000-000000000001";
const sessions = await namera.sessionKeys.list({ walletId });

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

console.log(sessions.data);

Omit walletId to list all session keys available to your credential. Each key includes its walletId, policies, and network installations.

Use a Specific Session KeyCopy Anchor Link

Once you have chosen a key, keep its ID in your application's configuration. Retrieve it directly instead of relying on list order:

const sessionKeyId = "0199dfe1-0000-7000-8000-000000000002";
const result = await namera.sessionKeys.get(sessionKeyId);

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

const session = result.data;
console.log(result.data);

Use session.walletId and session.id together when executing or signing. The key must be active, installed on the target network, and permitted to perform the operation. See Permissions.

Get an Account by IDCopy Anchor Link

const wallet = await namera.wallets.get(session.walletId);
if (!wallet.success) throw new Error(wallet.error.message);

console.log(wallet.data);

An empty list means no resources are available to this credential. Check the session-key grants and whether the key is still active in the dashboard.

For a complete example using these resources, see Getting Started.