@tonappchain/sdk 0.7.3-rc7 → 0.8.0

package/dist/artifacts/testnet/ton/internal/wrappers/Settings.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Settings = exports.SettingsErrors = exports.SettingsOpCodes = void 0;
 exports.settingsConfigToCell = settingsConfigToCell;
+exports.createSettingsSetValueBody = createSettingsSetValueBody;
 const core_1 = require("@ton/core");
 const GasUtils_1 = require("./utils/GasUtils");
 exports.SettingsOpCodes = {
@@ -29,6 +30,14 @@ function settingsConfigToCell(config) {
         .storeDict(config.settings)
         .endCell();
 }
+function createSettingsSetValueBody(params) {
+    return (0, core_1.beginCell)()
+        .storeUint(exports.SettingsOpCodes.admin_setValue, 32)
+        .storeUint(params.queryId ?? 0, 64)
+        .storeUint(params.key, 256)
+        .storeRef(params.value)
+        .endCell();
+}
 class Settings {
     constructor(address, init, configuration) {
         this.address = address;
@@ -54,12 +63,7 @@ class Settings {
         await provider.internal(via, {
             value,
             sendMode: core_1.SendMode.PAY_GAS_SEPARATELY,
-            body: (0, core_1.beginCell)()
-                .storeUint(exports.SettingsOpCodes.admin_setValue, 32)
-                .storeUint(params.queryId ?? 0, 64)
-                .storeUint(params.key, 256)
-                .storeRef(params.value)
-                .endCell(),
+            body: createSettingsSetValueBody(params),
         });
     }
     async sendGetValue(provider, via, value, params) {
@@ -148,6 +152,6 @@ class Settings {
     }
 }
 exports.Settings = Settings;
-Settings.storageStats = new GasUtils_1.StorageStats(39375n, 118n);
+Settings.storageStats = new GasUtils_1.StorageStats(39175n, 118n);
 Settings.minStorageDuration = 10 * 365 * 24 * 3600; // 10 years
 Settings.minStorageStats = new GasUtils_1.StorageStats(29557n, 104n);

package/dist/src/adapters/RetryableContractOpener.js

@@ -146,7 +146,7 @@ class RetryableContractOpener {
             const openerLabel = `opener ${index + 1}/${this.openerConfigs.length}`;
             this.logger?.debug(`[RetryableContractOpener] ${operationName}: trying ${openerLabel}`);
             const result = useRetries
-                ? await this.tryWithRetries(() => operation(config), config, `${operationName} ${openerLabel}`)
+                ? await this.tryWithRetries(() => operation(config), config, `${operationName} ${openerLabel}`, shouldFallbackOnError)
                 : await this.trySingleAttempt(() => operation(config));
             if (result.success) {
                 return { success: true, data: result.data };
@@ -186,7 +186,7 @@ class RetryableContractOpener {
             return { success: false, lastError: error };
         }
     }
-    async tryWithRetries(operation, config, operationContext = 'operation') {
+    async tryWithRetries(operation, config, operationContext = 'operation', shouldRetryError) {
         let lastError;
         for (let attempt = 0; attempt <= config.retries; attempt++) {
             try {
@@ -198,6 +198,9 @@ class RetryableContractOpener {
                 if (lastError instanceof errors_1.TransactionError || this.isContractExecutionError(lastError)) {
                     return { success: false, lastError };
                 }
+                if (shouldRetryError && !shouldRetryError(lastError)) {
+                    return { success: false, lastError };
+                }
                 if (attempt < config.retries) {
                     const retryDelay = this.getRetryDelay(config, attempt);
                     this.logger?.debug(`[RetryableContractOpener] ${operationContext}: attempt ${attempt + 1}/${config.retries + 1} failed (${lastError.message}), retrying in ${retryDelay}ms`);

package/dist/src/adapters/ToncenterV3Indexer.js

@@ -11,7 +11,7 @@ const Utils_1 = require("../sdk/Utils");
  * 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()) {
+    constructor(endpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient({ timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS })) {
         this.endpoint = endpoint;
         this.httpClient = httpClient;
     }

package/dist/src/assets/AssetCache.d.ts

@@ -1,19 +1,19 @@
-import { Asset } from '../interfaces';
+import type { Asset, IConfiguration } from '../interfaces';
 type AssetCacheToken = {
     address: string;
     index?: bigint;
     tokenType?: string;
 };
 export declare class AssetCache {
-    private static readonly cache;
+    private static cache;
     /**
      * Get asset from cache
      */
-    static get(token: AssetCacheToken): Asset | undefined;
+    static get(configuration: IConfiguration, token: AssetCacheToken): Asset | undefined;
     /**
      * Set asset in cache
      */
-    static set(token: AssetCacheToken, asset: Asset): void;
+    static set(configuration: IConfiguration, token: AssetCacheToken, asset: Asset): void;
     /**
      * Clear the cache
      */

package/dist/src/assets/AssetCache.js

@@ -5,22 +5,27 @@ class AssetCache {
     /**
      * Get asset from cache
      */
-    static get(token) {
+    static get(configuration, token) {
         const key = this.generateKey(token);
-        return this.cache.get(key);
+        return this.cache.get(configuration)?.get(key);
     }
     /**
      * Set asset in cache
      */
-    static set(token, asset) {
+    static set(configuration, token, asset) {
         const key = this.generateKey(token);
-        this.cache.set(key, asset);
+        let scopedCache = this.cache.get(configuration);
+        if (!scopedCache) {
+            scopedCache = new Map();
+            this.cache.set(configuration, scopedCache);
+        }
+        scopedCache.set(key, asset);
     }
     /**
      * Clear the cache
      */
     static clear() {
-        this.cache.clear();
+        this.cache = new WeakMap();
     }
     static generateKey(token) {
         // Normalize address to lowercase for consistency
@@ -36,4 +41,4 @@ class AssetCache {
     }
 }
 exports.AssetCache = AssetCache;
-AssetCache.cache = new Map();
+AssetCache.cache = new WeakMap();

package/dist/src/assets/AssetFactory.js

@@ -18,14 +18,14 @@ class AssetFactory {
                 throw (0, errors_1.unknownTokenTypeError)(token.address, 'detected TON, but token type is not FT');
             return TON_1.TON.create(configuration);
         }
-        const cachedAsset = AssetCache_1.AssetCache.get(token);
+        const cachedAsset = AssetCache_1.AssetCache.get(configuration, token);
         if (cachedAsset) {
             return cachedAsset.clone.withRawAmount(0n);
         }
         const asset = token.tokenType === Struct_1.AssetType.FT
             ? await this.createFTAsset(configuration, token.address)
             : await this.createNFTAsset(configuration, token.address, token.addressType, token.addressType === Struct_1.NFTAddressType.COLLECTION ? token.index : undefined);
-        AssetCache_1.AssetCache.set(token, asset);
+        AssetCache_1.AssetCache.set(configuration, token, asset);
         return asset;
     }
     static async createFTAsset(configuration, address) {

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, 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';
+export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, executedInTONStageFailedError, externalInMessageRequiredError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidAmountError, invalidMethodNameError, invalidTonExternalMessageBocError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tonIndexerRequiredForTonTransactionBocError, 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.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;
+exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.tonIndexerRequiredForTonTransactionBocError = 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.invalidTonExternalMessageBocError = exports.invalidMethodNameError = exports.invalidAmountError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.externalInMessageRequiredError = 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;
 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,14 +22,15 @@ 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, "externalInMessageRequiredError", { enumerable: true, get: function () { return instances_1.externalInMessageRequiredError; } });
 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, "invalidAmountError", { enumerable: true, get: function () { return instances_1.invalidAmountError; } });
 Object.defineProperty(exports, "invalidMethodNameError", { enumerable: true, get: function () { return instances_1.invalidMethodNameError; } });
+Object.defineProperty(exports, "invalidTonExternalMessageBocError", { enumerable: true, get: function () { return instances_1.invalidTonExternalMessageBocError; } });
 Object.defineProperty(exports, "missingDecimals", { enumerable: true, get: function () { return instances_1.missingDecimals; } });
 Object.defineProperty(exports, "missingFeeParamsError", { enumerable: true, get: function () { return instances_1.missingFeeParamsError; } });
 Object.defineProperty(exports, "missingGasLimitError", { enumerable: true, get: function () { return instances_1.missingGasLimitError; } });
@@ -42,6 +43,7 @@ Object.defineProperty(exports, "prefixError", { enumerable: true, get: function
 Object.defineProperty(exports, "profilingFetchError", { enumerable: true, get: function () { return instances_1.profilingFetchError; } });
 Object.defineProperty(exports, "simulationFetchError", { enumerable: true, get: function () { return instances_1.simulationFetchError; } });
 Object.defineProperty(exports, "statusFetchError", { enumerable: true, get: function () { return instances_1.statusFetchError; } });
+Object.defineProperty(exports, "tonIndexerRequiredForTonTransactionBocError", { enumerable: true, get: function () { return instances_1.tonIndexerRequiredForTonTransactionBocError; } });
 Object.defineProperty(exports, "tvmAddressError", { enumerable: true, get: function () { return instances_1.tvmAddressError; } });
 Object.defineProperty(exports, "txFinalizationError", { enumerable: true, get: function () { return instances_1.txFinalizationError; } });
 Object.defineProperty(exports, "unknownTokenTypeError", { enumerable: true, get: function () { return instances_1.unknownTokenTypeError; } });

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

@@ -43,3 +43,5 @@ export declare const blockGasLimitFetchError: (msg: string, inner?: unknown) =>
 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;
+export declare const tonIndexerRequiredForTonTransactionBocError: SettingError;
+export declare const invalidAmountError: (reason: string) => FormatError;

package/dist/src/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.invalidAmountError = exports.tonIndexerRequiredForTonTransactionBocError = 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);
@@ -131,3 +131,6 @@ const invalidTonExternalMessageBocError = (reason) => new errors_1.FormatError(`
 exports.invalidTonExternalMessageBocError = invalidTonExternalMessageBocError;
 const externalInMessageRequiredError = (actualType) => new errors_1.FormatError(`Expected external-in TON message, got ${actualType}`, 142);
 exports.externalInMessageRequiredError = externalInMessageRequiredError;
+exports.tonIndexerRequiredForTonTransactionBocError = new errors_1.SettingError('TON indexer is required to resolve operation ID by TON transaction BOC', 143);
+const invalidAmountError = (reason) => new errors_1.FormatError(`Invalid amount: ${reason}`, 144);
+exports.invalidAmountError = invalidAmountError;

package/dist/src/index.d.ts

@@ -4,6 +4,7 @@ export * as AgnosticStructs from './agnosticSdk/AgnosticStructs';
 export * from './assets';
 export * from './errors';
 export * from './interfaces';
+export { getArtifacts } from './sdk/Artifacts';
 export { AxiosHttpClient } from './sdk/AxiosHttpClient';
 export { Configuration } from './sdk/Configuration';
 export { LiteSequencerClient } from './sdk/LiteSequencerClient';

package/dist/src/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TonTxFinalizer = exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.TacExplorerClient = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
+exports.TonTxFinalizer = exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.TacExplorerClient = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.getArtifacts = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
 __exportStar(require("./adapters"), exports);
 var AgnosticSdk_1 = require("./agnosticSdk/AgnosticSdk");
 Object.defineProperty(exports, "AgnosticProxySDK", { enumerable: true, get: function () { return AgnosticSdk_1.AgnosticProxySDK; } });
@@ -44,6 +44,8 @@ exports.AgnosticStructs = __importStar(require("./agnosticSdk/AgnosticStructs"))
 __exportStar(require("./assets"), exports);
 __exportStar(require("./errors"), exports);
 __exportStar(require("./interfaces"), exports);
+var Artifacts_1 = require("./sdk/Artifacts");
+Object.defineProperty(exports, "getArtifacts", { enumerable: true, get: function () { return Artifacts_1.getArtifacts; } });
 var AxiosHttpClient_1 = require("./sdk/AxiosHttpClient");
 Object.defineProperty(exports, "AxiosHttpClient", { enumerable: true, get: function () { return AxiosHttpClient_1.AxiosHttpClient; } });
 var Configuration_1 = require("./sdk/Configuration");

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

@@ -1,11 +1,11 @@
-import { dev, mainnet, testnet } from '../../artifacts';
+import type { NetworkArtifacts } from '../../artifacts';
 import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
 import { Network } from '../structs/Struct';
 export interface IConfiguration {
     /** Current network the SDK is configured for (e.g., MAINNET/TESTNET). */
     readonly network: Network;
     /** Resolved artifacts bundle for the selected network (contract ABIs/addresses). */
-    readonly artifacts: typeof testnet | typeof mainnet | typeof dev;
+    readonly artifacts: NetworkArtifacts;
     /** Low-level TON client parameters and dependencies. */
     readonly TONParams: InternalTONParams;
     /** Low-level TAC (EVM-side) client parameters and dependencies. */

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

@@ -32,10 +32,23 @@ export interface IOperationTracker {
     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.
+     * When OperationTracker config includes TONParams.tonIndexer, the hash may belong to any transaction in the linked
+     * TON transaction chain; the tracker resolves the sequencer-collected crossChainLayer transaction before querying
+     * the sequencer.
+     * Retries cover both the indexed crossChainLayer lookup and the sequencer request.
+     * @param transactionHash TON 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 an operation id by the BOC of an external TON message that was sent to the blockchain.
+     * The tracker resolves the root TON transaction that processed the external message, then resolves the
+     * sequencer-collected crossChainLayer transaction before querying the sequencer. Retries cover that whole lookup.
+     * Requires OperationTracker config to include TONParams.tonIndexer.
+     * @param boc BOC of the external TON message that was sent to the blockchain.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
+     */
+    getOperationIdByTonTransactionBoc(boc: 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/ITacSDK.d.ts

@@ -2,7 +2,7 @@ import { Wallet } from 'ethers';
 import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT, TAC, TON } from '../assets';
 import type { SenderAbstraction } from '../sender';
-import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrossChainTransactionToTONOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TACCrossChainTransactionResult, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
+import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrossChainTransactionToTONOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TACCrossChainTransactionResult, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 import { Asset } from './Asset';
 import { ContractOpener } from './ContractOpener';
 import { IConfiguration } from './IConfiguration';
@@ -123,26 +123,6 @@ export interface ITacSDK {
      * @returns Promise with an array of TransactionLinkerWithOperationId for each submitted transaction.
      */
     sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTxWithAssetLike[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
-    /**
-     * Resolves operation id by any TON hash from a linked chain of TON transactions.
-     * The SDK first resolves indexed TON transaction context, traverses adjacent TON transactions
-     * until it finds the crossChainLayer transaction that the sequencer would collect as a TVM event,
-     * and only then queries the sequencer with that exact transaction hash.
-     * @param transactionHash Any TON transaction hash from the relevant linked chain of TON transactions.
-     * @param waitOptions Optional waiting settings for the final sequencer lookup. Pass `null` to disable retries.
-     * @returns Promise resolving to operation id, or empty string when the sequencer-collected crossChainLayer event transaction is not found.
-     */
-    getOperationIdByTonTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
-    /**
-     * Resolves operation id by the BOC of an external TON message that was sent to the blockchain.
-     * The SDK derives the normalized external-in message hash from the BOC, finds the root TON transaction
-     * that processed that external message through the configured contract opener, and then reuses the same
-     * linked chain of TON transactions lookup as `getOperationIdByTonTransactionHash(...)`.
-     * @param boc BOC of the external TON message that was sent to the blockchain.
-     * @param waitOptions Optional waiting settings for the final sequencer lookup. Pass `null` to disable retries.
-     * @returns Promise resolving to operation id, or empty string when the sequencer-collected crossChainLayer event transaction is not found.
-     */
-    getOperationIdByTonTransactionBoc(boc: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
     /**
      * Bridges tokens/value from EVM to TON chain via the executor.
      * This is a low-level send-only method. It prepares the TAC -> TON message, performs approvals,

package/dist/src/sdk/Artifacts.d.ts

@@ -0,0 +1,3 @@
+import type { NetworkArtifacts } from '../../artifacts';
+import { Network } from '../structs/Struct';
+export declare function getArtifacts(network: Network): NetworkArtifacts;

package/dist/src/sdk/Artifacts.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getArtifacts = getArtifacts;
+const artifacts_1 = require("../../artifacts");
+const Struct_1 = require("../structs/Struct");
+function getArtifacts(network) {
+    switch (network) {
+        case Struct_1.Network.MAINNET:
+            return artifacts_1.mainnet;
+        case Struct_1.Network.TESTNET:
+            return artifacts_1.testnet;
+        case Struct_1.Network.DEV:
+            return artifacts_1.dev;
+        default:
+            throw new Error(`Unsupported network: ${network}`);
+    }
+}

package/dist/src/sdk/Configuration.d.ts

@@ -1,16 +1,16 @@
-import { dev, mainnet, testnet } from '../../artifacts';
+import type { NetworkArtifacts } from '../../artifacts';
 import { IConfiguration, ILogger } from '../interfaces';
 import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
 import { Network, TACParams, TONParams } from '../structs/Struct';
 export declare class Configuration implements IConfiguration {
     readonly network: Network;
-    readonly artifacts: typeof testnet | typeof mainnet | typeof dev;
+    readonly artifacts: NetworkArtifacts;
     readonly TONParams: InternalTONParams;
     readonly TACParams: InternalTACParams;
     readonly liteSequencerEndpoints: string[];
     readonly logger: ILogger;
-    constructor(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams: InternalTONParams, TACParams: InternalTACParams, liteSequencerEndpoints: string[], logger: ILogger);
-    static create(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams?: TONParams, TACParams?: TACParams, customLiteSequencerEndpoints?: string[], delay?: number, logger?: ILogger, passLoggerToOpeners?: boolean): Promise<Configuration>;
+    constructor(network: Network, artifacts: NetworkArtifacts, TONParams: InternalTONParams, TACParams: InternalTACParams, liteSequencerEndpoints: string[], logger: ILogger);
+    static create(network: Network, artifacts: NetworkArtifacts, TONParams?: TONParams, TACParams?: TACParams, customLiteSequencerEndpoints?: string[], delay?: number, logger?: ILogger, passLoggerToOpeners?: boolean): Promise<Configuration>;
     private static prepareTONParams;
     private static prepareTACParams;
     private static loadTACSettingsViaMulticall;

package/dist/src/sdk/Configuration.js

@@ -3,9 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Configuration = void 0;
 const ton_1 = require("@ton/ton");
 const ethers_1 = require("ethers");
-const artifacts_1 = require("../../artifacts");
 const adapters_1 = require("../adapters");
 const Struct_1 = require("../structs/Struct");
+const Artifacts_1 = require("./Artifacts");
 const Consts_1 = require("./Consts");
 const Fees_1 = require("./Fees");
 const Logger_1 = require("./Logger");
@@ -56,6 +56,10 @@ class Configuration {
                     (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, Consts_1.DEFAULT_RETRY_MAX_COUNT, delay, passLoggerToOpeners ? logger : undefined, artifacts.TONCENTER_V3_INDEXER_ENDPOINT));
             settingsAddress = TONParams?.settingsAddress ?? artifacts.TON_SETTINGS_ADDRESS;
         }
+        const tonIndexer = TONParams?.tonIndexer ??
+            (artifacts.TONCENTER_V3_INDEXER_ENDPOINT
+                ? new adapters_1.ToncenterV3Indexer(artifacts.TONCENTER_V3_INDEXER_ENDPOINT)
+                : undefined);
         if (passLoggerToOpeners) {
             contractOpener.setLogger(logger);
         }
@@ -81,6 +85,7 @@ class Configuration {
         const feesParams = await this.retrieveTONFeesParams(contractOpener);
         return {
             contractOpener,
+            tonIndexer,
             jettonProxyAddress,
             crossChainLayerAddress,
             jettonMinterCode,
@@ -93,7 +98,7 @@ class Configuration {
         };
     }
     static async prepareTACParams(network, TACParams) {
-        const artifacts = network === Struct_1.Network.MAINNET ? artifacts_1.mainnet : network === Struct_1.Network.TESTNET ? artifacts_1.testnet : artifacts_1.dev;
+        const artifacts = (0, Artifacts_1.getArtifacts)(network);
         let provider;
         let settingsAddress;
         let saFactoryAddress;
@@ -158,7 +163,7 @@ class Configuration {
             // skip multicall in dev, because it's not guaranteed that multicall contract is deployed
             return null;
         }
-        const artifacts = network === Struct_1.Network.MAINNET ? artifacts_1.mainnet : artifacts_1.testnet;
+        const artifacts = (0, Artifacts_1.getArtifacts)(network);
         const multicallAddress = artifacts.MULTICALL_3_ADDRESS;
         const multicallAbi = artifacts.tac.multicall.MULTICALL_ABI_ETHERS;
         try {

package/dist/src/sdk/Consts.d.ts

@@ -49,6 +49,5 @@ export declare const IGNORE_MSG_VALUE_1_NANO = 1n;
 export declare const CROSS_CHAIN_MESSAGE_VERSION_V1 = 1n;
 export declare const NFT_BRIDGE_AMOUNT = 1n;
 export declare const DEFAULT_EIP1559_PRIORITY_FEE = 0n;
-export declare const SHARDS_KEY_RANDOM_RANGE = 1000000000000000000;
 export declare const IGNORE_OPCODE: number[];
 export declare const HTTP_NOT_FOUND_STATUS_CODE = 404;

package/dist/src/sdk/Consts.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NFT_BRIDGE_AMOUNT = exports.CROSS_CHAIN_MESSAGE_VERSION_V1 = exports.IGNORE_MSG_VALUE_1_NANO = exports.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS = exports.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = exports.DEFAULT_RETRY_ON_NOT_FOUND = exports.DEFAULT_FIND_TX_MAX_DEPTH = exports.DEFAULT_MAX_SCANNED_TRANSACTIONS = exports.DEFAULT_FIND_TX_LIMIT = exports.DEFAULT_WAIT_DELAY_MS = exports.DEFAULT_WAIT_MAX_ATTEMPTS = exports.DEFAULT_WAIT_TIMEOUT_MS = exports.DEFAULT_RETRY_BACKOFF_MULTIPLIER = exports.DEFAULT_RETRY_MAX_DELAY_MS = exports.DEFAULT_RETRY_DELAY_MS = exports.DEFAULT_RETRY_MAX_COUNT = exports.DEFAULT_HTTP_CLIENT_TIMEOUT_MS = exports.TON_BURN_ADDRESS = exports.MINUTE = exports.FIVE_MINUTES = exports.TAC_DECIMALS = exports.TON_DECIMALS = exports.ONE_YEAR_SECONDS = exports.FIFTEEN_MINUTES = exports.TAC_SYMBOL = exports.TON_SYMBOL = exports.MAX_MSG_DEPTH = exports.MAX_HIGHLOAD_GROUP_MSG_NUM = exports.MAX_EXT_MSG_SIZE = exports.SOLIDITY_METHOD_NAME_REGEX = exports.SOLIDITY_SIGNATURE_REGEX = exports.DEFAULT_DELAY = exports.MAX_ITERATION_COUNT = exports.FIXED_POINT_SHIFT = exports.DYNAMIC_JETTON_WALLET_CODE_HASHES = exports.USDT_JETTON_WALLET_CODE_HASH = exports.LEGACY_NFT_TRANSFER_WITH_FORWARD_OUTBOUND_MESSAGE_COUNT = exports.LEGACY_NFT_TRANSFER_BASE_OUTBOUND_MESSAGE_COUNT = exports.LEGACY_NFT_ITEM_MIN_TONS_FOR_STORAGE = exports.LEGACY_JETTON_WALLET_TRANSFER_GAS_AND_STORAGE = exports.LEGACY_JETTON_TRANSFER_WITH_FORWARD_OUTBOUND_MESSAGE_COUNT = exports.LEGACY_JETTON_TRANSFER_BASE_OUTBOUND_MESSAGE_COUNT = exports.LEGACY_JETTON_WALLET_GAS_CONSUMPTION_COUNT = exports.LEGACY_JETTON_WALLET_GAS_CONSUMPTION = exports.LEGACY_JETTON_WALLET_MIN_TONS_FOR_STORAGE = exports.LEGACY_STRICTLY_GREATER_THAN_FEE_EPSILON = exports.LEGACY_FORWARD_FEE_ESTIMATE_DENOMINATOR = exports.LEGACY_FORWARD_FEE_ESTIMATE_NUMERATOR = exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = void 0;
-exports.HTTP_NOT_FOUND_STATUS_CODE = exports.IGNORE_OPCODE = exports.SHARDS_KEY_RANDOM_RANGE = exports.DEFAULT_EIP1559_PRIORITY_FEE = void 0;
+exports.HTTP_NOT_FOUND_STATUS_CODE = exports.IGNORE_OPCODE = exports.DEFAULT_EIP1559_PRIORITY_FEE = void 0;
 const ton_1 = require("@ton/ton");
 exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = (0, ton_1.toNano)(0.2);
 exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = (0, ton_1.toNano)(0.3);
@@ -55,7 +55,6 @@ exports.IGNORE_MSG_VALUE_1_NANO = 1n;
 exports.CROSS_CHAIN_MESSAGE_VERSION_V1 = 1n;
 exports.NFT_BRIDGE_AMOUNT = 1n;
 exports.DEFAULT_EIP1559_PRIORITY_FEE = 0n;
-exports.SHARDS_KEY_RANDOM_RANGE = 1e18;
 exports.IGNORE_OPCODE = [
     0xd53276db, // Excess
 ];

package/dist/src/sdk/LiteSequencerClient.js

@@ -4,9 +4,10 @@ exports.LiteSequencerClient = void 0;
 const errors_1 = require("../errors");
 const instances_1 = require("../errors/instances");
 const AxiosHttpClient_1 = require("./AxiosHttpClient");
+const Consts_1 = require("./Consts");
 const Utils_1 = require("./Utils");
 class LiteSequencerClient {
-    constructor(endpoint, maxChunkSize = 100, httpClient = new AxiosHttpClient_1.AxiosHttpClient()) {
+    constructor(endpoint, maxChunkSize = 100, httpClient = new AxiosHttpClient_1.AxiosHttpClient({ timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS })) {
         this.endpoint = endpoint;
         this.maxChunkSize = maxChunkSize;
         this.httpClient = httpClient;

package/dist/src/sdk/OperationTracker.d.ts

@@ -1,15 +1,18 @@
-import { ILiteSequencerClient, ILiteSequencerClientFactory, ILogger, IOperationTracker } from '../interfaces';
-import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStages, ExecutionStagesByOperationId, ExecutionStagesV2, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, Network, OperationIdsByShardsKey, OperationIdWithLogIndex, OperationType, OperationTypeV2Info, SimplifiedStatuses, StatusInfo, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker, WaitOptions } from '../structs/Struct';
+import { IConfiguration, ILiteSequencerClient, ILiteSequencerClientFactory, ILogger, IOperationTracker } from '../interfaces';
+import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStages, ExecutionStagesByOperationId, ExecutionStagesV2, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationIdWithLogIndex, OperationType, OperationTypeV2Info, SimplifiedStatuses, StatusInfo, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker, WaitOptions } from '../structs/Struct';
 export declare class DefaultLiteSequencerClientFactory implements ILiteSequencerClientFactory {
     createClients(endpoints: string[]): ILiteSequencerClient[];
 }
 export declare class OperationTracker implements IOperationTracker {
     private readonly clients;
     private readonly logger;
-    constructor(network: Network, customLiteSequencerEndpoints?: string[], logger?: ILogger, clientFactory?: ILiteSequencerClientFactory);
+    private readonly config;
+    constructor(config: IConfiguration, logger?: ILogger, clientFactory?: ILiteSequencerClientFactory);
     getOperationIdByTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
     getOperationIdByTacTransactionHash(transactionHash: string, waitOptions?: WaitOptions<OperationIdWithLogIndex[]> | null): Promise<OperationIdWithLogIndex[]>;
     getOperationIdByTonTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
+    getOperationIdByTonTransactionBoc(boc: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
+    private getOperationIdByTonTransaction;
     getOperationType(operationId: string, waitOptions?: WaitOptions<OperationType> | null): Promise<OperationType>;
     getOperationTypeV2(operationId: string, waitOptions?: WaitOptions<OperationTypeV2Info> | null): Promise<OperationTypeV2Info>;
     getOperationId(transactionLinker: TransactionLinker, waitOptions?: WaitOptions<string> | null): Promise<string>;

package/dist/src/sdk/OperationTracker.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationTracker = exports.DefaultLiteSequencerClientFactory = void 0;
-const artifacts_1 = require("../../artifacts");
+const ton_1 = require("@ton/ton");
 const errors_1 = require("../errors");
 const instances_1 = require("../errors/instances");
 const Struct_1 = require("../structs/Struct");
@@ -16,23 +16,10 @@ class DefaultLiteSequencerClientFactory {
 }
 exports.DefaultLiteSequencerClientFactory = DefaultLiteSequencerClientFactory;
 class OperationTracker {
-    constructor(network, customLiteSequencerEndpoints, logger = new Logger_1.NoopLogger(), clientFactory = new DefaultLiteSequencerClientFactory()) {
-        let endpoints;
-        if (network === Struct_1.Network.DEV) {
-            if (!customLiteSequencerEndpoints || customLiteSequencerEndpoints.length === 0) {
-                throw new Error('For DEV network, custom lite sequencer endpoints must be provided');
-            }
-            endpoints = customLiteSequencerEndpoints;
-        }
-        else {
-            const artifacts = network === Struct_1.Network.MAINNET ? artifacts_1.mainnet : artifacts_1.testnet;
-            endpoints =
-                customLiteSequencerEndpoints && customLiteSequencerEndpoints.length !== 0
-                    ? customLiteSequencerEndpoints
-                    : artifacts.PUBLIC_LITE_SEQUENCER_ENDPOINTS;
-        }
-        this.clients = clientFactory.createClients(endpoints);
+    constructor(config, logger = new Logger_1.NoopLogger(), clientFactory = new DefaultLiteSequencerClientFactory()) {
+        this.clients = clientFactory.createClients(config.liteSequencerEndpoints);
         this.logger = logger;
+        this.config = config;
     }
     async getOperationIdByTransactionHash(transactionHash, waitOptions) {
         const requestFn = async () => {
@@ -71,11 +58,49 @@ class OperationTracker {
             : await (0, Utils_1.waitUntilSuccess)({ logger: this.logger, ...waitOptions }, requestFn, `OperationTracker: Getting operation IDs by TAC transaction hash ${(0, Utils_1.formatObjectForLogging)(transactionHash)}`);
     }
     async getOperationIdByTonTransactionHash(transactionHash, waitOptions) {
+        return this.getOperationIdByTonTransaction(async () => transactionHash, `OperationTracker: Getting operation ID by TON transaction hash ${(0, Utils_1.formatObjectForLogging)(transactionHash)}`, waitOptions);
+    }
+    async getOperationIdByTonTransactionBoc(boc, waitOptions) {
+        if (!this.config.TONParams.tonIndexer) {
+            throw errors_1.tonIndexerRequiredForTonTransactionBocError;
+        }
+        let message;
+        try {
+            message = (0, ton_1.loadMessage)(ton_1.Cell.fromBase64(boc).beginParse());
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : undefined;
+            throw (0, errors_1.invalidTonExternalMessageBocError)(reason);
+        }
+        if (message.info.type !== 'external-in') {
+            throw (0, errors_1.externalInMessageRequiredError)(message.info.type);
+        }
+        const destination = ton_1.Address.parse(message.info.dest.toString());
+        const messageHash = (0, Utils_1.getNormalizedExtMessageHash)(message);
+        return this.getOperationIdByTonTransaction(async () => {
+            const transaction = await this.config.TONParams.contractOpener.getTransactionByHash(destination, messageHash);
+            return transaction?.hash().toString('base64') ?? '';
+        }, 'OperationTracker: Getting operation ID by TON transaction BOC', waitOptions);
+    }
+    async getOperationIdByTonTransaction(resolveTransactionHash, operationDescription, waitOptions) {
         const requestFn = async () => {
+            const transactionHash = await resolveTransactionHash();
+            if (!transactionHash) {
+                return '';
+            }
+            let eventTxHash = transactionHash;
+            const tonIndexer = this.config.TONParams.tonIndexer;
+            if (tonIndexer) {
+                const cclTransaction = await tonIndexer.findCollectibleCrossChainLayerTransaction(transactionHash, this.config.TONParams.crossChainLayerAddress);
+                if (!cclTransaction) {
+                    return '';
+                }
+                eventTxHash = `0x${(0, Utils_1.normalizeHashToHex)(cclTransaction.hash)}`;
+            }
             let lastError;
             for (const client of this.clients) {
                 try {
-                    const id = await client.getOperationIdByTonTransactionHash(transactionHash);
+                    const id = await client.getOperationIdByTonTransactionHash(eventTxHash);
                     return id;
                 }
                 catch (error) {
@@ -86,7 +111,7 @@ class OperationTracker {
         };
         return waitOptions === null
             ? await requestFn()
-            : await (0, Utils_1.waitUntilSuccess)({ logger: this.logger, ...waitOptions }, requestFn, `OperationTracker: Getting operation ID by TON transaction hash ${(0, Utils_1.formatObjectForLogging)(transactionHash)}`);
+            : await (0, Utils_1.waitUntilSuccess)({ logger: this.logger, ...waitOptions }, requestFn, operationDescription);
     }
     async getOperationType(operationId, waitOptions) {
         const requestFn = async () => {