arc402-cli 0.3.4 → 0.4.1

package/src/commands/agreements.ts

@@ -7,6 +7,9 @@ import { getClient } from "../client";
 import { agreementStatusLabel, formatDate, printTable, truncateAddress } from "../utils/format";
 import { formatDeadline } from "../utils/time";
 import { hashString } from "../utils/hash";
+import { c } from "../ui/colors";
+import { renderTree } from "../ui/tree";
+import { formatAddress } from "../ui/format";
 
 // ─── AgreementTree minimal ABI ────────────────────────────────────────────────
 
@@ -61,11 +64,23 @@ export function registerAgreementsCommands(program: Command): void {
       const client = new ServiceAgreementClient(config.serviceAgreementAddress, provider);
       const agreement = await client.getAgreement(BigInt(id));
       if (opts.json) return console.log(JSON.stringify(agreement, (_k, value) => typeof value === "bigint" ? value.toString() : value, 2));
-      console.log(`agreement #${agreement.id}\nclient=${agreement.client}\nprovider=${agreement.provider}\nstatus=${agreementStatusLabel(agreement.status)}\ncreated=${formatDate(Number(agreement.createdAt))}\ndeadline=${formatDate(Number(agreement.deadline))}\nverifyWindowEnd=${Number(agreement.verifyWindowEnd) ? formatDate(Number(agreement.verifyWindowEnd)) : "n/a"}\ncommittedHash=${agreement.committedHash}`);
+      console.log('\n ' + c.mark + c.white(` Agreement #${agreement.id}`));
+      renderTree([
+        { label: 'Client', value: formatAddress(agreement.client) },
+        { label: 'Provider', value: formatAddress(agreement.provider) },
+        { label: 'Status', value: agreementStatusLabel(agreement.status) },
+        { label: 'Created', value: formatDate(Number(agreement.createdAt)) },
+        { label: 'Deadline', value: formatDate(Number(agreement.deadline)) },
+        { label: 'Verify end', value: Number(agreement.verifyWindowEnd) ? formatDate(Number(agreement.verifyWindowEnd)) : 'n/a' },
+        { label: 'Hash', value: String(agreement.committedHash), last: true },
+      ]);
       if ([AgreementStatus.REVISION_REQUESTED, AgreementStatus.REVISED, AgreementStatus.PARTIAL_SETTLEMENT, AgreementStatus.ESCALATED_TO_HUMAN, AgreementStatus.DISPUTED, AgreementStatus.ESCALATED_TO_ARBITRATION].includes(agreement.status)) {
         const remediation = await client.getRemediationCase(agreement.id);
         const dispute = await client.getDisputeCase(agreement.id);
-        console.log(`remediationActive=${remediation.active} cycles=${remediation.cycleCount} disputeOutcome=${dispute.outcome}`);
+        renderTree([
+          { label: 'Remediation', value: `active=${remediation.active} cycles=${remediation.cycleCount}` },
+          { label: 'Dispute', value: `outcome=${dispute.outcome}`, last: true },
+        ]);
       }
     });
 
@@ -90,9 +105,12 @@ export function registerAgreementsCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify({ txHash: receipt.hash, parentId: opts.parent, childId: opts.child }));
       } else {
-        console.log(`Sub-agreement registered.`);
-        console.log(`  Parent: ${opts.parent}  Child: ${opts.child}`);
-        console.log(`  tx: ${receipt.hash}`);
+        console.log('\n ' + c.mark + c.white(' Sub-agreement registered'));
+        renderTree([
+          { label: 'Parent', value: `#${opts.parent}` },
+          { label: 'Child', value: `#${opts.child}` },
+          { label: 'Tx', value: receipt.hash, last: true },
+        ]);
       }
     });
 
@@ -130,11 +148,13 @@ export function registerAgreementsCommands(program: Command): void {
         return;
       }
 
-      console.log(`Agreement Tree — node #${agreementId}`);
-      console.log(`  Root:     #${result.root}`);
-      console.log(`  Depth:    ${result.depth}`);
-      console.log(`  Path:     ${result.path.map((p) => "#" + p).join(" → ")}`);
-      console.log(`  Children: ${result.children.length > 0 ? result.children.map((c) => "#" + c).join(", ") : "(none)"}`);
+      console.log('\n ' + c.mark + c.white(` Agreement Tree — node #${agreementId}`));
+      renderTree([
+        { label: 'Root', value: `#${result.root}` },
+        { label: 'Depth', value: String(result.depth) },
+        { label: 'Path', value: result.path.map((p) => "#" + p).join(" → ") },
+        { label: 'Children', value: result.children.length > 0 ? result.children.map((ch) => "#" + ch).join(", ") : "(none)", last: true },
+      ]);
     });
 
   // ── arc402 agreements-tree-status <id> ───────────────────────────────────────
@@ -168,10 +188,12 @@ export function registerAgreementsCommands(program: Command): void {
         return;
       }
 
-      console.log(`Agreement #${agreementId} tree status:`);
-      console.log(`  Sub-agreements: ${result.childCount}`);
-      console.log(`  All settled:    ${result.allChildrenSettled ? "YES" : "NO"}`);
-      console.log(`  Ready to deliver to parent: ${result.readyToDeliver ? "YES" : "NO"}`);
+      console.log('\n ' + c.mark + c.white(` Agreement #${agreementId} — tree status`));
+      renderTree([
+        { label: 'Sub-agrmts', value: String(result.childCount) },
+        { label: 'All settled', value: result.allChildrenSettled ? 'YES' : 'NO' },
+        { label: 'Ready', value: result.readyToDeliver ? 'YES — ready to deliver to parent' : 'NO', last: true },
+      ]);
     });
 
   // ── arc402 agreements-create-tree ────────────────────────────────────────────
@@ -255,7 +277,7 @@ export function registerAgreementsCommands(program: Command): void {
       const rootDeadline = Number(opts.deadline);
       const rootHash = hashString(opts.task);
 
-      if (!opts.json) console.log(`\nProposing root agreement to ${opts.provider}...`);
+      if (!opts.json) console.log('\n ' + c.mark + c.white(` Proposing root agreement to ${opts.provider}...`));
       const rootTx = await saContract.propose(
         opts.provider, opts.serviceType, opts.task,
         rootPrice, ethers.ZeroAddress, rootDeadline, rootHash,
@@ -274,11 +296,11 @@ export function registerAgreementsCommands(program: Command): void {
       }
       if (rootAgreementId === undefined) throw new Error("Could not parse root AgreementProposed event");
 
-      if (!opts.json) console.log(`  Root agreement ID: ${rootAgreementId}`);
+      if (!opts.json) console.log(' ' + c.success + c.white(` Root agreement ID: #${rootAgreementId}`));
 
       const childAgreementIds: bigint[] = [];
       for (const sub of subSpecs) {
-        if (!opts.json) console.log(`  Proposing sub-agreement to ${sub.provider}...`);
+        if (!opts.json) console.log(' ' + c.dim(`  Proposing sub-agreement to ${sub.provider}...`));
         const subHash = hashString(sub.task);
         const subTx = await saContract.propose(
           sub.provider, sub.serviceType, sub.task,
@@ -294,7 +316,7 @@ export function registerAgreementsCommands(program: Command): void {
           } catch { /* skip */ }
         }
         if (childId === undefined) throw new Error(`Could not parse AgreementProposed for sub-agreement to ${sub.provider}`);
-        if (!opts.json) console.log(`    Sub-agreement ID: ${childId} — registering in tree...`);
+        if (!opts.json) console.log(' ' + c.success + c.white(` Sub-agreement #${childId} — registering in tree...`));
         await (await treeContract.registerSubAgreement(rootAgreementId, childId)).wait();
         childAgreementIds.push(childId);
       }
@@ -308,13 +330,17 @@ export function registerAgreementsCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`\nAgreement tree created.`);
-        console.log(`  Root:     #${result.rootAgreementId}`);
-        if (result.childAgreementIds.length > 0) {
-          console.log(`  Children: ${result.childAgreementIds.map((id) => "#" + id).join(", ")}`);
-        } else {
-          console.log(`  Children: (none — sub-agreements can be added with agreements-sub-register)`);
-        }
+        console.log('\n ' + c.mark + c.white(' Agreement tree created'));
+        renderTree([
+          { label: 'Root', value: `#${result.rootAgreementId}` },
+          {
+            label: 'Children',
+            value: result.childAgreementIds.length > 0
+              ? result.childAgreementIds.map((id) => "#" + id).join(", ")
+              : "(none — sub-agreements can be added with agreements-sub-register)",
+            last: true,
+          },
+        ]);
       }
     });
 

package/src/commands/arbitrator.ts

@@ -2,6 +2,9 @@ import { Command } from "commander";
 import { DisputeArbitrationClient } from "@arc402/sdk";
 import { loadConfig } from "../config";
 import { getClient, requireSigner } from "../client";
+import { c } from "../ui/colors";
+import { startSpinner } from "../ui/spinner";
+import { renderTree } from "../ui/tree";
 
 export function registerArbitratorCommand(program: Command): void {
   const arbitrator = program
@@ -23,16 +26,22 @@ export function registerArbitratorCommand(program: Command): void {
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, provider);
 
       const eligible = await client.isEligibleArbitrator(arbitratorAddress);
-      console.log(`Arbitrator ${arbitratorAddress} eligible: ${eligible}`);
+      console.log('\n ' + c.mark + c.white(' Arbitrator status'));
+      renderTree([
+        { label: 'Address', value: arbitratorAddress },
+        { label: 'Eligible', value: eligible ? 'yes' : 'no', last: !agreementId },
+      ]);
 
       if (agreementId) {
         const bondState = await client.getArbitratorBondState(arbitratorAddress, BigInt(agreementId));
-        console.log(`Bond state for agreement ${agreementId}:`);
-        console.log(`  Amount: ${bondState.bondAmount.toString()} tokens`);
-        console.log(`  Locked: ${bondState.locked}`);
-        console.log(`  Slashed: ${bondState.slashed}`);
-        console.log(`  Returned: ${bondState.returned}`);
-        console.log(`  Locked at: ${new Date(Number(bondState.lockedAt) * 1000).toISOString()}`);
+        console.log('\n ' + c.mark + c.white(` Bond state — agreement #${agreementId}`));
+        renderTree([
+          { label: 'Amount', value: `${bondState.bondAmount.toString()} tokens` },
+          { label: 'Locked', value: String(bondState.locked) },
+          { label: 'Slashed', value: String(bondState.slashed) },
+          { label: 'Returned', value: String(bondState.returned) },
+          { label: 'Locked at', value: new Date(Number(bondState.lockedAt) * 1000).toISOString(), last: true },
+        ]);
       }
     });
 
@@ -48,11 +57,18 @@ export function registerArbitratorCommand(program: Command): void {
 
       const bondAmount = BigInt(opts.bond);
       if (bondAmount === 0n) {
-        console.warn("Warning: bond amount is 0. For ERC-20 agreements, pre-approve the DisputeArbitration contract.");
+        console.warn(' ' + c.warning + c.white(' Bond amount is 0. For ERC-20 agreements, pre-approve the DisputeArbitration contract.'));
       }
 
-      await client.acceptAssignment(BigInt(agreementId), bondAmount);
-      console.log(`accepted assignment for agreement ${agreementId}`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.acceptAssignment(BigInt(agreementId), bondAmount);
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Assignment accepted — agreement #${agreementId}`));
     });
 
   bond
@@ -63,8 +79,15 @@ export function registerArbitratorCommand(program: Command): void {
       if (!config.disputeArbitrationAddress) throw new Error("disputeArbitrationAddress missing in config");
       const { signer } = await requireSigner(config);
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, signer);
-      await client.triggerFallback(BigInt(agreementId));
-      console.log(`fallback triggered for ${agreementId}`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.triggerFallback(BigInt(agreementId));
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Fallback triggered — agreement #${agreementId}`));
     });
 
   // Rate subcommands — nest under 'rate'
@@ -82,8 +105,15 @@ export function registerArbitratorCommand(program: Command): void {
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, signer);
 
       const rateVal = BigInt(usdPerToken);
-      await client.setTokenUsdRate(tokenAddress, rateVal);
-      console.log(`token rate set: ${tokenAddress} = ${rateVal.toString()} USD/token`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.setTokenUsdRate(tokenAddress, rateVal);
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Token rate set: ${tokenAddress} = ${rateVal.toString()} USD/token`));
     });
 
   // Admin: slash arbitrator (manual rules violation)
@@ -95,8 +125,15 @@ export function registerArbitratorCommand(program: Command): void {
       if (!config.disputeArbitrationAddress) throw new Error("disputeArbitrationAddress missing in config");
       const { signer } = await requireSigner(config);
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, signer);
-      await client.slashArbitrator(BigInt(agreementId), arbitratorAddress, reason);
-      console.log(`slashed arbitrator ${arbitratorAddress} for ${reason}`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.slashArbitrator(BigInt(agreementId), arbitratorAddress, reason);
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Slashed ${arbitratorAddress}`));
     });
 
   arbitrator
@@ -107,8 +144,15 @@ export function registerArbitratorCommand(program: Command): void {
       if (!config.disputeArbitrationAddress) throw new Error("disputeArbitrationAddress missing in config");
       const { signer } = await requireSigner(config);
       const client = new DisputeArbitrationClient(config.disputeArbitrationAddress, signer);
-      await client.reclaimExpiredBond(BigInt(agreementId));
-      console.log(`bond reclaimed for agreement ${agreementId}`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.reclaimExpiredBond(BigInt(agreementId));
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Bond reclaimed — agreement #${agreementId}`));
     });
 
   arbitrator
@@ -123,7 +167,14 @@ export function registerArbitratorCommand(program: Command): void {
       if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
       const { signer } = await requireSigner(config);
       const client = new ServiceAgreementClient(config.serviceAgreementAddress, signer);
-      await client.resolveFromArbitration(BigInt(agreementId), opts.recipient, BigInt(opts.providerAmount), BigInt(opts.clientAmount));
-      console.log(`resolved from arbitration: agreement ${agreementId}, recipient ${opts.recipient}`);
+      const spinner = startSpinner("Submitting transaction...");
+      try {
+        await client.resolveFromArbitration(BigInt(agreementId), opts.recipient, BigInt(opts.providerAmount), BigInt(opts.clientAmount));
+        spinner.succeed();
+      } catch (err) {
+        spinner.fail();
+        throw err;
+      }
+      console.log(' ' + c.success + c.white(` Resolved from arbitration — agreement #${agreementId}`));
     });
 }

package/src/commands/arena-handshake.ts

@@ -3,6 +3,9 @@ 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";
 
@@ -122,6 +125,7 @@ export function registerArenaHandshakeCommands(program: Command): void {
 
       const handshake = new ethers.Contract(config.handshakeAddress, HANDSHAKE_ABI, signer);
 
+      const hsSpinner = startSpinner(`Sending ${opts.type} handshake...`);
       let tx;
       if (opts.usdc) {
         // USDC handshake
@@ -133,6 +137,7 @@ export function registerArenaHandshakeCommands(program: Command): void {
         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;
@@ -150,14 +155,16 @@ export function registerArenaHandshakeCommands(program: Command): void {
       if (opts.json) {
         console.log(JSON.stringify({ tx: tx.hash, from: myAddress, to: agentAddress, type: opts.type, note: opts.note }));
       } else {
-        console.log(`✓ Handshake sent`);
-        console.log(`  From: ${myAddress}`);
-        console.log(`  To:   ${agentAddress}`);
-        console.log(`  Type: ${opts.type}`);
-        if (opts.note) console.log(`  Note: ${opts.note}`);
-        if (opts.tip) console.log(`  Tip:  ${opts.tip} ETH`);
-        if (opts.usdc) console.log(`  Tip:  ${opts.usdc} USDC`);
-        console.log(`  tx:   ${tx.hash}`);
+        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);
       }
     });
 

package/src/commands/arena.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -45,7 +46,7 @@ export function registerArenaCommands(program: Command): void {
           if (opts.json) {
             console.log(JSON.stringify({ error: msg }));
           } else {
-            console.error(chalk.red(msg));
+            console.error(' ' + c.warning + c.white(` ${msg}`));
           }
           process.exit(1);
         }
@@ -90,7 +91,7 @@ export function registerArenaCommands(program: Command): void {
         if (opts.json) {
           console.log(JSON.stringify({ error: "Subgraph unavailable", details: msg }));
         } else {
-          console.error(chalk.red(`Subgraph unavailable: ${msg}`));
+          console.error(' ' + c.failure + c.white(` Subgraph unavailable: ${msg}`));
         }
         process.exit(1);
       }
@@ -113,7 +114,7 @@ export function registerArenaCommands(program: Command): void {
         if ((opts as FeedOptions).json) {
           console.log(JSON.stringify({ error: "Subgraph unavailable", details: msg }));
         } else {
-          console.error(chalk.red(`Subgraph unavailable: ${msg}`));
+          console.error(' ' + c.failure + c.white(` Subgraph unavailable: ${msg}`));
         }
         process.exit(1);
       }

package/src/commands/cancel.ts

@@ -4,6 +4,8 @@ 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) => {
@@ -11,16 +13,23 @@ export function registerCancelCommand(program: Command): void {
     if (!config.serviceAgreementAddress) throw new Error("serviceAgreementAddress missing in config");
     const { signer } = await requireSigner(config);
     printSenderInfo(config);
-    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));
+    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(`cancelled ${id}`);
+    console.log(' ' + c.success + c.white(` Cancelled — agreement #${id}`));
   });
 }

package/src/commands/channel.ts

@@ -6,6 +6,10 @@ 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");
 
@@ -33,6 +37,7 @@ export function registerChannelCommands(program: Command): void {
       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,
@@ -41,10 +46,14 @@ export function registerChannelCommands(program: Command): void {
         Number(opts.deadline)
       );
       if (opts.json || program.opts().json) {
+        spinner.stop();
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`channel opened: ${result.channelId}`);
-        console.log(`tx: ${result.txHash}`);
+        spinner.succeed(' Opened — channel ' + result.channelId);
+        renderTree([
+          { label: 'Channel', value: result.channelId },
+          { label: 'Tx', value: result.txHash, last: true },
+        ]);
       }
     });
 
@@ -60,14 +69,15 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify(ch, (_k, v) => typeof v === "bigint" ? v.toString() : v, 2));
       } else {
-        console.log(`channel: ${channelId}`);
-        console.log(`  status:    ${ch.status}`);
-        console.log(`  client:    ${ch.client}`);
-        console.log(`  provider:  ${ch.provider}`);
-        console.log(`  deposit:   ${ch.depositAmount}`);
-        console.log(`  settled:   ${ch.settledAmount}`);
-        console.log(`  seq:       ${ch.lastSequenceNumber}`);
-        console.log(`  deadline:  ${ch.deadline}`);
+        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 },
+        ]);
       }
     });
 
@@ -107,8 +117,8 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`close submitted: ${result.txHash}`);
-        console.log("challenge window open (24h)");
+        console.log(' ' + c.success + c.white(` Close submitted — ${result.txHash}`));
+        console.log(' ' + c.dim('Challenge window open (24h)'));
       }
     });
 
@@ -126,7 +136,7 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`challenge submitted: ${result.txHash}`);
+        console.log(' ' + c.success + c.white(` Challenge submitted — ${result.txHash}`));
       }
     });
 
@@ -142,7 +152,7 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`finalised: ${result.txHash}`);
+        console.log(' ' + c.success + c.white(` Finalised — ${result.txHash}`));
       }
     });
 
@@ -158,7 +168,7 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify(result, null, 2));
       } else {
-        console.log(`reclaimed: ${result.txHash}`);
+        console.log(' ' + c.success + c.white(` Reclaimed — ${result.txHash}`));
       }
     });
 
@@ -201,8 +211,8 @@ export function registerChannelCommands(program: Command): void {
       if (opts.json || program.opts().json) {
         console.log(JSON.stringify({ stored: true, channelId, path: dest }));
       } else {
-        console.log(`State stored: ${dest}`);
-        console.log(`  seq: ${state.sequenceNumber}`);
+        console.log(' ' + c.success + c.white(` State stored — ${dest}`));
+        console.log(' ' + c.dim(`seq: ${state.sequenceNumber}`));
       }
     });
 }

package/src/commands/coldstart.ts

@@ -2,6 +2,9 @@ import { Command } from "commander";
 import { ethers } from "ethers";
 import { loadConfig } from "../config";
 import { getClient, requireSigner } from "../client";
+import { c } from '../ui/colors';
+import { startSpinner } from '../ui/spinner';
+import { renderTree } from '../ui/tree';
 
 const VOUCHING_REGISTRY_ABI = [
   "function vouch(address newAgent, uint256 stakeAmount) external payable",
@@ -42,6 +45,7 @@ export function registerColdStartCommands(program: Command): void {
       const stakeAmount = opts.stake ? BigInt(opts.stake) : 0n;
       const contract = new ethers.Contract(config.vouchingRegistryAddress, VOUCHING_REGISTRY_ABI, signer);
 
+      const spinner = startSpinner(`Vouching for ${address}…`);
       const tx = await contract.vouch(address, stakeAmount);
       const receipt = await tx.wait();
 
@@ -53,11 +57,14 @@ export function registerColdStartCommands(program: Command): void {
         boostGranted: boost.toString(),
         txHash: receipt.hash,
       };
-      if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      console.log(`vouched for ${address}`);
-      if (stakeAmount > 0n) console.log(`  stake: ${ethers.formatEther(stakeAmount)} ETH`);
-      console.log(`  boost granted: +${boost} trust points`);
-      console.log(`  tx: ${receipt.hash}`);
+      if (opts.json) { spinner.stop(); return console.log(JSON.stringify(payload, null, 2)); }
+      spinner.succeed(` Vouched — ${address}`);
+      renderTree([
+        { label: 'New Agent', value: address },
+        { label: 'Stake', value: stakeAmount > 0n ? `${ethers.formatEther(stakeAmount)} ETH` : '0' },
+        { label: 'Boost', value: `+${boost} trust points` },
+        { label: 'Tx', value: receipt.hash, last: true },
+      ]);
     });
 
   // ─── bond ──────────────────────────────────────────────────────────────────
@@ -88,14 +95,18 @@ export function registerColdStartCommands(program: Command): void {
       }
 
       const amount = opts.amount ? BigInt(opts.amount) : BOND_DEFAULT_AMOUNT;
+      const bondSpinner = startSpinner('Posting bond…');
       const tx = await contract.postBond({ value: amount });
       const receipt = await tx.wait();
 
       const payload = { bonded: true, amount: amount.toString(), txHash: receipt.hash };
-      if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      console.log(`bond posted: ${ethers.formatEther(amount)} ETH`);
-      console.log(`  claimable after 90 days of clean operation`);
-      console.log(`  tx: ${receipt.hash}`);
+      if (opts.json) { bondSpinner.stop(); return console.log(JSON.stringify(payload, null, 2)); }
+      bondSpinner.succeed(` Bond posted — ${ethers.formatEther(amount)} ETH`);
+      renderTree([
+        { label: 'Amount', value: `${ethers.formatEther(amount)} ETH` },
+        { label: 'Tx', value: receipt.hash },
+        { label: 'Note', value: 'Claimable after 90 days of clean operation', last: true },
+      ]);
     });
 
   // arc402 bond status <address>
@@ -121,8 +132,8 @@ export function registerColdStartCommands(program: Command): void {
       } catch {
         const payload = { address, bonded: false };
         if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-        console.log(`address=${address}`);
-        console.log(`  no active bond`);
+        console.log('\n ' + c.mark + c.white(` Bond Status — ${address}`));
+        renderTree([{ label: 'Status', value: 'No active bond', last: true }]);
         return;
       }
 
@@ -140,17 +151,15 @@ export function registerColdStartCommands(program: Command): void {
         daysRemaining,
       };
       if (opts.json) return console.log(JSON.stringify(payload, null, 2));
-      console.log(`address=${address}`);
+      console.log('\n ' + c.mark + c.white(` Bond Status — ${address}`));
       if (!active) {
-        console.log(`  no active bond`);
+        renderTree([{ label: 'Status', value: 'No active bond', last: true }]);
         return;
       }
-      console.log(`  amount: ${ethers.formatEther(amount)} ETH`);
-      console.log(`  posted: ${new Date(Number(postedAt) * 1000).toISOString()}`);
-      if (daysRemaining > 0) {
-        console.log(`  claimable in: ${daysRemaining} days`);
-      } else {
-        console.log(`  claimable: now`);
-      }
+      renderTree([
+        { label: 'Amount', value: `${ethers.formatEther(amount)} ETH` },
+        { label: 'Posted', value: new Date(Number(postedAt) * 1000).toISOString() },
+        { label: 'Claimable', value: daysRemaining > 0 ? `in ${daysRemaining} days` : 'now', last: true },
+      ]);
     });
 }