moltspay 0.2.5 → 0.2.7

package/README.md

@@ -80,7 +80,59 @@ 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
+```
+
+**Owner funds the Agent (one-time):**
+- Agent tells Owner its wallet address
+- Owner sends USDC to the agent's address using Coinbase, MetaMask, etc.
+- No complex signatures needed — just a simple transfer
+
+**Agent pays for services:**
+```bash
+npx moltspay transfer --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);
+// Tell Owner to send USDC to this address
+
+// Check balance
+const balance = await wallet.getBalance();
+console.log('USDC balance:', balance.usdc);
+
+// Pay for services
+const result = await wallet.transfer({
+  to: '0xServiceProvider...',
+  amount: 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';