run402 1.13.5 → 1.14.0

package/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
 `;

package/lib/allowance.mjs

@@ -6,24 +6,25 @@ Usage:
   run402 allowance <subcommand>
 
 Subcommands:
-  status    Show allowance address, network, and funding status
+  status    Show allowance address, network, rail, and funding status
   create    Generate a new allowance and save it locally
-  fund      Request test USDC from the Run402 faucet (Base Sepolia)
-  balance   Show on-chain USDC (mainnet + testnet) and Run402 billing balance
+  fund      Request test funds from the faucet (Base Sepolia or Tempo)
+  balance   Show on-chain balances and Run402 billing balance
   export    Print the allowance address (useful for scripting)
   checkout  Create a billing checkout session (--amount <usd_micros>)
   history   View billing transaction history (--limit <n>)
 
 Notes:
-  - Agent allowance is stored locally at ~/.run402/allowance.json
-  - The allowance works on any EVM chain (currently Run402 uses Base Mainnet and Sepolia for testnet)
-  - You need to create and fund an allowance before any x402 transaction with Run402
+  - Agent allowance is stored locally at ~/.config/run402/allowance.json
+  - The allowance works on any EVM chain (Base for x402, Tempo for MPP)
+  - Use 'run402 init' for x402 or 'run402 init mpp' for MPP rail
 
 Examples:
   run402 allowance create
   run402 allowance status
   run402 allowance fund
   run402 allowance export
+  run402 allowance balance
   run402 allowance checkout --amount 5000000
   run402 allowance history --limit 10
 `;
@@ -31,12 +32,20 @@ Examples:
 const USDC_ABI = [{ name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }] }];
 const USDC_MAINNET = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 const USDC_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+const PATH_USD = "0x20c0000000000000000000000000000000000000";
+const TEMPO_RPC = "https://rpc.moderato.tempo.xyz/";
 
 async function loadDeps() {
   const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
-  const { createPublicClient, http } = await import("viem");
+  const { createPublicClient, http, defineChain } = await import("viem");
   const { base, baseSepolia } = await import("viem/chains");
-  return { generatePrivateKey, privateKeyToAccount, createPublicClient, http, base, baseSepolia };
+  const tempoModerato = defineChain({
+    id: 42431,
+    name: "Tempo Moderato",
+    nativeCurrency: { name: "pathUSD", symbol: "pathUSD", decimals: 6 },
+    rpcUrls: { default: { http: [TEMPO_RPC] } },
+  });
+  return { generatePrivateKey, privateKeyToAccount, createPublicClient, http, base, baseSepolia, tempoModerato };
 }
 
 async function status() {
@@ -45,7 +54,7 @@ async function status() {
     console.log(JSON.stringify({ status: "no_wallet", message: "No agent allowance found. Run: run402 allowance create" }));
     return;
   }
-  console.log(JSON.stringify({ status: "ok", address: w.address, created: w.created, funded: w.funded || false, path: ALLOWANCE_FILE }));
+  console.log(JSON.stringify({ status: "ok", address: w.address, created: w.created, funded: w.funded || false, rail: w.rail || "x402", path: ALLOWANCE_FILE }));
 }
 
 async function create() {
@@ -64,6 +73,37 @@ async function fund() {
   const w = readAllowance();
   if (!w) { console.log(JSON.stringify({ status: "error", message: "No agent allowance. Run: run402 allowance create" })); process.exit(1); }
 
+  if (w.rail === "mpp") {
+    // Tempo Moderato faucet — instant, no polling needed
+    const { createPublicClient, http, tempoModerato } = await loadDeps();
+    const client = createPublicClient({ chain: tempoModerato, transport: http() });
+    const before = await readUsdcBalance(client, PATH_USD, w.address).catch(() => 0);
+
+    const res = await fetch(TEMPO_RPC, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ jsonrpc: "2.0", method: "tempo_fundAddress", params: [w.address], id: 1 }),
+    });
+    const data = await res.json();
+    if (data.error) {
+      console.log(JSON.stringify({ status: "error", message: data.error.message || "Tempo faucet failed" }));
+      process.exit(1);
+    }
+
+    // Re-read balance once (instant confirmation)
+    const now = await readUsdcBalance(client, PATH_USD, w.address).catch(() => before);
+    saveAllowance({ ...w, funded: true, lastFaucet: new Date().toISOString() });
+    console.log(JSON.stringify({
+      address: w.address,
+      rail: "mpp",
+      onchain: {
+        "tempo-moderato_pathusd_micros": now,
+      },
+    }, null, 2));
+    return;
+  }
+
+  // Default: Base Sepolia faucet (existing behavior)
   const { createPublicClient, http, baseSepolia } = await loadDeps();
   const client = createPublicClient({ chain: baseSepolia, transport: http() });
   const before = await readUsdcBalance(client, USDC_SEPOLIA, w.address).catch(() => 0);
@@ -83,6 +123,7 @@ async function fund() {
       saveAllowance({ ...w, funded: true, lastFaucet: new Date().toISOString() });
       console.log(JSON.stringify({
         address: w.address,
+        rail: w.rail || "x402",
         onchain: {
           "base-sepolia_usd_micros": now,
         },
@@ -104,13 +145,15 @@ async function balance() {
   const w = readAllowance();
   if (!w) { console.log(JSON.stringify({ status: "error", message: "No agent allowance. Run: run402 allowance create" })); process.exit(1); }
 
-  const { createPublicClient, http, base, baseSepolia } = await loadDeps();
+  const { createPublicClient, http, base, baseSepolia, tempoModerato } = await loadDeps();
   const mainnetClient = createPublicClient({ chain: base, transport: http() });
   const sepoliaClient = createPublicClient({ chain: baseSepolia, transport: http() });
+  const tempoClient = createPublicClient({ chain: tempoModerato, transport: http() });
 
-  const [mainnetUsdc, sepoliaUsdc, billingRes] = await Promise.all([
+  const [mainnetUsdc, sepoliaUsdc, tempoPathUsd, billingRes] = await Promise.all([
     readUsdcBalance(mainnetClient, USDC_MAINNET, w.address).catch(() => null),
     readUsdcBalance(sepoliaClient, USDC_SEPOLIA, w.address).catch(() => null),
+    readUsdcBalance(tempoClient, PATH_USD, w.address).catch(() => null),
     fetch(`${API}/billing/v1/accounts/${w.address.toLowerCase()}`),
   ]);
 
@@ -118,9 +161,11 @@ async function balance() {
 
   console.log(JSON.stringify({
     address: w.address,
+    rail: w.rail || "x402",
     onchain: {
       "base-mainnet_usd_micros": mainnetUsdc,
       "base-sepolia_usd_micros": sepoliaUsdc,
+      "tempo-moderato_pathusd_micros": tempoPathUsd,
     },
     run402: billing ? { balance_usd_micros: billing.available_usd_micros } : "no billing account",
   }, null, 2));

package/lib/init.mjs

@@ -4,16 +4,19 @@ import { mkdirSync } from "fs";
 
 const USDC_ABI = [{ name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }] }];
 const USDC_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+const PATH_USD = "0x20c0000000000000000000000000000000000000";
+const TEMPO_RPC = "https://rpc.moderato.tempo.xyz/";
 
 const HELP = `run402 init — Set up allowance, funding, and check tier status
 
 Usage:
-  run402 init
+  run402 init          Set up with x402 (Base Sepolia) — default
+  run402 init mpp      Set up with MPP (Tempo Moderato)
 
 Steps (idempotent — safe to re-run):
   1. Creates config directory (~/.config/run402)
   2. Creates agent allowance if none exists
-  3. Checks on-chain USDC balance; requests faucet if zero
+  3. Checks on-chain balance; requests faucet if zero
   4. Shows current tier subscription status
   5. Lists local project count
   6. Suggests next step (tier set or deploy)
@@ -26,6 +29,7 @@ function line(label, value) { console.log(`  ${label.padEnd(10)} ${value}`); }
 
 export async function run(args = []) {
   if (args.includes("--help") || args.includes("-h")) { console.log(HELP); process.exit(0); }
+  const isMpp = args[0] === "mpp";
   console.log();
 
   // 1. Config directory
@@ -34,58 +38,126 @@ export async function run(args = []) {
 
   // 2. Allowance
   let allowance = readAllowance();
+  const previousRail = allowance?.rail;
   if (!allowance) {
     const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
     const privateKey = generatePrivateKey();
     const account = privateKeyToAccount(privateKey);
-    allowance = { address: account.address, privateKey, created: new Date().toISOString(), funded: false };
+    allowance = { address: account.address, privateKey, created: new Date().toISOString(), funded: false, rail: isMpp ? "mpp" : "x402" };
     saveAllowance(allowance);
     line("Allowance", `${short(allowance.address)} (created)`);
   } else {
+    // Update rail if switching
+    if ((isMpp && allowance.rail !== "mpp") || (!isMpp && allowance.rail === "mpp")) {
+      allowance = { ...allowance, rail: isMpp ? "mpp" : "x402" };
+      saveAllowance(allowance);
+    } else if (!allowance.rail) {
+      allowance = { ...allowance, rail: isMpp ? "mpp" : "x402" };
+      saveAllowance(allowance);
+    }
     line("Allowance", short(allowance.address));
   }
 
-  // 3. Balance — check on-chain, faucet if zero
-  const { createPublicClient, http } = await import("viem");
-  const { baseSepolia } = await import("viem/chains");
-  const client = createPublicClient({ chain: baseSepolia, transport: http() });
+  line("Network", isMpp ? "Tempo Moderato (testnet)" : "Base Sepolia (testnet)");
+  line("Rail", isMpp ? "mpp" : "x402");
 
+  // 3. Balance — check on-chain, faucet if zero
   let balance = 0;
-  try {
-    const raw = await client.readContract({ address: USDC_SEPOLIA, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
-    balance = Number(raw);
-  } catch {}
 
-  if (balance === 0) {
-    line("Balance", "0 USDC — requesting faucet...");
-    const res = await fetch(`${API}/faucet/v1`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ address: allowance.address }),
+  if (isMpp) {
+    // Tempo Moderato: read pathUSD balance
+    const { createPublicClient, http, defineChain } = await import("viem");
+    const tempoModerato = defineChain({
+      id: 42431,
+      name: "Tempo Moderato",
+      nativeCurrency: { name: "pathUSD", symbol: "pathUSD", decimals: 6 },
+      rpcUrls: { default: { http: [TEMPO_RPC] } },
     });
-    if (res.ok) {
-      // Poll for up to 30s
-      for (let i = 0; i < 30; i++) {
-        await new Promise(r => setTimeout(r, 1000));
-        try {
-          const raw = await client.readContract({ address: USDC_SEPOLIA, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
-          balance = Number(raw);
-          if (balance > 0) break;
-        } catch {}
+    const client = createPublicClient({ chain: tempoModerato, transport: http() });
+
+    try {
+      const raw = await client.readContract({ address: PATH_USD, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
+      balance = Number(raw);
+    } catch {}
+
+    if (balance === 0) {
+      line("Balance", "0 pathUSD — requesting Tempo faucet...");
+      try {
+        const res = await fetch(TEMPO_RPC, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ jsonrpc: "2.0", method: "tempo_fundAddress", params: [allowance.address], id: 1 }),
+        });
+        const data = await res.json();
+        if (data.result) {
+          // Tempo faucet is instant — re-read balance once
+          try {
+            const raw = await client.readContract({ address: PATH_USD, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
+            balance = Number(raw);
+          } catch {}
+          saveAllowance({ ...allowance, funded: true, lastFaucet: new Date().toISOString() });
+          if (balance > 0) {
+            line("Balance", `${(balance / 1e6).toFixed(2)} pathUSD (funded)`);
+          } else {
+            line("Balance", "faucet sent — checking balance...");
+          }
+        } else {
+          line("Balance", `faucet failed: ${data.error?.message || "unknown error"}`);
+        }
+      } catch (err) {
+        line("Balance", `faucet error: ${err.message}`);
       }
-      saveAllowance({ ...allowance, funded: true, lastFaucet: new Date().toISOString() });
-      if (balance > 0) {
-        line("Balance", `${(balance / 1e6).toFixed(2)} USDC (funded)`);
+    } else {
+      line("Balance", `${(balance / 1e6).toFixed(2)} pathUSD`);
+    }
+  } else {
+    // Base Sepolia: read USDC balance (existing behavior)
+    const { createPublicClient, http } = await import("viem");
+    const { baseSepolia } = await import("viem/chains");
+    const client = createPublicClient({ chain: baseSepolia, transport: http() });
+
+    try {
+      const raw = await client.readContract({ address: USDC_SEPOLIA, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
+      balance = Number(raw);
+    } catch {}
+
+    if (balance === 0) {
+      line("Balance", "0 USDC — requesting faucet...");
+      const res = await fetch(`${API}/faucet/v1`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ address: allowance.address }),
+      });
+      if (res.ok) {
+        // Poll for up to 30s
+        for (let i = 0; i < 30; i++) {
+          await new Promise(r => setTimeout(r, 1000));
+          try {
+            const raw = await client.readContract({ address: USDC_SEPOLIA, abi: USDC_ABI, functionName: "balanceOf", args: [allowance.address] });
+            balance = Number(raw);
+            if (balance > 0) break;
+          } catch {}
+        }
+        saveAllowance({ ...allowance, funded: true, lastFaucet: new Date().toISOString() });
+        if (balance > 0) {
+          line("Balance", `${(balance / 1e6).toFixed(2)} USDC (funded)`);
+        } else {
+          line("Balance", "faucet sent — not yet confirmed on-chain");
+        }
       } else {
-        line("Balance", "faucet sent — not yet confirmed on-chain");
+        const data = await res.json().catch(() => ({}));
+        const msg = data.error || data.message || `HTTP ${res.status}`;
+        line("Balance", `faucet failed: ${msg}`);
       }
     } else {
-      const data = await res.json().catch(() => ({}));
-      const msg = data.error || data.message || `HTTP ${res.status}`;
-      line("Balance", `faucet failed: ${msg}`);
+      line("Balance", `${(balance / 1e6).toFixed(2)} USDC`);
     }
-  } else {
-    line("Balance", `${(balance / 1e6).toFixed(2)} USDC`);
+  }
+
+  // Show note if switching rails
+  if (previousRail && previousRail !== (isMpp ? "mpp" : "x402")) {
+    const prev = previousRail === "mpp" ? "Tempo pathUSD" : "Base Sepolia USDC";
+    line("Note", `Switched from ${previousRail} — ${prev} balance still available if you switch back`);
   }
 
   // 4. Tier status
@@ -101,7 +173,7 @@ export async function run(args = []) {
     }
   } catch {}
 
-  if (tierInfo && tierInfo.tier && tierInfo.status === "active") {
+  if (tierInfo && tierInfo.tier && tierInfo.active) {
     const expiry = tierInfo.lease_expires_at ? tierInfo.lease_expires_at.split("T")[0] : "unknown";
     line("Tier", `${tierInfo.tier} (expires ${expiry})`);
   } else {
@@ -113,7 +185,7 @@ export async function run(args = []) {
 
   // 6. Next step
   console.log();
-  if (!tierInfo || !tierInfo.tier || tierInfo.status !== "active") {
+  if (!tierInfo || !tierInfo.tier || !tierInfo.active) {
     console.log("  Next: run402 tier set prototype");
   } else {
     console.log("  Ready to deploy. Run: run402 deploy --manifest app.json");

package/lib/paid-fetch.mjs

@@ -1,8 +1,8 @@
 /**
- * Shared x402 payment wrapper for CLI commands that need paid fetch.
- * Uses viem for allowance signing + @x402/fetch for payment wrapping.
- * Registers both Base mainnet (eip155:8453) and Base Sepolia (eip155:84532)
- * so the x402 client matches whichever network the server offers.
+ * Shared payment wrapper for CLI commands that need paid fetch.
+ * Branches on allowance rail:
+ *   - "mpp": uses mppx.fetch (Tempo pathUSD)
+ *   - "x402" (default): uses @x402/fetch (Base USDC)
  */
 
 import { readAllowance, ALLOWANCE_FILE } from "./config.mjs";
@@ -15,12 +15,23 @@ export async function setupPaidFetch() {
   }
   const allowance = readAllowance();
   const { privateKeyToAccount } = await import("viem/accounts");
+  const account = privateKeyToAccount(allowance.privateKey);
+
+  if (allowance.rail === "mpp") {
+    const { Mppx, tempo } = await import("mppx/client");
+    const mppx = Mppx.create({
+      polyfill: false,
+      methods: [tempo({ account })],
+    });
+    return mppx.fetch;
+  }
+
+  // Default: x402 (existing behavior)
   const { createPublicClient, http } = await import("viem");
   const { base, baseSepolia } = await import("viem/chains");
   const { x402Client, wrapFetchWithPayment } = await import("@x402/fetch");
   const { ExactEvmScheme } = await import("@x402/evm/exact/client");
   const { toClientEvmSigner } = await import("@x402/evm");
-  const account = privateKeyToAccount(allowance.privateKey);
 
   const mainnetClient = createPublicClient({ chain: base, transport: http() });
   const sepoliaClient = createPublicClient({ chain: baseSepolia, transport: http() });

package/lib/tier.mjs

@@ -38,7 +38,14 @@ async function set(tierName) {
   if (!tierName) { console.error(JSON.stringify({ status: "error", message: "Usage: run402 tier set <prototype|hobby|team>" })); process.exit(1); }
   const fetchPaid = await setupPaidFetch();
   const res = await fetchPaid(`${API}/tiers/v1/${tierName}`, { method: "POST", headers: { "Content-Type": "application/json" } });
-  const data = await res.json();
+  const text = await res.text();
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    console.error(JSON.stringify({ status: "error", http: res.status, message: "Non-JSON response from server", body: text.slice(0, 500) }));
+    process.exit(1);
+  }
   if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
   console.log(JSON.stringify(data, null, 2));
 }

package/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"
@@ -19,6 +19,7 @@
     "@noble/hashes": "^2.0.1",
     "@x402/evm": "^2.6.0",
     "@x402/fetch": "^2.6.0",
+    "mppx": "^0.4.7",
     "viem": "^2.47.1"
   },
   "engines": {