@tonappchain/sdk 0.7.3-rc5 → 0.7.3-rc7

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

@@ -1,8 +1,9 @@
 import { SandboxContract } from '@ton/sandbox';
+import type { Message } from '@ton/ton';
 import { Address, Contract, OpenedContract, Transaction } from '@ton/ton';
 import { ContractOpener, ILogger } from '../interfaces';
 import { AddressInformation, GetTransactionsOptions } from '../structs/Struct';
-import { ContractState, TrackTransactionTreeParams, TrackTransactionTreeResult } from '../structs/Struct';
+import { ContractState, TrackTransactionTreeParams, TrackTransactionTreeResult, TransactionValidationError } from '../structs/Struct';
 /**
  * Base class for ContractOpener implementations with common functionality
  */
@@ -56,15 +57,15 @@ export declare abstract class BaseContractOpener implements ContractOpener {
     /**
      * Validate transaction phases and return error details
      */
-    private validateTransactionWithResult;
+    protected validateTransactionWithResult(tx: Transaction, ignoreOpcodeList: number[]): TransactionValidationError | null;
     /**
      * Find transaction by hash type
      */
-    private findTransactionByHashType;
+    protected findTransactionByHashType(address: Address, hash: string, hashType: 'unknown' | 'in' | 'out' | undefined, opts: GetTransactionsOptions, message?: Message): Promise<Transaction | null>;
     /**
      * Find transaction with retry logic
      */
-    private findTransactionWithRetry;
+    protected findTransactionWithRetry(address: Address, hash: string, hashType: 'unknown' | 'in' | 'out' | undefined, opts: GetTransactionsOptions, depth: number, message?: Message): Promise<Transaction | null>;
     /**
      * Track transaction tree and validate all transactions
      */

package/dist/src/adapters/BaseContractOpener.js

@@ -27,24 +27,33 @@ class BaseContractOpener {
      */
     async scanTransactionHistory(addr, opts, predicate) {
         const limit = opts?.limit ?? Consts_1.DEFAULT_FIND_TX_LIMIT;
-        const inclusive = opts?.inclusive ?? true;
+        const toLtInclusive = opts?.inclusive ?? true;
         const toLt = opts?.to_lt ? BigInt(opts.to_lt) : undefined;
         let currentLt = opts?.lt;
         let currentHash = opts?.hash ? (0, Utils_1.normalizeHashToBase64)(opts.hash) : undefined;
-        const seenCursors = new Set();
+        let requestInclusive = toLtInclusive;
+        const seenRequests = new Set();
         let scannedTransactions = 0;
         const maxScannedTransactions = opts?.maxScannedTransactions ?? Consts_1.DEFAULT_MAX_SCANNED_TRANSACTIONS;
         while (true) {
-            const list = await this.getTransactions(addr, {
+            const requestKey = `${currentLt ?? ''}:${currentHash ?? ''}:${requestInclusive}`;
+            if (seenRequests.has(requestKey)) {
+                break;
+            }
+            seenRequests.add(requestKey);
+            const requestOpts = {
                 limit,
                 lt: currentLt,
                 hash: currentHash,
                 to_lt: opts?.to_lt,
-                inclusive,
-                archival: opts?.archival ?? Consts_1.DEFAULT_FIND_TX_ARCHIVAL,
+                inclusive: requestInclusive,
                 timeoutMs: opts?.timeoutMs,
                 retryDelayMs: opts?.retryDelayMs,
-            });
+            };
+            if (opts?.archival !== undefined) {
+                requestOpts.archival = opts.archival;
+            }
+            const list = await this.getTransactions(addr, requestOpts);
             if (list.length === 0) {
                 break;
             }
@@ -54,7 +63,7 @@ class BaseContractOpener {
                 currentHash &&
                 firstTx.lt.toString() === currentLt &&
                 firstTx.hash().toString('base64') === currentHash;
-            if (firstTxMatchesCursor) {
+            if (firstTxMatchesCursor && !requestInclusive) {
                 startIndex = 1;
                 if (list.length === 1) {
                     if (firstTx.prevTransactionLt === 0n) {
@@ -65,13 +74,9 @@ class BaseContractOpener {
                     if (currentLt && BigInt(nextLt) >= BigInt(currentLt)) {
                         break;
                     }
-                    const cursorKey = `${nextLt}:${nextHash}`;
-                    if (seenCursors.has(cursorKey)) {
-                        break;
-                    }
-                    seenCursors.add(cursorKey);
                     currentLt = nextLt;
                     currentHash = nextHash;
+                    requestInclusive = true;
                     continue;
                 }
             }
@@ -90,21 +95,17 @@ class BaseContractOpener {
             if (oldestTx.prevTransactionLt === 0n)
                 break;
             if (toLt !== undefined) {
-                if (inclusive ? oldestTx.lt <= toLt : oldestTx.lt < toLt)
+                if (toLtInclusive ? oldestTx.lt <= toLt : oldestTx.lt < toLt)
                     break;
             }
             const nextLt = oldestTx.lt.toString();
             const nextHash = oldestTx.hash().toString('base64');
-            if (currentLt && BigInt(nextLt) >= BigInt(currentLt)) {
+            if (currentLt && currentHash && nextLt === currentLt && nextHash === currentHash && !requestInclusive) {
                 break;
             }
-            const cursorKey = `${nextLt}:${nextHash}`;
-            if (seenCursors.has(cursorKey)) {
-                break;
-            }
-            seenCursors.add(cursorKey);
             currentLt = nextLt;
             currentHash = nextHash;
+            requestInclusive = false;
         }
         return null;
     }
@@ -281,37 +282,31 @@ class BaseContractOpener {
     /**
      * Find transaction by hash type
      */
-    async findTransactionByHashType(address, hash, hashType, opts) {
-        const searchOpts = { archival: true, ...opts };
+    async findTransactionByHashType(address, hash, hashType, opts, message) {
+        const targetHash = message ? (0, ton_1.beginCell)().store((0, ton_1.storeMessage)(message)).endCell().hash().toString('base64') : hash;
         if (hashType === 'in') {
-            return this.getTransactionByInMsgHash(address, hash, searchOpts);
+            return this.getTransactionByInMsgHash(address, targetHash, opts);
         }
         else if (hashType === 'out') {
-            return this.getTransactionByOutMsgHash(address, hash, searchOpts);
+            return this.getTransactionByOutMsgHash(address, targetHash, opts);
         }
         else {
-            return this.getTransactionByHash(address, hash, searchOpts);
+            return this.getTransactionByHash(address, targetHash, opts);
         }
     }
     /**
      * Find transaction with retry logic
      */
-    async findTransactionWithRetry(address, hash, hashType, opts, depth) {
+    async findTransactionWithRetry(address, hash, hashType, opts, depth, message) {
         const retryDelayMs = opts.retryDelayMs ?? Consts_1.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS;
         const maxRetries = opts.retries ?? Consts_1.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            let errorMsg;
-            try {
-                const tx = await this.findTransactionByHashType(address, hash, hashType, opts);
-                if (tx) {
-                    return tx;
-                }
-            }
-            catch (error) {
-                errorMsg = error instanceof Error ? error.message : String(error);
+            const tx = await this.findTransactionByHashType(address, hash, hashType, opts, message);
+            if (tx) {
+                return tx;
             }
             const isLastAttempt = attempt >= maxRetries;
-            const reason = errorMsg ?? 'not found';
+            const reason = 'not found';
             const retryInfo = isLastAttempt ? '' : `, retrying in ${retryDelayMs}ms`;
             this.logger?.debug(`Transaction not found at depth ${depth} (attempt ${attempt + 1}/${maxRetries + 1}): ${reason}${retryInfo}`);
             if (isLastAttempt) {
@@ -357,7 +352,7 @@ class BaseContractOpener {
         direction: Struct_1.TransactionTreeDirection.FORWARD,
         retryOnNotFound: Consts_1.DEFAULT_RETRY_ON_NOT_FOUND,
     }) {
-        const { maxDepth = Consts_1.DEFAULT_FIND_TX_MAX_DEPTH, ignoreOpcodeList = Consts_1.IGNORE_OPCODE, limit = Consts_1.DEFAULT_FIND_TX_LIMIT, maxScannedTransactions = Consts_1.DEFAULT_MAX_SCANNED_TRANSACTIONS, direction = Struct_1.TransactionTreeDirection.FORWARD, retryOnNotFound = Consts_1.DEFAULT_RETRY_ON_NOT_FOUND, retryDelayMs, retries, } = params;
+        const { maxDepth = Consts_1.DEFAULT_FIND_TX_MAX_DEPTH, ignoreOpcodeList = Consts_1.IGNORE_OPCODE, limit = Consts_1.DEFAULT_FIND_TX_LIMIT, maxScannedTransactions = Consts_1.DEFAULT_MAX_SCANNED_TRANSACTIONS, archival, rootLt, direction = Struct_1.TransactionTreeDirection.FORWARD, retryOnNotFound = Consts_1.DEFAULT_RETRY_ON_NOT_FOUND, retryDelayMs, retries, } = params;
         const parsedAddress = ton_1.Address.parse(address);
         const normalizedRootHash = (0, Utils_1.normalizeHashToBase64)(hash);
         const visitedSearchKeys = new Set();
@@ -365,25 +360,30 @@ class BaseContractOpener {
         let checkedCount = 0;
         const searchOpts = {
             limit,
-            archival: true,
             maxScannedTransactions,
             retryDelayMs,
             retries,
         };
+        if (archival !== undefined) {
+            searchOpts.archival = archival;
+        }
         const queue = [
             { address: parsedAddress, hash: normalizedRootHash, depth: 0, hashType: 'unknown' },
         ];
         while (queue.length > 0) {
-            const { hash: currentHash, depth: currentDepth, address: currentAddress, hashType } = queue.shift();
+            const { hash: currentHash, depth: currentDepth, address: currentAddress, hashType, message, } = queue.shift();
             const visitedKey = `${currentAddress.toString()}:${currentHash}:${hashType}`;
             if (visitedSearchKeys.has(visitedKey))
                 continue;
             visitedSearchKeys.add(visitedKey);
+            const currentSearchOpts = currentDepth === 0 && hashType === 'unknown' && rootLt
+                ? { ...searchOpts, lt: rootLt, hash: currentHash, inclusive: true }
+                : searchOpts;
             const tx = retryOnNotFound
-                ? await this.findTransactionWithRetry(currentAddress, currentHash, hashType, searchOpts, currentDepth)
-                : await this.findTransactionByHashType(currentAddress, currentHash, hashType, searchOpts);
+                ? await this.findTransactionWithRetry(currentAddress, currentHash, hashType, currentSearchOpts, currentDepth, message)
+                : await this.findTransactionByHashType(currentAddress, currentHash, hashType, currentSearchOpts, message);
             if (!tx) {
-                this.logger?.debug(`Transaction not found for hash: ${currentHash} (address=${currentAddress?.toString()}, hashType=${hashType ?? 'unknown'})`);
+                this.logger?.debug(`Transaction not found for hash: ${currentHash} (address=${currentAddress.toString()}, hashType=${hashType})`);
                 return {
                     success: false,
                     checkedCount,
@@ -392,8 +392,8 @@ class BaseContractOpener {
                         exitCode: 'N/A',
                         resultCode: 'N/A',
                         reason: 'not_found',
-                        address: currentAddress?.toString(),
-                        hashType: hashType ?? 'unknown',
+                        address: currentAddress.toString(),
+                        hashType,
                     },
                 };
             }
@@ -422,6 +422,7 @@ class BaseContractOpener {
                             address: dst,
                             depth: currentDepth + 1,
                             hashType: 'in',
+                            message: msg,
                         });
                     }
                 }
@@ -433,6 +434,7 @@ class BaseContractOpener {
                         address: tx.inMessage.info.src,
                         depth: currentDepth + 1,
                         hashType: 'out',
+                        message: tx.inMessage,
                     });
                 }
             }

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

@@ -42,4 +42,4 @@ export declare class RetryableContractOpener implements ContractOpener {
     private createRetryableContract;
     private callMethodAcrossOpeners;
 }
-export declare function createDefaultRetryableOpener(tonRpcEndpoint: string, networkType: Network, maxRetries?: number, retryDelay?: number, logger?: ILogger): Promise<RetryableContractOpener>;
+export declare function createDefaultRetryableOpener(tonRpcEndpoint: string, networkType: Network, maxRetries?: number, retryDelay?: number, logger?: ILogger, toncenterV3Endpoint?: string): Promise<RetryableContractOpener>;

package/dist/src/adapters/RetryableContractOpener.js

@@ -7,6 +7,8 @@ const errors_1 = require("../errors");
 const instances_1 = require("../errors/instances");
 const Consts_1 = require("../sdk/Consts");
 const Struct_1 = require("../structs/Struct");
+const ToncenterV3Indexer_1 = require("./ToncenterV3Indexer");
+const ToncenterV3Opener_1 = require("./ToncenterV3Opener");
 const TonClient4Opener_1 = require("./TonClient4Opener");
 const TonClientOpener_1 = require("./TonClientOpener");
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -271,12 +273,21 @@ class RetryableContractOpener {
     }
 }
 exports.RetryableContractOpener = RetryableContractOpener;
-async function createDefaultRetryableOpener(tonRpcEndpoint, networkType, maxRetries = Consts_1.DEFAULT_RETRY_MAX_COUNT, retryDelay = Consts_1.DEFAULT_RETRY_DELAY_MS, logger) {
+async function createDefaultRetryableOpener(tonRpcEndpoint, networkType, maxRetries = Consts_1.DEFAULT_RETRY_MAX_COUNT, retryDelay = Consts_1.DEFAULT_RETRY_DELAY_MS, logger, toncenterV3Endpoint) {
     const openers = [];
     const tonClient = new ton_1.TonClient({
         endpoint: new URL('api/v2/jsonRPC', tonRpcEndpoint).toString(),
         timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS,
     });
+    if (toncenterV3Endpoint) {
+        openers.push({
+            opener: new ToncenterV3Opener_1.ToncenterV3Opener(new ToncenterV3Indexer_1.ToncenterV3Indexer(toncenterV3Endpoint), tonClient, logger),
+            retries: maxRetries,
+            retryDelay,
+            maxRetryDelay: Consts_1.DEFAULT_RETRY_MAX_DELAY_MS,
+            retryBackoffMultiplier: Consts_1.DEFAULT_RETRY_BACKOFF_MULTIPLIER,
+        });
+    }
     const opener = (0, TonClientOpener_1.tonClientOpener)(tonClient, logger);
     openers.push({
         opener,

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

@@ -1,3 +1,4 @@
+import type { Message } from '@ton/ton';
 import { Address, Contract, OpenedContract, TonClient, Transaction } from '@ton/ton';
 import { ILogger } from '../interfaces';
 import { AddressInformation, ContractState, GetTransactionsOptions, Network } from '../structs/Struct';
@@ -12,6 +13,7 @@ export declare class TonClientOpener extends BaseContractOpener {
     getContractState(address: Address): Promise<ContractState>;
     getTransactions(address: Address, opts: GetTransactionsOptions): Promise<Transaction[]>;
     getAddressInformation(addr: Address): Promise<AddressInformation>;
+    protected findTransactionByHashType(address: Address, hash: string, hashType: 'unknown' | 'in' | 'out' | undefined, opts: GetTransactionsOptions, message?: Message): Promise<Transaction | null>;
     getConfig(): Promise<string>;
 }
 export declare function tonClientOpener(client: TonClient, logger?: ILogger): TonClientOpener;

package/dist/src/adapters/TonClientOpener.js

@@ -38,7 +38,7 @@ class TonClientOpener extends BaseContractOpener_1.BaseContractOpener {
             hash: opts.hash ? (0, Utils_1.normalizeHashToBase64)(opts.hash) : undefined,
             to_lt: opts.to_lt,
             inclusive: opts.inclusive,
-            archival: opts.archival,
+            ...(opts.archival === undefined ? {} : { archival: opts.archival }),
         };
         return this.client.getTransactions(address, clientOpts);
     }
@@ -51,6 +51,40 @@ class TonClientOpener extends BaseContractOpener_1.BaseContractOpener {
             },
         };
     }
+    async findTransactionByHashType(address, hash, hashType, opts, message) {
+        if (opts.archival === true && message?.info.type === 'internal') {
+            const { src, dest, createdLt } = message.info;
+            const targetHash = (0, Utils_1.normalizeHashToBase64)(hash);
+            if (hashType === 'in') {
+                try {
+                    const tx = await this.client.tryLocateResultTx(src, dest, createdLt.toString());
+                    if (tx.inMessage &&
+                        (0, ton_1.beginCell)().store((0, ton_1.storeMessage)(tx.inMessage)).endCell().hash().toString('base64') ===
+                            targetHash) {
+                        return tx;
+                    }
+                }
+                catch {
+                    // Keep the regular hash scan semantics when Toncenter cannot locate a delivered result.
+                }
+            }
+            else if (hashType === 'out') {
+                try {
+                    const tx = await this.client.tryLocateSourceTx(src, dest, createdLt.toString());
+                    for (const outMessage of tx.outMessages.values()) {
+                        if ((0, ton_1.beginCell)().store((0, ton_1.storeMessage)(outMessage)).endCell().hash().toString('base64') ===
+                            targetHash) {
+                            return tx;
+                        }
+                    }
+                }
+                catch {
+                    // Keep the regular hash scan semantics when Toncenter cannot locate the source.
+                }
+            }
+        }
+        return super.findTransactionByHashType(address, hash, hashType, opts, message);
+    }
     async getConfig() {
         const info = await this.client.getMasterchainInfo();
         const url = new URL('getConfigAll', this.client.parameters.endpoint);

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

@@ -14,6 +14,7 @@ export declare class ToncenterV3Indexer implements IToncenterV3Indexer {
      * @returns Indexed transaction with owning account context, or null on 404 / empty result.
      */
     getTransactionByHash(transactionHash: string): Promise<ToncenterV3IndexedTransaction | null>;
+    getTransactionsByMessageHash(messageHash: string, direction: 'in' | 'out'): Promise<ToncenterV3IndexedTransaction[]>;
     /**
      * Queries Toncenter v3 indexed `/adjacentTransactions` endpoint by hash.
      * @param transactionHash TON transaction hash accepted by the indexer.

package/dist/src/adapters/ToncenterV3Indexer.js

@@ -27,20 +27,41 @@ class ToncenterV3Indexer {
             const response = await this.httpClient.get(endpoint, {
                 params: {
                     hash: transactionHash,
-                    limit: 1,
+                    limit: Consts_1.DEFAULT_FIND_TX_LIMIT,
                 },
                 transformResponse: [Utils_1.toCamelCaseTransformer],
             });
             return response.data.transactions?.[0] ?? null;
         }
         catch (error) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            if (error?.response?.status === 404) {
+            if (error.response?.status === Consts_1.HTTP_NOT_FOUND_STATUS_CODE) {
                 return null;
             }
             throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to resolve TON indexed transaction`, error);
         }
     }
+    async getTransactionsByMessageHash(messageHash, direction) {
+        const endpoint = this.endpoint.endsWith('/')
+            ? `${this.endpoint}transactionsByMessage`
+            : `${this.endpoint}/transactionsByMessage`;
+        try {
+            const { data } = await this.httpClient.get(endpoint, {
+                params: {
+                    msg_hash: messageHash,
+                    direction,
+                    limit: Consts_1.DEFAULT_FIND_TX_LIMIT,
+                },
+                transformResponse: [Utils_1.toCamelCaseTransformer],
+            });
+            return data.transactions ?? [];
+        }
+        catch (error) {
+            if (error.response?.status === Consts_1.HTTP_NOT_FOUND_STATUS_CODE) {
+                return [];
+            }
+            throw (0, errors_1.operationFetchError)(`request GET ${endpoint} failed to resolve TON indexed transactions by message`, error);
+        }
+    }
     /**
      * Queries Toncenter v3 indexed `/adjacentTransactions` endpoint by hash.
      * @param transactionHash TON transaction hash accepted by the indexer.
@@ -59,8 +80,7 @@ class ToncenterV3Indexer {
             return response.data.transactions ?? [];
         }
         catch (error) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            if (error?.response?.status === 404) {
+            if (error.response?.status === Consts_1.HTTP_NOT_FOUND_STATUS_CODE) {
                 return [];
             }
             throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to resolve adjacent TON indexed transactions`, error);
@@ -86,20 +106,19 @@ class ToncenterV3Indexer {
             return rootTransaction;
         }
         const queue = [{ hash: rootTransaction.hash, depth: 0 }];
-        const visitedHashes = new Set([(0, Utils_1.normalizeHashToHex)(rootTransaction.hash)]);
+        const visitedHashes = new Set([rootTransaction.hash]);
         let scannedTransactions = 0;
-        while (queue.length > 0) {
-            const { hash: currentHash, depth } = queue.shift();
+        for (let i = 0; i < queue.length; i++) {
+            const { hash: currentHash, depth } = queue[i];
             if (depth >= maxDepth || scannedTransactions >= maxScannedTransactions) {
                 continue;
             }
             const adjacentTransactions = await this.getAdjacentTransactions(currentHash);
             for (const transaction of adjacentTransactions) {
-                const normalizedHash = (0, Utils_1.normalizeHashToHex)(transaction.hash);
-                if (visitedHashes.has(normalizedHash)) {
+                if (visitedHashes.has(transaction.hash)) {
                     continue;
                 }
-                visitedHashes.add(normalizedHash);
+                visitedHashes.add(transaction.hash);
                 scannedTransactions += 1;
                 if (this.isCollectibleEventTransactionOnAccount(transaction, crossChainLayer)) {
                     return transaction;

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

@@ -0,0 +1,11 @@
+import { TonClient } from '@ton/ton';
+import { ILogger, IToncenterV3Indexer } from '../interfaces';
+import { TrackTransactionTreeParams, TrackTransactionTreeResult } from '../structs/Struct';
+import { TonClientOpener } from './TonClientOpener';
+export declare class ToncenterV3Opener extends TonClientOpener {
+    private readonly indexer;
+    constructor(indexer: IToncenterV3Indexer, client: TonClient, logger?: ILogger);
+    trackTransactionTreeWithResult(address: string, hash: string, params?: TrackTransactionTreeParams): Promise<TrackTransactionTreeResult>;
+    private findRootTransaction;
+    private validateIndexedTransactionWithResult;
+}

package/dist/src/adapters/ToncenterV3Opener.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToncenterV3Opener = void 0;
+const ton_1 = require("@ton/ton");
+const Consts_1 = require("../sdk/Consts");
+const Utils_1 = require("../sdk/Utils");
+const Struct_1 = require("../structs/Struct");
+const TonClientOpener_1 = require("./TonClientOpener");
+class ToncenterV3Opener extends TonClientOpener_1.TonClientOpener {
+    constructor(indexer, client, logger) {
+        super(client, logger);
+        this.indexer = indexer;
+    }
+    async trackTransactionTreeWithResult(address, hash, params = {}) {
+        const { maxDepth = Consts_1.DEFAULT_FIND_TX_MAX_DEPTH, direction = Struct_1.TransactionTreeDirection.FORWARD, retryOnNotFound = Consts_1.DEFAULT_RETRY_ON_NOT_FOUND, retryDelayMs = Consts_1.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS, retries = Consts_1.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES, } = params;
+        const rootAddress = ton_1.Address.parse(address);
+        const rootHash = (0, Utils_1.normalizeHashToBase64)(hash);
+        const attempts = retryOnNotFound ? retries + 1 : 1;
+        let rootTransaction = null;
+        for (let attempt = 0; attempt < attempts; attempt++) {
+            rootTransaction = await this.findRootTransaction(rootAddress, rootHash);
+            if (rootTransaction) {
+                break;
+            }
+            if (attempt < attempts - 1) {
+                await (0, Utils_1.sleep)(retryDelayMs);
+            }
+        }
+        if (!rootTransaction) {
+            return {
+                success: false,
+                checkedCount: 0,
+                error: {
+                    txHash: rootHash,
+                    exitCode: 'N/A',
+                    resultCode: 'N/A',
+                    reason: 'not_found',
+                    address: rootAddress.toString(),
+                },
+            };
+        }
+        const queue = [{ transaction: rootTransaction, depth: 0 }];
+        const processedTxHashes = new Set();
+        let checkedCount = 0;
+        for (let i = 0; i < queue.length; i++) {
+            const { transaction: tx, depth } = queue[i];
+            if (processedTxHashes.has(tx.hash)) {
+                continue;
+            }
+            processedTxHashes.add(tx.hash);
+            checkedCount += 1;
+            const validationError = this.validateIndexedTransactionWithResult(tx);
+            if (validationError) {
+                return { success: false, checkedCount, error: validationError };
+            }
+            if (depth >= maxDepth) {
+                continue;
+            }
+            const adjacentTransactions = await this.indexer.getAdjacentTransactions(tx.hash);
+            for (const adjacentTransaction of adjacentTransactions) {
+                if ((direction !== Struct_1.TransactionTreeDirection.BACKWARD &&
+                    tx.outMsgs.some((message) => message.hash && message.hash === adjacentTransaction.inMsg?.hash)) ||
+                    (direction !== Struct_1.TransactionTreeDirection.FORWARD &&
+                        adjacentTransaction.outMsgs.some((message) => message.hash && message.hash === tx.inMsg?.hash))) {
+                    queue.push({ transaction: adjacentTransaction, depth: depth + 1 });
+                }
+            }
+        }
+        return { success: true, checkedCount };
+    }
+    async findRootTransaction(address, hash) {
+        const tx = await this.indexer.getTransactionByHash(hash);
+        if (tx && ton_1.Address.parse(tx.account).equals(address)) {
+            return tx;
+        }
+        for (const direction of ['in', 'out']) {
+            const transactions = await this.indexer.getTransactionsByMessageHash(hash, direction);
+            const transaction = transactions.find((tx) => ton_1.Address.parse(tx.account).equals(address));
+            if (transaction) {
+                return transaction;
+            }
+        }
+        return null;
+    }
+    validateIndexedTransactionWithResult(tx) {
+        const { description } = tx;
+        if (description?.type && description.type !== 'generic') {
+            return null;
+        }
+        const computePh = description?.computePh;
+        const action = description?.action;
+        const exitCode = computePh && !computePh.skipped ? computePh.exitCode ?? 'N/A' : 'N/A';
+        const resultCode = action ? action.resultCode ?? 'N/A' : 'N/A';
+        let reason = null;
+        if (description?.aborted) {
+            reason = 'aborted';
+        }
+        else if (!computePh) {
+            reason = 'compute_phase_missing';
+        }
+        else if (!computePh.skipped && (computePh.success !== true || computePh.exitCode !== 0)) {
+            reason = 'compute_phase_failed';
+        }
+        else if (action && (action.success !== true || action.resultCode !== 0)) {
+            reason = 'action_phase_failed';
+        }
+        return reason ? { txHash: tx.hash, exitCode, resultCode, reason } : null;
+    }
+}
+exports.ToncenterV3Opener = ToncenterV3Opener;

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

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

package/dist/src/adapters/index.js

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

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,7 +53,7 @@ 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;
         }
         if (passLoggerToOpeners) {

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

@@ -7,7 +7,7 @@ export declare const createCrossChainLayerTvmMsgToEvmStep: (params: ContractFeeU
 export declare const createJettonWalletInternalTransferStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
 export declare const createJettonWalletReceiveStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
 export declare const createJettonWalletBurnStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
-export declare const createJettonProxyOwnershipAssignedStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
+export declare const createJettonProxyTransferNotificationStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
 export declare const createJettonMinterBurnNotificationStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
 export declare const createNftItemSendStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;
 export declare const createNftItemBurnStep: (params: ContractFeeUsageParams, msgBits: number, msgCells: number) => TransactionFeeCalculationStep;

package/dist/src/sdk/Fees.js

@@ -1,16 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNftItemErrorNotificationStep = exports.createNftProxyErrorNotificationStep = exports.createMintAfterErrorGasStep = exports.createEstimatedReceiveTransferGasStep = exports.createEstimatedSendTransferGasStep = exports.createErrorNotificationGasStep = exports.createNftProxyOwnershipAssignedStep = exports.createNftItemBurnStep = exports.createNftItemSendStep = exports.createJettonMinterBurnNotificationStep = exports.createJettonProxyOwnershipAssignedStep = exports.createJettonWalletBurnStep = exports.createJettonWalletReceiveStep = exports.createJettonWalletInternalTransferStep = exports.createCrossChainLayerTvmMsgToEvmStep = exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = void 0;
+exports.createNftItemErrorNotificationStep = exports.createNftProxyErrorNotificationStep = exports.createMintAfterErrorGasStep = exports.createEstimatedReceiveTransferGasStep = exports.createEstimatedSendTransferGasStep = exports.createErrorNotificationGasStep = exports.createNftProxyOwnershipAssignedStep = exports.createNftItemBurnStep = exports.createNftItemSendStep = exports.createJettonMinterBurnNotificationStep = exports.createJettonProxyTransferNotificationStep = exports.createJettonWalletBurnStep = exports.createJettonWalletReceiveStep = exports.createJettonWalletInternalTransferStep = exports.createCrossChainLayerTvmMsgToEvmStep = exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = void 0;
 const Consts_1 = require("./Consts");
 /**
  * Default contract fee usage parameters used as fallback.
  */
 exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = {
     crossChainLayer: {
-        accountBits: 43514,
-        accountCells: 100,
+        accountBits: 51611,
+        accountCells: 105,
         gas: {
-            tvmMsgToEvm: 14619,
+            tvmMsgToEvm: 15505,
         },
     },
     jettonWallet: {
@@ -32,7 +32,6 @@ exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = {
         accountBits: 7760,
         accountCells: 16,
         gas: {
-            ownershipAssigned: 8515,
             transferNotification: 8515,
             errorNotification: 5556,
         },
@@ -48,6 +47,8 @@ exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = {
     nftItem: {
         accountBits: 1422,
         accountCells: 5,
+        estimatedAccountBits: 9877,
+        estimatedAccountCells: 25,
         gas: {
             send: 11722,
             burn: 11552,
@@ -55,7 +56,7 @@ exports.DEFAULT_CONTRACT_FEE_USAGE_PARAMS = {
         },
     },
     nftProxy: {
-        accountBits: 7512,
+        accountBits: 7680,
         accountCells: 15,
         gas: {
             ownershipAssigned: 7688,
@@ -99,15 +100,15 @@ const createJettonWalletBurnStep = (params, msgBits, msgCells) => ({
     timeDelta: Consts_1.ONE_YEAR_SECONDS,
 });
 exports.createJettonWalletBurnStep = createJettonWalletBurnStep;
-const createJettonProxyOwnershipAssignedStep = (params, msgBits, msgCells) => ({
+const createJettonProxyTransferNotificationStep = (params, msgBits, msgCells) => ({
     accountBits: 0,
     accountCells: 0,
-    gasUsed: params.jettonProxy.gas.ownershipAssigned,
+    gasUsed: params.jettonProxy.gas.transferNotification,
     msgBits,
     msgCells,
     timeDelta: Consts_1.ONE_YEAR_SECONDS,
 });
-exports.createJettonProxyOwnershipAssignedStep = createJettonProxyOwnershipAssignedStep;
+exports.createJettonProxyTransferNotificationStep = createJettonProxyTransferNotificationStep;
 const createJettonMinterBurnNotificationStep = (params, msgBits, msgCells) => ({
     accountBits: params.jettonMinter.accountBits,
     accountCells: params.jettonMinter.accountCells,

package/dist/src/sdk/Simulator.js

@@ -123,7 +123,7 @@ class Simulator {
         return this.calculateTransactionPipeline([
             (0, Fees_1.createJettonWalletInternalTransferStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
             (0, Fees_1.createJettonWalletReceiveStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
-            (0, Fees_1.createJettonProxyOwnershipAssignedStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
+            (0, Fees_1.createJettonProxyTransferNotificationStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
             (0, Fees_1.createCrossChainLayerTvmMsgToEvmStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
             (0, Fees_1.createErrorNotificationGasStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
             (0, Fees_1.createEstimatedSendTransferGasStep)(this.config.TONParams.contractFeeUsageParams, msgBits, msgCells),
@@ -136,9 +136,7 @@ class Simulator {
         return dynamicFee > legacyNetworkFee ? dynamicFee : legacyNetworkFee;
     }
     calculateLegacyNftTransferNetworkFee(params, msgBits, msgCells) {
-        const forwardTonAmount = Consts_1.NFT_TRANSFER_FORWARD_TON_AMOUNT +
-            (params.forwardFeeTonAmount ?? 0n) +
-            (params.crossChainTonAmount ?? 0n);
+        const forwardTonAmount = Consts_1.NFT_TRANSFER_FORWARD_TON_AMOUNT + (params.forwardFeeTonAmount ?? 0n) + (params.crossChainTonAmount ?? 0n);
         const outboundMessageCount = forwardTonAmount > 0n
             ? Consts_1.LEGACY_NFT_TRANSFER_WITH_FORWARD_OUTBOUND_MESSAGE_COUNT
             : Consts_1.LEGACY_NFT_TRANSFER_BASE_OUTBOUND_MESSAGE_COUNT;

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

@@ -1,4 +1,4 @@
-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';
@@ -130,6 +130,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[];
 };
@@ -196,7 +203,6 @@ export type ContractFeeUsageParams = {
         accountBits: number;
         accountCells: number;
         gas: {
-            ownershipAssigned: number;
             transferNotification: number;
             errorNotification: number;
         };
@@ -212,6 +218,8 @@ export type ContractFeeUsageParams = {
     nftItem: {
         accountBits: number;
         accountCells: number;
+        estimatedAccountBits: number;
+        estimatedAccountCells: number;
         gas: {
             send: number;
             burn: number;

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-rc5",
+    "version": "0.7.3-rc7",
     "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",