💼 WalletKit — Agent Wallet Provisioning API

Stripe for agent wallets. One API call provisions a funded Base wallet for your agent in under 1 second.

What It Does

Every AI agent eventually needs to transact on-chain. WalletKit makes wallet provisioning instant and effortless:

• POST /api/wallets → Returns a new Base wallet address + private key, pre-funded with USDC from our treasury
• GET /api/wallets/:address → Query USDC balance for any wallet

Built on viem + Base mainnet. Framework-agnostic. Works with any agent stack.

Quick Start

1. Install dependencies

npm install

2. Configure environment

Create .env:

TREASURY_PRIVATE_KEY=0x...  # Your treasury wallet private key
BASE_RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
PORT=3403

3. Run the API

npm run dev

4. Create a wallet

curl -X POST http://localhost:3403/api/wallets \
  -H "Content-Type: application/json" \
  -d '{"fundAmount": 1}'

Response:

{
  "address": "0xABC...",
  "privateKey": "0x123...",
  "fundedAmount": "1.0",
  "currency": "USDC",
  "chain": "base",
  "txHash": "0xDEF..."
}

⚠️ Security: The private key is returned ONCE. Store it securely. We never log or persist it.

API Reference

POST /api/wallets

Provisions a new wallet and funds it with USDC.

Request body:

{
  "fundAmount": 1  // Optional, defaults to 1 USDC
}

Response:

{
  "address": "0x...",
  "privateKey": "0x...",
  "fundedAmount": "1.0",
  "currency": "USDC",
  "chain": "base",
  "txHash": "0x..."
}

GET /api/wallets/:address

Query USDC balance for a wallet.

Response:

{
  "address": "0x...",
  "balance": "5.42",
  "currency": "USDC",
  "chain": "base"
}

Pricing

• Free tier: 10 wallets/month
• Pay-as-you-go: $0.001 per wallet + 0.1% fee on funded amounts

Contact: Zoë for enterprise pricing.

Security

• Private keys generated client-side using viem/accounts
• Treasury key required to fund wallets (never exposed in API responses)
• HTTPS recommended for production (use reverse proxy like Caddy or nginx)

Stack

• Framework: Express.js (TypeScript)
• Chain: Base mainnet
• Wallet lib: viem v2
• Funding: USDC via treasury wallet

Roadmap

• [ ] API key authentication
• [ ] Webhook notifications on wallet creation
• [ ] Support for ETH funding (not just USDC)
• [ ] Rate limiting (Redis-backed)
• [ ] Polygon + Ethereum support

License

MIT — built by Zoë

Questions? Open an issue or reach out on Discord.