moltspay 0.2.4 → 0.2.6

package/README.md

@@ -80,7 +80,73 @@ Complete support for pure-conversation payment between AI Agents.
 START → 能力识别 → 能力协商 → Onboarding → 服务请求 → 报价 → 支付 → 验证 → 交付 → 收据 → END
 ```
 
-### Buyer Agent: Create Wallet & Pay
+### Client Agent: Auto-Setup (Recommended - v0.2.5+)
+
+The simplest way for a client agent to get started:
+
+**First-time setup is automatic:**
+```bash
+# 1. Install (agent does this automatically when calling a paid service)
+npm install moltspay
+
+# 2. Initialize wallet (automatic, no gas needed)
+npx moltspay init --chain base
+
+# Output:
+# ✅ Agent wallet initialized
+#    Address: 0xABC123...
+#    Storage: ~/.moltspay
+```
+
+**Request Owner authorization (one-time):**
+```bash
+npx moltspay auth-request --owner 0xOWNER_METAMASK --amount 50 --chain base
+```
+
+**Owner signs (CLI or MetaMask):**
+```bash
+# Owner runs this with their private key
+npx moltspay sign-permit \
+  --owner 0xOWNER_METAMASK \
+  --spender 0xAGENT_ADDRESS \
+  --amount 50 \
+  --deadline $(date -d '+7 days' +%s) \
+  --nonce 0 \
+  --chain base
+```
+
+**Agent spends within allowance:**
+```bash
+npx moltspay spend --to 0xSERVICE_PROVIDER --amount 0.99 --chain base
+```
+
+### Code Example (Auto-Initialize)
+
+```typescript
+import { AgentWallet } from 'moltspay';
+
+// Auto-creates wallet on first use (no gas needed)
+const wallet = new AgentWallet({ chain: 'base' });
+console.log('Agent address:', wallet.address);
+
+// Generate auth request for Owner
+const request = await wallet.generateAuthRequest({
+  ownerAddress: '0xOWNER...',
+  amount: 50,  // $50 USDC allowance
+});
+console.log(request.message);  // Send to Owner
+
+// After Owner signs, store permit
+wallet.storePermit(ownerPermit);
+
+// Pay for services (USDC comes from Owner's wallet)
+const result = await wallet.spend('0xServiceProvider...', 0.99);
+console.log('Paid:', result.txHash);
+```
+
+### Buyer Agent: Create Wallet & Pay (Manual)
+
+For more control, you can manually manage wallet creation:
 
 ```typescript
 import { createWallet, loadWallet, PermitWallet } from 'moltspay';