moltspay 0.9.6 → 0.9.7

package/README.md

@@ -1,6 +1,21 @@
 # MoltsPay
 
-Blockchain payment infrastructure for AI Agents. Turn any skill into a paid service with one JSON file.
+[![npm version](https://img.shields.io/npm/v/moltspay.svg)](https://www.npmjs.com/package/moltspay)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+
+**Blockchain payment infrastructure for AI Agents.** Turn any skill into a paid service with one JSON file.
+
+MoltsPay enables agent-to-agent commerce using the [x402 protocol](https://www.x402.org/) - HTTP-native payments where AI agents can pay each other for services without human intervention. Built on USDC stablecoins with gasless transactions powered by Coinbase CDP.
+
+## Why MoltsPay?
+
+| Problem | MoltsPay Solution |
+|---------|-------------------|
+| AI agents can't pay for services | x402 protocol - HTTP 402 Payment Required flow |
+| Blockchain payments need gas | Gasless - CDP facilitator handles all gas fees |
+| Complex wallet integration | One JSON file - add `moltspay.services.json` to any skill |
+| Payment verification is hard | Automatic on-chain verification included |
 
 ## Features
 
@@ -8,7 +23,7 @@ Blockchain payment infrastructure for AI Agents. Turn any skill into a paid serv
 - 🎫 **x402 Protocol** - HTTP-native payments (402 Payment Required)
 - 💨 **Gasless** - Both client and server pay no gas (CDP facilitator handles it)
 - ✅ **Payment Verification** - Automatic on-chain verification
-- 🔒 **Secure Wallet** - Limits, whitelist, and audit logging
+- 🔒 **Secure Wallet** - Spending limits, whitelist, and audit logging
 - ⛓️ **Multi-chain** - Base, Polygon, Ethereum (mainnet & testnet)
 - 🤖 **Agent-to-Agent** - Complete A2A payment flow support
 
@@ -63,13 +78,39 @@ npx moltspay init --chain base
 ```
 
 **2. Fund your wallet:**
-Ask your owner to send USDC to your wallet address. No ETH needed!
+Send USDC to your wallet address. No ETH needed!
 
 **3. Use paid services:**
 ```bash
 npx moltspay pay https://server.com text-to-video --prompt "a cat dancing"
 ```
 
+## How x402 Protocol Works
+
+```
+Client                         Server                      CDP Facilitator
+  │                              │                              │
+  │ POST /execute                │                              │
+  │ ─────────────────────────>   │                              │
+  │                              │                              │
+  │ 402 + payment requirements   │                              │
+  │ <─────────────────────────   │                              │
+  │                              │                              │
+  │ [Sign EIP-3009 - NO GAS]     │                              │
+  │                              │                              │
+  │ POST + X-Payment header      │                              │
+  │ ─────────────────────────>   │ Verify signature             │
+  │                              │ ─────────────────────────>   │
+  │                              │                              │
+  │                              │ Execute transfer (pays gas)  │
+  │                              │ <─────────────────────────   │
+  │                              │                              │
+  │ 200 OK + result              │                              │
+  │ <─────────────────────────   │                              │
+```
+
+**Key insight:** Client signs a payment authorization, server submits it. Neither party pays gas - the CDP facilitator handles settlement.
+
 ## Skill Structure
 
 MoltsPay reads your skill's existing structure:
@@ -81,10 +122,6 @@ my-skill/
 └── moltspay.services.json # Only file you add!
 ```
 
-**Entry point discovery:**
-1. If `package.json` exists → uses `main` field
-2. Otherwise → defaults to `index.js`
-
 **Your functions stay untouched.** Just add the JSON config.
 
 ## Services Manifest Schema
@@ -119,8 +156,6 @@ my-skill/
 
 ```bash
 npx moltspay validate ./my-skill
-# or
-npx moltspay validate ./moltspay.services.json
 ```
 
 ## Server Setup (Mainnet)
@@ -141,33 +176,6 @@ npx moltspay start ./my-skill --port 3000
 
 Server does NOT need a private key - the x402 facilitator handles settlement.
 
-## How x402 Works
-
-```
-Client                         Server                      CDP Facilitator
-  │                              │                              │
-  │ POST /execute                │                              │
-  │ ─────────────────────────>   │                              │
-  │                              │                              │
-  │ 402 + payment requirements   │                              │
-  │ <─────────────────────────   │                              │
-  │                              │                              │
-  │ [Sign EIP-3009 - NO GAS]     │                              │
-  │                              │                              │
-  │ POST + X-Payment header      │                              │
-  │ ─────────────────────────>   │ Verify signature             │
-  │                              │ ─────────────────────────>   │
-  │                              │                              │
-  │                              │ Execute transfer (pays gas)  │
-  │                              │ <─────────────────────────   │
-  │                              │                              │
-  │ 200 OK + result              │                              │
-  │ <─────────────────────────   │                              │
-```
-
-**Client needs:** USDC balance only (no ETH/gas)
-**Server needs:** CDP credentials only (no private key)
-
 ## CLI Reference
 
 ```bash
@@ -227,30 +235,45 @@ server.listen(3000);
 
 | Chain | ID | Type |
 |-------|-----|------|
-| base | 8453 | Mainnet |
-| polygon | 137 | Mainnet |
-| ethereum | 1 | Mainnet |
-| base_sepolia | 84532 | Testnet |
+| Base | 8453 | Mainnet |
+| Polygon | 137 | Mainnet |
+| Ethereum | 1 | Mainnet |
+| Base Sepolia | 84532 | Testnet |
 
-## Example: Zen7 Video Generation
+## Live Example: Zen7 Video Generation
 
 Live service at `https://juai8.com/zen7/`
 
 **Services:**
-- `text-to-video` - $0.99 USDC
-- `image-to-video` - $1.49 USDC
+- `text-to-video` - $0.99 USDC - Generate video from text prompt
+- `image-to-video` - $1.49 USDC - Animate a static image
 
-**Test it:**
+**Try it:**
 ```bash
 npx moltspay services https://juai8.com/zen7
 npx moltspay pay https://juai8.com/zen7 text-to-video --prompt "a happy cat"
 ```
 
+## Use Cases
+
+- **AI Video Generation** - Pay per video generated
+- **Image Processing** - Pay for AI image editing/enhancement
+- **Data APIs** - Monetize proprietary datasets
+- **Compute Services** - Sell GPU time to other agents
+- **Content Generation** - AI writing, music, code generation
+
+## Related Projects
+
+- [moltspay-python](https://github.com/Yaqing2023/moltspay-python) - Python SDK with LangChain integration
+- [x402 Protocol](https://www.x402.org/) - The HTTP payment standard
+
 ## Links
 
+- **Website:** https://moltspay.com
 - **npm:** https://www.npmjs.com/package/moltspay
-- **GitHub:** https://github.com/Yaqing2023/moltspay
+- **PyPI:** https://pypi.org/project/moltspay/
 - **x402 Protocol:** https://www.x402.org/
+- **Coinbase CDP:** https://portal.cdp.coinbase.com/
 
 ## License
 

package/dist/cli/index.js

@@ -293,7 +293,17 @@ var MoltsPayClient = class {
         throw new Error(`Insufficient balance: need $${amount}, have ${balances.usdc} USDC / ${balances.usdt} USDT`);
       }
     }
-    console.log(`[MoltsPay] Signing payment: $${amount} ${token} (gasless)`);
+    if (token === "USDT") {
+      const balances = await this.getBalance();
+      if (balances.native < 1e-4) {
+        throw new Error(
+          `USDT requires ETH for gas (~$0.01 on Base). Your ETH balance: ${balances.native.toFixed(6)} ETH. Please add a small amount of ETH to your wallet, or use USDC (gasless).`
+        );
+      }
+      console.log(`[MoltsPay] \u26A0\uFE0F  USDT requires gas (~$0.01). Proceeding with payment...`);
+    } else {
+      console.log(`[MoltsPay] Signing payment: $${amount} ${token} (gasless)`);
+    }
     const payTo = req.payTo || req.resource;
     if (!payTo) {
       throw new Error("Missing payTo address in payment requirements");
@@ -2036,6 +2046,18 @@ program.command("pay <server> <service> [params]").description("Pay for a servic
   }
   const imageDisplay = params.image_url || (params.image_base64 ? `[local file: ${options.image}]` : null);
   const token = (options.token || "USDC").toUpperCase();
+  if (token === "USDT") {
+    const balance = await client.getBalance();
+    if (balance.native < 1e-4) {
+      console.log("\n\u26A0\uFE0F  USDT requires a small amount of ETH for gas (~$0.01)");
+      console.log(`   Your ETH balance: ${balance.native.toFixed(6)} ETH`);
+      console.log("   Please add a tiny amount of ETH to your wallet.\n");
+      process.exit(1);
+    }
+    if (!options.json) {
+      console.log("\n\u26A0\uFE0F  Note: USDT payments require gas (~$0.01 on Base)");
+    }
+  }
   if (!options.json) {
     console.log(`
 \u{1F4B3} MoltsPay - Paying for service