Agentic Wallet — Give Any AI Agent Its Own Crypto Wallet
Use this skill when an agent needs a crypto wallet to send/receive payments, interact with blockchain protocols, or pay for services via x402 or Machine Payments Protocol (MPP).
All commands use npx agentic-wallet <command>. No global installation required.
WHEN TO USE THIS SKILL
Use this skill when:
- - You need a wallet to pay for an x402-gated API
- You need to receive USDC payments for services you provide
- You need to check your wallet balance before making a purchase
- You need to set up a new wallet for the first time
- You need to back up or recover an existing wallet
PROVIDER SELECTION
Choose your wallet provider based on your requirements:
CODEBLOCK0
| Provider | Company | Type | Key Storage | Best For |
|---|
| coinbase | Coinbase | Managed | Coinbase servers | Production agents, compliance, x402 |
| tempo |
Stripe | Passkey | Local + Tempo network | Machine payments, service discovery |
|
openwallet | MoonPay | Self-custody | Encrypted local file | Full control, offline, multi-chain |
|
crossmint | Crossmint | Managed/API | Crossmint infrastructure | 50+ chains, custodial & non-custodial |
COMMAND REFERENCE
providers — List all wallet providers
CODEBLOCK1
setup — Create a new wallet
CODEBLOCK2
Options:
- -
--provider <name> — Required. One of: coinbase, tempo, openwallet, INLINECODE5 - INLINECODE6 — Target chain for openwallet (default:
base) - INLINECODE8 — Wallet name (default:
default) - INLINECODE10 — Path to file with encryption password (non-interactive openwallet)
- INLINECODE11 — Path to Crossmint server-side API key (non-interactive crossmint)
- INLINECODE12 — Crossmint chain:
evm, solana, aptos, sui, stellar (default: evm) - INLINECODE19 — Crossmint wallet:
smart or mpc (default: smart) - INLINECODE23 — No prompts (requires
--password-file for openwallet, --api-key-file for crossmint) - INLINECODE26 — JSON output for programmatic use
Non-interactive setup for autonomous agents:
CODEBLOCK3
balance — Check wallet balances
CODEBLOCK4
JSON output format:
CODEBLOCK5
status — Check authentication status
CODEBLOCK6
fund — Get funding instructions
CODEBLOCK7
Returns your wallet address and instructions for sending USDC on the configured chain.
backup — Backup a MoonPay local wallet to encrypted file
CODEBLOCK8
recover — Restore wallet from backup or seed phrase
CODEBLOCK9
schema — Machine-readable command schemas
CODEBLOCK10
STANDARD AGENT WORKFLOW
CODEBLOCK11
PROVIDER DETAILS
Coinbase Agentic Wallet
Managed wallet with enterprise compliance. Requires email authentication (OTP via email).
CODEBLOCK12
Features: KYT screening, OFAC compliance, spending guardrails, x402 support.
Prerequisite: Node.js 18+, email address.
Docs: https://docs.cdp.coinbase.com/agentic-wallet/welcome
Tempo Wallet (Stripe)
Passkey-based wallet optimized for machine payments. Requires browser for initial passkey setup.
CODEBLOCK13
Features: ~500ms finality, sub-cent fees, MPP protocol, service discovery.
Prerequisite: Browser access for passkey registration.
Docs: https://docs.tempo.xyz/
MoonPay Local Wallet (OpenWallet Standard)
Self-custody wallet with AES-256-GCM encryption. Fully local, works offline.
CODEBLOCK14
Features: Local encrypted storage, multi-chain, backup/recovery, policy-gated signing.
Supported chains: Base, Ethereum, Arbitrum, Optimism, Polygon.
Docs: https://docs.openwallet.sh/
Crossmint Wallet
API-first wallet supporting 50+ chains. Both interactive and non-interactive modes.
CODEBLOCK15
Features: 50+ chains (evm, solana, aptos, sui, stellar), smart + mpc wallets, custodial & non-custodial.
Custody: Custodial uses API-key signer (agent-friendly). Non-custodial uses email signer.
Storage: Wallet records at ~/.agent-arena/crossmint-wallets/. No credentials stored.
Prerequisite: Node.js 18+. Interactive mode needs Crossmint CLI (npm install -g @crossmint/cli). Non-interactive needs only an API key.
Docs: https://docs.crossmint.com/introduction/platform-overview
SUPPORTED CHAINS (MoonPay Local Wallet)
| Chain | Chain ID | Native Token |
|---|
| Base | 8453 | ETH |
| Ethereum |
1 | ETH |
| Arbitrum One | 42161 | ETH |
| Optimism | 10 | ETH |
| Polygon | 137 | POL |
SECURITY
- - Zero key exposure — This CLI is a passthrough wrapper. Private keys are handled exclusively by provider CLIs/SDKs.
- Encrypted at rest — MoonPay local wallets use AES-256-GCM with scrypt key derivation.
- File permissions — Wallet files are created with mode 0600 (owner-only read/write).
- Path traversal prevention — Wallet names are validated against strict patterns.
- No telemetry — No data is sent to any third party. All operations are local or direct to the provider.
TROUBLESHOOTING
"Wallet not found" — Verify name: npx agentic-wallet status --provider openwallet --json
"Wrong password" — Passwords are case-sensitive. Check file has no trailing newlines.
"Provider not authenticated" — Re-run: npx agentic-wallet setup --provider <provider>
"Balance check failed" — Check internet connectivity. RPC endpoints may be rate-limited.
LINKS
- - npm: https://www.npmjs.com/package/agentic-wallet
- GitHub: https://github.com/smukh/agentic-wallet
- Coinbase docs: https://docs.cdp.coinbase.com/agentic-wallet/welcome
- Tempo docs: https://docs.tempo.xyz/
- OpenWallet docs: https://docs.openwallet.sh/
- Crossmint docs: https://docs.crossmint.com/introduction/platform-overview
Copyright (c) 2026 BlockQuest Labs Incorporated. All rights reserved.
Licensed under AGPL-3.0-only.
Agentic Wallet — 为任何AI代理提供专属加密钱包
当代理需要加密钱包来发送/接收支付、与区块链协议交互，或通过x402或机器支付协议（MPP）支付服务费用时，使用此技能。
所有命令均使用 npx agentic-wallet ，无需全局安装。
何时使用此技能
在以下情况下使用此技能：
- - 需要钱包支付x402网关API费用
- 需要接收您提供服务的USDC付款
- 需要在购买前检查钱包余额
- 需要首次设置新钱包
- 需要备份或恢复现有钱包
提供商选择
根据您的需求选择钱包提供商：
如果需要合规（KYT、OFAC筛查） → 使用 coinbase
如果需要快速机器支付（约500ms） → 使用 tempo
如果需要完全自托管/离线访问 → 使用 openwallet
如果需要50+条链（EVM + Solana + Stellar） → 使用 crossmint
如果需要托管+非托管选项 → 使用 crossmint
| 提供商 | 公司 | 类型 | 密钥存储 | 最佳用途 |
|---|
| coinbase | Coinbase | 托管 | Coinbase服务器 | 生产代理、合规、x402 |
| tempo |
Stripe | 通行密钥 | 本地 + Tempo网络 | 机器支付、服务发现 |
|
openwallet | MoonPay | 自托管 | 加密本地文件 | 完全控制、离线、多链 |
|
crossmint | Crossmint | 托管/API | Crossmint基础设施 | 50+条链、托管与非托管 |
命令参考
providers — 列出所有钱包提供商
bash
npx agentic-wallet providers --json
setup — 创建新钱包
bash
交互式（将提示输入密码/认证）
npx agentic-wallet setup --provider
非交互式OpenWallet（自托管）
npx agentic-wallet setup \
--provider openwallet \
--name <钱包名称> \
--chain \
--password-file <密码文件路径> \
--non-interactive \
--json
非交互式Crossmint（托管，API密钥签名器）
npx agentic-wallet setup \
--provider crossmint \
--name <钱包名称> \
--api-key-file \
--chain-type \
--wallet-type \
--non-interactive \
--json
选项：
- - --provider <名称> — 必需。可选值：coinbase、tempo、openwallet、crossmint
- --chain <名称> — openwallet的目标链（默认：base）
- --name <名称> — 钱包名称（默认：default）
- --password-file <路径> — 包含加密密码的文件路径（非交互式openwallet）
- --api-key-file <路径> — Crossmint服务器端API密钥文件路径（非交互式crossmint）
- --chain-type <类型> — Crossmint链：evm、solana、aptos、sui、stellar（默认：evm）
- --wallet-type <类型> — Crossmint钱包：smart或mpc（默认：smart）
- --non-interactive — 无提示（openwallet需要--password-file，crossmint需要--api-key-file）
- --json — JSON格式输出，用于程序化使用
自主代理的非交互式设置：
bash
--- OpenWallet（自托管） ---
echo your-strong-password > ~/.secrets/wallet-pw.txt
chmod 600 ~/.secrets/wallet-pw.txt
npx agentic-wallet setup \
--provider openwallet \
--name trading-agent \
--chain base \
--password-file ~/.secrets/wallet-pw.txt \
--non-interactive --json
--- Crossmint（托管，无需浏览器） ---
echo your-crossmint-server-api-key > ~/.secrets/crossmint-key.txt
chmod 600 ~/.secrets/crossmint-key.txt
npx agentic-wallet setup \
--provider crossmint \
--name my-agent \
--api-key-file ~/.secrets/crossmint-key.txt \
--chain-type evm \
--wallet-type smart \
--non-interactive --json
balance — 检查钱包余额
bash
所有提供商的所有钱包
npx agentic-wallet balance --all --json
特定提供商
npx agentic-wallet balance --provider openwallet --json
过滤字段（减少token消耗）
npx agentic-wallet balance --all --json --fields address,balanceUSDC
JSON输出格式：
json
[
{
provider: openwallet,
name: trading-agent,
address: 0x...,
chain: Base,
chainId: 8453,
balanceUSDC: 100.50,
balanceETH: 0.01,
status: ok
}
]
status — 检查认证状态
bash
npx agentic-wallet status --json
npx agentic-wallet status --provider tempo --json
fund — 获取充值说明
bash
npx agentic-wallet fund --provider openwallet --json
返回您的钱包地址以及在配置链上发送USDC的说明。
backup — 将MoonPay本地钱包备份到加密文件
bash
npx agentic-wallet backup \
--name <钱包名称> \
--output <目录> \
--password-file <路径> \
--json
recover — 从备份或助记词恢复钱包
bash
从备份文件恢复
npx agentic-wallet recover \
--from <备份文件路径.json> \
--name <新钱包名称> \
--password-file <路径> \
--json
从12个单词的助记词恢复（仅交互式）
npx agentic-wallet recover --seed-phrase --name <钱包名称>
schema — 机器可读的命令模式
bash
所有命令
npx agentic-wallet schema
特定命令
npx agentic-wallet schema setup
标准代理工作流程
- 1. 检查 → npx agentic-wallet providers --json
- 创建 → npx agentic-wallet setup --provider openwallet --name my-agent --json
- 验证 → npx agentic-wallet balance --all --json
- 充值 → npx agentic-wallet fund --provider openwallet --json
- 使用 → 使用钱包地址通过x402或MPP进行支付
提供商详情
Coinbase Agentic Wallet
具有企业合规性的托管钱包。需要电子邮件认证（通过电子邮件发送OTP）。
bash
npx agentic-wallet setup --provider coinbase
功能：KYT筛查、OFAC合规、支出护栏、x402支持。
前提条件：Node.js 18+、电子邮件地址。
文档：https://docs.cdp.coinbase.com/agentic-wallet/welcome
Tempo Wallet (Stripe)
基于通行密钥的钱包，针对机器支付进行了优化。初始通行密钥设置需要浏览器。
bash
npx agentic-wallet setup --provider tempo
功能：约500ms最终确认、低于1美分费用、MPP协议、服务发现。
前提条件：需要浏览器访问以注册通行密钥。
文档：https://docs.tempo.xyz/
MoonPay Local Wallet (OpenWallet标准)
使用AES-256-GCM加密的自托管钱包。完全本地化，支持离线使用。
bash
npx agentic-wallet setup --provider openwallet --name my-wallet --chain base --json
功能：本地加密存储、多链、备份/恢复、策略门控签名。
支持的链：Base、Ethereum、Arbitrum、Optimism、Polygon。
文档：https://docs.openwallet.sh/
Crossmint Wallet
支持50+条链的API优先钱包。支持交互式和非交互式模式。
bash
交互式（浏览器登录 + 提示）
npx agentic-wallet setup --provider crossmint --name my-wallet
非交互式（API密钥，无需浏览器 — 适合代理）
npx agentic-wallet setup --provider crossmint --name my-agent \
--api-key-file ~/.secrets/crossmint
