Getting Started

Create a smart agentic wallet

A smart agentic wallet gives any authorized agent permissioned access to your onchain assets through Altana's global Keystore: a public onchain registry of authorized keys.

You own the wallet. Agents get scoped, expiring, revocable keys. Every permission is verifiable by anyone, from any chain, with a free read.

Which admin key type?

Passkey

Best for consumer apps where a person approves with Face ID or Touch ID.

Biometric authentication run in the browser through WebAuthn. The private key is created inside your device's secure hardware and never leaves it.

Private key

Best for autonomous agents, backend services, and scripts.

A key your own code holds, in an env var, OS keychain, or encrypted file. Altana never sees it. No API key and no hosted backend.

Try it live

Each call hits the Altana SDK against BNB Smart Chain. Your passkey stays on your device.

Create a passkey wallet

Your browser will prompt for biometric confirmation (Face ID, Touch ID, or your platform authenticator). The private key is generated inside your device's secure hardware and never leaves it.

Activate the wallet onchain

The first transaction registers your passkey's public key in Altana's onchain Keystore and activates the wallet.

You will see one more biometric prompt. That is your passkey signing the transaction.

or, recover an existing wallet

Recover from passkey

Recovery matches your passkey's private key (held on your device, synced via iCloud or Google) against the public key registered onchain in the Keystore. Both halves are needed. No seed phrase, no server.

Build this into your own app →

Step-by-step code walkthrough for integrating a passkey wallet into your browser app, granting a session to an agent, and revoking it.

Get started with the SDK

What you need

Node.js 18+ and npm, bun, or pnpm

Step 1: Install

npm install @altananetwork/sdk viem

Step 2: Generate your wallet

Generate a private key, then build a wallet around it. Run this once.

import { generatePrivateKey } from "viem/accounts";
import { createClient, BNB, signerFromPrivateKey } from "@altananetwork/sdk";
 
const privateKey = generatePrivateKey();
console.log("Save this key:", privateKey); // copy and store this somewhere safe
 
const signer = signerFromPrivateKey(privateKey);
const client = createClient({ chains: [BNB] });
const wallet = await client.createWallet({ signer });
 
console.log("Wallet address:", wallet.address);

You generate the key yourself here rather than asking the SDK for one, so the key is only ever somewhere you put it.

Step 3: Fund your wallet

Send BNB to your wallet.address before executing.

Fund the address with BNB from any exchange or wallet.

Step 4: Run a transaction

The first execute activates the wallet and registers the admin key in the global Keystore.

All in one transaction.

const result = await client.execute({
  wallet,
  signer,
  calls: { to: wallet.address as `0x${string}`, value: 0n },
});
 
console.log(result.status, result.transactionHash);

Already have a private key?

If you are bringing an existing Ethereum key, use signerFromPrivateKey instead of generating a new one.

Store it in a .env file at your project root:

# .env  —  add to .gitignore, never commit this file
PRIVATE_KEY=0xYourKeyHere

Install dotenv to load it:

npm install dotenv

Then use it in your script:

import 'dotenv/config'
import { createClient, BNB, signerFromPrivateKey } from "@altananetwork/sdk";
 
const client = createClient({ chains: [BNB] });
const signer = signerFromPrivateKey(process.env.PRIVATE_KEY as `0x${string}`);
const wallet = await client.createWallet({ signer });
 
console.log(wallet.address);

Give an agent a wallet and a policy: grant an AI a scoped, expiring key on this wallet.
Use a passkey wallet as admin, delegate to an agent: passkey admin grants a capped key to an AI.
Connect an AI tool: operate wallets via Claude, Codex, or any AI without writing code.