@chainlink/ccip-sdk 0.92.1 → 0.94.0

package/dist/chain.d.ts

@@ -1,13 +1,49 @@
-import type { BytesLike } from 'ethers';
+import { type BytesLike } from 'ethers';
 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 { LeafHasher } from './hasher/common.ts';
 import type { UnsignedSolanaTx } from './solana/types.ts';
 import type { UnsignedTONTx } from './ton/types.ts';
-import { type AnyMessage, type CCIPCommit, type CCIPExecution, type CCIPMessage, type CCIPRequest, type ChainFamily, type ChainTransaction, type CommitReport, type ExecutionReceipt, type ExecutionReport, type Lane, type Log_, type Logger, type NetworkInfo, type OffchainTokenData, type WithLogger } from './types.ts';
+import { type AnyMessage, type CCIPCommit, type CCIPExecution, type CCIPMessage, type CCIPRequest, type ChainFamily, type ChainTransaction, type CommitReport, type ExecutionReceipt, type ExecutionReport, type Lane, type Log_, type Logger, type NetworkInfo, type OffchainTokenData, type MessageInput, type WithLogger } from './types.ts';
 import { util } from './utils.ts';
+/**
+ * Context for Chain class initialization.
+ * Extends WithLogger with optional API client configuration.
+ *
+ * @example Default behavior (auto-create API client)
+ * ```typescript
+ * const chain = await EVMChain.fromUrl(rpcUrl, { logger })
+ * await chain.getLaneLatency(destSelector) // Works - uses production API
+ * ```
+ *
+ * @example Custom API endpoint
+ * ```typescript
+ * const api = new CCIPAPIClient('https://staging-api.example.com', { logger })
+ * const chain = await EVMChain.fromUrl(rpcUrl, { apiClient: api, logger })
+ * ```
+ *
+ * @example Explicit opt-out (decentralized mode)
+ * ```typescript
+ * const chain = await EVMChain.fromUrl(rpcUrl, { apiClient: null, logger })
+ * await chain.getLaneLatency(destSelector) // Throws CCIPApiClientNotAvailableError
+ * ```
+ */
+export type ChainContext = WithLogger & {
+    /**
+     * CCIP API client instance for lane information queries.
+     *
+     * - `undefined` (default): Creates CCIPAPIClient with production endpoint
+     *   (https://api.ccip.chain.link)
+     * - `CCIPAPIClient`: Uses provided instance (allows custom URL, fetch, etc.)
+     * - `null`: Disables API client entirely (getLaneLatency() will throw)
+     *
+     * Default: `undefined` (auto-create with production endpoint)
+     */
+    apiClient?: CCIPAPIClient | null;
+};
 /**
  * Filter options for getLogs queries across chains.
  */
@@ -77,6 +113,36 @@ export type UnsignedTx = {
     [ChainFamily.TON]: UnsignedTONTx;
     [ChainFamily.Sui]: never;
 };
+/**
+ * Common options for [[getFee]], [[generateUnsignedSendMessage]] and [[sendMessage]] Chain methods
+ */
+export type SendMessageOpts = {
+    /** Router address on this chain */
+    router: string;
+    /** Destination network selector. */
+    destChainSelector: bigint;
+    /** Message to send. If `fee` is omitted, it'll be calculated */
+    message: MessageInput;
+    /** Approve the maximum amount of tokens to transfer */
+    approveMax?: boolean;
+};
+/**
+ * Common options for [[generateUnsignedExecuteReport]] and [[executeReport]] Chain methods
+ */
+export type ExecuteReportOpts = {
+    /** address of the OffRamp contract */
+    offRamp: string;
+    /** execution report */
+    execReport: ExecutionReport;
+    /** gasLimit or computeUnits limit override for the ccipReceive call */
+    gasLimit?: number;
+    /** For EVM, overrides gasLimit on tokenPool call */
+    tokensGasLimit?: number;
+    /** For Solana, send report in chunks to OffRamp, to later execute */
+    forceBuffer?: boolean;
+    /** For Solana, create and extend addresses in a lookup table before executing */
+    forceLookupTable?: boolean;
+};
 /**
  * Works like an interface for a base Chain class, but provides implementation (which can be
  * specialized) for some basic methods
@@ -86,11 +152,14 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
     [util.inspect.custom]: () => string;
     readonly network: NetworkInfo<F>;
     logger: Logger;
+    /** CCIP API client (null if opted out) */
+    readonly apiClient: CCIPAPIClient | null;
     /**
      * Base constructor for Chain class.
      * @param network - NetworkInfo object for the Chain instance
+     * @param ctx - Optional context with logger and API client configuration
      */
-    constructor(network: NetworkInfo, { logger }?: WithLogger);
+    constructor(network: NetworkInfo, ctx?: ChainContext);
     /** Cleanup method to release resources (e.g., close connections). */
     destroy?(): void | Promise<void>;
     /**
@@ -109,14 +178,21 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * Confirm a log tx is finalized or wait for it to be finalized
      * Throws if it isn't included (e.g. a reorg)
      */
-    waitFinalized({ log, tx, }: SetOptional<PickDeep<CCIPRequest, `log.${'address' | 'blockNumber' | 'transactionHash' | 'topics' | 'tx.timestamp'}` | 'tx.timestamp'>, 'tx'>, finality?: number | 'finalized', cancel$?: Promise<unknown>): Promise<true>;
+    waitFinalized({ request: { log, tx }, finality, cancel$, }: {
+        request: SetOptional<PickDeep<CCIPRequest, `log.${'address' | 'blockNumber' | 'transactionHash' | 'topics' | 'tx.timestamp'}` | 'tx.timestamp'>, 'tx'>;
+        finality?: number | 'finalized';
+        cancel$?: Promise<unknown>;
+    }): Promise<true>;
     /**
      * An async generator that yields logs based on the provided options.
      * @param opts - Options object containing:
      *   - `startBlock`: if provided, fetch and generate logs forward starting from this block;
-     *     otherwise, returns logs backwards in time from endBlock;
-     *     optionally, startTime may be provided to fetch logs forward starting from this time
-     *   - `endBlock`: if omitted, use latest block
+     *        otherwise, returns logs backwards in time from endBlock;
+     *        optionally, startTime may be provided to fetch logs forward starting from this time
+     *   - `startTime`: instead of a startBlock, a start timestamp may be provided;
+     *        if either is provided, fetch logs forward from this starting point; otherwise, backwards
+     *   - `endBlock`: if omitted, use latest block; can be a block number, 'latest', 'finalized' or
+     *        negative finality block depth
      *   - `endBefore`: optional hint signature for end of iteration, instead of endBlock
      *   - `address`: if provided, fetch logs for this address only (may be required in some
      *     networks/implementations)
@@ -125,6 +201,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      *     some networks/implementations may not be able to filter topics other than topic0s, so one may
      *     want to assume those are optimization hints, instead of hard filters, and verify results
      *   - `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.
      */
     abstract getLogs(opts: LogFilter): AsyncIterableIterator<Log_>;
@@ -133,14 +210,14 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @param tx - ChainTransaction or txHash to fetch requests from
      * @returns CCIP messages in the transaction (at least one)
      **/
-    abstract fetchRequestsInTx(tx: string | ChainTransaction): Promise<CCIPRequest[]>;
+    abstract getMessagesInTx(tx: string | ChainTransaction): Promise<CCIPRequest[]>;
     /**
      * Scan for a CCIP request by message ID
      * @param messageId - message ID to fetch request for
      * @param onRamp - address may be required in some implementations, and throw if missing
      * @returns CCIPRequest
      **/
-    fetchRequestById?(messageId: string, onRamp?: string, opts?: {
+    getMessageById?(messageId: string, onRamp?: string, opts?: {
         page?: number;
     }): Promise<CCIPRequest>;
     /**
@@ -149,7 +226,7 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @param commit - CommitReport range (min, max).
      * @param opts - Optional parameters (e.g., `page` for pagination width).
      */
-    abstract fetchAllMessagesInBatch<R extends PickDeep<CCIPRequest, 'lane' | `log.${'topics' | 'address' | 'blockNumber'}` | 'message.sequenceNumber'>>(request: R, commit: Pick<CommitReport, 'minSeqNr' | 'maxSeqNr'>, opts?: {
+    abstract getMessagesInBatch<R extends PickDeep<CCIPRequest, 'lane' | `log.${'topics' | 'address' | 'blockNumber'}` | 'message.sequenceNumber'>>(request: R, commit: Pick<CommitReport, 'minSeqNr' | 'maxSeqNr'>, opts?: {
         page?: number;
     }): Promise<R['message'][]>;
     /**
@@ -232,99 +309,154 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
     abstract getTokenAdminRegistryFor(address: string): Promise<string>;
     /**
      * Fetch the current fee for a given intended message
-     * @param router - router address on this chain
-     * @param destChainSelector - dest network selector
-     * @param message - message to send
+     * @param opts - {@link SendMessageOpts} without approveMax
      */
-    abstract getFee(router: string, destChainSelector: bigint, message: AnyMessage): Promise<bigint>;
+    abstract getFee(opts: Omit<SendMessageOpts, 'approveMax'>): Promise<bigint>;
     /**
      * Generate unsigned txs for ccipSend'ing a message
-     * @param sender - sender address
-     * @param router - address of the Router contract
-     * @param destChainSelector - chainSelector of destination chain
-     * @param message - AnyMessage to send; if `fee` is not present, it'll be calculated
-     * @param approveMax - if tokens approvals are needed, opt into approving maximum allowance
+     * @param opts - {@link SendMessageOpts} with sender address
      * @returns chain-family specific unsigned txs
      */
-    abstract generateUnsignedSendMessage(sender: string, router: string, destChainSelector: bigint, message: AnyMessage & {
-        fee?: bigint;
-    }, opts?: {
-        approveMax?: boolean;
+    abstract generateUnsignedSendMessage(opts: SendMessageOpts & {
+        /** Sender address (address of wallet which will send the message) */
+        sender: string;
     }): Promise<UnsignedTx[F]>;
     /**
      * Send a CCIP message through a router using provided wallet.
-     * @param router - Router address on this chain.
-     * @param destChainSelector - Destination network selector.
-     * @param message - Message to send.
-     * @param opts - Optional parameters:
-     *   - `wallet`: cli or environmental parameters to help pick a wallet
-     *   - `approveMax`: approve the maximum amount of tokens to transfer
-     */
-    abstract sendMessage(router: string, destChainSelector: bigint, message: AnyMessage & {
-        fee?: bigint;
-    }, opts: {
+     * @param opts - {@link SendMessageOpts} with chain-specific wallet for signing
+     * @returns CCIP request
+     *
+     * @example
+     * ```typescript
+     * const request = await chain.sendMessage({
+     *   router: '0x...',
+     *   destChainSelector: 4949039107694359620n,
+     *   message: {
+     *     receiver: '0x...',
+     *     data: '0x1337',
+     *     tokenAmounts: [{ token: '0x...', amount: 100n }],
+     *     feeToken: '0xLinkToken',
+     *   },
+     *   wallet: signer,
+     * })
+     * console.log(`Message ID: ${request.message.messageId}`)
+     * ```
+     */
+    abstract sendMessage(opts: SendMessageOpts & {
+        /** Signer instance (chain-dependent) */
         wallet: unknown;
-        approveMax?: boolean;
     }): Promise<CCIPRequest>;
     /**
      * Fetch supported offchain token data for a request from this network
      * @param request - CCIP request, with tx, logs and message
      * @returns array with one offchain token data for each token transfer in request
      */
-    abstract fetchOffchainTokenData(request: CCIPRequest): Promise<OffchainTokenData[]>;
+    abstract getOffchainTokenData(request: CCIPRequest): Promise<OffchainTokenData[]>;
     /**
      * Generate unsigned tx to manuallyExecute a message
-     * @param payer - address which will be used to transmit the report tx
-     * @param offRamp - address of the OffRamp contract
-     * @param execReport - execution report
-     * @param gasLimit - gasLimit or computeUnits limit override for the ccipReceive call
-     * @param tokensGasLimit - For EVM, overrides gasLimit on tokenpPool call
-     * @param forceBuffer - For Solana, send report in chunks to OffRamp, to later execute
-     * @param forceLookupTable - For Solana, create and extend addresses in a lookup table before executing
+     * @param opts - {@link ExecuteReportOpts} with payer address which will send the exec tx
      * @returns chain-family specific unsigned txs
      */
-    abstract generateUnsignedExecuteReport(payer: string, offRamp: string, execReport: ExecutionReport, opts: {
-        gasLimit?: number;
-        tokensGasLimit?: number;
-        forceBuffer?: boolean;
-        forceLookupTable?: boolean;
+    abstract generateUnsignedExecuteReport(opts: ExecuteReportOpts & {
+        /** address which will be used to send the report tx */
+        payer: string;
     }): Promise<UnsignedTx[F]>;
     /**
      * Execute messages in report in an offRamp
-     * @param offRamp - offRamp address on this dest chain
-     * @param execReport - execution report containing messages to execute, proofs and offchainTokenData
-     * @param opts - general options for execution (see [[generateUnsignedExecuteReport]])
-     * @param wallet - chain-specific wallet or signer instance, to sign transactions
+     * @param opts - {@link ExecuteReportOpts} with chain-specific wallet to sign and send tx
      * @returns transaction of the execution
-     */
-    abstract executeReport(offRamp: string, execReport: ExecutionReport, opts: {
+     *
+     * @example
+     * ```typescript
+     * const execReportProof = calculateManualExecProof(
+     *   messagesInBatch: await source.getMessagesInBatch(request, commit.report),
+     *   request.lane,
+     *   request.message.messageId,
+     *   commit.report.merkleRoot,
+     *   dest,
+     * )
+     * const receipt = await dest.executeReport({
+     *   offRamp,
+     *   execReport: {
+     *     ...execReportProof,
+     *     message: request.message,
+     *     offchainTokenData: await source.getOffchainTokenData(request),
+     *   },
+     *   wallet,
+     * })
+     * console.log(`Message ID: ${request.message.messageId}`)
+     * ```
+     */
+    abstract executeReport(opts: ExecuteReportOpts & {
         wallet: unknown;
-        gasLimit?: number;
-        tokensGasLimit?: number;
-        forceBuffer?: boolean;
-        forceLookupTable?: boolean;
-    }): Promise<ChainTransaction>;
+    }): Promise<CCIPExecution>;
     /**
      * Look for a CommitReport at dest for given CCIP request
      * May be specialized by some subclasses
-     *
-     * @param commitStore - Commit store address
-     * @param request - CCIPRequest to get commit info for
-     * @param hints - Additional filtering hints
+     * @param opts - getCommitReport options
      * @returns CCIPCommit info, or reject if none found
      **/
-    fetchCommitReport(commitStore: string, request: PickDeep<CCIPRequest, 'lane' | 'message.sequenceNumber' | 'tx.timestamp'>, hints?: Pick<LogFilter, 'page' | 'watch'> & {
-        startBlock?: number;
-    }): Promise<CCIPCommit>;
-    /**
-     * Default/generic implementation of fetchExecutionReceipts
-     * @param offRamp - Off-ramp address
-     * @param request - CCIPRequest to get execution receipts for
-     * @param commit - CCIPCommit info to help narrowing search for executions
-     * @param hints - Additional filtering hints
+    getCommitReport({ commitStore, request, ...hints }: {
+        /** address of commitStore (OffRamp in \>=v1.6) */
+        commitStore: string;
+        /** CCIPRequest subset object */
+        request: PickDeep<CCIPRequest, 'lane' | 'message.sequenceNumber' | 'tx.timestamp'>;
+    } & Pick<LogFilter, 'page' | 'watch' | 'startBlock'>): Promise<CCIPCommit>;
+    /**
+     * Fetches estimated lane latency to a destination chain.
+     * Uses this chain's selector as the source.
+     *
+     * @param destChainSelector - Destination CCIP chain selector (bigint)
+     * @returns Promise resolving to {@link LaneLatencyResponse} containing:
+     *   - `lane.sourceNetworkInfo` - Source chain metadata (name, selector, chainId)
+     *   - `lane.destNetworkInfo` - Destination chain metadata
+     *   - `lane.routerAddress` - Router contract address on source chain
+     *   - `totalMs` - Estimated delivery time in milliseconds
+     *
+     * @throws {@link CCIPApiClientNotAvailableError} if apiClient was disabled (set to `null`)
+     * @throws {@link CCIPHttpError} if API request fails (network error, 4xx, 5xx status)
+     *
+     * @remarks
+     * Each call makes a fresh API request. Consider caching results if making
+     * frequent calls for the same lane.
+     *
+     * @example Get estimated delivery time
+     * ```typescript
+     * const chain = await EVMChain.fromUrl('https://eth-mainnet.example.com')
+     * try {
+     *   const latency = await chain.getLaneLatency(4949039107694359620n) // Arbitrum
+     *   console.log(`Estimated delivery: ${Math.round(latency.totalMs / 60000)} minutes`)
+     *   console.log(`Router: ${latency.lane.routerAddress}`)
+     * } catch (err) {
+     *   if (err instanceof CCIPHttpError) {
+     *     console.error(`API error: ${err.context.apiErrorCode}`)
+     *   }
+     * }
+     * ```
+     */
+    getLaneLatency(destChainSelector: bigint): Promise<LaneLatencyResponse>;
+    /**
+     * Default/generic implementation of getExecutionReceipts
+     * @param opts - getExecutionReceipts options
      * @returns Async generator of CCIPExecution receipts
      */
-    fetchExecutionReceipts(offRamp: string, request: PickDeep<CCIPRequest, 'lane' | 'message.messageId' | 'tx.timestamp'>, commit?: CCIPCommit, hints?: Pick<LogFilter, 'page' | 'watch'>): AsyncIterableIterator<CCIPExecution>;
+    getExecutionReceipts({ offRamp, messageId, sourceChainSelector, commit, ...hints }: {
+        /** address of OffRamp contract */
+        offRamp: string;
+        /** filter: yield only executions for this message */
+        messageId?: string;
+        /** filter: yield only executions for this source chain */
+        sourceChainSelector?: bigint;
+        /** optional commit associated with the request, can be used for optimizations in some families */
+        commit?: CCIPCommit;
+    } & Pick<LogFilter, 'page' | 'watch' | 'startBlock' | 'startTime'>): AsyncIterableIterator<CCIPExecution>;
+    /**
+     * Fetch first execution receipt inside a transaction.
+     * @internal
+     * @param tx - transaction hash or transaction object
+     * @returns CCIP execution object
+     */
+    getExecutionReceiptInTx(tx: string | ChainTransaction): Promise<CCIPExecution>;
     /**
      * List tokens supported by given TokenAdminRegistry contract.
      * @param address - Usually TokenAdminRegistry, but chain may support receiving Router, OnRamp, etc.
@@ -366,6 +498,8 @@ export declare abstract class Chain<F extends ChainFamily = ChainFamily> {
      * @returns Mapping of token addresses to respective TokenInfo objects.
      */
     abstract getFeeTokens(router: string): Promise<Record<string, TokenInfo>>;
+    /** {@inheritDoc ChainStatic.buildMessageForDest} */
+    static buildMessageForDest(message: Parameters<ChainStatic['buildMessageForDest']>[0]): AnyMessage;
 }
 /** Static methods and properties available on Chain class constructors. */
 export type ChainStatic<F extends ChainFamily = ChainFamily> = Function & {
@@ -374,8 +508,9 @@ export type ChainStatic<F extends ChainFamily = ChainFamily> = Function & {
     /**
      * async constructor: builds a Chain from a rpc endpoint url
      * @param url - rpc endpoint url
+     * @param ctx - optional context with logger and API client configuration
      */
-    fromUrl(url: string, ctx?: WithLogger): Promise<Chain<F>>;
+    fromUrl(url: string, ctx?: ChainContext): Promise<Chain<F>>;
     /**
      * Try to decode a CCIP message *from* a log/event *originated* from this *source* chain,
      * but which may *target* other dest chain families
@@ -449,6 +584,13 @@ export type ChainStatic<F extends ChainFamily = ChainFamily> = Function & {
      * @returns Ordered record with messages/properties, or undefined if not a recognized error
      */
     parse?(data: unknown): Record<string, unknown> | undefined | null;
+    /**
+     * Returns a copy of a message, populating missing fields like `extraArgs` with defaults
+     * It's expected to return a message suitable at least for basic token transfers
+     * @param message - AnyMessage (from source), containing at least `receiver`
+     * @returns A message suitable for `sendMessage` to this destination chain family
+     */
+    buildMessageForDest(message: MessageInput): AnyMessage;
 };
 /** Function type for getting a Chain instance by ID, selector, or name. */
 export type ChainGetter = (idOrSelectorOrName: number | string | bigint) => Promise<Chain>;

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":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,QAAQ,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEtD,OAAO,EAAE,KAAK,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AASvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IACtC;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CACjC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IAC1C,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAA;IACrC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,IAAI,CAAA;AAER;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,oEAAoE;IACpE,uBAAuB,EAAE,gBAAgB,CAAA;IACzC,iEAAiE;IACjE,wBAAwB,EAAE,gBAAgB,CAAA;CAC3C,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAA;IAChC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACtC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,eAAe,CAAA;IACpC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAA;IAChC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAA;IACzB,gEAAgE;IAChE,OAAO,EAAE,YAAY,CAAA;IACrB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,UAAU,EAAE,eAAe,CAAA;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED;;;GAGG;AACH,8BAAsB,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAoC7D,iDAAiD;IACjD,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IApCrB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAA;IAExC;;;;OAIG;gBACS,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,YAAY;IAsBpD,qEAAqE;IACrE,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAChE;;;OAGG;IACG,aAAa,CAAC,EAClB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EACpB,QAAsB,EACtB,OAAO,GACR,EAAE;QACD,OAAO,EAAE,WAAW,CAClB,QAAQ,CACN,WAAW,EACT,OAAO,SAAS,GAAG,aAAa,GAAG,iBAAiB,GAAG,QAAQ,GAAG,cAAc,EAAE,GAClF,cAAc,CACjB,EACD,IAAI,CACL,CAAA;QACD,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;QAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAE9D;;;;QAII;IACJ,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE/E;;;;;QAKI;IACJ,cAAc,CAAC,CACb,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,WAAW,CAAC;IAEvB;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CACzB,CAAC,SAAS,QAAQ,CAChB,WAAW,EACX,MAAM,GAAG,OAAO,QAAQ,GAAG,SAAS,GAAG,aAAa,EAAE,GAAG,wBAAwB,CAClF,EAED,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC,EACnD,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAEpF;;;;;;OAMG;IACH,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3F;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjE;;;;;;OAMG;IACH,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC7F;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF;;;;;;OAMG;IACH,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3F;;;;;OAKG;IACH,QAAQ,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACnE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3E;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,CAClC,IAAI,EAAE,eAAe,GAAG;QACtB,qEAAqE;QACrE,MAAM,EAAE,MAAM,CAAA;KACf,GACA,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,WAAW,CAClB,IAAI,EAAE,eAAe,GAAG;QACtB,wCAAwC;QACxC,MAAM,EAAE,OAAO,CAAA;KAChB,GACA,OAAO,CAAC,WAAW,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IACjF;;;;OAIG;IACH,QAAQ,CAAC,6BAA6B,CACpC,IAAI,EAAE,iBAAiB,GAAG;QACxB,uDAAuD;QACvD,KAAK,EAAE,MAAM,CAAA;KACd,GACA,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,aAAa,CACpB,IAAI,EAAE,iBAAiB,GAAG;QAExB,MAAM,EAAE,OAAO,CAAA;KAChB,GACA,OAAO,CAAC,aAAa,CAAC;IAEzB;;;;;QAKI;IACE,eAAe,CAAC,EACpB,WAAW,EACX,OAAO,EACP,GAAG,KAAK,EACT,EAAE;QACD,kDAAkD;QAClD,WAAW,EAAE,MAAM,CAAA;QACnB,gCAAgC;QAChC,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,wBAAwB,GAAG,cAAc,CAAC,CAAA;KACnF,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO7E;;;;OAIG;IACI,oBAAoB,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,mBAAmB,EACnB,MAAM,EACN,GAAG,KAAK,EACT,EAAE;QACD,kCAAkC;QAClC,OAAO,EAAE,MAAM,CAAA;QACf,qDAAqD;QACrD,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,0DAA0D;QAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,kGAAkG;QAClG,MAAM,CAAC,EAAE,UAAU,CAAA;KACpB,GAAG,IAAI,CACN,SAAS,EACT,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,CAC9C,GAAG,qBAAqB,CAAC,aAAa,CAAC;IAyBxC;;;;;OAKG;IACG,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAYpF;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEzF;;;;OAIG;IACH,QAAQ,CAAC,sBAAsB,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QACT,aAAa,EAAE,MAAM,CAAA;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC;IAEF;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACvD,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAC1B,SAAS,EAAE,MAAM,EACjB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEzE,oDAAoD;IACpD,MAAM,CAAC,mBAAmB,CACxB,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,GACzD,UAAU;CAWd;AAED,2EAA2E;AAE3E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,QAAQ,GAAG;IACxE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D;;;;;;;OAOG;IACH,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,SAAS,CAAA;IAC/D;;;;OAIG;IACH,eAAe,CACb,SAAS,EAAE,SAAS,GAElB,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC7C,SAAS,CAAA;IACb,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAAA;IAC7C;;;;;OAKG;IACH,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE,GAAG,SAAS,CAAA;IAC/E;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAAA;IACpE;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAA;IACjC;;;;;OAKG;IACH,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACvC;;;;OAIG;IACH,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACnC;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;IAC3D;;;;OAIG;IACH,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAA;IACjE;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAAA;CACvD,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA"}

package/dist/chain.js

@@ -1,5 +1,8 @@
-import { fetchCommitReport } from "./commits.js";
-import { CCIPChainFamilyMismatchError, CCIPTransactionNotFinalizedError } from "./errors/index.js";
+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 { DEFAULT_GAS_LIMIT } from "./evm/const.js";
 import { ExecutionState, } from "./types.js";
 import { util } from "./utils.js";
 /**
@@ -9,15 +12,29 @@ import { util } from "./utils.js";
 export class Chain {
     network;
     logger;
+    /** CCIP API client (null if opted out) */
+    apiClient;
     /**
      * Base constructor for Chain class.
      * @param network - NetworkInfo object for the Chain instance
+     * @param ctx - Optional context with logger and API client configuration
      */
-    constructor(network, { logger = console } = {}) {
+    constructor(network, ctx) {
+        const { logger = console, apiClient } = ctx ?? {};
         if (network.family !== this.constructor.family)
             throw new CCIPChainFamilyMismatchError(this.constructor.name, this.constructor.family, network.family);
         this.network = network;
         this.logger = logger;
+        // API client initialization: default enabled, null = explicit opt-out
+        if (apiClient === null) {
+            this.apiClient = null; // Explicit opt-out
+        }
+        else if (apiClient !== undefined) {
+            this.apiClient = apiClient; // Use provided instance
+        }
+        else {
+            this.apiClient = new CCIPAPIClient(undefined, { logger }); // Default
+        }
     }
     /** Custom inspector for Node.js util.inspect. */
     [util.inspect.custom]() {
@@ -27,7 +44,7 @@ export class Chain {
      * Confirm a log tx is finalized or wait for it to be finalized
      * Throws if it isn't included (e.g. a reorg)
      */
-    async waitFinalized({ log, tx, }, finality = 'finalized', cancel$) {
+    async waitFinalized({ request: { log, tx }, finality = 'finalized', cancel$, }) {
         const timestamp = log.tx?.timestamp ?? tx?.timestamp;
         if (!timestamp || Date.now() / 1e3 - timestamp > 60) {
             // only try to fetch tx if request is old enough (>60s)
@@ -57,34 +74,70 @@ export class Chain {
     /**
      * Look for a CommitReport at dest for given CCIP request
      * May be specialized by some subclasses
-     *
-     * @param commitStore - Commit store address
-     * @param request - CCIPRequest to get commit info for
-     * @param hints - Additional filtering hints
+     * @param opts - getCommitReport options
      * @returns CCIPCommit info, or reject if none found
      **/
-    async fetchCommitReport(commitStore, request, hints) {
-        return fetchCommitReport(this, commitStore, request, hints);
+    async getCommitReport({ commitStore, request, ...hints }) {
+        return getCommitReport(this, commitStore, request, hints);
+    }
+    /**
+     * Fetches estimated lane latency to a destination chain.
+     * Uses this chain's selector as the source.
+     *
+     * @param destChainSelector - Destination CCIP chain selector (bigint)
+     * @returns Promise resolving to {@link LaneLatencyResponse} containing:
+     *   - `lane.sourceNetworkInfo` - Source chain metadata (name, selector, chainId)
+     *   - `lane.destNetworkInfo` - Destination chain metadata
+     *   - `lane.routerAddress` - Router contract address on source chain
+     *   - `totalMs` - Estimated delivery time in milliseconds
+     *
+     * @throws {@link CCIPApiClientNotAvailableError} if apiClient was disabled (set to `null`)
+     * @throws {@link CCIPHttpError} if API request fails (network error, 4xx, 5xx status)
+     *
+     * @remarks
+     * Each call makes a fresh API request. Consider caching results if making
+     * frequent calls for the same lane.
+     *
+     * @example Get estimated delivery time
+     * ```typescript
+     * const chain = await EVMChain.fromUrl('https://eth-mainnet.example.com')
+     * try {
+     *   const latency = await chain.getLaneLatency(4949039107694359620n) // Arbitrum
+     *   console.log(`Estimated delivery: ${Math.round(latency.totalMs / 60000)} minutes`)
+     *   console.log(`Router: ${latency.lane.routerAddress}`)
+     * } catch (err) {
+     *   if (err instanceof CCIPHttpError) {
+     *     console.error(`API error: ${err.context.apiErrorCode}`)
+     *   }
+     * }
+     * ```
+     */
+    async getLaneLatency(destChainSelector) {
+        if (!this.apiClient) {
+            throw new CCIPApiClientNotAvailableError();
+        }
+        return this.apiClient.getLaneLatency(this.network.chainSelector, destChainSelector);
     }
     /**
-     * Default/generic implementation of fetchExecutionReceipts
-     * @param offRamp - Off-ramp address
-     * @param request - CCIPRequest to get execution receipts for
-     * @param commit - CCIPCommit info to help narrowing search for executions
-     * @param hints - Additional filtering hints
+     * Default/generic implementation of getExecutionReceipts
+     * @param opts - getExecutionReceipts options
      * @returns Async generator of CCIPExecution receipts
      */
-    async *fetchExecutionReceipts(offRamp, request, commit, hints) {
-        const onlyLast = !commit?.log.blockNumber && !request.tx.timestamp; // backwards
+    async *getExecutionReceipts({ offRamp, messageId, sourceChainSelector, commit, ...hints }) {
+        hints.startBlock ??= commit?.log.blockNumber;
+        const onlyLast = !hints.startTime && !hints.startBlock; // backwards
         for await (const log of this.getLogs({
-            startBlock: commit?.log.blockNumber,
-            startTime: request.tx.timestamp,
             address: offRamp,
             topics: ['ExecutionStateChanged'],
             ...hints,
         })) {
             const receipt = this.constructor.decodeReceipt(log);
-            if (!receipt || receipt.messageId !== request.message.messageId)
+            // filters
+            if (!receipt ||
+                (messageId && receipt.messageId !== messageId) ||
+                (sourceChainSelector &&
+                    receipt.sourceChainSelector &&
+                    receipt.sourceChainSelector !== sourceChainSelector))
                 continue;
             const timestamp = log.tx?.timestamp ?? (await this.getBlockTimestamp(log.blockNumber));
             yield { receipt, log, timestamp };
@@ -92,5 +145,35 @@ export class Chain {
                 break;
         }
     }
+    /**
+     * Fetch first execution receipt inside a transaction.
+     * @internal
+     * @param tx - transaction hash or transaction object
+     * @returns CCIP execution object
+     */
+    async getExecutionReceiptInTx(tx) {
+        if (typeof tx === 'string')
+            tx = await this.getTransaction(tx);
+        for (const log of tx.logs) {
+            const rcpt = this.constructor.decodeReceipt(log);
+            if (!rcpt)
+                continue;
+            const timestamp = tx.timestamp;
+            return { receipt: rcpt, log, timestamp };
+        }
+        throw new CCIPExecTxRevertedError(tx.hash);
+    }
+    /** {@inheritDoc ChainStatic.buildMessageForDest} */
+    static buildMessageForDest(message) {
+        // default to GenericExtraArgsV2, aka EVMExtraArgsV2
+        return {
+            ...message,
+            extraArgs: {
+                gasLimit: message.data && dataLength(message.data) ? DEFAULT_GAS_LIMIT : 0n,
+                allowOutOfOrderExecution: true,
+                ...message.extraArgs,
+            },
+        };
+    }
 }
 //# sourceMappingURL=chain.js.map