arc402-cli 0.9.19 → 0.10.0

package/src/commands/arena-handshake.ts

@@ -1,274 +0,0 @@
-import { Command } from "commander";
-import { ethers } from "ethers";
-import { loadConfig, getUsdcAddress } from "../config.js";
-import { requireSigner } from "../client.js";
-import { AGENT_REGISTRY_ABI } from "../abis.js";
-import { startSpinner } from "../ui/spinner.js";
-import { renderTree } from "../ui/tree.js";
-import { c } from "../ui/colors.js";
-
-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> {
-  // Check whitelist with RPC fallback (public RPCs often fail on eth_call)
-  const { callWithFallback } = await import("../ui/rpc-fallback.js");
-  const rpcUrl = (provider as ethers.JsonRpcProvider)._getConnection?.()?.url ?? "https://mainnet.base.org";
-  const isWhitelisted = await callWithFallback(rpcUrl, async (p) => {
-    const pe = new ethers.Contract(policyEngineAddress, POLICY_ENGINE_ABI, p);
-    return await pe.isContractWhitelisted(walletAddress, handshakeAddress) as boolean;
-  }).catch(() => true); // If all RPCs fail, assume whitelisted and let the tx itself fail if not
-
-  if (!isWhitelisted) {
-    console.log("Handshake contract not yet whitelisted on your wallet.");
-    console.log("Whitelisting now (one-time setup)...");
-    try {
-      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");
-    } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
-      if (msg.includes("already whitelisted")) {
-        console.log("  ✓ Handshake contract already whitelisted\n");
-      } else if (msg.includes("insufficient funds")) {
-        console.log("  ⚠ Machine key has no ETH for whitelisting. Use WalletConnect:");
-        console.log(`    arc402 wallet whitelist-contract ${handshakeAddress}\n`);
-        return;
-      } else {
-        throw e;
-      }
-    }
-  }
-}
-
-// ─── 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.js";
-import { c } from "../ui/colors.js";
-
-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/backup.ts

@@ -1,117 +0,0 @@
-import { Command } from "commander";
-import { execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { c } from "../ui/colors.js";
-
-const ARC402_DIR = path.join(os.homedir(), ".arc402");
-
-// Files/patterns to exclude from backup
-const EXCLUDE_PATTERNS = [
-  "daemon.db",
-  "daemon.log",
-  "daemon.pid",
-  "daemon.sock",
-  "repl_history",
-];
-
-function todayStr(): string {
-  const d = new Date();
-  const y = d.getFullYear();
-  const m = (d.getMonth() + 1).toString().padStart(2, "0");
-  const day = d.getDate().toString().padStart(2, "0");
-  return `${y}-${m}-${day}`;
-}
-
-export function registerBackupCommand(program: Command): void {
-  // ── backup ─────────────────────────────────────────────────────────────────
-  program
-    .command("backup")
-    .description("Backup ~/.arc402/ config, keys, and wallet storage to a tar.gz archive")
-    .option("--output <path>", "Output file path (default: arc402-backup-YYYY-MM-DD.tar.gz)")
-    .action((opts: { output?: string }) => {
-      if (!fs.existsSync(ARC402_DIR)) {
-        console.error(`  ${c.failure} No ~/.arc402/ directory found. Nothing to back up.`);
-        process.exit(1);
-      }
-
-      const outFile = opts.output ?? `arc402-backup-${todayStr()}.tar.gz`;
-      const absOut = path.isAbsolute(outFile) ? outFile : path.join(process.cwd(), outFile);
-
-      // Build --exclude flags
-      const excludeFlags = EXCLUDE_PATTERNS.map((p) => `--exclude='.arc402/${p}'`).join(" ");
-
-      try {
-        execSync(
-          `tar -czf "${absOut}" ${excludeFlags} -C "${os.homedir()}" .arc402`,
-          { stdio: "pipe" }
-        );
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(`  ${c.failure} Backup failed: ${msg}`);
-        process.exit(1);
-      }
-
-      // Verify the file was created
-      if (!fs.existsSync(absOut)) {
-        console.error(`  ${c.failure} Archive not found after tar completed.`);
-        process.exit(1);
-      }
-
-      const sizeBytes = fs.statSync(absOut).size;
-      const sizeStr = sizeBytes < 1024
-        ? `${sizeBytes} B`
-        : sizeBytes < 1024 * 1024
-        ? `${(sizeBytes / 1024).toFixed(1)} KB`
-        : `${(sizeBytes / (1024 * 1024)).toFixed(2)} MB`;
-
-      console.log(`  ${c.success} Backup saved to ${c.white(path.basename(absOut))}  ${c.dim(`(${sizeStr})`)}`);
-    });
-
-  // ── restore ────────────────────────────────────────────────────────────────
-  program
-    .command("restore")
-    .description("Restore ~/.arc402/ from a backup archive")
-    .argument("<archive>", "Path to arc402-backup-*.tar.gz")
-    .action((archive: string) => {
-      const absArchive = path.isAbsolute(archive) ? archive : path.join(process.cwd(), archive);
-
-      if (!fs.existsSync(absArchive)) {
-        console.error(`  ${c.failure} Archive not found: ${absArchive}`);
-        process.exit(1);
-      }
-
-      // Warn if ~/.arc402/ already exists
-      if (fs.existsSync(ARC402_DIR)) {
-        const existing = fs.readdirSync(ARC402_DIR);
-        if (existing.length > 0) {
-          console.warn(`  ${c.warning} Existing ~/.arc402/ has ${existing.length} file(s) — merging (existing files take precedence for conflicts).`);
-        }
-      }
-
-      try {
-        // Extract to home dir — tar archive has .arc402/ as the root entry
-        execSync(`tar -xzf "${absArchive}" -C "${os.homedir()}"`, { stdio: "pipe" });
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(`  ${c.failure} Restore failed: ${msg}`);
-        process.exit(1);
-      }
-
-      // Verify config.json is present
-      const configPath = path.join(ARC402_DIR, "config.json");
-      if (!fs.existsSync(configPath)) {
-        console.error(`  ${c.failure} config.json not found after restore — archive may be incomplete.`);
-        process.exit(1);
-      }
-
-      // Fix permissions on restored directory
-      try {
-        fs.chmodSync(ARC402_DIR, 0o700);
-        fs.chmodSync(configPath, 0o600);
-      } catch { /* best-effort */ }
-
-      console.log(`  ${c.success} Config restored. Run ${c.white("arc402 doctor")} to verify.`);
-    });
-}

package/src/commands/cancel.ts

@@ -1,35 +0,0 @@
-import { Command } from "commander";
-import { ServiceAgreementClient } from "@arc402/sdk";
-import { loadConfig } from "../config.js";
-import { requireSigner } from "../client.js";
-import { printSenderInfo, executeContractWriteViaWallet } from "../wallet-router.js";
-import { SERVICE_AGREEMENT_ABI } from "../abis.js";
-import { c } from "../ui/colors.js";
-import { startSpinner } from "../ui/spinner.js";
-
-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}`));
-  });
-}