@tonappchain/sdk 0.7.3-rc1 → 0.7.3-rc2

package/dist/artifacts/dev/index.d.ts

@@ -1,9 +1,9 @@
 import { DEV_AGNOSTIC_PROXY_ADDRESS as AGNOSTIC_PROXY_ADDRESS, DEV_MULTICALL_3_ADDRESS as MULTICALL_3_ADDRESS, DEV_TAC_SETTINGS_ADDRESS as TAC_SETTINGS_ADDRESS, DEV_TAC_SMART_ACCOUNT_FACTORY_ADDRESS as TAC_SMART_ACCOUNT_FACTORY_ADDRESS } from './tac/addresses';
 import { DEV_PUBLIC_LITE_SEQUENCER_ENDPOINTS as PUBLIC_LITE_SEQUENCER_ENDPOINTS, DEV_TAC_RPC_ENDPOINT as TAC_RPC_ENDPOINT, DEV_TAC_EXPLORER_API_ENDPOINT as TAC_EXPLORER_API_ENDPOINT } from "./tac/endpoints";
 import { DEV_TON_SETTINGS_ADDRESS as TON_SETTINGS_ADDRESS } from './ton/addresses';
-import { DEV_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, DEV_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, DEV_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC } from "./ton/endpoints";
+import { DEV_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, DEV_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, DEV_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC, DEV_TONCENTER_V3_INDEXER_ENDPOINT as TONCENTER_V3_INDEXER_ENDPOINT } from "./ton/endpoints";
 export * as tac from "./tac";
 export { PUBLIC_LITE_SEQUENCER_ENDPOINTS, TAC_RPC_ENDPOINT, TAC_EXPLORER_API_ENDPOINT };
 export * as ton from "./ton";
-export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC };
+export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC, TONCENTER_V3_INDEXER_ENDPOINT };
 export { AGNOSTIC_PROXY_ADDRESS, MULTICALL_3_ADDRESS, TAC_SETTINGS_ADDRESS, TAC_SMART_ACCOUNT_FACTORY_ADDRESS, TON_SETTINGS_ADDRESS };

package/dist/artifacts/dev/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
+exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TONCENTER_V3_INDEXER_ENDPOINT = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
 const addresses_1 = require("./tac/addresses");
 Object.defineProperty(exports, "AGNOSTIC_PROXY_ADDRESS", { enumerable: true, get: function () { return addresses_1.DEV_AGNOSTIC_PROXY_ADDRESS; } });
 Object.defineProperty(exports, "MULTICALL_3_ADDRESS", { enumerable: true, get: function () { return addresses_1.DEV_MULTICALL_3_ADDRESS; } });
@@ -49,5 +49,6 @@ const endpoints_2 = require("./ton/endpoints");
 Object.defineProperty(exports, "DEFAULT_LITESERVERS", { enumerable: true, get: function () { return endpoints_2.DEV_DEFAULT_LITESERVERS; } });
 Object.defineProperty(exports, "TON_PUBLIC_RPC_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.DEV_TON_PUBLIC_RPC_ENDPOINT; } });
 Object.defineProperty(exports, "TON_RPC_ENDPOINT_BY_TAC", { enumerable: true, get: function () { return endpoints_2.DEV_TON_RPC_ENDPOINT_BY_TAC; } });
+Object.defineProperty(exports, "TONCENTER_V3_INDEXER_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.DEV_TONCENTER_V3_INDEXER_ENDPOINT; } });
 exports.tac = __importStar(require("./tac"));
 exports.ton = __importStar(require("./ton"));

package/dist/artifacts/dev/ton/endpoints.d.ts

@@ -1,3 +1,4 @@
 export declare const DEV_DEFAULT_LITESERVERS = "";
 export declare const DEV_TON_PUBLIC_RPC_ENDPOINT = "";
 export declare const DEV_TON_RPC_ENDPOINT_BY_TAC = "";
+export declare const DEV_TONCENTER_V3_INDEXER_ENDPOINT = "";

package/dist/artifacts/dev/ton/endpoints.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEV_TON_RPC_ENDPOINT_BY_TAC = exports.DEV_TON_PUBLIC_RPC_ENDPOINT = exports.DEV_DEFAULT_LITESERVERS = void 0;
+exports.DEV_TONCENTER_V3_INDEXER_ENDPOINT = exports.DEV_TON_RPC_ENDPOINT_BY_TAC = exports.DEV_TON_PUBLIC_RPC_ENDPOINT = exports.DEV_DEFAULT_LITESERVERS = void 0;
 exports.DEV_DEFAULT_LITESERVERS = "";
 exports.DEV_TON_PUBLIC_RPC_ENDPOINT = "";
 exports.DEV_TON_RPC_ENDPOINT_BY_TAC = "";
+exports.DEV_TONCENTER_V3_INDEXER_ENDPOINT = "";

package/dist/artifacts/mainnet/index.d.ts

@@ -1,9 +1,9 @@
 import { MAINNET_AGNOSTIC_PROXY_ADDRESS as AGNOSTIC_PROXY_ADDRESS, MAINNET_MULTICALL_3_ADDRESS as MULTICALL_3_ADDRESS, MAINNET_TAC_SETTINGS_ADDRESS as TAC_SETTINGS_ADDRESS, MAINNET_TAC_SMART_ACCOUNT_FACTORY_ADDRESS as TAC_SMART_ACCOUNT_FACTORY_ADDRESS } from './tac/addresses';
 import { MAINNET_PUBLIC_LITE_SEQUENCER_ENDPOINTS as PUBLIC_LITE_SEQUENCER_ENDPOINTS, MAINNET_TAC_RPC_ENDPOINT as TAC_RPC_ENDPOINT, MAINNET_TAC_EXPLORER_API_ENDPOINT as TAC_EXPLORER_API_ENDPOINT } from "./tac/endpoints";
 import { MAINNET_TON_SETTINGS_ADDRESS as TON_SETTINGS_ADDRESS } from './ton/addresses';
-import { MAINNET_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, MAINNET_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, MAINNET_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC } from "./ton/endpoints";
+import { MAINNET_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, MAINNET_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, MAINNET_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC, MAINNET_TONCENTER_V3_INDEXER_ENDPOINT as TONCENTER_V3_INDEXER_ENDPOINT } from "./ton/endpoints";
 export * as tac from "./tac";
 export { PUBLIC_LITE_SEQUENCER_ENDPOINTS, TAC_RPC_ENDPOINT, TAC_EXPLORER_API_ENDPOINT };
 export * as ton from "./ton";
-export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC };
+export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC, TONCENTER_V3_INDEXER_ENDPOINT };
 export { AGNOSTIC_PROXY_ADDRESS, MULTICALL_3_ADDRESS, TAC_SETTINGS_ADDRESS, TAC_SMART_ACCOUNT_FACTORY_ADDRESS, TON_SETTINGS_ADDRESS };

package/dist/artifacts/mainnet/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
+exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TONCENTER_V3_INDEXER_ENDPOINT = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
 const addresses_1 = require("./tac/addresses");
 Object.defineProperty(exports, "AGNOSTIC_PROXY_ADDRESS", { enumerable: true, get: function () { return addresses_1.MAINNET_AGNOSTIC_PROXY_ADDRESS; } });
 Object.defineProperty(exports, "MULTICALL_3_ADDRESS", { enumerable: true, get: function () { return addresses_1.MAINNET_MULTICALL_3_ADDRESS; } });
@@ -49,5 +49,6 @@ const endpoints_2 = require("./ton/endpoints");
 Object.defineProperty(exports, "DEFAULT_LITESERVERS", { enumerable: true, get: function () { return endpoints_2.MAINNET_DEFAULT_LITESERVERS; } });
 Object.defineProperty(exports, "TON_PUBLIC_RPC_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.MAINNET_TON_PUBLIC_RPC_ENDPOINT; } });
 Object.defineProperty(exports, "TON_RPC_ENDPOINT_BY_TAC", { enumerable: true, get: function () { return endpoints_2.MAINNET_TON_RPC_ENDPOINT_BY_TAC; } });
+Object.defineProperty(exports, "TONCENTER_V3_INDEXER_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.MAINNET_TONCENTER_V3_INDEXER_ENDPOINT; } });
 exports.tac = __importStar(require("./tac"));
 exports.ton = __importStar(require("./ton"));

package/dist/artifacts/mainnet/ton/endpoints.d.ts

@@ -1,3 +1,4 @@
 export declare const MAINNET_DEFAULT_LITESERVERS = "https://ton.org/global.config.json";
 export declare const MAINNET_TON_PUBLIC_RPC_ENDPOINT = "https://toncenter.com/api/v2/jsonRPC";
 export declare const MAINNET_TON_RPC_ENDPOINT_BY_TAC = "https://toncenter-mainnet.tac.build";
+export declare const MAINNET_TONCENTER_V3_INDEXER_ENDPOINT = "https://toncenter-mainnet.tac.build/api/v3/";

package/dist/artifacts/mainnet/ton/endpoints.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAINNET_TON_RPC_ENDPOINT_BY_TAC = exports.MAINNET_TON_PUBLIC_RPC_ENDPOINT = exports.MAINNET_DEFAULT_LITESERVERS = void 0;
+exports.MAINNET_TONCENTER_V3_INDEXER_ENDPOINT = exports.MAINNET_TON_RPC_ENDPOINT_BY_TAC = exports.MAINNET_TON_PUBLIC_RPC_ENDPOINT = exports.MAINNET_DEFAULT_LITESERVERS = void 0;
 exports.MAINNET_DEFAULT_LITESERVERS = 'https://ton.org/global.config.json';
 exports.MAINNET_TON_PUBLIC_RPC_ENDPOINT = 'https://toncenter.com/api/v2/jsonRPC';
 exports.MAINNET_TON_RPC_ENDPOINT_BY_TAC = 'https://toncenter-mainnet.tac.build';
+exports.MAINNET_TONCENTER_V3_INDEXER_ENDPOINT = 'https://toncenter-mainnet.tac.build/api/v3/';

package/dist/artifacts/testnet/index.d.ts

@@ -1,9 +1,9 @@
 import { TESTNET_AGNOSTIC_PROXY_ADDRESS as AGNOSTIC_PROXY_ADDRESS, TESTNET_MULTICALL_3_ADDRESS as MULTICALL_3_ADDRESS, TESTNET_TAC_SETTINGS_ADDRESS as TAC_SETTINGS_ADDRESS, TESTNET_TAC_SMART_ACCOUNT_FACTORY_ADDRESS as TAC_SMART_ACCOUNT_FACTORY_ADDRESS } from './tac/addresses';
 import { TESTNET_PUBLIC_LITE_SEQUENCER_ENDPOINTS as PUBLIC_LITE_SEQUENCER_ENDPOINTS, TESTNET_TAC_RPC_ENDPOINT as TAC_RPC_ENDPOINT, TESTNET_TAC_EXPLORER_API_ENDPOINT as TAC_EXPLORER_API_ENDPOINT } from "./tac/endpoints";
 import { TESTNET_TON_SETTINGS_ADDRESS as TON_SETTINGS_ADDRESS } from './ton/addresses';
-import { TESTNET_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, TESTNET_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, TESTNET_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC } from "./ton/endpoints";
+import { TESTNET_DEFAULT_LITESERVERS as DEFAULT_LITESERVERS, TESTNET_TON_PUBLIC_RPC_ENDPOINT as TON_PUBLIC_RPC_ENDPOINT, TESTNET_TON_RPC_ENDPOINT_BY_TAC as TON_RPC_ENDPOINT_BY_TAC, TESTNET_TONCENTER_V3_INDEXER_ENDPOINT as TONCENTER_V3_INDEXER_ENDPOINT } from "./ton/endpoints";
 export * as tac from "./tac";
 export { PUBLIC_LITE_SEQUENCER_ENDPOINTS, TAC_RPC_ENDPOINT, TAC_EXPLORER_API_ENDPOINT };
 export * as ton from "./ton";
-export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC };
+export { DEFAULT_LITESERVERS, TON_PUBLIC_RPC_ENDPOINT, TON_RPC_ENDPOINT_BY_TAC, TONCENTER_V3_INDEXER_ENDPOINT };
 export { AGNOSTIC_PROXY_ADDRESS, MULTICALL_3_ADDRESS, TAC_SETTINGS_ADDRESS, TAC_SMART_ACCOUNT_FACTORY_ADDRESS, TON_SETTINGS_ADDRESS };

package/dist/artifacts/testnet/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
+exports.TON_SETTINGS_ADDRESS = exports.TAC_SMART_ACCOUNT_FACTORY_ADDRESS = exports.TAC_SETTINGS_ADDRESS = exports.MULTICALL_3_ADDRESS = exports.AGNOSTIC_PROXY_ADDRESS = exports.TONCENTER_V3_INDEXER_ENDPOINT = exports.TON_RPC_ENDPOINT_BY_TAC = exports.TON_PUBLIC_RPC_ENDPOINT = exports.DEFAULT_LITESERVERS = exports.ton = exports.TAC_EXPLORER_API_ENDPOINT = exports.TAC_RPC_ENDPOINT = exports.PUBLIC_LITE_SEQUENCER_ENDPOINTS = exports.tac = void 0;
 const addresses_1 = require("./tac/addresses");
 Object.defineProperty(exports, "AGNOSTIC_PROXY_ADDRESS", { enumerable: true, get: function () { return addresses_1.TESTNET_AGNOSTIC_PROXY_ADDRESS; } });
 Object.defineProperty(exports, "MULTICALL_3_ADDRESS", { enumerable: true, get: function () { return addresses_1.TESTNET_MULTICALL_3_ADDRESS; } });
@@ -49,5 +49,6 @@ const endpoints_2 = require("./ton/endpoints");
 Object.defineProperty(exports, "DEFAULT_LITESERVERS", { enumerable: true, get: function () { return endpoints_2.TESTNET_DEFAULT_LITESERVERS; } });
 Object.defineProperty(exports, "TON_PUBLIC_RPC_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.TESTNET_TON_PUBLIC_RPC_ENDPOINT; } });
 Object.defineProperty(exports, "TON_RPC_ENDPOINT_BY_TAC", { enumerable: true, get: function () { return endpoints_2.TESTNET_TON_RPC_ENDPOINT_BY_TAC; } });
+Object.defineProperty(exports, "TONCENTER_V3_INDEXER_ENDPOINT", { enumerable: true, get: function () { return endpoints_2.TESTNET_TONCENTER_V3_INDEXER_ENDPOINT; } });
 exports.tac = __importStar(require("./tac"));
 exports.ton = __importStar(require("./ton"));

package/dist/artifacts/testnet/ton/endpoints.d.ts

@@ -1,3 +1,4 @@
 export declare const TESTNET_DEFAULT_LITESERVERS = "https://ton.org/testnet-global.config.json";
 export declare const TESTNET_TON_PUBLIC_RPC_ENDPOINT = "https://testnet.toncenter.com/api/v2/jsonRPC";
 export declare const TESTNET_TON_RPC_ENDPOINT_BY_TAC = "https://toncenter-spb.tac.build";
+export declare const TESTNET_TONCENTER_V3_INDEXER_ENDPOINT = "https://toncenter-spb.tac.build/api/v3/";

package/dist/artifacts/testnet/ton/endpoints.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TESTNET_TON_RPC_ENDPOINT_BY_TAC = exports.TESTNET_TON_PUBLIC_RPC_ENDPOINT = exports.TESTNET_DEFAULT_LITESERVERS = void 0;
+exports.TESTNET_TONCENTER_V3_INDEXER_ENDPOINT = exports.TESTNET_TON_RPC_ENDPOINT_BY_TAC = exports.TESTNET_TON_PUBLIC_RPC_ENDPOINT = exports.TESTNET_DEFAULT_LITESERVERS = void 0;
 exports.TESTNET_DEFAULT_LITESERVERS = 'https://ton.org/testnet-global.config.json';
 exports.TESTNET_TON_PUBLIC_RPC_ENDPOINT = 'https://testnet.toncenter.com/api/v2/jsonRPC';
 exports.TESTNET_TON_RPC_ENDPOINT_BY_TAC = 'https://toncenter-spb.tac.build';
+exports.TESTNET_TONCENTER_V3_INDEXER_ENDPOINT = 'https://toncenter-spb.tac.build/api/v3/';

package/dist/src/adapters/RetryableContractOpener.d.ts

@@ -7,8 +7,12 @@ export interface OpenerConfig {
     opener: ContractOpener;
     /** Number of retry attempts before falling back to the next opener. */
     retries: number;
-    /** Delay in milliseconds between retries for this opener. */
+    /** Base delay in milliseconds between retries for this opener. */
     retryDelay: number;
+    /** Upper bound for exponential backoff delay in milliseconds. */
+    maxRetryDelay?: number;
+    /** Exponential backoff multiplier applied after each failed retry. */
+    retryBackoffMultiplier?: number;
 }
 export declare class RetryableContractOpener implements ContractOpener {
     private readonly openerConfigs;
@@ -32,6 +36,7 @@ export declare class RetryableContractOpener implements ContractOpener {
     private executeWithFallback;
     private trySingleAttempt;
     private tryWithRetries;
+    private getRetryDelay;
     private isContractExecutionError;
     private isTransportError;
     private createRetryableContract;

package/dist/src/adapters/RetryableContractOpener.js

@@ -22,9 +22,7 @@ class RetryableContractOpener {
         }
     }
     setLogger(logger) {
-        if (!this.logger) {
-            this.logger = logger;
-        }
+        this.logger = logger;
         this.applyLoggerToOpeners(logger);
     }
     applyLoggerToOpeners(logger) {
@@ -199,13 +197,24 @@ class RetryableContractOpener {
                     return { success: false, lastError };
                 }
                 if (attempt < config.retries) {
-                    this.logger?.debug(`[RetryableContractOpener] ${operationContext}: attempt ${attempt + 1}/${config.retries + 1} failed (${lastError.message}), retrying in ${config.retryDelay}ms`);
-                    await sleep(config.retryDelay);
+                    const retryDelay = this.getRetryDelay(config, attempt);
+                    this.logger?.debug(`[RetryableContractOpener] ${operationContext}: attempt ${attempt + 1}/${config.retries + 1} failed (${lastError.message}), retrying in ${retryDelay}ms`);
+                    await sleep(retryDelay);
                 }
             }
         }
         return { success: false, lastError };
     }
+    getRetryDelay(config, attempt) {
+        const baseDelay = config.retryDelay ?? Consts_1.DEFAULT_RETRY_DELAY_MS;
+        const maxRetryDelay = config.maxRetryDelay ?? Consts_1.DEFAULT_RETRY_MAX_DELAY_MS;
+        const backoffMultiplier = config.retryBackoffMultiplier ?? Consts_1.DEFAULT_RETRY_BACKOFF_MULTIPLIER;
+        if (baseDelay === 0 || maxRetryDelay === 0) {
+            return 0;
+        }
+        const calculatedDelay = baseDelay * backoffMultiplier ** attempt;
+        return Math.min(Math.round(calculatedDelay), maxRetryDelay);
+    }
     isContractExecutionError(error) {
         const errorWithExit = error;
         if (typeof errorWithExit.exitCode === 'number' ||
@@ -269,18 +278,36 @@ async function createDefaultRetryableOpener(tonRpcEndpoint, networkType, maxRetr
         timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS,
     });
     const opener = (0, TonClientOpener_1.tonClientOpener)(tonClient, logger);
-    openers.push({ opener, retries: maxRetries, retryDelay });
+    openers.push({
+        opener,
+        retries: maxRetries,
+        retryDelay,
+        maxRetryDelay: Consts_1.DEFAULT_RETRY_MAX_DELAY_MS,
+        retryBackoffMultiplier: Consts_1.DEFAULT_RETRY_BACKOFF_MULTIPLIER,
+    });
     if (networkType !== Struct_1.Network.DEV) {
         try {
             const opener = await (0, TonClientOpener_1.orbsOpener)(networkType, logger);
-            openers.push({ opener: opener, retries: maxRetries, retryDelay });
+            openers.push({
+                opener: opener,
+                retries: maxRetries,
+                retryDelay,
+                maxRetryDelay: Consts_1.DEFAULT_RETRY_MAX_DELAY_MS,
+                retryBackoffMultiplier: Consts_1.DEFAULT_RETRY_BACKOFF_MULTIPLIER,
+            });
         }
         catch {
             // skip opener in case of failure
         }
         try {
             const opener4 = await (0, TonClient4Opener_1.orbsOpener4)(networkType, Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS, logger);
-            openers.push({ opener: opener4, retries: maxRetries, retryDelay });
+            openers.push({
+                opener: opener4,
+                retries: maxRetries,
+                retryDelay,
+                maxRetryDelay: Consts_1.DEFAULT_RETRY_MAX_DELAY_MS,
+                retryBackoffMultiplier: Consts_1.DEFAULT_RETRY_BACKOFF_MULTIPLIER,
+            });
         }
         catch {
             // skip opener in case of failure

package/dist/src/adapters/ToncenterV3Indexer.d.ts

@@ -0,0 +1,34 @@
+import { IHttpClient, IToncenterV3Indexer } from '../interfaces';
+import { ToncenterV3IndexedTransaction, ToncenterV3TraversalParams } from '../structs/Struct';
+/**
+ * Thin Toncenter v3 indexer client for resolving indexed TON transaction context by hash and
+ * traversing a linked chain of TON transactions until it finds the sequencer-collected event transaction on CCL.
+ */
+export declare class ToncenterV3Indexer implements IToncenterV3Indexer {
+    readonly endpoint: string;
+    private readonly httpClient;
+    constructor(endpoint: string, httpClient?: IHttpClient);
+    /**
+     * Queries Toncenter v3 indexed `/transactions` endpoint by hash and returns the first match.
+     * @param transactionHash TON transaction hash accepted by the indexer.
+     * @returns Indexed transaction with owning account context, or null on 404 / empty result.
+     */
+    getTransactionByHash(transactionHash: string): Promise<ToncenterV3IndexedTransaction | null>;
+    /**
+     * Queries Toncenter v3 indexed `/adjacentTransactions` endpoint by hash.
+     * @param transactionHash TON transaction hash accepted by the indexer.
+     * @returns Adjacent indexed transactions, or an empty array on 404 / empty result.
+     */
+    getAdjacentTransactions(transactionHash: string): Promise<ToncenterV3IndexedTransaction[]>;
+    /**
+     * Traverses the linked chain of TON transactions in both directions starting from any TON transaction hash
+     * from that linked transaction chain, and returns the transaction on crossChainLayer that the sequencer would collect
+     * as a TVM event.
+     * @param transactionHash Any TON transaction hash from the target linked chain of TON transactions.
+     * @param crossChainLayerAddress crossChainLayer address whose sequencer-collected event transaction should be found in that linked chain of TON transactions.
+     * @param params Optional traversal settings. Defaults match the SDK traversal defaults.
+     * @returns Indexed crossChainLayer transaction that matches the sequencer collector rules, or null if not found.
+     */
+    findCollectibleCrossChainLayerTransaction(transactionHash: string, crossChainLayerAddress: string, params?: ToncenterV3TraversalParams): Promise<ToncenterV3IndexedTransaction | null>;
+    private isCollectibleEventTransactionOnAccount;
+}

package/dist/src/adapters/ToncenterV3Indexer.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToncenterV3Indexer = void 0;
+const ton_1 = require("@ton/ton");
+const errors_1 = require("../errors");
+const AxiosHttpClient_1 = require("../sdk/AxiosHttpClient");
+const Consts_1 = require("../sdk/Consts");
+const Utils_1 = require("../sdk/Utils");
+/**
+ * Thin Toncenter v3 indexer client for resolving indexed TON transaction context by hash and
+ * traversing a linked chain of TON transactions until it finds the sequencer-collected event transaction on CCL.
+ */
+class ToncenterV3Indexer {
+    constructor(endpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient()) {
+        this.endpoint = endpoint;
+        this.httpClient = httpClient;
+    }
+    /**
+     * Queries Toncenter v3 indexed `/transactions` endpoint by hash and returns the first match.
+     * @param transactionHash TON transaction hash accepted by the indexer.
+     * @returns Indexed transaction with owning account context, or null on 404 / empty result.
+     */
+    async getTransactionByHash(transactionHash) {
+        const endpoint = this.endpoint.endsWith('/') ? `${this.endpoint}transactions` : `${this.endpoint}/transactions`;
+        const requestLabel = `GET ${endpoint}`;
+        try {
+            const response = await this.httpClient.get(endpoint, {
+                params: {
+                    hash: transactionHash,
+                    limit: 1,
+                },
+                transformResponse: [Utils_1.toCamelCaseTransformer],
+            });
+            return response.data.transactions?.[0] ?? null;
+        }
+        catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            if (error?.response?.status === 404) {
+                return null;
+            }
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to resolve TON indexed transaction`, error);
+        }
+    }
+    /**
+     * Queries Toncenter v3 indexed `/adjacentTransactions` endpoint by hash.
+     * @param transactionHash TON transaction hash accepted by the indexer.
+     * @returns Adjacent indexed transactions, or an empty array on 404 / empty result.
+     */
+    async getAdjacentTransactions(transactionHash) {
+        const endpoint = this.endpoint.endsWith('/') ? `${this.endpoint}adjacentTransactions` : `${this.endpoint}/adjacentTransactions`;
+        const requestLabel = `GET ${endpoint}`;
+        try {
+            const response = await this.httpClient.get(endpoint, {
+                params: {
+                    hash: transactionHash,
+                },
+                transformResponse: [Utils_1.toCamelCaseTransformer],
+            });
+            return response.data.transactions ?? [];
+        }
+        catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            if (error?.response?.status === 404) {
+                return [];
+            }
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to resolve adjacent TON indexed transactions`, error);
+        }
+    }
+    /**
+     * Traverses the linked chain of TON transactions in both directions starting from any TON transaction hash
+     * from that linked transaction chain, and returns the transaction on crossChainLayer that the sequencer would collect
+     * as a TVM event.
+     * @param transactionHash Any TON transaction hash from the target linked chain of TON transactions.
+     * @param crossChainLayerAddress crossChainLayer address whose sequencer-collected event transaction should be found in that linked chain of TON transactions.
+     * @param params Optional traversal settings. Defaults match the SDK traversal defaults.
+     * @returns Indexed crossChainLayer transaction that matches the sequencer collector rules, or null if not found.
+     */
+    async findCollectibleCrossChainLayerTransaction(transactionHash, crossChainLayerAddress, params) {
+        const { maxDepth = Consts_1.DEFAULT_FIND_TX_MAX_DEPTH, maxScannedTransactions = Consts_1.DEFAULT_MAX_SCANNED_TRANSACTIONS, } = params ?? {};
+        const crossChainLayer = ton_1.Address.parse(crossChainLayerAddress);
+        const rootTransaction = await this.getTransactionByHash(transactionHash);
+        if (!rootTransaction) {
+            return null;
+        }
+        if (this.isCollectibleEventTransactionOnAccount(rootTransaction, crossChainLayer)) {
+            return rootTransaction;
+        }
+        const queue = [{ hash: rootTransaction.hash, depth: 0 }];
+        const visitedHashes = new Set([(0, Utils_1.normalizeHashToHex)(rootTransaction.hash)]);
+        let scannedTransactions = 0;
+        while (queue.length > 0) {
+            const { hash: currentHash, depth } = queue.shift();
+            if (depth >= maxDepth || scannedTransactions >= maxScannedTransactions) {
+                continue;
+            }
+            const adjacentTransactions = await this.getAdjacentTransactions(currentHash);
+            for (const transaction of adjacentTransactions) {
+                const normalizedHash = (0, Utils_1.normalizeHashToHex)(transaction.hash);
+                if (visitedHashes.has(normalizedHash)) {
+                    continue;
+                }
+                visitedHashes.add(normalizedHash);
+                scannedTransactions += 1;
+                if (this.isCollectibleEventTransactionOnAccount(transaction, crossChainLayer)) {
+                    return transaction;
+                }
+                if (scannedTransactions < maxScannedTransactions) {
+                    queue.push({ hash: transaction.hash, depth: depth + 1 });
+                }
+            }
+        }
+        return null;
+    }
+    isCollectibleEventTransactionOnAccount(transaction, account) {
+        if (!ton_1.Address.parse(transaction.account).equals(account)) {
+            return false;
+        }
+        return transaction.outMsgs.some((message) => {
+            return message.destination == null;
+        });
+    }
+}
+exports.ToncenterV3Indexer = ToncenterV3Indexer;

package/dist/src/adapters/index.d.ts

@@ -3,5 +3,6 @@ export * from './LiteClientOpener';
 export * from './OpenerUtils';
 export * from './RetryableContractOpener';
 export * from './SandboxOpener';
+export * from './ToncenterV3Indexer';
 export * from './TonClient4Opener';
 export * from './TonClientOpener';

package/dist/src/adapters/index.js

@@ -19,5 +19,6 @@ __exportStar(require("./LiteClientOpener"), exports);
 __exportStar(require("./OpenerUtils"), exports);
 __exportStar(require("./RetryableContractOpener"), exports);
 __exportStar(require("./SandboxOpener"), exports);
+__exportStar(require("./ToncenterV3Indexer"), exports);
 __exportStar(require("./TonClient4Opener"), exports);
 __exportStar(require("./TonClientOpener"), exports);

package/dist/src/assets/FT.js

@@ -131,7 +131,7 @@ class FT {
         else {
             const resolvedEvmAddress = (0, ethers_1.isAddress)(address)
                 ? address
-                : cachedEvmAddress ?? (await jettonMinter.getEVMTokenAddress());
+                : (cachedEvmAddress ?? (await jettonMinter.getEVMTokenAddress()));
             finalEvmAddress = resolvedEvmAddress;
             decimals = await this.getTACDecimals(configuration, resolvedEvmAddress);
         }

package/dist/src/errors/index.d.ts

@@ -1,2 +1,2 @@
 export { AddressError, BitError, ContractError, EVMCallError, FetchError, FormatError, KeyError, MetadataError, SettingError, TokenError, TransactionError, WalletError, } from './errors';
-export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, executedInTONStageFailedError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';
+export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, externalInMessageRequiredError, executedInTONStageFailedError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidTonExternalMessageBocError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';

package/dist/src/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationIdRequiredForFinalizationError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidMethodNameError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.executedInTONStageFailedError = exports.evmAddressError = exports.estimatedGasExceedsBlockGasLimitError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.blockGasLimitFetchError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
+exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationIdRequiredForFinalizationError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidMethodNameError = exports.invalidTonExternalMessageBocError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.executedInTONStageFailedError = exports.externalInMessageRequiredError = exports.evmAddressError = exports.estimatedGasExceedsBlockGasLimitError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.blockGasLimitFetchError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AddressError", { enumerable: true, get: function () { return errors_1.AddressError; } });
 Object.defineProperty(exports, "BitError", { enumerable: true, get: function () { return errors_1.BitError; } });
@@ -22,11 +22,13 @@ Object.defineProperty(exports, "emptyContractError", { enumerable: true, get: fu
 Object.defineProperty(exports, "emptySettingError", { enumerable: true, get: function () { return instances_1.emptySettingError; } });
 Object.defineProperty(exports, "estimatedGasExceedsBlockGasLimitError", { enumerable: true, get: function () { return instances_1.estimatedGasExceedsBlockGasLimitError; } });
 Object.defineProperty(exports, "evmAddressError", { enumerable: true, get: function () { return instances_1.evmAddressError; } });
+Object.defineProperty(exports, "externalInMessageRequiredError", { enumerable: true, get: function () { return instances_1.externalInMessageRequiredError; } });
 Object.defineProperty(exports, "executedInTONStageFailedError", { enumerable: true, get: function () { return instances_1.executedInTONStageFailedError; } });
 Object.defineProperty(exports, "gasPriceFetchError", { enumerable: true, get: function () { return instances_1.gasPriceFetchError; } });
 Object.defineProperty(exports, "indexRequiredError", { enumerable: true, get: function () { return instances_1.indexRequiredError; } });
 Object.defineProperty(exports, "insufficientBalanceError", { enumerable: true, get: function () { return instances_1.insufficientBalanceError; } });
 Object.defineProperty(exports, "insufficientFeeParamsError", { enumerable: true, get: function () { return instances_1.insufficientFeeParamsError; } });
+Object.defineProperty(exports, "invalidTonExternalMessageBocError", { enumerable: true, get: function () { return instances_1.invalidTonExternalMessageBocError; } });
 Object.defineProperty(exports, "invalidMethodNameError", { enumerable: true, get: function () { return instances_1.invalidMethodNameError; } });
 Object.defineProperty(exports, "missingDecimals", { enumerable: true, get: function () { return instances_1.missingDecimals; } });
 Object.defineProperty(exports, "missingFeeParamsError", { enumerable: true, get: function () { return instances_1.missingFeeParamsError; } });

package/dist/src/errors/instances.d.ts

@@ -41,3 +41,5 @@ export declare const operationIdRequiredForFinalizationError: TransactionError;
 export declare const executedInTONStageFailedError: TransactionError;
 export declare const blockGasLimitFetchError: (msg: string, inner?: unknown) => FetchError;
 export declare const estimatedGasExceedsBlockGasLimitError: (txName: string, estimatedGas: bigint, blockGasLimit: bigint) => TransactionError;
+export declare const invalidTonExternalMessageBocError: (reason?: string) => FormatError;
+export declare const externalInMessageRequiredError: (actualType: string) => FormatError;

package/dist/src/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.estimatedGasExceedsBlockGasLimitError = exports.blockGasLimitFetchError = exports.executedInTONStageFailedError = exports.operationIdRequiredForFinalizationError = exports.insufficientFeeParamsError = exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
+exports.externalInMessageRequiredError = exports.invalidTonExternalMessageBocError = exports.estimatedGasExceedsBlockGasLimitError = exports.blockGasLimitFetchError = exports.executedInTONStageFailedError = exports.operationIdRequiredForFinalizationError = exports.insufficientFeeParamsError = exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
 const errors_1 = require("./errors");
 exports.emptyContractError = new errors_1.ContractError('unexpected empty contract code of given jetton.', 100);
 const operationFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch OperationId: ${msg}`, 101, inner);
@@ -127,3 +127,7 @@ const blockGasLimitFetchError = (msg, inner) => new errors_1.FetchError(`Failed
 exports.blockGasLimitFetchError = blockGasLimitFetchError;
 const estimatedGasExceedsBlockGasLimitError = (txName, estimatedGas, blockGasLimit) => new errors_1.TransactionError(`Estimated gas for ${txName} (${estimatedGas}) exceeds current TAC block gas limit (${blockGasLimit})`, 140);
 exports.estimatedGasExceedsBlockGasLimitError = estimatedGasExceedsBlockGasLimitError;
+const invalidTonExternalMessageBocError = (reason) => new errors_1.FormatError(`Invalid external TON message BOC${reason ? `: ${reason}` : ''}`, 141);
+exports.invalidTonExternalMessageBocError = invalidTonExternalMessageBocError;
+const externalInMessageRequiredError = (actualType) => new errors_1.FormatError(`Expected external-in TON message, got ${actualType}`, 142);
+exports.externalInMessageRequiredError = externalInMessageRequiredError;

package/dist/src/interfaces/ContractOpener.d.ts

@@ -16,7 +16,7 @@ export interface ContractOpener {
      */
     getContractState(address: Address): Promise<ContractState>;
     /**
-     * Closes any underlying connections if supported by the implementation.
+     * Closes TON lite client connections. Use only with LiteClientOpener.
      */
     closeConnections?: () => unknown;
     /**

package/dist/src/interfaces/ILiteSequencerClient.d.ts

@@ -1,13 +1,17 @@
 import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, OperationTypeV2Info, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
 export interface ILiteSequencerClient {
+    /** Base URL of the lite sequencer endpoint used by this client. */
+    readonly endpoint: string;
     /** Retrieves the operation type by id. */
     getOperationType(operationId: string): Promise<OperationType>;
     /** Retrieves the v2 operation route/finalization state by id. */
     getOperationTypeV2(operationId: string): Promise<OperationTypeV2Info>;
     /** Resolves operation id by a transaction linker. */
     getOperationId(transactionLinker: TransactionLinker): Promise<string>;
-    /** Resolves operation id by the originating transaction hash. */
+    /** Resolves operation id by the originating transaction hash (from ccl event in TON and TAC). */
     getOperationIdByTransactionHash(transactionHash: string): Promise<string>;
+    /** Resolves operation id by the originating transaction hash (from ccl event in TON). */
+    getOperationIdByTonTransactionHash(transactionHash: string): Promise<string>;
     /**
      * Resolves operation ids for multiple shard keys.
      * @param shardsKeys Shard keys to query.

package/dist/src/interfaces/IOperationTracker.d.ts

@@ -24,6 +24,12 @@ export interface IOperationTracker {
      * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
     getOperationIdByTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
+    /**
+     * Resolves an operation id by a TON transaction hash, optionally waiting until available.
+     * @param transactionHash Exact TON crossChainLayer transaction hash.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
+     */
+    getOperationIdByTonTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
     /**
      * Resolves operation ids by shard keys for a particular caller, with optional batching and waiting.
      * @param shardsKeys List of shard keys.

package/dist/src/interfaces/ITACTransactionManager.d.ts

@@ -1,5 +1,5 @@
 import { Wallet } from 'ethers';
-import { BridgeTokensToTONOptions, TACCrossChainTransactionResult } from '../structs/Struct';
+import { CrossChainTransactionToTONOptions, TACCrossChainTransactionResult } from '../structs/Struct';
 import { Asset } from './Asset';
 export interface ITACTransactionManager {
     /**
@@ -8,14 +8,15 @@ export interface ITACTransactionManager {
      * performs production-oriented TAC prechecks: requires EIP-1559 fee data from the TAC provider,
      * optionally validates balances / ownership of non-native TAC assets, uses provider gas estimates as-is,
      * validates those estimates against the latest TAC block gas limit,
-     * computes the worst-case upfront TAC balance requirement, and then submits approvals plus the bridge message.
+     * first estimates approval gas and checks TAC balance for approvals, submits approvals,
+     * then estimates the bridge message and checks the remaining TAC balance before sending it.
      * @param signer Ethers Wallet used to sign EVM transaction.
      * @param tonTarget Recipient TVM address on TON.
      * @param assets Optional list of TAC assets to include. Native TAC should be passed here as a TAC asset.
      * @param options Optional bridge configuration object.
      * @returns TAC transaction hash and optional operationId.
      */
-    sendCrossChainTransactionToTON(signer: Wallet, tonTarget: string, assets?: Asset[], options?: BridgeTokensToTONOptions): Promise<TACCrossChainTransactionResult>;
+    sendCrossChainTransactionToTON(signer: Wallet, tonTarget: string, assets?: Asset[], options?: CrossChainTransactionToTONOptions): Promise<TACCrossChainTransactionResult>;
     /**
      * Bridges native EVM value and optional assets to TON chain via executor.
      * This is a low-level send-only method: it approves assets, sends the TAC -> TON message and