run402 1.27.0 → 1.29.0

package/cli.mjs

@@ -39,6 +39,8 @@ Commands:
   message     Send messages to Run402 developers
   auth        Manage project user authentication (magic link, passwords, settings)
   sender-domain  Manage custom email sender domain (register, status, remove)
+  billing     Email billing accounts, Stripe tier checkout, email packs
+  contracts   KMS contract wallets ($0.04/day rental + $0.000005/sign)
   agent       Manage agent identity (contact info)
 
 Run 'run402 <command> --help' for detailed usage of each command.
@@ -171,6 +173,16 @@ switch (cmd) {
     await run(sub, rest);
     break;
   }
+  case "billing": {
+    const { run } = await import("./lib/billing.mjs");
+    await run(sub, rest);
+    break;
+  }
+  case "contracts": {
+    const { run } = await import("./lib/contracts.mjs");
+    await run(sub, rest);
+    break;
+  }
   default:
     console.error(`Unknown command: ${cmd}\n`);
     console.log(HELP);

package/lib/billing.mjs

@@ -0,0 +1,169 @@
+import { API } from "./config.mjs";
+
+const HELP = `run402 billing — Email billing accounts, Stripe tier checkout, email packs
+
+Usage:
+  run402 billing <subcommand> [args...]
+
+Subcommands:
+  create-email <email>                     Create an email billing account
+  link-wallet <account_id> <wallet>        Link a wallet to an email account
+  tier-checkout <tier> [--email <e> | --wallet <w>]    Stripe tier checkout
+  buy-pack [--email <e> | --wallet <w>]    Buy \$5 email pack (10,000 emails)
+  auto-recharge <account_id> <on|off> [--threshold <n>]
+  balance <identifier>                     Balance by email or wallet (0x...)
+  history <identifier> [--limit <n>]       Ledger history by email or wallet
+
+Examples:
+  run402 billing create-email user@example.com
+  run402 billing tier-checkout hobby --email user@example.com
+  run402 billing buy-pack --wallet 0x1234...
+  run402 billing auto-recharge acct_abc on --threshold 2000
+  run402 billing balance user@example.com
+`;
+
+function parseFlag(args, flag) {
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === flag && args[i + 1]) return args[i + 1];
+  }
+  return null;
+}
+
+async function createEmail(args) {
+  const email = args[0];
+  if (!email) {
+    console.error(JSON.stringify({ status: "error", message: "Missing email. Usage: run402 billing create-email <email>" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/billing/v1/accounts`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function linkWallet(args) {
+  const accountId = args[0];
+  const wallet = args[1];
+  if (!accountId || !wallet) {
+    console.error(JSON.stringify({ status: "error", message: "Usage: run402 billing link-wallet <account_id> <wallet>" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/billing/v1/accounts/${encodeURIComponent(accountId)}/link-wallet`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ wallet }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function tierCheckout(args) {
+  const tier = args[0];
+  if (!tier) {
+    console.error(JSON.stringify({ status: "error", message: "Usage: run402 billing tier-checkout <tier> [--email <e> | --wallet <w>]" }));
+    process.exit(1);
+  }
+  const email = parseFlag(args, "--email");
+  const wallet = parseFlag(args, "--wallet");
+  if (!email && !wallet) {
+    console.error(JSON.stringify({ status: "error", message: "Must provide --email or --wallet" }));
+    process.exit(1);
+  }
+  const body = email ? { email } : { wallet };
+  const res = await fetch(`${API}/billing/v1/tiers/${encodeURIComponent(tier)}/checkout`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function buyPack(args) {
+  const email = parseFlag(args, "--email");
+  const wallet = parseFlag(args, "--wallet");
+  if (!email && !wallet) {
+    console.error(JSON.stringify({ status: "error", message: "Must provide --email or --wallet" }));
+    process.exit(1);
+  }
+  const body = email ? { email } : { wallet };
+  const res = await fetch(`${API}/billing/v1/email-packs/checkout`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function autoRecharge(args) {
+  const accountId = args[0];
+  const state = args[1];
+  if (!accountId || !state || !["on", "off"].includes(state)) {
+    console.error(JSON.stringify({ status: "error", message: "Usage: run402 billing auto-recharge <account_id> <on|off> [--threshold <n>]" }));
+    process.exit(1);
+  }
+  const thresholdStr = parseFlag(args, "--threshold");
+  const body = {
+    billing_account_id: accountId,
+    enabled: state === "on",
+  };
+  if (thresholdStr) body.threshold = Number(thresholdStr);
+  const res = await fetch(`${API}/billing/v1/email-packs/auto-recharge`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function balance(args) {
+  const id = args[0];
+  if (!id) {
+    console.error(JSON.stringify({ status: "error", message: "Usage: run402 billing balance <email-or-wallet>" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/billing/v1/accounts/${encodeURIComponent(id)}`);
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function history(args) {
+  const id = args[0];
+  if (!id) {
+    console.error(JSON.stringify({ status: "error", message: "Usage: run402 billing history <email-or-wallet> [--limit <n>]" }));
+    process.exit(1);
+  }
+  const limit = parseFlag(args, "--limit") || "50";
+  const res = await fetch(`${API}/billing/v1/accounts/${encodeURIComponent(id)}/history?limit=${encodeURIComponent(limit)}`);
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+export async function run(sub, args) {
+  if (!sub || sub === "--help" || sub === "-h") { console.log(HELP); process.exit(0); }
+  switch (sub) {
+    case "create-email": await createEmail(args); break;
+    case "link-wallet": await linkWallet(args); break;
+    case "tier-checkout": await tierCheckout(args); break;
+    case "buy-pack": await buyPack(args); break;
+    case "auto-recharge": await autoRecharge(args); break;
+    case "balance": await balance(args); break;
+    case "history": await history(args); break;
+    default:
+      console.error(`Unknown subcommand: ${sub}\n`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}

package/lib/contracts.mjs

@@ -0,0 +1,262 @@
+import { findProject, API } from "./config.mjs";
+
+const HELP = `run402 contracts — KMS-backed Ethereum wallets for smart-contract calls
+
+  Pricing: $0.04/day per wallet ($1.20/month) plus $0.000005 per contract call.
+  Wallet creation requires $1.20 in cash credit (30 days of rent).
+  Non-custodial: see https://run402.com/humans/terms.html#non-custodial-kms-wallets
+
+Usage:
+  run402 contracts <subcommand> [args...]
+
+Subcommands:
+  provision-wallet <project_id> --chain <base-mainnet|base-sepolia> [--recovery 0x...]
+    Provision a KMS wallet ($0.04/day, requires $1.20 prepay).
+  get-wallet <project_id> <wallet_id>
+    Get wallet metadata + live native balance.
+  list-wallets <project_id>
+    List all KMS wallets for the project (includes deleted).
+  set-recovery <project_id> <wallet_id> [--address 0x... | --clear]
+    Set/clear the optional recovery address.
+  set-alert <project_id> <wallet_id> --threshold-wei <n>
+    Set the low-balance alert threshold (in wei).
+  call <project_id> <wallet_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).
+  read --chain <chain> --to 0x... --abi <json> --fn <name> --args <json>
+    Read-only contract call (free).
+  status <project_id> <call_id>
+    Get call status, gas used, gas cost USD-micros, receipt.
+  drain <project_id> <wallet_id> --to 0x... --confirm
+    Drain native balance to a destination address. Works on suspended wallets.
+  delete <project_id> <wallet_id> --confirm
+    Schedule the KMS key for deletion (refused if balance >= dust).
+
+Examples:
+  run402 contracts provision-wallet proj_abc --chain base-mainnet
+  run402 contracts call proj_abc cwlt_xyz --to 0x1234... --abi '[{"type":"function","name":"ping","inputs":[],"outputs":[]}]' --fn ping --args '[]'
+`;
+
+function parseFlag(args, flag) {
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === flag && args[i + 1]) return args[i + 1];
+  }
+  return null;
+}
+function hasFlag(args, flag) {
+  return args.includes(flag);
+}
+
+async function provisionWallet(projectId, args) {
+  const p = findProject(projectId);
+  const chain = parseFlag(args, "--chain");
+  if (!chain) {
+    console.error(JSON.stringify({ status: "error", message: "Missing --chain (base-mainnet or base-sepolia)" }));
+    process.exit(1);
+  }
+  const recovery = parseFlag(args, "--recovery");
+  // Soft default of one wallet — confirm if project already has one
+  try {
+    const listRes = await fetch(`${API}/contracts/v1/wallets`, {
+      headers: { Authorization: `Bearer ${p.service_key}` },
+    });
+    if (listRes.ok) {
+      const list = await listRes.json();
+      const active = (list.wallets || []).filter((w) => w.status === "active");
+      if (active.length >= 1 && !hasFlag(args, "--yes")) {
+        console.error(`This project already has ${active.length} active wallet(s). Adding another costs $0.04/day each ($1.20/month). Re-run with --yes to confirm.`);
+        process.exit(1);
+      }
+    }
+  } catch { /* best-effort */ }
+  const body = { chain };
+  if (recovery) body.recovery_address = recovery;
+  const res = await fetch(`${API}/contracts/v1/wallets`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function getWallet(projectId, walletId) {
+  const p = findProject(projectId);
+  const res = await fetch(`${API}/contracts/v1/wallets/${encodeURIComponent(walletId)}`, {
+    headers: { Authorization: `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function listWallets(projectId) {
+  const p = findProject(projectId);
+  const res = await fetch(`${API}/contracts/v1/wallets`, {
+    headers: { Authorization: `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function setRecovery(projectId, walletId, args) {
+  const p = findProject(projectId);
+  const clear = hasFlag(args, "--clear");
+  const address = parseFlag(args, "--address");
+  if (!clear && !address) {
+    console.error(JSON.stringify({ status: "error", message: "Provide --address 0x... or --clear" }));
+    process.exit(1);
+  }
+  const body = { recovery_address: clear ? null : address };
+  const res = await fetch(`${API}/contracts/v1/wallets/${encodeURIComponent(walletId)}/recovery-address`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function setAlert(projectId, walletId, args) {
+  const p = findProject(projectId);
+  const threshold = parseFlag(args, "--threshold-wei");
+  if (!threshold) {
+    console.error(JSON.stringify({ status: "error", message: "Missing --threshold-wei <n>" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/contracts/v1/wallets/${encodeURIComponent(walletId)}/alert`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ threshold_wei: threshold }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function call(projectId, walletId, args) {
+  const p = findProject(projectId);
+  const to = parseFlag(args, "--to");
+  const abi = parseFlag(args, "--abi");
+  const fn = parseFlag(args, "--fn");
+  const argsJson = parseFlag(args, "--args");
+  const value = parseFlag(args, "--value-wei");
+  const chain = parseFlag(args, "--chain") || "base-mainnet";
+  const idempotency = parseFlag(args, "--idempotency-key");
+  if (!to || !abi || !fn || !argsJson) {
+    console.error(JSON.stringify({ status: "error", message: "Required flags: --to, --abi, --fn, --args. Cost: chain gas + $0.000005 KMS sign fee." }));
+    process.exit(1);
+  }
+  const body = {
+    wallet_id: walletId,
+    chain,
+    contract_address: to,
+    abi_fragment: JSON.parse(abi),
+    function_name: fn,
+    args: JSON.parse(argsJson),
+  };
+  if (value) body.value = value;
+  const headers = { Authorization: `Bearer ${p.service_key}`, "Content-Type": "application/json" };
+  if (idempotency) headers["Idempotency-Key"] = idempotency;
+  const res = await fetch(`${API}/contracts/v1/call`, { method: "POST", headers, body: JSON.stringify(body) });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function read(args) {
+  const chain = parseFlag(args, "--chain");
+  const to = parseFlag(args, "--to");
+  const abi = parseFlag(args, "--abi");
+  const fn = parseFlag(args, "--fn");
+  const argsJson = parseFlag(args, "--args");
+  if (!chain || !to || !abi || !fn || !argsJson) {
+    console.error(JSON.stringify({ status: "error", message: "Required flags: --chain, --to, --abi, --fn, --args" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/contracts/v1/read`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      chain,
+      contract_address: to,
+      abi_fragment: JSON.parse(abi),
+      function_name: fn,
+      args: JSON.parse(argsJson),
+    }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function status(projectId, callId) {
+  const p = findProject(projectId);
+  const res = await fetch(`${API}/contracts/v1/calls/${encodeURIComponent(callId)}`, {
+    headers: { Authorization: `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function drain(projectId, walletId, args) {
+  const p = findProject(projectId);
+  const to = parseFlag(args, "--to");
+  if (!to || !hasFlag(args, "--confirm")) {
+    console.error(JSON.stringify({ status: "error", message: "Required: --to 0x... and --confirm. Cost: chain gas + $0.000005 KMS sign fee." }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/contracts/v1/wallets/${encodeURIComponent(walletId)}/drain`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${p.service_key}`,
+      "Content-Type": "application/json",
+      "X-Confirm-Drain": walletId,
+    },
+    body: JSON.stringify({ destination_address: to }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function deleteWallet(projectId, walletId, args) {
+  const p = findProject(projectId);
+  if (!hasFlag(args, "--confirm")) {
+    console.error(JSON.stringify({ status: "error", message: "Required: --confirm" }));
+    process.exit(1);
+  }
+  const res = await fetch(`${API}/contracts/v1/wallets/${encodeURIComponent(walletId)}`, {
+    method: "DELETE",
+    headers: {
+      Authorization: `Bearer ${p.service_key}`,
+      "X-Confirm-Delete": walletId,
+    },
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+export async function run(sub, args) {
+  if (!sub || sub === "--help" || sub === "-h") { console.log(HELP); process.exit(0); }
+  switch (sub) {
+    case "provision-wallet": await provisionWallet(args[0], args.slice(1)); break;
+    case "get-wallet":       await getWallet(args[0], args[1]); break;
+    case "list-wallets":     await listWallets(args[0]); break;
+    case "set-recovery":     await setRecovery(args[0], args[1], args.slice(2)); break;
+    case "set-alert":        await setAlert(args[0], args[1], args.slice(2)); break;
+    case "call":             await call(args[0], args[1], args.slice(2)); break;
+    case "read":             await read(args); break;
+    case "status":           await status(args[0], args[1]); break;
+    case "drain":            await drain(args[0], args[1], args.slice(2)); break;
+    case "delete":           await deleteWallet(args[0], args[1], args.slice(2)); break;
+    default:
+      console.error(`Unknown subcommand: ${sub}\n`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}

package/package.json

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