cli: add token transfer

cli/README.md

@@ -1,5 +1,7 @@
 # NTT cli
 
+Comprehensive setup instructions, walkthroughs, and deployment guides live in the Native Token Transfers documentation. Start with [Get Started with NTT](https://wormhole.com/docs/products/token-transfers/native-token-transfers/get-started/).
+
 ## Prerequisites
 
 - [bun](https://bun.sh/docs/installation)

cli/package.json

@@ -18,8 +18,9 @@
     "ntt": "src/index.ts"
   },
   "dependencies": {
-    "chalk": "^5.3.0",
-    "yargs": "^17.7.2"
+    "chalk": "^5.6.0",
+    "ora": "8.2.0",
+    "yargs": "18.0.0"
   },
   "overrides": {
     "@wormhole-foundation/sdk-definitions-ntt": {

cli/src/deployments.ts

@@ -0,0 +1,41 @@
+import type { Chain, Network } from "@wormhole-foundation/sdk";
+import type { Ntt } from "@wormhole-foundation/sdk-definitions-ntt";
+import fs from "fs";
+
+export type ChainConfig = {
+  version: string;
+  mode: Ntt.Mode;
+  paused: boolean;
+  owner: string;
+  pauser?: string;
+  manager: string;
+  token: string;
+  transceivers: {
+    threshold: number;
+    wormhole: { address: string; pauser?: string; executor?: boolean };
+  };
+  limits: {
+    outbound: string;
+    inbound: Partial<{ [C in Chain]: string }>;
+  };
+};
+
+export type Config = {
+  network: Network;
+  chains: Partial<{
+    [C in Chain]: ChainConfig;
+  }>;
+  defaultLimits?: {
+    outbound: string;
+  };
+};
+
+export function loadConfig(path: string): Config {
+  if (!fs.existsSync(path)) {
+    console.error(`File not found: ${path}`);
+    console.error(`Create with 'ntt init' or specify another file with --path`);
+    process.exit(1);
+  }
+  const deployments: Config = JSON.parse(fs.readFileSync(path).toString());
+  return deployments;
+}

cli/src/error.ts

@@ -2,6 +2,49 @@ import chalk from "chalk";
 import type { Chain, Network } from "@wormhole-foundation/sdk";
 import { chainToPlatform } from "@wormhole-foundation/sdk-base";
 
+const RPC_ERROR_KEYWORDS = [
+  "jsonrpc",
+  "network error",
+  "rpc",
+  "connection",
+  "unable to connect",
+  "404 not found",
+  "status code: 404",
+  "status code",
+  "not found",
+  "could not connect",
+  "failed to fetch",
+  "connect to",
+] as const;
+
+function extractErrorDetails(
+  error: unknown
+): { message: string; stack: string } {
+  if (error instanceof Error) {
+    return {
+      message: error.message ?? "",
+      stack: error.stack ?? "",
+    };
+  }
+  if (typeof error === "object" && error !== null) {
+    const message =
+      "message" in error ? String((error as { message?: unknown }).message ?? "") : "";
+    const stack =
+      "stack" in error ? String((error as { stack?: unknown }).stack ?? "") : "";
+    return { message, stack };
+  }
+  return { message: String(error ?? ""), stack: "" };
+}
+
+export function isRpcConnectionError(error: unknown): boolean {
+  const { message, stack } = extractErrorDetails(error);
+  const haystack = `${message} ${stack}`.toLowerCase();
+  if (!haystack.trim()) {
+    return false;
+  }
+  return RPC_ERROR_KEYWORDS.some((needle) => haystack.includes(needle));
+}
+
 /**
  * @param error - The error that occurred (typically from execSync)
  * @param rpc - The RPC endpoint URL
@@ -57,41 +100,33 @@ function handleRpcConnectionError(
   network: Network,
   rpc: string
 ): boolean {
-  const errorMessage = error?.message || String(error);
-  const errorStack = error?.stack || "";
+  if (!isRpcConnectionError(error)) {
+    return false;
+  }
 
-  // Check if this is an RPC-related error by looking for common RPC error indicators
-  const isRpcError =
-    errorMessage.toLowerCase().includes("jsonrpc") ||
-    errorStack.toLowerCase().includes("jsonrpc") ||
-    errorMessage.toLowerCase().includes("rpc") ||
-    errorMessage.toLowerCase().includes("connection") ||
-    errorMessage.toLowerCase().includes("network error");
+  const errorMessage = error?.message || String(error);
 
-  if (isRpcError) {
-    console.error(
-      chalk.red(`RPC connection error for ${chain} on ${network}\n`)
-    );
-    console.error(chalk.yellow("RPC endpoint:"), chalk.white(rpc));
-    console.error(chalk.yellow("Error:"), errorMessage);
-    console.error();
-    console.error(
-      chalk.yellow(
-        "This error usually means the RPC endpoint is missing, invalid, or unreachable."
-      )
-    );
-    console.error(
-      chalk.yellow(
-        "You can specify a private RPC endpoint by creating an overrides.json file.\n"
-      )
-    );
-    console.error(
-      chalk.cyan("Create a file named ") +
-        chalk.white("overrides.json") +
-        chalk.cyan(" in your project root:")
-    );
-    console.error(
-      chalk.white(`
+  console.error(chalk.red(`RPC connection error for ${chain} on ${network}\n`));
+  console.error(chalk.yellow("RPC endpoint:"), chalk.white(rpc));
+  console.error(chalk.yellow("Error:"), errorMessage);
+  console.error();
+  console.error(
+    chalk.yellow(
+      "This error usually means the RPC endpoint is missing, invalid, or unreachable."
+    )
+  );
+  console.error(
+    chalk.yellow(
+      "You can specify a private RPC endpoint by creating an overrides.json file.\n"
+    )
+  );
+  console.error(
+    chalk.cyan("Create a file named ") +
+      chalk.white("overrides.json") +
+      chalk.cyan(" in your project root:")
+  );
+  console.error(
+    chalk.white(`
 {
   "chains": {
     "${chain}": {
@@ -100,31 +135,28 @@ function handleRpcConnectionError(
   }
 }
 `)
-    );
+  );
 
-    // Show chainlist.org only for EVM chains
-    try {
-      const platform = chainToPlatform(chain as any);
-      if (platform === "Evm") {
-        console.error(
-          chalk.cyan(`Find RPC endpoints for ${chain}: https://chainlist.org`)
-        );
-      }
-    } catch (e) {
-      // If chainToPlatform fails, just skip the platform-specific message
+  // Show chainlist.org only for EVM chains
+  try {
+    const platform = chainToPlatform(chain as any);
+    if (platform === "Evm") {
+      console.error(
+        chalk.cyan(`Find RPC endpoints for ${chain}: https://chainlist.org`)
+      );
     }
-
-    console.error(
-      chalk.cyan(
-        `For more information about overrides.json:\n` +
-          `  • https://wormhole.com/docs/products/token-transfers/native-token-transfers/faqs/#how-can-i-specify-a-custom-rpc-for-ntt`
-      )
-    );
-
-    return true;
+  } catch (e) {
+    // If chainToPlatform fails, just skip the platform-specific message
   }
-
-  return false;
+
+  console.error(
+    chalk.cyan(
+      `For more information about overrides.json:\n` +
+        `  • https://wormhole.com/docs/products/token-transfers/native-token-transfers/faqs/#how-can-i-specify-a-custom-rpc-for-ntt`
+    )
+  );
+
+  return true;
 }
 
 /**
@@ -177,3 +209,20 @@ export function handleDeploymentError(
 
   handleGenericError(error);
 }
+
+/**
+ * Log a concise RPC failure when connection-specific guidance wasn’t already printed.
+ */
+export function logRpcError(
+  error: any,
+  chain: Chain,
+  network: Network,
+  rpc?: string
+): void {
+  if (rpc && handleRpcConnectionError(error, chain, network, rpc)) {
+    return;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(chalk.red(`RPC error for ${chain} on ${network}`));
+  console.error(message);
+}

cli/src/index.ts

@@ -70,6 +70,8 @@ import { registerSolanaTransceiver } from "./solanaHelpers";
 import { colorizeDiff, diffObjects } from "./diff";
 import { forgeSignerArgs, getSigner, type SignerType } from "./getSigner";
 import { handleDeploymentError } from "./error";
+import { loadConfig, type ChainConfig, type Config } from "./deployments";
+export type { ChainConfig, Config } from "./deployments";
 
 // Configuration fields that should be excluded from diff operations
 // These are local-only configurations that don't have on-chain representations
@@ -105,6 +107,7 @@ import type {
 } from "@wormhole-foundation/sdk-evm";
 import { getAvailableVersions, getGitTagName } from "./tag";
 import * as configuration from "./configuration";
+import { createTokenTransferCommand } from "./tokenTransfer";
 import { AbiCoder, ethers, Interface } from "ethers";
 import { newSignSendWaiter, signSendWaitWithOverride } from "./signSendWait.js";
 
@@ -262,35 +265,6 @@ export type SuiDeploymentResult<C extends Chain> = ChainAddress<C> & {
   };
 };
 
-// TODO: rename
-export type ChainConfig = {
-  version: string;
-  mode: Ntt.Mode;
-  paused: boolean;
-  owner: string;
-  pauser?: string;
-  manager: string;
-  token: string;
-  transceivers: {
-    threshold: number;
-    wormhole: { address: string; pauser?: string; executor?: boolean };
-  };
-  limits: {
-    outbound: string;
-    inbound: Partial<{ [C in Chain]: string }>;
-  };
-};
-
-export type Config = {
-  network: Network;
-  chains: Partial<{
-    [C in Chain]: ChainConfig;
-  }>;
-  defaultLimits?: {
-    outbound: string;
-  };
-};
-
 const options = {
   network: {
     alias: "n",
@@ -2010,6 +1984,7 @@ yargs(hideBin(process.argv))
       }
     }
   )
+  .command(createTokenTransferCommand(overrides))
   .command("solana", "Solana commands", (yargs) => {
     yargs
       .command(
@@ -5256,16 +5231,6 @@ function checkAnchorVersion(pwd: string) {
   }
 }
 
-function loadConfig(path: string): Config {
-  if (!fs.existsSync(path)) {
-    console.error(`File not found: ${path}`);
-    console.error(`Create with 'ntt init' or specify another file with --path`);
-    process.exit(1);
-  }
-  const deployments: Config = JSON.parse(fs.readFileSync(path).toString());
-  return deployments;
-}
-
 function resolveVersion(
   latest: boolean,
   ver: string | undefined,