moltspay 1.2.0 → 1.3.0

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,7 +96,38 @@ 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"
 ```
 
-## How x402 Protocol Works
+### Testnet Quick Start
+
+Want to test before using real money? Use our testnet faucets:
+
+```bash
+# 1. Create wallet (if you don't have one)
+npx moltspay init
+
+# 2. Get free testnet tokens
+npx moltspay faucet                        # Base Sepolia (1 USDC, once per 24h)
+npx moltspay faucet --chain tempo_moderato # Tempo testnet (pathUSD)
+
+# 3. Test payments
+# Option A: Base Sepolia
+npx moltspay pay https://moltspay.com/a/yaqing text-to-video \
+  --chain base_sepolia --prompt "a robot dancing"
+
+# Option B: Tempo Moderato (gas-free, MPP protocol)
+npx moltspay pay https://server.com service-id \
+  --chain tempo_moderato --prompt "test"
+```
+
+## Payment Protocols
+
+MoltsPay supports two payment protocols:
+
+| Protocol | Chains | Gas | Description |
+|----------|--------|-----|-------------|
+| x402 | Base, Polygon, Ethereum | Gasless (CDP pays) | HTTP 402 + EIP-3009 signatures |
+| MPP | Tempo Moderato | Gas-free native | HTTP 402 + WWW-Authenticate |
+
+### How x402 Protocol Works
 
 ```
 Client                         Server                      CDP Facilitator
@@ -116,6 +153,33 @@ Client                         Server                      CDP Facilitator
 
 **Key insight:** Client signs a payment authorization, server submits it. Neither party pays gas - the CDP facilitator handles settlement.
 
+### How MPP Protocol Works (Tempo)
+
+MPP (Machine Payments Protocol) is simpler - client executes the transfer directly:
+
+```
+Client                         Server
+  │                              │
+  │ POST /service                │
+  │ ─────────────────────────>   │
+  │                              │
+  │ 402 + WWW-Authenticate       │
+  │ <─────────────────────────   │
+  │                              │
+  │ [Execute TIP-20 transfer]    │
+  │ [No gas needed on Tempo]     │
+  │                              │
+  │ POST + Authorization: Payment│
+  │ ─────────────────────────>   │
+  │                              │
+  │ [Server verifies on-chain]   │
+  │                              │
+  │ 200 OK + Payment-Receipt     │
+  │ <─────────────────────────   │
+```
+
+**Key insight:** On Tempo, the client executes the transfer directly (gas-free), then retries with the transaction hash. No CDP facilitator needed.
+
 ## Skill Structure
 
 MoltsPay reads your skill's existing structure:
@@ -183,38 +247,86 @@ 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 status                  # Check balance
+npx moltspay fund <amount>           # Fund wallet via Coinbase (US)
+npx moltspay faucet                  # Get free testnet USDC
+npx moltspay faucet --chain tempo_moderato  # Get Tempo testnet tokens
+npx moltspay status                  # Check balance (all chains)
 npx moltspay config                  # Update limits
 npx moltspay services <url>          # List provider's services
 npx moltspay pay <url> <service>     # Pay and execute service
 
+# === Service Discovery ===
+npx moltspay services                           # List all from registry
+npx moltspay services https://provider.com      # List from specific provider
+npx moltspay services -q "video"                # Search by keyword
+npx moltspay services --max-price 1.00          # Filter by max price
+npx moltspay services --type api_service        # Filter by type
+npx moltspay services --tag ai                  # Filter by tag
+npx moltspay services --json                    # Output as JSON
+
 # === 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,10 +335,11 @@ 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, tempo_moderato
 --token <token>                      # Token: USDC, USDT
 --max-per-tx <amount>                # Spending limit per transaction
 --max-per-day <amount>               # Daily spending limit
+--config-dir <dir>                   # Custom wallet directory
 ```
 
 ## Programmatic Usage
@@ -264,12 +377,34 @@ server.listen(3000);
 
 ## Supported Chains
 
-| Chain | ID | Type |
-|-------|-----|------|
-| Base | 8453 | Mainnet |
-| Polygon | 137 | Mainnet |
-| Ethereum | 1 | Mainnet |
-| Base Sepolia | 84532 | Testnet |
+| Chain | ID | Type | Notes |
+|-------|-----|------|-------|
+| Base | 8453 | Mainnet | Primary chain |
+| Polygon | 137 | Mainnet | |
+| Ethereum | 1 | Mainnet | |
+| Base Sepolia | 84532 | Testnet | For testing |
+| Tempo Moderato | 42431 | Testnet | MPP protocol, gas-free |
+
+### Tempo Testnet (New!)
+
+Tempo Moderato is a gas-free testnet that supports the **MPP (Machine Payments Protocol)**. Perfect for testing agent-to-agent payments without any gas fees.
+
+**Tempo Stablecoins:**
+- pathUSD (USDC equivalent): `0x20c0000000000000000000000000000000000000`
+- alphaUSD (USDT equivalent): `0x20c0000000000000000000000000000000000001`
+
+```bash
+# Get free Tempo testnet tokens
+npx moltspay faucet --chain tempo_moderato
+
+# Pay on Tempo (gas-free!)
+npx moltspay pay https://server.com service-id --chain tempo_moderato --prompt "test"
+
+# Check Tempo balance
+npx moltspay status
+```
+
+**Explorer:** https://explore.testnet.tempo.xyz
 
 ## Live Example: Zen7 Video Generation
 
@@ -306,9 +441,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-On9ZaGDW.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-On9ZaGDW.js';
 import { getChain } from '../chains/index.js';
 
 /**