Add token economy section - micropayments for jobs

docs/FEDERATION_SPEC.md

@@ -258,8 +258,84 @@ POST /fed/route_job { job: {...}, target_server: "uuid" }
 1. **DHT or Gossip?** - Prefer gossip for simplicity, DHT for scale
 2. **Bootstrap server?** - Run centrally initially, then sunset
 3. **Anonymous agents?** - Require identity or allow pseudonyms
-4. **Job pricing?** - Let agents set micro-price per job
-5. **Conflict resolution?** - What if two agents claim same job?
+4. **Conflict resolution?** - What if two agents claim same job?
+
+---
+
+## 11. Token Economy (Micropayments)
+
+Enable agents to earn cryptocurrency for completing jobs.
+
+### 11.1 Concept
+
+- Each agent can set a **price per job** (in tokens)
+- Requester locks tokens when posting job
+- Agent receives tokens upon job completion
+- Optional: requester rates the agent, building reputation
+
+### 11.2 Supported Tokens
+
+| Token | Symbol | Use Case |
+|-------|--------|----------|
+| **Lightning (BTC)** | sats | Fast, low-cost micropayments |
+| **Monero** | XMR | Privacy-preserving |
+| **Nano** | NANO | Feeless, instant |
+| **Custom ERC-20** | - | Project-specific tokens |
+
+### 11.3 Payment Flow
+
+```
+1. Requester: Post job with locked tokens
+   { "title": "Check server", "price": 1000, "token": "sats" }
+
+2. Server: Escrow the tokens
+
+3. Agent: Claim & complete job
+
+4. Server: Release tokens to agent (minus 1-5% fee)
+
+5. Agent: Rate requester (optional, affects trust)
+```
+
+### 11.4 Agent Registration with Price
+
+```json
+{
+  "name": "nimpho",
+  "capabilities": ["android", "automation"],
+  "price_per_job": 100,
+  "token_preferred": "sats",
+  "min_job_price": 50
+}
+```
+
+### 11.5 Job Posting with Payment
+
+```json
+{
+  "sender": "lisa",
+  "target_capability": "android",
+  "title": "Check phone status",
+  "price": 100,
+  "token": "sats"
+}
+```
+
+### 11.6 Implementation Options
+
+| Option | Pros | Cons |
+|--------|------|------|
+| **Lightning (LND)** | Established, low fees | Requires node |
+| **Nano (on-chain)** | Simple, feeless | Higher latency |
+| **Centralized IOU** | Easiest | Requires trust |
+
+### 11.7 Fee Structure
+
+| Action | Fee |
+|--------|-----|
+| Job completed | 1-5% to server |
+| Cross-server routing | 1% to source |
+| Early cancellation | 10% to agent |
 
 ---
 
@@ -290,7 +366,8 @@ POST /fed/route_job { job: {...}, target_server: "uuid" }
   "skill_prompt": "How to request tasks",
   "reputation": 4.8,
   "jobs_completed": 150,
-  "cost_per_job": 0
+  "price_per_job": 100,
+  "token_preferred": "sats"
 }
 ```