@toon-protocol/rig 2.10.3 → 2.12.0

package/dist/cli/rig.js

@@ -1074,7 +1074,7 @@ function loadPaidSession(deps, relayUrl) {
   });
 }
 var defaultLoadStandalone = async (options) => {
-  const mod = await import("../standalone-mode-YMIY4GL3.js");
+  const mod = await import("../standalone-mode-U3OOSVOB.js");
   return mod.createStandaloneContext(options);
 };
 function identityReport(ctx) {
@@ -1712,8 +1712,236 @@ async function runBalance(args, deps) {
   }
 }
 
-// src/cli/channel.ts
+// src/cli/chain.ts
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname, join as join2 } from "path";
 import { parseArgs as parseArgs4 } from "util";
+var FAMILY_USDC = {
+  evm: "EVM USDC (Base Sepolia on devnet)",
+  solana: "Solana USDC",
+  mina: "Mina USDC"
+};
+var FAMILY_ALIASES = {
+  evm: "evm",
+  eth: "evm",
+  sol: "solana",
+  solana: "solana",
+  mina: "mina"
+};
+var CHAIN_ARG_LIST = "evm | sol | solana | mina (or a full id like evm:base:84532)";
+var CHAIN_USAGE = `Usage: rig chain [set <chain> | unset]
+
+Choose which chain \u2014 and therefore which USDC token \u2014 settles paid \`rig\`
+writes. The choice is saved to the client config's \`chain\` field and applies to
+every subsequent paid command (there is no per-command chain flag). Free: only
+the local config file is touched.
+
+  rig chain               show the current settlement-chain preference
+  rig chain set <chain>   pin the settlement chain / USDC:
+                            evm   \u2192 EVM USDC (Base Sepolia on devnet)
+                            sol   \u2192 Solana USDC
+                            mina  \u2192 Mina USDC
+                          (a full id like evm:base:84532 or solana:devnet also
+                          works; \`solana\` is accepted for \`sol\`, \`eth\` for \`evm\`)
+  rig chain unset         clear the pin \u2014 revert to automatic selection
+
+When nothing is pinned, rig auto-selects: your most-recently-used open channel's
+chain, else the first announced chain your wallet holds USDC on, else the first
+announced EVM chain.
+
+Options:
+  --json               machine-readable envelope
+  -h, --help           show this help`;
+function configPathFor(env) {
+  const dir = env["TOON_CLIENT_HOME"] ?? join2(homedir2(), ".toon-client");
+  return join2(dir, "config.json");
+}
+function readChainConfig(configPath) {
+  try {
+    return JSON.parse(readFileSync2(configPath, "utf8"));
+  } catch (err) {
+    if (err.code === "ENOENT") return {};
+    throw new Error(
+      `failed to read client config at ${configPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
+function writeChainConfig(configPath, file) {
+  mkdirSync2(dirname(configPath), { recursive: true });
+  writeFileSync2(configPath, `${JSON.stringify(file, null, 2)}
+`, "utf8");
+}
+function normalizeChain(raw) {
+  if (raw.includes(":")) {
+    const family = raw.split(":")[0]?.toLowerCase() ?? "";
+    if (!(family in FAMILY_USDC)) {
+      throw new Error(
+        `unknown chain family in ${JSON.stringify(raw)} \u2014 must start with evm:, solana:, or mina:`
+      );
+    }
+    return raw;
+  }
+  const canonical = FAMILY_ALIASES[raw.toLowerCase()];
+  if (!canonical) {
+    throw new Error(`chain must be one of ${CHAIN_ARG_LIST}, got ${JSON.stringify(raw)}`);
+  }
+  return canonical;
+}
+function usdcFor(chain) {
+  const family = (chain.includes(":") ? chain.split(":")[0] ?? chain : chain).toLowerCase();
+  return FAMILY_USDC[family] ?? `${family} USDC`;
+}
+async function runChain(args, deps) {
+  const { io: io2, env } = deps;
+  let positionals;
+  let json = false;
+  try {
+    const parsed = parseArgs4({
+      args,
+      allowPositionals: true,
+      options: {
+        json: { type: "boolean", default: false },
+        help: { type: "boolean", short: "h", default: false }
+      }
+    });
+    if (parsed.values.help) {
+      io2.out(CHAIN_USAGE);
+      return 0;
+    }
+    positionals = parsed.positionals;
+    json = parsed.values.json ?? false;
+  } catch (err) {
+    io2.err(err instanceof Error ? err.message : String(err));
+    io2.err(CHAIN_USAGE);
+    return 2;
+  }
+  const [sub, ...subRest] = positionals;
+  if (sub !== void 0 && sub !== "set" && sub !== "unset") {
+    io2.err(`unknown subcommand ${JSON.stringify(sub)} \u2014 expected \`set\`, \`unset\`, or no argument`);
+    io2.err(CHAIN_USAGE);
+    return 2;
+  }
+  if (sub === "set" && subRest.length !== 1) {
+    io2.err(
+      subRest.length === 0 ? `rig chain set needs a chain: ${CHAIN_ARG_LIST}` : `rig chain set takes exactly one chain, got ${subRest.length}: ${subRest.join(" ")}`
+    );
+    io2.err(CHAIN_USAGE);
+    return 2;
+  }
+  if (sub === "unset" && subRest.length !== 0) {
+    io2.err(`rig chain unset takes no arguments, got: ${subRest.join(" ")}`);
+    io2.err(CHAIN_USAGE);
+    return 2;
+  }
+  let setValue;
+  if (sub === "set") {
+    try {
+      setValue = normalizeChain(subRest[0]);
+    } catch (err) {
+      io2.err(err instanceof Error ? err.message : String(err));
+      io2.err(CHAIN_USAGE);
+      return 2;
+    }
+  }
+  try {
+    const configPath = configPathFor(env);
+    const file = readChainConfig(configPath);
+    const envChain = env["TOON_CLIENT_CHAIN"];
+    const supported0 = file.supportedChains?.[0];
+    const precedenceWarnings = (targetField) => {
+      const w = [];
+      if (envChain !== void 0) {
+        w.push(
+          `TOON_CLIENT_CHAIN=${envChain} is set in the environment and overrides the config ${targetField === "chain" ? "value you just wrote" : "file"} \u2014 unset it for the config to take effect.`
+        );
+      }
+      if (supported0 !== void 0) {
+        w.push(
+          `config \`supportedChains\` is set (first entry ${JSON.stringify(supported0)}) and takes precedence over \`chain\` \u2014 clear or reorder it for this pin to take effect.`
+        );
+      }
+      return w;
+    };
+    if (sub === "set") {
+      const value = setValue;
+      file.chain = value;
+      writeChainConfig(configPath, file);
+      const warnings = precedenceWarnings("chain");
+      if (json) {
+        io2.emitJson({
+          command: "chain",
+          chain: envChain ?? value,
+          source: envChain !== void 0 ? "env" : "config",
+          usdc: usdcFor(envChain ?? value),
+          wrote: value,
+          configPath,
+          ...warnings.length ? { warnings } : {}
+        });
+        return 0;
+      }
+      io2.out(`Settlement chain set to ${value} \u2192 spends ${usdcFor(value)}.`);
+      io2.out(`Saved to ${configPath}. Applies to the next paid command (e.g. \`rig push\`).`);
+      for (const w of warnings) io2.err(`warning: ${w}`);
+      return 0;
+    }
+    if (sub === "unset") {
+      const had = file.chain;
+      delete file.chain;
+      writeChainConfig(configPath, file);
+      const stillPinned = envChain ?? supported0;
+      if (json) {
+        io2.emitJson({
+          command: "chain",
+          chain: stillPinned ?? null,
+          source: envChain !== void 0 ? "env" : supported0 !== void 0 ? "supportedChains" : "auto",
+          usdc: stillPinned ? usdcFor(stillPinned) : null,
+          wrote: null,
+          configPath,
+          ...precedenceWarnings(null).length ? { warnings: precedenceWarnings(null) } : {}
+        });
+        return 0;
+      }
+      io2.out(
+        had !== void 0 ? `Cleared the settlement-chain pin (was ${had}).` : "No settlement-chain pin was set."
+      );
+      if (stillPinned !== void 0) {
+        io2.out(`Still pinned to ${stillPinned} by ${envChain !== void 0 ? "TOON_CLIENT_CHAIN" : "config supportedChains"} \u2192 ${usdcFor(stillPinned)}.`);
+      } else {
+        io2.out("Reverted to automatic selection (most-recent channel \u2192 first funded announced chain \u2192 first EVM).");
+      }
+      return 0;
+    }
+    const effective = envChain ?? file.chain ?? supported0;
+    const source = envChain !== void 0 ? "env" : file.chain !== void 0 ? "config" : supported0 !== void 0 ? "supportedChains" : "auto";
+    if (json) {
+      io2.emitJson({
+        command: "chain",
+        chain: effective ?? null,
+        source,
+        usdc: effective ? usdcFor(effective) : null,
+        configPath
+      });
+      return 0;
+    }
+    if (effective !== void 0) {
+      const via = source === "env" ? "TOON_CLIENT_CHAIN env" : source === "config" ? `config \`chain\` (${configPath})` : `config \`supportedChains[0]\``;
+      io2.out(`Settlement chain: ${effective} \u2192 spends ${usdcFor(effective)} (from ${via}).`);
+      io2.out("Change it with `rig chain set <evm|sol|mina>`, or `rig chain unset` for auto.");
+    } else {
+      io2.out("Settlement chain: (auto) \u2014 no pin set.");
+      io2.out("rig picks your most-recent open channel, else the first announced chain your");
+      io2.out("wallet holds USDC on, else the first announced EVM chain.");
+      io2.out("Pin one with `rig chain set <evm|sol|mina>`.");
+    }
+    return 0;
+  } catch (err) {
+    return emitCliError(io2, json, "chain", err);
+  }
+}
+
+// src/cli/channel.ts
+import { parseArgs as parseArgs5 } from "util";
 var CHANNEL_USAGE = `Usage: rig channel <subcommand>
 
 Manage the payment channels paid rig commands hold with relay/store peers.
@@ -1780,7 +2008,7 @@ function runChannelList(args, deps) {
   const { io: io2, env } = deps;
   let json = false;
   try {
-    const { values } = parseArgs4({
+    const { values } = parseArgs5({
       args,
       options: {
         json: { type: "boolean", default: false },
@@ -1899,7 +2127,7 @@ async function runChannelOpen(args, deps) {
   let yes = false;
   let json = false;
   try {
-    const { values } = parseArgs4({
+    const { values } = parseArgs5({
       args,
       options: {
         peer: { type: "string" },
@@ -2036,7 +2264,7 @@ async function runChannelWithdrawStep(args, deps, step) {
   let yes = false;
   let json = false;
   try {
-    const { values, positionals } = parseArgs4({
+    const { values, positionals } = parseArgs5({
       args,
       options: {
         yes: { type: "boolean", default: false },
@@ -2177,8 +2405,8 @@ async function stopQuietly(ctx) {
 
 // src/cli/clone.ts
 import { mkdtemp, mkdir, readdir, rename, rm, rmdir } from "fs/promises";
-import { basename, dirname, join as join2, resolve } from "path";
-import { parseArgs as parseArgs5 } from "util";
+import { basename, dirname as dirname2, join as join3, resolve } from "path";
+import { parseArgs as parseArgs6 } from "util";
 var CLONE_USAGE = `Usage: rig clone <relay-url> <owner>/<repo-id> [dir] [options]
 
 Clone a TOON repository \u2014 FREE (relay reads + Arweave gateway downloads; no
@@ -2219,7 +2447,7 @@ var MissingRemoteObjectsError = class extends Error {
 };
 var WS_URL_RE = /^wss?:\/\//i;
 function parseCloneArgs(args) {
-  const { values, positionals } = parseArgs5({
+  const { values, positionals } = parseArgs6({
     args,
     options: {
       json: { type: "boolean", default: false },
@@ -2346,9 +2574,9 @@ async function runClone(args, deps) {
         `warning: unreachable object ${sha} (tx ${txId}) could not be downloaded \u2014 not needed by any ref, continuing`
       );
     }
-    const parent = dirname(dest);
+    const parent = dirname2(dest);
     await mkdir(parent, { recursive: true });
-    tempDir = await mkdtemp(join2(parent, `.${basename(dest)}.rig-clone-`));
+    tempDir = await mkdtemp(join3(parent, `.${basename(dest)}.rig-clone-`));
     await runGit(tempDir, [
       "init",
       "--quiet",
@@ -2418,7 +2646,7 @@ async function runClone(args, deps) {
 
 // src/cli/events.ts
 import { readFile } from "fs/promises";
-import { parseArgs as parseArgs7 } from "util";
+import { parseArgs as parseArgs8 } from "util";
 import {
   REPOSITORY_ANNOUNCEMENT_KIND as REPOSITORY_ANNOUNCEMENT_KIND2,
   STATUS_APPLIED_KIND as STATUS_APPLIED_KIND2,
@@ -2428,7 +2656,7 @@ import {
 } from "@toon-protocol/core/nip34";
 
 // src/cli/tracker.ts
-import { parseArgs as parseArgs6 } from "util";
+import { parseArgs as parseArgs7 } from "util";
 import {
   ISSUE_KIND,
   PATCH_KIND,
@@ -2761,7 +2989,7 @@ async function runList(args, deps, spec) {
   const { io: io2 } = deps;
   let flags;
   try {
-    const { values, positionals } = parseArgs6({
+    const { values, positionals } = parseArgs7({
       args,
       options: TRACKER_OPTIONS,
       allowPositionals: true
@@ -2825,7 +3053,7 @@ async function runShow(args, deps, spec) {
   let flags;
   let eventId;
   try {
-    const { values, positionals } = parseArgs6({
+    const { values, positionals } = parseArgs7({
       args,
       options: TRACKER_OPTIONS,
       allowPositionals: true
@@ -3212,7 +3440,7 @@ async function runIssue(args, deps) {
   let bodyFile;
   let labels;
   try {
-    const { values } = parseArgs7({
+    const { values } = parseArgs8({
       args: rest,
       options: {
         ...COMMON_OPTIONS,
@@ -3288,7 +3516,7 @@ async function runComment(args, deps) {
   let parentAuthor;
   let marker;
   try {
-    const { values, positionals } = parseArgs7({
+    const { values, positionals } = parseArgs8({
       args,
       options: {
         ...COMMON_OPTIONS,
@@ -3388,7 +3616,7 @@ async function runPrCreate(rest, deps) {
   let bodyFlag;
   let bodyFile;
   try {
-    const { values } = parseArgs7({
+    const { values } = parseArgs8({
       args: rest,
       options: {
         ...COMMON_OPTIONS,
@@ -3516,7 +3744,7 @@ async function runPrStatus(args, deps) {
   let targetEventId;
   let status;
   try {
-    const { values, positionals } = parseArgs7({
+    const { values, positionals } = parseArgs8({
       args,
       options: COMMON_OPTIONS,
       allowPositionals: true
@@ -3595,7 +3823,7 @@ async function warnIfNotMaintainer(deps, args) {
 }
 
 // src/cli/fetch.ts
-import { parseArgs as parseArgs8 } from "util";
+import { parseArgs as parseArgs9 } from "util";
 var FETCH_USAGE = `Usage: rig fetch [remote] [options]
 
 Fetch from a TOON remote \u2014 FREE (relay reads + Arweave gateway downloads; no
@@ -3649,7 +3877,7 @@ async function runFetch(args, deps) {
   let ownerFlag;
   let concurrency;
   try {
-    const { values, positionals } = parseArgs8({
+    const { values, positionals } = parseArgs9({
       args,
       options: {
         json: { type: "boolean", default: false },
@@ -3814,10 +4042,10 @@ async function runFetch(args, deps) {
 }
 
 // src/cli/fund.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join3 } from "path";
-import { parseArgs as parseArgs9 } from "util";
+import { readFileSync as readFileSync3 } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+import { parseArgs as parseArgs10 } from "util";
 var DEVNET_FAUCET_URL = "https://faucet.devnet.toonprotocol.dev";
 var CHAINS = ["evm", "solana", "mina"];
 var CHAIN_ALIASES = {
@@ -3828,13 +4056,13 @@ var CHAIN_ALIASES = {
   mina: "mina",
   all: "all"
 };
-var CHAIN_ARG_LIST = "evm | sol | solana | mina | all";
+var CHAIN_ARG_LIST2 = "evm | sol | solana | mina | all";
 function resolveChainArg(raw) {
   if (raw === void 0) return void 0;
   const canonical = CHAIN_ALIASES[raw.toLowerCase()];
   if (!canonical) {
     throw new Error(
-      `chain must be one of ${CHAIN_ARG_LIST}, got ${JSON.stringify(raw)}`
+      `chain must be one of ${CHAIN_ARG_LIST2}, got ${JSON.stringify(raw)}`
     );
   }
   return canonical;
@@ -3921,11 +4149,11 @@ function noFaucetGuidance(network, devnetOrigin) {
   return `${head}. If you meant the shared devnet, set TOON_CLIENT_NETWORK=devnet and re-run \`rig fund\` \u2014 no faucet URL is needed there. If this is a self-hosted network with its own faucet, set TOON_CLIENT_FAUCET_URL (or the faucetUrl config field). ${external}`;
 }
 function readFundConfig(env) {
-  const dir = env["TOON_CLIENT_HOME"] ?? join3(homedir2(), ".toon-client");
-  const configPath = join3(dir, "config.json");
+  const dir = env["TOON_CLIENT_HOME"] ?? join4(homedir3(), ".toon-client");
+  const configPath = join4(dir, "config.json");
   try {
     return {
-      file: JSON.parse(readFileSync2(configPath, "utf8")),
+      file: JSON.parse(readFileSync3(configPath, "utf8")),
       configPath
     };
   } catch (err) {
@@ -3943,7 +4171,7 @@ async function runFund(args, deps) {
   let addressFlag;
   let json = false;
   try {
-    const { values, positionals } = parseArgs9({
+    const { values, positionals } = parseArgs10({
       args,
       allowPositionals: true,
       options: {
@@ -3973,7 +4201,7 @@ async function runFund(args, deps) {
     json = values.json ?? false;
     if (addressFlag !== void 0 && (resolvedChain === void 0 || resolvedChain === "all")) {
       throw new Error(
-        `--address requires an explicit single chain (${CHAIN_ARG_LIST}) \u2014 a single address cannot fund every chain`
+        `--address requires an explicit single chain (${CHAIN_ARG_LIST2}) \u2014 a single address cannot fund every chain`
       );
     }
   } catch (err) {
@@ -4165,10 +4393,10 @@ var runGitPassthrough = (argv2, options = {}) => {
 };
 
 // src/cli/identity-cmd.ts
-import { existsSync, mkdirSync as mkdirSync2 } from "fs";
-import { dirname as dirname2 } from "path";
+import { existsSync, mkdirSync as mkdirSync3 } from "fs";
+import { dirname as dirname3 } from "path";
 import { createInterface } from "readline/promises";
-import { parseArgs as parseArgs10 } from "util";
+import { parseArgs as parseArgs11 } from "util";
 async function loadKeyOps() {
   return await import("@toon-protocol/client");
 }
@@ -4217,7 +4445,7 @@ async function prepareKeystoreTarget(input) {
   const envPassword = input.env["TOON_CLIENT_KEYSTORE_PASSWORD"]?.trim() || void 0;
   const autoPassword = envPassword === void 0;
   const password = envPassword ?? DEFAULT_KEYSTORE_PASSWORD;
-  mkdirSync2(dirname2(keystorePath), { recursive: true });
+  mkdirSync3(dirname3(keystorePath), { recursive: true });
   return { keystorePath, password, autoPassword, existing, keyOps };
 }
 function readAccountIndex(env) {
@@ -4339,7 +4567,7 @@ async function runIdentity(args, deps) {
   }
 }
 function parseMintArgs(args, verb) {
-  const { values, positionals } = parseArgs10({
+  const { values, positionals } = parseArgs11({
     args,
     options: {
       force: { type: "boolean", default: false },
@@ -4444,7 +4672,7 @@ async function runIdentityShow(args, deps) {
   let json = false;
   let help = false;
   try {
-    const parsed = parseArgs10({
+    const parsed = parseArgs11({
       args,
       options: {
         json: { type: "boolean", default: false },
@@ -4553,7 +4781,7 @@ async function defaultReadSecretLine(prompt, isInteractive) {
 
 // src/cli/init.ts
 import { basename as basename2 } from "path";
-import { parseArgs as parseArgs11 } from "util";
+import { parseArgs as parseArgs12 } from "util";
 
 // src/cli/git-author.ts
 var PROFILE_KIND = 0;
@@ -4671,7 +4899,7 @@ Options:
   --json               machine-readable report
   -h, --help           show this help`;
 function parseInitArgs(args) {
-  const { values, positionals } = parseArgs11({
+  const { values, positionals } = parseArgs12({
     args,
     options: {
       "repo-id": { type: "string" },
@@ -4715,7 +4943,7 @@ async function resolveProfileRelay(flagRelay, originRelay, toonRelays) {
   ].filter((u) => u !== void 0 && isWebSocketRelay2(u));
   if (candidates[0] !== void 0) return candidates[0];
   try {
-    const { loadGenesisSeed } = await import("../network-bootstrap-IHQ4PWUW.js");
+    const { loadGenesisSeed } = await import("../network-bootstrap-3X2GXNJB.js");
     const seed = loadGenesisSeed();
     if (seed?.relayUrl && isWebSocketRelay2(seed.relayUrl)) return seed.relayUrl;
   } catch {
@@ -4904,7 +5132,7 @@ async function runInit(args, deps) {
 }
 
 // src/cli/maintainers.ts
-import { parseArgs as parseArgs12 } from "util";
+import { parseArgs as parseArgs13 } from "util";
 var HEX64_RE3 = /^[0-9a-f]{64}$/;
 var WS_URL_RE4 = /^wss?:\/\//i;
 var MAINTAINERS_USAGE = `Usage: rig maintainers <list|add|remove> [<pubkey>] [options]
@@ -5009,7 +5237,7 @@ async function runList2(args, deps) {
   const { io: io2 } = deps;
   let flags;
   try {
-    const { values, positionals } = parseArgs12({
+    const { values, positionals } = parseArgs13({
       args,
       options: MAINT_OPTIONS,
       allowPositionals: true
@@ -5076,7 +5304,7 @@ async function runMutate(op, args, deps) {
   let flags;
   let pubkey;
   try {
-    const { values, positionals } = parseArgs12({
+    const { values, positionals } = parseArgs13({
       args,
       options: MAINT_OPTIONS,
       allowPositionals: true
@@ -5225,7 +5453,7 @@ async function runMutate(op, args, deps) {
 
 // src/cli/name.ts
 import { randomUUID } from "crypto";
-import { parseArgs as parseArgs13 } from "util";
+import { parseArgs as parseArgs14 } from "util";
 var ARIO_DECIMALS = 6;
 function renderMario(mario) {
   return `${mario.toString()} mARIO (~${formatUnits(mario.toString(), ARIO_DECIMALS)} ARIO)`;
@@ -5732,7 +5960,7 @@ async function resolveNameContext(deps, network, processId, mode) {
   return { identity, solanaAddress, network, processId, sdk, nostrSecretKey };
 }
 function parseNameFlags(args, env) {
-  const { values, positionals } = parseArgs13({
+  const { values, positionals } = parseArgs14({
     args,
     allowPositionals: true,
     options: {
@@ -6222,7 +6450,7 @@ async function runName(args, deps) {
 }
 
 // src/cli/site.ts
-import { parseArgs as parseArgs14 } from "util";
+import { parseArgs as parseArgs15 } from "util";
 
 // src/arweave-manifest.ts
 var DEFAULT_INDEX = "index.html";
@@ -6241,22 +6469,22 @@ function buildArweaveManifest(entries, indexPath = DEFAULT_INDEX, fallbackTxId)
 }
 
 // src/cli/site-record.ts
-import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join4 } from "path";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join5 } from "path";
 var SITE_MANIFEST_FILENAME = "site-manifests.json";
 function storeDir2(env) {
-  return env["TOON_CLIENT_HOME"] ?? join4(homedir3(), ".toon-client");
+  return env["TOON_CLIENT_HOME"] ?? join5(homedir4(), ".toon-client");
 }
 function storePath2(env) {
-  return join4(storeDir2(env), SITE_MANIFEST_FILENAME);
+  return join5(storeDir2(env), SITE_MANIFEST_FILENAME);
 }
 function keyOf(repoId, ref) {
   return `${repoId}\0${ref}`;
 }
 function readFile2(env) {
   try {
-    const parsed = JSON.parse(readFileSync3(storePath2(env), "utf8"));
+    const parsed = JSON.parse(readFileSync4(storePath2(env), "utf8"));
     if (parsed && typeof parsed === "object") return parsed;
     return {};
   } catch {
@@ -6268,10 +6496,10 @@ function readSiteRecord(env, repoId, ref) {
 }
 function writeSiteRecord(env, record) {
   const dir = storeDir2(env);
-  mkdirSync3(dir, { recursive: true });
+  mkdirSync4(dir, { recursive: true });
   const file = readFile2(env);
   file[keyOf(record.repoId, record.ref)] = record;
-  writeFileSync2(storePath2(env), `${JSON.stringify(file, null, 2)}
+  writeFileSync3(storePath2(env), `${JSON.stringify(file, null, 2)}
 `, "utf8");
 }
 
@@ -6313,7 +6541,7 @@ Options (publish):
                        estimate (nothing uploaded)
   -h, --help           show this help`;
 function parseSiteArgs(args) {
-  const { values, positionals } = parseArgs14({
+  const { values, positionals } = parseArgs15({
     args,
     options: {
       index: { type: "string" },
@@ -6721,6 +6949,8 @@ Commands rig owns:
                              address(es) to fund externally
   balance                    wallet balances + payment-channel holdings
                              (free \u2014 chain reads and local state only)
+  chain [set <c>|unset]      choose which chain/USDC settles paid writes
+                             (evm|sol|mina); free \u2014 reads/writes local config
   name buy <name>            ArNS naming (#367): buy points a human name at an
   name set <name> <txId>     Arweave txId, owned + paid by this identity's
   name status <name>         Solana key. buy spends mARIO on Solana via the
@@ -6796,6 +7026,8 @@ async function dispatch(argv2, deps) {
       return runFund(rest, deps);
     case "balance":
       return runBalance(rest, deps);
+    case "chain":
+      return runChain(rest, deps);
     case "name":
       return runName(rest, deps);
     case "help":