llm_wallet

# 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

```bash
# 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
```bash
llm-wallet create [--label <name>]
```
Creates a new HD wallet with encryption. Returns wallet address.

**Example:**
```bash
llm-wallet create --label "agent-wallet"
```

### Import Wallet
```bash
llm-wallet import --private-key <key> [--label <name>]
```
Import existing wallet from private key.

### Check Balance
```bash
llm-wallet balance
```
Shows USDC balance and native token balance on current network.

### Transaction History
```bash
llm-wallet history
```
View all transactions and payments made from this wallet.

## Spending Limits

### Set Limits
```bash
llm-wallet set-limit --per-tx <amount> --daily <amount>
```
Set per-transaction and daily spending caps in USDC.

**Example:**
```bash
llm-wallet set-limit --per-tx 0.10 --daily 5.00
```

### Check Limits
```bash
llm-wallet get-limits
```
View current spending limits and daily usage.

## x402 Payments

### Make Payment
```bash
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:**
```bash
# 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 <url>`
2. Show user: URL, estimated cost, current limits
3. Wait...

# LLM Wallet Skill for OpenClaw

Enable OpenClaw agents to own crypto wallets and make x402 micropayments with USDC stablecoins.

## What This Skill Does

- **Wallet Management**: Create, import, and manage HD wallets with encryption
- **Check Balance**: View USDC and native token balances
- **Spending Limits**: Set per-transaction and daily spending caps
- **x402 Payments**: Make micropayments to paid APIs using USDC
- **Dynamic APIs**: Register paid APIs as reusable tools
- **Transaction History**: Track all payments and transactions

## Installation

### Prerequisites
- Node.js 20+
- OpenClaw installed

### Install Skill

**Option 1: Via ClawHub (Recommended)**
```bash
clawhub install llm-wallet
```

**Option 2: Manual Installation**
```bash
# Clone or copy this skill directory to your workspace
cp -r skills/llm-wallet ~/.openclaw/workspace/skills/

# Install MCP server
npm install -g llm-wallet-mcp
```

### Add to PATH
```bash
# Add to your shell profile (~/.bashrc, ~/.zshrc)
export PATH="/Users/agada/openclaw/skills/llm-wallet/bin:$PATH"
```

## Quick Start

### 1. Create Wallet
```bash
llm-wallet create --label "my-agent-wallet"
```

### 2. Set Spending Limits
```bash
llm-wallet set-limit --per-tx 0.10 --daily 5.00
```

### 3. Fund Wallet (Testnet)
Visit: https://faucet.polygon.technology/
- Select "USDC" token
- Select "Polygon Amoy" network
- Paste your wallet address
- Request testnet USDC (free)

### 4. Check Balance
```bash
llm-wallet balance
```

### 5. Make Payment (with Agent)
```
User: "What's the weather in London?"

Agent: "I'll check the weather API. Cost: $0.001 USDC. Approve?"

User: "Yes"

Agent executes: llm-wallet pay "https://api.weather.com/current?location=London"
```

## Usage in OpenClaw

### Agent Workflow

The agent will automatically:
1. Detect when paid APIs are needed
2. Check cost via `llm-wallet check-payment`
3. Ask user for approval
4. Execute payment via `llm-wallet pay`
5. Return API response with transaction confirmation

###...