npm - @tonappchain/sdk - Versions diffs - 0.7.2-scaled-ui-support-2 → 0.7.2 - Mend

@tonappchain/sdk 0.7.2-scaled-ui-support-2 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (171) hide show

package/dist/src/errors/instances.js CHANGED Viewed

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
+exports.insufficientFeeParamsError = exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
 const errors_1 = require("./errors");
 exports.emptyContractError = new errors_1.ContractError('unexpected empty contract code of given jetton.', 100);
 const operationFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch OperationId: ${msg}`, 101, inner);
@@ -30,7 +30,64 @@ exports.invalidAssetType = new errors_1.FormatError('Invalid asset type', 114);
 const prepareMessageGroupError = (isBocSizeValid, isDepthValid) => new errors_1.PrepareMessageGroupError(`Failed to prepare message group: BOC size valid: ${isBocSizeValid}, depth valid: ${isDepthValid}`, 115);
 exports.prepareMessageGroupError = prepareMessageGroupError;
 exports.noValidGroupFoundError = new errors_1.NoValidGroupFoundError('Failed to prepare valid message group', 116);
-const allEndpointsFailedError = (inner) => new errors_1.FetchError('All endpoints failed, last err: ' + inner.message, 117, inner);
+function extractEndpoint(message) {
+    const match = message.match(/https?:\/\/\S+/i);
+    if (!match) {
+        return undefined;
+    }
+    return match[0].replace(/[),.;]+$/, '');
+}
+function extractResponseMessage(data, includeFullTrace) {
+    if (typeof data === 'string' && data.length > 0) {
+        const isHtml = data.includes('<!doctype html>') || data.includes('<html');
+        if (isHtml && !includeFullTrace) {
+            return '[HTML response]';
+        }
+        return data;
+    }
+    if (!data || typeof data !== 'object') {
+        return undefined;
+    }
+    const payload = data;
+    if (typeof payload.message === 'string' && payload.message.length > 0) {
+        return payload.message;
+    }
+    if (typeof payload.error === 'string' && payload.error.length > 0) {
+        return payload.error;
+    }
+    return undefined;
+}
+function buildInnerErrorSummary(inner, includeFullTrace) {
+    if (inner && typeof inner === 'object') {
+        const err = inner;
+        const parts = [];
+        const responseMessage = extractResponseMessage(err.response?.data, includeFullTrace);
+        const httpStatus = [err.httpStatus, err.status, err.response?.status].find((value) => typeof value === 'number');
+        const httpMessage = typeof err.innerMessage === 'string' && err.innerMessage.length > 0 ? err.innerMessage : responseMessage;
+        if (typeof httpStatus === 'number') {
+            parts.push(`httpStatus=${httpStatus}`);
+        }
+        if (typeof httpMessage === 'string' && httpMessage.length > 0) {
+            parts.push(`httpMessage=${httpMessage}`);
+        }
+        if (typeof err.message === 'string' && err.message.length > 0) {
+            const endpoint = extractEndpoint(err.message);
+            if (endpoint) {
+                parts.push(`endpoint=${endpoint}`);
+            }
+        }
+        if (parts.length > 0) {
+            return parts.join(', ');
+        }
+    }
+    if (typeof inner === 'string' && inner.length > 0) {
+        return `message=${inner}`;
+    }
+    return 'message=unknown error';
+}
+const allEndpointsFailedError = (inner, includeInnerStack = false) => new errors_1.FetchError(`All endpoints failed, last err: ${buildInnerErrorSummary(inner, includeInnerStack)}`, 117, inner, {
+    includeInnerStack,
+});
 exports.allEndpointsFailedError = allEndpointsFailedError;
 const allContractOpenerFailedError = (inner) => new errors_1.FetchError('All contract opener failed', 118, inner);
 exports.allContractOpenerFailedError = allContractOpenerFailedError;
@@ -56,3 +113,11 @@ exports.zeroRawAmountError = zeroRawAmountError;
 const sendCrossChainTransactionFailedError = (msg) => new errors_1.WalletError(`failed to send cross chain transaction: ${msg}`, 131);
 exports.sendCrossChainTransactionFailedError = sendCrossChainTransactionFailedError;
 exports.convertCurrencyNegativeOrZeroValueError = new errors_1.FormatError('Value cannot be negative or zero for currency conversion', 132);
+const unknownAssetOriginError = (origin) => new errors_1.TokenError(`Unknown asset origin: ${origin}`, 133);
+exports.unknownAssetOriginError = unknownAssetOriginError;
+const gasPriceFetchError = (msg, inner) => new errors_1.FetchError(`Failed to fetch gas price: ${msg}`, 134, inner);
+exports.gasPriceFetchError = gasPriceFetchError;
+const txFinalizationError = (msg) => new errors_1.TransactionError(`Transaction failed: ${msg}`, 135);
+exports.txFinalizationError = txFinalizationError;
+const insufficientFeeParamsError = (feeName, provided, required) => new errors_1.FormatError(`Provided ${feeName} (${provided}) is lower than required (${required}). Set shouldValidateFees: false to bypass.`, 136);
+exports.insufficientFeeParamsError = insufficientFeeParamsError;

package/dist/src/index.d.ts CHANGED Viewed

@@ -10,10 +10,12 @@ export { LiteSequencerClient } from './sdk/LiteSequencerClient';
 export { ConsoleLogger, NoopLogger } from './sdk/Logger';
 export { OperationTracker } from './sdk/OperationTracker';
 export { Simulator } from './sdk/Simulator';
-export { startTracking, startTrackingMultiple } from './sdk/StartTracking';
+export * from './sdk/StartTracking';
+export { TacExplorerClient } from './sdk/TacExplorerClient';
 export { TacSdk } from './sdk/TacSdk';
 export { TACTransactionManager } from './sdk/TACTransactionManager';
 export { TONTransactionManager } from './sdk/TONTransactionManager';
+export { TonTxFinalizer } from './sdk/TxFinalizer';
 export * from './sender';
 export * from './structs/Struct';
 export * from './wrappers/ContentUtils';

package/dist/src/index.js CHANGED Viewed

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.startTrackingMultiple = exports.startTracking = 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; } });
@@ -57,15 +57,17 @@ var OperationTracker_1 = require("./sdk/OperationTracker");
 Object.defineProperty(exports, "OperationTracker", { enumerable: true, get: function () { return OperationTracker_1.OperationTracker; } });
 var Simulator_1 = require("./sdk/Simulator");
 Object.defineProperty(exports, "Simulator", { enumerable: true, get: function () { return Simulator_1.Simulator; } });
-var StartTracking_1 = require("./sdk/StartTracking");
-Object.defineProperty(exports, "startTracking", { enumerable: true, get: function () { return StartTracking_1.startTracking; } });
-Object.defineProperty(exports, "startTrackingMultiple", { enumerable: true, get: function () { return StartTracking_1.startTrackingMultiple; } });
+__exportStar(require("./sdk/StartTracking"), exports);
+var TacExplorerClient_1 = require("./sdk/TacExplorerClient");
+Object.defineProperty(exports, "TacExplorerClient", { enumerable: true, get: function () { return TacExplorerClient_1.TacExplorerClient; } });
 var TacSdk_1 = require("./sdk/TacSdk");
 Object.defineProperty(exports, "TacSdk", { enumerable: true, get: function () { return TacSdk_1.TacSdk; } });
 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; } });
+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/Asset.d.ts CHANGED Viewed

@@ -1,10 +1,11 @@
 import type { Cell } from '@ton/ton';
-import { AssetType, FeeParams } from '../structs/Struct';
+import { AssetType, GeneratePayloadParams, Origin } from '../structs/Struct';
 export interface Asset {
     address: string;
     type: AssetType;
     rawAmount: bigint;
     clone: Asset;
+    origin: Origin;
     /**
      * Returns a new asset instance with the specified transfer amount in human-readable units.
      * Does not mutate the current asset instance.
@@ -57,15 +58,9 @@ export interface Asset {
      * @param params.crossChainTonAmount Optional TON amount to transfer cross-chain with the message.
      * @param params.forwardFeeTonAmount Optional TON amount used to cover forwarding fees on TON.
      * @param params.feeParams Optional fee parameters to fine-tune execution costs.
-     * @returns Promise that resolves to a Cell containing the encoded payload.
+     * @returns Cell containing the encoded payload.
      */
-    generatePayload(params: {
-        excessReceiver: string;
-        evmData: Cell;
-        crossChainTonAmount?: bigint;
-        forwardFeeTonAmount?: bigint;
-        feeParams?: FeeParams;
-    }): Promise<Cell>;
+    generatePayload(params: GeneratePayloadParams): Cell;
     /**
      * Validates whether the specified user is allowed to transfer this asset.
      * Implementations should throw if the transfer is not permitted (e.g., frozen asset, missing wallet, insufficient permissions).

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

@@ -1,6 +1,7 @@
 import { SandboxContract } from '@ton/sandbox';
-import type { Address, Contract, OpenedContract } from '@ton/ton';
-import { ContractState } from '../structs/Struct';
+import type { Address, Contract, OpenedContract, Transaction } from '@ton/ton';
+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.).
@@ -18,4 +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/IOperationTracker.d.ts CHANGED Viewed

@@ -3,55 +3,55 @@ export interface IOperationTracker {
     /**
      * Returns the operation type for the given id, optionally waiting according to the provided policy.
      * @param operationId Operation identifier.
-     * @param waitOptions Optional waiting and polling settings.
+     * @param waitOptions Optional waiting and polling settings. Pass `null` to disable retries and use a single attempt.
      */
-    getOperationType(operationId: string, waitOptions?: WaitOptions<OperationType>): Promise<OperationType>;
+    getOperationType(operationId: string, waitOptions?: WaitOptions<OperationType> | null): Promise<OperationType>;
     /**
      * Resolves an operation id for the given transaction linker, optionally waiting until available.
      * @param transactionLinker Reference to originating transaction across chains.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
-    getOperationId(transactionLinker: TransactionLinker, waitOptions?: WaitOptions<string>): Promise<string>;
+    getOperationId(transactionLinker: TransactionLinker, waitOptions?: WaitOptions<string> | null): Promise<string>;
     /**
      * Resolves an operation id by a transaction hash, optionally waiting until available.
      * @param transactionHash Hash of the originating transaction.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
-    getOperationIdByTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string>): Promise<string>;
+    getOperationIdByTransactionHash(transactionHash: string, waitOptions?: WaitOptions<string> | null): Promise<string>;
     /**
      * Resolves operation ids by shard keys for a particular caller, with optional batching and waiting.
      * @param shardsKeys List of shard keys.
      * @param caller Human-readable identifier of the caller (for tracing/limits).
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      * @param chunkSize Optional batching size for network requests.
      */
-    getOperationIdsByShardsKeys(shardsKeys: string[], caller: string, waitOptions?: WaitOptions<OperationIdsByShardsKey>, chunkSize?: number): Promise<OperationIdsByShardsKey>;
+    getOperationIdsByShardsKeys(shardsKeys: string[], caller: string, waitOptions?: WaitOptions<OperationIdsByShardsKey> | null, chunkSize?: number): Promise<OperationIdsByShardsKey>;
     /**
      * Gets detailed stage profiling for a single operation, optionally waiting until available.
      * @param operationId Operation identifier.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
-    getStageProfiling(operationId: string, waitOptions?: WaitOptions<ExecutionStages>): Promise<ExecutionStages>;
+    getStageProfiling(operationId: string, waitOptions?: WaitOptions<ExecutionStages> | null): Promise<ExecutionStages>;
     /**
      * Gets stage profiling for multiple operations in bulk.
      * @param operationIds Operation identifiers.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      * @param chunkSize Optional batching size for requests.
      */
-    getStageProfilings(operationIds: string[], waitOptions?: WaitOptions<ExecutionStagesByOperationId>, chunkSize?: number): Promise<ExecutionStagesByOperationId>;
+    getStageProfilings(operationIds: string[], waitOptions?: WaitOptions<ExecutionStagesByOperationId> | null, chunkSize?: number): Promise<ExecutionStagesByOperationId>;
     /**
      * Gets statuses for multiple operations.
      * @param operationIds Operation identifiers.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      * @param chunkSize Optional batching size for requests.
      */
-    getOperationStatuses(operationIds: string[], waitOptions?: WaitOptions<StatusInfosByOperationId>, chunkSize?: number): Promise<StatusInfosByOperationId>;
+    getOperationStatuses(operationIds: string[], waitOptions?: WaitOptions<StatusInfosByOperationId> | null, chunkSize?: number): Promise<StatusInfosByOperationId>;
     /**
      * Gets a single operation status, optionally waiting according to policy.
      * @param operationId Operation identifier.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
-    getOperationStatus(operationId: string, waitOptions?: WaitOptions<StatusInfo>): Promise<StatusInfo>;
+    getOperationStatus(operationId: string, waitOptions?: WaitOptions<StatusInfo> | null): Promise<StatusInfo>;
     /**
      * Returns a simplified status for the provided transaction linker.
      * @param transactionLinker Reference to originating transaction across chains.
@@ -60,22 +60,22 @@ export interface IOperationTracker {
     /**
      * Converts currency using the tracker service, optionally waiting for completion.
      * @param params Conversion parameters.
-     * @param waitOptions Optional waiting settings.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
      */
-    convertCurrency(params: ConvertCurrencyParams, waitOptions?: WaitOptions<ConvertedCurrencyResult>): Promise<ConvertedCurrencyResult>;
+    convertCurrency(params: ConvertCurrencyParams, waitOptions?: WaitOptions<ConvertedCurrencyResult> | null): Promise<ConvertedCurrencyResult>;
     /**
      * Simulates execution of a TAC message without broadcasting it, optionally waiting until the result is available.
      * Useful to validate inputs and estimate effects before sending a real transaction.
      * @param params Simulation parameters and context.
-     * @param waitOptions Optional waiting settings (polling/timeout policy).
+     * @param waitOptions Optional waiting settings (polling/timeout policy). Pass `null` to disable retries and use a single attempt.
      * @returns Promise with detailed simulation result.
      */
-    simulateTACMessage(params: TACSimulationParams, waitOptions?: WaitOptions<TACSimulationResult>): Promise<TACSimulationResult>;
+    simulateTACMessage(params: TACSimulationParams, waitOptions?: WaitOptions<TACSimulationResult> | null): Promise<TACSimulationResult>;
     /**
      * Suggests/calculates a TVM executor fee for the provided parameters, optionally waiting for completion.
      * @param params Parameters affecting fee calculation.
-     * @param waitOptions Optional waiting settings (polling/timeout policy).
+     * @param waitOptions Optional waiting settings (polling/timeout policy). Pass `null` to disable retries and use a single attempt.
      * @returns Promise with suggested fee information.
      */
-    getTVMExecutorFee(params: GetTVMExecutorFeeParams, waitOptions?: WaitOptions<SuggestedTVMExecutorFee>): Promise<SuggestedTVMExecutorFee>;
+    getTVMExecutorFee(params: GetTVMExecutorFeeParams, waitOptions?: WaitOptions<SuggestedTVMExecutorFee> | null): Promise<SuggestedTVMExecutorFee>;
 }

package/dist/src/interfaces/ISimulator.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { SenderAbstraction } from '../sender';
-import { CrosschainTx, ExecutionFeeEstimationResult } from '../structs/Struct';
+import { CrosschainTx, ExecutionFeeEstimationResult, GeneratePayloadParams } from '../structs/Struct';
+import { Asset } from './Asset';
 export interface ISimulator {
     /**
      * Simulates a list of cross-chain transactions for a given sender.
@@ -15,4 +16,11 @@ export interface ISimulator {
      * @returns Promise with fee estimation and execution info.
      */
     getSimulationInfo(sender: SenderAbstraction, tx: CrosschainTx): Promise<ExecutionFeeEstimationResult>;
+    /**
+     * Estimates the TON network fee required for a single asset.
+     * @param asset Asset to be included in the transaction.
+     * @param params Payload parameters.
+     * @returns The total estimated fee in nanotons (1 TON = 10^9 nanotons) for processing the provided asset.
+     */
+    estimateTONFee(asset: Asset, params: GeneratePayloadParams): bigint;
 }

package/dist/src/interfaces/ITONTransactionManager.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { SenderAbstraction } from '../sender';
-import { BatchCrossChainTx, CrossChainTransactionsOptions, CrosschainTx, EvmProxyMsg, TransactionLinkerWithOperationId } from '../structs/Struct';
+import { BatchCrossChainTx, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EvmProxyMsg, FeeParams, TransactionLinkerWithOperationId } from '../structs/Struct';
+import { Asset } from './Asset';
 export interface ITONTransactionManager {
     /**
      * Sends a single cross-chain transaction.
@@ -17,4 +18,22 @@ export interface ITONTransactionManager {
      * @returns Array of transaction linkers, one per submitted transaction.
      */
     sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTx[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
+    /**
+     * Builds the fee parameters for a cross-chain transaction.
+     * @param options Transaction configuration options.
+     * @param evmProxyMsg Encoded EVM proxy message.
+     * @param sender Sender abstraction for TVM message sending.
+     * @param tx Cross-chain transaction to bridge.
+     * @returns Promise with the fee parameters.
+     */
+    buildFeeParams(options: CrossChainTransactionOptions, evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx): Promise<FeeParams>;
+    /**
+     * Prepares the transaction payloads required for a cross-chain operation without sending them.
+     * @param evmProxyMsg Encoded EVM proxy message.
+     * @param senderAddress TVM address of the transaction sender (wallet address).
+     * @param assets Assets to be included in the transaction.
+     * @param options Optional transaction configuration including error handling and executor settings.
+     * @returns Promise with the prepared transaction payloads.
+     */
+    prepareCrossChainTransactionPayload(evmProxyMsg: EvmProxyMsg, senderAddress: string, assets: Asset[], options?: CrossChainTransactionOptions): Promise<CrossChainPayloadResult[]>;
 }

package/dist/src/interfaces/ITacExplorerClient.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { TacGasPriceResponse } from '../structs/InternalStruct';
+export interface ITacExplorerClient {
+    /**
+     * Gets TAC gas price from the blockchain explorer.
+     * @returns Promise resolving to TAC gas price response with average, fast, and slow prices.
+     */
+    getTACGasPrice(): Promise<TacGasPriceResponse>;
+}

package/dist/src/interfaces/ITacExplorerClient.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";
2	+ Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -2,10 +2,12 @@ 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, 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';
 export interface ITacSDK {
     readonly config: IConfiguration;
     /**
@@ -182,4 +184,26 @@ export interface ITacSDK {
      * Returns the operation tracker instance used for querying operation statuses and utilities.
      */
     getOperationTracker(): IOperationTracker;
+    /**
+     * 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.
+     * @param senderAddress TVM address of the transaction sender (wallet address).
+     * @param assets Assets to be included in the transaction.
+     * @param options Optional transaction configuration including error handling and executor settings.
+     * @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/interfaces/ITxFinalizer.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { TrackTransactionTreeParams } from '../structs/Struct';
+export interface ITxFinalizer {
+    trackTransactionTree(address: string, hash: string, params?: TrackTransactionTreeParams): Promise<void>;
+}

package/dist/src/interfaces/ITxFinalizer.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";
2	+ Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/interfaces/WalletInstanse.d.ts CHANGED Viewed

@@ -1,20 +1,16 @@
-import type { Contract, ContractProvider, MessageRelaxed, SendMode } from '@ton/ton';
+import type { Cell, Contract, ContractProvider, MessageRelaxed, SendMode } from '@ton/ton';
 export interface WalletInstanse extends Contract {
     /**
      * Returns current wallet seqno, used for nonce/ordering.
      * @param provider Contract provider to query the wallet.
      */
     getSeqno(provider: ContractProvider): Promise<number>;
-    /**
-     * Sends a transfer with specified messages and send mode.
-     * @param provider Contract provider used to send the transfer.
-     * @param args Transfer arguments including seqno, secretKey, messages and sendMode.
-     */
-    sendTransfer(provider: ContractProvider, args: {
+    send(provider: ContractProvider, msg: Cell): Promise<string | void>;
+    createTransfer(args: {
         seqno: number;
         secretKey: Buffer;
         messages: MessageRelaxed[];
         sendMode: SendMode;
         timeout?: number;
-    }): Promise<void>;
+    }): Cell;
 }

package/dist/src/interfaces/index.d.ts CHANGED Viewed

@@ -7,6 +7,7 @@ export * from './ILiteSequencerClientFactory';
 export * from './ILogger';
 export * from './IOperationTracker';
 export * from './ISimulator';
+export * from './ITacExplorerClient';
 export * from './ITacSDK';
 export * from './ITACTransactionManager';
 export * from './ITONTransactionManager';

package/dist/src/interfaces/index.js CHANGED Viewed

@@ -23,6 +23,7 @@ __exportStar(require("./ILiteSequencerClientFactory"), exports);
 __exportStar(require("./ILogger"), exports);
 __exportStar(require("./IOperationTracker"), exports);
 __exportStar(require("./ISimulator"), exports);
+__exportStar(require("./ITacExplorerClient"), exports);
 __exportStar(require("./ITacSDK"), exports);
 __exportStar(require("./ITACTransactionManager"), exports);
 __exportStar(require("./ITONTransactionManager"), exports);

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

@@ -1,5 +1,5 @@
 import { dev, mainnet, testnet } from '../../artifacts';
-import { IConfiguration } from '../interfaces';
+import { IConfiguration, ILogger } from '../interfaces';
 import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
 import { Network, TACParams, TONParams } from '../structs/Struct';
 export declare class Configuration implements IConfiguration {
@@ -8,8 +8,9 @@ export declare class Configuration implements IConfiguration {
     readonly TONParams: InternalTONParams;
     readonly TACParams: InternalTACParams;
     readonly liteSequencerEndpoints: string[];
-    constructor(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams: InternalTONParams, TACParams: InternalTACParams, liteSequencerEndpoints: string[]);
-    static create(network: Network, artifacts: typeof testnet | typeof mainnet | typeof dev, TONParams?: TONParams, TACParams?: TACParams, customLiteSequencerEndpoints?: string[], delay?: number): Promise<Configuration>;
+    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>;
     private static prepareTONParams;
     private static prepareTACParams;
     private static loadTACSettingsViaMulticall;
@@ -19,4 +20,5 @@ export declare class Configuration implements IConfiguration {
     get getTrustedTONExecutors(): string[];
     closeConnections(): unknown;
     isContractDeployedOnTVM(address: string): Promise<boolean>;
+    private static retrieveTONFeesParams;
 }