Pi Wallet Extension

CDP Agentic Wallet + x402 payments for pi-coding-agent.

Installation

# Via pi CLI
pi install npm:@0xkobold/pi-wallet

# Or in pi-config.ts
{
  extensions: [
    'npm:@0xkobold/pi-wallet'
  ]
}

# Or temporary (testing)
pi -e npm:@0xkobold/pi-wallet

Features

• 🪙 CDP Agentic Wallet - Zero setup, email-based authentication
• 💳 x402 Protocol - Machine-to-machine payments
• ⛓️ Base L2 - Mainnet (8453) and Sepolia (84532)
• 🔒 Secure - Config stored with 0600 permissions
• 📁 Portable - Works with or without .0xkobold directory
• ⚙️ Configurable - Environment variables for custom paths

Quick Start

# Create wallet
/wallet-create --email me@example.com

# Check status  
/wallet-status

# Send ETH
/wallet-send --to 0x742d35... --amount 0.01

# Send USDC
/wallet-send --to 0x742d35... --amount 10 --token USDC

# Trade tokens
/wallet-trade 10 USDC ETH

# Pay via x402
/wallet-x402 --url https://api.service.com/pay --budget 0.001

Configuration

Environment Variables

Variable	Description	Default
PI_WALLET_DIR	Custom storage directory	~/.pi/wallet or ~/.0xkobold/wallets
PI_WALLET_CHAIN	Default chain	sepolia
PI_WALLET_MAX_AMOUNT	Max transaction amount	100

Config File

Stored at PI_WALLET_DIR/config.json:

{
  "activeProvider": "agentic",
  "agentic": {
    "email": "me@example.com",
    "authenticated": true,
    "address": "0x742d35..."
  },
  "settings": {
    "defaultChain": "sepolia",
    "maxTransactionAmount": "100",
    "requireConfirmation": true
  }
}

Commands

Command	Description
/wallet create --email E	Create CDP Agentic Wallet
/wallet status	Check status and balances
/wallet send --to ADDR --amount N [--token T] [--chain C]	Send crypto
/wallet trade AMOUNT FROM TO	Swap tokens
/wallet x402 --url URL [--budget N]	Pay via x402

Chains

Chain	Chain ID	Explorer
Base	8453	https://basescan.org
Base Sepolia	84532	https://sepolia.basescan.org

Tools

wallet_send

{
  to: "0x742d35...",
  amount: "0.01",
  token?: "ETH" | "USDC",
  chain?: "base" | "sepolia"
}

wallet_x402_pay

{
  url: "https://api.example.com",
  maxBudget?: 0.01
}

Prerequisites

# Install CDP Agentic Wallet
npm install -g @coinbase/awal

# Or use via npx (no install)
npx awal status

Local Development

git clone https://github.com/0xKobold/pi-wallet
cd pi-wallet
npm install
npm run build
pi install ./

Testing

npm test

Security

• Config stored with 0o600 permissions (owner only)
• No private keys stored locally
• Atomic writes prevent corruption
• Optional transaction confirmations

License

MIT © 0xKobold