feat(sdk-route): group executor overrides under executor namespace on Config

Add executor.getCapabilities to NttExecutorRoute.Config and
MultiTokenNttExecutorRoute.Config. Replace local type definitions
with imports from sdk-definitions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: kev1n-peters

sdk/route/src/executor/executor.ts

@@ -39,6 +39,7 @@ import {
 import "@wormhole-foundation/sdk-definitions-ntt";
 import { NttRoute } from "../types.js";
 import {
+  type CapabilitiesResponse,
   calculateReferrerFee,
   collectTransactions,
   fetchCapabilities,
@@ -61,6 +62,10 @@ export namespace NttExecutorRoute {
     referrerFee?: ReferrerFeeConfig;
     // Takes priority over referrerFee if defined
     getReferrerFee?: ReferrerFeeCallback;
+    executor?: {
+      /** Override the default capabilities fetcher (e.g. to cache or use a custom endpoint). */
+      getCapabilities?: (network: Network) => Promise<CapabilitiesResponse>;
+    };
   };
 
   export type ReferrerFeeConfig = {
@@ -379,7 +384,9 @@ export class NttExecutorRoute<N extends Network>
       throw new Error("Amount after fee <= 0");
     }
 
-    const capabilities = await fetchCapabilities(fromChain.network);
+    const capabilities = this.staticConfig.executor?.getCapabilities
+      ? await this.staticConfig.executor.getCapabilities(fromChain.network)
+      : await fetchCapabilities(fromChain.network);
     const srcCapabilities = capabilities[toChainId(fromChain.chain)];
     if (!srcCapabilities) {
       throw new Error("Unsupported source chain");

sdk/route/src/executor/multiToken.ts

@@ -36,8 +36,9 @@ import {
   NttWithExecutor,
 } from "@wormhole-foundation/sdk-definitions-ntt";
 import {
+  type CapabilitiesResponse,
+  type Capabilities,
   calculateReferrerFee,
-  Capabilities,
   collectTransactions,
   fetchCapabilities,
   fetchSignedQuote,
@@ -51,6 +52,10 @@ export namespace MultiTokenNttExecutorRoute {
     contracts: MultiTokenNtt.Contracts[];
     referrerFee?: ReferrerFeeConfig;
     axelarGasMultiplier?: number | "auto";
+    executor?: {
+      /** Override the default capabilities fetcher (e.g. to cache or use a custom endpoint). */
+      getCapabilities?: (network: Network) => Promise<CapabilitiesResponse>;
+    };
   };
 
   export type ReferrerFeeConfig = NttExecutorRoute.ReferrerFeeConfig;
@@ -349,7 +354,9 @@ export class MultiTokenNttExecutorRoute<N extends Network>
     sourceCapabilities: Capabilities;
     destinationCapabilities: Capabilities;
   }> {
-    const capabilities = await fetchCapabilities(fromChain.network);
+    const capabilities = this.staticConfig.executor?.getCapabilities
+      ? await this.staticConfig.executor.getCapabilities(fromChain.network)
+      : await fetchCapabilities(fromChain.network);
     const sourceCapabilities = capabilities[toChainId(fromChain.chain)];
     if (!sourceCapabilities) {
       throw new Error("Unsupported source chain");

sdk/route/src/executor/utils.ts

@@ -5,71 +5,32 @@ import {
   amount as sdkAmount,
 } from "@wormhole-foundation/sdk-base";
 import type { UnsignedTransaction } from "@wormhole-foundation/sdk-definitions";
-import { SignedQuote } from "@wormhole-foundation/sdk-definitions";
+import {
+  type CapabilitiesResponse,
+  type Capabilities,
+  type QuoteResponse,
+  type RelayData,
+  type RequestForExecution,
+  type StatusResponse,
+  type TxInfo,
+  RelayStatus,
+  RequestPrefix,
+} from "@wormhole-foundation/sdk-definitions";
 import axios from "axios";
 import { apiBaseUrl } from "./consts.js";
 import { NttRoute } from "../types.js";
 
-export enum RelayStatus {
-  Pending = "pending",
-  Failed = "failed",
-  Unsupported = "unsupported",
-  Submitted = "submitted",
-  Underpaid = "underpaid",
-  Aborted = "aborted",
-}
-
-export type RequestForExecution = {
-  quoterAddress: `0x${string}`;
-  amtPaid: string;
-  dstChain: number;
-  dstAddr: `0x${string}`;
-  refundAddr: `0x${string}`;
-  signedQuoteBytes: `0x${string}`;
-  requestBytes: `0x${string}`;
-  relayInstructionsBytes: `0x${string}`;
-  timestamp: Date;
-};
-
-export type TxInfo = {
-  txHash: string;
-  chainId: number;
-  blockNumber: string;
-  blockTime: Date | null;
-  cost: string;
+export { RelayStatus, RequestPrefix };
+export type {
+  CapabilitiesResponse,
+  Capabilities,
+  QuoteResponse,
+  RelayData,
+  RequestForExecution,
+  StatusResponse,
+  TxInfo,
 };
 
-export type RelayData = {
-  id: `0x${string}`;
-  txHash: string;
-  chainId: number;
-  status: string;
-  estimatedCost: string;
-  requestForExecution: RequestForExecution;
-  instruction?: Request;
-  txs?: TxInfo[];
-  indexed_at: Date;
-};
-
-export enum RequestPrefix {
-  ERM1 = "ERM1", // MM
-  ERV1 = "ERV1", // VAA_V1
-  ERN1 = "ERN1", // NTT_V1
-  ERC1 = "ERC1", // CCTP_V1
-  ERC2 = "ERC2", // CCTP_V2
-}
-
-export type Capabilities = {
-  requestPrefixes: Array<keyof typeof RequestPrefix>;
-  gasDropOffLimit: string;
-  maxGasLimit: string;
-  maxMsgValue: string; // the maximum msgValue, inclusive of the gasDropOffLimit
-};
-
-export interface CapabilitiesResponse {
-  [chainId: string]: Capabilities;
-}
-
 export async function fetchCapabilities(
   network: Network
 ): Promise<CapabilitiesResponse> {
@@ -83,11 +44,6 @@ export async function fetchCapabilities(
   }
 }
 
-export interface QuoteResponse {
-  signedQuote: `0x${string}`;
-  estimatedCost?: string;
-}
-
 export async function fetchSignedQuote(
   network: Network,
   srcChain: Chain,
@@ -108,11 +64,6 @@ export async function fetchSignedQuote(
   }
 }
 
-export interface StatusResponse extends RelayData {
-  signedQuote: SignedQuote;
-  estimatedCost: string;
-}
-
 // Fetch Status
 export async function fetchStatus(
   network: Network,

sdk/route/src/index.ts

@@ -4,3 +4,7 @@ export * from "./automatic.js";
 export * from "./multiTokenManual.js";
 export * from "./executor/executor.js";
 export * from "./executor/multiToken.js";
+export {
+  fetchCapabilities,
+  type CapabilitiesResponse,
+} from "./executor/utils.js";