moltspay 0.9.5 → 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/cdp/index.d.mts

@@ -1,4 +1,4 @@
-import { C as ChainName } from '../index-Dg8n6wdW.mjs';
+import { C as ChainName } from '../index-B3v8IWjM.mjs';
 import { getChain } from '../chains/index.mjs';
 
 /**

package/dist/cdp/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ChainName } from '../index-Dg8n6wdW.js';
+import { C as ChainName } from '../index-B3v8IWjM.js';
 import { getChain } from '../chains/index.js';
 
 /**

package/dist/cdp/index.js

@@ -30361,7 +30361,20 @@ var CHAINS = {
     name: "Base",
     chainId: 8453,
     rpc: "https://mainnet.base.org",
+    tokens: {
+      USDC: {
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        decimals: 6,
+        symbol: "USDC"
+      },
+      USDT: {
+        address: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
+        decimals: 6,
+        symbol: "USDT"
+      }
+    },
     usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    // deprecated, for backward compat
     explorer: "https://basescan.org/address/",
     explorerTx: "https://basescan.org/tx/",
     avgBlockTime: 2
@@ -30370,6 +30383,18 @@ var CHAINS = {
     name: "Polygon",
     chainId: 137,
     rpc: "https://polygon-rpc.com",
+    tokens: {
+      USDC: {
+        address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        decimals: 6,
+        symbol: "USDC"
+      },
+      USDT: {
+        address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
+        decimals: 6,
+        symbol: "USDT"
+      }
+    },
     usdc: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
     explorer: "https://polygonscan.com/address/",
     explorerTx: "https://polygonscan.com/tx/",
@@ -30379,6 +30404,18 @@ var CHAINS = {
     name: "Ethereum",
     chainId: 1,
     rpc: "https://eth.llamarpc.com",
+    tokens: {
+      USDC: {
+        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        decimals: 6,
+        symbol: "USDC"
+      },
+      USDT: {
+        address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+        decimals: 6,
+        symbol: "USDT"
+      }
+    },
     usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
     explorer: "https://etherscan.io/address/",
     explorerTx: "https://etherscan.io/tx/",
@@ -30389,6 +30426,19 @@ var CHAINS = {
     name: "Base Sepolia",
     chainId: 84532,
     rpc: "https://sepolia.base.org",
+    tokens: {
+      USDC: {
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        decimals: 6,
+        symbol: "USDC"
+      },
+      USDT: {
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        // Same as USDC on testnet (no official USDT)
+        decimals: 6,
+        symbol: "USDT"
+      }
+    },
     usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
     explorer: "https://sepolia.basescan.org/address/",
     explorerTx: "https://sepolia.basescan.org/tx/",
@@ -30398,6 +30448,19 @@ var CHAINS = {
     name: "Sepolia",
     chainId: 11155111,
     rpc: "https://rpc.sepolia.org",
+    tokens: {
+      USDC: {
+        address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        decimals: 6,
+        symbol: "USDC"
+      },
+      USDT: {
+        address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        // Same as USDC on testnet
+        decimals: 6,
+        symbol: "USDT"
+      }
+    },
     usdc: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
     explorer: "https://sepolia.etherscan.io/address/",
     explorerTx: "https://sepolia.etherscan.io/tx/",