Agentic Wallet

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:

IF you need compliance (KYT, OFAC screening)  → USE coinbase
IF you need fast machine payments (~500ms)     → USE tempo
IF you need full self-custody / offline access  → USE openwallet
IF you need 50+ chains (EVM + Solana + Stellar) → USE crossmint
IF you need custodial + non-custodial options  → USE crossmint

COMMAND REFERENCE

providers — List all wallet providers

npx agentic-wallet providers --json

setup — Create a new wallet

# Interactive (will prompt for password/auth)
npx agentic-wallet setup --provider <coinbase|tempo|openwallet|crossmint>

# Non-interactive OpenWallet (self-custody)
npx agentic-wallet setup \
  --provider openwallet \
  --name <wallet-name> \
  --chain <base|ethereum|arbitrum|optimism|polygon> \
  --password-file <path-to-password-file> \
  --non-interactive \
  --json

# Non-interactive Crossmint (custodial, API-key signer)
npx agentic-wallet setup \
  --provider crossmint \
  --name <wallet-name> \
  --api-key-file <path-to-api-key-file> \
  --chain-type <evm|solana|aptos|sui|stellar> \
  --wallet-type <smart|mpc> \
  --non-interactive \
  --json

Options:

• --provider <name> — Required. One of: coinbase, tempo, openwallet, crossmint
• --chain <name> — Target chain for openwallet (default: base)
• --name <name> — Wallet name (default: default)
• --password-file <path> — Path to file with encryption password (non-interactive openwallet)
• --api-key-file <path> — Path to Crossmint server-side API key (non-interactive crossmint)
• --chain-type <type> — Crossmint chain: evm, solana, aptos, sui, stellar (default: evm)
• --wallet-type <type> — Crossmint wallet: smart or mpc (default: smart)
• --non-interactive — No prompts (requires --password-file for openwallet, --api-key-file for crossmint)
• --json — JSON output for programmatic use

Non-interactive setup for autonomous agents:

# --- OpenWallet (self-custody) ---
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 (custodial, no browser needed) ---
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 — Check wallet balances

# All wallets across all providers
npx agentic-wallet balance --all --json

# Specific provider
npx agentic-wallet balance --provider openwallet --json

# Filter fields (reduce token consumption)
npx agentic-wallet balance --all --json --fields address,balanceUSDC

JSON output format:

[
  {
    "provider": "openwallet",
    "name": "trading-agent",
    "address": "0x...",
    "chain": "Base",
    "chainId": 8453,
    "balanceUSDC": "100.50",
    "balanceETH": "0.01",
    "status": "ok"
  }
]

status — Check authentication status

npx agentic-wallet status --json
npx agentic-wallet status --provider tempo --json

fund — Get funding instructions

npx agentic-wallet fund --provider openwallet --json

Returns your wallet address and instructions for sending USDC on the configured chain.

backup — Backup a MoonPay local wallet to encrypted file

npx agentic-wallet backup \
  --name <wallet-name> \
  --output <directory> \
  --password-file <path> \
  --json

recover — Restore wallet from backup or seed phrase

# From backup file
npx agentic-wallet recover \
  --from <path-to-backup.json> \
  --name <new-wallet-name> \
  --password-file <path> \
  --json

# From 12-word seed phrase (interactive only)
npx agentic-wallet recover --seed-phrase --name <wallet-name>

schema — Machine-readable command schemas

# All commands
npx agentic-wallet schema

# Specific command
npx agentic-wallet schema setup

STANDARD AGENT WORKFLOW

1. CHECK     → npx agentic-wallet providers --json
2. CREATE    → npx agentic-wallet setup --provider openwallet --name my-agent --json
3. VERIFY    → npx agentic-wallet balance --all --json
4. FUND      → npx agentic-wallet fund --provider openwallet --json
5. USE       → Make payments via x402 or MPP using wallet address

PROVIDER DETAILS

Coinbase Agentic Wallet

Managed wallet with enterprise compliance. Requires email authentication (OTP via email).

npx agentic-wallet setup --provider coinbase

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.

npx agentic-wallet setup --provider tempo

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.

npx agentic-wallet setup --provider openwallet --name my-wallet --chain base --json

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.

# Interactive (browser login + prompts)
npx agentic-wallet setup --provider crossmint --name my-wallet

# Non-interactive (API key, no browser — ideal for agents)
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

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)

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.