feat(cli): xrpl transfer subcommand to trigger ntt transfers with relay

Co-authored-by: Douglas Galico <douglas.galico@gmail.com>

Author: M-Picco

cli/src/commands/manual.ts

@@ -8,6 +8,7 @@ import {
   encoding,
   isNetwork,
   toUniversal,
+  UniversalAddress,
   type Chain,
 } from "@wormhole-foundation/sdk";
 
@@ -20,6 +21,8 @@ import { options } from "./shared";
 import { pullChainConfig } from "../index";
 import { validatePayerOption } from "../validation";
 
+const isUniversalHex = (address: string): boolean => /^(0x)?[0-9a-fA-F]{64}$/.test(address);
+
 export function createManualCommand(
   overrides: WormholeConfigOverrides<Network>
 ) {
@@ -118,10 +121,15 @@ export function createManualCommand(
                 `\nSource NTT Manager: ${colors.yellow(sourceConfig.manager)}`
               );
 
-              // Create peer address object
+              // Create peer address object. A peer NTT manager address is a raw
+              // 32-byte universal value, so accept hex directly — routing it
+              // through the chain-specific parser (toUniversal) fails for chains
+              // whose native encoding isn't hex (e.g. XRPL base58).
               const peerChainAddress = {
                 chain: peerChain,
-                address: toUniversal(peerChain, peerAddress),
+                address: isUniversalHex(peerAddress)
+                  ? new UniversalAddress(peerAddress)
+                  : toUniversal(peerChain, peerAddress),
               };
 
               // Get signer for the source chain
@@ -337,10 +345,15 @@ export function createManualCommand(
                 `\nSource NTT Manager: ${colors.yellow(sourceConfig.manager)}`
               );
 
-              // Create peer address object
+              // Create peer address object. A transceiver peer is always a raw
+              // 32-byte universal address, so accept hex directly — routing it
+              // through the chain-specific parser (toUniversal) fails for chains
+              // whose native encoding isn't hex (e.g. XRPL base58).
               const peerChainAddress = {
                 chain: peerChain,
-                address: toUniversal(peerChain, peerAddress),
+                address: isUniversalHex(peerAddress)
+                  ? new UniversalAddress(peerAddress)
+                  : toUniversal(peerChain, peerAddress),
               };
 
               // Get signer for the source chain

cli/src/commands/xrpl/index.ts

@@ -17,6 +17,7 @@ import { createXrplParseVaaCommand } from "./parse-vaa";
 import { createXrplRelayCommand } from "./relay";
 import { createXrplRegisterPeerCommand } from "./register-peer";
 import { createXrplRotateAdminCommand } from "./rotate-admin";
+import { createXrplTransferCommand } from "./transfer";
 
 /**
  * `ntt xrpl <subcommand>` — XRPL commands for preparing and operating an NTT
@@ -66,6 +67,7 @@ export function createXrplCommand(overrides: WormholeConfigOverrides<Network>) {
         .command(createXrplRelayCommand(overrides))
         .command(createXrplRegisterPeerCommand(overrides))
         .command(createXrplRotateAdminCommand(overrides))
+        .command(createXrplTransferCommand(overrides))
         .demandCommand(1, "Specify an xrpl subcommand")
         .strict(),
     handler: () => {},

cli/src/commands/xrpl/relay.ts

@@ -211,7 +211,7 @@ export function createXrplRelayCommand(
   };
 }
 
-async function runRelay(
+export async function runRelay(
   argv: any,
   overrides: WormholeConfigOverrides<Network>
 ): Promise<void> {
@@ -221,12 +221,12 @@ async function runRelay(
   const dstChain = resolveChainId(argv["dst-chain"]);
   const requestType: "ern1" | "erv1" = argv["request-type"];
   const executor: string = argv.executor;
-  const executorApi: string = argv["executor-api"];
-  const guardianApi: string = argv["guardian-api"];
+  const executorApi: string = argv["executor-api"] ?? DEFAULT_EXECUTOR_API;
+  const guardianApi: string = argv["guardian-api"] ?? DEFAULT_GUARDIAN_API;
   const gasLimit = BigInt(argv["gas-limit"]);
   const msgValue = BigInt(argv["msg-value"]);
-  const pollInterval = argv["poll-interval"];
-  const pollTimeout = argv["poll-timeout"];
+  const pollInterval = argv["poll-interval"] ?? 5_000;
+  const pollTimeout = argv["poll-timeout"] ?? 120_000;
 
   const seed = loadSeed(argv.seed, "seed", "SEED");
   const wallet = walletFromSeed(seed, argv.algorithm);