Agent Crypto Wallet

Cryptocurrency wallet system for AI agents. Enables secure storage and management of Bitcoin (BTC), USDT (ERC20/TRC20), and USDC (Base), with support for agent-to-agent payments via x402 protocol and trading on major exchanges.

Features

• Multi-Chain Support: Bitcoin, Ethereum, Base, and TRON networks
• Secure Storage: AES-256-GCM encryption for all credentials
• MPC Wallets: Non-custodial key management via Coinbase CDP
• Agent Payments: x402 protocol for seamless agent-to-agent transactions
• Exchange Trading: Trade on Binance and Coinbase
• HD Wallets: BIP39/BIP44 hierarchical deterministic wallets
• OpenClaw Integration: Ready-to-use skill for OpenClaw agents

Installation

npm install -g agent-crypto-wallet

Quick Start

Initialize Wallet

import AgentWallet from 'agent-crypto-wallet';

// Create or load wallet
const wallet = new AgentWallet({
  agentId: 'my-agent',
  mpc: { provider: 'cdp' }
});

// Initialize with existing wallet or generate new
await wallet.initialize({
  password: 'secure-password',
  generateSeed: true  // Set to false to load existing
});

Check Balances

// Get all addresses
const addresses = wallet.getAllAddresses();
console.log(addresses);
// { bitcoin: 'bc1q...', ethereum: '0x...', base: '0x...', tron: 'T...' }

// Get balance for specific asset
const btcBalance = await wallet.getBalance('BTC');
console.log(`BTC: ${btcBalance}`);

Send Payments

// Send payment via x402 protocol
await wallet.sendPayment({
  to: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
  amount: '100',
  asset: 'USDC-Base',
  protocol: 'x402'
});

// Send native payment
await wallet.sendPayment({
  to: 'bc1q...',
  amount: '0.001',
  asset: 'BTC',
  protocol: 'native'
});

Trade on Exchanges

// Buy BTC on Binance
await wallet.createOrder({
  exchange: 'binance',
  symbol: 'BTC/USDT',
  side: 'buy',
  amount: 0.001,
  type: 'market'
});

// Sell on Coinbase
await wallet.createOrder({
  exchange: 'coinbase',
  symbol: 'BTC-USD',
  side: 'sell',
  amount: 0.001,
  type: 'limit',
  price: 45000
});

Configuration

Environment Variables

# MPC Wallet (Coinbase CDP)
COINBASE_CDP_API_KEY=your_api_key
COINBASE_CDP_API_SECRET=your_secret

# Exchange APIs
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret
COINBASE_API_KEY=your_key
COINBASE_API_SECRET=your_secret

# Node URLs (optional)
ETHEREUM_NODE=https://eth-mainnet.alchemyapi.io/v2/YOUR_KEY
BASE_NODE=https://mainnet.base.org
TRON_NODE=https://api.trongrid.io

Supported Assets

Asset	Network	Address
BTC	Bitcoin	Native
USDT	Ethereum (ERC20)	0xdAC17F958D2ee523a2206206994597C13D831ec7
USDT	TRON (TRC20)	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
USDC	Base	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

OpenClaw Skill Usage

After installation, the wallet skill is automatically registered with OpenClaw. Use these commands:

"Initialize my crypto wallet"
"Show my wallet addresses"
"Check my BTC balance"
"Send 100 USDC to 0x742d..."
"Buy 0.001 BTC on Binance"

Security

• Encryption: All credentials encrypted with AES-256-GCM
• MPC Support: Multi-party computation for enhanced security
• Key Storage: Private keys never stored in plain text
• Sandboxed: All wallet operations run in isolated context

API Reference

AgentWallet

Constructor

new AgentWallet(options)

Options:

• agentId (string): Unique identifier for the agent
• mpc.provider (string): MPC provider ('cdp' or 'agentpayy')
• mpc.enabled (boolean): Enable MPC wallet (default: true)

Methods

initialize(options)

Initialize the wallet.

Options:

• password (string, required): Encryption password
• seedPhrase (string, optional): Existing seed phrase
• generateSeed (boolean, optional): Generate new seed (default: false)
• forceNew (boolean, optional): Create new wallet even if exists

getAddress(chain)

Get address for specific chain.

Parameters:

• chain (string): 'bitcoin', 'ethereum', 'base', 'tron'

getBalance(asset)

Get balance for specific asset.

Parameters:

• asset (string): 'BTC', 'USDT-ERC20', 'USDT-TRC20', 'USDC-Base'

sendPayment(params)

Send payment to another address.

Parameters:

• to (string, required): Recipient address
• amount (string|number, required): Amount to send
• asset (string, required): Asset to send
• protocol (string): 'x402' or 'native' (default: 'x402')

createOrder(params)

Create trading order on exchange.

Parameters:

• exchange (string, required): 'binance' or 'coinbase'
• symbol (string, required): Trading pair (e.g., 'BTC/USDT')
• side (string, required): 'buy' or 'sell'
• amount (number, required): Order amount
• type (string): 'market' or 'limit' (default: 'market')
• price (number): Required for limit orders

Development

# Clone repository
git clone https://github.com/clawfin/agent-crypto-wallet.git
cd agent-crypto-wallet

# Install dependencies
npm install

# Run tests
npm test

# Link for local development
npm link

License

MIT

Contributing

Contributions welcome! Please read our contributing guidelines.

Support

• GitHub Issues: https://github.com/clawfin/agent-crypto-wallet/issues
• Documentation: https://github.com/clawfin/agent-crypto-wallet/wiki