gentsWallets
Get Started

Introduction

AgentsWallets is the wallet CLI for AI agents — local custody, policy guardrails, DeFi trading, perpetual contracts, and Security Guard.

What is AgentsWallets?

AgentsWallets is a CLI tool that gives AI agents their own crypto wallets. Think of it as MetaMask for agents — but with built-in spending policies, audit trails, and a non-custodial architecture where private keys never leave the local machine.

npm install -g @agentswallets/cli

Core principles

Local-first custody

All secrets (mnemonic, private keys) are generated and stored locally, encrypted at rest with AES-256-GCM + scrypt. New wallets use BIP-39 HD derivation, producing both EVM and Solana addresses from a single mnemonic.

Policy-first design

Every transaction is evaluated against configurable guardrails before it reaches the network:

  • Per-transaction spending limit — cap individual transfers
  • Daily spending limit — prevent runaway spend over 24 hours
  • Allowed tokens list — restrict which tokens the agent can use
  • Address allowlist — limit destinations to known-safe addresses
  • Approval threshold — require human approval above a dollar amount
  • Transaction count cap — limit how many transactions per day

Structured output

All commands produce machine-readable JSON by default in non-TTY environments, making it trivial for agents to parse responses:

{
  "ok": true,
  "data": { "id": "2b9123ea-...", "name": "bot", "address": "0x..." },
  "error": null,
  "meta": { "request_id": "req_abc" }
}

Networks

AgentsWallets supports six chains:

ChainChain IDNative tokenStablecoins
Ethereum1ETHUSDC, USDT
BNB Chain56BNBUSDC, USDT
Base8453ETHUSDC
Polygon137POLUSDC, USDC.e, USDT
Arbitrum42161ETHUSDC, USDT
Solana—SOLUSDC, USDT

Status

AgentsWallets is in public alpha. The current scope covers:

  • Wallet core (create, balance, send, deposit address)
  • Multi-chain support (Ethereum, BNB, Base, Polygon, Arbitrum, Solana)
  • HD wallet architecture (BIP-39 mnemonic → EVM + Solana keys)
  • Security policies (limits, allowlists, approval thresholds)
  • DeFi trading (OKX DEX swaps, cross-chain bridges)
  • Market data and token discovery
  • Perpetual contracts (Hyperliquid integration)
  • Security Guard (red/yellow-line rules, anomaly detection)
  • Polymarket integration (search markets, buy/sell positions)
  • Audit chain (tamper-evident SHA-256 hash chain)

509 tests covering wallet operations, policy enforcement, DeFi trading, perpetual contracts, and security guard rules.

Next steps