@chainlink/ccip-sdk 0.95.0 → 0.96.0

package/dist/chain.d.ts

@@ -3,7 +3,7 @@ import type { PickDeep, SetOptional } from 'type-fest';
 import { type LaneLatencyResponse, CCIPAPIClient } from './api/index.ts';
 import type { UnsignedAptosTx } from './aptos/types.ts';
 import type { UnsignedEVMTx } from './evm/types.ts';
-import type { EVMExtraArgsV1, EVMExtraArgsV2, ExtraArgs, SVMExtraArgsV1, SuiExtraArgsV1 } from './extra-args.ts';
+import type { EVMExtraArgsV1, EVMExtraArgsV2, ExtraArgs, GenericExtraArgsV3, SVMExtraArgsV1, SuiExtraArgsV1 } from './extra-args.ts';
 import type { LeafHasher } from './hasher/common.ts';
 import type { UnsignedSolanaTx } from './solana/types.ts';
 import type { UnsignedTONTx } from './ton/types.ts';
@@ -35,8 +35,7 @@ export type ChainContext = WithLogger & {
     /**
      * CCIP API client instance for lane information queries.
      *
-     * - `undefined` (default): Creates CCIPAPIClient with production endpoint
-     *   (https://api.ccip.chain.link)
+     * - `undefined` (default): Creates CCIPAPIClient with {@link DEFAULT_API_BASE_URL}
      * - `CCIPAPIClient`: Uses provided instance (allows custom URL, fetch, etc.)
      * - `null`: Disables API client entirely (getLaneLatency() will throw)
      *
@@ -111,29 +110,91 @@ export type GetBalanceOpts = {
 };
 /**
  * Rate limiter state for token pool configurations.
- * Null if rate limiting is disabled.
+ *
+ * @remarks
+ * - Returns the rate limiter bucket state when rate limiting is **enabled**
+ * - Returns `null` when rate limiting is **disabled** (unlimited throughput)
+ *
+ * @example Handling nullable state
+ * ```typescript
+ * const remote = await chain.getTokenPoolRemotes(poolAddress)
+ * const state = remote['ethereum-mainnet'].inboundRateLimiterState
+ *
+ * if (state === null) {
+ *   console.log('Rate limiting disabled - unlimited throughput')
+ * } else {
+ *   console.log(`Capacity: ${state.capacity}, Available: ${state.tokens}`)
+ * }
+ * ```
  */
 export type RateLimiterState = {
     /** Current token balance in the rate limiter bucket. */
     tokens: bigint;
     /** Maximum capacity of the rate limiter bucket. */
     capacity: bigint;
-    /** Rate at which tokens are replenished. */
+    /** Rate at which tokens are replenished (tokens per second). */
     rate: bigint;
 } | null;
 /**
- * Remote token pool configuration for a specific chain.
+ * Remote token pool configuration for a specific destination chain.
+ *
+ * @remarks
+ * Each entry represents the configuration needed to transfer tokens
+ * from the current chain to a specific destination chain.
  */
 export type TokenPoolRemote = {
     /** Address of the remote token on the destination chain. */
     remoteToken: string;
-    /** Addresses of remote token pools. */
+    /**
+     * Addresses of remote token pools on the destination chain.
+     *
+     * @remarks
+     * Multiple pools may exist for:
+     * - Redundancy (failover if one pool is unavailable)
+     * - Capacity aggregation across pools
+     * - Version management (different pool implementations)
+     */
     remotePools: string[];
     /** Inbound rate limiter state for tokens coming into this chain. */
     inboundRateLimiterState: RateLimiterState;
     /** Outbound rate limiter state for tokens leaving this chain. */
     outboundRateLimiterState: RateLimiterState;
 };
+/**
+ * Token pool configuration returned by {@link Chain.getTokenPoolConfig}.
+ *
+ * @remarks
+ * Contains the core configuration of a token pool including the token it manages,
+ * the router it's registered with, and optionally its version identifier.
+ */
+export type TokenPoolConfig = {
+    /** Address of the token managed by this pool. */
+    token: string;
+    /** Address of the CCIP router this pool is registered with. */
+    router: string;
+    /**
+     * Version identifier string (e.g., "BurnMintTokenPool 1.5.1").
+     *
+     * @remarks
+     * May be undefined for older pool implementations that don't expose this method.
+     */
+    typeAndVersion?: string;
+};
+/**
+ * Token configuration from a TokenAdminRegistry, returned by {@link Chain.getRegistryTokenConfig}.
+ *
+ * @remarks
+ * The TokenAdminRegistry tracks which administrator controls each token
+ * and which pool is authorized to handle transfers.
+ */
+export type RegistryTokenConfig = {
+    /** Address of the current administrator for this token. */
+    administrator: string;
+    /** Address of pending administrator (if ownership transfer is in progress). */
+    pendingAdministrator?: string;
+    /** Address of the token pool authorized to handle this token's transfers. */
+    tokenPool?: string;
+};
 /**
  * Maps chain family to respective unsigned transaction type.
  */
@@ -146,7 +207,7 @@ export type UnsignedTx = {
     [ChainFamily.Unknown]: never;
 };
 /**
- * Common options for [[getFee]], [[generateUnsignedSendMessage]] and [[sendMessage]] Chain methods
+ * Common options for {@link Chain.getFee}, {@link Chain.generateUnsignedSendMessage} and {@link Chain.sendMessage} methods.
  */
 export type SendMessageOpts = {
     /** Router address on this chain */
@@ -159,7 +220,7 @@ export type SendMessageOpts = {
     approveMax?: boolean;
 };
 /**
- * Common options for [[generateUnsignedExecuteReport]] and [[executeReport]] Chain methods
+ * Common options for {@link Chain.generateUnsignedExecuteReport} and {@link Chain.executeReport} methods.
  */
 export type ExecuteReportOpts = {
     /** address of the OffRamp contract */
@@ -192,6 +253,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * Base constructor for Chain class.
      * @param network - NetworkInfo object for the Chain instance
      * @param ctx - Optional context with logger and API client configuration
+     * @throws {@link CCIPChainFamilyMismatchError} if network family doesn't match the Chain subclass
      */
     constructor(network: NetworkInfo, ctx?: ChainContext);
     /** Cleanup method to release resources (e.g., close connections). */
@@ -200,17 +262,21 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * Fetch the timestamp of a given block
      * @param block - positive block number, negative finality depth or 'finalized' tag
      * @returns timestamp of the block, in seconds
+     * @throws {@link CCIPBlockNotFoundError} if block does not exist
      */
     abstract getBlockTimestamp(block: number | 'finalized'): Promise<number>;
     /**
      * Fetch a transaction by its hash
      * @param hash - transaction hash
      * @returns generic transaction details
+     * @throws {@link CCIPTransactionNotFoundError} if transaction not found
      */
     abstract getTransaction(hash: string): Promise<ChainTransaction>;
     /**
-     * Confirm a log tx is finalized or wait for it to be finalized
-     * Throws if it isn't included (e.g. a reorg)
+     * Confirm a log tx is finalized or wait for it to be finalized.
+     * @param opts - Options containing the request, finality level, and optional cancel promise
+     * @returns true when the transaction is finalized
+     * @throws {@link CCIPTransactionNotFinalizedError} if the transaction is not included (e.g., due to a reorg)
      */
     waitFinalized({ request: { log, tx }, finality, cancel$, }: {
         request: SetOptional<PickDeep<CCIPRequest, `log.${'address' | 'blockNumber' | 'transactionHash' | 'topics' | 'tx.timestamp'}` | 'tx.timestamp'>, 'tx'>;
@@ -237,21 +303,44 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      *   - `page`: if provided, try to use this page/range for batches
      *   - `watch`: true or cancellation promise, getLogs continuously after initial fetch
      * @returns An async iterable iterator of logs.
+     * @throws {@link CCIPLogsWatchRequiresFinalityError} if watch mode is used without a finality endBlock tag
+     * @throws {@link CCIPLogsWatchRequiresStartError} if watch mode is used without startBlock or startTime
+     * @throws {@link CCIPLogsAddressRequiredError} if address is required but not provided (chain-specific)
      */
     abstract getLogs(opts: LogFilter): AsyncIterableIterator<Log_>;
     /**
      * Fetch all CCIP requests in a transaction
      * @param tx - ChainTransaction or txHash to fetch requests from
      * @returns CCIP messages in the transaction (at least one)
-     **/
+     * @throws {@link CCIPMessageNotFoundInTxError} if no CCIP messages found in transaction
+     */
     getMessagesInTx(tx: string | ChainTransaction): Promise<CCIPRequest[]>;
     /**
-     * Fetch a message by ID.
-     * Default implementation just tries API.
-     * Children may override to fetch from chain as fallback
-     * @param messageId - message ID to fetch request for
-     * @param _opts - onRamp may be required in some implementations, and throw if missing
-     * @returns CCIPRequest
+     * Fetch a CCIP message by its unique message ID.
+     *
+     * @remarks
+     * Uses the CCIP API to retrieve message details. The returned request includes
+     * a `metadata` field with API-specific information.
+     *
+     * @example
+     * ```typescript
+     * const request = await chain.getMessageById(messageId)
+     * console.log(`Sender: ${request.message.sender}`)
+     *
+     * if (request.metadata) {
+     *   console.log(`Status: ${request.metadata.status}`)
+     *   if (request.metadata.deliveryTime) {
+     *     console.log(`Delivered in ${request.metadata.deliveryTime}ms`)
+     *   }
+     * }
+     * ```
+     *
+     * @param messageId - The unique message ID (0x + 64 hex chars)
+     * @param _opts - Optional: `onRamp` hint for non-EVM chains
+     * @returns CCIPRequest with `metadata` populated from API
+     * @throws {@link CCIPApiClientNotAvailableError} if API disabled
+     * @throws {@link CCIPMessageIdNotFoundError} if message not found
+     * @throws {@link CCIPHttpError} if API request fails
      **/
     getMessageById(messageId: string, _opts?: {
         page?: number;
@@ -262,6 +351,8 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @param request - CCIPRequest to fetch batch for.
      * @param commit - CommitReport range (min, max).
      * @param opts - Optional parameters (e.g., `page` for pagination width).
+     * @returns Array of messages in the batch.
+     * @throws {@link CCIPMessageBatchIncompleteError} if not all messages in range could be fetched
      */
     abstract getMessagesInBatch<R extends PickDeep<CCIPRequest, 'lane' | `log.${'topics' | 'address' | 'blockNumber'}` | 'message.sequenceNumber'>>(request: R, commit: Pick<CommitReport, 'minSeqNr' | 'maxSeqNr'>, opts?: {
         page?: number;
@@ -273,6 +364,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @returns version - parsed version of the contract, e.g. `1.6.0`
      * @returns typeAndVersion - original (unparsed) typeAndVersion() string
      * @returns suffix - suffix of the version, if any (e.g. `-dev`)
+     * @throws {@link CCIPTypeVersionInvalidError} if contract doesn't have valid typeAndVersion
      */
     abstract typeAndVersion(address: string): Promise<[type: string, version: string, typeAndVersion: string, suffix?: string]>;
     /**
@@ -364,12 +456,14 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
     /**
      * Fetch TokenAdminRegistry configured in a given OnRamp, Router, etc
      * Needed to map a source token to its dest counterparts
-     * @param onRamp - Some contract for which we can fetch a TokenAdminRegistry
+     * @param address - Some contract for which we can fetch a TokenAdminRegistry (OnRamp, Router, etc.)
+     * @returns TokenAdminRegistry address
      */
     abstract getTokenAdminRegistryFor(address: string): Promise<string>;
     /**
      * Fetch the current fee for a given intended message
      * @param opts - {@link SendMessageOpts} without approveMax
+     * @returns Fee amount in the feeToken's smallest units
      */
     abstract getFee(opts: Omit<SendMessageOpts, 'approveMax'>): Promise<bigint>;
     /**
@@ -385,6 +479,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * Send a CCIP message through a router using provided wallet.
      * @param opts - {@link SendMessageOpts} with chain-specific wallet for signing
      * @returns CCIP request
+     * @throws {@link CCIPWalletNotSignerError} if wallet cannot sign transactions
      *
      * @example
      * ```typescript
@@ -446,6 +541,8 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * })
      * console.log(`Message ID: ${request.message.messageId}`)
      * ```
+     * @throws {@link CCIPWalletNotSignerError} if wallet cannot sign transactions
+     * @throws {@link CCIPExecTxNotConfirmedError} if execution transaction fails to confirm
      */
     abstract executeReport(opts: ExecuteReportOpts & {
         wallet: unknown;
@@ -454,8 +551,9 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * Look for a CommitReport at dest for given CCIP request
      * May be specialized by some subclasses
      * @param opts - getCommitReport options
-     * @returns CCIPCommit info, or reject if none found
-     **/
+     * @returns CCIPCommit info
+     * @throws {@link CCIPCommitNotFoundError} if no commit found for the request
+     */
     getCommitReport({ commitStore, request, ...hints }: {
         /** address of commitStore (OffRamp in \>=v1.6) */
         commitStore: string;
@@ -515,6 +613,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @internal
      * @param tx - transaction hash or transaction object
      * @returns CCIP execution object
+     * @throws {@link CCIPExecTxRevertedError} if no execution receipt found in transaction
      */
     getExecutionReceiptInTx(tx: string | ChainTransaction): Promise<CCIPExecution>;
     /**
@@ -527,31 +626,109 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
         page?: number;
     }): Promise<string[]>;
     /**
-     * Get TokenConfig for a given token address in a TokenAdminRegistry
-     * @param address - TokenAdminRegistry contract address
-     * @param token - Token address
+     * Fetch token configuration from a TokenAdminRegistry.
+     *
+     * @remarks
+     * The TokenAdminRegistry is a contract that tracks token administrators and their
+     * associated pools. Each token has an administrator who can update pool configurations.
+     *
+     * @example Query a token's registry configuration
+     * ```typescript
+     * const config = await chain.getRegistryTokenConfig(registryAddress, tokenAddress)
+     * console.log(`Administrator: ${config.administrator}`)
+     * if (config.tokenPool) {
+     *   console.log(`Pool: ${config.tokenPool}`)
+     * }
+     * ```
+     *
+     * @param registry - TokenAdminRegistry contract address.
+     * @param token - Token address to query.
+     * @returns {@link RegistryTokenConfig} containing administrator and pool information.
+     * @throws {@link CCIPTokenNotInRegistryError} if token is not registered.
      */
-    abstract getRegistryTokenConfig(registry: string, token: string): Promise<{
-        administrator: string;
-        pendingAdministrator?: string;
-        tokenPool?: string;
-    }>;
+    abstract getRegistryTokenConfig(registry: string, token: string): Promise<RegistryTokenConfig>;
     /**
-     * Get TokenPool state and configurations
-     * @param tokenPool - Token pool address
+     * Fetch configuration of a token pool.
+     *
+     * @remarks
+     * Returns the core configuration of a token pool including which token it manages
+     * and which router it's registered with.
+     *
+     * @example Query pool configuration
+     * ```typescript
+     * const config = await chain.getTokenPoolConfig(poolAddress)
+     * console.log(`Manages token: ${config.token}`)
+     * console.log(`Router: ${config.router}`)
+     * if (config.typeAndVersion) {
+     *   console.log(`Version: ${config.typeAndVersion}`)
+     * }
+     * ```
+     *
+     * @param tokenPool - Token pool contract address.
+     * @returns {@link TokenPoolConfig} containing token, router, and version info.
      */
-    abstract getTokenPoolConfigs(tokenPool: string): Promise<{
-        token: string;
-        router: string;
-        typeAndVersion?: string;
-    }>;
+    abstract getTokenPoolConfig(tokenPool: string): Promise<TokenPoolConfig>;
     /**
-     * Get TokenPool remote configurations.
-     * @param tokenPool - Token pool address.
-     * @param remoteChainSelector - If provided, only return remotes for the specified chain (may error if remote not supported).
-     * @returns Record of network names and remote configurations (remoteToken, remotePools, rateLimitStates).
+     * Fetch remote chain configurations for a token pool.
+     *
+     * @remarks
+     * A token pool maintains configurations for each destination chain it supports.
+     * The returned Record maps chain names to their respective configurations.
+     *
+     * @example Get all supported destinations
+     * ```typescript
+     * const remotes = await chain.getTokenPoolRemotes(poolAddress)
+     * // Returns: {
+     * //   "ethereum-mainnet": { remoteToken: "0x...", remotePools: [...], ... },
+     * //   "ethereum-mainnet-arbitrum-1": { remoteToken: "0x...", remotePools: [...], ... },
+     * //   "solana-mainnet": { remoteToken: "...", remotePools: [...], ... }
+     * // }
+     *
+     * // Access a specific chain's config
+     * const arbConfig = remotes['ethereum-mainnet']
+     * console.log(`Remote token: ${arbConfig.remoteToken}`)
+     * ```
+     *
+     * @example Filter to a specific destination
+     * ```typescript
+     * import { networkInfo } from '@chainlink/ccip-sdk'
+     *
+     * const arbitrumSelector = 4949039107694359620n
+     * const remotes = await chain.getTokenPoolRemotes(poolAddress, arbitrumSelector)
+     * // Returns only: { "arbitrum-mainnet": { ... } }
+     *
+     * const chainName = networkInfo(arbitrumSelector).name
+     * const config = remotes[chainName]
+     * ```
+     *
+     * @param tokenPool - Token pool address on the current chain.
+     * @param remoteChainSelector - Optional chain selector to filter results to a single destination.
+     * @returns Record where keys are chain names (e.g., "ethereum-mainnet") and values are {@link TokenPoolRemote} configs.
+     * @throws {@link CCIPTokenPoolChainConfigNotFoundError} if remoteChainSelector is specified but not configured.
      */
     abstract getTokenPoolRemotes(tokenPool: string, remoteChainSelector?: bigint): Promise<Record<string, TokenPoolRemote>>;
+    /**
+     * Fetch remote chain configuration for a token pool for a specific destination.
+     *
+     * @remarks
+     * Convenience wrapper around {@link getTokenPoolRemotes} that returns a single
+     * configuration instead of a Record. Use this when you need configuration for
+     * a specific destination chain.
+     *
+     * @example
+     * ```typescript
+     * const arbitrumSelector = 4949039107694359620n
+     * const remote = await chain.getTokenPoolRemote(poolAddress, arbitrumSelector)
+     * console.log(`Remote token: ${remote.remoteToken}`)
+     * console.log(`Remote pools: ${remote.remotePools.join(', ')}`)
+     * ```
+     *
+     * @param tokenPool - Token pool address on the current chain.
+     * @param remoteChainSelector - Chain selector of the desired remote chain.
+     * @returns TokenPoolRemote config for the specified remote chain.
+     * @throws {@link CCIPTokenPoolChainConfigNotFoundError} if no configuration found for the specified remote chain.
+     */
+    getTokenPoolRemote(tokenPool: string, remoteChainSelector: bigint): Promise<TokenPoolRemote>;
     /**
      * Fetch list and info of supported feeTokens.
      * @param router - Router address on this chain.
@@ -608,6 +785,8 @@ export type ChainStatic<F extends ChainFamily = ChainFamily> = Function & {
         _tag: 'EVMExtraArgsV1';
     }) | (EVMExtraArgsV2 & {
         _tag: 'EVMExtraArgsV2';
+    }) | (GenericExtraArgsV3 & {
+        _tag: 'GenericExtraArgsV3';
     }) | (SVMExtraArgsV1 & {
         _tag: 'SVMExtraArgsV1';
     }) | (SuiExtraArgsV1 & {
@@ -622,7 +801,7 @@ export type ChainStatic<F extends ChainFamily = ChainFamily> = Function & {
      */
     decodeCommits(log: Pick<Log_, 'data'>, lane?: Lane): CommitReport[] | undefined;
     /**
-     * Decode a receipt (ExecutioStateChanged) event
+     * Decode a receipt (ExecutionStateChanged) event
      * @param log - Chain generic log
      * @returns ExecutionReceipt or undefined if not a recognized receipt
      */

package/dist/chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}

package/dist/chain.js

@@ -1,11 +1,27 @@
 import { dataLength } from 'ethers';
 import { CCIPAPIClient } from "./api/index.js";
 import { getCommitReport } from "./commits.js";
-import { CCIPApiClientNotAvailableError, CCIPChainFamilyMismatchError, CCIPExecTxRevertedError, CCIPTransactionNotFinalizedError, } from "./errors/index.js";
+import { CCIPApiClientNotAvailableError, CCIPChainFamilyMismatchError, CCIPExecTxRevertedError, CCIPTokenPoolChainConfigNotFoundError, CCIPTransactionNotFinalizedError, } from "./errors/index.js";
 import { DEFAULT_GAS_LIMIT } from "./evm/const.js";
 import { getMessagesInTx } from "./requests.js";
 import { ExecutionState, } from "./types.js";
-import { util, withRetry } from "./utils.js";
+import { networkInfo, util, withRetry } from "./utils.js";
+/** Field names unique to GenericExtraArgsV3 (not present in V2). */
+const V3_ONLY_FIELDS = [
+    'blockConfirmations',
+    'ccvs',
+    'ccvArgs',
+    'executor',
+    'executorArgs',
+    'tokenReceiver',
+    'tokenArgs',
+];
+/** Check if extraArgs contains any V3-only fields. */
+function hasV3ExtraArgs(extraArgs) {
+    if (!extraArgs)
+        return false;
+    return V3_ONLY_FIELDS.some((field) => field in extraArgs);
+}
 export const DEFAULT_API_RETRY_CONFIG = {
     maxRetries: 3,
     initialDelayMs: 1000,
@@ -28,6 +44,7 @@ export class Chain {
      * Base constructor for Chain class.
      * @param network - NetworkInfo object for the Chain instance
      * @param ctx - Optional context with logger and API client configuration
+     * @throws {@link CCIPChainFamilyMismatchError} if network family doesn't match the Chain subclass
      */
     constructor(network, ctx) {
         const { logger = console, apiClient, apiRetryConfig } = ctx ?? {};
@@ -54,8 +71,10 @@ export class Chain {
         return `${this.constructor.name} { ${this.network.name} }`;
     }
     /**
-     * Confirm a log tx is finalized or wait for it to be finalized
-     * Throws if it isn't included (e.g. a reorg)
+     * Confirm a log tx is finalized or wait for it to be finalized.
+     * @param opts - Options containing the request, finality level, and optional cancel promise
+     * @returns true when the transaction is finalized
+     * @throws {@link CCIPTransactionNotFinalizedError} if the transaction is not included (e.g., due to a reorg)
      */
     async waitFinalized({ request: { log, tx }, finality = 'finalized', cancel$, }) {
         const timestamp = log.tx?.timestamp ?? tx?.timestamp;
@@ -88,7 +107,8 @@ export class Chain {
      * Fetch all CCIP requests in a transaction
      * @param tx - ChainTransaction or txHash to fetch requests from
      * @returns CCIP messages in the transaction (at least one)
-     **/
+     * @throws {@link CCIPMessageNotFoundInTxError} if no CCIP messages found in transaction
+     */
     async getMessagesInTx(tx) {
         const txHash = typeof tx === 'string' ? tx : tx.hash;
         try {
@@ -116,12 +136,31 @@ export class Chain {
         }
     }
     /**
-     * Fetch a message by ID.
-     * Default implementation just tries API.
-     * Children may override to fetch from chain as fallback
-     * @param messageId - message ID to fetch request for
-     * @param _opts - onRamp may be required in some implementations, and throw if missing
-     * @returns CCIPRequest
+     * Fetch a CCIP message by its unique message ID.
+     *
+     * @remarks
+     * Uses the CCIP API to retrieve message details. The returned request includes
+     * a `metadata` field with API-specific information.
+     *
+     * @example
+     * ```typescript
+     * const request = await chain.getMessageById(messageId)
+     * console.log(`Sender: ${request.message.sender}`)
+     *
+     * if (request.metadata) {
+     *   console.log(`Status: ${request.metadata.status}`)
+     *   if (request.metadata.deliveryTime) {
+     *     console.log(`Delivered in ${request.metadata.deliveryTime}ms`)
+     *   }
+     * }
+     * ```
+     *
+     * @param messageId - The unique message ID (0x + 64 hex chars)
+     * @param _opts - Optional: `onRamp` hint for non-EVM chains
+     * @returns CCIPRequest with `metadata` populated from API
+     * @throws {@link CCIPApiClientNotAvailableError} if API disabled
+     * @throws {@link CCIPMessageIdNotFoundError} if message not found
+     * @throws {@link CCIPHttpError} if API request fails
      **/
     async getMessageById(messageId, _opts) {
         if (!this.apiClient)
@@ -136,8 +175,9 @@ export class Chain {
      * Look for a CommitReport at dest for given CCIP request
      * May be specialized by some subclasses
      * @param opts - getCommitReport options
-     * @returns CCIPCommit info, or reject if none found
-     **/
+     * @returns CCIPCommit info
+     * @throws {@link CCIPCommitNotFoundError} if no commit found for the request
+     */
     async getCommitReport({ commitStore, request, ...hints }) {
         return getCommitReport(this, commitStore, request, hints);
     }
@@ -211,6 +251,7 @@ export class Chain {
      * @internal
      * @param tx - transaction hash or transaction object
      * @returns CCIP execution object
+     * @throws {@link CCIPExecTxRevertedError} if no execution receipt found in transaction
      */
     async getExecutionReceiptInTx(tx) {
         if (typeof tx === 'string')
@@ -224,13 +265,62 @@ export class Chain {
         }
         throw new CCIPExecTxRevertedError(tx.hash);
     }
+    /**
+     * Fetch remote chain configuration for a token pool for a specific destination.
+     *
+     * @remarks
+     * Convenience wrapper around {@link getTokenPoolRemotes} that returns a single
+     * configuration instead of a Record. Use this when you need configuration for
+     * a specific destination chain.
+     *
+     * @example
+     * ```typescript
+     * const arbitrumSelector = 4949039107694359620n
+     * const remote = await chain.getTokenPoolRemote(poolAddress, arbitrumSelector)
+     * console.log(`Remote token: ${remote.remoteToken}`)
+     * console.log(`Remote pools: ${remote.remotePools.join(', ')}`)
+     * ```
+     *
+     * @param tokenPool - Token pool address on the current chain.
+     * @param remoteChainSelector - Chain selector of the desired remote chain.
+     * @returns TokenPoolRemote config for the specified remote chain.
+     * @throws {@link CCIPTokenPoolChainConfigNotFoundError} if no configuration found for the specified remote chain.
+     */
+    async getTokenPoolRemote(tokenPool, remoteChainSelector) {
+        const remotes = await this.getTokenPoolRemotes(tokenPool, remoteChainSelector);
+        const network = networkInfo(remoteChainSelector);
+        const remoteConfig = remotes[network.name];
+        if (!remoteConfig) {
+            throw new CCIPTokenPoolChainConfigNotFoundError(tokenPool, tokenPool, network.name);
+        }
+        return remoteConfig;
+    }
     /** {@inheritDoc ChainStatic.buildMessageForDest} */
     static buildMessageForDest(message) {
-        // default to GenericExtraArgsV2, aka EVMExtraArgsV2
+        const gasLimit = message.data && dataLength(message.data) ? DEFAULT_GAS_LIMIT : 0n;
+        // Detect if user wants V3 by checking for any V3-only field
+        if (hasV3ExtraArgs(message.extraArgs)) {
+            // V3 defaults (GenericExtraArgsV3)
+            return {
+                ...message,
+                extraArgs: {
+                    gasLimit,
+                    blockConfirmations: 0,
+                    ccvs: [],
+                    ccvArgs: [],
+                    executor: '',
+                    executorArgs: '0x',
+                    tokenReceiver: '',
+                    tokenArgs: '0x',
+                    ...message.extraArgs,
+                },
+            };
+        }
+        // Default to V2 (GenericExtraArgsV2, aka EVMExtraArgsV2)
         return {
             ...message,
             extraArgs: {
-                gasLimit: message.data && dataLength(message.data) ? DEFAULT_GAS_LIMIT : 0n,
+                gasLimit,
                 allowOutOfOrderExecution: true,
                 ...message.extraArgs,
             },