@chainlink/ccip-sdk 0.91.0 → 0.92.0

package/dist/sui/manuallyExec/encoder.d.ts

@@ -0,0 +1,8 @@
+import type { CCIPMessage, CCIPVersion, ExecutionReport } from '../../types.ts';
+/**
+ * Serializes an execution report for Sui manual execution.
+ * @param executionReport - The execution report to serialize.
+ * @returns Serialized execution report as Uint8Array.
+ */
+export declare function serializeExecutionReport(executionReport: ExecutionReport<CCIPMessage<typeof CCIPVersion.V1_6>>): Uint8Array;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/sui/manuallyExec/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/sui/manuallyExec/encoder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AA4B/E;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,CAAC,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GACrE,UAAU,CA+CZ"}

package/dist/sui/manuallyExec/encoder.js

@@ -0,0 +1,76 @@
+import { bcs } from '@mysten/sui/bcs';
+import { CCIPMessageInvalidError } from "../../errors/specialized.js";
+import { decodeExtraArgs } from "../../extra-args.js";
+import { bytesToBuffer, getAddressBytes, getDataBytes, networkInfo } from "../../utils.js";
+const Any2SuiTokenTransferBCS = bcs.struct('Any2SuiTokenTransfer', {
+    source_pool_address: bcs.vector(bcs.u8()),
+    dest_token_address: bcs.Address,
+    dest_gas_amount: bcs.u32(),
+    extra_data: bcs.vector(bcs.u8()),
+    amount: bcs.u256(),
+});
+const ExecutionReportBCS = bcs.struct('ExecutionReport', {
+    source_chain_selector: bcs.u64(),
+    message_id: bcs.fixedArray(32, bcs.u8()),
+    header_source_chain_selector: bcs.u64(),
+    dest_chain_selector: bcs.u64(),
+    sequence_number: bcs.u64(),
+    nonce: bcs.u64(),
+    sender: bcs.vector(bcs.u8()),
+    data: bcs.vector(bcs.u8()),
+    receiver: bcs.Address,
+    gas_limit: bcs.u256(),
+    token_receiver: bcs.Address,
+    token_amounts: bcs.vector(Any2SuiTokenTransferBCS),
+    offchain_token_data: bcs.vector(bcs.vector(bcs.u8())),
+    proofs: bcs.vector(bcs.fixedArray(32, bcs.u8())),
+});
+/**
+ * Serializes an execution report for Sui manual execution.
+ * @param executionReport - The execution report to serialize.
+ * @returns Serialized execution report as Uint8Array.
+ */
+export function serializeExecutionReport(executionReport) {
+    const { message, offchainTokenData, proofs } = executionReport;
+    if (!message) {
+        throw new CCIPMessageInvalidError('Message is undefined in execution report');
+    }
+    let gasLimit, tokenReceiver;
+    if ('receiverObjectIds' in message) {
+        ;
+        ({ gasLimit, tokenReceiver } = message);
+    }
+    else {
+        const decodedExtraArgs = decodeExtraArgs(message.extraArgs, networkInfo(message.sourceChainSelector).family);
+        if (decodedExtraArgs?._tag !== 'SuiExtraArgsV1')
+            throw new CCIPMessageInvalidError('Expected Sui extra args');
+        ({ gasLimit, tokenReceiver } = decodedExtraArgs);
+    }
+    const reportData = {
+        source_chain_selector: message.sourceChainSelector,
+        message_id: Array.from(bytesToBuffer(message.messageId)),
+        header_source_chain_selector: message.sourceChainSelector,
+        dest_chain_selector: message.destChainSelector,
+        sequence_number: message.sequenceNumber,
+        nonce: message.nonce,
+        sender: Array.from(bytesToBuffer(message.sender)),
+        data: Array.from(bytesToBuffer(message.data)),
+        receiver: message.receiver,
+        gas_limit: gasLimit,
+        token_receiver: tokenReceiver,
+        token_amounts: message.tokenAmounts.map((token) => ({
+            source_pool_address: Array.from(getAddressBytes(token.sourcePoolAddress)),
+            dest_token_address: token.destTokenAddress,
+            dest_gas_amount: Number(token.destGasAmount || 0n), // Use actual destGasAmount from token data
+            extra_data: Array.from(getDataBytes(token.extraData)),
+            amount: BigInt(token.amount),
+        })),
+        // TODO: encode as per CCTP/LBTC TPs, when available
+        offchain_token_data: offchainTokenData.map(() => Buffer.from([])),
+        proofs: proofs.map((proof) => {
+            return Array.from(getDataBytes(proof));
+        }),
+    };
+    return ExecutionReportBCS.serialize(reportData).toBytes();
+}
+//# sourceMappingURL=encoder.js.map

package/dist/sui/manuallyExec/encoder.js.map

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

package/dist/sui/manuallyExec/index.d.ts

@@ -0,0 +1,37 @@
+import { Transaction } from '@mysten/sui/transactions';
+import type { ExecutionReport } from '../../types.ts';
+import type { CCIPMessage_V1_6_Sui } from '../types.ts';
+/** Configuration for manually executing a Sui receiver module. */
+export type ManuallyExecuteSuiReceiverConfig = {
+    moduleName: string;
+    packageId: string;
+};
+/** Configuration for a token pool in manual execution. */
+export type TokenConfig = {
+    tokenPoolPackageId: string;
+    tokenPoolModule: string;
+    tokenType: string;
+    administrator: string;
+    pendingAdministrator: string;
+    tokenPoolTypeProof: string;
+    lockOrBurnParams: string[];
+    releaseOrMintParams: string[];
+};
+/** Input parameters for building a Sui manual execution transaction. */
+export type SuiManuallyExecuteInput = {
+    offrampAddress: string;
+    executionReport: ExecutionReport<CCIPMessage_V1_6_Sui>;
+    ccipAddress: string;
+    ccipObjectRef: string;
+    offrampStateObject: string;
+    receiverConfig: ManuallyExecuteSuiReceiverConfig;
+    tokenConfigs?: TokenConfig[];
+    overrideReceiverObjectIds?: string[];
+};
+/**
+ * Builds a Sui Programmable Transaction Block for manual CCIP message execution.
+ * @param params - Input parameters for building the manual execution transaction.
+ * @returns A Transaction object ready to be signed and executed.
+ */
+export declare function buildManualExecutionPTB({ offrampAddress, executionReport, ccipAddress, ccipObjectRef, offrampStateObject, receiverConfig, tokenConfigs, overrideReceiverObjectIds, }: SuiManuallyExecuteInput): Transaction;
+//# sourceMappingURL=index.d.ts.map

package/dist/sui/manuallyExec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sui/manuallyExec/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAKtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,kEAAkE;AAClE,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC9B,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAA;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,gCAAgC,CAAA;IAChD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAA;CACrC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,yBAAyB,GAC1B,EAAE,uBAAuB,GAAG,WAAW,CAmFvC"}

package/dist/sui/manuallyExec/index.js

@@ -0,0 +1,81 @@
+import { Transaction } from '@mysten/sui/transactions';
+import { serializeExecutionReport } from "./encoder.js";
+import { CCIPMessageInvalidError } from "../../errors/specialized.js";
+import { decodeExtraArgs } from "../../extra-args.js";
+import { networkInfo } from "../../utils.js";
+/**
+ * Builds a Sui Programmable Transaction Block for manual CCIP message execution.
+ * @param params - Input parameters for building the manual execution transaction.
+ * @returns A Transaction object ready to be signed and executed.
+ */
+export function buildManualExecutionPTB({ offrampAddress, executionReport, ccipAddress, ccipObjectRef, offrampStateObject, receiverConfig, tokenConfigs, overrideReceiverObjectIds, }) {
+    const reportBytes = serializeExecutionReport(executionReport);
+    // Create transaction
+    const tx = new Transaction();
+    // Step 1: Call manually_init_execute to prepare the execution
+    const receiverParamsArg = tx.moveCall({
+        target: `${offrampAddress}::offramp::manually_init_execute`,
+        arguments: [
+            tx.object(ccipObjectRef),
+            tx.object(offrampStateObject),
+            tx.object('0x6'), // Clock object
+            tx.pure.vector('u8', Array.from(reportBytes)),
+        ],
+    });
+    // Get the message from the from the report using the offramp helper
+    const messageArg = tx.moveCall({
+        target: `${ccipAddress}::offramp_state_helper::extract_any2sui_message`,
+        arguments: [receiverParamsArg],
+    });
+    // Process token pool transfers
+    if (tokenConfigs && tokenConfigs.length > 0) {
+        if (executionReport.message.tokenAmounts.length !== tokenConfigs.length) {
+            throw new CCIPMessageInvalidError('Token amounts length does not match token configs length');
+        }
+        // Process each token transfer
+        for (let i = 0; i < tokenConfigs.length; i++) {
+            const tokenConfig = tokenConfigs[i];
+            tx.moveCall({
+                target: `${tokenConfig.tokenPoolPackageId}::${tokenConfig.tokenPoolModule}::release_or_mint`,
+                typeArguments: [tokenConfig.tokenType],
+                arguments: [
+                    tx.object(ccipObjectRef), // CCIPObjectRef
+                    receiverParamsArg, // ReceiverParams (mutable)
+                    ...tokenConfig.releaseOrMintParams.map((param) => tx.object(param)), // Pool-specific objects (clock, deny_list, token_state, state, etc.)
+                ],
+            });
+        }
+    }
+    // Decode extraArgs to get receiverObjectIds
+    const decodedExtraArgs = decodeExtraArgs(executionReport.message.extraArgs, networkInfo(executionReport.message.destChainSelector).family);
+    if (!decodedExtraArgs || decodedExtraArgs._tag !== 'SuiExtraArgsV1') {
+        throw new CCIPMessageInvalidError('Expected Sui extra args');
+    }
+    if (decodedExtraArgs.receiverObjectIds.length === 0) {
+        throw new CCIPMessageInvalidError('No receiverObjectIds provided in SUIExtraArgsV1');
+    }
+    // Call the receiver contract
+    tx.moveCall({
+        target: `${receiverConfig.packageId}::${receiverConfig.moduleName}::ccip_receive`,
+        arguments: [
+            tx.pure.vector('u8', Buffer.from(executionReport.message.messageId.slice(2), 'hex')),
+            tx.object(ccipObjectRef),
+            messageArg,
+            // if overrideReceiverObjectIds is provided, use them; otherwise, use the ones from decodedExtraArgs (original message)
+            ...(overrideReceiverObjectIds && overrideReceiverObjectIds.length > 0
+                ? overrideReceiverObjectIds.map(tx.object)
+                : decodedExtraArgs.receiverObjectIds.map(tx.object)),
+        ],
+    });
+    // Step 2: Call finish_execute to complete the execution
+    tx.moveCall({
+        target: `${offrampAddress}::offramp::finish_execute`,
+        arguments: [
+            tx.object(ccipObjectRef),
+            tx.object(offrampStateObject),
+            receiverParamsArg, // ReceiverParams from manually_init_execute
+        ],
+    });
+    return tx;
+}
+//# sourceMappingURL=index.js.map

package/dist/sui/manuallyExec/index.js.map

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

package/dist/sui/objects.d.ts

@@ -0,0 +1,46 @@
+import type { SuiClient } from '@mysten/sui/client';
+import type { CCIPMessage, CCIPVersion } from '../types.ts';
+/**
+ * Derive a dynamic field object ID using the Sui algorithm
+ * This matches the Go implementation in chainlink-sui
+ */
+export declare function deriveObjectID(parentAddress: string, keyBytes: Uint8Array): string;
+/**
+ * Get the CCIPObjectRef ID for a CCIP package
+ */
+export declare function getCcipObjectRef(client: SuiClient, ccipPackageId: string): Promise<string>;
+/**
+ * Get the OffRampState object ID for an offramp package
+ */
+export declare function getOffRampStateObject(client: SuiClient, offrampPackageId: string): Promise<string>;
+/**
+ * Get the receiver module configuration from the receiver registry.
+ * @param provider - Sui client
+ * @param ccipPackageId - CCIP package ID
+ * @param ccipObjectRef - CCIP object reference
+ * @param receiverPackageId - Receiver package ID
+ * @returns Receiver module name and package ID
+ */
+export declare function getReceiverModule(provider: SuiClient, ccipPackageId: string, ccipObjectRef: string, receiverPackageId: string): Promise<{
+    moduleName: string;
+    packageId: string;
+}>;
+/**
+ * Fetch token configurations for the given token amounts.
+ * @param client - Sui client
+ * @param ccipPackageId - CCIP package ID
+ * @param ccipObjectRef - CCIP object reference
+ * @param tokenAmounts - Token amounts from CCIP message
+ * @returns Array of token configurations
+ */
+export declare function fetchTokenConfigs(client: SuiClient, ccipPackageId: string, ccipObjectRef: string, tokenAmounts: CCIPMessage<typeof CCIPVersion.V1_6>['tokenAmounts']): Promise<{
+    tokenPoolPackageId: string;
+    tokenPoolModule: string;
+    tokenType: string;
+    administrator: string;
+    pendingAdministrator: string;
+    tokenPoolTypeProof: string;
+    lockOrBurnParams: string[];
+    releaseOrMintParams: string[];
+}[]>;
+//# sourceMappingURL=objects.d.ts.map

package/dist/sui/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/sui/objects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAMnD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAsClF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwChG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,SAAS,EACnB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM;;;GA+C1B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,WAAW,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC;;;;;;;;;KA2InE"}

package/dist/sui/objects.js

@@ -0,0 +1,259 @@
+import { bcs } from '@mysten/sui/bcs';
+import { Transaction } from '@mysten/sui/transactions';
+import { normalizeSuiAddress } from '@mysten/sui/utils';
+import { blake2b } from '@noble/hashes/blake2';
+import { CCIPDataFormatUnsupportedError } from "../errors/index.js";
+/**
+ * Derive a dynamic field object ID using the Sui algorithm
+ * This matches the Go implementation in chainlink-sui
+ */
+export function deriveObjectID(parentAddress, keyBytes) {
+    // Normalize parent address to 32 bytes
+    const normalizedParent = normalizeSuiAddress(parentAddress);
+    const parentBytes = bcs.Address.serialize(normalizedParent).toBytes();
+    // BCS serialize the key (vector<u8>)
+    const bcsKeyBytes = bcs.vector(bcs.u8()).serialize(Array.from(keyBytes)).toBytes();
+    // Construct TypeTag for DerivedObjectKey<vector<u8>>
+    const suiFrameworkAddress = bcs.Address.serialize('0x2').toBytes();
+    const typeTagBytes = new Uint8Array([
+        0x07, // TypeTag::Struct
+        ...suiFrameworkAddress,
+        0x0e, // module length
+        ...new TextEncoder().encode('derived_object'),
+        0x10, // struct name length
+        ...new TextEncoder().encode('DerivedObjectKey'),
+        0x01, // type params count
+        ...[0x06, 0x01], // vector<u8> TypeTag
+    ]);
+    // Build the hash input
+    const keyLenBytes = new Uint8Array(8);
+    new DataView(keyLenBytes.buffer).setBigUint64(0, BigInt(bcsKeyBytes.length), true);
+    const hashInput = new Uint8Array([
+        0xf0, // HashingIntentScope::ChildObjectId
+        ...parentBytes,
+        ...keyLenBytes,
+        ...bcsKeyBytes,
+        ...typeTagBytes,
+    ]);
+    // Hash with Blake2b-256
+    const hash = blake2b(hashInput, { dkLen: 32 });
+    // Convert to address string
+    return normalizeSuiAddress('0x' + Buffer.from(hash).toString('hex'));
+}
+/**
+ * Get the CCIPObjectRef ID for a CCIP package
+ */
+export async function getCcipObjectRef(client, ccipPackageId) {
+    // Get the pointer to find the CCIPObject ID
+    const pointerResponse = await client.getOwnedObjects({
+        owner: ccipPackageId,
+        filter: {
+            StructType: `${ccipPackageId}::state_object::CCIPObjectRefPointer`,
+        },
+    });
+    if (pointerResponse.data.length === 0) {
+        throw new CCIPDataFormatUnsupportedError('No CCIPObjectRefPointer found for the given packageId');
+    }
+    // Get the pointer object to extract ccip_object_id
+    const pointerId = pointerResponse.data[0].data?.objectId;
+    if (!pointerId) {
+        throw new CCIPDataFormatUnsupportedError('Pointer does not have objectId');
+    }
+    const pointerObject = await client.getObject({
+        id: pointerId,
+        options: { showContent: true },
+    });
+    if (pointerObject.data?.content?.dataType !== 'moveObject') {
+        throw new CCIPDataFormatUnsupportedError('Pointer object is not a Move object');
+    }
+    const ccipObjectId = pointerObject.data.content.fields['ccip_object_id'];
+    if (!ccipObjectId) {
+        throw new CCIPDataFormatUnsupportedError('Could not find ccip_object_id in pointer');
+    }
+    // Derive the CCIPObjectRef ID from the parent CCIPObject ID
+    return deriveObjectID(ccipObjectId, new TextEncoder().encode('CCIPObjectRef'));
+}
+/**
+ * Get the OffRampState object ID for an offramp package
+ */
+export async function getOffRampStateObject(client, offrampPackageId) {
+    const offrampPointerResponse = await client.getOwnedObjects({
+        owner: offrampPackageId,
+        filter: {
+            StructType: `${offrampPackageId}::offramp::OffRampStatePointer`,
+        },
+    });
+    if (offrampPointerResponse.data.length === 0) {
+        throw new CCIPDataFormatUnsupportedError('No OffRampStatePointer found for the given offramp package');
+    }
+    const offrampPointerId = offrampPointerResponse.data[0].data?.objectId;
+    if (!offrampPointerId) {
+        throw new CCIPDataFormatUnsupportedError('OffRampStatePointer does not have a valid objectId');
+    }
+    const offrampPointerObject = await client.getObject({
+        id: offrampPointerId,
+        options: { showContent: true },
+    });
+    if (offrampPointerObject.data?.content?.dataType !== 'moveObject') {
+        throw new CCIPDataFormatUnsupportedError('OffRamp pointer object is not a Move object');
+    }
+    const offrampObjectId = offrampPointerObject.data.content.fields['off_ramp_object_id'];
+    if (!offrampObjectId) {
+        throw new CCIPDataFormatUnsupportedError('Could not find off_ramp_object_id in pointer');
+    }
+    // Derive the OffRampState ID from the parent OffRamp Object ID
+    return deriveObjectID(offrampObjectId, new TextEncoder().encode('OffRampState'));
+}
+/**
+ * Get the receiver module configuration from the receiver registry.
+ * @param provider - Sui client
+ * @param ccipPackageId - CCIP package ID
+ * @param ccipObjectRef - CCIP object reference
+ * @param receiverPackageId - Receiver package ID
+ * @returns Receiver module name and package ID
+ */
+export async function getReceiverModule(provider, ccipPackageId, ccipObjectRef, receiverPackageId) {
+    // Call get_receiver_config from receiver_registry contract
+    const tx = new Transaction();
+    tx.moveCall({
+        target: `${ccipPackageId}::receiver_registry::get_receiver_config`,
+        arguments: [tx.object(ccipObjectRef), tx.pure.address(receiverPackageId)],
+    });
+    const result = await provider.devInspectTransactionBlock({
+        transactionBlock: tx,
+        sender: '0x0000000000000000000000000000000000000000000000000000000000000000',
+    });
+    if (result.error) {
+        throw new CCIPDataFormatUnsupportedError(`Failed to call get_receiver_config: ${result.error}`);
+    }
+    if (!result.results || result.results.length === 0) {
+        throw new CCIPDataFormatUnsupportedError('No results returned from get_receiver_config');
+    }
+    const returnValues = result.results[0]?.returnValues;
+    if (!returnValues || returnValues.length === 0) {
+        throw new CCIPDataFormatUnsupportedError('No return values from get_receiver_config');
+    }
+    // Decode the ReceiverConfig struct
+    // ReceiverConfig has two fields: module_name (String) and proof_typename (ascii::String)
+    // The struct is returned as a BCS-encoded byte array
+    const receiverConfigBytes = returnValues[0][0];
+    // Parse the struct:
+    // First field is module_name (String = vector<u8> with length prefix)
+    let offset = 0;
+    const moduleNameLength = receiverConfigBytes[offset];
+    offset += 1;
+    const moduleName = new TextDecoder().decode(new Uint8Array(receiverConfigBytes.slice(offset, offset + moduleNameLength)));
+    return {
+        moduleName,
+        packageId: receiverPackageId,
+    };
+}
+/**
+ * Fetch token configurations for the given token amounts.
+ * @param client - Sui client
+ * @param ccipPackageId - CCIP package ID
+ * @param ccipObjectRef - CCIP object reference
+ * @param tokenAmounts - Token amounts from CCIP message
+ * @returns Array of token configurations
+ */
+export async function fetchTokenConfigs(client, ccipPackageId, ccipObjectRef, tokenAmounts) {
+    if (tokenAmounts.length === 0) {
+        return [];
+    }
+    const tokenConfigs = [];
+    const tokenAddresses = [
+        ...new Set(tokenAmounts.map((token) => token.destTokenAddress).filter((addr) => addr && addr !== '0x0')),
+    ];
+    // Fetch token config for each unique token address
+    for (const tokenAddress of tokenAddresses) {
+        const tx = new Transaction();
+        // Call get_token_config_struct from token_admin_registry
+        tx.moveCall({
+            target: `${ccipPackageId}::token_admin_registry::get_token_config_struct`,
+            arguments: [tx.object(ccipObjectRef), tx.pure.address(tokenAddress)],
+        });
+        const result = await client.devInspectTransactionBlock({
+            transactionBlock: tx,
+            sender: '0x0000000000000000000000000000000000000000000000000000000000000000',
+        });
+        if (result.error) {
+            throw new CCIPDataFormatUnsupportedError(`Failed to fetch token config for ${tokenAddress}: ${result.error}`);
+        }
+        if (!result.results || result.results.length === 0) {
+            throw new CCIPDataFormatUnsupportedError(`No results returned from get_token_config_struct for ${tokenAddress}`);
+        }
+        const returnValues = result.results[0]?.returnValues;
+        if (!returnValues || returnValues.length === 0) {
+            throw new CCIPDataFormatUnsupportedError(`No return values from get_token_config_struct for ${tokenAddress}`);
+        }
+        // Parse the TokenConfig struct from BCS-encoded bytes
+        const configBytes = returnValues[0][0];
+        // TokenConfig structure (from token_admin_registry.go):
+        // - TokenPoolPackageId (address = 32 bytes)
+        // - TokenPoolModule (String = length + bytes)
+        // - TokenType (ascii::String = length + bytes)
+        // - Administrator (address = 32 bytes)
+        // - PendingAdministrator (address = 32 bytes)
+        // - TokenPoolTypeProof (ascii::String = length + bytes)
+        // - LockOrBurnParams (vector<address> = length + N * 32 bytes)
+        // - ReleaseOrMintParams (vector<address> = length + N * 32 bytes)
+        let offset = 0;
+        // TokenPoolPackageId (32 bytes)
+        const tokenPoolPackageIdBytes = configBytes.slice(offset, offset + 32);
+        const tokenPoolPackageId = normalizeSuiAddress('0x' + Buffer.from(tokenPoolPackageIdBytes).toString('hex'));
+        offset += 32;
+        // TokenPoolModule (String)
+        const moduleNameLength = configBytes[offset];
+        offset += 1;
+        const tokenPoolModule = new TextDecoder().decode(new Uint8Array(configBytes.slice(offset, offset + moduleNameLength)));
+        offset += moduleNameLength;
+        // TokenType (ascii::String)
+        const tokenTypeLength = configBytes[offset];
+        offset += 1;
+        const tokenType = new TextDecoder().decode(new Uint8Array(configBytes.slice(offset, offset + tokenTypeLength)));
+        offset += tokenTypeLength;
+        // Administrator (32 bytes)
+        const administratorBytes = configBytes.slice(offset, offset + 32);
+        const administrator = normalizeSuiAddress('0x' + Buffer.from(administratorBytes).toString('hex'));
+        offset += 32;
+        // PendingAdministrator (32 bytes)
+        const pendingAdminBytes = configBytes.slice(offset, offset + 32);
+        const pendingAdministrator = normalizeSuiAddress('0x' + Buffer.from(pendingAdminBytes).toString('hex'));
+        offset += 32;
+        // TokenPoolTypeProof (ascii::String)
+        const proofLength = configBytes[offset];
+        offset += 1;
+        const tokenPoolTypeProof = new TextDecoder().decode(new Uint8Array(configBytes.slice(offset, offset + proofLength)));
+        offset += proofLength;
+        // LockOrBurnParams (vector<address>)
+        const lockOrBurnCount = configBytes[offset];
+        offset += 1;
+        const lockOrBurnParams = [];
+        for (let i = 0; i < lockOrBurnCount; i++) {
+            const addrBytes = configBytes.slice(offset, offset + 32);
+            lockOrBurnParams.push(normalizeSuiAddress('0x' + Buffer.from(addrBytes).toString('hex')));
+            offset += 32;
+        }
+        // ReleaseOrMintParams (vector<address>)
+        const releaseOrMintCount = configBytes[offset];
+        offset += 1;
+        const releaseOrMintParams = [];
+        for (let i = 0; i < releaseOrMintCount; i++) {
+            const addrBytes = configBytes.slice(offset, offset + 32);
+            releaseOrMintParams.push(normalizeSuiAddress('0x' + Buffer.from(addrBytes).toString('hex')));
+            offset += 32;
+        }
+        tokenConfigs.push({
+            tokenPoolPackageId,
+            tokenPoolModule,
+            tokenType,
+            administrator,
+            pendingAdministrator,
+            tokenPoolTypeProof,
+            lockOrBurnParams,
+            releaseOrMintParams,
+        });
+    }
+    return tokenConfigs;
+}
+//# sourceMappingURL=objects.js.map

package/dist/sui/objects.js.map

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

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

@@ -0,0 +1,48 @@
+import type { Address, ContractProvider } from '@ton/core';
+/**
+ * Configuration for a source chain on the TON OffRamp contract.
+ */
+export interface SourceChainConfig {
+    router: Address;
+    isEnabled: boolean;
+    minSeqNr: bigint;
+    isRMNVerificationDisabled: boolean;
+    onRamp: Buffer;
+}
+/**
+ * Dynamic configuration for the OffRamp contract.
+ * Contains addresses that can be updated without redeploying the contract.
+ */
+export interface DynamicConfig {
+    router: Address;
+    feeQuoter: Address;
+    permissionlessExecutionThresholdSeconds: number;
+}
+/**
+ * TON OffRamp contract binding.
+ * The OffRamp receives and executes cross-chain messages on the destination (TON) chain.
+ */
+export declare class OffRamp {
+    readonly address: Address;
+    /**
+     * Creates a new OffRamp instance.
+     * @param address - The OffRamp contract address on TON.
+     */
+    constructor(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: Address): OffRamp;
+    /**
+     * 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.
+     */
+    getSourceChainConfig(provider: ContractProvider, sourceChainSelector: bigint): Promise<SourceChainConfig>;
+}
+//# sourceMappingURL=offramp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offramp.d.ts","sourceRoot":"","sources":["../../../src/ton/bindings/offramp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,yBAAyB,EAAE,OAAO,CAAA;IAClC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,uCAAuC,EAAE,MAAM,CAAA;CAChD;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB;;;OAGG;gBACS,OAAO,EAAE,OAAO;IAI5B;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAInD;;;;;;;OAOG;IACG,oBAAoB,CACxB,QAAQ,EAAE,gBAAgB,EAC1B,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,iBAAiB,CAAC;CAoC9B"}