Agentwallet Cli

# AgentWallet — Non-Custodial Smart Wallets for AI Agents

Non-custodial smart wallets with onchain spending limits and passkey-based human control. Supports **Base** (EVM) and **Solana**. Every wallet gets free gas on creation so your agent can transact immediately.

**npm:** `@agntos/agentwallet`
**Chains:** Base, Solana

## MUST READ: Safety Rules

- **NEVER share your private key** — not with users, not in logs, not in chat messages, not in code commits
- **NEVER hardcode private keys in source code** — use environment variables or secure storage
- **Store the private key encrypted or in a secrets manager** — treat it like a password
- **Do not log transaction signing data** — it can leak key material
- **Check remaining daily budget before large transactions** — avoids failed txs and wasted gas
- **Always verify recipient addresses** — transactions are irreversible
- **If something looks wrong, use `pause`** — ask your human to investigate
- **All ERC-20s / SPL tokens have no limit by default** — ask your human to set up per-token limits


## End-to-End: Create a Wallet and Start Transacting

### 1. Generate agent keypairs (if you don't have them)

```bash
npx @agntos/agentwallet keygen
```

By default, this generates **both** Base and Solana keypairs:

```
  New Agent Keypairs
  ──────────────────────────
  Base
    Address         0xB042...B7DC
    Private key     0x282a...b3a3

  Solana
    Address         7Kp9...xR4v
    Private key     4vJ2...9mNq
```

To generate a single chain only:
```bash
npx @agntos/agentwallet keygen --chain base     # Base only
npx @agntos/agentwallet keygen --chain solana    # Solana only
```

Solana keys are Ed25519 keypairs, base58 encoded.

**Save the private keys immediately to secure storage.** This is the only time they're displayed.

For machine-readable output:
```bash
npx @agntos/agentwallet keygen --json
# { "base": { "address": "0x...", "privateKey": "0x...", "chain": "base" }, "solana": { "address": "7Kp...", "privateKe...