Back to Skills

agentwallet

Wallets for AI agents with x402 and MPP payment signing, referral rewards, and policy-controlled actions.

4stars2forksUpdated 6/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About agentwallet

AgentWallet provides server-side cryptocurrency wallets specifically designed for AI agents to interact with paid APIs and services. It solves the challenge of enabling autonomous agents to make micropayments for API access without requiring manual intervention or exposing private keys. Wallets are provisioned after email OTP verification, and all cryptographic signing operations happen server-side with policy-based controls to ensure safe, governed spending.

The skill supports x402 payment protocol for pay-per-use APIs and MPP (Micropayment Protocol) with Tempo method. It offers a streamlined one-step payment proxy through the x402/fetch endpoint that automatically handles 402 payment detection, transaction signing, and retry logic. Support spans multiple blockchain networks including Ethereum mainnet, Base, Optimism, Polygon, Arbitrum, BSC, and Solana, with payment tokens including USDC, USDT, and CASH. The system includes built-in referral rewards, dry-run capabilities for cost preview, and comprehensive wallet management features.

Ideal for AI agent developers building autonomous systems that need to consume paid APIs, researchers creating agents that interact with decentralized services, and teams deploying AI applications requiring micropayment capabilities. The policy-controlled architecture ensures agents can transact safely within predefined spending limits while maintaining security through server-side key management. Configuration persistence through local files enables seamless reconnection without repeated authentication.

FAQ

How do I check if my agent is already connected to AgentWallet?

Check for the existence of ~/.agentwallet/config.json file. If this file exists and contains an apiToken field, your agent is already connected and authenticated. Do not prompt for email in this case.

What blockchain networks and tokens does AgentWallet support?

AgentWallet supports EVM chains (Ethereum mainnet, Base, Optimism, Polygon, Arbitrum, BSC, and their testnets) and Solana (mainnet and devnet). Supported payment tokens are USDC, USDT, and CASH. The system can automatically select the optimal chain based on available balance.

How does the x402/fetch one-step payment proxy work?

The x402/fetch endpoint acts as a payment proxy - you simply send the target API URL and request body, and the server automatically detects 402 payment requirements, signs the transaction using your wallet, and retries the request with payment proof. This eliminates manual payment handling.

Can I preview payment costs before executing a transaction?

Yes, add 'dryRun': true to your x402/fetch request. This returns payment details including chain, amount, and policy check results without actually executing the payment or API call.

What happens if my wallet policy denies a payment?

If a payment exceeds policy limits or violates spending rules, the request fails with a POLICY_DENIED error (HTTP 403). Policy checks happen before any transaction is signed, preventing unauthorized spending.

All Files

3 files
HEARTBEAT.md3.0 KB
View
SKILL.md20.7 KB
View
skill.json0.7 KB
View

Install agentwallet

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill