LLM Wallet - x402 stabelcoin payments on Polygon

LLM Wallet - Crypto Wallet & x402 Micropayments

Use llm-wallet commands to manage crypto wallets and make micropayments to paid APIs using USDC stablecoins on Polygon blockchain.

Default Network: Polygon Testnet (polygon-amoy) - safe for testing Facilitator: https://x402-amoy.polygon.technology

Quick Start

# Create wallet
llm-wallet create
Check balance
llm-wallet balance
Set spending limits (recommended)
llm-wallet set-limit --per-tx 0.10 --daily 5.00
View transaction history
llm-wallet history

Wallet Management

Create Wallet

llm-wallet create [--label ]

Example:

llm-wallet create --label "agent-wallet"

Import Wallet

llm-wallet import --private-key  [--label ]

Check Balance

llm-wallet balance

Transaction History

llm-wallet history

Spending Limits

Set Limits

llm-wallet set-limit --per-tx  --daily 

Example:

llm-wallet set-limit --per-tx 0.10 --daily 5.00

Check Limits

llm-wallet get-limits

x402 Payments

Make Payment

llm-wallet pay  [--method GET|POST] [--body ]

⚠️ IMPORTANT: Always ask user for approval before making payments!

Example:

# Ask user: "I need to make a payment to https://api.example.com/weather. Cost: $0.001 USDC. Approve?"
llm-wallet pay "https://api.example.com/weather?location=London"

Workflow: 1. Check if payment is needed: llm-wallet check-payment 2. Show user: URL, estimated cost, current limits 3. Wait for user approval 4. Execute: llm-wallet pay 5. Confirm completion and show transaction ID

Check Payment (Pre-flight)

llm-wallet check-payment 

Dynamic API Registration

Register API

llm-wallet register-api  --name 

Example:

llm-wallet register-api "https://api.example.com/weather" --name weather_api

List Registered APIs

llm-wallet list-apis

Call Registered API

llm-wallet call-api  [--params ]

Example:

# Ask user for approval first if cost > 0
llm-wallet call-api weather_api --params '{"location": "London"}'

Unregister API

llm-wallet unregister-api 

Seller Tools (Advanced)

Verify Payment

llm-wallet verify-payment --header  --requirements 

Create Payment Requirements

llm-wallet create-requirements --price  --pay-to 
 --url 

Safety Rules

1. Network Default: Always uses polygon-amoy (testnet) unless configured otherwise 2. Approval Required: Always ask user before making payments 3. Spending Limits: Check limits before payment attempts 4. Transaction Logging: All payments are logged with timestamps 5. Encryption: Wallets are encrypted with AES-256-GCM

Configuration

Environment Variables

Network Info

Common Workflows

First Time Setup

# 1. Create wallet
llm-wallet create --label "my-agent"
2. Set spending limits
llm-wallet set-limit --per-tx 0.10 --daily 5.00
3. Check balance (will be 0 initially)
llm-wallet balance
4. Fund wallet with testnet USDC
User needs to: visit https://faucet.polygon.technology/

Making a Payment

# 1. Pre-check payment
llm-wallet check-payment "https://api.example.com/weather?location=London"
2. Show user: URL, cost estimate, current limits
3. Ask user: "Approve payment of $0.001 USDC to https://api.example.com/weather?"
4. If approved, execute payment
llm-wallet pay "https://api.example.com/weather?location=London"
5. Confirm and show transaction ID
llm-wallet history

Registering a Paid API

# 1. Register the API
llm-wallet register-api "https://api.example.com/translate" --name translate_api
2. List available APIs
llm-wallet list-apis
3. Call the API (with approval)
llm-wallet call-api translate_api --params '{"text": "hello", "to": "es"}'
4. View payment in history
llm-wallet history

Error Handling

References

See references/ folder for:

Notes

# Create wallet
llm-wallet create
Check balance
llm-wallet balance
Set spending limits (recommended)
llm-wallet set-limit --per-tx 0.10 --daily 5.00
View transaction history
llm-wallet history

Environment Variables

Network Info