arc402-cli 1.0.0-rc.1 → 1.0.0

package/src/commands/arena-handshake.ts

@@ -1,257 +0,0 @@
-import { Command } from "commander";
-import { ethers } from "ethers";
-import { loadConfig, getUsdcAddress } from "../config";
-import { requireSigner } from "../client";
-import { AGENT_REGISTRY_ABI } from "../abis";
-import { startSpinner } from "../ui/spinner";
-import { renderTree } from "../ui/tree";
-import { c } from "../ui/colors";
-
-const DEFAULT_REGISTRY_ADDRESS = "0xD5c2851B00090c92Ba7F4723FB548bb30C9B6865";
-
-async function pingHandshakeEndpoint(
-  agentAddress: string,
-  payload: Record<string, unknown>,
-  registryAddress: string,
-  provider: ethers.Provider
-): Promise<void> {
-  const registry = new ethers.Contract(registryAddress, AGENT_REGISTRY_ABI, provider);
-  const agentData = await registry.getAgent(agentAddress);
-  const endpoint = agentData.endpoint as string;
-  if (!endpoint) return;
-  await fetch(`${endpoint}/handshake`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload),
-  });
-}
-
-// ─── Handshake Contract ABI (from Handshake.sol) ─────────────────────────────
-
-const HANDSHAKE_ABI = [
-  "function sendHandshake(address to, uint8 hsType, string note) payable",
-  "function sendHandshakeWithToken(address to, uint8 hsType, string note, address token, uint256 tokenAmount)",
-  "function sendBatch(address[] recipients, uint8[] hsTypes, string[] notes)",
-  "function hasConnection(address from, address to) view returns (bool)",
-  "function isMutual(address a, address b) view returns (bool)",
-  "function getStats(address agent) view returns (uint256 sent, uint256 received, uint256 uniqueInbound)",
-  "function sentCount(address) view returns (uint256)",
-  "function receivedCount(address) view returns (uint256)",
-  "function uniqueSenders(address) view returns (uint256)",
-  "function totalHandshakes() view returns (uint256)",
-  "function allowedTokens(address) view returns (bool)",
-  "event HandshakeSent(uint256 indexed handshakeId, address indexed from, address indexed to, uint8 hsType, address token, uint256 amount, string note, uint256 timestamp)",
-  "event NewConnection(address indexed from, address indexed to, uint256 handshakeId)",
-];
-
-const POLICY_ENGINE_ABI = [
-  "function isContractWhitelisted(address wallet, address target) view returns (bool)",
-  "function whitelistContract(address wallet, address target)",
-];
-
-const HANDSHAKE_TYPES: Record<string, number> = {
-  respect: 0,
-  curiosity: 1,
-  endorsement: 2,
-  thanks: 3,
-  collaboration: 4,
-  challenge: 5,
-  referral: 6,
-  hello: 7,
-};
-
-// ─── Auto-Whitelist ──────────────────────────────────────────────────────────
-
-async function ensureWhitelisted(
-  signer: ethers.Signer,
-  provider: ethers.Provider,
-  walletAddress: string,
-  policyEngineAddress: string,
-  handshakeAddress: string
-): Promise<void> {
-  const pe = new ethers.Contract(policyEngineAddress, POLICY_ENGINE_ABI, provider);
-  const isWhitelisted = await pe.isContractWhitelisted(walletAddress, handshakeAddress);
-
-  if (!isWhitelisted) {
-    console.log("Handshake contract not yet whitelisted on your wallet.");
-    console.log("Whitelisting now (one-time setup)...");
-
-    const peSigner = new ethers.Contract(policyEngineAddress, POLICY_ENGINE_ABI, signer);
-    const tx = await peSigner.whitelistContract(walletAddress, handshakeAddress);
-    console.log(`  tx: ${tx.hash}`);
-    await tx.wait();
-    console.log("  ✓ Handshake contract whitelisted\n");
-  }
-}
-
-// ─── Commands ────────────────────────────────────────────────────────────────
-
-export function registerArenaHandshakeCommands(program: Command): void {
-  const hs = program
-    .command("shake")
-    .description("ARC Arena social handshake — send a typed trust signal to another agent.");
-
-  // ── send ──────────────────────────────────────────────────────────────────
-  hs.command("send <agentAddress>")
-    .description("Send a handshake to another agent.")
-    .option("--type <type>", "Handshake type: respect, curiosity, endorsement, thanks, collaboration, challenge, referral, hello", "hello")
-    .option("--note <note>", "Short message (max 280 chars)", "")
-    .option("--tip <amount>", "ETH tip to attach (e.g. 0.01)")
-    .option("--usdc <amount>", "USDC tip to attach (e.g. 5.00)")
-    .option("--json", "Output as JSON")
-    .action(async (agentAddress: string, opts) => {
-      const config = loadConfig();
-      const { signer, provider } = await requireSigner(config);
-      const myAddress = await signer.getAddress();
-
-      if (!config.handshakeAddress) {
-        console.error("handshakeAddress not configured. Run: arc402 config set handshakeAddress <address>");
-        process.exit(1);
-      }
-      if (!config.policyEngineAddress) {
-        console.error("policyEngineAddress not configured.");
-        process.exit(1);
-      }
-
-      // Auto-whitelist check
-      await ensureWhitelisted(signer, provider, myAddress, config.policyEngineAddress, config.handshakeAddress);
-
-      const hsType = HANDSHAKE_TYPES[opts.type.toLowerCase()];
-      if (hsType === undefined) {
-        console.error(`Unknown handshake type: ${opts.type}`);
-        console.error(`Valid types: ${Object.keys(HANDSHAKE_TYPES).join(", ")}`);
-        process.exit(1);
-      }
-
-      const handshake = new ethers.Contract(config.handshakeAddress, HANDSHAKE_ABI, signer);
-
-      const hsSpinner = startSpinner(`Sending ${opts.type} handshake...`);
-      let tx;
-      if (opts.usdc) {
-        // USDC handshake
-        const usdcAddress = getUsdcAddress(config);
-        const amount = ethers.parseUnits(opts.usdc, 6);
-        tx = await handshake.sendHandshakeWithToken(agentAddress, hsType, opts.note, usdcAddress, amount);
-      } else {
-        // ETH handshake (with optional tip)
-        const value = opts.tip ? ethers.parseEther(opts.tip) : 0n;
-        tx = await handshake.sendHandshake(agentAddress, hsType, opts.note, { value });
-      }
-      hsSpinner.succeed("Handshake sent");
-
-      // Notify recipient's HTTP endpoint (non-blocking)
-      const registryAddress = config.agentRegistryV2Address ?? config.agentRegistryAddress ?? DEFAULT_REGISTRY_ADDRESS;
-      try {
-        await pingHandshakeEndpoint(
-          agentAddress,
-          { from: myAddress, type: opts.type, note: opts.note, txHash: tx.hash },
-          registryAddress,
-          provider
-        );
-      } catch (err) {
-        console.warn(`Warning: could not notify recipient endpoint: ${err instanceof Error ? err.message : String(err)}`);
-      }
-
-      if (opts.json) {
-        console.log(JSON.stringify({ tx: tx.hash, from: myAddress, to: agentAddress, type: opts.type, note: opts.note }));
-      } else {
-        const treeItems = [
-          { label: "From", value: myAddress },
-          { label: "To", value: agentAddress },
-          { label: "Type", value: opts.type },
-          ...(opts.note ? [{ label: "Note", value: opts.note as string }] : []),
-          ...(opts.tip ? [{ label: "Tip", value: `${opts.tip as string} ETH` }] : []),
-          ...(opts.usdc ? [{ label: "Tip", value: `${opts.usdc as string} USDC` }] : []),
-          { label: "Tx", value: tx.hash as string, last: true },
-        ];
-        renderTree(treeItems);
-      }
-    });
-
-  // ── batch ─────────────────────────────────────────────────────────────────
-  hs.command("batch")
-    .description("Send handshakes to multiple agents at once (onboarding ritual).")
-    .argument("<agents...>", "Agent addresses to handshake (up to 10)")
-    .option("--type <type>", "Handshake type for all", "hello")
-    .option("--note <note>", "Note for all", "")
-    .action(async (agents: string[], opts) => {
-      const config = loadConfig();
-      const { signer, provider } = await requireSigner(config);
-      const myAddress = await signer.getAddress();
-
-      if (!config.handshakeAddress || !config.policyEngineAddress) {
-        console.error("handshakeAddress or policyEngineAddress not configured.");
-        process.exit(1);
-      }
-
-      await ensureWhitelisted(signer, provider, myAddress, config.policyEngineAddress, config.handshakeAddress);
-
-      const hsType = HANDSHAKE_TYPES[opts.type.toLowerCase()];
-      if (hsType === undefined) {
-        console.error(`Unknown type: ${opts.type}. Valid: ${Object.keys(HANDSHAKE_TYPES).join(", ")}`);
-        process.exit(1);
-      }
-
-      if (agents.length > 10) {
-        console.error("Max 10 agents per batch.");
-        process.exit(1);
-      }
-
-      const handshake = new ethers.Contract(config.handshakeAddress, HANDSHAKE_ABI, signer);
-      const types = agents.map(() => hsType);
-      const notes = agents.map(() => opts.note);
-
-      const tx = await handshake.sendBatch(agents, types, notes);
-      console.log(`✓ Batch handshake sent to ${agents.length} agents`);
-      agents.forEach(a => console.log(`  → ${a}`));
-      console.log(`  tx: ${tx.hash}`);
-    });
-
-  // ── stats ─────────────────────────────────────────────────────────────────
-  hs.command("stats [address]")
-    .description("View handshake stats for an agent.")
-    .action(async (address?: string) => {
-      const config = loadConfig();
-      const { signer, provider } = await requireSigner(config);
-      const target = address || await signer.getAddress();
-
-      if (!config.handshakeAddress) {
-        console.error("handshakeAddress not configured.");
-        process.exit(1);
-      }
-
-      const handshake = new ethers.Contract(config.handshakeAddress, HANDSHAKE_ABI, provider);
-      const [sent, received, unique] = await handshake.getStats(target);
-      const total = await handshake.totalHandshakes();
-
-      console.log(`Handshake Stats: ${target}`);
-      console.log(`  Sent:            ${sent}`);
-      console.log(`  Received:        ${received}`);
-      console.log(`  Unique senders:  ${unique}`);
-      console.log(`  Network total:   ${total}`);
-    });
-
-  // ── check ─────────────────────────────────────────────────────────────────
-  hs.command("check <agentAddress>")
-    .description("Check if a connection or mutual handshake exists with an agent.")
-    .action(async (agentAddress: string) => {
-      const config = loadConfig();
-      const { signer, provider } = await requireSigner(config);
-      const myAddress = await signer.getAddress();
-
-      if (!config.handshakeAddress) {
-        console.error("handshakeAddress not configured.");
-        process.exit(1);
-      }
-
-      const handshake = new ethers.Contract(config.handshakeAddress, HANDSHAKE_ABI, provider);
-      const iSent = await handshake.hasConnection(myAddress, agentAddress);
-      const theySent = await handshake.hasConnection(agentAddress, myAddress);
-      const mutual = await handshake.isMutual(myAddress, agentAddress);
-
-      console.log(`Connection: ${myAddress} ↔ ${agentAddress}`);
-      console.log(`  You → them: ${iSent ? "✓ handshaked" : "✗ no handshake"}`);
-      console.log(`  Them → you: ${theySent ? "✓ handshaked" : "✗ no handshake"}`);
-      console.log(`  Mutual:     ${mutual ? "✓ yes" : "✗ no"}`);
-    });
-}

package/src/commands/arena.ts

@@ -1,122 +0,0 @@
-import { Command } from "commander";
-import chalk from "chalk";
-import { runFeed, FeedOptions } from "./feed";
-import { c } from "../ui/colors";
-
-const SUBGRAPH_URL = "https://api.studio.thegraph.com/query/1744310/arc-402/v0.2.0";
-
-async function gql(query: string): Promise<Record<string, unknown>> {
-  const res = await fetch(SUBGRAPH_URL, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ query }),
-  });
-  if (!res.ok) throw new Error(`Subgraph HTTP ${res.status}`);
-  const json = (await res.json()) as { data?: Record<string, unknown>; errors?: unknown[] };
-  if (json.errors?.length) throw new Error(`Subgraph error: ${JSON.stringify(json.errors[0])}`);
-  return json.data ?? {};
-}
-
-export function registerArenaCommands(program: Command): void {
-  const arena = program.command("arena").description("Arena network commands");
-
-  // ─── arena stats ───────────────────────────────────────────────────────────
-
-  arena
-    .command("stats")
-    .description("Show Arena network statistics")
-    .option("--json", "Output as JSON")
-    .action(async (opts) => {
-      try {
-        const data = await gql(`{
-          protocolStats(id: "global") {
-            totalAgents
-            totalWallets
-            totalAgreements
-            totalHandshakes
-            totalConnections
-            totalVouches
-            totalCapabilityClaims
-          }
-        }`);
-
-        const stats = data["protocolStats"] as Record<string, unknown> | null;
-        if (!stats) {
-          const msg = "No stats available — subgraph may still be syncing.";
-          if (opts.json) {
-            console.log(JSON.stringify({ error: msg }));
-          } else {
-            console.error(' ' + c.warning + c.white(` ${msg}`));
-          }
-          process.exit(1);
-        }
-
-        // Try to count active agreements separately — non-fatal if it fails
-        let activeAgreements = 0;
-        try {
-          const agData = await gql(`{
-            proposals: agreements(where: { state: 0 }, first: 1000) { id }
-            accepted: agreements(where: { state: 1 }, first: 1000) { id }
-          }`);
-          activeAgreements =
-            ((agData["proposals"] as unknown[]) ?? []).length +
-            ((agData["accepted"] as unknown[]) ?? []).length;
-        } catch {
-          // ignore — active count just stays 0
-        }
-
-        if (opts.json) {
-          console.log(JSON.stringify({ ...stats, activeAgreements }, null, 2));
-          return;
-        }
-
-        const pad = (v: unknown) => String(v ?? 0).padStart(6);
-        console.log(chalk.bold("╔══════════════════════════════════════╗"));
-        console.log(chalk.bold("║         ARC Arena — Network Stats    ║"));
-        console.log(chalk.bold("╚══════════════════════════════════════╝"));
-        console.log();
-        console.log(`  Agents        ${pad(stats["totalAgents"])}  registered`);
-        console.log(`  Wallets        ${pad(stats["totalWallets"])}  deployed`);
-        console.log(
-          `  Agreements     ${pad(stats["totalAgreements"])}  total  (${activeAgreements} active)`,
-        );
-        console.log(`  Handshakes     ${pad(stats["totalHandshakes"])}  sent`);
-        console.log(`  Connections    ${pad(stats["totalConnections"])}  unique pairs`);
-        console.log(`  Vouches        ${pad(stats["totalVouches"])}  active`);
-        console.log(`  Capabilities   ${pad(stats["totalCapabilityClaims"])}  claimed`);
-        console.log();
-        console.log(chalk.dim("  Subgraph: v0.2.0 · synced"));
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if (opts.json) {
-          console.log(JSON.stringify({ error: "Subgraph unavailable", details: msg }));
-        } else {
-          console.error(' ' + c.failure + c.white(` Subgraph unavailable: ${msg}`));
-        }
-        process.exit(1);
-      }
-    });
-
-  // ─── arena feed (alias) ─────────────────────────────────────────────────────
-
-  arena
-    .command("feed")
-    .description("Live terminal feed of recent Arena events (alias for arc402 feed)")
-    .option("--limit <n>", "Number of events to show", "20")
-    .option("--live", "Poll every 30s for new events")
-    .option("--type <type>", "Filter by event type: handshake|hire|fulfill|vouch")
-    .option("--json", "Output as JSON")
-    .action(async (opts) => {
-      try {
-        await runFeed(opts as FeedOptions);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        if ((opts as FeedOptions).json) {
-          console.log(JSON.stringify({ error: "Subgraph unavailable", details: msg }));
-        } else {
-          console.error(' ' + c.failure + c.white(` Subgraph unavailable: ${msg}`));
-        }
-        process.exit(1);
-      }
-    });
-}

package/src/commands/cancel.ts

@@ -1,35 +0,0 @@
-import { Command } from "commander";
-import { ServiceAgreementClient } from "@arc402/sdk";
-import { loadConfig } from "../config";
-import { requireSigner } from "../client";
-import { printSenderInfo, executeContractWriteViaWallet } from "../wallet-router";
-import { SERVICE_AGREEMENT_ABI } from "../abis";
-import { c } from "../ui/colors";
-import { startSpinner } from "../ui/spinner";
-
-export function registerCancelCommand(program: Command): void {
-  program.command("cancel <id>").description("Cancel a proposed agreement; use --expired for post-deadline recovery paths").option("--expired", "Call expiredCancel()", false).action(async (id, opts) => {
-    const config = loadConfig();
-    if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-    const { signer } = await requireSigner(config);
-    printSenderInfo(config);
-    const spinner = startSpinner("Submitting transaction...");
-    try {
-      if (config.walletContractAddress) {
-        const fn = opts.expired ? "expiredCancel" : "cancel";
-        await executeContractWriteViaWallet(
-          config.walletContractAddress, signer, config.serviceAgreementAddress,
-          SERVICE_AGREEMENT_ABI, fn, [BigInt(id)],
-        );
-      } else {
-        const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
-        if (opts.expired) await client.expiredCancel(BigInt(id)); else await client.cancel(BigInt(id));
-      }
-      spinner.succeed();
-    } catch (err) {
-      spinner.fail();
-      throw err;
-    }
-    console.log(' ' + c.success + c.white(` Cancelled — agreement #${id}`));
-  });
-}

package/src/commands/channel.ts

@@ -1,218 +0,0 @@
-import { Command } from "commander";
-import { loadConfig } from "../config";
-import { requireSigner, getClient } from "../client";
-import { ChannelClient } from "@arc402/sdk";
-import type { ChannelState } from "@arc402/sdk";
-import * as fs from "fs";
-import * as path from "path";
-import * as os from "os";
-import { c } from '../ui/colors';
-import { startSpinner } from '../ui/spinner';
-import { renderTree } from '../ui/tree';
-import { formatAddress } from '../ui/format';
-
-const CHANNEL_STATES_DIR = path.join(os.homedir(), ".arc402", "channel-states");
-
-function loadStateFile(path: string): ChannelState {
-  const raw = fs.readFileSync(path, "utf-8");
-  const obj = JSON.parse(raw);
-  return {
-    ...obj,
-    cumulativePayment: BigInt(obj.cumulativePayment),
-  } as ChannelState;
-}
-
-export function registerChannelCommands(program: Command): void {
-  const channel = program.command("channel").description("Session channel management — open, close, challenge, reclaim");
-
-  channel.command("open <provider>")
-    .description("Open a session channel with a provider")
-    .requiredOption("--token <address>", "Token address (0x0 for ETH)")
-    .requiredOption("--max <amount>", "Max deposit amount in wei")
-    .requiredOption("--rate <amount>", "Expected rate per call in wei (informational)")
-    .requiredOption("--deadline <timestamp>", "Channel expiry unix timestamp")
-    .option("--json", "JSON output")
-    .action(async (provider, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer } = await requireSigner(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, signer);
-      const spinner = startSpinner('Opening session channel…');
-      const result = await client.openSessionChannel(
-        provider,
-        opts.token,
-        BigInt(opts.max),
-        BigInt(opts.rate),
-        Number(opts.deadline)
-      );
-      if (opts.json || program.opts().json) {
-        spinner.stop();
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        spinner.succeed(' Opened — channel ' + result.channelId);
-        renderTree([
-          { label: 'Channel', value: result.channelId },
-          { label: 'Tx', value: result.txHash, last: true },
-        ]);
-      }
-    });
-
-  channel.command("status <channelId>")
-    .description("Get channel status")
-    .option("--json", "JSON output")
-    .action(async (channelId, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { provider } = await getClient(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, provider);
-      const ch = await client.getChannelStatus(channelId);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(ch, (_k, v) => typeof v === "bigint" ? v.toString() : v, 2));
-      } else {
-        console.log('\n ' + c.mark + c.white(` Channel ${channelId}`));
-        renderTree([
-          { label: 'Status', value: ch.status },
-          { label: 'Client', value: formatAddress(ch.client) },
-          { label: 'Provider', value: formatAddress(ch.provider) },
-          { label: 'Deposit', value: ch.depositAmount.toString() },
-          { label: 'Settled', value: ch.settledAmount.toString() },
-          { label: 'Seq', value: ch.lastSequenceNumber.toString(), last: true },
-        ]);
-      }
-    });
-
-  channel.command("list <wallet>")
-    .description("List open channels for a wallet (client or provider)")
-    .option("--json", "JSON output")
-    .action(async (wallet, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { provider } = await getClient(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, provider);
-      const channels = await client.getOpenChannels(wallet);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(channels, (_k, v) => typeof v === "bigint" ? v.toString() : v, 2));
-      } else {
-        if (channels.length === 0) {
-          console.log("no open channels");
-        } else {
-          for (const ch of channels) {
-            console.log(`  ${ch.status}  deposit=${ch.depositAmount}  seq=${ch.lastSequenceNumber}  deadline=${ch.deadline}`);
-          }
-        }
-      }
-    });
-
-  channel.command("close <channelId>")
-    .description("Close a channel cooperatively with signed final state")
-    .requiredOption("--state <path>", "Path to signed state JSON file")
-    .option("--json", "JSON output")
-    .action(async (channelId, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer } = await requireSigner(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, signer);
-      const state = loadStateFile(opts.state);
-      const result = await client.closeChannel(channelId, state);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(' ' + c.success + c.white(` Close submitted — ${result.txHash}`));
-        console.log(' ' + c.dim('Challenge window open (24h)'));
-      }
-    });
-
-  channel.command("challenge <channelId>")
-    .description("Challenge a stale close with a higher sequence state")
-    .requiredOption("--state <path>", "Path to signed state JSON file with higher sequenceNumber")
-    .option("--json", "JSON output")
-    .action(async (channelId, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer } = await requireSigner(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, signer);
-      const state = loadStateFile(opts.state);
-      const result = await client.challengeChannel(channelId, state);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(' ' + c.success + c.white(` Challenge submitted — ${result.txHash}`));
-      }
-    });
-
-  channel.command("finalise <channelId>")
-    .description("Finalise a close after the challenge window expires")
-    .option("--json", "JSON output")
-    .action(async (channelId, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer } = await requireSigner(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, signer);
-      const result = await client.finaliseChallenge(channelId);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(' ' + c.success + c.white(` Finalised — ${result.txHash}`));
-      }
-    });
-
-  channel.command("reclaim <channelId>")
-    .description("Client: reclaim deposit from expired channel")
-    .option("--json", "JSON output")
-    .action(async (channelId, opts) => {
-      const config = loadConfig();
-      if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
-      const { signer } = await requireSigner(config);
-      const client = new ChannelClient(config.serviceAgreementAddress, signer);
-      const result = await client.reclaimExpiredChannel(channelId);
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(' ' + c.success + c.white(` Reclaimed — ${result.txHash}`));
-      }
-    });
-
-  channel.command("store-state <channelId> <statePath>")
-    .description(
-      "Save a signed channel state to local storage (~/.arc402/channel-states/<channelId>.json) " +
-      "for the `arc402 daemon channel-watch` to use when auto-challenging stale closes."
-    )
-    .option("--json", "JSON output")
-    .action((channelId, statePath, opts) => {
-      let raw: string;
-      try {
-        raw = fs.readFileSync(statePath, "utf-8");
-      } catch (err) {
-        console.error(`Cannot read state file: ${statePath}\n${err}`);
-        process.exit(1);
-      }
-
-      let state: Record<string, unknown>;
-      try {
-        state = JSON.parse(raw) as Record<string, unknown>;
-      } catch {
-        console.error("State file is not valid JSON.");
-        process.exit(1);
-      }
-
-      const required = ["sequenceNumber", "cumulativePayment", "callCount", "token", "timestamp", "clientSig", "providerSig"];
-      for (const field of required) {
-        if (!(field in state)) {
-          console.error(`State file missing required field: ${field}`);
-          process.exit(1);
-        }
-      }
-
-      fs.mkdirSync(CHANNEL_STATES_DIR, { recursive: true, mode: 0o700 });
-      const dest = path.join(CHANNEL_STATES_DIR, `${channelId}.json`);
-      const stored = { ...state, channelId };
-      fs.writeFileSync(dest, JSON.stringify(stored, null, 2), { mode: 0o600 });
-
-      if (opts.json || program.opts().json) {
-        console.log(JSON.stringify({ stored: true, channelId, path: dest }));
-      } else {
-        console.log(' ' + c.success + c.white(` State stored — ${dest}`));
-        console.log(' ' + c.dim(`seq: ${state.sequenceNumber}`));
-      }
-    });
-}