@tonappchain/sdk 0.7.2-alpha-11 → 0.7.2-alpha-14

package/dist/src/adapters/TonClient4Opener.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TonClient4Opener = void 0;
+exports.tonHubApi4Opener = tonHubApi4Opener;
+exports.tonClient4Opener = tonClient4Opener;
+exports.orbsOpener4 = orbsOpener4;
+const ton_1 = require("@ton/ton");
+const Consts_1 = require("../sdk/Consts");
+const Struct_1 = require("../structs/Struct");
+const BaseContractOpener_1 = require("./BaseContractOpener");
+const OpenerUtils_1 = require("./OpenerUtils");
+class TonClient4Opener extends BaseContractOpener_1.BaseContractOpener {
+    constructor(client4, logger) {
+        super(logger);
+        this.client4 = client4;
+    }
+    static create(endpoint, timeout = 10000, logger) {
+        const client4 = new ton_1.TonClient4({ endpoint, timeout });
+        return new TonClient4Opener(client4, logger);
+    }
+    open(contract) {
+        return this.client4.open(contract);
+    }
+    async getContractState(address) {
+        const latestBlock = await this.client4.getLastBlock();
+        const latestBlockNumber = latestBlock.last.seqno;
+        const state = await this.client4.getAccount(latestBlockNumber, address);
+        return {
+            balance: BigInt(state.account.balance.coins),
+            code: 'code' in state.account.state && state.account.state.code !== null
+                ? Buffer.from(state.account.state.code, 'base64')
+                : null,
+            state: state.account.state.type === 'uninit' ? 'uninitialized' : state.account.state.type,
+        };
+    }
+    async getTransactions(address, opts) {
+        const allTxs = await this.client4
+            .getAccountTransactions(address, opts.lt ? BigInt(opts.lt) : 0n, opts.hash ? Buffer.from(opts.hash, 'base64') : Buffer.alloc(0))
+            .then((res) => res.map((t) => t.tx));
+        // Apply limit if specified
+        let txs = opts.limit ? allTxs.slice(0, opts.limit) : allTxs;
+        // Apply to_lt filter if specified
+        if (opts.to_lt) {
+            const toLt = BigInt(opts.to_lt);
+            txs = txs.filter((tx) => {
+                const comparison = tx.lt > toLt;
+                return opts.inclusive ? tx.lt >= toLt : comparison;
+            });
+        }
+        return txs;
+    }
+    async getAddressInformation(addr) {
+        const latestBlock = await this.client4.getLastBlock();
+        const latestBlockNumber = latestBlock.last.seqno;
+        const state = await this.client4.getAccount(latestBlockNumber, addr);
+        return {
+            lastTransaction: {
+                lt: state.account.last?.lt ?? '',
+                hash: state.account.last?.hash ?? '',
+            },
+        };
+    }
+    async getConfig() {
+        const block = await this.client4.getLastBlock();
+        const { config } = await this.client4.getConfig(block.last.seqno);
+        return config.cell;
+    }
+}
+exports.TonClient4Opener = TonClient4Opener;
+/**
+ * Creates a TonClient4Opener instance using TonHub public API
+ * @param network Network to connect to (mainnet or testnet)
+ * @param timeout Request timeout in milliseconds
+ * @param logger
+ */
+function tonHubApi4Opener(network, timeout = Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS, logger) {
+    const endpoint = network === Struct_1.Network.MAINNET ? 'https://mainnet-v4.tonhubapi.com' : 'https://testnet-v4.tonhubapi.com';
+    return TonClient4Opener.create(endpoint, timeout, logger);
+}
+function tonClient4Opener(client, logger) {
+    return new TonClient4Opener(client, logger);
+}
+async function orbsOpener4(network, timeout = Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS, logger) {
+    const endpoint = await (0, OpenerUtils_1.getHttpV4EndpointWithRetry)(network);
+    const client = new ton_1.TonClient4({ endpoint, timeout });
+    return new TonClient4Opener(client, logger);
+}

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

@@ -0,0 +1,17 @@
+import { Address, Contract, OpenedContract, TonClient, Transaction } from '@ton/ton';
+import { ILogger } from '../interfaces';
+import { AddressInformation, ContractState, GetTransactionsOptions, Network } from '../structs/Struct';
+import { BaseContractOpener } from './BaseContractOpener';
+export declare class TonClientOpener extends BaseContractOpener {
+    private readonly client;
+    private readonly httpClient;
+    constructor(client: TonClient, logger?: ILogger);
+    static create(endpoint: string, timeout?: number, logger?: ILogger): TonClientOpener;
+    open<T extends Contract>(contract: T): OpenedContract<T>;
+    getContractState(address: Address): Promise<ContractState>;
+    getTransactions(address: Address, opts: GetTransactionsOptions): Promise<Transaction[]>;
+    getAddressInformation(addr: Address): Promise<AddressInformation>;
+    getConfig(): Promise<string>;
+}
+export declare function tonClientOpener(client: TonClient, logger?: ILogger): TonClientOpener;
+export declare function orbsOpener(network: Network, logger?: ILogger): Promise<TonClientOpener>;

package/dist/src/adapters/TonClientOpener.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TonClientOpener = void 0;
+exports.tonClientOpener = tonClientOpener;
+exports.orbsOpener = orbsOpener;
+const ton_1 = require("@ton/ton");
+const AxiosHttpClient_1 = require("../sdk/AxiosHttpClient");
+const Consts_1 = require("../sdk/Consts");
+const Utils_1 = require("../sdk/Utils");
+const BaseContractOpener_1 = require("./BaseContractOpener");
+const OpenerUtils_1 = require("./OpenerUtils");
+class TonClientOpener extends BaseContractOpener_1.BaseContractOpener {
+    constructor(client, logger) {
+        super(logger);
+        this.client = client;
+        this.httpClient = new AxiosHttpClient_1.AxiosHttpClient({ timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS });
+    }
+    static create(endpoint, timeout = Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS, logger) {
+        const client = new ton_1.TonClient({ endpoint, timeout });
+        return new TonClientOpener(client, logger);
+    }
+    open(contract) {
+        return this.client.open(contract);
+    }
+    async getContractState(address) {
+        return this.client.getContractState(address);
+    }
+    async getTransactions(address, opts) {
+        // TonClient doesn't accept timeoutMs and retryDelayMs, filter them out
+        const clientOpts = {
+            limit: opts.limit ?? Consts_1.DEFAULT_FIND_TX_LIMIT,
+            lt: opts.lt,
+            // TonClient API expects base64 transaction hash and converts it to hex internally.
+            hash: opts.hash ? (0, Utils_1.normalizeHashToBase64)(opts.hash) : undefined,
+            to_lt: opts.to_lt,
+            inclusive: opts.inclusive,
+            archival: opts.archival,
+        };
+        return this.client.getTransactions(address, clientOpts);
+    }
+    async getAddressInformation(addr) {
+        const state = await this.client.getContractState(addr);
+        return {
+            lastTransaction: {
+                lt: state.lastTransaction?.lt ?? '',
+                hash: state.lastTransaction?.hash ?? '',
+            },
+        };
+    }
+    async getConfig() {
+        const info = await this.client.getMasterchainInfo();
+        const url = new URL('getConfigAll', this.client.parameters.endpoint);
+        url.searchParams.append('seqno', info.latestSeqno.toString());
+        // Use longer timeout for getConfig as the response is very large (~100KB+)
+        // and Brotli decompression can take significant time
+        const response = await this.httpClient.get(url.toString(), { timeout: 60000 });
+        const body = response.data;
+        if (!body?.ok || !body.result?.config?.bytes) {
+            throw new Error(`Failed to fetch config: ${JSON.stringify(body)}`);
+        }
+        return body.result.config.bytes;
+    }
+}
+exports.TonClientOpener = TonClientOpener;
+function tonClientOpener(client, logger) {
+    return new TonClientOpener(client, logger);
+}
+async function orbsOpener(network, logger) {
+    const endpoint = await (0, OpenerUtils_1.getHttpEndpointWithRetry)(network);
+    const client = new ton_1.TonClient({ endpoint, timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS });
+    return new TonClientOpener(client, logger);
+}

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

@@ -1,2 +1,7 @@
-export * from './contractOpener';
-export * from './retryableContractOpener';
+export * from './BaseContractOpener';
+export * from './LiteClientOpener';
+export * from './OpenerUtils';
+export * from './RetryableContractOpener';
+export * from './SandboxOpener';
+export * from './TonClient4Opener';
+export * from './TonClientOpener';

package/dist/src/adapters/index.js

@@ -14,5 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./contractOpener"), exports);
-__exportStar(require("./retryableContractOpener"), exports);
+__exportStar(require("./BaseContractOpener"), exports);
+__exportStar(require("./LiteClientOpener"), exports);
+__exportStar(require("./OpenerUtils"), exports);
+__exportStar(require("./RetryableContractOpener"), exports);
+__exportStar(require("./SandboxOpener"), exports);
+__exportStar(require("./TonClient4Opener"), exports);
+__exportStar(require("./TonClientOpener"), exports);

package/dist/src/index.d.ts

@@ -15,7 +15,7 @@ export { TacExplorerClient } from './sdk/TacExplorerClient';
 export { TacSdk } from './sdk/TacSdk';
 export { TACTransactionManager } from './sdk/TACTransactionManager';
 export { TONTransactionManager } from './sdk/TONTransactionManager';
-export * from './sdk/TxFinalizer';
+export { TonTxFinalizer } from './sdk/TxFinalizer';
 export * from './sender';
 export * from './structs/Struct';
 export * from './wrappers/ContentUtils';

package/dist/src/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.TacExplorerClient = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
+exports.TonTxFinalizer = exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.TacExplorerClient = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
 __exportStar(require("./adapters"), exports);
 var AgnosticSdk_1 = require("./agnosticSdk/AgnosticSdk");
 Object.defineProperty(exports, "AgnosticProxySDK", { enumerable: true, get: function () { return AgnosticSdk_1.AgnosticProxySDK; } });
@@ -66,7 +66,8 @@ var TACTransactionManager_1 = require("./sdk/TACTransactionManager");
 Object.defineProperty(exports, "TACTransactionManager", { enumerable: true, get: function () { return TACTransactionManager_1.TACTransactionManager; } });
 var TONTransactionManager_1 = require("./sdk/TONTransactionManager");
 Object.defineProperty(exports, "TONTransactionManager", { enumerable: true, get: function () { return TONTransactionManager_1.TONTransactionManager; } });
-__exportStar(require("./sdk/TxFinalizer"), exports);
+var TxFinalizer_1 = require("./sdk/TxFinalizer");
+Object.defineProperty(exports, "TonTxFinalizer", { enumerable: true, get: function () { return TxFinalizer_1.TonTxFinalizer; } });
 __exportStar(require("./sender"), exports);
 __exportStar(require("./structs/Struct"), exports);
 __exportStar(require("./wrappers/ContentUtils"), exports);

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

@@ -1,7 +1,7 @@
 import { SandboxContract } from '@ton/sandbox';
 import type { Address, Contract, OpenedContract, Transaction } from '@ton/ton';
-import { AddressInformation, GetTransactionsOptions } from '../structs/InternalStruct';
-import { ContractState } from '../structs/Struct';
+import { AddressInformation, ContractState, GetTransactionsOptions, TrackTransactionTreeParams, TrackTransactionTreeResult } from '../structs/Struct';
+import { ILogger } from './ILogger';
 export interface ContractOpener {
     /**
      * Opens a contract for interaction using the underlying client (lite client, sandbox, etc.).
@@ -19,8 +19,77 @@ export interface ContractOpener {
      * Closes any underlying connections if supported by the implementation.
      */
     closeConnections?: () => unknown;
+    /**
+     * Fetches transactions for a given address.
+     * @param address Address to fetch transactions for.
+     * @param opts Options for fetching transactions (limit, archival, etc.).
+     * @returns Promise with array of transactions.
+     */
+    getTransactions(address: Address, opts: GetTransactionsOptions): Promise<Transaction[]>;
+    /**
+     * Find transaction by its hash.
+     * Searches by transaction hash, and also by incoming message hash (both external-in and internal).
+     * This is a universal method that checks all possible hash types.
+     * @param address Account address where to search
+     * @param hash Transaction or message hash in any format (base64, hex)
+     * @param opts Search options (limit, pagination, etc.)
+     * @returns Transaction if found, null otherwise
+     */
     getTransactionByHash(address: Address, hash: string, opts?: GetTransactionsOptions): Promise<Transaction | null>;
+    /**
+     * Find transaction by its transaction hash only.
+     * More efficient than getTransactionByHash if you know it's a transaction hash.
+     * @param address Account address where to search
+     * @param txHash Transaction hash in any format (base64, hex)
+     * @param opts Search options
+     * @returns Transaction if found, null otherwise
+     */
+    getTransactionByTxHash(address: Address, txHash: string, opts?: GetTransactionsOptions): Promise<Transaction | null>;
+    /**
+     * Find transaction by its incoming message hash.
+     * Useful for finding the transaction that processed a specific message.
+     * @param address Account address where to search
+     * @param msgHash Message hash in any format (base64, hex)
+     * @param opts Search options
+     * @returns Transaction if found, null otherwise
+     */
+    getTransactionByInMsgHash(address: Address, msgHash: string, opts?: GetTransactionsOptions): Promise<Transaction | null>;
+    /**
+     * Find transaction by its outgoing message hash.
+     * Useful for finding the parent transaction that sent a specific message.
+     * @param address Account address where to search
+     * @param msgHash Outgoing message hash in any format (base64, hex)
+     * @param opts Search options
+     * @returns Transaction if found, null otherwise
+     */
+    getTransactionByOutMsgHash(address: Address, msgHash: string, opts?: GetTransactionsOptions): Promise<Transaction | null>;
+    /**
+     * Get adjacent transactions (children via outgoing messages and parent via incoming message).
+     * @param address Account address
+     * @param hash Transaction or message hash in any format (base64, hex)
+     * @param opts Search options
+     * @returns Array of adjacent transactions
+     */
     getAdjacentTransactions(address: Address, hash: string, opts?: GetTransactionsOptions): Promise<Transaction[]>;
     getAddressInformation(address: Address): Promise<AddressInformation>;
     getConfig(): Promise<string>;
+    /**
+     * Track and validate entire transaction tree starting from a root transaction.
+     * Recursively follows outgoing messages and validates all child transactions.
+     * @param address Root account address
+     * @param hash Root transaction or message hash
+     * @param params Tracking parameters (maxDepth, ignoreOpcodeList, etc.)
+     * @throws Error if any transaction in the tree failed or if a hash is not found
+     */
+    trackTransactionTree(address: string, hash: string, params?: TrackTransactionTreeParams): Promise<void>;
+    /**
+     * Track and validate entire transaction tree starting from a root transaction (returns result instead of throwing).
+     * Recursively follows outgoing messages and validates all child transactions.
+     * @param address Root account address
+     * @param hash Root transaction or message hash
+     * @param params Tracking parameters (maxDepth, ignoreOpcodeList, etc.)
+     * @returns Result object with success flag and error details if validation failed or a hash was not found
+     */
+    trackTransactionTreeWithResult(address: string, hash: string, params?: TrackTransactionTreeParams): Promise<TrackTransactionTreeResult>;
+    setLogger(logger: ILogger): void;
 }

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

@@ -2,8 +2,9 @@ import { Wallet } from 'ethers';
 import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT } from '../assets';
 import type { SenderAbstraction } from '../sender';
-import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
+import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
 import { Asset } from './Asset';
+import { ContractOpener } from './ContractOpener';
 import { IConfiguration } from './IConfiguration';
 import { IOperationTracker } from './IOperationTracker';
 import { ITacExplorerClient } from './ITacExplorerClient';
@@ -187,6 +188,10 @@ export interface ITacSDK {
      * Returns the TAC explorer client instance used for querying blockchain explorer data.
      */
     getTacExplorerClient(): ITacExplorerClient;
+    /**
+     * Returns the TON contract opener client instance used for querying TON blockchain data.
+     */
+    getTonContractOpener(): ContractOpener;
     /**
      * Prepares the transaction payloads required for a cross-chain operation without sending them.
      * @param evmProxyMsg Encoded EVM proxy message.
@@ -196,4 +201,9 @@ export interface ITacSDK {
      * @returns Promise with the prepared transaction payloads.
      */
     prepareCrossChainTransactionPayload(evmProxyMsg: EvmProxyMsg, senderAddress: string, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<CrossChainPayloadResult[]>;
+    /**
+     * Returns TAC gas price for the current network.
+     * @returns Promise resolving to the gas price in wei (bigint).
+     */
+    getTACGasPrice(): Promise<TacGasPrice>;
 }

package/dist/src/sdk/Configuration.js

@@ -52,9 +52,10 @@ class Configuration {
         else {
             contractOpener =
                 TONParams?.contractOpener ??
-                    (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, 5, delay));
+                    (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, 5, delay, logger));
             settingsAddress = TONParams?.settingsAddress ?? artifacts.TON_SETTINGS_ADDRESS;
         }
+        contractOpener.setLogger(logger);
         const settings = contractOpener.open(artifacts.ton.wrappers.Settings.createFromAddress(ton_1.Address.parse(settingsAddress)));
         const allSettingsSlice = (await settings.getAll()).beginParse();
         const allSettings = allSettingsSlice.loadDictDirect(ton_1.Dictionary.Keys.BigUint(256), ton_1.Dictionary.Values.Cell());

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

@@ -14,10 +14,17 @@ export declare const ONE_YEAR_SECONDS: number;
 export declare const TON_DECIMALS = 9;
 export declare const TAC_DECIMALS = 18;
 export declare const FIVE_MINUTES: number;
+export declare const MINUTE: number;
 export declare const TON_BURN_ADDRESS = "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
-export declare const DEFAULT_FIND_TX_TIMEOUT_MS = 60000;
-export declare const DEFAULT_FIND_TX_RETRY_DELAY_MS = 2000;
-export declare const DEFAULT_FIND_TX_LIMIT = 10;
+export declare const DEFAULT_HTTP_CLIENT_TIMEOUT_MS = 30000;
+export declare const DEFAULT_RETRY_MAX_COUNT = 5;
+export declare const DEFAULT_RETRY_DELAY_MS = 1000;
+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_WAIT_FOR_ROOT_TRANSACTION = true;
+export declare const DEFAULT_WAIT_FOR_ROOT_TRANSACTION_TIMEOUT_MS: number;
+export declare const DEFAULT_WAIT_FOR_ROOT_TRANSACTION_RETRY_DELAY_MS = 1000;
 export declare const IGNORE_MSG_VALUE_1_NANO = 1n;
+export declare const IGNORE_OPCODE: number[];

package/dist/src/sdk/Consts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IGNORE_MSG_VALUE_1_NANO = exports.DEFAULT_FIND_TX_MAX_DEPTH = exports.DEFAULT_FIND_TX_ARCHIVAL = exports.DEFAULT_FIND_TX_LIMIT = exports.DEFAULT_FIND_TX_RETRY_DELAY_MS = exports.DEFAULT_FIND_TX_TIMEOUT_MS = exports.TON_BURN_ADDRESS = 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.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = void 0;
+exports.IGNORE_OPCODE = exports.IGNORE_MSG_VALUE_1_NANO = exports.DEFAULT_WAIT_FOR_ROOT_TRANSACTION_RETRY_DELAY_MS = exports.DEFAULT_WAIT_FOR_ROOT_TRANSACTION_TIMEOUT_MS = exports.DEFAULT_WAIT_FOR_ROOT_TRANSACTION = exports.DEFAULT_FIND_TX_MAX_DEPTH = exports.DEFAULT_FIND_TX_ARCHIVAL = exports.DEFAULT_MAX_SCANNED_TRANSACTIONS = exports.DEFAULT_FIND_TX_LIMIT = 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.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = 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);
@@ -18,11 +18,19 @@ exports.ONE_YEAR_SECONDS = 365 * 24 * 3600;
 exports.TON_DECIMALS = 9;
 exports.TAC_DECIMALS = 18;
 exports.FIVE_MINUTES = 5 * 60 * 1000;
+exports.MINUTE = 60 * 1000;
 exports.TON_BURN_ADDRESS = 'EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c';
-// TX TRACKING
-exports.DEFAULT_FIND_TX_TIMEOUT_MS = 60000;
-exports.DEFAULT_FIND_TX_RETRY_DELAY_MS = 2000;
-exports.DEFAULT_FIND_TX_LIMIT = 10;
+exports.DEFAULT_HTTP_CLIENT_TIMEOUT_MS = 30000;
+exports.DEFAULT_RETRY_MAX_COUNT = 5;
+exports.DEFAULT_RETRY_DELAY_MS = 1000;
+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_WAIT_FOR_ROOT_TRANSACTION = true;
+exports.DEFAULT_WAIT_FOR_ROOT_TRANSACTION_TIMEOUT_MS = exports.MINUTE;
+exports.DEFAULT_WAIT_FOR_ROOT_TRANSACTION_RETRY_DELAY_MS = 1000;
 exports.IGNORE_MSG_VALUE_1_NANO = 1n;
+exports.IGNORE_OPCODE = [
+    0xd53276db, // Excess
+];

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

@@ -1,4 +1,4 @@
-import { ILogger } from '../interfaces';
+import { ContractOpener, ILogger } from '../interfaces';
 import { ITxFinalizer } from '../interfaces/ITxFinalizer';
 import { ExecutionStages, Network, TransactionLinker } from '../structs/Struct';
 export declare function startTracking(transactionLinker: TransactionLinker, network: Network, options?: {
@@ -9,6 +9,7 @@ export declare function startTracking(transactionLinker: TransactionLinker, netw
     tableView?: boolean;
     logger?: ILogger;
     txFinalizer?: ITxFinalizer;
+    contractOpener?: ContractOpener;
     cclAddress?: string;
 }): Promise<void | ExecutionStages>;
 export declare function startTrackingMultiple(transactionLinkers: TransactionLinker[], network: Network, options?: {
@@ -19,5 +20,7 @@ export declare function startTrackingMultiple(transactionLinkers: TransactionLin
     tableView?: boolean;
     logger?: ILogger;
     txFinalizer?: ITxFinalizer;
+    contractOpener?: ContractOpener;
+    cclAddress?: string;
 }): Promise<void | ExecutionStages[]>;
 export declare function printExecutionStagesTable(stages: ExecutionStages, logger: ILogger): void;

package/dist/src/sdk/StartTracking.js

@@ -9,7 +9,7 @@ const Logger_1 = require("./Logger");
 const OperationTracker_1 = require("./OperationTracker");
 const Utils_1 = require("./Utils");
 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, cclAddress, } = 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);
     logger.debug(`Start tracking operation\n` +
         `caller: ${transactionLinker.caller}\n` +
@@ -63,15 +63,18 @@ async function startTracking(transactionLinker, network, options) {
         logger.debug(errorMessage);
     }
     const profilingData = await tracker.getStageProfiling(operationId);
-    // Check if EXECUTED_IN_TON stage exists and use TxFinalizer to verify transaction success
+    // Check if EXECUTED_IN_TON stage exists and use ContractOpener to verify transaction success
     if (profilingData.executedInTON.exists && profilingData.executedInTON.stageData?.transactions) {
         logger.debug('EXECUTED_IN_TON stage found, verifying transaction success in TON...');
-        if (txFinalizer && cclAddress) {
+        const finalizer = txFinalizer || contractOpener;
+        if (finalizer && cclAddress) {
             const transactions = profilingData.executedInTON.stageData.transactions;
             for (const tx of transactions) {
                 try {
                     logger.debug(`Verifying transaction: ${tx.hash}`);
-                    await txFinalizer.trackTransactionTree(cclAddress, tx.hash, { maxDepth: Consts_1.DEFAULT_FIND_TX_MAX_DEPTH });
+                    await finalizer.trackTransactionTree(cclAddress, tx.hash, {
+                        maxDepth: Consts_1.DEFAULT_FIND_TX_MAX_DEPTH,
+                    });
                     logger.debug(`Transaction ${tx.hash} verified successfully in TON`);
                 }
                 catch (error) {
@@ -83,7 +86,7 @@ async function startTracking(transactionLinker, network, options) {
             }
         }
         else {
-            logger.debug('TxFinalizer or CCL address is not provided, skipping TON transaction verification');
+            logger.debug('Finalizer, ContractOpener or CCL address is not provided, skipping TON transaction verification');
         }
     }
     if (returnValue) {
@@ -99,7 +102,7 @@ async function startTracking(transactionLinker, network, options) {
     }
 }
 async function startTrackingMultiple(transactionLinkers, network, options) {
-    const { customLiteSequencerEndpoints, delay = 10, maxIterationCount = Consts_1.MAX_ITERATION_COUNT, returnValue = false, tableView = true, txFinalizer, logger = new Logger_1.NoopLogger(), } = 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`);
     const results = await Promise.all(transactionLinkers.map((linker, index) => {
         logger.debug(`\nProcessing operation ${index + 1}/${transactionLinkers.length}`);
@@ -110,6 +113,8 @@ async function startTrackingMultiple(transactionLinkers, network, options) {
             returnValue: true,
             tableView: false,
             txFinalizer,
+            contractOpener,
+            cclAddress,
             logger,
         });
     }));

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

@@ -1,5 +1,4 @@
 import { Asset, IConfiguration, ILogger, IOperationTracker, ISimulator, ITONTransactionManager } from '../interfaces';
-import { ITxFinalizer } from '../interfaces/ITxFinalizer';
 import { type SenderAbstraction } from '../sender';
 import { BatchCrossChainTx, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EvmProxyMsg, FeeParams, TransactionLinkerWithOperationId } from '../structs/Struct';
 export declare class TONTransactionManager implements ITONTransactionManager {
@@ -7,8 +6,7 @@ export declare class TONTransactionManager implements ITONTransactionManager {
     private readonly simulator;
     private readonly operationTracker;
     private readonly logger;
-    private readonly txFinalizer;
-    constructor(config: IConfiguration, simulator: ISimulator, operationTracker: IOperationTracker, logger: ILogger | undefined, txFinalizer: ITxFinalizer);
+    constructor(config: IConfiguration, simulator: ISimulator, operationTracker: IOperationTracker, logger?: ILogger);
     buildFeeParams(options: CrossChainTransactionOptions, evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx): Promise<FeeParams>;
     private prepareCrossChainTransaction;
     private generateCrossChainMessages;

package/dist/src/sdk/TONTransactionManager.js

@@ -11,12 +11,11 @@ const Logger_1 = require("./Logger");
 const Utils_1 = require("./Utils");
 const Validator_1 = require("./Validator");
 class TONTransactionManager {
-    constructor(config, simulator, operationTracker, logger = new Logger_1.NoopLogger(), txFinalizer) {
+    constructor(config, simulator, operationTracker, logger = new Logger_1.NoopLogger()) {
         this.config = config;
         this.simulator = simulator;
         this.operationTracker = operationTracker;
         this.logger = logger;
-        this.txFinalizer = txFinalizer;
     }
     async buildFeeParams(options, evmProxyMsg, sender, tx) {
         const { withoutSimulation, protocolFee, evmExecutorFee, tvmExecutorFee, isRoundTrip } = options;
@@ -160,12 +159,12 @@ class TONTransactionManager {
     async sendCrossChainTransaction(evmProxyMsg, sender, tx) {
         const { transaction, transactionLinker } = await this.prepareCrossChainTransaction(evmProxyMsg, sender, tx.assets, tx.options);
         await assets_1.TON.checkBalance(sender, this.config, [transaction]);
+        const shouldWaitForOperationId = tx.options?.waitOperationId ?? true;
         this.logger.debug(`Sending transaction: ${(0, Utils_1.formatObjectForLogging)(transactionLinker)}`);
         const sendTransactionResult = await sender.sendShardTransaction(transaction, this.config.network, this.config.TONParams.contractOpener);
         if (!sendTransactionResult.success || sendTransactionResult.error) {
             throw (0, instances_1.sendCrossChainTransactionFailedError)(sendTransactionResult.error?.message ?? 'Transaction failed to send');
         }
-        const shouldWaitForOperationId = tx.options?.waitOperationId ?? true;
         if (!shouldWaitForOperationId) {
             return { sendTransactionResult, ...transactionLinker };
         }
@@ -175,7 +174,7 @@ class TONTransactionManager {
         if (waitOptions.ensureTxExecuted && sendTransactionResult.boc) {
             const hash = (0, Utils_1.getNormalizedExtMessageHash)((0, ton_1.loadMessage)(ton_1.Cell.fromBase64(sendTransactionResult.boc).beginParse()));
             this.logger.info(`Tracking transaction tree for hash: ${hash}`);
-            await this.txFinalizer.trackTransactionTree(sender.getSenderAddress(), hash, {
+            await this.config.TONParams.contractOpener.trackTransactionTree(sender.getSenderAddress(), hash, {
                 maxDepth: Consts_1.DEFAULT_FIND_TX_MAX_DEPTH,
             });
             this.logger.info(`Transaction tree successful`);

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

@@ -1,11 +1,12 @@
 import { Wallet } from 'ethers';
 import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT } from '../assets';
-import { IConfiguration, ILogger, IOperationTracker, ITacExplorerClient, ITacSDK } from '../interfaces';
+import { ContractOpener, IConfiguration, ILogger, IOperationTracker, ITacExplorerClient, ITacSDK } from '../interfaces';
 import type { SenderAbstraction } from '../sender';
 import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SDKParams, SuggestedTVMExecutorFee, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 export declare class TacSdk implements ITacSDK {
     readonly config: IConfiguration;
+    readonly contactOpener: ContractOpener;
     readonly operationTracker: IOperationTracker;
     readonly explorerClient: ITacExplorerClient;
     private readonly simulator;
@@ -45,4 +46,5 @@ export declare class TacSdk implements ITacSDK {
     getTacExplorerClient(): ITacExplorerClient;
     prepareCrossChainTransactionPayload(evmProxyMsg: EvmProxyMsg, senderAddress: string, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<CrossChainPayloadResult[]>;
     getTACGasPrice(): Promise<TacGasPrice>;
+    getTonContractOpener(): ContractOpener;
 }

package/dist/src/sdk/TacSdk.js

@@ -12,11 +12,11 @@ const Simulator_1 = require("./Simulator");
 const TacExplorerClient_1 = require("./TacExplorerClient");
 const TACTransactionManager_1 = require("./TACTransactionManager");
 const TONTransactionManager_1 = require("./TONTransactionManager");
-const TxFinalizer_1 = require("./TxFinalizer");
 const Utils_1 = require("./Utils");
 class TacSdk {
     constructor(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient) {
         this.config = config;
+        this.contactOpener = config.TONParams.contractOpener;
         this.simulator = simulator;
         this.tonTransactionManager = tonTransactionManager;
         this.tacTransactionManager = tacTransactionManager;
@@ -44,8 +44,7 @@ class TacSdk {
         const operationTracker = new OperationTracker_1.OperationTracker(network, config.liteSequencerEndpoints);
         const explorerClient = new TacExplorerClient_1.TacExplorerClient(artifacts.TAC_EXPLORER_API_ENDPOINT);
         const simulator = new Simulator_1.Simulator(config, operationTracker, logger);
-        const txFinalizer = sdkParams.TONParams?.txFinalizer ?? new TxFinalizer_1.TonTxFinalizer(config.TONParams.contractOpener, logger);
-        const tonTransactionManager = new TONTransactionManager_1.TONTransactionManager(config, simulator, operationTracker, logger, txFinalizer);
+        const tonTransactionManager = new TONTransactionManager_1.TONTransactionManager(config, simulator, operationTracker, logger);
         const tacTransactionManager = new TACTransactionManager_1.TACTransactionManager(config, operationTracker, logger);
         return new TacSdk(config, simulator, tonTransactionManager, tacTransactionManager, operationTracker, explorerClient);
     }
@@ -197,5 +196,8 @@ class TacSdk {
             slow: response.gasPrices.slow,
         };
     }
+    getTonContractOpener() {
+        return this.contactOpener;
+    }
 }
 exports.TacSdk = TacSdk;

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

@@ -1,15 +1,8 @@
-import { ContractOpener, IHttpClient, ILogger } from '../interfaces';
+import { IHttpClient, ILogger } from '../interfaces';
 import { ITxFinalizer } from '../interfaces/ITxFinalizer';
 import { TxFinalizerConfig } from '../structs/InternalStruct';
 import { TrackTransactionTreeParams } from '../structs/Struct';
 export declare class TonTxFinalizer implements ITxFinalizer {
-    private logger;
-    private contractOpener;
-    constructor(contractOpener: ContractOpener, logger?: ILogger);
-    private fetchAdjacentTransactions;
-    trackTransactionTree(address: string, hash: string, params?: TrackTransactionTreeParams): Promise<void>;
-}
-export declare class TonIndexerTxFinalizer implements ITxFinalizer {
     private logger;
     private apiConfig;
     private readonly httpClient;