# Send LLM Wallet - x402 stabelcoin payments on Polygon to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "llm-wallet",
    "name": "LLM Wallet - x402 stabelcoin payments on Polygon",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/AkshatGada/llm-wallet",
    "canonicalUrl": "https://clawhub.ai/AkshatGada/llm-wallet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/llm-wallet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=llm-wallet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/examples.md",
      "references/wallet-setup.md",
      "references/x402-protocol.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/llm-wallet"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/llm-wallet",
    "downloadUrl": "https://openagent3.xyz/downloads/llm-wallet",
    "agentUrl": "https://openagent3.xyz/skills/llm-wallet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/llm-wallet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/llm-wallet/agent.md"
  }
}
```
## Documentation

### 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

### Create Wallet

llm-wallet create [--label <name>]

Creates a new HD wallet with encryption. Returns wallet address.

Example:

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

### Import Wallet

llm-wallet import --private-key <key> [--label <name>]

Import existing wallet from private key.

### Check Balance

llm-wallet balance

Shows USDC balance and native token balance on current network.

### Transaction History

llm-wallet history

View all transactions and payments made from this wallet.

### Set Limits

llm-wallet set-limit --per-tx <amount> --daily <amount>

Set per-transaction and daily spending caps in USDC.

Example:

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

### Check Limits

llm-wallet get-limits

View current spending limits and daily usage.

### Make Payment

llm-wallet pay <url> [--method GET|POST] [--body <json>]

Make x402 micropayment to a paid API endpoint.

⚠️ 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:

Check if payment is needed: llm-wallet check-payment <url>
Show user: URL, estimated cost, current limits
Wait for user approval
Execute: llm-wallet pay <url>
Confirm completion and show transaction ID

### Check Payment (Pre-flight)

llm-wallet check-payment <url>

Checks if wallet can afford payment without executing it.

### Register API

llm-wallet register-api <url> --name <tool_name>

Register a paid API endpoint as a reusable tool.

Example:

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

### List Registered APIs

llm-wallet list-apis

Show all registered API tools.

### Call Registered API

llm-wallet call-api <tool_name> [--params <json>]

Execute a registered API tool. Requires approval if payment needed.

Example:

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

### Unregister API

llm-wallet unregister-api <tool_name>

Remove a registered API tool.

### Verify Payment

llm-wallet verify-payment --header <x-payment-header> --requirements <json>

Verify incoming payment from a buyer (seller-side).

### Create Payment Requirements

llm-wallet create-requirements --price <amount> --pay-to <address> --url <resource-url>

Generate payment requirements for a protected resource.

### Safety Rules

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

### Environment Variables

WALLET_ENCRYPTION_KEY - Wallet encryption key (32+ chars, auto-generated if missing)
WALLET_NETWORK - Network selection (default: polygon-amoy | polygon)
FACILITATOR_URL - Custom facilitator URL (auto-configured)
WALLET_MAX_TX_AMOUNT - Per-transaction limit override
WALLET_DAILY_LIMIT - Daily limit override

### Network Info

Polygon Testnet (Amoy): Chain ID 80002, Facilitator: https://x402-amoy.polygon.technology
Polygon Mainnet: Chain ID 137, Facilitator: https://x402.polygon.technology

### 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

Insufficient Balance: Show error and guide user to faucet (testnet) or funding instructions (mainnet)
Payment Rejected: Transaction reverted, check error message for details
Limit Exceeded: Show current limits and daily usage, suggest increasing limits
Network Timeout: Retry with exponential backoff (max 3 attempts)

### References

See references/ folder for:

x402-protocol.md - x402 payment protocol overview
wallet-setup.md - Detailed wallet setup guide
examples.md - More usage examples

### Notes

All amounts are in USDC (6 decimals)
Default network is testnet for safety
Testnet USDC has no real value
Always verify network before mainnet usage
Keep encryption key secure (never share or commit)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: AkshatGada
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/llm-wallet)
- [Send to Agent page](https://openagent3.xyz/skills/llm-wallet/agent)
- [JSON manifest](https://openagent3.xyz/skills/llm-wallet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/llm-wallet/agent.md)
- [Download page](https://openagent3.xyz/downloads/llm-wallet)