arc402-cli 0.9.19 → 0.10.0

package/src/ui/format.ts

@@ -1,78 +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 < 0) return "in " + formatDuration(Math.abs(delta));
-  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/qr-render.ts

@@ -1,92 +0,0 @@
-import QRCode from "qrcode";
-
-export interface QRRenderOptions {
-  /** Error correction level. L = smallest QR. Default: 'L' */
-  errorCorrection?: "L" | "M" | "Q" | "H";
-  /** Quiet zone size in modules. Default: 1 (standard is 4, but 1 suffices for terminal) */
-  quiet?: number;
-  /** Invert colors for dark terminal backgrounds. Default: true */
-  invert?: boolean;
-}
-
-/**
- * Render a QR code as terminal-friendly half-block Unicode characters.
- * Returns an array of strings, one per terminal row.
- *
- * Uses qrcode library for matrix generation, custom renderer for compact output.
- * Key optimizations vs qrcode-terminal:
- *   - Error correction L (not M) — ~20% fewer modules
- *   - Quiet zone 1 (not 4) — saves ~6 rows
- *   - Half-block chars: each terminal row = 2 QR module rows
- */
-export function renderQR(data: string, options?: QRRenderOptions): string[] {
-  const ec = options?.errorCorrection ?? "L";
-  const quiet = options?.quiet ?? 1;
-  const invert = options?.invert ?? true;
-
-  // Generate QR matrix
-  const qr = QRCode.create(data, {
-    errorCorrectionLevel: ec,
-  });
-
-  const size = qr.modules.size;
-  const modules = qr.modules.data;
-
-  // Helper: is module at (row, col) dark? (with quiet zone)
-  const totalSize = size + quiet * 2;
-  const isDark = (row: number, col: number): boolean => {
-    const r = row - quiet;
-    const c = col - quiet;
-    if (r < 0 || r >= size || c < 0 || c >= size) return false;
-    return modules[r * size + c] === 1;
-  };
-
-  const lines: string[] = [];
-
-  // Process 2 rows at a time using half-block characters
-  for (let row = 0; row < totalSize; row += 2) {
-    let line = "";
-    for (let col = 0; col < totalSize; col++) {
-      const top = isDark(row, col);
-      const bottom = row + 1 < totalSize ? isDark(row + 1, col) : false;
-
-      if (invert) {
-        // Dark terminal: dark modules = space (background), light = filled
-        if (top && bottom) {
-          line += " ";       // both dark → background
-        } else if (top && !bottom) {
-          line += "▄";       // top dark, bottom light → bottom half filled
-        } else if (!top && bottom) {
-          line += "▀";       // top light, bottom dark → top half filled
-        } else {
-          line += "█";       // both light → full block
-        }
-      } else {
-        // Light terminal: dark modules = filled
-        if (top && bottom) {
-          line += "█";
-        } else if (top && !bottom) {
-          line += "▀";
-        } else if (!top && bottom) {
-          line += "▄";
-        } else {
-          line += " ";
-        }
-      }
-    }
-    lines.push(line);
-  }
-
-  return lines;
-}
-
-/**
- * Render QR code to stdout (for non-TUI / child process context).
- * Drop-in replacement for qrcode-terminal.generate().
- */
-export function printQR(data: string, options?: QRRenderOptions): void {
-  const lines = renderQR(data, options);
-  for (const line of lines) {
-    console.log("  " + line);
-  }
-}

package/src/ui/rpc-fallback.ts

@@ -1,59 +0,0 @@
-import { ethers } from "ethers";
-
-/**
- * Public RPC endpoints for Base mainnet, ordered by reliability.
- * Used as fallbacks when the configured RPC fails on read-only calls.
- */
-const BASE_FALLBACK_RPCS = [
-  "https://base.llamarpc.com",
-  "https://base-rpc.publicnode.com",
-  "https://1rpc.io/base",
-];
-
-/** Check if verbose mode is enabled via --verbose flag or ARC402_DEBUG env */
-export function isVerbose(): boolean {
-  return process.argv.includes("--verbose") || process.env.ARC402_DEBUG === "1";
-}
-
-/** Log only when verbose mode is on */
-export function verbose(...args: unknown[]): void {
-  if (isVerbose()) {
-    console.log("\x1b[2m  [verbose]", ...args, "\x1b[22m");
-  }
-}
-
-/**
- * Try a read-only call on the configured RPC first, then fall back
- * to public RPCs. Write operations always use the configured RPC.
- */
-export async function callWithFallback<T>(
-  configuredRpcUrl: string,
-  fn: (provider: ethers.JsonRpcProvider) => Promise<T>,
-): Promise<T> {
-  // Try configured RPC first
-  try {
-    verbose(`RPC call via ${configuredRpcUrl}`);
-    const provider = new ethers.JsonRpcProvider(configuredRpcUrl);
-    const result = await fn(provider);
-    verbose(`RPC call succeeded`);
-    return result;
-  } catch (e) {
-    verbose(`RPC failed on ${configuredRpcUrl}: ${e instanceof Error ? e.message.slice(0, 80) : String(e)}`);
-  }
-
-  // Try each fallback
-  for (const rpc of BASE_FALLBACK_RPCS) {
-    try {
-      verbose(`Falling back to ${rpc}`);
-      const provider = new ethers.JsonRpcProvider(rpc);
-      const result = await fn(provider);
-      verbose(`Fallback succeeded on ${rpc}`);
-      return result;
-    } catch (e) {
-      verbose(`Fallback failed on ${rpc}: ${e instanceof Error ? e.message.slice(0, 80) : String(e)}`);
-      continue;
-    }
-  }
-
-  throw new Error("All RPC endpoints failed for read-only call");
-}

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.js";
-
-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.js";
-import { ARC402_WALLET_EXECUTE_ABI } from "./abis.js";
-
-// ─── 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.js";
-
-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);
-}