@chainlink/ccip-sdk 0.91.1 → 0.92.0

package/dist/ton/bindings/offramp.js

@@ -0,0 +1,63 @@
+/**
+ * TON OffRamp contract binding.
+ * The OffRamp receives and executes cross-chain messages on the destination (TON) chain.
+ */
+export class OffRamp {
+    address;
+    /**
+     * Creates a new OffRamp instance.
+     * @param address - The OffRamp contract address on TON.
+     */
+    constructor(address) {
+        this.address = address;
+    }
+    /**
+     * Creates an OffRamp instance from a contract address.
+     * @param address - The OffRamp contract address on TON.
+     * @returns A new OffRamp instance.
+     */
+    static createFromAddress(address) {
+        return new OffRamp(address);
+    }
+    /**
+     * Retrieves the source chain configuration for a given chain selector.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param sourceChainSelector - The CCIP chain selector of the source chain.
+     * @returns The source chain configuration.
+     * @throws Error with exitCode 266 if the source chain is not enabled.
+     */
+    async getSourceChainConfig(provider, sourceChainSelector) {
+        const result = await provider.get('sourceChainConfig', [
+            { type: 'int', value: sourceChainSelector },
+        ]);
+        // Tolk returns struct as tuple
+        const router = result.stack.readAddress();
+        const isEnabled = result.stack.readBoolean();
+        const minSeqNr = result.stack.readBigNumber();
+        const isRMNVerificationDisabled = result.stack.readBoolean();
+        // onRamp is stored as CrossChainAddress cell
+        const onRampCell = result.stack.readCell();
+        const onRampSlice = onRampCell.beginParse();
+        // Check if length-prefixed or raw format based on cell bit length
+        const cellBits = onRampCell.bits.length;
+        let onRamp;
+        if (cellBits === 160) {
+            // Raw 20-byte EVM address (no length prefix)
+            onRamp = onRampSlice.loadBuffer(20);
+        }
+        else {
+            // Length-prefixed format: 8-bit length + data
+            const onRampLength = onRampSlice.loadUint(8);
+            onRamp = onRampSlice.loadBuffer(onRampLength);
+        }
+        return {
+            router,
+            isEnabled,
+            minSeqNr,
+            isRMNVerificationDisabled,
+            onRamp,
+        };
+    }
+}
+//# sourceMappingURL=offramp.js.map

package/dist/ton/bindings/offramp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offramp.js","sourceRoot":"","sources":["../../../src/ton/bindings/offramp.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,MAAM,OAAO,OAAO;IACT,OAAO,CAAS;IAEzB;;;OAGG;IACH,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAgB;QACvC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,oBAAoB,CACxB,QAA0B,EAC1B,mBAA2B;QAE3B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,mBAAmB,EAAE;YACrD,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE;SAC5C,CAAC,CAAA;QAEF,+BAA+B;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QACzC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,CAAA;QAC7C,MAAM,yBAAyB,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;QAE5D,6CAA6C;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAA;QAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,EAAE,CAAA;QAE3C,kEAAkE;QAClE,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAA;QACvC,IAAI,MAAc,CAAA;QAElB,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;YACrB,6CAA6C;YAC7C,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,8CAA8C;YAC9C,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAC5C,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;QAC/C,CAAC;QAED,OAAO;YACL,MAAM;YACN,SAAS;YACT,QAAQ;YACR,yBAAyB;YACzB,MAAM;SACP,CAAA;IACH,CAAC;CACF"}

package/dist/ton/bindings/onramp.d.ts

@@ -0,0 +1,40 @@
+import { type Address, type ContractProvider, Dictionary } from '@ton/core';
+/**
+ * Configuration for a destination chain on the TON OnRamp contract.
+ * Contains routing and access control settings for messages going to a specific destination chain.
+ */
+export interface DestChainConfig {
+    router: Address;
+    sequenceNumber: bigint;
+    allowlistEnabled: boolean;
+    allowedSenders: Dictionary<Address, boolean>;
+}
+/**
+ * TON OnRamp contract binding.
+ * The OnRamp sends cross-chain messages from the source (TON) chain to destination chains.
+ * It validates messages, assigns sequence numbers, and emits events for the CCIP network.
+ */
+export declare class OnRamp {
+    readonly address: Address;
+    /**
+     * Creates a new OnRamp instance.
+     * @param address - The OnRamp contract address on TON.
+     */
+    constructor(address: Address);
+    /**
+     * Creates an OnRamp instance from a contract address.
+     * @param address - The OnRamp contract address on TON.
+     * @returns A new OnRamp instance.
+     */
+    static createFromAddress(address: Address): OnRamp;
+    /**
+     * Retrieves the destination chain configuration for a given chain selector.
+     * This includes the router, current sequence number, and allowlist settings.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param destChainSelector - The CCIP chain selector of the destination chain.
+     * @returns The destination chain configuration.
+     */
+    getDestChainConfig(provider: ContractProvider, destChainSelector: bigint): Promise<DestChainConfig>;
+}
+//# sourceMappingURL=onramp.d.ts.map

package/dist/ton/bindings/onramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramp.d.ts","sourceRoot":"","sources":["../../../src/ton/bindings/onramp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;CAC7C;AAED;;;;GAIG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB;;;OAGG;gBACS,OAAO,EAAE,OAAO;IAI5B;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAIlD;;;;;;;OAOG;IACG,kBAAkB,CACtB,QAAQ,EAAE,gBAAgB,EAC1B,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,eAAe,CAAC;CAqB5B"}

package/dist/ton/bindings/onramp.js

@@ -0,0 +1,51 @@
+// TODO: FIXME: Remove local copies and import when chainlink-ton is published as npm package
+import { Dictionary } from '@ton/core';
+/**
+ * TON OnRamp contract binding.
+ * The OnRamp sends cross-chain messages from the source (TON) chain to destination chains.
+ * It validates messages, assigns sequence numbers, and emits events for the CCIP network.
+ */
+export class OnRamp {
+    address;
+    /**
+     * Creates a new OnRamp instance.
+     * @param address - The OnRamp contract address on TON.
+     */
+    constructor(address) {
+        this.address = address;
+    }
+    /**
+     * Creates an OnRamp instance from a contract address.
+     * @param address - The OnRamp contract address on TON.
+     * @returns A new OnRamp instance.
+     */
+    static createFromAddress(address) {
+        return new OnRamp(address);
+    }
+    /**
+     * Retrieves the destination chain configuration for a given chain selector.
+     * This includes the router, current sequence number, and allowlist settings.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param destChainSelector - The CCIP chain selector of the destination chain.
+     * @returns The destination chain configuration.
+     */
+    async getDestChainConfig(provider, destChainSelector) {
+        const { stack } = await provider.get('destChainConfig', [
+            { type: 'int', value: destChainSelector },
+        ]);
+        const router = stack.readAddress();
+        const sequenceNumber = stack.readBigNumber();
+        const allowlistEnabled = stack.readBoolean();
+        const allowedSendersCell = stack.readCellOpt();
+        return {
+            router,
+            sequenceNumber,
+            allowlistEnabled,
+            allowedSenders: allowedSendersCell
+                ? Dictionary.loadDirect(Dictionary.Keys.Address(), Dictionary.Values.Bool(), allowedSendersCell)
+                : Dictionary.empty(),
+        };
+    }
+}
+//# sourceMappingURL=onramp.js.map

package/dist/ton/bindings/onramp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramp.js","sourceRoot":"","sources":["../../../src/ton/bindings/onramp.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,EAAuC,UAAU,EAAE,MAAM,WAAW,CAAA;AAa3E;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACR,OAAO,CAAS;IAEzB;;;OAGG;IACH,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAgB;QACvC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,kBAAkB,CACtB,QAA0B,EAC1B,iBAAyB;QAEzB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE;YACtD,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE;SAC1C,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;QAClC,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,EAAE,CAAA;QAC5C,MAAM,gBAAgB,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;QAC5C,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;QAC9C,OAAO;YACL,MAAM;YACN,cAAc;YACd,gBAAgB;YAChB,cAAc,EAAE,kBAAkB;gBAChC,CAAC,CAAC,UAAU,CAAC,UAAU,CACnB,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EACzB,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,EACxB,kBAAkB,CACnB;gBACH,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE;SACvB,CAAA;IACH,CAAC;CACF"}

package/dist/ton/bindings/router.d.ts

@@ -0,0 +1,47 @@
+import type { Address, ContractProvider } from '@ton/core';
+/**
+ * Represents a ramp (OnRamp or OffRamp) configuration in the Router.
+ */
+export interface Ramp {
+    chainSelector: bigint;
+    address: Address;
+}
+/**
+ * TON Router contract binding.
+ * The Router is the main entry point for CCIP on TON. It routes messages to the appropriate
+ * OnRamp (for sending) or OffRamp (for receiving) based on the chain selector.
+ */
+export declare class Router {
+    readonly address: Address;
+    /**
+     * Creates a new Router instance.
+     * @param address - The Router contract address on TON.
+     */
+    constructor(address: Address);
+    /**
+     * Creates a Router instance from a contract address.
+     * @param address - The Router contract address on TON.
+     * @returns A new Router instance.
+     */
+    static createFromAddress(address: Address): Router;
+    /**
+     * Gets the OffRamp address for a given source chain selector.
+     * The OffRamp handles incoming messages from the specified source chain.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param chainSelector - The CCIP chain selector of the source chain.
+     * @returns The OffRamp contract address.
+     * @throws Error with exitCode 261 if the source chain is not enabled.
+     */
+    getOffRamp(provider: ContractProvider, chainSelector: bigint): Promise<Address>;
+    /**
+     * Gets the OnRamp address for a given destination chain selector.
+     * The OnRamp handles outgoing messages to the specified destination chain.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param destChainSelector - The CCIP chain selector of the destination chain.
+     * @returns The OnRamp contract address.
+     */
+    getOnRamp(provider: ContractProvider, destChainSelector: bigint): Promise<Address>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/ton/bindings/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/ton/bindings/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB;;;OAGG;gBACS,OAAO,EAAE,OAAO;IAI5B;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAIlD;;;;;;;;OAQG;IACG,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMrF;;;;;;;OAOG;IACG,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAKzF"}

package/dist/ton/bindings/router.js

@@ -0,0 +1,51 @@
+/**
+ * TON Router contract binding.
+ * The Router is the main entry point for CCIP on TON. It routes messages to the appropriate
+ * OnRamp (for sending) or OffRamp (for receiving) based on the chain selector.
+ */
+export class Router {
+    address;
+    /**
+     * Creates a new Router instance.
+     * @param address - The Router contract address on TON.
+     */
+    constructor(address) {
+        this.address = address;
+    }
+    /**
+     * Creates a Router instance from a contract address.
+     * @param address - The Router contract address on TON.
+     * @returns A new Router instance.
+     */
+    static createFromAddress(address) {
+        return new Router(address);
+    }
+    /**
+     * Gets the OffRamp address for a given source chain selector.
+     * The OffRamp handles incoming messages from the specified source chain.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param chainSelector - The CCIP chain selector of the source chain.
+     * @returns The OffRamp contract address.
+     * @throws Error with exitCode 261 if the source chain is not enabled.
+     */
+    async getOffRamp(provider, chainSelector) {
+        return provider
+            .get('offRamp', [{ type: 'int', value: chainSelector }])
+            .then((r) => r.stack.readAddress());
+    }
+    /**
+     * Gets the OnRamp address for a given destination chain selector.
+     * The OnRamp handles outgoing messages to the specified destination chain.
+     *
+     * @param provider - TON contract provider for making RPC calls.
+     * @param destChainSelector - The CCIP chain selector of the destination chain.
+     * @returns The OnRamp contract address.
+     */
+    async getOnRamp(provider, destChainSelector) {
+        return provider
+            .get('onRamp', [{ type: 'int', value: destChainSelector }])
+            .then((r) => r.stack.readAddress());
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/ton/bindings/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/ton/bindings/router.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,OAAO,MAAM;IACR,OAAO,CAAS;IAEzB;;;OAGG;IACH,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAgB;QACvC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CAAC,QAA0B,EAAE,aAAqB;QAChE,OAAO,QAAQ;aACZ,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;aACvD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,QAA0B,EAAE,iBAAyB;QACnE,OAAO,QAAQ;aACZ,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;aAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACvC,CAAC;CACF"}

package/dist/ton/exec.d.ts

@@ -0,0 +1,18 @@
+import { beginCell } from '@ton/core';
+import type { ExecutionReport } from '../types.ts';
+import { type CCIPMessage_V1_6_TON } from './types.ts';
+/**
+ * Generates an unsigned execute report payload for the TON OffRamp contract.
+ *
+ * @param offRamp - OffRamp contract address.
+ * @param execReport - Execution report containing the CCIP message and proofs.
+ * @param opts - Optional execution options. Gas limit override for execution (0 = no override).
+ * @returns Object with target address, value, and payload cell.
+ */
+export declare function generateUnsignedExecuteReport(offRamp: string, execReport: ExecutionReport<CCIPMessage_V1_6_TON>, opts?: {
+    gasLimit?: number;
+}): {
+    to: string;
+    body: ReturnType<typeof beginCell>['endCell'] extends () => infer R ? R : never;
+};
+//# sourceMappingURL=exec.d.ts.map

package/dist/ton/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/ton/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,CAAC,oBAAoB,CAAC,EACjD,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B;IACD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;CAChF,CAmBA"}

package/dist/ton/exec.js

@@ -0,0 +1,28 @@
+import { beginCell } from '@ton/core';
+import { MANUALLY_EXECUTE_OPCODE, serializeExecutionReport, } from "./types.js";
+/**
+ * Generates an unsigned execute report payload for the TON OffRamp contract.
+ *
+ * @param offRamp - OffRamp contract address.
+ * @param execReport - Execution report containing the CCIP message and proofs.
+ * @param opts - Optional execution options. Gas limit override for execution (0 = no override).
+ * @returns Object with target address, value, and payload cell.
+ */
+export function generateUnsignedExecuteReport(offRamp, execReport, opts) {
+    // Serialize the execution report
+    const serializedReport = serializeExecutionReport(execReport);
+    // Use provided gasLimit as override, or 0 for no override
+    const gasOverride = opts?.gasLimit ? BigInt(opts.gasLimit) : 0n;
+    // Construct the OffRamp_ManuallyExecute message
+    const payload = beginCell()
+        .storeUint(MANUALLY_EXECUTE_OPCODE, 32) // Opcode for OffRamp_ManuallyExecute
+        .storeUint(0, 64) // queryID (default 0)
+        .storeBuilder(serializedReport) // as builder!
+        .storeCoins(gasOverride) // gasOverride (optional, 0 = no override)
+        .endCell();
+    return {
+        to: offRamp,
+        body: payload,
+    };
+}
+//# sourceMappingURL=exec.js.map

package/dist/ton/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/ton/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGrC,OAAO,EAEL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EACf,UAAiD,EACjD,IAA4B;IAK5B,iCAAiC;IACjC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAE7D,0DAA0D;IAC1D,MAAM,WAAW,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/D,gDAAgD;IAChD,MAAM,OAAO,GAAG,SAAS,EAAE;SACxB,SAAS,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,qCAAqC;SAC5E,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,sBAAsB;SACvC,YAAY,CAAC,gBAAgB,CAAC,CAAC,cAAc;SAC7C,UAAU,CAAC,WAAW,CAAC,CAAC,0CAA0C;SAClE,OAAO,EAAE,CAAA;IAEZ,OAAO;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;KACd,CAAA;AACH,CAAC"}

package/dist/ton/hasher.d.ts

@@ -0,0 +1,27 @@
+import type { LeafHasher } from '../hasher/common.ts';
+import { CCIPVersion } from '../types.ts';
+/**
+ * Creates a leaf hasher for TON messages.
+ *
+ * @param lane - Lane configuration containing sourceChainSelector, destChainSelector,
+ *   onRamp (as hex string), and version (only v1.6 supported for TON).
+ * @returns A LeafHasher function that computes message hashes for TON.
+ */
+export declare function getTONLeafHasher<V extends CCIPVersion = CCIPVersion>({ sourceChainSelector, destChainSelector, onRamp, version, }: {
+    sourceChainSelector: bigint;
+    destChainSelector: bigint;
+    onRamp: string;
+    version: V;
+}): LeafHasher<V>;
+/**
+ * Creates a hash that uniquely identifies the message lane configuration
+ * (source chain, destination chain, and onRamp address).
+ * Following the TON implementation from chainlink-ton repo.
+ *
+ * @param sourceChainSelector - Source chain selector.
+ * @param destChainSelector - Destination chain selector.
+ * @param onRamp - OnRamp address as hex string.
+ * @returns SHA256 hash of the metadata as hex string.
+ */
+export declare const hashTONMetadata: (sourceChainSelector: bigint, destChainSelector: bigint, onRamp: string) => string;
+//# sourceMappingURL=hasher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/ton/hasher.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAA2C,WAAW,EAAE,MAAM,aAAa,CAAA;AAOlF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACpE,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACN,OAAO,GACR,EAAE;IACD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,CAAC,CAAA;CACX,GAAG,UAAU,CAAC,CAAC,CAAC,CAYhB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAC1B,qBAAqB,MAAM,EAC3B,mBAAmB,MAAM,EACzB,QAAQ,MAAM,KACb,MAiBF,CAAA"}

package/dist/ton/hasher.js

@@ -0,0 +1,134 @@
+import { Address, beginCell } from '@ton/core';
+import { sha256, toBigInt } from 'ethers';
+import { CCIPExtraArgsInvalidError, CCIPHasherVersionUnsupportedError, } from "../errors/specialized.js";
+import { decodeExtraArgs } from "../extra-args.js";
+import { CCIPVersion } from "../types.js";
+import { networkInfo } from "../utils.js";
+import { hexToBuffer, tryParseCell } from "./utils.js";
+// TON uses 256 bits (32 bytes) of zeros as leaf domain separator
+const TON_LEAF_DOMAIN_SEPARATOR = 0n;
+/**
+ * Creates a leaf hasher for TON messages.
+ *
+ * @param lane - Lane configuration containing sourceChainSelector, destChainSelector,
+ *   onRamp (as hex string), and version (only v1.6 supported for TON).
+ * @returns A LeafHasher function that computes message hashes for TON.
+ */
+export function getTONLeafHasher({ sourceChainSelector, destChainSelector, onRamp, version, }) {
+    if (version !== CCIPVersion.V1_6) {
+        throw new CCIPHasherVersionUnsupportedError('TON', version);
+    }
+    // Pre-compute metadata hash once for all messages using this hasher
+    const metadataHash = hashTONMetadata(sourceChainSelector, destChainSelector, onRamp);
+    // Return the actual hashing function that will be called for each message
+    return ((message) => {
+        return hashV16TONMessage(message, metadataHash);
+    });
+}
+/**
+ * Creates a hash that uniquely identifies the message lane configuration
+ * (source chain, destination chain, and onRamp address).
+ * Following the TON implementation from chainlink-ton repo.
+ *
+ * @param sourceChainSelector - Source chain selector.
+ * @param destChainSelector - Destination chain selector.
+ * @param onRamp - OnRamp address as hex string.
+ * @returns SHA256 hash of the metadata as hex string.
+ */
+export const hashTONMetadata = (sourceChainSelector, destChainSelector, onRamp) => {
+    // Domain separator for TON messages
+    const versionHash = BigInt(sha256(Buffer.from('Any2TVMMessageHashV1')));
+    const onRampBytes = hexToBuffer(onRamp);
+    // Build metadata cell
+    const metadataCell = beginCell()
+        .storeUint(versionHash, 256)
+        .storeUint(sourceChainSelector, 64)
+        .storeUint(destChainSelector, 64)
+        .storeRef(beginCell().storeUint(BigInt(onRampBytes.length), 8).storeBuffer(onRampBytes).endCell())
+        .endCell();
+    // Return cell hash as hex string (excludes BOC headers)
+    return '0x' + metadataCell.hash().toString('hex');
+};
+/**
+ * Computes the full message hash for a CCIP v1.6 TON message
+ * Follows the chainlink-ton's Any2TVMRampMessage.generateMessageId()
+ *
+ * @param message - CCIP message to hash
+ * @param metadataHash - Pre-computed metadata hash from hashTONMetadata()
+ * @returns SHA256 hash of the complete message as hex string
+ */
+function hashV16TONMessage(message, metadataHash) {
+    // Extract gas limit from message
+    let gasLimit;
+    const embeddedGasLimit = message.gasLimit;
+    if (typeof embeddedGasLimit === 'bigint') {
+        gasLimit = embeddedGasLimit;
+    }
+    else {
+        const parsedArgs = decodeExtraArgs(message.extraArgs, networkInfo(message.sourceChainSelector).family);
+        if (!parsedArgs || parsedArgs._tag !== 'EVMExtraArgsV2') {
+            throw new CCIPExtraArgsInvalidError('TON', message.extraArgs);
+        }
+        gasLimit = parsedArgs.gasLimit || 0n;
+    }
+    // Build header cell containing header routing information
+    const headerCell = beginCell()
+        .storeUint(toBigInt(message.messageId), 256)
+        .storeAddress(Address.parse(message.receiver))
+        .storeUint(toBigInt(message.sequenceNumber), 64)
+        .storeCoins(gasLimit)
+        .storeUint(toBigInt(message.nonce), 64)
+        .endCell();
+    // Build sender cell with address bytes
+    const senderBytes = hexToBuffer(message.sender);
+    const senderCell = beginCell()
+        .storeUint(BigInt(senderBytes.length), 8)
+        .storeBuffer(senderBytes)
+        .endCell();
+    // Build token amounts cell if tokens are being transferred
+    const tokenAmountsCell = message.tokenAmounts.length > 0 ? buildTokenAmountsCell(message.tokenAmounts) : null;
+    // Assemble the complete message cell
+    // LEAF_DOMAIN_SEPARATOR (256 bits) + metadataHash (256 bits) + refs
+    const messageCell = beginCell()
+        .storeUint(TON_LEAF_DOMAIN_SEPARATOR, 256)
+        .storeUint(toBigInt(metadataHash), 256)
+        .storeRef(headerCell)
+        .storeRef(senderCell)
+        .storeRef(tryParseCell(message.data))
+        .storeMaybeRef(tokenAmountsCell)
+        .endCell();
+    // Return cell hash as hex string
+    return '0x' + messageCell.hash().toString('hex');
+}
+/**
+ * Creates a nested cell structure for token amounts, where each token
+ * transfer is stored as a reference cell containing source pool, destination,
+ * amount, and extra data.
+ *
+ * @param tokenAmounts - Array of token transfer details
+ * @returns Cell containing all token transfer information
+ */
+function buildTokenAmountsCell(tokenAmounts) {
+    const builder = beginCell();
+    // Process each token transfer
+    for (const ta of tokenAmounts) {
+        const sourcePoolBytes = hexToBuffer(ta.sourcePoolAddress);
+        // Extract amount
+        const amountSource = ta.amount ??
+            ta.destGasAmount ??
+            0n;
+        const amount = toBigInt(amountSource);
+        // Store each token transfer as a reference cell
+        builder.storeRef(beginCell()
+            .storeRef(beginCell()
+            .storeUint(BigInt(sourcePoolBytes.length), 8)
+            .storeBuffer(sourcePoolBytes)
+            .endCell())
+            .storeAddress(Address.parse(ta.destTokenAddress))
+            .storeUint(amount, 256)
+            .storeRef(tryParseCell(ta.extraData))
+            .endCell());
+    }
+    return builder.endCell();
+}
+//# sourceMappingURL=hasher.js.map

package/dist/ton/hasher.js.map

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