Agent Wallet

AgentWallet

Multi-chain wallet skill for AI agents. One seed phrase, all chains.

Quick Reference

| Command | Example | |---------|---------| | Create wallet | "Create a new wallet" | | Show addresses | "Show my addresses" / "What's my wallet?" | | Check balance | "Check my balance" / "How much USDC do I have?" | | Transfer | "Send 10 USDC to 0x..." / "Transfer 5 SOL to ..." | | Bridge | "Bridge 10 USDC from Base to Solana" | | Chain info | "What chains are supported?" |

Setup

New Wallet

User: "Create a new wallet"

Generates BIP-39 seed phrase, derives addresses for all chains. Shows seed ONCE with security warning.

Import Existing Wallet

User: "Import my wallet"

Response: "Add your seed phrase to .env as WALLET_SEED_PHRASE, then say 'Show my addresses' to verify."

No seed phrases in chat for imports - security first.

Environment

# Required for wallet operations
WALLET_SEED_PHRASE="your twelve word seed phrase goes here"
Optional
NETWORK=testnet          # testnet (default) or mainnet
SOLANA_RPC=              # Custom Solana RPC (defaults to public)
BASE_RPC=                # Custom Base RPC (defaults to public)
ETH_RPC=                 # Custom Ethereum RPC (defaults to public)

Commands

Create Wallet

Run: node scripts/wallet.js create

Output format:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔐 NEW WALLET GENERATED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️  CRITICAL: Save this seed phrase securely!
    It will NOT be shown again.
    Anyone with this phrase can access your funds.
Seed Phrase:
┌────────────────────────────────────────────┐
│ word1 word2 word3 word4 word5 word6        │
│ word7 word8 word9 word10 word11 word12     │
└────────────────────────────────────────────┘
Your Addresses:
├─ Solana:   7xK9...mP4q
├─ Base:     0x7a3B...4f2E
└─ Ethereum: 0x7a3B...4f2E (same as Base)
Add to .env:
WALLET_SEED_PHRASE="word1 word2 word3 ..."
Network: TESTNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Show Addresses

Run: node scripts/wallet.js addresses

Shows derived addresses without exposing seed.

Check Balance

Run: node scripts/wallet.js balance [chain]

Output includes native token + USDC balance per chain.

Transfer

Run: node scripts/wallet.js transfer

Examples:

Supported tokens per chain:

Bridge (Cross-Chain)

Run: node scripts/wallet.js bridge

Bridges USDC between chains using Circle CCTP V2.

Examples:

Note: Bridging takes 1-5 minutes (burn → attestation → mint). Requires USDC on source chain plus native tokens for gas.

Chain Info

Run: node scripts/wallet.js chains

Lists supported chains, networks, and USDC contract addresses.

Derivation Paths

All chains derive from single BIP-39 seed:

| Chain | Path | Standard | |-------|------|----------| | Solana | m/44'/501'/0'/0' | Solana/Phantom | | EVM (Base/Eth) | m/44'/60'/0'/0/0 | BIP-44 Ethereum |

EVM chains share the same address (same derivation path).

Security Model

Error Handling

| Error | Cause | Fix | |-------|-------|-----| | "WALLET_SEED_PHRASE not set" | Missing env var | Add seed to .env | | "Invalid seed phrase" | Wrong format | Must be 12 or 24 words | | "Insufficient balance" | Not enough funds | Check balance first | | "Invalid address" | Wrong format | Verify recipient address |

Chain References

For RPC endpoints, USDC addresses, and chain-specific details, see references/chains.md.

New Wallet

User: "Create a new wallet"

Generates BIP-39 seed phrase, derives addresses for all chains. Shows seed ONCE with security warning.

Import Existing Wallet

User: "Import my wallet"

Response: "Add your seed phrase to .env as WALLET_SEED_PHRASE, then say 'Show my addresses' to verify."

No seed phrases in chat for imports - security first.

Environment

# Required for wallet operations
WALLET_SEED_PHRASE="your twelve word seed phrase goes here"
Optional
NETWORK=testnet          # testnet (default) or mainnet
SOLANA_RPC=              # Custom Solana RPC (defaults to public)
BASE_RPC=                # Custom Base RPC (defaults to public)
ETH_RPC=                 # Custom Ethereum RPC (defaults to public)