moltspay 1.2.0 → 1.2.1

package/README.md

@@ -78,8 +78,14 @@ npx moltspay init --chain base
 # Output: Wallet address 0xABC123...
 ```
 
-**2. Fund your wallet:**
-Send USDC to your wallet address. No ETH needed!
+**2. Fund your wallet (US users):**
+```bash
+npx moltspay fund 50
+# Opens Coinbase Pay - use debit card or Apple Pay
+# USDC arrives in ~2 minutes. No ETH needed!
+```
+
+Or send USDC directly to your wallet address from any exchange.
 
 **3. Use paid services:**
 ```bash
@@ -90,6 +96,22 @@ npx moltspay pay https://server.com text-to-video --prompt "a cat dancing"
 npx moltspay pay https://server.com text-to-video --chain polygon --prompt "a cat dancing"
 ```
 
+### Testnet Quick Start
+
+Want to test before using real money? Use our testnet faucet:
+
+```bash
+# 1. Create wallet (if you don't have one)
+npx moltspay init
+
+# 2. Get free testnet USDC (1 USDC per request, once per 24h)
+npx moltspay faucet
+
+# 3. Test payments on Base Sepolia
+npx moltspay pay https://moltspay.com/a/yaqing text-to-video \
+  --chain base_sepolia --prompt "a robot dancing"
+```
+
 ## How x402 Protocol Works
 
 ```
@@ -183,38 +205,76 @@ If no `--chain` is specified, the client uses the first chain in the provider's
 npx moltspay validate ./my-skill
 ```
 
-## Server Setup (Mainnet)
+## Server Setup
 
 **1. Get CDP credentials** from https://portal.cdp.coinbase.com/
 
 **2. Create `~/.moltspay/.env`:**
 ```env
-USE_MAINNET=true
 CDP_API_KEY_ID=your-key-id
 CDP_API_KEY_SECRET=your-secret
 ```
 
-**3. Start server:**
+**3. Configure chains in your manifest:**
+```json
+{
+  "provider": {
+    "wallet": "0x...",
+    "chains": [
+      { "chain": "base", "network": "eip155:8453", "tokens": ["USDC"] },
+      { "chain": "base_sepolia", "network": "eip155:84532", "tokens": ["USDC"] }
+    ]
+  }
+}
+```
+
+**4. Start server:**
 ```bash
 npx moltspay start ./my-skill --port 3000
 ```
 
 Server does NOT need a private key - the x402 facilitator handles settlement.
 
+### Chain Auto-Detection
+
+The server automatically detects which chain to verify payments on based on the client's payment header:
+
+- Client pays with `--chain base` → Server verifies on Base mainnet
+- Client pays with `--chain base_sepolia` → Server verifies on Base Sepolia
+
+**No `USE_MAINNET` env var needed!** Just configure your accepted chains in the manifest.
+
+### Testnet Setup (Providers)
+
+To accept testnet payments, add `base_sepolia` to your chains array:
+
+```json
+{
+  "provider": {
+    "wallet": "0x...",
+    "chains": ["base", "base_sepolia"]
+  }
+}
+```
+
+Clients can then pay using `--chain base_sepolia` and get free testnet USDC via `npx moltspay faucet`.
+
 ## CLI Reference
 
 ```bash
 # === Client Commands ===
 npx moltspay init                    # Create wallet
-npx moltspay init --chain polygon    # Create wallet for Polygon
+npx moltspay fund <amount>           # Fund wallet via Coinbase (US)
+npx moltspay faucet                  # Get free testnet USDC (Base Sepolia)
 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
+npx moltspay pay <url> <service> --chain base          # Pay on Base (default)
+npx moltspay pay <url> <service> --chain polygon       # Pay on Polygon
+npx moltspay pay <url> <service> --chain base_sepolia  # Pay on testnet
 
 # === Server Commands ===
 npx moltspay start <skill-dir>       # Start server
@@ -223,7 +283,7 @@ npx moltspay validate <path>         # Validate manifest
 
 # === Options ===
 --port <port>                        # Server port (default 3000)
---chain <chain>                      # Chain: base, polygon (for pay/init)
+--chain <chain>                      # Chain: base, polygon, base_sepolia
 --token <token>                      # Token: USDC, USDT
 --max-per-tx <amount>                # Spending limit per transaction
 --max-per-day <amount>               # Daily spending limit
@@ -306,9 +366,18 @@ npx moltspay pay https://juai8.com/zen7 text-to-video --chain polygon --prompt "
 - [moltspay-python](https://github.com/Yaqing2023/moltspay-python) - Python SDK with LangChain integration
 - [x402 Protocol](https://www.x402.org/) - The HTTP payment standard
 
+## Community & Support
+
+Join our Discord for help, feedback, and updates:
+
+👉 **[MoltsPay Discord](https://discord.gg/QwCJgVBxVK)** 
+
+Or visit the [#moltspay-support](https://discord.com/channels/1472602423267819734/1480968496346304522) channel directly.
+
 ## Links
 
 - **Website:** https://moltspay.com
+- **Discord:** https://discord.gg/QwCJgVBxVK
 - **npm:** https://www.npmjs.com/package/moltspay
 - **PyPI:** https://pypi.org/project/moltspay/
 - **x402 Protocol:** https://www.x402.org/

package/dist/cdp/index.d.mts

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

package/dist/cdp/index.d.ts

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

package/dist/cdp/index.js

@@ -30365,12 +30365,15 @@ var CHAINS = {
       USDC: {
         address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
         decimals: 6,
-        symbol: "USDC"
+        symbol: "USDC",
+        eip712Name: "USD Coin"
+        // EIP-712 domain name
       },
       USDT: {
         address: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
         decimals: 6,
-        symbol: "USDT"
+        symbol: "USDT",
+        eip712Name: "Tether USD"
       }
     },
     usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
@@ -30387,12 +30390,15 @@ var CHAINS = {
       USDC: {
         address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
         decimals: 6,
-        symbol: "USDC"
+        symbol: "USDC",
+        eip712Name: "USD Coin"
       },
       USDT: {
         address: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
         decimals: 6,
-        symbol: "USDT"
+        symbol: "USDT",
+        eip712Name: "(PoS) Tether USD"
+        // Polygon uses this name
       }
     },
     usdc: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
@@ -30400,27 +30406,6 @@ var CHAINS = {
     explorerTx: "https://polygonscan.com/tx/",
     avgBlockTime: 2
   },
-  ethereum: {
-    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/",
-    avgBlockTime: 12
-  },
   // ============ Testnet ============
   base_sepolia: {
     name: "Base Sepolia",
@@ -30430,41 +30415,23 @@ var CHAINS = {
       USDC: {
         address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
         decimals: 6,
-        symbol: "USDC"
+        symbol: "USDC",
+        eip712Name: "USDC"
+        // Testnet USDC uses 'USDC' not 'USD Coin'
       },
       USDT: {
         address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
         // Same as USDC on testnet (no official USDT)
         decimals: 6,
-        symbol: "USDT"
+        symbol: "USDT",
+        eip712Name: "USDC"
+        // Uses same contract as USDC
       }
     },
     usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
     explorer: "https://sepolia.basescan.org/address/",
     explorerTx: "https://sepolia.basescan.org/tx/",
     avgBlockTime: 2
-  },
-  sepolia: {
-    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/",
-    avgBlockTime: 12
   }
 };
 function getChain(name) {