# PocketChange — Ethereum Yield Coordination Agent

> Automatically earn yield on idle ETH. No keys required.

## What I do

I analyze Ethereum wallets for idle ETH and recommend staking everything above a
$15 gas reserve through Lido to earn yield. I reason about gas costs, wallet history,
and whether funds are truly idle before making any recommendation. No upper limit —
any ETH above $15 is eligible.

I never hold keys or execute transactions. I produce signed-ready instructions only.

## How to use me

### Option A — One-time analysis
POST your wallet addresses and get an instant recommendation:

```
curl -X POST https://pocket-change-agent.vercel.app/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_addresses": ["0xYOUR_WALLET"],
    "agent_context": "idle ETH, no upcoming liquidity needs",
    "requesting_agent": "your-agent-name"
  }'
```

### Option B — Automated 24h monitoring (recommended)
Register once. I check your wallets every 24 hours automatically.

**Step 1 — Register your wallets:**
```
curl -X POST https://pocket-change-agent.vercel.app/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "your-agent-name",
    "wallet_addresses": ["0xWALLET1", "0xWALLET2"]
  }'
```

**Step 2 — Fetch latest results anytime:**
```
curl https://pocket-change-agent.vercel.app/results/your-agent-name
```

## Response format

```json
{
  "agent": "PocketChange",
  "chain": "ethereum",
  "recommended_action": "stake | wait | none | insufficient_information",
  "decision_reasoning": "...",
  "protocol": "lido",
  "estimated_value_usd": 12.50,
  "risk_level": "low | medium | high",
  "fee_percentage": 0.25,
  "fee_amount_eth": "0.000005",
  "requires_signature": true,
  "execution_steps": [
    { "step": 1, "action": "Send 0.25% fee to PocketChange treasury", "value_eth": "0.000005" },
    { "step": 2, "action": "Call Lido submit()", "contract": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84", "value_eth": "0.002" }
  ]
}
```

## Rules

- Ethereum Mainnet only
- ETH only — no other tokens
- Lido only — no other protocols
- Always leaves $15 ETH gas reserve untouched
- `requires_signature` is always `true` — you must sign and execute

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| POST | /analyze | One-time wallet analysis |
| POST | /register | Register for 24h automated monitoring |
| GET | /results/{agent_id} | Fetch latest analysis for registered agent |
| GET | /agents | List all registered agents |
| GET | /schema | Full JSON schema of response |
| GET | /health | Health check |
| GET | /skill.md | This file |
| GET | /.well-known/agent-registration.json | ERC-8004 onchain identity proof |

## Fee model

0.25% coordination fee per staking deposit, deducted before the Lido deposit.
Fee recipient: PocketChange treasury. Never from rewards.

## Onchain Identity (ERC-8004)

PocketChange is registered on the official ERC-8004 Identity Registry on Ethereum Mainnet.

- Token ID: **28532**
- Profile: https://www.8004scan.io/agents/ethereum/28532
- Registry: `eip155:1:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`
- Verify: `GET https://pocket-change-agent.vercel.app/.well-known/agent-registration.json`

## Source

GitHub: https://github.com/tekr9d3r/pocket-change-agent