@clanker-chain/clanker-cli 2026.9.7-4 → 2026.9.7

package/lib/setup.mjs

@@ -1,549 +0,0 @@
-/**
- * Interactive / flag-driven `clanker setup`.
- */
-
-import { stdin as input } from "node:process";
-import { existsSync } from "node:fs";
-import { getAddress } from "viem";
-import * as clack from "@clack/prompts";
-import {
-  ANVIL_DEFAULT_ADDRESS,
-  PRESETS,
-  SEPOLIA_FAST_FROM_BLOCK,
-  clankerHome,
-  configPath,
-  initProfile,
-  isLocalRpc,
-  operatorPath,
-  writeOperator,
-} from "./profile.mjs";
-import {
-  publicClientFromRpc,
-  readOperator,
-  resolvePreferredOperator,
-} from "./identity-query.mjs";
-import {
-  addressFromEnv,
-  addressFromKeyFile,
-  detectSetupHints,
-  formatSetupDetectTable,
-} from "./setup-detect.mjs";
-import { c, nextHint } from "./ui.mjs";
-
-/**
- * @param {string[]} argv
- */
-export function parseSetupFlags(argv) {
-  let preset = null;
-  let operator = null;
-  let address = null;
-  let keyFile = null;
-  let keyEnv = null;
-  let fromBlock = null;
-  let force = false;
-  let yes = false;
-  let skipKey = false;
-  let skipChainCheck = false;
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const a = argv[i];
-    if (a === "--preset" && argv[i + 1]) preset = argv[++i];
-    else if (a === "--operator" && argv[i + 1]) operator = argv[++i];
-    else if (a === "--address" && argv[i + 1]) address = argv[++i];
-    else if (a === "--key-file" && argv[i + 1]) keyFile = argv[++i];
-    else if (a === "--key-env" && argv[i + 1]) keyEnv = argv[++i];
-    else if (a === "--from-block" && argv[i + 1]) fromBlock = BigInt(argv[++i]);
-    else if (a === "--force") force = true;
-    else if (a === "--yes" || a === "-y") yes = true;
-    else if (a === "--skip-key") skipKey = true;
-    else if (a === "--skip-chain-check") skipChainCheck = true;
-  }
-
-  return {
-    preset,
-    operator,
-    address,
-    keyFile,
-    keyEnv,
-    fromBlock,
-    force,
-    yes,
-    skipKey,
-    skipChainCheck,
-  };
-}
-
-function cancelIf(value) {
-  if (clack.isCancel(value)) {
-    clack.cancel("Setup aborted.");
-    process.exit(0);
-  }
-  return value;
-}
-
-/**
- * Validate address + label against registry (and Anvil-on-public).
- * @param {{ rpc: string, registry: string, label: string, address: string, skipChainCheck?: boolean }} opts
- */
-export async function assertSetupIdentity(opts) {
-  const address = getAddress(opts.address);
-  const local = isLocalRpc(opts.rpc);
-
-  if (!local && address.toLowerCase() === ANVIL_DEFAULT_ADDRESS.toLowerCase()) {
-    throw new Error(
-      "Refusing Anvil account #0 address on a non-local RPC. Use your real operator owner address.",
-    );
-  }
-
-  if (opts.skipChainCheck) {
-    return { address, operator: null, skipped: true };
-  }
-
-  if (!opts.registry || !/^0x[0-9a-fA-F]{40}$/.test(opts.registry)) {
-    if (local) {
-      return { address, operator: null, skipped: true };
-    }
-    throw new Error("Registry address required for chain check on public RPC.");
-  }
-
-  const pub = await publicClientFromRpc(opts.rpc);
-  const op = await readOperator(pub, opts.registry, opts.label);
-
-  if (op.registeredAt === 0n) {
-    return { address, operator: op, skipped: false, unregistered: true };
-  }
-
-  const resolved = await resolvePreferredOperator(pub, {
-    registry: opts.registry,
-    label: opts.label,
-    owner: address,
-  });
-  if (resolved.error) {
-    throw new Error(resolved.error);
-  }
-  return { address, operator: resolved.operator, skipped: false, unregistered: false };
-}
-
-/**
- * @returns {{ type: 'env'|'keyFile', value: string }|null}
- */
-export function buildKeyPointer({ keyFile, keyEnv, skipKey, env = process.env }) {
-  if (skipKey) return null;
-  if (keyFile) {
-    if (!existsSync(keyFile)) throw new Error(`Key file not found: ${keyFile}`);
-    addressFromKeyFile(keyFile);
-    return { type: "keyFile", value: keyFile };
-  }
-  if (keyEnv) {
-    return { type: "env", value: keyEnv };
-  }
-  if (env.OPERATOR_PRIVATE_KEY) {
-    return { type: "env", value: "OPERATOR_PRIVATE_KEY" };
-  }
-  return null;
-}
-
-/**
- * Apply setup choices to disk.
- */
-export function applySetup(choices, opts = {}) {
-  const home = opts.home ?? clankerHome(opts.env);
-  const force = Boolean(choices.force);
-
-  if (existsSync(configPath(home)) && !force) {
-    throw new Error(
-      `Profile already exists at ${configPath(home)}. Pass --force to overwrite.`,
-    );
-  }
-  if (existsSync(operatorPath(home)) && !force) {
-    throw new Error(
-      `Operator profile already exists at ${operatorPath(home)}. Pass --force to overwrite.`,
-    );
-  }
-
-  const { path: configFile, config } = initProfile(choices.preset, {
-    force: true,
-    home,
-    registryAddress: choices.registryAddress,
-    fromBlock: choices.fromBlock,
-  });
-
-  const { path: opFile, operator } = writeOperator(
-    {
-      label: choices.label,
-      owner: getAddress(choices.address),
-      key: choices.key,
-    },
-    home,
-  );
-
-  return { configPath: configFile, config, operatorPath: opFile, operator };
-}
-
-/**
- * Non-interactive setup (agents / CI).
- */
-export async function runSetupNonInteractive(argv, opts = {}) {
-  const flags = parseSetupFlags(argv);
-  const env = opts.env ?? process.env;
-  const home = opts.home ?? clankerHome(env);
-
-  if (!flags.preset || !PRESETS[flags.preset]) {
-    throw new Error(
-      "Non-interactive setup requires --preset sepolia|local (stdin is not a TTY). " +
-        "Also pass --operator <label> and --address 0x…",
-    );
-  }
-  if (!flags.operator) {
-    throw new Error("Non-interactive setup requires --operator <label>");
-  }
-  if (!flags.address && !flags.keyFile && !env.OPERATOR_PRIVATE_KEY) {
-    throw new Error(
-      "Non-interactive setup requires --address 0x…, --key-file, or OPERATOR_PRIVATE_KEY",
-    );
-  }
-
-  let address = flags.address;
-  if (!address && flags.keyFile) address = addressFromKeyFile(flags.keyFile);
-  if (!address && env.OPERATOR_PRIVATE_KEY) address = addressFromEnv(env);
-
-  const preset = PRESETS[flags.preset];
-  let fromBlock = flags.fromBlock;
-  if (fromBlock == null && flags.preset === "sepolia") {
-    fromBlock = SEPOLIA_FAST_FROM_BLOCK;
-  }
-
-  const rpc = preset.chainRpcUrl;
-  const registry = preset.registryAddress;
-
-  await assertSetupIdentity({
-    rpc,
-    registry,
-    label: flags.operator,
-    address,
-    skipChainCheck: flags.skipChainCheck || opts.skipChainCheck || !registry,
-  });
-
-  const key = buildKeyPointer({
-    keyFile: flags.keyFile,
-    keyEnv: flags.keyEnv,
-    skipKey: flags.skipKey,
-    env,
-  });
-
-  if (flags.keyFile && flags.address) {
-    const fromKey = getAddress(addressFromKeyFile(flags.keyFile));
-    if (fromKey !== getAddress(flags.address)) {
-      throw new Error(
-        `Key file address ${fromKey} does not match --address ${getAddress(flags.address)}`,
-      );
-    }
-  }
-
-  return applySetup(
-    {
-      preset: flags.preset,
-      force: flags.force || flags.yes,
-      fromBlock,
-      registryAddress: registry,
-      label: flags.operator,
-      address,
-      key,
-    },
-    { home, env },
-  );
-}
-
-/**
- * Interactive wizard (Clack) when stdin is a TTY.
- */
-export async function runSetupInteractive(argv, opts = {}) {
-  const flags = parseSetupFlags(argv);
-  const env = opts.env ?? process.env;
-  const home = opts.home ?? clankerHome(env);
-  const hints = detectSetupHints({
-    home,
-    env,
-    castBin: opts.castBin,
-    spawn: opts.spawn,
-    openclawDir: opts.openclawDir,
-  });
-
-  clack.intro(c.bold("clanker setup"));
-  clack.log.step("Creates ~/.clanker/config.json (network) and operator.json (identity).");
-  clack.log.message(
-    c.dim("whoami works from owner without a key; mint/revoke need a key pointer later."),
-  );
-  clack.log.message(c.dim(`Profile: ${home}`));
-  console.log("");
-  console.log(c.dim(formatSetupDetectTable(hints)));
-  console.log("");
-
-  if ((hints.hasConfig || hints.hasOperator) && !flags.force) {
-    if (hints.hasConfig && !hints.hasOperator) {
-      const cont = cancelIf(
-        await clack.confirm({
-          message: "Network config exists; continue to create operator.json?",
-          initialValue: true,
-        }),
-      );
-      if (!cont) {
-        clack.cancel("Aborted.");
-        process.exit(0);
-      }
-      flags.force = true;
-    } else {
-      const overwrite = cancelIf(
-        await clack.confirm({
-          message: "Replace existing config.json / operator.json?",
-          initialValue: false,
-        }),
-      );
-      if (!overwrite) {
-        clack.cancel("Aborted. Pass --force to replace.");
-        process.exit(0);
-      }
-      flags.force = true;
-    }
-  }
-
-  let preset = flags.preset || hints.config?.preset || null;
-  if (!preset) {
-    preset = cancelIf(
-      await clack.select({
-        message: "Network",
-        options: [
-          { value: "sepolia", label: "sepolia", hint: "public closed-beta hub" },
-          { value: "local", label: "local", hint: "Anvil" },
-        ],
-        initialValue: "sepolia",
-      }),
-    );
-  }
-  preset = String(preset).toLowerCase();
-  if (!PRESETS[preset]) throw new Error(`Unknown preset "${preset}"`);
-
-  // Fast Sepolia default — no interactive fromBlock question
-  let fromBlock = flags.fromBlock;
-  if (fromBlock == null && preset === "sepolia") {
-    fromBlock = SEPOLIA_FAST_FROM_BLOCK;
-  }
-
-  let address = flags.address ?? null;
-  if (!address && flags.keyFile) {
-    address = addressFromKeyFile(flags.keyFile);
-    clack.log.info(`Address from --key-file: ${address}`);
-  }
-  if (!address && hints.envAddress) {
-    const useEnv = cancelIf(
-      await clack.confirm({
-        message: `Use OPERATOR_PRIVATE_KEY address (${hints.envAddress})?`,
-        initialValue: true,
-      }),
-    );
-    if (useEnv) address = hints.envAddress;
-  }
-  if (!address && hints.operator?.owner) {
-    const useOp = cancelIf(
-      await clack.confirm({
-        message: `Keep existing owner (${hints.operator.owner})?`,
-        initialValue: true,
-      }),
-    );
-    if (useOp) address = hints.operator.owner;
-  }
-  if (!address && hints.foundryAccounts.length) {
-    const options = [
-      ...hints.foundryAccounts.map((n) => ({
-        value: n,
-        label: n,
-        hint: "Foundry keystore — paste 0x next",
-      })),
-      { value: "__paste__", label: "Paste an address…", hint: "0x…" },
-    ];
-    const pick = cancelIf(
-      await clack.select({
-        message: "Operator owner source",
-        options,
-        initialValue: hints.foundryAccounts[0],
-      }),
-    );
-    if (pick === "__paste__") {
-      address = cancelIf(
-        await clack.text({
-          message: "Operator owner address",
-          placeholder: "0x…",
-          validate: (v) =>
-            /^0x[0-9a-fA-F]{40}$/.test(v || "") ? undefined : "Need 0x + 40 hex",
-        }),
-      );
-    } else {
-      address = cancelIf(
-        await clack.text({
-          message: `Paste 0x address for Foundry account "${pick}"`,
-          placeholder: "0x…",
-          validate: (v) =>
-            /^0x[0-9a-fA-F]{40}$/.test(v || "") ? undefined : "Need 0x + 40 hex",
-        }),
-      );
-    }
-  }
-  if (!address) {
-    address = cancelIf(
-      await clack.text({
-        message: "Operator owner address",
-        placeholder: "0x…",
-        validate: (v) =>
-          /^0x[0-9a-fA-F]{40}$/.test(v || "") ? undefined : "Need 0x + 40 hex",
-      }),
-    );
-  }
-  address = getAddress(address);
-
-  let label = flags.operator || hints.operator?.label || null;
-  if (!label) {
-    label = cancelIf(
-      await clack.text({
-        message: "Operator label",
-        placeholder: "org.openclaw.pat",
-        validate: (v) => (v && v.trim() ? undefined : "Label required"),
-      }),
-    );
-  }
-
-  const presetCfg = PRESETS[preset];
-  const spin = clack.spinner();
-  spin.start(`Looking up "${label}" on ${preset}`);
-  let check;
-  try {
-    check = await assertSetupIdentity({
-      rpc: presetCfg.chainRpcUrl,
-      registry: presetCfg.registryAddress,
-      label,
-      address,
-      skipChainCheck: flags.skipChainCheck || !presetCfg.registryAddress,
-    });
-    spin.stop(
-      check.unregistered
-        ? c.yellow(`"${label}" not registered yet — mint after setup`)
-        : check.skipped
-          ? "Chain check skipped"
-          : c.green(`"${label}" active and owned by this address`),
-    );
-  } catch (err) {
-    spin.stop(c.red("Chain check failed"));
-    throw err;
-  }
-
-  let keyFile = flags.keyFile;
-  let keyEnv = flags.keyEnv;
-  let skipKey = flags.skipKey;
-  if (!skipKey && !keyFile && !keyEnv) {
-    if (hints.hasOperatorPrivateKeyEnv) {
-      const use = cancelIf(
-        await clack.confirm({
-          message: "Store OPERATOR_PRIVATE_KEY pointer for signing?",
-          initialValue: true,
-        }),
-      );
-      if (use) keyEnv = "OPERATOR_PRIVATE_KEY";
-      else skipKey = true;
-    } else {
-      const path = cancelIf(
-        await clack.text({
-          message: "Operator key file path (Enter = read-only)",
-          placeholder: "~/.clanker/op.key",
-        }),
-      );
-      if (path && String(path).trim()) keyFile = String(path).trim();
-      else skipKey = true;
-    }
-  }
-
-  const key = buildKeyPointer({ keyFile, keyEnv, skipKey, env });
-  if (key?.type === "keyFile") {
-    const fromKey = getAddress(addressFromKeyFile(key.value));
-    if (fromKey !== address) {
-      throw new Error(`Key file address ${fromKey} does not match chosen owner ${address}`);
-    }
-  }
-
-  clack.note(
-    [
-      `network:   ${preset}`,
-      `fromBlock: ${fromBlock ?? presetCfg.fromBlock}`,
-      `label:     ${label}`,
-      `owner:     ${address}`,
-      `signing:   ${key ? `${key.type}=${key.value}` : "none (read-only)"}`,
-    ].join("\n"),
-    "Summary",
-  );
-
-  if (!flags.yes) {
-    const ok = cancelIf(
-      await clack.confirm({ message: "Write these files?", initialValue: true }),
-    );
-    if (!ok) {
-      clack.cancel("Aborted.");
-      process.exit(0);
-    }
-  }
-
-  const result = applySetup(
-    {
-      preset,
-      force: true,
-      fromBlock: fromBlock ?? undefined,
-      registryAddress: presetCfg.registryAddress,
-      label,
-      address,
-      key,
-    },
-    { home, env },
-  );
-
-  clack.outro(c.green(`Wrote ${result.configPath}\nWrote ${result.operatorPath}`));
-  if (!key) {
-    nextHint([
-      "clanker whoami",
-      "clanker setup --key-file ~/.clanker/op.key --force   # when you need mint",
-    ]);
-  } else {
-    nextHint(["clanker whoami", `clanker bot mint <label>`]);
-  }
-  return result;
-}
-
-/**
- * Entry: interactive if TTY (unless --yes with full flags), else non-interactive.
- */
-export async function runSetup(argv, opts = {}) {
-  const flags = parseSetupFlags(argv);
-  const isTTY = opts.isTTY ?? Boolean(input.isTTY);
-
-  if (
-    !isTTY ||
-    (flags.yes && flags.preset && flags.operator && (flags.address || flags.keyFile))
-  ) {
-    if (!isTTY && !(flags.preset && flags.operator)) {
-      return runSetupNonInteractive(argv, opts);
-    }
-    if (
-      flags.yes &&
-      flags.preset &&
-      flags.operator &&
-      (flags.address ||
-        flags.keyFile ||
-        opts.env?.OPERATOR_PRIVATE_KEY ||
-        process.env.OPERATOR_PRIVATE_KEY)
-    ) {
-      return runSetupNonInteractive(argv, opts);
-    }
-  }
-
-  if (!isTTY) {
-    return runSetupNonInteractive(argv, opts);
-  }
-
-  return runSetupInteractive(argv, opts);
-}

package/lib/ui.mjs

@@ -1,104 +0,0 @@
-/**
- * Shared human-path CLI UX (color, plans, next hints, structured errors).
- * Respects NO_COLOR / non-TTY via picocolors.
- */
-
-import pc from "picocolors";
-import * as clack from "@clack/prompts";
-
-export const c = {
-  dim: (s) => pc.dim(String(s)),
-  green: (s) => pc.green(String(s)),
-  yellow: (s) => pc.yellow(String(s)),
-  red: (s) => pc.red(String(s)),
-  bold: (s) => pc.bold(String(s)),
-  cyan: (s) => pc.cyan(String(s)),
-};
-
-/**
- * @param {string[]} argv
- * @param {{ stdinTTY?: boolean }} [opts]
- */
-export function isInteractive(argv = [], opts = {}) {
-  const tty = opts.stdinTTY ?? Boolean(process.stdin.isTTY);
-  if (!tty) return false;
-  if (argv.includes("--yes") || argv.includes("-y")) return false;
-  if (argv.includes("--json")) return false;
-  return true;
-}
-
-/**
- * @param {string|string[]} lines
- */
-export function nextHint(lines) {
-  const list = Array.isArray(lines) ? lines : [lines];
-  console.log("");
-  console.log(c.bold("Next:"));
-  for (const line of list) {
-    console.log(`  ${c.cyan(line)}`);
-  }
-}
-
-/**
- * Cargo-style human error.
- * @param {{ error: string, because?: string, try?: string[] }} opts
- * @returns {string}
- */
-export function formatCliError(opts) {
-  const lines = [c.red(`error: ${opts.error}`)];
-  if (opts.because) {
-    lines.push(c.dim(`because: ${opts.because}`));
-  }
-  if (opts.try?.length) {
-    lines.push(c.yellow("try:"));
-    for (const t of opts.try) {
-      lines.push(`  ${t}`);
-    }
-  }
-  return lines.join("\n");
-}
-
-/**
- * Print a plan table (key/value rows).
- * @param {[string, string][]} rows
- * @param {string} [title]
- */
-export function printPlan(rows, title = "Plan") {
-  console.log("");
-  console.log(c.bold(title));
-  const w = Math.min(18, Math.max(4, ...rows.map(([k]) => k.length)));
-  for (const [k, v] of rows) {
-    const pad = k + " ".repeat(Math.max(0, w - k.length));
-    console.log(`  ${c.dim(pad)}  ${v}`);
-  }
-}
-
-/**
- * Confirm a mutating plan. Skips when not interactive.
- * @param {string[]} argv
- * @param {[string, string][]} rows
- * @param {string} [message]
- * @returns {Promise<boolean>}
- */
-export async function confirmPlan(argv, rows, message = "Proceed?") {
-  printPlan(rows);
-  if (!isInteractive(argv)) return true;
-  const ok = await clack.confirm({
-    message,
-    initialValue: true,
-  });
-  if (clack.isCancel(ok) || ok === false) {
-    clack.cancel("Aborted.");
-    return false;
-  }
-  return true;
-}
-
-/**
- * Print structured error to stderr and exit.
- * @param {{ error: string, because?: string, try?: string[], status?: number }} opts
- */
-export function exitCliError(opts) {
-  console.error(formatCliError(opts));
-  process.exit(opts.status ?? 1);
-}