@tonappchain/sdk 0.7.3-rc6 → 0.7.3-rc8

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.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,4 @@ 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);

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/interfaces/IToncenterV3Indexer.d.ts

@@ -15,6 +15,7 @@ export interface IToncenterV3Indexer {
      * @returns Indexed transaction with owning account context, or null if not found.
      */
     getTransactionByHash(transactionHash: string): Promise<ToncenterV3IndexedTransaction | null>;
+    getTransactionsByMessageHash(messageHash: string, direction: 'in' | 'out'): Promise<ToncenterV3IndexedTransaction[]>;
     /**
      * Resolves adjacent indexed transactions for the provided hash from the same linked chain of TON transactions.
      * The result may contain both parent and child transactions.

package/dist/src/sdk/Configuration.js

@@ -53,9 +53,13 @@ class Configuration {
         else {
             contractOpener =
                 TONParams?.contractOpener ??
-                    (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, Consts_1.DEFAULT_RETRY_MAX_COUNT, delay, passLoggerToOpeners ? logger : undefined));
+                    (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,

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

@@ -41,7 +41,6 @@ export declare const DEFAULT_WAIT_MAX_ATTEMPTS = 30;
 export declare const DEFAULT_WAIT_DELAY_MS = 10000;
 export declare const DEFAULT_FIND_TX_LIMIT = 100;
 export declare const DEFAULT_MAX_SCANNED_TRANSACTIONS = 100;
-export declare const DEFAULT_FIND_TX_ARCHIVAL = true;
 export declare const DEFAULT_FIND_TX_MAX_DEPTH = 10;
 export declare const DEFAULT_RETRY_ON_NOT_FOUND = true;
 export declare const DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = 10;
@@ -52,3 +51,4 @@ 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.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_FIND_TX_ARCHIVAL = 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.IGNORE_OPCODE = exports.SHARDS_KEY_RANDOM_RANGE = exports.DEFAULT_EIP1559_PRIORITY_FEE = exports.NFT_BRIDGE_AMOUNT = void 0;
+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;
 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);
@@ -47,7 +47,6 @@ exports.DEFAULT_WAIT_MAX_ATTEMPTS = 30;
 exports.DEFAULT_WAIT_DELAY_MS = 10000; // 10 seconds
 exports.DEFAULT_FIND_TX_LIMIT = 100;
 exports.DEFAULT_MAX_SCANNED_TRANSACTIONS = 100;
-exports.DEFAULT_FIND_TX_ARCHIVAL = true;
 exports.DEFAULT_FIND_TX_MAX_DEPTH = 10;
 exports.DEFAULT_RETRY_ON_NOT_FOUND = true;
 exports.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = 10;
@@ -60,3 +59,4 @@ exports.SHARDS_KEY_RANDOM_RANGE = 1e18;
 exports.IGNORE_OPCODE = [
     0xd53276db, // Excess
 ];
+exports.HTTP_NOT_FOUND_STATUS_CODE = 404;

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 () => {

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

@@ -1,6 +1,10 @@
 import { ContractOpener, ILogger } from '../interfaces';
 import { ITxFinalizer } from '../interfaces/ITxFinalizer';
 import { ExecutionStages, Network, TransactionLinkerWithOperationId } from '../structs/Struct';
+/**
+ * @deprecated Use `TacSdk.sendCrossChainTransaction(...)` instead. It already waits for operation ID
+ * and full cross-chain finalization by default via `waitOperationId` and `waitFinalization` options.
+ */
 export declare function startTracking(transactionLinker: TransactionLinkerWithOperationId, network: Network, options?: {
     customLiteSequencerEndpoints?: string[];
     delay?: number;
@@ -12,6 +16,10 @@ export declare function startTracking(transactionLinker: TransactionLinkerWithOp
     contractOpener?: ContractOpener;
     cclAddress?: string;
 }): Promise<void | ExecutionStages>;
+/**
+ * @deprecated Use `TacSdk.sendCrossChainTransaction(...)` for new single-transaction flows. It already waits
+ * for operation ID and full cross-chain finalization by default via `waitOperationId` and `waitFinalization` options.
+ */
 export declare function startTrackingMultiple(transactionLinkers: TransactionLinkerWithOperationId[], network: Network, options?: {
     customLiteSequencerEndpoints?: string[];
     delay?: number;

package/dist/src/sdk/StartTracking.js

@@ -3,14 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startTracking = startTracking;
 exports.startTrackingMultiple = startTrackingMultiple;
 exports.printExecutionStagesTable = printExecutionStagesTable;
+const artifacts_1 = require("../../artifacts");
 const Struct_1 = require("../structs/Struct");
+const Configuration_1 = require("./Configuration");
 const Consts_1 = require("./Consts");
 const Logger_1 = require("./Logger");
 const OperationTracker_1 = require("./OperationTracker");
 const Utils_1 = require("./Utils");
+/**
+ * @deprecated Use `TacSdk.sendCrossChainTransaction(...)` instead. It already waits for operation ID
+ * and full cross-chain finalization by default via `waitOperationId` and `waitFinalization` options.
+ */
 async function startTracking(transactionLinker, network, options) {
     const { customLiteSequencerEndpoints, delay = 10, maxIterationCount = Consts_1.MAX_ITERATION_COUNT, returnValue = false, tableView = true, logger = new Logger_1.NoopLogger(), txFinalizer, contractOpener, cclAddress, } = options || {};
-    const tracker = new OperationTracker_1.OperationTracker(network, customLiteSequencerEndpoints, logger);
+    const artifacts = network === Struct_1.Network.MAINNET ? artifacts_1.mainnet : network === Struct_1.Network.TESTNET ? artifacts_1.testnet : artifacts_1.dev;
+    const liteSequencerEndpoints = customLiteSequencerEndpoints && customLiteSequencerEndpoints.length !== 0
+        ? customLiteSequencerEndpoints
+        : artifacts.PUBLIC_LITE_SEQUENCER_ENDPOINTS;
+    if (network === Struct_1.Network.DEV && liteSequencerEndpoints.length === 0) {
+        throw new Error('For DEV network, custom lite sequencer endpoints must be provided');
+    }
+    const trackerConfig = new Configuration_1.Configuration(network, artifacts, {}, {}, liteSequencerEndpoints, logger);
+    const tracker = new OperationTracker_1.OperationTracker(trackerConfig, logger);
     logger.debug(`Start tracking operation\n` +
         `caller: ${transactionLinker.caller}\n` +
         `shardsKey: ${transactionLinker.shardsKey}\n` +
@@ -102,6 +116,10 @@ async function startTracking(transactionLinker, network, options) {
         logger.debug(formatExecutionStages(profilingData));
     }
 }
+/**
+ * @deprecated Use `TacSdk.sendCrossChainTransaction(...)` for new single-transaction flows. It already waits
+ * for operation ID and full cross-chain finalization by default via `waitOperationId` and `waitFinalization` options.
+ */
 async function startTrackingMultiple(transactionLinkers, network, options) {
     const { customLiteSequencerEndpoints, delay = 10, maxIterationCount = Consts_1.MAX_ITERATION_COUNT, returnValue = false, tableView = true, txFinalizer, contractOpener, cclAddress, logger = new Logger_1.NoopLogger(), } = options || {};
     logger.debug(`Start tracking ${transactionLinkers.length} operations`);

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

@@ -11,6 +11,7 @@ export declare class TONTransactionManager implements ITONTransactionManager {
     private prepareCrossChainTransaction;
     private generateCrossChainMessages;
     sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx): Promise<TransactionLinkerWithOperationId>;
+    private resolveOperationId;
     sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTx[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
     private prepareBatchTransactions;
     private waitForOperationIds;

package/dist/src/sdk/TONTransactionManager.js

@@ -191,15 +191,10 @@ class TONTransactionManager {
         const waitOptions = tx.options?.waitOptions ?? {};
         waitOptions.successCheck = waitOptions.successCheck ?? ((id) => !!id);
         waitOptions.logger = waitOptions.logger ?? this.logger;
-        const operationId = await this.operationTracker
-            .getOperationId(transactionLinker, waitOptions)
-            .catch((error) => {
-            this.logger.error(`Error while waiting for operation ID: ${error}`);
-            return undefined;
-        });
+        const operationId = await this.resolveOperationId(sendTransactionResult.boc, transactionLinker, waitOptions);
         const shouldWaitForFinalization = tx.options?.waitFinalization ?? true;
         if (!shouldWaitForFinalization) {
-            return { sendTransactionResult, ...transactionLinker };
+            return { sendTransactionResult, operationId, ...transactionLinker };
         }
         if (!operationId) {
             throw errors_1.operationIdRequiredForFinalizationError;
@@ -224,6 +219,22 @@ class TONTransactionManager {
         await this.operationTracker.getStageProfiling(operationId, finalizationWaitOptions);
         return { sendTransactionResult, operationId, ...transactionLinker };
     }
+    async resolveOperationId(boc, transactionLinker, waitOptions) {
+        const operationId = await this.operationTracker
+            .getOperationIdByTonTransactionBoc(boc, waitOptions)
+            .catch((error) => {
+            this.logger.error(`Error while waiting for operation ID by TON transaction BOC: ${error}`);
+            return undefined;
+        });
+        if (operationId) {
+            return operationId;
+        }
+        this.logger.debug('Operation ID by TON transaction BOC not found; trying transaction linker');
+        return this.operationTracker.getOperationId(transactionLinker, waitOptions).catch((error) => {
+            this.logger.error(`Error while waiting for operation ID by transaction linker: ${error}`);
+            return undefined;
+        });
+    }
     async sendCrossChainTransactions(sender, txs, options) {
         const caller = sender.getSenderAddress();
         this.logger.debug(`Preparing ${txs.length} cross-chain transactions for ${caller}`);

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

@@ -3,7 +3,7 @@ import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT, TAC, TON } from '../assets';
 import { ContractOpener, IConfiguration, ILogger, IOperationTracker, ITacExplorerClient, ITacSDK } from '../interfaces';
 import type { SenderAbstraction } from '../sender';
-import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrossChainTransactionToTONOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SDKParams, 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, SDKParams, SuggestedTVMExecutorFee, TACCrossChainTransactionResult, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 export declare class TacSdk implements ITacSDK {
     readonly config: IConfiguration;
     readonly contactOpener: ContractOpener;
@@ -12,7 +12,6 @@ export declare class TacSdk implements ITacSDK {
     private readonly simulator;
     private readonly tonTransactionManager;
     private readonly tacTransactionManager;
-    private readonly tonIndexer;
     private constructor();
     static create(sdkParams: SDKParams, logger?: ILogger): Promise<TacSdk>;
     closeConnections(): unknown;
@@ -26,8 +25,6 @@ export declare class TacSdk implements ITacSDK {
     sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<TransactionLinkerWithOperationId>;
     sendCrossChainTransactionToTON(signer: Wallet, tonTarget: string, assets?: AssetLike[], options?: CrossChainTransactionToTONOptions): Promise<TACCrossChainTransactionResult>;
     sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTxWithAssetLike[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
-    getOperationIdByTonTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
-    getOperationIdByTonTransactionBoc(boc: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
     bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: AssetLike[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
     isContractDeployedOnTVM(address: string): Promise<boolean>;
     simulateTACMessage(req: TACSimulationParams): Promise<TACSimulationResult>;
@@ -51,5 +48,4 @@ export declare class TacSdk implements ITacSDK {
     prepareCrossChainTransactionPayload(evmProxyMsg: EvmProxyMsg, senderAddress: string, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<CrossChainPayloadResult[]>;
     getTACGasPrice(): Promise<TacGasPrice>;
     getTonContractOpener(): ContractOpener;
-    private toSequencerTonTransactionHash;
 }

package/dist/src/sdk/TacSdk.js

@@ -1,11 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TacSdk = void 0;
-const ton_1 = require("@ton/ton");
 const artifacts_1 = require("../../artifacts");
-const adapters_1 = require("../adapters");
 const assets_1 = require("../assets");
-const errors_1 = require("../errors");
 const Struct_1 = require("../structs/Struct");
 const Configuration_1 = require("./Configuration");
 const Consts_1 = require("./Consts");
@@ -17,7 +14,7 @@ const TACTransactionManager_1 = require("./TACTransactionManager");
 const TONTransactionManager_1 = require("./TONTransactionManager");
 const Utils_1 = require("./Utils");
 class TacSdk {
-    constructor(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient, tonIndexer) {
+    constructor(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient) {
         this.config = config;
         this.contactOpener = config.TONParams.contractOpener;
         this.simulator = simulator;
@@ -25,7 +22,6 @@ class TacSdk {
         this.tacTransactionManager = tacTransactionManager;
         this.operationTracker = operationTracker;
         this.explorerClient = explorerClient;
-        this.tonIndexer = tonIndexer;
     }
     static async create(sdkParams, logger = new Logger_1.NoopLogger()) {
         const network = sdkParams.network;
@@ -46,13 +42,12 @@ class TacSdk {
                 throw new Error(`Unsupported network: ${network}`);
         }
         const config = await Configuration_1.Configuration.create(network, artifacts, sdkParams.TONParams, sdkParams.TACParams, sdkParams.customLiteSequencerEndpoints, delay, logger, passLoggerToOpeners);
-        const operationTracker = new OperationTracker_1.OperationTracker(network, config.liteSequencerEndpoints, logger);
+        const operationTracker = new OperationTracker_1.OperationTracker(config, logger);
         const explorerClient = new TacExplorerClient_1.TacExplorerClient(artifacts.TAC_EXPLORER_API_ENDPOINT);
         const simulator = new Simulator_1.Simulator(config, operationTracker, logger);
         const tonTransactionManager = new TONTransactionManager_1.TONTransactionManager(config, simulator, operationTracker, logger);
         const tacTransactionManager = new TACTransactionManager_1.TACTransactionManager(config, operationTracker, logger);
-        const tonIndexer = sdkParams.TONParams?.tonIndexer ?? new adapters_1.ToncenterV3Indexer(artifacts.TONCENTER_V3_INDEXER_ENDPOINT);
-        return new TacSdk(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient, tonIndexer);
+        return new TacSdk(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient);
     }
     closeConnections() {
         return this.config.closeConnections();
@@ -104,32 +99,6 @@ class TacSdk {
         })));
         return this.tonTransactionManager.sendCrossChainTransactions(sender, normalizedTxs, options);
     }
-    async getOperationIdByTonTransactionHash(transactionHash, waitOptions) {
-        const cclTransaction = await this.tonIndexer.findCollectibleCrossChainLayerTransaction(transactionHash, this.config.TONParams.crossChainLayerAddress);
-        if (!cclTransaction) {
-            return '';
-        }
-        return this.operationTracker.getOperationIdByTonTransactionHash(this.toSequencerTonTransactionHash(cclTransaction), waitOptions);
-    }
-    async getOperationIdByTonTransactionBoc(boc, waitOptions) {
-        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 = message.info.dest;
-        const transaction = await this.contactOpener.getTransactionByHash(ton_1.Address.parse(destination.toString()), (0, Utils_1.getNormalizedExtMessageHash)(message));
-        if (!transaction) {
-            return '';
-        }
-        return this.getOperationIdByTonTransactionHash(transaction.hash().toString('base64'), waitOptions);
-    }
     async bridgeTokensToTON(signer, value, tonTarget, assets, tvmExecutorFee, tvmValidExecutors) {
         const normalizedAssets = await (0, Utils_1.normalizeAssets)(this.config, assets);
         return this.tacTransactionManager.bridgeTokensToTON(signer, value, tonTarget, normalizedAssets, tvmExecutorFee, tvmValidExecutors);
@@ -235,8 +204,5 @@ class TacSdk {
     getTonContractOpener() {
         return this.contactOpener;
     }
-    toSequencerTonTransactionHash(transaction) {
-        return `0x${(0, Utils_1.normalizeHashToHex)(transaction.hash)}`;
-    }
 }
 exports.TacSdk = TacSdk;

package/dist/src/structs/InternalStruct.d.ts

@@ -1,7 +1,7 @@
-import { Address, Cell } from '@ton/ton';
+import type { Address, Cell, Message } from '@ton/ton';
 import { AbstractProvider, ethers } from 'ethers';
 import { ICrossChainLayer, ISAFactory, ISettings, ITokenUtils } from '../../artifacts/tacTypes';
-import { ContractOpener } from '../interfaces';
+import { ContractOpener, IToncenterV3Indexer } from '../interfaces';
 import { CurrencyType, ExecutionStagesByOperationId, ExecutionStagesV2ByOperationId, Network, OperationIdsByShardsKey, OperationIdWithLogIndex, OperationType, OperationTypeV2Info, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationResult, ToncenterV3IndexedTransaction, TransactionLinker } from './Struct';
 export type ShardMessage = {
     address: string;
@@ -37,6 +37,7 @@ export type RandomNumberByTimestamp = {
 };
 export type InternalTONParams = {
     contractOpener: ContractOpener;
+    tonIndexer?: IToncenterV3Indexer;
     jettonProxyAddress: string;
     nftProxyAddress: string;
     crossChainLayerAddress: string;
@@ -130,6 +131,13 @@ export type TransactionDepth = {
     depth: number;
     hashType?: 'unknown' | 'in' | 'out';
 };
+export type TransactionQueueItem = {
+    address: Address;
+    hash: string;
+    depth: number;
+    hashType: 'unknown' | 'in' | 'out';
+    message?: Message;
+};
 export type AdjacentTransactionsResponse = {
     transactions: ToncenterTransaction[];
 };

package/dist/src/structs/Struct.d.ts

@@ -197,8 +197,24 @@ export type ToncenterV3IndexedTransaction = {
     hash: string;
     /** Optional trace identifier returned by Toncenter v3. */
     traceId?: string;
+    /** Transaction phase data returned by Toncenter v3. */
+    description?: {
+        type?: string;
+        aborted?: boolean;
+        computePh?: {
+            skipped?: boolean;
+            success?: boolean;
+            exitCode?: number;
+        } | null;
+        action?: {
+            success?: boolean;
+            resultCode?: number;
+        } | null;
+    } | null;
     /** Incoming message of the indexed transaction, when present in the response. */
     inMsg?: {
+        /** Indexed message hash. */
+        hash?: string | null;
         /** Message source address. */
         source?: string | null;
         /** Message destination address. */
@@ -213,6 +229,8 @@ export type ToncenterV3IndexedTransaction = {
     } | null;
     /** Outgoing messages of the indexed transaction. */
     outMsgs: Array<{
+        /** Indexed message hash. */
+        hash?: string | null;
         /** Message destination address. `null` means external outbound log message. */
         destination?: string | null;
         /** Raw message content returned by Toncenter v3. */
@@ -693,6 +711,15 @@ export type TrackTransactionTreeParams = {
      * @default 100
      */
     maxScannedTransactions?: number;
+    /**
+     * Whether to search archival nodes for historical data.
+     * Omitted by default; set true for old transactions when the provider has archival nodes.
+     */
+    archival?: boolean;
+    /**
+     * Logical time of the root transaction. Use with a root transaction hash to avoid scanning from latest history.
+     */
+    rootLt?: string;
     /**
      * List of operation codes (opcodes) to skip for extra checks.
      * Core phase validation is still applied.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tonappchain/sdk",
-    "version": "0.7.3-rc6",
+    "version": "0.7.3-rc8",
     "repository": "https://github.com/TacBuild/tac-sdk.git",
     "author": "TAC. <developers@tac>",
     "license": "MIT",
@@ -61,6 +61,8 @@
         "build:artifacts:tac:all": "npm run build:artifacts:tac:dev && npm run build:artifacts:tac:testnet && npm run build:artifacts:tac:mainnet",
         "build:artifacts": "npm run build:artifacts:ton:all && npm run build:artifacts:tac:all",
         "test": "jest --verbose --runInBand",
+        "test:ton-providers": "RUN_TON_PROVIDER_TESTS=1 jest --verbose --runInBand tests/ton_providers",
+        "test:toncenter-v2-tree": "RUN_TON_PROVIDER_TESTS=1 jest --verbose --runInBand tests/ton_providers/contractOpeners/toncenterV2HistoricalTree.spec.ts",
         "release": "npm run build && npx release-it",
         "lint": "eslint .",
         "lint:fix": "eslint . --fix",