Add MPP tests, docs, and version bump to 1.14.0

- 5 new mock e2e tests: init mpp, allowance status/balance/fund in MPP mode, switch back
- Tempo RPC mock (tempo_fundAddress, pathUSD balance)
- CLI help: mention init mpp, MPP rail
- SKILL.md: document dual-rail (x402 + MPP)
- OpenClaw SKILL.md: mention MPP
- Bump version 1.13.5 → 1.14.0

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: MajorTal

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: run402
-description: Provision and manage AI-native Postgres databases with REST API, auth, storage, and row-level security. Prototype tier is free (testnet). Paid tiers use x402 USDC on Base or Stripe credits.
+description: Provision and manage AI-native Postgres databases with REST API, auth, storage, and row-level security. Prototype tier is free (testnet). Paid tiers use x402 USDC on Base, MPP pathUSD on Tempo, or Stripe credits.
 metadata:
   openclaw:
     emoji: "🐘"
@@ -17,7 +17,11 @@ metadata:
 
 # Run402 — Postgres for AI Agents
 
-Run402 gives you a full Postgres database with a REST API, user auth, file storage, and row-level security. The prototype tier is free — you pay with testnet USDC to test the x402 flow end-to-end, no real money needed. Higher tiers (hobby, team) cost real money, payable with USDC on Base or Stripe credits. No signups, no human approval needed.
+Run402 gives you a full Postgres database with a REST API, user auth, file storage, and row-level security. The prototype tier is free — you pay with testnet USDC to test the payment flow end-to-end, no real money needed. Higher tiers (hobby, team) cost real money, payable with USDC on Base (x402), pathUSD on Tempo (MPP), or Stripe credits. No signups, no human approval needed.
+
+Two payment rails are supported:
+- **x402** (default): USDC on Base Sepolia (testnet) or Base mainnet. Standard HTTP 402 protocol.
+- **MPP**: pathUSD on Tempo Moderato (testnet). Stripe's Machine Payments Protocol. Same wallet key works on both chains.
 
 One tool call. One payment. You get back `anon_key`, `service_key`, and a project ID. Start creating tables immediately.
 
@@ -308,7 +312,7 @@ run_sql(project_id: "prj_...", sql: "SELECT count(*) FROM todos")
 
 ## Payment Handling
 
-Run402 uses the x402 HTTP payment protocol. Here's what you need to know:
+Run402 supports two payment protocols: **x402** (USDC on Base) and **MPP** (pathUSD on Tempo). Both use the same wallet key. Here's what you need to know:
 
 **When payment is needed:** Only `provision_postgres_project` and `renew_project` require x402 payment. All other tools (run_sql, rest_query, upload_file) use stored project keys — no payment needed.
 
@@ -327,7 +331,7 @@ Run402 uses the x402 HTTP payment protocol. Here's what you need to know:
 | Hobby | $5.00 | 30 days | 1 GB | 5,000,000 | 25 | 30s | 256MB | 50 |
 | Team | $20.00 | 30 days | 10 GB | 50,000,000 | 100 | 60s | 512MB | 200 |
 
-Prototype uses Base Sepolia testnet USDC — no real money needed. Get test USDC from the faucet. Hobby and Team require real payment via USDC on Base or Stripe credits.
+Prototype uses testnet tokens — no real money needed. With x402: Base Sepolia USDC from the faucet. With MPP: Tempo Moderato pathUSD from the Tempo faucet (instant, no rate limit). Hobby and Team require real payment via USDC on Base, pathUSD on Tempo, or Stripe credits.
 
 **Budget enforcement:** When a project hits its tier's API call or storage limit, REST/SQL calls return 402 with usage details and a renew URL. Suggest renewing the project at the same or higher tier.
 
@@ -362,15 +366,22 @@ Prototype uses Base Sepolia testnet USDC — no real money needed. Get test USDC
 
 ## Agent Allowance Setup
 
-To pay Run402, the user needs an agent allowance with USDC on Base. If they don't have one yet, here are the options:
+To pay Run402, the user needs an agent allowance. Two payment rails are available:
 
-**Option A: Coinbase AgentKit (recommended)** — Gives you an allowance on Base with built-in x402 support. No KYC, no manual key management.
+**x402 rail (default):** USDC on Base. Set up with `run402 init`.
+- Prototype: Base Sepolia testnet USDC (free from faucet)
+- Hobby/Team: real USDC on Base mainnet
 
-**Option B: AgentPayy** — Auto-bootstraps an MPC wallet on Base using Coinbase CDP. Purpose-built for x402.
+**MPP rail:** pathUSD on Tempo. Set up with `run402 init mpp`.
+- Prototype: Tempo Moderato testnet pathUSD (free from faucet, instant, no rate limit)
+- Hobby/Team: real pathUSD on Tempo mainnet
 
-**Option C: x402 OpenClaw Skill** — Install the x402 skill from ClawHub for x402 payment capabilities.
+The same wallet key works on both chains — switching rails just changes which chain is used for payments.
 
-**Prototype (free):** Use Base Sepolia testnet. Get free test USDC from the faucet (`request_faucet`) or Circle. No real money needed — the goal is to test the x402 payment flow end-to-end.
+**Additional setup options:**
+- **Coinbase AgentKit** — Gives you an allowance on Base with built-in x402 support
+- **AgentPayy** — Auto-bootstraps an MPC wallet on Base using Coinbase CDP
+- **x402 OpenClaw Skill** — Install the x402 skill from ClawHub for x402 payment capabilities
 
 **Hobby/Team (real money):** Fund the allowance with USDC on Base mainnet, or buy credits via Stripe. The simplest path: download Coinbase Wallet, buy USDC, send to the allowance address. Base transactions cost under $0.01.
 

cli-e2e.test.mjs

@@ -47,7 +47,11 @@ function noContent() {
 
 // USDC balance as ABI-encoded uint256 (250000 = 0.25 USDC)
 const USDC_BALANCE_HEX = "0x" + "0".repeat(58) + "03d090";
+// pathUSD balance as ABI-encoded uint256 (1000000 = 1.00 pathUSD)
+const PATHUSD_BALANCE_HEX = "0x" + "0".repeat(59) + "f4240";
+const TEMPO_RPC_URL = "https://rpc.moderato.tempo.xyz/";
 let rpcCallCount = 0;
+let tempoRpcCallCount = 0;
 
 function mockFetch(input, init) {
   // Handle Request objects (x402 library may pass these)
@@ -72,6 +76,31 @@ function mockFetch(input, init) {
     body = rawBody;
   }
 
+  // ── Tempo Moderato RPC (pathUSD balance, faucet) ──
+  if (url === TEMPO_RPC_URL && body?.jsonrpc === "2.0") {
+    tempoRpcCallCount++;
+    if (body.method === "tempo_fundAddress") {
+      return Promise.resolve(json({ jsonrpc: "2.0", result: ["0xtx1", "0xtx2", "0xtx3", "0xtx4"], id: body.id }));
+    }
+    if (body.method === "eth_call") {
+      // Return 0 for first call (before faucet), positive for subsequent
+      const balance = tempoRpcCallCount <= 1 ? "0x0" : PATHUSD_BALANCE_HEX;
+      return Promise.resolve(json({ jsonrpc: "2.0", result: balance, id: body.id }));
+    }
+    if (body.method === "eth_chainId") {
+      return Promise.resolve(json({ jsonrpc: "2.0", result: "0xa5bf", id: body.id }));
+    }
+    if (Array.isArray(body)) {
+      const results = body.map(req => {
+        if (req.method === "eth_call") return { jsonrpc: "2.0", result: PATHUSD_BALANCE_HEX, id: req.id };
+        if (req.method === "eth_chainId") return { jsonrpc: "2.0", result: "0xa5bf", id: req.id };
+        return { jsonrpc: "2.0", result: "0x0", id: req.id };
+      });
+      return Promise.resolve(json(results));
+    }
+    return Promise.resolve(json({ jsonrpc: "2.0", result: "0x0", id: body.id }));
+  }
+
   // ── Viem JSON-RPC calls (eth_call for USDC balance, eth_chainId, etc.) ──
   if (body?.jsonrpc === "2.0") {
     rpcCallCount++;
@@ -820,4 +849,63 @@ describe("CLI e2e happy path", () => {
     assert.ok(data.allowance.address, "should include allowance address");
     assert.ok(Array.isArray(data.projects), "should include projects array");
   });
+
+  // ── MPP rail ─────────────────────────────────────────────────────────────
+
+  it("init mpp (switch to MPP rail)", async () => {
+    tempoRpcCallCount = 0; // reset for fresh faucet flow
+    const { run } = await import("./cli/lib/init.mjs");
+    captureStart();
+    await run(["mpp"]);
+    captureStop();
+    const out = captured();
+    assert.ok(out.includes("Tempo"), "should show Tempo network");
+    assert.ok(out.includes("pathUSD"), "should show pathUSD");
+    assert.ok(out.includes("mpp"), "should show mpp rail");
+    // Verify rail saved
+    const allowance = JSON.parse(readFileSync(join(tempDir, "allowance.json"), "utf-8"));
+    assert.equal(allowance.rail, "mpp", "rail should be mpp");
+  });
+
+  it("allowance status (MPP rail)", async () => {
+    const { run } = await import("./cli/lib/allowance.mjs");
+    captureStart();
+    await run("status", []);
+    captureStop();
+    assert.ok(captured().includes("mpp"), "should show mpp rail");
+  });
+
+  it("allowance balance (MPP rail)", async () => {
+    const { run } = await import("./cli/lib/allowance.mjs");
+    captureStart();
+    await run("balance", []);
+    captureStop();
+    const out = captured();
+    assert.ok(out.includes("tempo-moderato_pathusd_micros"), "should show Tempo balance");
+    assert.ok(out.includes("mpp"), "should show mpp rail");
+  });
+
+  it("allowance fund (MPP rail)", async () => {
+    tempoRpcCallCount = 0; // reset so first call returns 0, faucet tops up
+    const { run } = await import("./cli/lib/allowance.mjs");
+    captureStart();
+    await run("fund", []);
+    captureStop();
+    const out = captured();
+    assert.ok(out.includes("tempo-moderato_pathusd_micros"), "should show Tempo fund result");
+    assert.ok(out.includes("mpp"), "should show mpp rail");
+  });
+
+  it("init (switch back to x402)", async () => {
+    const { run } = await import("./cli/lib/init.mjs");
+    captureStart();
+    await run([]);
+    captureStop();
+    const out = captured();
+    assert.ok(out.includes("Base Sepolia"), "should show Base Sepolia network");
+    assert.ok(out.includes("x402"), "should show x402 rail");
+    // Verify rail switched back
+    const allowance = JSON.parse(readFileSync(join(tempDir, "allowance.json"), "utf-8"));
+    assert.equal(allowance.rail, "x402", "rail should be x402");
+  });
 });

cli/cli.mjs

@@ -19,7 +19,8 @@ Usage:
   run402 <command> [subcommand] [options]
 
 Commands:
-  init        Set up allowance, funding, and check tier status
+  init        Set up allowance, funding, and check tier status (x402 default)
+  init mpp    Set up with MPP payment rail (Tempo Moderato testnet)
   status      Show full account state (allowance, balance, tier, projects)
   allowance   Manage your agent allowance (create, fund, balance, status)
   tier        Manage tier subscription (status, set)
@@ -31,7 +32,7 @@ Commands:
   sites       Deploy static sites
   subdomains  Manage custom subdomains (claim, list, delete)
   apps        Browse and manage the app marketplace
-  image       Generate AI images via x402 micropayments
+  image       Generate AI images via x402 or MPP micropayments
   message     Send messages to Run402 developers
   agent       Manage agent identity (contact info)
 
@@ -48,7 +49,8 @@ Examples:
   run402 image generate "a startup mascot, pixel art" --output logo.png
 
 Getting started:
-  run402 init               Set up everything in one command
+  run402 init               Set up with x402 (Base Sepolia)
+  run402 init mpp           Set up with MPP (Tempo Moderato)
   run402 tier set prototype  Subscribe to a tier
   run402 deploy --manifest app.json
 `;

cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "run402",
-  "version": "1.13.5",
-  "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 micropayments.",
+  "version": "1.14.0",
+  "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {
     "run402": "cli.mjs"

openclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: run402
-description: Provision Postgres databases, deploy static sites, generate images, and build full-stack webapps on Run402 using x402 micropayments. Use when the user asks to build a webapp, deploy a site, create a database, generate images, or mentions Run402.
+description: Provision Postgres databases, deploy static sites, generate images, and build full-stack webapps on Run402 using x402 or MPP micropayments. Use when the user asks to build a webapp, deploy a site, create a database, generate images, or mentions Run402.
 ---
 
 # Run402 — AI-Native Postgres & Static Hosting