@tonappchain/sdk 0.7.3-rc7 → 0.8.0-aa-alpha-test

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

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

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

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

package/dist/src/sdk/Artifacts.js

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

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

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

package/dist/src/sdk/Configuration.js

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

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

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

package/dist/src/sdk/Consts.js

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

package/dist/src/sdk/LiteSequencerClient.js

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

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

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

package/dist/src/sdk/OperationTracker.js

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

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

@@ -4,13 +4,27 @@ exports.startTracking = startTracking;
 exports.startTrackingMultiple = startTrackingMultiple;
 exports.printExecutionStagesTable = printExecutionStagesTable;
 const Struct_1 = require("../structs/Struct");
+const Artifacts_1 = require("./Artifacts");
+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 = (0, Artifacts_1.getArtifacts)(network);
+    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/TACTransactionManager.js

@@ -37,7 +37,7 @@ class TACTransactionManager {
             tvmExecutorFee = BigInt(suggestedFee.inTAC);
         }
         const protocolFee = await this.config.TACParams.crossChainLayer.getProtocolFee();
-        const shardsKey = BigInt(Math.round(Math.random() * Consts_1.SHARDS_KEY_RANDOM_RANGE));
+        const shardsKey = BigInt((0, Utils_1.generateRandomNumberByTimestamp)().randomNumber);
         this.logger.debug(`Shards key: ${shardsKey}, Protocol fee: ${protocolFee}`);
         const [toBridge, toBridgeNFT] = await Promise.all([
             Promise.all(assets
@@ -189,11 +189,11 @@ class TACTransactionManager {
         if (!shouldWaitForOperationId) {
             return { txHash: tx.hash };
         }
-        const waitOptions = options?.waitOptions ?? {};
-        waitOptions.successCheck = waitOptions.successCheck ?? ((id) => !!id);
-        waitOptions.logger = waitOptions.logger ?? this.logger;
+        const waitOperationIdOptions = options?.waitOperationIdOptions ?? {};
+        waitOperationIdOptions.successCheck = waitOperationIdOptions.successCheck ?? ((id) => !!id);
+        waitOperationIdOptions.logger = waitOperationIdOptions.logger ?? this.logger;
         const operationId = await this.operationTracker
-            .getOperationIdByTransactionHash(tx.hash, waitOptions)
+            .getOperationIdByTransactionHash(tx.hash, waitOperationIdOptions)
             .catch((error) => {
             this.logger.error(`Error while waiting for operation ID by transaction hash: ${error}`);
             return undefined;

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

@@ -188,18 +188,13 @@ class TONTransactionManager {
             await this.config.TONParams.contractOpener.trackTransactionTree(sender.getSenderAddress(), hash);
             this.logger.info(`Transaction tree successful`);
         }
-        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 waitOperationIdOptions = tx.options?.waitOperationIdOptions ?? {};
+        waitOperationIdOptions.successCheck = waitOperationIdOptions.successCheck ?? ((id) => !!id);
+        waitOperationIdOptions.logger = waitOperationIdOptions.logger ?? this.logger;
+        const operationId = await this.resolveOperationId(sendTransactionResult.boc, transactionLinker, waitOperationIdOptions);
         const shouldWaitForFinalization = tx.options?.waitFinalization ?? true;
         if (!shouldWaitForFinalization) {
-            return { sendTransactionResult, ...transactionLinker };
+            return { sendTransactionResult, operationId, ...transactionLinker };
         }
         if (!operationId) {
             throw errors_1.operationIdRequiredForFinalizationError;
@@ -224,6 +219,24 @@ class TONTransactionManager {
         await this.operationTracker.getStageProfiling(operationId, finalizationWaitOptions);
         return { sendTransactionResult, operationId, ...transactionLinker };
     }
+    async resolveOperationId(boc, transactionLinker, waitOperationIdOptions) {
+        if (this.config.TONParams.tonIndexer) {
+            const operationId = await this.operationTracker
+                .getOperationIdByTonTransactionBoc(boc, waitOperationIdOptions)
+                .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, waitOperationIdOptions).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}`);
@@ -238,7 +251,7 @@ class TONTransactionManager {
         }
         const shouldWaitForOperationIds = options?.waitOperationIds ?? true;
         return shouldWaitForOperationIds
-            ? await this.waitForOperationIds(transactionLinkers, caller, options?.waitOptions ?? {})
+            ? await this.waitForOperationIds(transactionLinkers, caller, options?.waitOperationIdOptions ?? {})
             : transactionLinkers;
     }
     async prepareBatchTransactions(txs, sender) {
@@ -260,15 +273,15 @@ class TONTransactionManager {
             transactionLinkers: results.map((r) => r.transactionLinker),
         };
     }
-    async waitForOperationIds(transactionLinkers, caller, waitOptions) {
+    async waitForOperationIds(transactionLinkers, caller, waitOperationIdOptions) {
         this.logger.debug(`Waiting for operation IDs`);
         try {
-            waitOptions.successCheck =
-                waitOptions.successCheck ??
+            waitOperationIdOptions.successCheck =
+                waitOperationIdOptions.successCheck ??
                     ((operationIds) => Object.keys(operationIds).length == transactionLinkers.length &&
                         Object.values(operationIds).every((ids) => ids.operationIds.length > 0));
-            waitOptions.logger = waitOptions.logger ?? this.logger;
-            const operationIds = await this.operationTracker.getOperationIdsByShardsKeys(transactionLinkers.map((linker) => linker.shardsKey), caller, waitOptions);
+            waitOperationIdOptions.logger = waitOperationIdOptions.logger ?? this.logger;
+            const operationIds = await this.operationTracker.getOperationIdsByShardsKeys(transactionLinkers.map((linker) => linker.shardsKey), caller, waitOperationIdOptions);
             this.logger.debug(`Operation IDs: ${(0, Utils_1.formatObjectForLogging)(operationIds)}`);
             return transactionLinkers.map((linker) => ({
                 ...linker,

package/dist/src/sdk/TacExplorerClient.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TacExplorerClient = void 0;
-const instances_1 = require("../errors/instances");
+const errors_1 = require("../errors");
 const AxiosHttpClient_1 = require("./AxiosHttpClient");
+const Consts_1 = require("./Consts");
 const Utils_1 = require("./Utils");
 class TacExplorerClient {
-    constructor(explorerApiEndpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient()) {
+    constructor(explorerApiEndpoint, httpClient = new AxiosHttpClient_1.AxiosHttpClient({ timeout: Consts_1.DEFAULT_HTTP_CLIENT_TIMEOUT_MS })) {
         this.explorerApiEndpoint = explorerApiEndpoint;
         this.httpClient = httpClient;
     }
@@ -15,7 +16,7 @@ class TacExplorerClient {
             return response.data;
         }
         catch (error) {
-            throw (0, instances_1.gasPriceFetchError)(`endpoint ${this.explorerApiEndpoint} failed to complete request`, error);
+            throw (0, errors_1.gasPriceFetchError)(`endpoint ${this.explorerApiEndpoint} failed to complete request`, error);
         }
     }
 }

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,12 +1,9 @@
 "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 Artifacts_1 = require("./Artifacts");
 const Configuration_1 = require("./Configuration");
 const Consts_1 = require("./Consts");
 const Logger_1 = require("./Logger");
@@ -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,34 +22,19 @@ 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;
         const delay = sdkParams.delay ?? Consts_1.DEFAULT_DELAY;
         const passLoggerToOpeners = sdkParams.passLoggerToOpeners ?? true;
-        let artifacts;
-        switch (network) {
-            case Struct_1.Network.MAINNET:
-                artifacts = artifacts_1.mainnet;
-                break;
-            case Struct_1.Network.TESTNET:
-                artifacts = artifacts_1.testnet;
-                break;
-            case Struct_1.Network.DEV:
-                artifacts = artifacts_1.dev;
-                break;
-            default:
-                throw new Error(`Unsupported network: ${network}`);
-        }
+        const artifacts = (0, Artifacts_1.getArtifacts)(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 +86,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 +191,5 @@ class TacSdk {
     getTonContractOpener() {
         return this.contactOpener;
     }
-    toSequencerTonTransactionHash(transaction) {
-        return `0x${(0, Utils_1.normalizeHashToHex)(transaction.hash)}`;
-    }
 }
 exports.TacSdk = TacSdk;