@chainlink/ccip-sdk 0.90.2 → 0.91.0

package/dist/execution.d.ts

@@ -1,80 +1,37 @@
-import moize from 'moize';
 import type { Chain } from './chain.ts';
-import { type CCIPExecution, type CCIPMessage, type CCIPVersion, type CommitReport, type ExecutionReport, type Lane } from './types.ts';
+import { type CCIPCommit, type CCIPExecution, type CCIPMessage, type CCIPRequest, type CCIPVersion, type ExecutionReport, type Lane, type WithLogger } from './types.ts';
 /**
  * Pure/sync function to calculate/generate OffRamp.executeManually report for messageIds
  *
  * @param messagesInBatch - Array containing all messages in batch, ordered
- * @param lane - Arguments for leafeHasher (lane info)
- * @param messageIds - list of messages (from batch) to prove for manual execution
+ * @param lane - Arguments for leafHasher (lane info)
+ * @param messageId - Message ID to prove for manual execution
  * @param merkleRoot - Optional merkleRoot of the CommitReport, for validation
+ * @param ctx - Context for logging
  * @returns ManualExec report arguments
  **/
-export declare function calculateManualExecProof<V extends CCIPVersion = CCIPVersion>(messagesInBatch: readonly CCIPMessage<V>[], lane: Lane<V>, messageId: string, merkleRoot?: string): Omit<ExecutionReport, 'offchainTokenData' | 'message'>;
-export declare const discoverOffRamp: moize.Moized<(source: Chain, dest: Chain, onRamp: string) => Promise<string>, Partial<{
-    isDeepEqual: boolean;
-    isPromise: boolean;
-    isReact: boolean;
-    isSerialized: boolean;
-    isShallowEqual: boolean;
-    matchesArg: moize.IsEqual;
-    matchesKey: moize.IsMatchingKey;
-    maxAge: number;
-    maxArgs: number;
-    maxSize: number;
-    onCacheAdd: moize.OnCacheOperation<(source: Chain, dest: Chain, onRamp: string) => Promise<string>>;
-    onCacheChange: moize.OnCacheOperation<(source: Chain, dest: Chain, onRamp: string) => Promise<string>>;
-    onCacheHit: moize.OnCacheOperation<(source: Chain, dest: Chain, onRamp: string) => Promise<string>>;
-    onExpire: moize.OnExpire;
-    profileName: string;
-    serializer: moize.Serialize;
-    transformArgs: moize.TransformKey;
-    updateCacheForKey: moize.UpdateCacheForKey;
-    updateExpire: boolean;
-}> & Partial<{
-    isDeepEqual: boolean;
-    isPromise: boolean;
-    isReact: boolean;
-    isSerialized: boolean;
-    isShallowEqual: boolean;
-    matchesArg: moize.IsEqual;
-    matchesKey: moize.IsMatchingKey;
-    maxAge: number;
-    maxArgs: number;
-    maxSize: number;
-    onCacheAdd: moize.OnCacheOperation<moize.Moizeable>;
-    onCacheChange: moize.OnCacheOperation<moize.Moizeable>;
-    onCacheHit: moize.OnCacheOperation<moize.Moizeable>;
-    onExpire: moize.OnExpire;
-    profileName: string;
-    serializer: moize.Serialize;
-    transformArgs: moize.TransformKey;
-    updateCacheForKey: moize.UpdateCacheForKey;
-    updateExpire: boolean;
-}> & {
-    transformArgs: ([source, dest, onRamp]: moize.Key<any>) => (string | bigint)[];
+export declare function calculateManualExecProof<V extends CCIPVersion = CCIPVersion>(messagesInBatch: readonly CCIPMessage<V>[], lane: Lane<V>, messageId: string, merkleRoot?: string, ctx?: WithLogger): Omit<ExecutionReport, 'offchainTokenData' | 'message'>;
+export declare const discoverOffRamp: import("micro-memoize").Memoized<(source: Chain, dest: Chain, onRamp: string, { logger }?: WithLogger) => Promise<string>, {
+    transformKey: ([source, dest, onRamp]: [source: Chain<import("./types.ts").ChainFamily>, dest: Chain<import("./types.ts").ChainFamily>, onRamp: string, (WithLogger | undefined)?]) => [bigint, bigint, string];
 }>;
 /**
- * Generic implementation for fetching ExecutionReceipts for given requests
- * If more than one request is given, may yield them interleaved
- * Completes as soon as there's no more work to be done
- * 2 possible behaviors:
+ * Generic implementation for fetching ExecutionReceipts for given requests.
+ * If more than one request is given, may yield them interleaved.
+ * Completes as soon as there's no more work to be done.
+ *
+ * Two possible behaviors:
  * - if `startBlock|startTime` is given, pages forward from that block up;
  *   completes when success (final) receipt is found for all requests (or reach latest block)
  * - otherwise, pages backwards and returns only the most recent receipt per request;
  *   completes when receipts for all requests were seen
  *
- * @param dest - provider to page through
- * @param requests - CCIP requests to search executions for
- * @param hints.fromBlock - A block from where to start paging forward;
- *  otherwise, page backwards and completes on first (most recent) receipt
- * @param hints.page - getLogs pagination range param
- * @param hints.commit - Special param to help narrow down search on suppported chains (e.g. Solana)
- **/
-export declare function fetchExecutionReceipts(dest: Chain, offRamp: string, messageIds: Set<string>, hints?: {
-    startBlock?: number;
-    startTime?: number;
+ * @param dest - Provider to page through.
+ * @param offRamp - OffRamp contract address.
+ * @param request - CCIP request to search executions for.
+ * @param commit - Optional commit info to narrow down search.
+ * @param hints - Optional hints (e.g., `page` for getLogs pagination range).
+ */
+export declare function fetchExecutionReceipts(dest: Chain, offRamp: string, request: CCIPRequest, commit?: CCIPCommit, hints?: {
     page?: number;
-    commit?: CommitReport;
 }): AsyncGenerator<CCIPExecution>;
 //# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,YAAY,CAAA;AAEpD,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,IAAI,EAEV,MAAM,YAAY,CAAA;AAEnB;;;;;;;;IAQI;AACJ,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC1E,eAAe,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAC1C,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAAC,eAAe,EAAE,mBAAmB,GAAG,SAAS,CAAC,CA4BxD;AAED,eAAO,MAAM,eAAe,wBACc,KAAK,QAAQ,KAAK,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;gDAApD,KAAK,QAAQ,KAAK,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;mDAApD,KAAK,QAAQ,KAAK,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;gDAApD,KAAK,QAAQ,KAAK,UAAU,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC7F,CAAA;AAED;;;;;;;;;;;;;;;;IAgBI;AACJ,wBAAuB,sBAAsB,CAC3C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,KAAK,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAE,GACxF,cAAc,CAAC,aAAa,CAAC,CAe/B"}
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,YAAY,CAAA;AAEpD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;IASI;AACJ,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC1E,eAAe,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAC1C,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,UAAU,GACf,IAAI,CAAC,eAAe,EAAE,mBAAmB,GAAG,SAAS,CAAC,CA4BxD;AAED,eAAO,MAAM,eAAe,4CAEhB,KAAK,QACP,KAAK,UACH,MAAM,eACQ,UAAU,KAC/B,OAAO,CAAC,MAAM,CAAC;;EA6BnB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAuB,sBAAsB,CAC3C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,KAAK,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,cAAc,CAAC,aAAa,CAAC,CAgB/B"}

package/dist/execution.js

@@ -1,17 +1,18 @@
-import moize from 'moize';
+import { memoize } from 'micro-memoize';
 import { Tree, getLeafHasher, proofFlagsToBits } from "./hasher/index.js";
 import { ExecutionState, } from "./types.js";
 /**
  * Pure/sync function to calculate/generate OffRamp.executeManually report for messageIds
  *
  * @param messagesInBatch - Array containing all messages in batch, ordered
- * @param lane - Arguments for leafeHasher (lane info)
- * @param messageIds - list of messages (from batch) to prove for manual execution
+ * @param lane - Arguments for leafHasher (lane info)
+ * @param messageId - Message ID to prove for manual execution
  * @param merkleRoot - Optional merkleRoot of the CommitReport, for validation
+ * @param ctx - Context for logging
  * @returns ManualExec report arguments
  **/
-export function calculateManualExecProof(messagesInBatch, lane, messageId, merkleRoot) {
-    const hasher = getLeafHasher(lane);
+export function calculateManualExecProof(messagesInBatch, lane, messageId, merkleRoot, ctx) {
+    const hasher = getLeafHasher(lane, ctx);
     const msgIdx = messagesInBatch.findIndex((message) => message.header.messageId === messageId);
     if (msgIdx < 0) {
         throw new Error(`Could not find ${messageId} in batch seqNums=[${Number(messagesInBatch[0].header.sequenceNumber)}..${Number(messagesInBatch[messagesInBatch.length - 1].header.sequenceNumber)}]`);
@@ -30,7 +31,7 @@ export function calculateManualExecProof(messagesInBatch, lane, messageId, merkl
         merkleRoot: tree.root(),
     };
 }
-export const discoverOffRamp = moize.default(async function discoverOffRamp_(source, dest, onRamp) {
+export const discoverOffRamp = memoize(async function discoverOffRamp_(source, dest, onRamp, { logger = console } = {}) {
     const sourceRouter = await source.getRouterForOnRamp(onRamp, dest.network.chainSelector);
     const sourceOffRamps = await source.getOffRampsForRouter(sourceRouter, dest.network.chainSelector);
     for (const offRamp of sourceOffRamps) {
@@ -40,51 +41,47 @@ export const discoverOffRamp = moize.default(async function discoverOffRamp_(sou
         for (const offRamp of destOffRamps) {
             const offRampsOnRamp = await dest.getOnRampForOffRamp(offRamp, source.network.chainSelector);
             if (offRampsOnRamp === onRamp) {
-                console.debug('discoverOffRamp: found, from', { sourceRouter, sourceOffRamps, destOnRamp, destOffRamps, offRampsOnRamp }, '=', offRamp);
+                logger.debug('discoverOffRamp: found, from', { sourceRouter, sourceOffRamps, destOnRamp, destOffRamps, offRampsOnRamp }, '=', offRamp);
                 return offRamp;
             }
         }
     }
     throw new Error(`No matching offRamp found for "${onRamp}" on "${dest.network.name}"`);
 }, {
-    transformArgs: ([source, dest, onRamp]) => [
-        source.network.chainSelector,
-        dest.network.chainSelector,
-        onRamp,
-    ],
+    transformKey: ([source, dest, onRamp]) => [source.network.chainSelector, dest.network.chainSelector, onRamp],
 });
 /**
- * Generic implementation for fetching ExecutionReceipts for given requests
- * If more than one request is given, may yield them interleaved
- * Completes as soon as there's no more work to be done
- * 2 possible behaviors:
+ * Generic implementation for fetching ExecutionReceipts for given requests.
+ * If more than one request is given, may yield them interleaved.
+ * Completes as soon as there's no more work to be done.
+ *
+ * Two possible behaviors:
  * - if `startBlock|startTime` is given, pages forward from that block up;
  *   completes when success (final) receipt is found for all requests (or reach latest block)
  * - otherwise, pages backwards and returns only the most recent receipt per request;
  *   completes when receipts for all requests were seen
  *
- * @param dest - provider to page through
- * @param requests - CCIP requests to search executions for
- * @param hints.fromBlock - A block from where to start paging forward;
- *  otherwise, page backwards and completes on first (most recent) receipt
- * @param hints.page - getLogs pagination range param
- * @param hints.commit - Special param to help narrow down search on suppported chains (e.g. Solana)
- **/
-export async function* fetchExecutionReceipts(dest, offRamp, messageIds, hints) {
-    const onlyLast = !hints?.startBlock && !hints?.startTime; // backwards
+ * @param dest - Provider to page through.
+ * @param offRamp - OffRamp contract address.
+ * @param request - CCIP request to search executions for.
+ * @param commit - Optional commit info to narrow down search.
+ * @param hints - Optional hints (e.g., `page` for getLogs pagination range).
+ */
+export async function* fetchExecutionReceipts(dest, offRamp, request, commit, hints) {
+    const onlyLast = !commit?.log.blockNumber && !request.tx.timestamp; // backwards
     for await (const log of dest.getLogs({
-        ...hints,
+        startBlock: commit?.log.blockNumber,
+        startTime: request.tx.timestamp,
         address: offRamp,
         topics: ['ExecutionStateChanged'],
+        ...hints,
     })) {
         const receipt = dest.constructor.decodeReceipt(log);
-        if (!receipt || !messageIds.has(receipt.messageId))
+        if (!receipt || receipt.messageId !== request.message.header.messageId)
             continue;
-        if (onlyLast || receipt.state === ExecutionState.Success)
-            messageIds.delete(receipt.messageId);
-        const timestamp = await dest.getBlockTimestamp(log.blockNumber);
+        const timestamp = log.tx?.timestamp ?? (await dest.getBlockTimestamp(log.blockNumber));
         yield { receipt, log, timestamp };
-        if (!messageIds.size)
+        if (onlyLast || receipt.state === ExecutionState.Success)
             break;
     }
 }

package/dist/execution.js.map

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

package/dist/extra-args.d.ts

@@ -1,26 +1,55 @@
 import { type BytesLike } from 'ethers';
-import { ChainFamily } from './chain.ts';
+import { ChainFamily } from './types.ts';
+/** Tag identifier for EVMExtraArgsV1 encoding. */
 export declare const EVMExtraArgsV1Tag: "0x97a657c9";
+/** Tag identifier for EVMExtraArgsV2 encoding. */
 export declare const EVMExtraArgsV2Tag: "0x181dcf10";
+/** Tag identifier for SVMExtraArgsV1 encoding. */
 export declare const SVMExtraArgsV1Tag: "0x1f3b3aba";
+/** Tag identifier for SuiExtraArgsV1 encoding. */
 export declare const SuiExtraArgsV1Tag: "0x21ea4ca9";
+/**
+ * EVM extra arguments version 1 with gas limit only.
+ */
 export type EVMExtraArgsV1 = {
+    /** Gas limit for execution on the destination chain. */
     gasLimit: bigint;
 };
+/**
+ * EVM extra arguments version 2 with out-of-order execution support.
+ * Also known as GenericExtraArgsV2.
+ */
 export type EVMExtraArgsV2 = EVMExtraArgsV1 & {
+    /** Whether to allow out-of-order message execution. */
     allowOutOfOrderExecution: boolean;
 };
+/**
+ * Solana (SVM) extra arguments version 1.
+ */
 export type SVMExtraArgsV1 = {
+    /** Compute units for Solana execution. */
     computeUnits: bigint;
+    /** Bitmap indicating which accounts are writable. */
     accountIsWritableBitmap: bigint;
+    /** Whether to allow out-of-order message execution. */
     allowOutOfOrderExecution: boolean;
+    /** Token receiver address on Solana. */
     tokenReceiver: string;
+    /** Additional account addresses required for execution. */
     accounts: string[];
 };
+/**
+ * Sui extra arguments version 1.
+ */
 export type SuiExtraArgsV1 = EVMExtraArgsV2 & {
+    /** Token receiver address on Sui. */
     tokenReceiver: string;
+    /** Object IDs required for the receiver. */
     receiverObjectIds: string[];
 };
+/**
+ * Union type of all supported extra arguments formats.
+ */
 export type ExtraArgs = EVMExtraArgsV1 | EVMExtraArgsV2 | SVMExtraArgsV1 | SuiExtraArgsV1;
 /**
  * Encodes extra arguments for CCIP messages.
@@ -29,10 +58,11 @@ export type ExtraArgs = EVMExtraArgsV1 | EVMExtraArgsV2 | SVMExtraArgsV1 | SuiEx
  **/
 export declare function encodeExtraArgs(args: ExtraArgs, from?: ChainFamily): string;
 /**
- * Parses extra arguments from CCIP messages
- * @param data - extra arguments bytearray data
- * @returns extra arguments object if found
- **/
+ * Parses extra arguments from CCIP messages.
+ * @param data - Extra arguments bytearray data.
+ * @param from - Optional chain family to narrow decoding attempts.
+ * @returns Extra arguments object if found, undefined otherwise.
+ */
 export declare function decodeExtraArgs(data: BytesLike, from?: ChainFamily): (EVMExtraArgsV1 & {
     _tag: 'EVMExtraArgsV1';
 }) | (EVMExtraArgsV2 & {

package/dist/extra-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extra-args.d.ts","sourceRoot":"","sources":["../src/extra-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAM,MAAM,QAAQ,CAAA;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAE3F,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,wBAAwB,EAAE,OAAO,CAAA;CAClC,CAAA;AACD,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,wBAAwB,EAAE,OAAO,CAAA;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AACD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAA;AAEzF;;;;IAII;AACJ,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,WAA6B,GAAG,MAAM,CAI5F;AAED;;;;IAII;AACJ,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,WAAW,GAEhB,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,SAAS,CAeZ"}
+{"version":3,"file":"extra-args.d.ts","sourceRoot":"","sources":["../src/extra-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAM,MAAM,QAAQ,CAAA;AAG3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAC3F,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAiD,YAAY,CAAA;AAE3F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,uDAAuD;IACvD,wBAAwB,EAAE,OAAO,CAAA;CAClC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,uBAAuB,EAAE,MAAM,CAAA;IAC/B,uDAAuD;IACvD,wBAAwB,EAAE,OAAO,CAAA;IACjC,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,CAAA;AAEzF;;;;IAII;AACJ,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,WAA6B,GAAG,MAAM,CAI5F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,WAAW,GAEhB,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,GAC7C,SAAS,CAeZ"}

package/dist/extra-args.js

@@ -1,9 +1,13 @@
 import { id } from 'ethers';
-import { ChainFamily } from "./chain.js";
 import { supportedChains } from "./supported-chains.js";
+import { ChainFamily } from "./types.js";
+/** Tag identifier for EVMExtraArgsV1 encoding. */
 export const EVMExtraArgsV1Tag = id('CCIP EVMExtraArgsV1').substring(0, 10);
+/** Tag identifier for EVMExtraArgsV2 encoding. */
 export const EVMExtraArgsV2Tag = id('CCIP EVMExtraArgsV2').substring(0, 10);
+/** Tag identifier for SVMExtraArgsV1 encoding. */
 export const SVMExtraArgsV1Tag = id('CCIP SVMExtraArgsV1').substring(0, 10);
+/** Tag identifier for SuiExtraArgsV1 encoding. */
 export const SuiExtraArgsV1Tag = id('CCIP SuiExtraArgsV1').substring(0, 10);
 /**
  * Encodes extra arguments for CCIP messages.
@@ -17,10 +21,11 @@ export function encodeExtraArgs(args, from = ChainFamily.EVM) {
     return chain.encodeExtraArgs(args);
 }
 /**
- * Parses extra arguments from CCIP messages
- * @param data - extra arguments bytearray data
- * @returns extra arguments object if found
- **/
+ * Parses extra arguments from CCIP messages.
+ * @param data - Extra arguments bytearray data.
+ * @param from - Optional chain family to narrow decoding attempts.
+ * @returns Extra arguments object if found, undefined otherwise.
+ */
 export function decodeExtraArgs(data, from) {
     if (!data || data === '')
         return;

package/dist/extra-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"extra-args.js","sourceRoot":"","sources":["../src/extra-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAuB3F;;;;IAII;AACJ,MAAM,UAAU,eAAe,CAAC,IAAe,EAAE,OAAoB,WAAW,CAAC,GAAG;IAClF,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;IAChE,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;;;;IAII;AACJ,MAAM,UAAU,eAAe,CAC7B,IAAe,EACf,IAAkB;IAOlB,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,EAAE;QAAE,OAAM;IAChC,IAAI,MAAM,CAAA;IACV,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;QAChE,MAAM,GAAG,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC3C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAA;IAC7B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,GAAG,CAAC,CAAA;AAC7D,CAAC"}
+{"version":3,"file":"extra-args.js","sourceRoot":"","sources":["../src/extra-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAC3F,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAiB,CAAA;AAkD3F;;;;IAII;AACJ,MAAM,UAAU,eAAe,CAAC,IAAe,EAAE,OAAoB,WAAW,CAAC,GAAG;IAClF,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;IAChE,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAe,EACf,IAAkB;IAOlB,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,EAAE;QAAE,OAAM;IAChC,IAAI,MAAM,CAAA;IACV,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;QAChE,MAAM,GAAG,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;IACzC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC3C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAA;IAC7B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,GAAG,CAAC,CAAA;AAC7D,CAAC"}

package/dist/gas.d.ts

@@ -3,14 +3,12 @@ import type { Chain } from './chain.ts';
 import type { EVMChain } from './evm/index.ts';
 import type { Lane } from './types.ts';
 /**
- * Estimate CCIP gasLimit needed to execute a request on a contract receiver
- *
- * @param dest - Provider for the destination chain
- * @param request - CCIP request info
- * @param request.lane - Lane info
- * @param request.message - Message info
- * @returns estimated gasLimit as bigint
- **/
+ * Estimate CCIP gasLimit needed to execute a request on a contract receiver.
+ * @param source - Provider for the source chain.
+ * @param dest - Provider for the destination chain.
+ * @param request - CCIP request info containing `lane` and `message` details.
+ * @returns Estimated gasLimit as bigint.
+ */
 export declare function estimateExecGasForRequest(source: Chain, dest: EVMChain, request: {
     lane: Lane;
     message: {

package/dist/gas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../src/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAWf,MAAM,QAAQ,CAAA;AAGf,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAetC;;;;;;;;IAQI;AACJ,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,KAAK,EACb,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE;IACP,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,SAAS,CAAA;QACf,YAAY,EAAE,SAAS;YACrB,iBAAiB,EAAE,MAAM,CAAA;YACzB,gBAAgB,EAAE,MAAM,CAAA;YACxB,MAAM,EAAE,MAAM,CAAA;SACf,EAAE,CAAA;KACJ,CAAA;CACF,mBA0EF"}
+{"version":3,"file":"gas.d.ts","sourceRoot":"","sources":["../src/gas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAWf,MAAM,QAAQ,CAAA;AAGf,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAetC;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,KAAK,EACb,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE;IACP,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,SAAS,CAAA;QACf,YAAY,EAAE,SAAS;YACrB,iBAAiB,EAAE,MAAM,CAAA;YACzB,gBAAgB,EAAE,MAAM,CAAA;YACxB,MAAM,EAAE,MAAM,CAAA;SACf,EAAE,CAAA;KACJ,CAAA;CACF,mBA0EF"}

package/dist/gas.js

@@ -12,16 +12,14 @@ const ccipReceive = FunctionFragment.from({
     outputs: [],
 });
 /**
- * Estimate CCIP gasLimit needed to execute a request on a contract receiver
- *
- * @param dest - Provider for the destination chain
- * @param request - CCIP request info
- * @param request.lane - Lane info
- * @param request.message - Message info
- * @returns estimated gasLimit as bigint
- **/
+ * Estimate CCIP gasLimit needed to execute a request on a contract receiver.
+ * @param source - Provider for the source chain.
+ * @param dest - Provider for the destination chain.
+ * @param request - CCIP request info containing `lane` and `message` details.
+ * @returns Estimated gasLimit as bigint.
+ */
 export async function estimateExecGasForRequest(source, dest, request) {
-    const offRamp = await discoverOffRamp(source, dest, request.lane.onRamp);
+    const offRamp = await discoverOffRamp(source, dest, request.lane.onRamp, source);
     const destRouter = await dest.getRouterForOffRamp(offRamp, request.lane.sourceChainSelector);
     const destTokenAmounts = await Promise.all(request.message.tokenAmounts.map(async (ta) => {
         if (!('destTokenAddress' in ta))

package/dist/gas.js.map

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

package/dist/hasher/common.d.ts

@@ -1,11 +1,12 @@
 import type { CCIPMessage, CCIPVersion } from '../types.ts';
+/** Function type for computing the leaf hash of a CCIP message. */
 export type LeafHasher<V extends CCIPVersion = CCIPVersion> = (message: CCIPMessage<V>) => string;
 export declare const LEAF_DOMAIN_SEPARATOR = "0x00";
 export declare const ZERO_HASH: string;
 /**
  * Computes the Keccak-256 hash of the concatenation of two hash values.
- * @param a The first hash as a Hash type.
- * @param b The second hash as a Hash type.
+ * @param a - The first hash as a Hash type.
+ * @param b - The second hash as a Hash type.
  * @returns The Keccak-256 hash result as a Hash type.
  */
 export declare function hashInternal(a: string, b: string): string;

package/dist/hasher/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/hasher/common.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE3D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;AAGjG,eAAO,MAAM,qBAAqB,SAAS,CAAA;AAC3C,eAAO,MAAM,SAAS,QAAyC,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/hasher/common.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE3D,mEAAmE;AACnE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;AAGjG,eAAO,MAAM,qBAAqB,SAAS,CAAA;AAC3C,eAAO,MAAM,SAAS,QAAyC,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/hasher/common.js

@@ -4,8 +4,8 @@ export const LEAF_DOMAIN_SEPARATOR = '0x00';
 export const ZERO_HASH = hexlify(new Uint8Array(32).fill(0xff));
 /**
  * Computes the Keccak-256 hash of the concatenation of two hash values.
- * @param a The first hash as a Hash type.
- * @param b The second hash as a Hash type.
+ * @param a - The first hash as a Hash type.
+ * @param b - The second hash as a Hash type.
  * @returns The Keccak-256 hash result as a Hash type.
  */
 export function hashInternal(a, b) {

package/dist/hasher/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/hasher/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAM5D,MAAM,yBAAyB,GAAG,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,CAAC;QAAA,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAClB,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,yBAAyB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,SAAS,CAAC,YAAY,CAAC,CAAA;AAChC,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/hasher/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAO5D,MAAM,yBAAyB,GAAG,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,CAAS;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,CAAC;QAAA,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAClB,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,yBAAyB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,SAAS,CAAC,YAAY,CAAC,CAAA;AAChC,CAAC"}

package/dist/hasher/hasher.d.ts

@@ -1,4 +1,10 @@
-import type { CCIPVersion, Lane } from '../types.ts';
+import type { CCIPVersion, Lane, WithLogger } from '../types.ts';
 import type { LeafHasher } from './common.ts';
-export declare function getLeafHasher<V extends CCIPVersion = CCIPVersion>(lane: Lane<V>): LeafHasher<V>;
+/**
+ * Factory function that returns the right encoder based on the version of the lane.
+ * @param lane - Lane configuration.
+ * @param ctx - Context object containing logger.
+ * @returns Leaf hasher function for the destination chain.
+ */
+export declare function getLeafHasher<V extends CCIPVersion = CCIPVersion>(lane: Lane<V>, ctx?: WithLogger): LeafHasher<V>;
 //# sourceMappingURL=hasher.d.ts.map

package/dist/hasher/hasher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/hasher/hasher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAK/F"}
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/hasher/hasher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,GAAG,CAAC,EAAE,UAAU,GACf,UAAU,CAAC,CAAC,CAAC,CAKf"}

package/dist/hasher/hasher.js

@@ -1,11 +1,16 @@
 import { supportedChains } from "../supported-chains.js";
 import { networkInfo } from "../utils.js";
-// Factory function that returns the right encoder based on the version of the lane
-export function getLeafHasher(lane) {
+/**
+ * Factory function that returns the right encoder based on the version of the lane.
+ * @param lane - Lane configuration.
+ * @param ctx - Context object containing logger.
+ * @returns Leaf hasher function for the destination chain.
+ */
+export function getLeafHasher(lane, ctx) {
     const destFamily = networkInfo(lane.destChainSelector).family;
     const chain = supportedChains[destFamily];
     if (!chain)
         throw new Error(`Unsupported chain family: ${destFamily}`);
-    return chain.getDestLeafHasher(lane);
+    return chain.getDestLeafHasher(lane, ctx);
 }
 //# sourceMappingURL=hasher.js.map

package/dist/hasher/hasher.js.map

@@ -1 +1 @@
-{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/hasher/hasher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAAsC,IAAa;IAC9E,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAA;IAC7D,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAA;IACtE,OAAO,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAkB,CAAA;AACvD,CAAC"}
+{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/hasher/hasher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAa,EACb,GAAgB;IAEhB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAA;IAC7D,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAA;IACtE,OAAO,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAkB,CAAA;AAC5D,CAAC"}

package/dist/hasher/merklemulti.d.ts

@@ -2,28 +2,31 @@ export declare const MAX_NUMBER_TREE_LEAVES = 256;
 type Hash = string;
 /**
  * Proof represents a proof data structure with hashes and source flags.
- * @template Hash The hash type.
  */
 export declare class Proof {
     hashes: Hash[];
     sourceFlags: boolean[];
+    /**
+     * Creates a new Proof instance.
+     * @param hashes - Proof hashes.
+     * @param sourceFlags - Source flags indicating leaf vs internal nodes.
+     */
     constructor(hashes?: Hash[], sourceFlags?: boolean[]);
     /**
      * Counts the number of source flags that match the given boolean value.
-     * @param b The boolean value to count.
+     * @param b - The boolean value to count.
      * @returns The count of source flags matching the provided boolean value.
      */
     countSourceFlags(b: boolean): number;
 }
 /**
  * Represents a Merkle Tree data structure.
- * @typeparam Hash The type of hash used in the tree.
  */
 export declare class Tree {
     layers: Hash[][];
     /**
      * Creates a new Merkle Tree using the provided context and leaf hashes.
-     * @param leafHashes An array of leaf hashes to construct the tree.
+     * @param leafHashes - An array of leaf hashes to construct the tree.
      * @returns A new Merkle Tree instance.
      * @throws Error if there are no leaf hashes provided.
      */
@@ -35,22 +38,21 @@ export declare class Tree {
     root(): Hash;
     /**
      * Generates a Merkle proof for a set of indices in the tree.
-     * @param indices The indices for which to generate the proof.
+     * @param indices - The indices for which to generate the proof.
      * @returns A proof object containing hashes and source flags.
      */
     prove(indices: number[]): Proof;
 }
 /**
  * Converts an array of boolean proof flags to a BigNumber where each flag represents a bit.
- * @param proofFlags An array of boolean proof flags.
+ * @param proofFlags - An array of boolean proof flags.
  * @returns A BigNumber representing the encoded flags.
  */
 export declare function proofFlagsToBits(proofFlags: boolean[]): bigint;
 /**
  * Verifies and computes the Merkle root hash based on provided leaf hashes and a Merkle proof.
- * @param ctx The Merkle context.
- * @param leafHashes An array of leaf hashes.
- * @param proof The Merkle proof containing hashes and source flags.
+ * @param leafHashes - An array of leaf hashes.
+ * @param proof - The Merkle proof containing hashes and source flags.
  * @returns The computed Merkle root hash.
  */
 export declare function verifyComputeRoot(leafHashes: Hash[], proof: Proof): Hash;

package/dist/hasher/merklemulti.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merklemulti.d.ts","sourceRoot":"","sources":["../../src/hasher/merklemulti.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,KAAK,IAAI,GAAG,MAAM,CAAA;AAQlB;;;GAGG;AACH,qBAAa,KAAK;IAChB,MAAM,EAAE,IAAI,EAAE,CAAK;IACnB,WAAW,EAAE,OAAO,EAAE,CAAK;gBAEf,MAAM,GAAE,IAAI,EAAO,EAAE,WAAW,GAAE,OAAO,EAAO;IAK5D;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;CAGrC;AAiGD;;;GAGG;AACH,qBAAa,IAAI;IACf,MAAM,EAAE,IAAI,EAAE,EAAE,CAAA;IAEhB;;;;;OAKG;gBACS,UAAU,EAAE,IAAI,EAAE;IAyB9B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK;CAahC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAqFxE"}
+{"version":3,"file":"merklemulti.d.ts","sourceRoot":"","sources":["../../src/hasher/merklemulti.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,KAAK,IAAI,GAAG,MAAM,CAAA;AAQlB;;GAEG;AACH,qBAAa,KAAK;IAChB,MAAM,EAAE,IAAI,EAAE,CAAK;IACnB,WAAW,EAAE,OAAO,EAAE,CAAK;IAE3B;;;;OAIG;gBACS,MAAM,GAAE,IAAI,EAAO,EAAE,WAAW,GAAE,OAAO,EAAO;IAK5D;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM;CAGrC;AAgGD;;GAEG;AACH,qBAAa,IAAI;IACf,MAAM,EAAE,IAAI,EAAE,EAAE,CAAA;IAEhB;;;;;OAKG;gBACS,UAAU,EAAE,IAAI,EAAE;IAyB9B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK;CAahC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAqFxE"}