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 . No global installation required.

WHEN TO USE THIS SKILL

Use this skill when:

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

| 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

npx agentic-wallet providers --json

setup — Create a new wallet

# Interactive (will prompt for password/auth)
npx agentic-wallet setup --provider 
Non-interactive OpenWallet (self-custody)
npx agentic-wallet setup \
  --provider openwallet \
  --name  \
  --chain  \
  --password-file  \
  --non-interactive \
  --json
Non-interactive Crossmint (custodial, API-key signer)
npx agentic-wallet setup \
  --provider crossmint \
  --name  \
  --api-key-file  \
  --chain-type  \
  --wallet-type  \
  --non-interactive \
  --json

Options:

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  \
  --output  \
  --password-file  \
  --json

recover — Restore wallet from backup or seed phrase

# From backup file
npx agentic-wallet recover \
  --from  \
  --name  \
  --password-file  \
  --json
From 12-word seed phrase (interactive only)
npx agentic-wallet recover --seed-phrase --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)

| Chain | Chain ID | Native Token | |-------|----------|-------------| | Base | 8453 | ETH | | Ethereum | 1 | ETH | | Arbitrum One | 42161 | ETH | | Optimism | 10 | ETH | | Polygon | 137 | POL |

SECURITY

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 "Balance check failed" — Check internet connectivity. RPC endpoints may be rate-limited.

LINKS

Copyright (c) 2026 BlockQuest Labs Incorporated. All rights reserved. Licensed under AGPL-3.0-only.

"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 "Balance check failed" — Check internet connectivity. RPC endpoints may be rate-limited.