run402 4.118.0 → 4.120.0

package/cli.mjs

@@ -32,7 +32,7 @@ Commands, grouped by when you reach for them:
 
 SET UP — get an agent funded and entitled
   init        Set up the local wallet, funding, and check tier status (x402 default)
-  init mpp    Set up with MPP payment rail (Tempo Moderato testnet)
+  init mpp    Set up with MPP payment rail (pathUSD on Tempo; faucet-funded on Moderato)
   wallets     Manage local wallets (list, current, new, use, fund, balance, import)
   tier        Manage your tier and its lease (status, set)
   redeem      Redeem a promo code into your organization's allowance
@@ -128,7 +128,7 @@ Examples:
 
 Getting started:
   run402 init               Set up with x402 (Base Sepolia)
-  run402 init mpp           Set up with MPP (Tempo Moderato)
+  run402 init mpp           Set up with MPP (pathUSD on Tempo)
   run402 tier set prototype  Set a tier (prototype is free)
   run402 up --name my-app -y  Create and deploy this app (explicit destination)
   run402 ci link github --project prj_... --manifest run402.deploy.json

package/lib/command-manifest.mjs

@@ -466,6 +466,9 @@ export const COMMAND_MANIFEST = [
   { path: ["contracts", "set-alert"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--threshold-wei", "1"] },
   { path: ["contracts", "call"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--to", "0x4444444444444444444444444444444444444444", "--abi", "[]", "--fn", "noop", "--args", "[]"] },
   { path: ["contracts", "deploy"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--bytecode", "0x00"] },
+  { path: ["contracts", "transfers", "create"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--to", "0x4444444444444444444444444444444444444444", "--amount", "1"] },
+  { path: ["contracts", "transfers", "get"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--transfer", "txf_gate1"] },
+  { path: ["contracts", "transfers", "list"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1"] },
   { path: ["contracts", "read"], positionals: [], projectScoped: false, legacyPositionalProject: false, minimalArgs: ["--chain", "base-sepolia", "--to", "0x4444444444444444444444444444444444444444", "--abi", "[]", "--fn", "noop", "--args", "[]"] },
   { path: ["contracts", "status"], positionals: [p("call_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["ccall_gate1"] },
   { path: ["contracts", "drain"], positionals: [p("signer_id")], projectScoped: true, legacyPositionalProject: true, minimalArgs: ["cwlt_gate1", "--to", "0x4444444444444444444444444444444444444444", "--confirm"] },

package/lib/contracts.mjs

@@ -11,7 +11,7 @@ import {
   failUnknownSubcommand,
 } from "./argparse.mjs";
 
-const HELP = `run402 contracts — KMS-backed Ethereum signers for smart-contract calls
+const HELP = `run402 contracts — signers, your app's wallet, for smart-contract calls
 
   Pricing: $0.04/day per signer ($1.20/month) plus $0.000005 per contract call.
   Signer creation requires $1.20 of allowance (30 days of rent).
@@ -22,19 +22,25 @@ Usage:
 
 Subcommands:
   provision-signer <project_id> --chain <base-mainnet|base-sepolia> [--recovery 0x...]
-    Provision a KMS signer ($0.04/day, requires $1.20 prepay).
+    Provision a signer ($0.04/day wallet rent, requires $1.20 prepay).
   get-signer <project_id> <signer_id>
     Get signer metadata + live native balance.
   list-signers <project_id>
-    List all KMS signers for the project (includes deleted).
+    List all signers for the project (includes deleted).
+  transfers create <signer_id> --to 0x... --amount <base units> [--asset usdc] [--chain <base-mainnet|base-sepolia>] [--idempotency-key <k>]
+    Send a token from the signer with no gas on it: the platform's facilitator settles the signed EIP-3009 authorization and pays the gas. One signing fee.
+  transfers get <signer_id> --transfer <transfer_id>
+    Read one transfer (status, tx hash, nonce, failure phase).
+  transfers list <signer_id>
+    The signer's transfers, newest first.
   set-recovery <project_id> <signer_id> [--address 0x... | --clear]
     Set/clear the optional recovery address.
   set-alert <project_id> <signer_id> --threshold-wei <n>
     Set the low-balance alert threshold (in wei).
   call <project_id> <signer_id> --to 0x... --abi <json> --fn <name> --args <json> [--value-wei <n>] [--idempotency-key <k>]
-    Submit a contract write call (chain gas + $0.000005 KMS sign fee).
+    Submit a contract write call (gas from the signer's balance, topped up at cost when short, + $0.000005 signing fee).
   deploy <project_id> <signer_id> --bytecode 0x... [--chain <base-mainnet|base-sepolia>] [--value-wei <n>] [--idempotency-key <k>]
-    Deploy a contract (chain gas + $0.000005 KMS sign fee). Returns deterministic CREATE address synchronously.
+    Deploy a contract (gas from the signer's balance + $0.000005 signing fee). Returns deterministic CREATE address synchronously.
   read --chain <chain> --to 0x... --abi <json> --fn <name> --args <json>
     Read-only contract call (free).
   status <project_id> <call_id>
@@ -42,7 +48,7 @@ Subcommands:
   drain <project_id> <signer_id> --to 0x... --confirm
     Drain native balance to a destination address. Works on suspended signers.
   delete <project_id> <signer_id> --confirm
-    Schedule the KMS key for deletion (refused if balance >= dust).
+    Schedule the signing key for deletion (refused if balance >= dust).
 
 Examples:
   run402 contracts provision-signer proj_abc --chain base-mainnet
@@ -50,7 +56,22 @@ Examples:
 `;
 
 const SUB_HELP = {
-  "provision-signer": `run402 contracts provision-signer — Provision a KMS-backed signer
+  transfers: `run402 contracts transfers — Send a token from a signer with no gas on it
+
+Usage:
+  run402 contracts transfers create <signer_id> --to 0x... --amount <base units> [--asset usdc] [--chain <base-mainnet|base-sepolia>] [--idempotency-key <k>] [--project <project_id>]
+  run402 contracts transfers get <signer_id> --transfer <transfer_id> [--project <project_id>]
+  run402 contracts transfers list <signer_id> [--project <project_id>]
+
+The signer is the payer of an x402 payment: Run402 signs the token's EIP-3009
+authorization with the signer's key and its facilitator settles it and pays the
+gas. One $0.000005 signing fee, no gas, no ETH on the signer. --amount is in the
+asset's base units (USDC: 6 decimals; 100000 is $0.10). An idempotency key
+makes a repeat return the transfer already made; a transfer that failed before
+settlement re-executes under its key, one that died in settlement never does.
+A "unknown" status means the settle outcome never came back: poll it with get.
+`,
+  "provision-signer": `run402 contracts provision-signer — Provision a signer
 
 Usage:
   run402 contracts provision-signer --chain <chain> [--project <project_id>] [options]
@@ -91,11 +112,11 @@ Legacy (still supported):
   run402 contracts call <project_id> <signer_id> --to 0x... --abi <json>
     --fn <name> --args <json> [options]
 `,
-  deploy: `run402 contracts deploy — Deploy a smart contract from a KMS signer
+  deploy: `run402 contracts deploy — Deploy a smart contract from a signer
 
-KMS-signs a contract-creation transaction (to: null + data: bytecode) and broadcasts.
+the platform's key custody-signs a contract-creation transaction (to: null + data: bytecode) and broadcasts.
 Returns the deterministic CREATE address synchronously — known from (signer, nonce)
-before the tx confirms. Cost: chain gas at-cost + $0.000005 KMS sign fee.
+before the tx confirms. Cost: chain gas at-cost + $0.000005 signing fee.
 
 Usage:
   run402 contracts deploy <signer_id> --bytecode 0x... [--project <project_id>] [options]
@@ -130,7 +151,7 @@ Usage:
 Legacy (still supported):
   run402 contracts drain <project_id> <signer_id> --to 0x... --confirm
 `,
-  delete: `run402 contracts delete — Schedule the KMS key for deletion
+  delete: `run402 contracts delete — Schedule the signing key for deletion
 
 Usage:
   run402 contracts delete <signer_id> --confirm [--project <project_id>]
@@ -153,7 +174,7 @@ Arguments:
 Examples:
   run402 contracts get-signer prj_abc123 cwlt_abc123
 `,
-  "list-signers": `run402 contracts list-signers — List all KMS signers for a project
+  "list-signers": `run402 contracts list-signers — List all signers for a project
 
 Usage:
   run402 contracts list-signers [--project <project_id>]
@@ -344,7 +365,7 @@ async function call(projectId, signerId, args) {
     fail({
       code: "BAD_USAGE",
       message: "Required flags: --to, --abi, --fn, --args.",
-      hint: "Cost: chain gas + $0.000005 KMS sign fee.",
+      hint: "Cost: chain gas + $0.000005 signing fee.",
     });
   }
   assertAllowedValue(chain, ["base-mainnet", "base-sepolia"], "--chain");
@@ -369,6 +390,89 @@ async function call(projectId, signerId, args) {
   }
 }
 
+/**
+ * `run402 contracts transfers create|get|list` — a signer sends a token with
+ * no gas on it: the gateway signs the EIP-3009 authorization with the
+ * signer's key and the platform's facilitator settles it and pays the gas.
+ */
+async function transfers(projectId, args) {
+  const [transferAction, ...rest] = Array.isArray(args) ? args : [];
+  if (transferAction === "create") return transfersCreate(projectId, rest[0], rest.slice(1));
+  if (transferAction === "get") return transfersGet(projectId, rest[0], rest.slice(1));
+  if (transferAction === "list") return transfersList(projectId, rest[0], rest.slice(1));
+  return fail({
+    code: "BAD_USAGE",
+    message: `Unknown contracts transfers verb: ${transferAction ?? "(none)"}`,
+    hint: "Verbs: create <signer_id> --to 0x… --amount <base units> [--asset usdc] [--chain …] [--idempotency-key <k>]; get <signer_id> --transfer <transfer_id>; list <signer_id>.",
+  });
+}
+
+async function transfersCreate(projectId, signerId, args) {
+  const parsedArgs = normalizeArgv(args);
+  const valueFlags = ["--to", "--amount", "--asset", "--chain", "--idempotency-key"];
+  assertKnownFlags(parsedArgs, [...valueFlags, "--help", "-h"], valueFlags);
+  const extra = positionalArgs(parsedArgs, valueFlags);
+  if (!signerId || !/^[a-z]+_[A-Za-z0-9]{8,}$/.test(signerId)) {
+    fail({ code: "BAD_USAGE", message: "Missing <signer_id>.", hint: "run402 contracts transfers create <signer_id> --to 0x… --amount <base units>" });
+  }
+  if (extra.length > 0) {
+    fail({ code: "BAD_USAGE", message: `Unexpected argument for contracts transfers create: ${extra[0]}` });
+  }
+  const to = flagValue(parsedArgs, "--to");
+  const amount = flagValue(parsedArgs, "--amount");
+  const asset = flagValue(parsedArgs, "--asset") || "usdc";
+  const chain = flagValue(parsedArgs, "--chain") || "base-mainnet";
+  const idempotency = flagValue(parsedArgs, "--idempotency-key");
+  if (!to || !amount) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Required flags: --to, --amount.",
+      hint: "--amount is in the asset's base units as a decimal string (USDC: 6 decimals, so 100000 is $0.10). Cost: one $0.000005 signing fee, no gas.",
+    });
+  }
+  assertAllowedValue(chain, ["base-mainnet", "base-sepolia"], "--chain");
+  validateEvmAddress(to, "--to");
+  if (!/^[1-9][0-9]*$/.test(amount)) {
+    fail({ code: "BAD_USAGE", message: "--amount must be a positive integer in the asset's base units." });
+  }
+  try {
+    const data = await getSdk().contracts.transfer(projectId, {
+      signerId, chain, asset, to, amount, idempotencyKey: idempotency ?? undefined,
+    });
+    console.log(JSON.stringify(data, null, 2));
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function transfersGet(projectId, signerId, args) {
+  const parsedArgs = normalizeArgv(args);
+  assertKnownFlags(parsedArgs, ["--transfer", "--help", "-h"], ["--transfer"]);
+  const extra = positionalArgs(parsedArgs, ["--transfer"]);
+  const transferId = flagValue(parsedArgs, "--transfer");
+  if (!signerId || !transferId || extra.length > 0) {
+    fail({ code: "BAD_USAGE", message: "Usage: run402 contracts transfers get <signer_id> --transfer <transfer_id>" });
+  }
+  try {
+    console.log(JSON.stringify(await getSdk().contracts.transferStatus(projectId, signerId, transferId), null, 2));
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
+async function transfersList(projectId, signerId, args) {
+  const parsedArgs = normalizeArgv(args);
+  assertKnownFlags(parsedArgs, ["--help", "-h"], []);
+  if (!signerId) {
+    fail({ code: "BAD_USAGE", message: "Usage: run402 contracts transfers list <signer_id>" });
+  }
+  try {
+    console.log(JSON.stringify(await getSdk().contracts.listTransfers(projectId, signerId), null, 2));
+  } catch (err) {
+    reportSdkError(err);
+  }
+}
+
 async function deploy(projectId, signerId, args) {
   const parsedArgs = normalizeArgv(args);
   const valueFlags = ["--bytecode", "--value-wei", "--chain", "--idempotency-key"];
@@ -385,7 +489,7 @@ async function deploy(projectId, signerId, args) {
     fail({
       code: "BAD_USAGE",
       message: "Required flag: --bytecode (0x-prefixed hex; full creation calldata = creation bytecode + ABI-encoded constructor args, concatenated client-side).",
-      hint: "Cost: chain gas + $0.000005 KMS sign fee. Returns deterministic CREATE address synchronously.",
+      hint: "Cost: chain gas + $0.000005 signing fee. Returns deterministic CREATE address synchronously.",
     });
   }
   assertAllowedValue(chain, ["base-mainnet", "base-sepolia"], "--chain");
@@ -469,7 +573,7 @@ async function drain(projectId, signerId, args) {
     fail({
       code: "BAD_USAGE",
       message: "Required: --to 0x... and --confirm.",
-      hint: "Cost: chain gas + $0.000005 KMS sign fee.",
+      hint: "Cost: chain gas + $0.000005 signing fee.",
     });
   }
   validateEvmAddress(to, "--to");
@@ -508,6 +612,13 @@ export async function run(sub, args) {
   // unknown subcommands (and the anonymous `read`) never trip project
   // resolution.
   const select = () => resolveProjectSelector(normalizeArgv(Array.isArray(args) ? args : []));
+  // The transfers group dispatches with `if` (not `case`) so the sync test
+  // inventories its leaf actions through parseContractsTransferActions.
+  if (sub === "transfers") {
+    const { projectId, rest } = select();
+    await transfers(projectId, rest);
+    return;
+  }
   switch (sub) {
     case "provision-signer": { const { projectId, rest } = select(); await provisionSigner(projectId, rest); break; }
     case "get-signer":       { const { projectId, rest } = select(); await getSigner(projectId, rest[0], rest.slice(1)); break; }

package/lib/init.mjs

@@ -17,7 +17,7 @@ Usage:
   run402 init --api-base <url>
                              Configure a Run402 Core/API target for the active
                              profile without setting up Cloud payment.
-  run402 init mpp            Set up with MPP (Tempo Moderato)
+  run402 init mpp            Set up with MPP (pathUSD on Tempo)
   run402 init lightning      Set up the Lightning wallet: a budgeted wallet
                              minted on Run402's Hub (custody: Run402), plus the
                              Base wallet as the x402 fallback. Lightning

package/lib/orgs.mjs

@@ -21,7 +21,7 @@ Usage:
   run402 orgs list
   run402 orgs get    [<org_id>]
   run402 orgs rename [<org_id>] --name <display_name>   (or: --clear to remove the label)
-  run402 orgs payout-wallet [<org_id>] <wallet_address>  (or: --clear to remove the explicit default)
+  run402 orgs payout-wallet [<org_id>] <wallet_address>  (or: --signer <signer_id>; --clear removes the explicit default)
   run402 orgs lightning-receiver set    [<org_id>] <nwc-uri | ->   (receive-only NWC pairing; - reads it from stdin)
   run402 orgs lightning-receiver status [<org_id>]
   run402 orgs lightning-receiver delete [<org_id>]
@@ -161,6 +161,7 @@ call after a dropped response can never double-bill.
 
 Usage:
   run402 orgs payout-wallet [<org_id>] <wallet_address>
+  run402 orgs payout-wallet [<org_id>] --signer <signer_id>
   run402 orgs payout-wallet [<org_id>] --clear
 
 Legacy (still supported):
@@ -170,6 +171,11 @@ Admin/owner-only + step-up gated. The wallet must already be active and linked
 to the same org. This wallet receives x402 settlement for function web routes
 that declare pricing.pay_to = "org_default_payout". Pass --clear to remove the
 explicit default; a single active org wallet may still resolve automatically.
+Pass --signer <signer_id> to make one of the org's own signers (your app's
+wallet, run402 contracts provision-signer) the payout address instead, so what
+your priced routes earn is what your app pays out from. The signer must be
+active and owned by a project of this org; while it is selected, that project
+cannot be transferred out.
 
 The JSON response includes recovery.status, active_wallet_count, and
 next_actions for PAYOUT_WALLET_REQUIRED / PAYOUT_WALLET_AMBIGUOUS setup.
@@ -478,20 +484,24 @@ async function rename(args) {
 
 async function payoutWallet(args) {
   const a = normalizeArgv(args);
-  assertKnownFlags(a, ["--org", "--address", "--clear", "--help", "-h"], ["--org", "--address"]);
+  assertKnownFlags(a, ["--org", "--address", "--signer", "--clear", "--help", "-h"], ["--org", "--address", "--signer"]);
   const clear = a.includes("--clear");
   const walletFlag = flagValue(a, "--address");
-  const single = clear || walletFlag !== null;
-  const { orgId: org, rest: pos } = await takeOrgPositional(a, ["--org", "--address"], { cmd: "orgs" });
+  const signerFlag = flagValue(a, "--signer");
+  if (signerFlag !== null && (clear || walletFlag !== null)) {
+    fail({ code: "BAD_USAGE", message: "--signer cannot be combined with --address or --clear." });
+  }
+  const single = clear || walletFlag !== null || signerFlag !== null;
+  const { orgId: org, rest: pos } = await takeOrgPositional(a, ["--org", "--address", "--signer"], { cmd: "orgs" });
   requireRest(pos, {
     min: single ? 0 : 1,
     max: single ? 0 : 1,
-    command: "run402 orgs payout-wallet [<org_id>] --address <wallet_address>",
-    missing: "Missing <wallet_address> (use --address, or pass --clear).",
+    command: "run402 orgs payout-wallet [<org_id>] --address <wallet_address> | --signer <signer_id> | --clear",
+    missing: "Missing <wallet_address> (use --address, --signer <signer_id>, or --clear).",
   });
-  const walletAddress = clear ? null : (walletFlag ?? pos[0]);
+  const input = signerFlag !== null ? { signerId: signerFlag } : { walletAddress: clear ? null : (walletFlag ?? pos[0]) };
   try {
-    console.log(JSON.stringify(await getSdk().org(org).setPayoutWallet({ walletAddress }), null, 2));
+    console.log(JSON.stringify(await getSdk().org(org).setPayoutWallet(input), null, 2));
   } catch (err) {
     reportSdkError(err);
   }

package/lib/wallets.mjs

@@ -15,6 +15,7 @@ import { failUnknownSubcommand } from "./argparse.mjs";
 import { fail, reportLocalOrSdkError, reportSdkError } from "./sdk-errors.mjs";
 import { readWallet as readActiveWallet, saveWallet as saveActiveWallet } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
+import { ALL_ON_CHAIN_BALANCE_KEYS, readOnChainBalances, TEMPO_MODERATO } from "#sdk/node";
 
 const HELP = `run402 wallets — manage named wallets (profiles)
 
@@ -175,25 +176,11 @@ async function cmdLightning(args) {
 }
 
 // ── fund / balance (the ACTIVE wallet) ─────────────────────────────────────
-
-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, defineChain } = await import("viem");
-  const { base, baseSepolia } = await import("viem/chains");
-  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 };
-}
+//
+// Balances come from the SDK's one reader, under the snake_case keys
+// `run402 status` and `run402 init` share (spec status-account-balances):
+// base_mainnet_usd_micros, base_sepolia_usd_micros,
+// tempo_mainnet_pathusd_micros, tempo_moderato_pathusd_micros.
 
 async function cmdFund() {
   const w = readActiveWallet();
@@ -206,12 +193,9 @@ async function cmdFund() {
   }
 
   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, {
+    // Tempo Moderato faucet (test pathUSD) — instant, no polling needed.
+    // Paid tiers and images prefer pathUSD on Tempo mainnet, which no faucet gives.
+    const res = await fetch(TEMPO_MODERATO.rpcUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ jsonrpc: "2.0", method: "tempo_fundAddress", params: [w.address], id: 1 }),
@@ -225,23 +209,16 @@ async function cmdFund() {
       });
     }
 
-    // Re-read balance once (instant confirmation)
-    const now = await readUsdcBalance(client, PATH_USD, w.address).catch(() => before);
+    const onchain = await readOnChainBalances(w.address, ["tempo_moderato_pathusd_micros"]);
     saveActiveWallet({ ...w, funded: true, lastFaucet: new Date().toISOString() });
-    console.log(JSON.stringify({
-      address: w.address,
-      rail: "mpp",
-      onchain: {
-        "tempo-moderato_pathusd_micros": now,
-      },
-    }, null, 2));
+    console.log(JSON.stringify({ address: w.address, rail: "mpp", onchain }, 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);
+  // Default: Base Sepolia faucet
+  const readSepolia = async () =>
+    (await readOnChainBalances(w.address, ["base_sepolia_usd_micros"])).base_sepolia_usd_micros;
+  const before = (await readSepolia()) ?? 0;
 
   let data;
   try {
@@ -253,15 +230,13 @@ async function cmdFund() {
   const MAX_WAIT = 30;
   for (let i = 0; i < MAX_WAIT; i++) {
     await new Promise(r => setTimeout(r, 1000));
-    const now = await readUsdcBalance(client, USDC_SEPOLIA, w.address).catch(() => before);
+    const now = (await readSepolia()) ?? before;
     if (now > before) {
       saveActiveWallet({ ...w, funded: true, lastFaucet: new Date().toISOString() });
       console.log(JSON.stringify({
         address: w.address,
         rail: w.rail || "x402",
-        onchain: {
-          "base-sepolia_usd_micros": now,
-        },
+        onchain: { base_sepolia_usd_micros: now },
       }, null, 2));
       return;
     }
@@ -271,11 +246,6 @@ async function cmdFund() {
   console.log(JSON.stringify({ ...data, balance_confirmed: false, hint: "Faucet request sent but on-chain balance not yet confirmed" }));
 }
 
-async function readUsdcBalance(client, usdc, address) {
-  const raw = await client.readContract({ address: usdc, abi: USDC_ABI, functionName: "balanceOf", args: [address] });
-  return Number(raw);
-}
-
 async function cmdBalance() {
   const w = readActiveWallet();
   if (!w) {
@@ -286,26 +256,15 @@ async function cmdBalance() {
     });
   }
 
-  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, 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),
+  const [onchain, billingRes] = await Promise.all([
+    readOnChainBalances(w.address, ALL_ON_CHAIN_BALANCE_KEYS),
     getSdk().billing.checkBalance(w.address).catch(() => null),
   ]);
 
   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,
-    },
+    onchain,
     allowance_usd_micros: billingRes ? billingRes.allowance_usd_micros : null,
   }, null, 2));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "4.118.0",
+  "version": "4.120.0",
   "description": "CLI for Run402 — full-stack backend infrastructure for AI agents: Postgres, auth, storage, serverless functions and atomic deploys. Paid with x402/MPP. Includes $0.03 image generation.",
   "type": "module",
   "bin": {

package/sdk/dist/namespaces/contracts.d.ts

@@ -46,6 +46,39 @@ export interface ContractCallResult {
 export interface ContractReadResult {
     result: unknown;
 }
+/** app-wallet: a gasless token transfer from a signer, settled through the platform's facilitator. */
+export type SignerTransferStatus = "pending" | "settled" | "failed" | "unknown";
+export type SignerTransferPhase = "precheck" | "sign" | "verify" | "settle";
+export interface SignerTransfer {
+    transfer_id: string;
+    signer_id: string;
+    status: SignerTransferStatus;
+    tx_hash: string | null;
+    chain: EvmChain;
+    network: string;
+    asset: string;
+    asset_address: string;
+    to: string;
+    amount: string;
+    nonce: string | null;
+    failed_phase: SignerTransferPhase | null;
+    facilitator_reason: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface ListSignerTransfersResult {
+    transfers: SignerTransfer[];
+}
+export interface SignerTransferOptions {
+    signerId: string;
+    chain: EvmChain;
+    /** The token to send; `usdc` (the default) today. */
+    asset?: string;
+    to: string;
+    /** The amount in the asset's base units (USDC: 6 decimals), as a decimal string. */
+    amount: string;
+    idempotencyKey?: string;
+}
 export interface DrainResult {
     call_id: string;
     status: ContractCallStatus;
@@ -146,6 +179,20 @@ export declare class Contracts {
     /** Read-only smart-contract call (view/pure). No auth, no gas, no billing. */
     read(opts: ContractReadOptions): Promise<ContractReadResult>;
     /** Look up a previously submitted call by id. */
+    /**
+     * Transfers a token from a signer with no gas on the signer: the gateway
+     * signs the token's EIP-3009 authorization with the signer's key and the
+     * platform's facilitator settles it and pays the gas. One signing fee, no
+     * gas. Idempotent on `idempotencyKey` like `call`: a transfer that failed
+     * before settlement re-executes under its key; one that died in settlement
+     * never does. `status: "unknown"` means the settle outcome never came back;
+     * poll `transferStatus` until the reconciler finishes it.
+     */
+    transfer(projectId: string, opts: SignerTransferOptions): Promise<SignerTransfer>;
+    /** One transfer by id. */
+    transferStatus(projectId: string, signerId: string, transferId: string): Promise<SignerTransfer>;
+    /** The signer's transfers, newest first. */
+    listTransfers(projectId: string, signerId: string): Promise<ListSignerTransfersResult>;
     callStatus(projectId: string, callId: string): Promise<ContractCallResult>;
     /**
      * Drain the signer's native-token balance to a destination address.

package/sdk/dist/namespaces/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/namespaces/contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/namespaces/contracts.ts"],"names":[],"mappings":"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"}

package/sdk/dist/namespaces/contracts.js

@@ -198,6 +198,42 @@ export class Contracts {
         });
     }
     /** Look up a previously submitted call by id. */
+    /**
+     * Transfers a token from a signer with no gas on the signer: the gateway
+     * signs the token's EIP-3009 authorization with the signer's key and the
+     * platform's facilitator settles it and pays the gas. One signing fee, no
+     * gas. Idempotent on `idempotencyKey` like `call`: a transfer that failed
+     * before settlement re-executes under its key; one that died in settlement
+     * never does. `status: "unknown"` means the settle outcome never came back;
+     * poll `transferStatus` until the reconciler finishes it.
+     */
+    async transfer(projectId, opts) {
+        assertStringInSet(opts.chain, EVM_CHAINS, "chain", "transferring from signer");
+        assertEvmAddress(opts.to, "to", "transferring from signer");
+        if (typeof opts.amount !== "string" || !/^[1-9][0-9]*$/.test(opts.amount)) {
+            throw new LocalError("contracts.transfer requires amount as a positive integer string in the asset's base units", "transferring from signer");
+        }
+        const project = await requireProjectCredentials(this.client, projectId, "transferring from signer");
+        const headers = { Authorization: `Bearer ${project.service_key}` };
+        if (opts.idempotencyKey)
+            headers["Idempotency-Key"] = opts.idempotencyKey;
+        return this.client.request(`/contracts/v1/signers/${encodeURIComponent(opts.signerId)}/transfers`, {
+            method: "POST",
+            headers,
+            body: { chain: opts.chain, asset: opts.asset ?? "usdc", to: opts.to, amount: opts.amount },
+            context: "transferring from signer",
+        });
+    }
+    /** One transfer by id. */
+    async transferStatus(projectId, signerId, transferId) {
+        const project = await requireProjectCredentials(this.client, projectId, "fetching transfer status");
+        return this.client.request(`/contracts/v1/signers/${encodeURIComponent(signerId)}/transfers/${encodeURIComponent(transferId)}`, { headers: { Authorization: `Bearer ${project.service_key}` }, context: "fetching transfer status" });
+    }
+    /** The signer's transfers, newest first. */
+    async listTransfers(projectId, signerId) {
+        const project = await requireProjectCredentials(this.client, projectId, "listing signer transfers");
+        return this.client.request(`/contracts/v1/signers/${encodeURIComponent(signerId)}/transfers`, { headers: { Authorization: `Bearer ${project.service_key}` }, context: "listing signer transfers" });
+    }
     async callStatus(projectId, callId) {
         const project = await requireProjectCredentials(this.client, projectId, "fetching call status");
         return this.client.request(`/contracts/v1/calls/${encodeURIComponent(callId)}`, {