@toon-protocol/townhouse 0.1.2 → 0.2.0

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import Docker from 'dockerode';
-import { C as ComposeLoaderOptions, T as TownhouseConfig, W as WalletManager, N as NodeType } from './manager-SsneW_Mj.js';
+import { C as ComposeLoaderOptions, T as TownhouseConfig, W as WalletManager, N as NodeType } from './manager-BtpOFwd6.js';
 
 /**
  * Cross-platform browser opener for the wizard CLI command.
@@ -119,12 +119,6 @@ interface CliNodeCommandOverrides {
     confirm?: (question: string) => Promise<boolean>;
     apiUrl?: string;
 }
-/**
- * Main CLI entry — exported for testability (same pattern as Mill CLI).
- * Accepts optional dockerode instance for dependency injection in tests.
- * The optional `hsOverrides` bag is used by unit tests to stub out Docker,
- * file I/O, and admin-client calls in the `hs up` / `hs down` path.
- */
 declare function main(argv: string[], dockerInstance?: Docker, browserOpener?: BrowserOpener, hsOverrides?: CliHsOverrides, nodeCommandOverrides?: CliNodeCommandOverrides): Promise<void>;
 
 export { CliHelpRequested, type CliHsOverrides, type CliNodeCommandOverrides, main };

package/dist/cli.js

@@ -23,11 +23,12 @@ import {
   materializeComposeTemplate,
   readImageManifest,
   readNodesYaml,
+  saveConfig,
   saveWallet,
   serviceFromContainerName,
   tailContainerLogs,
   writeHsConnectorConfig
-} from "./chunk-W33MEOPM.js";
+} from "./chunk-B4KWPVEK.js";
 import "./chunk-5O4SBV5O.js";
 import {
   CONTAINER_PREFIX
@@ -2004,6 +2005,9 @@ Usage:
   townhouse node add [<type>] [--json] [-c <path>]    Provision a child node (default: town)
   townhouse node remove <id> [--yes] [--json] [-c <path>]   Deprovision a child node
   townhouse node list [--json] [-c <path>]            List provisioned nodes
+  townhouse chains list [--json] [-c <path>]          List configured settlement chains (EVM/Solana/Mina)
+  townhouse chains add --chain-type <evm|solana|mina> --chain-id <id> [fields] [-c <path>]   Add/update a settlement chain
+  townhouse chains remove <chainId> [-c <path>]       Remove a settlement chain
   townhouse channels [--json]                    Show open payment channels
   townhouse logs <node-id> [-f|--follow] [--lines N] [--json]   Tail logs for a node (Ctrl-C to stop)
   townhouse peer <id> [--json]                   Show per-peer detail card
@@ -3029,8 +3033,52 @@ function isAnonBootstrapTimeout(err) {
 ${err.stderr ?? ""}`;
   return /connector.*unhealthy|dependency.*connector.*fail/i.test(text);
 }
+async function attachDashboard(hostname) {
+  if (!shouldRenderInk()) return;
+  try {
+    const { mountTui } = await import("./tui-QE3ZRZO3.js");
+    const apiUrlOverride = process.env["HS_TOWNHOUSE_API_URL"];
+    const mountOpts = apiUrlOverride !== void 0 ? { apiUrl: apiUrlOverride } : {};
+    const instance = mountTui(mountOpts);
+    await instance.waitUntilExit();
+  } catch (tuiErr) {
+    const detail = tuiErr instanceof Error ? tuiErr.message : String(tuiErr);
+    console.error("");
+    console.error(`Your node is live at ${hostname}.`);
+    console.error(
+      `The live dashboard could not open (${detail}) \u2014 this is a display issue, not a node issue. Your node keeps running.`
+    );
+    console.error(
+      "Stop it anytime with:  npx @toon-protocol/townhouse hs down"
+    );
+  }
+}
 async function handleHsUp(_configPath, configDir, config, docker, options) {
   const { password, force, skipPreflight, hsOverrides } = options;
+  if (!force) {
+    const adminClientFactory = hsOverrides?.createAdminClient ?? ((url, t) => new ConnectorAdminClient(url, t));
+    const probe = adminClientFactory(HS_CONNECTOR_ADMIN_URL, 3e3);
+    try {
+      const existing = await probe.getHsHostname();
+      if (existing.hostname !== null) {
+        console.log(`Apex live at ${existing.hostname}`);
+        _writeHostJson(configDir, {
+          hostname: existing.hostname,
+          publishedAt: existing.publishedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+          writtenAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        await attachDashboard(existing.hostname);
+        return;
+      }
+    } catch (probeErr) {
+      const msg = probeErr instanceof Error ? probeErr.message : String(probeErr);
+      if (msg.includes("anon-disabled")) {
+        const { exitCode } = renderFailure(probeErr);
+        process.exitCode = exitCode;
+        return;
+      }
+    }
+  }
   if (!skipPreflight) {
     const preflight = hsOverrides?.checkPortCollisions ?? ((d) => checkHsPortCollisions(d));
     try {
@@ -3089,29 +3137,6 @@ async function handleHsUp(_configPath, configDir, config, docker, options) {
   }
   const ribbon = new OnboardingRibbon();
   try {
-    if (!force) {
-      const adminClientFactory = hsOverrides?.createAdminClient ?? ((url, t) => new ConnectorAdminClient(url, t));
-      const probe = adminClientFactory(HS_CONNECTOR_ADMIN_URL, 3e3);
-      try {
-        const existing = await probe.getHsHostname();
-        if (existing.hostname !== null) {
-          console.log(`Apex live at ${existing.hostname}`);
-          _writeHostJson(configDir, {
-            hostname: existing.hostname,
-            publishedAt: existing.publishedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-            writtenAt: (/* @__PURE__ */ new Date()).toISOString()
-          });
-          return;
-        }
-      } catch (probeErr) {
-        const msg = probeErr instanceof Error ? probeErr.message : String(probeErr);
-        if (msg.includes("anon-disabled")) {
-          const { exitCode } = renderFailure(probeErr);
-          process.exitCode = exitCode;
-          return;
-        }
-      }
-    }
     writeHsConnectorConfig(configDir, config, { force });
     const materialize = hsOverrides?.materializeComposeTemplate ?? materializeComposeTemplate;
     const { composePath } = materialize("hs", { townhouseHome: configDir });
@@ -3141,6 +3166,7 @@ async function handleHsUp(_configPath, configDir, config, docker, options) {
         ribbon.start("bootstrap");
       }
     });
+    ribbon.stop();
     if (typeof orch.pullImage === "function") {
       try {
         const apexImages = await collectApexImageRefs(configDir);
@@ -3263,25 +3289,7 @@ async function handleHsUp(_configPath, configDir, config, docker, options) {
       writtenAt: (/* @__PURE__ */ new Date()).toISOString()
     });
     ribbon.start("live", hostname);
-    if (shouldRenderInk()) {
-      try {
-        const { mountTui } = await import("./tui-OIFXGBTL.js");
-        const apiUrlOverride = process.env["HS_TOWNHOUSE_API_URL"];
-        const mountOpts = apiUrlOverride !== void 0 ? { apiUrl: apiUrlOverride } : {};
-        const instance = mountTui(mountOpts);
-        await instance.waitUntilExit();
-      } catch (tuiErr) {
-        const detail = tuiErr instanceof Error ? tuiErr.message : String(tuiErr);
-        console.error("");
-        console.error(`Your node is live at ${hostname}.`);
-        console.error(
-          `The live dashboard could not open (${detail}) \u2014 this is a display issue, not a node issue. Your node keeps running.`
-        );
-        console.error(
-          "Stop it anytime with:  npx @toon-protocol/townhouse hs down"
-        );
-      }
-    }
+    await attachDashboard(hostname);
   } catch (err) {
     const { exitCode } = renderFailure(err);
     process.exitCode = exitCode;
@@ -3439,6 +3447,143 @@ function _runDockerComposeDown(composePath, withVolumes) {
     });
   });
 }
+var CHAINS_HELP = `townhouse chains \u2014 configure settlement chains (connector chainProviders)
+
+The connector settles ILP payment claims on these chains. Changes take effect
+on the next 'townhouse hs down && townhouse hs up'.
+
+Usage:
+  townhouse chains list [--json] [-c <path>]
+  townhouse chains add  --chain-type <evm|solana|mina> --chain-id <id> [fields] [-c <path>]
+  townhouse chains remove <chainId> [-c <path>]
+
+Fields by chain type:
+  evm:    --rpc-url <url> --registry <0x..> --token-address <0x..> --key-id <0x..>
+  solana: --rpc-url <url> --program-id <addr> --key-id <id> [--ws-url <url>] [--token-mint <addr>]
+  mina:   --graphql-url <url> --zkapp <addr> [--key-id <id>]`;
+function buildChainProviderFromFlags(f) {
+  const { chainType, chainId } = f;
+  if (chainType !== "evm" && chainType !== "solana" && chainType !== "mina") {
+    throw new Error("--chain-type must be one of: evm, solana, mina");
+  }
+  if (!chainId) throw new Error("--chain-id is required");
+  const require2 = (flag, val) => {
+    if (!val) throw new Error(`${flag} is required for ${chainType} chains`);
+    return val;
+  };
+  if (chainType === "evm") {
+    return {
+      chainType: "evm",
+      chainId,
+      rpcUrl: require2("--rpc-url", f.rpcUrl),
+      registryAddress: require2("--registry", f.registry),
+      tokenAddress: require2("--token-address", f.tokenAddress),
+      keyId: require2("--key-id", f.keyId)
+    };
+  }
+  if (chainType === "solana") {
+    return {
+      chainType: "solana",
+      chainId,
+      rpcUrl: require2("--rpc-url", f.rpcUrl),
+      ...f.wsUrl ? { wsUrl: f.wsUrl } : {},
+      programId: require2("--program-id", f.programId),
+      ...f.tokenMint ? { tokenMint: f.tokenMint } : {},
+      keyId: require2("--key-id", f.keyId)
+    };
+  }
+  return {
+    chainType: "mina",
+    chainId,
+    graphqlUrl: require2("--graphql-url", f.graphqlUrl),
+    zkAppAddress: require2("--zkapp", f.zkapp),
+    ...f.keyId ? { keyId: f.keyId } : {}
+  };
+}
+async function handleChains(action, chainIdArg, flags, configPath, jsonMode) {
+  if (!action) {
+    console.log(CHAINS_HELP);
+    throw new CliHelpRequested();
+  }
+  const config = loadConfig(configPath);
+  const providers = config.chainProviders ?? [];
+  switch (action) {
+    case "list": {
+      if (jsonMode) {
+        console.log(JSON.stringify(providers, null, 2));
+        return;
+      }
+      if (providers.length === 0) {
+        console.log(
+          "No settlement chains configured \u2014 the connector uses a built-in dev-Anvil EVM placeholder."
+        );
+        console.log(
+          "Add one with:  townhouse chains add --chain-type evm --chain-id evm:base:8453 ..."
+        );
+        return;
+      }
+      console.log("Configured settlement chains:");
+      for (const p of providers) {
+        console.log(`  ${p.chainType.padEnd(6)} ${p.chainId}`);
+      }
+      return;
+    }
+    case "add": {
+      let entry;
+      try {
+        entry = buildChainProviderFromFlags(flags);
+      } catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+        return;
+      }
+      const next = providers.filter((p) => p.chainId !== entry.chainId);
+      next.push(entry);
+      try {
+        saveConfig(configPath, { ...config, chainProviders: next });
+      } catch (err) {
+        console.error(
+          `Invalid chain config: ${err instanceof Error ? err.message : String(err)}`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      console.log(
+        `Added ${entry.chainType} settlement chain '${entry.chainId}'.`
+      );
+      console.log("Apply with:  townhouse hs down && townhouse hs up");
+      return;
+    }
+    case "remove": {
+      if (!chainIdArg) {
+        console.error("Usage: townhouse chains remove <chainId>");
+        process.exitCode = 1;
+        return;
+      }
+      const next = providers.filter((p) => p.chainId !== chainIdArg);
+      if (next.length === providers.length) {
+        console.error(
+          `No settlement chain with chainId '${chainIdArg}' found.`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      saveConfig(configPath, {
+        ...config,
+        chainProviders: next.length > 0 ? next : void 0
+      });
+      console.log(`Removed settlement chain '${chainIdArg}'.`);
+      console.log("Apply with:  townhouse hs down && townhouse hs up");
+      return;
+    }
+    default: {
+      const safe = action.replace(/[\x00-\x1f\x7f]/g, "");
+      console.error(`Unknown chains subcommand: ${safe}`);
+      console.log(CHAINS_HELP);
+      process.exitCode = 1;
+    }
+  }
+}
 async function main(argv, dockerInstance, browserOpener, hsOverrides, nodeCommandOverrides) {
   const { values, positionals } = parseArgs({
     args: argv,
@@ -3473,7 +3618,19 @@ async function main(argv, dockerInstance, browserOpener, hsOverrides, nodeComman
       // wallet show / wallet seed (epic-49, Phase 3)
       hex: { type: "boolean" },
       paths: { type: "boolean" },
-      confirm: { type: "boolean" }
+      confirm: { type: "boolean" },
+      // chains add (multi-chain settlement config)
+      "chain-type": { type: "string" },
+      "chain-id": { type: "string" },
+      "rpc-url": { type: "string" },
+      "ws-url": { type: "string" },
+      registry: { type: "string" },
+      "token-address": { type: "string" },
+      "token-mint": { type: "string" },
+      "program-id": { type: "string" },
+      "graphql-url": { type: "string" },
+      zkapp: { type: "string" },
+      "key-id": { type: "string" }
     },
     strict: false,
     allowPositionals: true
@@ -3708,6 +3865,32 @@ async function main(argv, dockerInstance, browserOpener, hsOverrides, nodeComman
       }
       break;
     }
+    case "chains": {
+      const configPath = values.config ?? DEFAULT_CONFIG_PATH;
+      const action = positionals[1];
+      const chainIdArg = positionals[2];
+      const flags = {
+        chainType: values["chain-type"],
+        chainId: values["chain-id"],
+        rpcUrl: values["rpc-url"],
+        wsUrl: values["ws-url"],
+        registry: values["registry"],
+        tokenAddress: values["token-address"],
+        tokenMint: values["token-mint"],
+        programId: values["program-id"],
+        graphqlUrl: values["graphql-url"],
+        zkapp: values["zkapp"],
+        keyId: values["key-id"]
+      };
+      await handleChains(
+        action,
+        chainIdArg,
+        flags,
+        configPath,
+        values.json === true
+      );
+      break;
+    }
     default: {
       const sanitized = command.replace(/[\x00-\x1f\x7f]/g, "");
       console.error(`Unknown command: ${sanitized}`);