arc402-cli 1.0.0-rc.1 → 1.1.0

package/src/telegram-notify.ts

@@ -1,88 +0,0 @@
-import * as https from "https";
-
-/** Generic Telegram message sender. Fire-and-forget — swallows errors. */
-export async function sendTelegramMessage(opts: {
-  botToken: string;
-  chatId: string;
-  threadId?: number;
-  text: string;
-  buttons?: { text: string; url?: string; callback_data?: string }[][];
-}): Promise<void> {
-  const body: Record<string, unknown> = {
-    chat_id: opts.chatId,
-    text: opts.text,
-  };
-  if (opts.threadId !== undefined) body.message_thread_id = opts.threadId;
-  if (opts.buttons && opts.buttons.length > 0) {
-    body.reply_markup = { inline_keyboard: opts.buttons };
-  }
-
-  const payload = JSON.stringify(body);
-  await new Promise<void>((resolve) => {
-    try {
-      const req = https.request(
-        {
-          hostname: "api.telegram.org",
-          path: `/bot${opts.botToken}/sendMessage`,
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Content-Length": Buffer.byteLength(payload),
-          },
-        },
-        (res) => { res.resume(); resolve(); }
-      );
-      req.on("error", () => resolve());
-      req.write(payload);
-      req.end();
-    } catch {
-      resolve();
-    }
-  });
-}
-
-export async function sendWalletConnectApprovalButton(opts: {
-  botToken: string;
-  chatId: string;
-  threadId?: number;
-  prompt: string;
-  walletLinks: { label: string; url: string }[];
-}): Promise<void> {
-  const body: Record<string, unknown> = {
-    chat_id: opts.chatId,
-    text: opts.prompt,
-    reply_markup: {
-      inline_keyboard: [opts.walletLinks.map((link) => ({ text: link.label, url: link.url }))],
-    },
-  };
-  if (opts.threadId !== undefined) {
-    body.message_thread_id = opts.threadId;
-  }
-
-  const payload = JSON.stringify(body);
-
-  await new Promise<void>((resolve) => {
-    try {
-      const req = https.request(
-        {
-          hostname: "api.telegram.org",
-          path: `/bot${opts.botToken}/sendMessage`,
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Content-Length": Buffer.byteLength(payload),
-          },
-        },
-        (res) => {
-          res.resume(); // drain response body
-          resolve();
-        }
-      );
-      req.on("error", () => resolve());
-      req.write(payload);
-      req.end();
-    } catch {
-      resolve();
-    }
-  });
-}

package/src/ui/banner.ts

@@ -1,51 +0,0 @@
-import chalk from "chalk";
-
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const _pkg = require("../../package.json") as { version: string };
-
-const ART = `
- ██████╗ ██████╗  ██████╗      ██╗  ██╗ ██████╗ ██████╗
- ██╔══██╗██╔══██╗██╔════╝      ██║  ██║██╔═══██╗╚════██╗
- ███████║██████╔╝██║     █████╗███████║██║   ██║ █████╔╝
- ██╔══██║██╔══██╗██║     ╚════╝╚════██║██║   ██║██╔═══╝
- ██║  ██║██║  ██║╚██████╗           ██║╚██████╔╝███████╗
- ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝          ╚═╝ ╚═════╝ ╚══════╝`;
-
-const SEPARATOR = chalk.cyanBright("◈") + " " + chalk.dim("─".repeat(45));
-
-export interface BannerConfig {
-  network?: string;
-  wallet?: string;
-  balance?: string;
-}
-
-/** Returns banner as an array of plain lines (no trailing newlines). */
-export function getBannerLines(config?: BannerConfig): string[] {
-  const lines: string[] = [];
-  // ART has a leading newline — skip it
-  for (const l of ART.split("\n").slice(1)) {
-    lines.push(chalk.cyan(l));
-  }
-  lines.push("");
-  lines.push(" " + chalk.dim(`agent-to-agent arcing · v${_pkg.version}`));
-  lines.push(" " + SEPARATOR);
-  if (config) {
-    lines.push("");
-    if (config.network)
-      lines.push(` ${chalk.dim("Network")}   ${chalk.white(config.network)}`);
-    if (config.wallet)
-      lines.push(` ${chalk.dim("Wallet")}    ${chalk.white(config.wallet)}`);
-    if (config.balance)
-      lines.push(` ${chalk.dim("Balance")}   ${chalk.white(config.balance)}`);
-  }
-  lines.push("");
-  lines.push(` ${chalk.dim("Type 'help' to get started")}`);
-  lines.push("");
-  return lines;
-}
-
-export function renderBanner(config?: BannerConfig): void {
-  for (const line of getBannerLines(config)) {
-    console.log(line);
-  }
-}

package/src/ui/colors.ts

@@ -1,30 +0,0 @@
-import chalk from "chalk";
-
-// ─── ARC-402 Color System ─────────────────────────────────────────────────────
-
-export const c = {
-  // Protocol mark + section headings
-  cyan: chalk.cyan,
-  brightCyan: chalk.cyanBright,
-
-  // Primary content, values
-  white: chalk.white,
-
-  // Secondary info — addresses, timestamps, labels
-  dim: chalk.dim,
-
-  // Success states, fulfilled agreements
-  green: chalk.green,
-
-  // Errors, disputes, failures
-  red: chalk.red,
-
-  // Warnings, pending states, unconfirmed
-  yellow: chalk.yellow,
-
-  // Symbols
-  mark: chalk.cyanBright("◈"),
-  success: chalk.green("✓"),
-  failure: chalk.red("✗"),
-  warning: chalk.yellow("⚠"),
-};

package/src/ui/format.ts

@@ -1,77 +0,0 @@
-// ─── Address Formatting ───────────────────────────────────────────────────────
-
-/**
- * Truncate an address to 0x1234...abcd format (first 6 + last 4 chars).
- * Full address is preserved in --json output only.
- */
-export function formatAddress(address: string): string {
-  if (address.length <= 12) return address;
-  return `${address.slice(0, 6)}...${address.slice(-4)}`;
-}
-
-// ─── Value Formatting ─────────────────────────────────────────────────────────
-
-/**
- * Format a single token value: "0.024 ETH" or "150 USDC"
- */
-export function formatValue(amount: string | number, token: string): string {
-  return `${amount} ${token}`;
-}
-
-/**
- * Format a combined ETH + token balance: "0.024 ETH · 150 USDC"
- */
-export function formatBalance(
-  ethAmount: string | number,
-  tokenAmount?: string | number,
-  tokenSymbol?: string
-): string {
-  const eth = `${ethAmount} ETH`;
-  if (tokenAmount !== undefined && tokenSymbol) {
-    return `${eth} · ${tokenAmount} ${tokenSymbol}`;
-  }
-  return eth;
-}
-
-// ─── Timestamp Formatting ─────────────────────────────────────────────────────
-
-/**
- * Format a unix timestamp (seconds) as a relative "time ago" string.
- */
-export function formatTimeAgo(timestampSeconds: number): string {
-  const now = Math.floor(Date.now() / 1000);
-  const delta = now - timestampSeconds;
-
-  if (delta < 60) return "just now";
-  if (delta < 3600) {
-    const m = Math.floor(delta / 60);
-    return `${m}m ago`;
-  }
-  if (delta < 86400) {
-    const h = Math.floor(delta / 3600);
-    return `${h}h ago`;
-  }
-  const d = Math.floor(delta / 86400);
-  return `${d}d ago`;
-}
-
-/**
- * Format seconds-until-expiry as "61h 14m" or "2d 3h".
- */
-export function formatDuration(seconds: number): string {
-  if (seconds <= 0) return "expired";
-  const d = Math.floor(seconds / 86400);
-  const h = Math.floor((seconds % 86400) / 3600);
-  const m = Math.floor((seconds % 3600) / 60);
-
-  if (d > 0) return h > 0 ? `${d}d ${h}h` : `${d}d`;
-  if (h > 0) return m > 0 ? `${h}h ${m}m` : `${h}h`;
-  return `${m}m`;
-}
-
-/**
- * Format a unix timestamp (seconds) as a locale date/time string.
- */
-export function formatTimestamp(timestampSeconds: number): string {
-  return new Date(timestampSeconds * 1000).toLocaleString();
-}

package/src/ui/spinner.ts

@@ -1,56 +0,0 @@
-import ora, { Ora } from "ora";
-import chalk from "chalk";
-
-const SPINNER_FRAMES = {
-  interval: 120,
-  frames: ["◈ ", "◉ ", "◎ ", "◉ "],
-};
-
-export interface ArcSpinner {
-  succeed(text?: string): void;
-  fail(text?: string): void;
-  update(text: string): void;
-  stop(): void;
-}
-
-export function startSpinner(text: string): ArcSpinner {
-  if (process.env.ARC402_PRINT) {
-    process.stdout.write(text + "\n");
-    return {
-      succeed(msg?: string) { if (msg) process.stdout.write("✓ " + msg + "\n"); },
-      fail(msg?: string) { if (msg) process.stderr.write("✗ " + msg + "\n"); },
-      update(t: string) { process.stdout.write(t + "\n"); },
-      stop() {},
-    };
-  }
-
-  const instance: Ora = ora({
-    text,
-    spinner: SPINNER_FRAMES,
-    color: "cyan",
-    prefixText: " ",
-  }).start();
-
-  return {
-    succeed(msg?: string) {
-      instance.stopAndPersist({
-        symbol: chalk.green("✓"),
-        text: msg ?? instance.text,
-        prefixText: " ",
-      });
-    },
-    fail(msg?: string) {
-      instance.stopAndPersist({
-        symbol: chalk.red("✗"),
-        text: msg ?? instance.text,
-        prefixText: " ",
-      });
-    },
-    update(text: string) {
-      instance.text = text;
-    },
-    stop() {
-      instance.stop();
-    },
-  };
-}

package/src/ui/tree.ts

@@ -1,16 +0,0 @@
-import { c } from "./colors";
-
-export interface TreeItem {
-  label: string;
-  value: string;
-  last?: boolean;
-}
-
-export function renderTree(items: TreeItem[]): void {
-  items.forEach((item, i) => {
-    const isLast = item.last ?? (i === items.length - 1);
-    const branch = isLast ? "└" : "├";
-    const paddedLabel = item.label.padEnd(10);
-    console.log(` ${c.dim(branch)} ${c.dim(paddedLabel)} ${c.white(item.value)}`);
-  });
-}

package/src/utils/format.ts

@@ -1,48 +0,0 @@
-import chalk from "chalk";
-import Table from "cli-table3";
-import { AgreementStatus, IdentityTier, ReputationSignalType } from "@arc402/sdk";
-
-export const truncateAddress = (address: string) => address.length <= 12 ? address : `${address.slice(0, 6)}...${address.slice(-4)}`;
-export const formatDate = (timestamp: number) => new Date(timestamp * 1000).toLocaleString();
-
-export function getTrustTier(score: number): string {
-  if (score >= 800) return "Autonomous";
-  if (score >= 600) return "Elevated";
-  if (score >= 300) return "Standard";
-  if (score >= 100) return "Restricted";
-  return "Probationary";
-}
-
-export function agreementStatusLabel(status: AgreementStatus): string {
-  return AgreementStatus[status] ?? "UNKNOWN";
-}
-
-export function colourStatus(status: AgreementStatus): string {
-  const label = agreementStatusLabel(status);
-  switch (status) {
-    case AgreementStatus.PROPOSED:
-    case AgreementStatus.REVISION_REQUESTED:
-      return chalk.yellow(label);
-    case AgreementStatus.ACCEPTED:
-    case AgreementStatus.REVISED:
-    case AgreementStatus.PENDING_VERIFICATION:
-      return chalk.blue(label);
-    case AgreementStatus.FULFILLED:
-      return chalk.green(label);
-    case AgreementStatus.DISPUTED:
-    case AgreementStatus.ESCALATED_TO_HUMAN:
-    case AgreementStatus.ESCALATED_TO_ARBITRATION:
-      return chalk.red(label);
-    default:
-      return chalk.gray(label);
-  }
-}
-
-export const identityTierLabel = (tier: IdentityTier) => IdentityTier[tier] ?? "NONE";
-export const reputationSignalLabel = (signal: ReputationSignalType) => ReputationSignalType[signal] ?? "UNKNOWN";
-
-export function printTable(head: string[], rows: (string | number)[][]) {
-  const table = new Table({ head: head.map((value) => chalk.cyan(value)), style: { head: [], border: [] } });
-  rows.forEach((row) => table.push(row));
-  console.log(table.toString());
-}

package/src/utils/hash.ts

@@ -1,5 +0,0 @@
-import * as fs from "fs";
-import { ethers } from "ethers";
-
-export const hashFile = (filePath: string) => ethers.keccak256(fs.readFileSync(filePath));
-export const hashString = (value: string) => ethers.keccak256(ethers.toUtf8Bytes(value));

package/src/utils/time.ts

@@ -1,15 +0,0 @@
-export function parseDuration(duration: string): number {
-  const now = Math.floor(Date.now() / 1000);
-  const match = duration.match(/^(\d+)([hd])$/i);
-  if (!match) throw new Error(`Invalid duration format: \"${duration}\". Use e.g. 2h, 24h, 7d`);
-  const value = Number(match[1]);
-  return now + (match[2].toLowerCase() === "d" ? value * 86400 : value * 3600);
-}
-
-export function formatDeadline(deadline: number): string {
-  const diff = deadline - Math.floor(Date.now() / 1000);
-  if (diff < 0) return "EXPIRED";
-  const hours = Math.floor(diff / 3600);
-  const days = Math.floor(hours / 24);
-  return days > 0 ? `${days}d ${hours % 24}h remaining` : `${hours}h remaining`;
-}

package/src/wallet-router.ts

@@ -1,178 +0,0 @@
-import { ethers } from "ethers";
-import { Arc402Config } from "./config";
-import { ARC402_WALLET_EXECUTE_ABI } from "./abis";
-
-// ─── ARC402Wallet custom error decoder ─────────────────────────────────────
-
-const WALLET_CUSTOM_ERROR_IFACE = new ethers.Interface([
-  "error WVel()",
-  "error WCtx()",
-  "error WAtt()",
-  "error WAuth()",
-  "error WCall()",
-  "error WZero()",
-  "error WFrozen()",
-  "error WPending()",
-  "error WLock()",
-]);
-
-const WALLET_ERROR_HELP: Record<string, string> = {
-  WVel:
-    "Velocity limit breached. Your wallet has been automatically frozen as a security measure.\n" +
-    "  To unfreeze: arc402 wallet unfreeze\n" +
-    "  To prevent this: check your spending velocity limits with arc402 wallet policy status",
-  WCtx:
-    "Context error: either a context is already open, or no context is open when one is required.\n" +
-    "  Note: each context allows exactly one spend — a new context must be opened per payment.\n" +
-    "  Check context state:  arc402 wallet check-context\n" +
-    "  Close stale context:  arc402 wallet close-context",
-  WAtt:
-    "Attestation invalid: not found, already consumed, expired, or parameters do not match.\n" +
-    "  Each attestation can only be used once. Create a new attestation for each spend.",
-  WAuth:
-    "Machine key not authorized on this wallet.\n" +
-    "  Fix: arc402 wallet authorize-machine-key <your-machine-key-address>",
-  WCall:
-    "External contract call failed. The target contract reverted. Check the target address and calldata.",
-  WZero:
-    "Zero address not allowed for a required address parameter.",
-  WFrozen:
-    "Wallet is frozen and cannot process transactions.\n" +
-    "  To unfreeze: arc402 wallet unfreeze (owner WalletConnect required)",
-  WPending:
-    "A registry upgrade is already pending. Cancel it first: arc402 wallet cancel-registry-upgrade",
-  WLock:
-    "Registry upgrade timelock has not elapsed yet. Check: arc402 wallet execute-registry-upgrade",
-};
-
-/**
- * Attempts to decode a known ARC402Wallet custom error from a thrown error.
- * If a recognized error is found, prints a human-readable message and exits.
- * Otherwise, rethrows the original error.
- */
-export function handleWalletError(e: unknown): never {
-  // Extract revert data from various ethers v6 error shapes
-  let errorData: string | undefined;
-  if (e && typeof e === "object") {
-    const err = e as Record<string, unknown>;
-    if (typeof err.data === "string") {
-      errorData = err.data;
-    } else if (err.error && typeof err.error === "object") {
-      const inner = err.error as Record<string, unknown>;
-      if (typeof inner.data === "string") errorData = inner.data;
-    }
-    // ethers v6 sometimes nests it in info.error.data
-    if (!errorData && err.info && typeof err.info === "object") {
-      const info = err.info as Record<string, unknown>;
-      if (info.error && typeof info.error === "object") {
-        const ie = info.error as Record<string, unknown>;
-        if (typeof ie.data === "string") errorData = ie.data;
-      }
-    }
-    // Fallback: parse from error message string
-    if (!errorData && typeof err.message === "string") {
-      const m = err.message.match(/"data"\s*:\s*"(0x[0-9a-fA-F]+)"/);
-      if (m) errorData = m[1];
-    }
-  }
-
-  if (errorData && errorData.length >= 10) {
-    try {
-      const decoded = WALLET_CUSTOM_ERROR_IFACE.parseError(errorData);
-      if (decoded) {
-        const help = WALLET_ERROR_HELP[decoded.name];
-        if (help) {
-          console.error(`\nError: ${decoded.name}()`);
-          console.error(`  ${help.split("\n").join("\n  ")}`);
-          process.exit(1);
-        }
-      }
-    } catch { /* decoding failed — fall through to rethrow */ }
-  }
-
-  throw e;
-}
-
-// ─── Selector-based error decoder (J1-06) ────────────────────────────────────
-//
-// Maps known 4-byte selectors to human-readable messages for use in external error handling.
-
-const WALLET_ERROR_SELECTOR_MAP: Record<string, string> = {
-  "0x13af807f": "Context error: either a context is already open, or no context is open. Check with `arc402 wallet check-context`",
-  "0x88529d53": "Attestation error: attestation not found, already used, expired, or wrong parameters",
-  "0xd6636aaa": "Velocity limit breached — wallet is now frozen. Run `arc402 wallet unfreeze` to recover",
-  "0xbc34a075": "Unauthorized: this operation requires owner or machine key authorization",
-  "0xf5138cb6": "Contract call failed: the target contract reverted. Check that the target contract is working correctly",
-  "0xd92e233d": "Zero address error: a required address parameter was address(0)",
-  "0xb808d662": "Wallet is frozen. Run `arc402 wallet unfreeze` to recover (requires owner)",
-};
-
-/**
- * Decode a 4-byte ARC402Wallet custom error selector into a human-readable message.
- * Returns null if the selector is not a known wallet error.
- */
-export function decodeWalletError(errorData: string): string | null {
-  if (!errorData || errorData.length < 10) return null;
-  const selector = errorData.slice(0, 10).toLowerCase();
-  return WALLET_ERROR_SELECTOR_MAP[selector] ?? null;
-}
-
-export interface SenderInfo {
-  address: string;
-  useContract: boolean;
-}
-
-export function getEffectiveSender(config: Arc402Config): SenderInfo {
-  if (config.walletContractAddress) {
-    return { address: config.walletContractAddress, useContract: true };
-  }
-  const wallet = new ethers.Wallet(config.privateKey!);
-  return { address: wallet.address, useContract: false };
-}
-
-export function printSenderInfo(config: Arc402Config): void {
-  if (config.walletContractAddress) {
-    console.log(`Using ARC402Wallet: ${config.walletContractAddress}`);
-    console.log(`Policy enforcement active — transaction subject to configured limits`);
-  } else {
-    const wallet = new ethers.Wallet(config.privateKey!);
-    console.log(`Using EOA wallet: ${wallet.address}`);
-    console.log(`Tip: run \`arc402 wallet deploy\` to enable spending limits and policy enforcement`);
-  }
-}
-
-/**
- * Route a write transaction through the ARC402Wallet's executeContractCall when deployed,
- * otherwise encode calldata directly against the target contract using the provided ABI.
- */
-export async function executeContractWriteViaWallet(
-  walletContractAddress: string,
-  signer: ethers.Wallet,
-  targetAddress: string,
-  contractAbi: readonly string[],
-  functionName: string,
-  args: unknown[],
-  value: bigint = 0n,
-  approvalToken: string = ethers.ZeroAddress,
-  maxApprovalAmount: bigint = 0n,
-): Promise<ethers.ContractTransactionResponse> {
-  const iface = new ethers.Interface(contractAbi);
-  const data = iface.encodeFunctionData(functionName, args);
-  const walletContract = new ethers.Contract(
-    walletContractAddress,
-    ARC402_WALLET_EXECUTE_ABI,
-    signer,
-  );
-  try {
-    return await walletContract.executeContractCall({
-      target: targetAddress,
-      data,
-      value,
-      minReturnValue: 0n,
-      maxApprovalAmount,
-      approvalToken,
-    });
-  } catch (e) {
-    handleWalletError(e);
-  }
-}

package/src/walletconnect-session.ts

@@ -1,27 +0,0 @@
-import { Arc402Config, saveConfig } from "./config";
-
-export interface WCSessionData {
-  topic: string;
-  expiry: number;   // Unix timestamp
-  account: string;  // Phone wallet address
-  chainId: number;
-}
-
-/** Returns null if no session, expired, or wrong chainId. */
-export function loadWCSession(config: Arc402Config, requiredChainId: number): WCSessionData | null {
-  if (!config.wcSession) return null;
-  const now = Math.floor(Date.now() / 1000);
-  if (config.wcSession.expiry <= now) return null;
-  if (config.wcSession.chainId !== requiredChainId) return null;
-  return config.wcSession as WCSessionData;
-}
-
-export function saveWCSession(config: Arc402Config, session: WCSessionData): void {
-  config.wcSession = session;
-  saveConfig(config);
-}
-
-export function clearWCSession(config: Arc402Config): void {
-  delete config.wcSession;
-  saveConfig(config);
-}