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

package/bin/clanker.mjs

@@ -23,15 +23,7 @@ import {
   readBot,
   resolvePreferredOperator,
 } from "../lib/identity-query.mjs";
-import { resolveForRead, resolveOperatorKey, resolveReadIdentity } from "../lib/resolve.mjs";
-import { runSetup } from "../lib/setup.mjs";
-import { runDoctor } from "../lib/doctor.mjs";
-import {
-  c,
-  confirmPlan,
-  exitCliError,
-  nextHint,
-} from "../lib/ui.mjs";
+import { resolveForRead, resolveOperatorKey } from "../lib/resolve.mjs";
 
 function resolveFoundryBinary(name) {
   const home = os.homedir();
@@ -152,18 +144,16 @@ function usage() {
   console.log(`clanker - clanker-chain helper CLI
 
 Usage:
-  clanker setup [--preset sepolia|local] [--operator <label>] [--address 0x…] [--key-file path] [--force]
-  clanker doctor [--json]
   clanker init --preset sepolia|local [--force]
-  clanker whoami [--json] [--operator <label>] [--address 0x…] [--with-bots]
-  clanker operator mint <label> [--json] [--yes]
-  clanker operator transfer propose <label> <newOwner> [--yes]
-  clanker operator transfer accept <label> [--yes]
-  clanker bot mint <label> [operator] [--json] [--yes]
+  clanker whoami [--json] [--operator <label>] [--address 0x…]
+  clanker operator mint <label> [--json]
+  clanker operator transfer propose <label> <newOwner>
+  clanker operator transfer accept <label>
+  clanker bot mint <label> [operator] [--json]
   clanker bots [--json] [--operator <label>] [--address 0x…]
   clanker bot status <label> [--json]
-  clanker bot revoke <label> [--json] [--yes]
-  clanker bot rotate <label> <newKeyAddress> [--json] [--yes]
+  clanker bot revoke <label> [--json]
+  clanker bot rotate <label> <newKeyAddress> [--json]
   clanker init-openclaw
   clanker chain up|deploy|mint-operator|mint-bot|rotate-bot-key|revoke-bot ...
   clanker check mqtt <bot_id> <operator_id>
@@ -171,12 +161,12 @@ Usage:
 
 Profile:
   ~/.clanker/config.json     network preset (registry, RPC, broker URLs)
-  ~/.clanker/operator.json   label + owner + optional key pointer (never raw hex)
+  ~/.clanker/operator.json   label + owner + key pointer (never raw hex)
   ~/.clanker/keys/           bot keys (also written to ~/.openclaw/keys/)
 
-Humans: \`clanker setup\` then \`clanker doctor\` / \`whoami\`.
-Mutates print a plan and confirm unless --yes or --json.
-whoami is fast by default; pass --with-bots to enrich child bots (or use \`clanker bots\`).
+Key resolution (mutating commands):
+  --key > --key-file > OPERATOR_PRIVATE_KEY > profile keyFile > profile env
+  Anvil account #0 is allowed only on localhost RPC.
 
 See docs/operator-cli.md.
 `);
@@ -223,20 +213,18 @@ async function cmdWhoami(argv) {
   let address;
   let source;
   let network;
-  try {
-    const resolved = resolveReadIdentity(argv);
+  const addressFlag = flagValue(argv, "--address");
+  if (addressFlag) {
+    network = resolveForRead(argv);
+    address = getAddress(addressFlag);
+    source = "--address";
+  } else {
+    const resolved = resolveOperatorKey(argv);
     address = resolved.address;
     source = resolved.source;
     network = resolved.network;
-  } catch (err) {
-    exitCliError({
-      error: err.message,
-      because: "whoami needs an owner address from --address, a key, or operator.json",
-      try: ["clanker setup", "clanker doctor", "clanker whoami --address 0x…"],
-    });
   }
 
-  const withBots = hasFlag(argv, "--with-bots");
   const pub = await publicClientFromRpc(network.rpc);
   const preferred =
     flagValue(argv, "--operator") ?? loadOperator(network.home)?.label ?? null;
@@ -249,14 +237,9 @@ async function cmdWhoami(argv) {
       owner: getAddress(address),
     });
     if (resolved.error) {
-      exitCliError({
-        error: resolved.error,
-        because: "preferred operator label did not match this owner on-chain",
-        try: [
-          "clanker whoami --address 0x…",
-          "clanker setup --force   # fix label/owner",
-        ],
-      });
+      const err = new Error(resolved.error);
+      err.candidates = resolved.candidates;
+      throw err;
     }
     selected = [resolved.operator];
   } else {
@@ -267,14 +250,12 @@ async function cmdWhoami(argv) {
     });
   }
 
-  if (withBots) {
-    for (const op of selected) {
-      op.bots = await findBotsByOperator(pub, {
-        registry: network.registry,
-        operatorId: op.id,
-        fromBlock: network.fromBlock,
-      });
-    }
+  for (const op of selected) {
+    op.bots = await findBotsByOperator(pub, {
+      registry: network.registry,
+      operatorId: op.id,
+      fromBlock: network.fromBlock,
+    });
   }
 
   const data = {
@@ -290,38 +271,31 @@ async function cmdWhoami(argv) {
       active: o.active,
       registeredAt: o.registeredAt.toString(),
       revokedAt: o.revokedAt.toString(),
-      bots: withBots
-        ? (o.bots ?? []).map((b) => ({
-            label: b.label,
-            botKey: b.botKey,
-            active: b.active,
-            registeredAt: b.registeredAt.toString(),
-            revokedAt: b.revokedAt.toString(),
-          }))
-        : [],
+      bots: (o.bots ?? []).map((b) => ({
+        label: b.label,
+        botKey: b.botKey,
+        active: b.active,
+        registeredAt: b.registeredAt.toString(),
+        revokedAt: b.revokedAt.toString(),
+      })),
     })),
   };
 
   if (hasFlag(argv, "--json")) printJson(data);
-  else {
-    printHumanWhoami(data);
-    if (!withBots && data.operators.length) {
-      console.log(c.dim("(bots omitted — pass --with-bots or run clanker bots)"));
-    }
-    nextHint(["clanker bots", "clanker doctor"]);
-  }
+  else printHumanWhoami(data);
 }
 
 async function cmdBots(argv) {
   let address;
   let network;
-  try {
-    const resolved = resolveReadIdentity(argv);
+  const addressFlag = flagValue(argv, "--address");
+  if (addressFlag) {
+    network = resolveForRead(argv);
+    address = getAddress(addressFlag);
+  } else {
+    const resolved = resolveOperatorKey(argv);
     address = resolved.address;
     network = resolved.network;
-  } catch (err) {
-    console.error(err.message);
-    process.exit(1);
   }
   const { label, pub } = await resolveOperatorLabel(argv, address, network);
   const bots = await findBotsByOperator(pub, {
@@ -383,27 +357,6 @@ async function main() {
 
   const repoRoot = findRepoRoot();
 
-  if (cmd === "setup") {
-    try {
-      await runSetup(rest);
-    } catch (err) {
-      exitCliError({
-        error: err.message,
-        because: "setup could not write a valid local profile",
-        try: [
-          "clanker setup --preset sepolia --operator org.you --address 0x… --yes --force",
-          "clanker doctor",
-        ],
-      });
-    }
-    return;
-  }
-
-  if (cmd === "doctor") {
-    const { exitCode } = await runDoctor(rest);
-    process.exit(exitCode);
-  }
-
   if (cmd === "init") {
     const preset = flagValue(rest, "--preset") ?? rest.find((a) => !a.startsWith("--"));
     if (!preset || preset === "init") {
@@ -450,38 +403,13 @@ async function main() {
         console.error("Usage: clanker operator mint <label>");
         process.exit(1);
       }
-      let planRows;
-      try {
-        const preview = resolveOperatorKey(flags);
-        planRows = [
-          ["action", "registerOperator"],
-          ["label", label],
-          ["owner", preview.address],
-          ["rpc", preview.network.rpc],
-          ["registry", preview.network.registry ?? "(none)"],
-          ["key", preview.source],
-        ];
-      } catch (err) {
-        exitCliError({
-          error: err.message,
-          because: "operator mint needs a signing key on this network",
-          try: [
-            "export OPERATOR_PRIVATE_KEY=0x…",
-            "clanker operator mint " + label + " --key-file ~/.clanker/op.key --yes",
-            "clanker doctor",
-          ],
-        });
-      }
-      const ok = await confirmPlan(flags, planRows, `Mint operator ${label}?`);
-      if (!ok) process.exit(0);
       const result = await chainMintOperator(label, flags);
       if (hasFlag(flags, "--json") || hasFlag(opArgv, "--json")) printJson(result);
       else {
-        console.log(c.green(`Minted operator ${label}`));
+        console.log(`Minted operator ${label}`);
         console.log(`owner: ${result.owner}`);
         console.log(`tx:    ${result.tx}`);
         console.log(`Wrote ~/.clanker/operator.json`);
-        nextHint([`clanker bot mint <bot_label>`, "clanker whoami"]);
       }
       return;
     }
@@ -493,23 +421,9 @@ async function main() {
           console.error("Usage: clanker operator transfer propose <label> <newOwner>");
           process.exit(1);
         }
-        const ok = await confirmPlan(
-          flags,
-          [
-            ["action", "proposeOperatorTransfer"],
-            ["label", label],
-            ["newOwner", getAddress(newOwner)],
-          ],
-          `Propose transfer of ${label}?`,
-        );
-        if (!ok) process.exit(0);
         const result = await chainProposeOperatorTransfer(label, getAddress(newOwner), flags);
         if (hasFlag(flags, "--json")) printJson(result);
-        else {
-          console.log(c.green(`Proposed transfer of ${label} → ${newOwner}`));
-          console.log(`tx: ${result.tx}`);
-          nextHint([`clanker operator transfer accept ${label}   # as new owner`]);
-        }
+        else console.log(`Proposed transfer of ${label} → ${newOwner}\ntx: ${result.tx}`);
         return;
       }
       if (action === "accept") {
@@ -517,23 +431,9 @@ async function main() {
           console.error("Usage: clanker operator transfer accept <label>");
           process.exit(1);
         }
-        const ok = await confirmPlan(
-          flags,
-          [
-            ["action", "acceptOperatorTransfer"],
-            ["label", label],
-          ],
-          `Accept transfer of ${label}?`,
-        );
-        if (!ok) process.exit(0);
         const result = await chainAcceptOperatorTransfer(label, flags);
         if (hasFlag(flags, "--json")) printJson(result);
-        else {
-          console.log(c.green(`Accepted transfer of ${label}`));
-          console.log(`owner: ${result.owner}`);
-          console.log(`tx: ${result.tx}`);
-          nextHint(["clanker whoami", "clanker bots"]);
-        }
+        else console.log(`Accepted transfer of ${label}\nowner: ${result.owner}\ntx: ${result.tx}`);
         return;
       }
       console.error("Usage: clanker operator transfer propose|accept ...");
@@ -573,45 +473,20 @@ async function main() {
       }
       let operatorLabel = operatorArg ?? flagValue(flags, "--operator") ?? null;
       if (!operatorLabel) {
-        try {
-          const { address, network } = resolveOperatorKey(flags);
-          const inferred = await resolveOperatorLabel(flags, address, network);
-          operatorLabel = inferred.label;
-        } catch (err) {
-          exitCliError({
-            error: err.message,
-            because: "bot mint needs an operator label or a resolvable signing key",
-            try: [
-              `clanker bot mint ${botLabel} <operator_label> --yes`,
-              "clanker setup",
-            ],
-          });
-        }
+        const { address, network } = resolveOperatorKey(flags);
+        const inferred = await resolveOperatorLabel(flags, address, network);
+        operatorLabel = inferred.label;
       }
-      const ok = await confirmPlan(
-        flags,
-        [
-          ["action", "registerBot"],
-          ["bot", botLabel],
-          ["operator", operatorLabel],
-        ],
-        `Mint bot ${botLabel} under ${operatorLabel}?`,
-      );
-      if (!ok) process.exit(0);
       const result = await chainMintBot(botLabel, operatorLabel, flags);
       if (hasFlag(flags, "--json")) printJson(result);
       else {
-        console.log(c.green(`Minted bot ${botLabel} under ${operatorLabel}`));
+        console.log(`Minted bot ${botLabel} under ${operatorLabel}`);
         console.log(`botKey:   ${result.bot_key}`);
         console.log(`key file: ${result.key_path}`);
         console.log(`also:     ${result.clanker_key_path}`);
         console.log(`tx:       ${result.tx}`);
         console.log("\nchannels.mqtt stub:");
         console.log(JSON.stringify(result.channels_mqtt, null, 2));
-        nextHint([
-          "Paste channels.mqtt into openclaw.json",
-          "openclaw plugins install @clanker-chain/mqtt-channel-plugin@…",
-        ]);
       }
       return;
     }
@@ -622,22 +497,9 @@ async function main() {
         console.error("Usage: clanker bot revoke <label>");
         process.exit(1);
       }
-      const ok = await confirmPlan(
-        flags,
-        [
-          ["action", "revokeBot"],
-          ["bot", botLabel],
-        ],
-        `Revoke bot ${botLabel}?`,
-      );
-      if (!ok) process.exit(0);
       const result = await chainRevokeBot(botLabel, flags);
       if (hasFlag(flags, "--json")) printJson(result);
-      else {
-        console.log(c.yellow(`Revoked ${botLabel}`));
-        console.log(`tx: ${result.tx}`);
-        nextHint(["clanker bots", "clanker bot status " + botLabel]);
-      }
+      else console.log(`Revoked ${botLabel}\ntx: ${result.tx}`);
       return;
     }
 
@@ -647,23 +509,9 @@ async function main() {
         console.error("Usage: clanker bot rotate <label> <newKeyAddress>");
         process.exit(1);
       }
-      const ok = await confirmPlan(
-        flags,
-        [
-          ["action", "rotateBotKey"],
-          ["bot", botLabel],
-          ["newKey", getAddress(newKey)],
-        ],
-        `Rotate key for ${botLabel}?`,
-      );
-      if (!ok) process.exit(0);
       const result = await chainRotateBotKey(botLabel, getAddress(newKey), flags);
       if (hasFlag(flags, "--json")) printJson(result);
-      else {
-        console.log(c.green(`Rotated ${botLabel} → ${newKey}`));
-        console.log(`tx: ${result.tx}`);
-        nextHint(["Update ~/.openclaw/keys/" + botLabel + ".key", "clanker bot status " + botLabel]);
-      }
+      else console.log(`Rotated ${botLabel} → ${newKey}\ntx: ${result.tx}`);
       return;
     }
 

package/lib/profile.mjs

@@ -17,14 +17,11 @@ export const ANVIL_DEFAULT_ADDRESS = "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
 export const SEPOLIA_REGISTRY = "0xD650467f9D7A20f37E55ec23Ca1c711598f97958";
 
 /**
- * Safe floor for Sepolia getLogs (before registry deploy). Use for full historical
- * scans via --from-block; default preset uses the faster public-RPC floor below.
+ * Safe floor for Sepolia getLogs (before registry deploy). Documented so scans
+ * stay cheap; bump only if you redeploy the registry earlier.
  */
 export const SEPOLIA_FROM_BLOCK = 35_000_000n;
 
-/** Default Sepolia fromBlock for public RPC (faster whoami/bots scans). */
-export const SEPOLIA_FAST_FROM_BLOCK = 46_000_000n;
-
 export const PRESETS = {
   local: {
     preset: "local",
@@ -40,7 +37,7 @@ export const PRESETS = {
     chainRpcUrl: "https://sepolia.base.org",
     brokerUrl: "mqtts://mqtt.clanker-chain.com:8883",
     mqttAuthServiceUrl: "https://mqtt-auth.clanker-chain.com",
-    fromBlock: SEPOLIA_FAST_FROM_BLOCK,
+    fromBlock: SEPOLIA_FROM_BLOCK,
   },
 };
 
@@ -66,7 +63,7 @@ export function openclawKeysDir() {
 
 /**
  * @param {string} presetName
- * @param {{ force?: boolean, registryAddress?: string|null, home?: string, fromBlock?: bigint|string|number }} [opts]
+ * @param {{ force?: boolean, registryAddress?: string|null, home?: string }} [opts]
  */
 export function initProfile(presetName, opts = {}) {
   const name = String(presetName || "").toLowerCase();
@@ -82,15 +79,13 @@ export function initProfile(presetName, opts = {}) {
   }
   mkdirSync(home, { recursive: true });
   const preset = PRESETS[name];
-  const fromBlock =
-    opts.fromBlock != null ? BigInt(opts.fromBlock) : preset.fromBlock;
   const config = {
     preset: preset.preset,
     registryAddress: opts.registryAddress ?? preset.registryAddress,
     chainRpcUrl: preset.chainRpcUrl,
     brokerUrl: preset.brokerUrl,
     mqttAuthServiceUrl: preset.mqttAuthServiceUrl,
-    fromBlock: fromBlock.toString(),
+    fromBlock: preset.fromBlock.toString(),
   };
   if (name === "local" && !config.registryAddress) {
     // Placeholder until chain deploy; operator must set after forge deploy.
@@ -125,9 +120,8 @@ export function loadOperator(home = clankerHome()) {
 }
 
 /**
- * Write operator profile (label + owner + optional key pointer). Never stores hex keys.
- * Omit `key` (or pass null) for a read-only profile; mint/revoke still need a pointer later.
- * @param {{ label: string, owner: string, key?: { type: 'env'|'keyFile', value?: string }|null }} op
+ * Write operator profile (label + owner + key pointer). Never stores hex keys.
+ * @param {{ label: string, owner: string, key?: { type: 'env'|'keyFile', value?: string } }} op
  * @param {string} [home]
  */
 export function writeOperator(op, home = clankerHome()) {
@@ -136,10 +130,8 @@ export function writeOperator(op, home = clankerHome()) {
   const out = {
     label: op.label,
     owner: op.owner,
+    key: op.key ?? { type: "env", value: "OPERATOR_PRIVATE_KEY" },
   };
-  if (op.key != null) {
-    out.key = op.key;
-  }
   writeFileSync(path, `${JSON.stringify(out, null, 2)}\n`, { mode: 0o600 });
   return { path, operator: out };
 }
@@ -190,7 +182,7 @@ export function resolveNetwork(argv = [], opts = {}) {
   }
 
   if (fromBlock == null) {
-    fromBlock = isLocalRpc(rpc) ? 0n : SEPOLIA_FAST_FROM_BLOCK;
+    fromBlock = isLocalRpc(rpc) ? 0n : SEPOLIA_FROM_BLOCK;
   }
 
   return {

package/lib/resolve.mjs

@@ -3,7 +3,6 @@
  */
 
 import { existsSync, readFileSync } from "node:fs";
-import { getAddress } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import {
   ANVIL_DEFAULT_PRIVATE_KEY,
@@ -175,63 +174,8 @@ export function resolveForRead(argv = [], opts = {}) {
   if (!network.registry || !/^0x[0-9a-fA-F]{40}$/.test(network.registry)) {
     throw new Error(
       "REGISTRY_ADDRESS or --registry is required (0x + 40 hex). " +
-        "Run `clanker init --preset sepolia` or `clanker setup`, or set registry after deploy.",
+        "Run `clanker init --preset sepolia` or set registry after `clanker chain deploy`.",
     );
   }
   return network;
 }
-
-/**
- * Resolve address for read-only commands.
- * Order: --address > signing key > operator.json owner > error (point at setup).
- *
- * @param {string[]} argv
- * @param {{ home?: string, env?: NodeJS.ProcessEnv }} [opts]
- * @returns {{ address: string, source: string, network: object }}
- */
-export function resolveReadIdentity(argv = [], opts = {}) {
-  const network = resolveForRead(argv, opts);
-  const home = opts.home ?? network.home;
-
-  let addressFlag = null;
-  for (let i = 0; i < argv.length; i += 1) {
-    if (argv[i] === "--address" && argv[i + 1] && !argv[i + 1].startsWith("--")) {
-      addressFlag = argv[++i];
-    }
-  }
-  if (addressFlag) {
-    return {
-      address: getAddress(addressFlag),
-      source: "--address",
-      network,
-    };
-  }
-
-  try {
-    const resolved = resolveOperatorKey(argv, { ...opts, home });
-    return {
-      address: resolved.address,
-      source: resolved.source,
-      network: resolved.network,
-    };
-  } catch (err) {
-    const msg = err?.message ?? String(err);
-    if (!/private key required|Anvil account #0|Key file not found|Profile keyFile/i.test(msg)) {
-      throw err;
-    }
-  }
-
-  const operator = loadOperator(home);
-  if (operator?.owner && /^0x[0-9a-fA-F]{40}$/.test(operator.owner)) {
-    return {
-      address: getAddress(operator.owner),
-      source: "profile owner",
-      network,
-    };
-  }
-
-  throw new Error(
-    "No operator identity configured. Run `clanker setup`, pass --address 0x…, " +
-      "or set a signing key (OPERATOR_PRIVATE_KEY / --key-file / operator.json key pointer).",
-  );
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clanker-chain/clanker-cli",
-  "version": "2026.9.7-4",
+  "version": "2026.9.7",
   "description": "CLI for wiring clanker-chain identity and MQTT into OpenClaw and other agentic stacks.",
   "type": "module",
   "bin": {
@@ -23,8 +23,6 @@
     "mint-bot:sepolia": "bash ./scripts/with-sepolia-env.sh mint-bot"
   },
   "dependencies": {
-    "@clack/prompts": "^1.8.0",
-    "picocolors": "^1.1.1",
     "viem": "^2.21.0"
   }
 }