moltspay 0.9.6 → 1.0.0

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
 
@@ -36,7 +51,8 @@ export async function textToVideo({ prompt }) {
 {
   "provider": {
     "name": "My Video Service",
-    "wallet": "0xYOUR_WALLET_ADDRESS"
+    "wallet": "0xYOUR_WALLET_ADDRESS",
+    "chains": ["base", "polygon"]
   },
   "services": [{
     "id": "text-to-video",
@@ -63,13 +79,43 @@ 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
+# Pay on Base (default)
 npx moltspay pay https://server.com text-to-video --prompt "a cat dancing"
+
+# Pay on Polygon
+npx moltspay pay https://server.com text-to-video --chain polygon --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 +127,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
@@ -96,7 +138,7 @@ my-skill/
     "name": "Service Name",
     "description": "Optional description",
     "wallet": "0x...",
-    "chain": "base"
+    "chains": ["base", "polygon"]
   },
   "services": [{
     "id": "service-id",
@@ -115,12 +157,30 @@ my-skill/
 }
 ```
 
+### Multi-Chain Configuration
+
+Accept payments on multiple chains by specifying a `chains` array:
+
+```json
+{
+  "provider": {
+    "wallet": "0x...",
+    "chains": ["base", "polygon"]
+  }
+}
+```
+
+Clients can then choose which chain to pay on:
+```bash
+npx moltspay pay https://server.com service-id --chain polygon --prompt "..."
+```
+
+If no `--chain` is specified, the client uses the first chain in the provider's list.
+
 ### Validate Your Config
 
 ```bash
 npx moltspay validate ./my-skill
-# or
-npx moltspay validate ./moltspay.services.json
 ```
 
 ## Server Setup (Mainnet)
@@ -141,43 +201,21 @@ 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
 # === Client Commands ===
 npx moltspay init                    # Create wallet
+npx moltspay init --chain polygon    # Create wallet for Polygon
 npx moltspay status                  # Check balance
 npx moltspay config                  # Update limits
 npx moltspay services <url>          # List provider's services
 npx moltspay pay <url> <service>     # Pay and execute service
 
+# === Pay with Chain Selection ===
+npx moltspay pay <url> <service> --chain base     # Pay on Base (default)
+npx moltspay pay <url> <service> --chain polygon  # Pay on Polygon
+
 # === Server Commands ===
 npx moltspay start <skill-dir>       # Start server
 npx moltspay stop                    # Stop server
@@ -185,7 +223,8 @@ npx moltspay validate <path>         # Validate manifest
 
 # === Options ===
 --port <port>                        # Server port (default 3000)
---chain <chain>                      # Chain: base, polygon, ethereum
+--chain <chain>                      # Chain: base, polygon (for pay/init)
+--token <token>                      # Token: USDC, USDT
 --max-per-tx <amount>                # Spending limit per transaction
 --max-per-day <amount>               # Daily spending limit
 ```
@@ -227,30 +266,53 @@ 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
+
+**Supported Chains:** Base, Polygon
 
-**Test it:**
+**Try it:**
 ```bash
+# List services
 npx moltspay services https://juai8.com/zen7
+
+# Pay on Base (default)
 npx moltspay pay https://juai8.com/zen7 text-to-video --prompt "a happy cat"
+
+# Pay on Polygon
+npx moltspay pay https://juai8.com/zen7 text-to-video --chain polygon --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.js

@@ -30382,7 +30382,7 @@ var CHAINS = {
   polygon: {
     name: "Polygon",
     chainId: 137,
-    rpc: "https://polygon-rpc.com",
+    rpc: "https://polygon-bor-rpc.publicnode.com",
     tokens: {
       USDC: {
         address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",