@caypo/canton-cli 0.1.0

package/src/commands/traffic.ts

@@ -0,0 +1,49 @@
+/**
+ * caypo traffic — Show validator traffic balance.
+ */
+
+import { Command } from "commander";
+import ora from "ora";
+import chalk from "chalk";
+import { banner, keyValue, accent, warn } from "../helpers/format.js";
+import { loadAgent } from "../helpers/load-agent.js";
+
+export const trafficCommand = new Command("traffic")
+  .description("Show validator traffic balance")
+  .action(async () => {
+    banner();
+
+    const spinner = ora("Checking traffic balance...").start();
+    try {
+      const agent = await loadAgent();
+      const balance = await agent.traffic.trafficBalance();
+      const sufficient = balance.remaining > 1000;
+      spinner.stop();
+
+      console.log(chalk.gray("  Validator Traffic\n"));
+      keyValue("Total purchased", accent(String(balance.totalPurchased)));
+      keyValue("Consumed", String(balance.consumed));
+      keyValue("Remaining", sufficient ? accent(String(balance.remaining)) : warn(String(balance.remaining)));
+      keyValue("Status", sufficient ? "Sufficient" : warn("Low — consider purchasing more"));
+      console.log("");
+    } catch (err) {
+      spinner.fail(`Failed: ${(err as Error).message}`);
+      process.exit(1);
+    }
+  });
+
+trafficCommand
+  .command("purchase")
+  .argument("<cc-amount>", "Canton Coin amount to burn for traffic")
+  .description("Purchase additional traffic by burning CC")
+  .action(async (ccAmount: string) => {
+    const spinner = ora(`Purchasing traffic with ${ccAmount} CC...`).start();
+    try {
+      const agent = await loadAgent();
+      await agent.traffic.purchaseTraffic(ccAmount);
+      spinner.succeed("Traffic purchased");
+    } catch (err) {
+      spinner.fail(`Purchase failed: ${(err as Error).message}`);
+      process.exit(1);
+    }
+  });

package/src/helpers/format.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI formatting helpers.
+ */
+
+import chalk from "chalk";
+
+export const label = (text: string) => chalk.gray(text);
+export const value = (text: string) => chalk.white.bold(text);
+export const success = (text: string) => chalk.green(text);
+export const warn = (text: string) => chalk.yellow(text);
+export const fail = (text: string) => chalk.red(text);
+export const accent = (text: string) => chalk.cyan(text);
+export const dim = (text: string) => chalk.dim(text);
+
+export function banner(): void {
+  console.log(chalk.cyan.bold("\n  CAYPO") + chalk.gray(" — A bank account for AI agents on Canton Network\n"));
+}
+
+export function keyValue(key: string, val: string): void {
+  console.log(`  ${label(key + ":")} ${value(val)}`);
+}
+
+export function errorMessage(msg: string): void {
+  console.log(`\n  ${fail("✗")} ${msg}\n`);
+}
+
+export function successMessage(msg: string): void {
+  console.log(`\n  ${success("✓")} ${msg}\n`);
+}

package/src/helpers/load-agent.ts

@@ -0,0 +1,28 @@
+/**
+ * Load CantonAgent from config for CLI commands.
+ */
+
+import { CantonAgent, loadConfig } from "@caypo/canton-sdk";
+import { errorMessage } from "./format.js";
+
+export async function loadAgent(): Promise<CantonAgent> {
+  try {
+    const config = await loadConfig();
+
+    if (!config.partyId) {
+      errorMessage("No wallet configured. Run 'caypo init' first.");
+      process.exit(1);
+    }
+
+    return CantonAgent.create({
+      ledgerUrl: config.ledgerUrl,
+      partyId: config.partyId,
+      userId: config.userId,
+      network: config.network,
+      token: process.env.CANTON_JWT ?? "",
+    });
+  } catch (err) {
+    errorMessage(`Failed to load agent: ${(err as Error).message}`);
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -0,0 +1,35 @@
+/**
+ * @caypo/canton-cli — CLI for Canton Network agent.
+ * Binary: caypo (aliases: canton-agent, ca)
+ */
+
+import { Command } from "commander";
+import { CANTON_SDK_VERSION } from "@caypo/canton-sdk";
+
+import { initCommand } from "./commands/init.js";
+import { balanceCommand } from "./commands/balance.js";
+import { sendCommand } from "./commands/send.js";
+import { payCommand } from "./commands/pay.js";
+import { addressCommand } from "./commands/address.js";
+import { safeguardsCommand } from "./commands/safeguards.js";
+import { trafficCommand } from "./commands/traffic.js";
+import { mcpCommand } from "./commands/mcp.js";
+
+export const CANTON_CLI_VERSION = "0.1.0";
+
+const program = new Command();
+
+program
+  .name("caypo")
+  .description("CAYPO — A bank account for AI agents on Canton Network")
+  .version(CANTON_CLI_VERSION, "-v, --version")
+  .addCommand(initCommand)
+  .addCommand(balanceCommand)
+  .addCommand(sendCommand)
+  .addCommand(payCommand)
+  .addCommand(addressCommand)
+  .addCommand(safeguardsCommand)
+  .addCommand(trafficCommand)
+  .addCommand(mcpCommand);
+
+program.parse(process.argv);

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  dts: false,
+  clean: true,
+  sourcemap: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    globals: true,
+    passWithNoTests: true,
+  },
+});