@tonappchain/sdk 0.7.2-alpha-15 → 0.7.2-alpha-16

package/dist/src/assets/AssetCache.d.ts

@@ -1,23 +1,23 @@
 import { Asset } from '../interfaces';
+type AssetCacheToken = {
+    address: string;
+    index?: bigint;
+    tokenType?: string;
+};
 export declare class AssetCache {
     private static readonly cache;
     /**
      * Get asset from cache
      */
-    static get(token: {
-        address: string;
-        index?: bigint;
-    }): Asset | undefined;
+    static get(token: AssetCacheToken): Asset | undefined;
     /**
      * Set asset in cache
      */
-    static set(token: {
-        address: string;
-        index?: bigint;
-    }, asset: Asset): void;
+    static set(token: AssetCacheToken, asset: Asset): void;
     /**
      * Clear the cache
      */
     static clear(): void;
     private static generateKey;
 }
+export {};

package/dist/src/assets/AssetCache.js

@@ -26,6 +26,9 @@ class AssetCache {
         // Normalize address to lowercase for consistency
         const normalizedAddress = token.address.toLowerCase();
         const parts = [normalizedAddress];
+        if (token.tokenType !== undefined) {
+            parts.push(token.tokenType);
+        }
         if (token.index !== undefined) {
             parts.push(token.index.toString());
         }

package/dist/src/errors/errors.d.ts

@@ -7,7 +7,15 @@ export declare class ContractError extends ErrorWithStatusCode {
 }
 export declare class FetchError extends ErrorWithStatusCode {
     readonly inner?: unknown;
-    constructor(message: string, errorCode: number, inner?: unknown);
+    readonly httpStatus?: number;
+    readonly innerErrorCode?: number;
+    readonly innerErrorName?: string;
+    readonly innerMessage?: string;
+    readonly innerStack?: string;
+    constructor(message: string, errorCode: number, inner?: unknown, options?: {
+        includeInnerStack?: boolean;
+    });
+    toDebugString(includeTrace?: boolean): string;
 }
 export declare class AddressError extends ErrorWithStatusCode {
     constructor(message: string, errorCode: number);

package/dist/src/errors/errors.js

@@ -16,10 +16,50 @@ class ContractError extends ErrorWithStatusCode {
 }
 exports.ContractError = ContractError;
 class FetchError extends ErrorWithStatusCode {
-    constructor(message, errorCode, inner) {
+    constructor(message, errorCode, inner, options) {
         super(message, errorCode);
         this.name = 'FetchError';
         this.inner = inner;
+        if (inner && typeof inner === 'object') {
+            const err = inner;
+            if (typeof err.status === 'number') {
+                this.httpStatus = err.status;
+            }
+            else if (typeof err.response?.status === 'number') {
+                this.httpStatus = err.response.status;
+            }
+            if (typeof err.errorCode === 'number') {
+                this.innerErrorCode = err.errorCode;
+            }
+            if (typeof err.name === 'string') {
+                this.innerErrorName = err.name;
+            }
+            if (typeof err.message === 'string') {
+                this.innerMessage = err.message;
+            }
+            if (options?.includeInnerStack && typeof err.stack === 'string') {
+                this.innerStack = err.stack;
+            }
+        }
+    }
+    toDebugString(includeTrace = false) {
+        const parts = [`${this.name} (${this.errorCode}): ${this.message}`];
+        if (this.httpStatus !== undefined) {
+            parts.push(`httpStatus: ${this.httpStatus}`);
+        }
+        if (this.innerErrorCode !== undefined) {
+            parts.push(`innerErrorCode: ${this.innerErrorCode}`);
+        }
+        if (this.innerErrorName) {
+            parts.push(`innerErrorName: ${this.innerErrorName}`);
+        }
+        if (this.innerMessage) {
+            parts.push(`innerMessage: ${this.innerMessage}`);
+        }
+        if (includeTrace && this.innerStack) {
+            parts.push(`innerStack:\n${this.innerStack}`);
+        }
+        return parts.join('\n');
     }
 }
 exports.FetchError = FetchError;

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

@@ -1,2 +1,2 @@
 export { AddressError, BitError, ContractError, EVMCallError, FetchError, FormatError, KeyError, MetadataError, SettingError, TokenError, TransactionError, WalletError, } from './errors';
-export { allEndpointsFailedError, emptyArrayError, emptyContractError, emptySettingError, evmAddressError, indexRequiredError, insufficientBalanceError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';
+export { allEndpointsFailedError, emptyArrayError, emptyContractError, emptySettingError, evmAddressError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';

package/dist/src/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidMethodNameError = exports.insufficientBalanceError = exports.indexRequiredError = exports.evmAddressError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
+exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidMethodNameError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.evmAddressError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.allEndpointsFailedError = exports.WalletError = exports.TransactionError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AddressError", { enumerable: true, get: function () { return errors_1.AddressError; } });
 Object.defineProperty(exports, "BitError", { enumerable: true, get: function () { return errors_1.BitError; } });
@@ -22,6 +22,7 @@ Object.defineProperty(exports, "emptySettingError", { enumerable: true, get: fun
 Object.defineProperty(exports, "evmAddressError", { enumerable: true, get: function () { return instances_1.evmAddressError; } });
 Object.defineProperty(exports, "indexRequiredError", { enumerable: true, get: function () { return instances_1.indexRequiredError; } });
 Object.defineProperty(exports, "insufficientBalanceError", { enumerable: true, get: function () { return instances_1.insufficientBalanceError; } });
+Object.defineProperty(exports, "insufficientFeeParamsError", { enumerable: true, get: function () { return instances_1.insufficientFeeParamsError; } });
 Object.defineProperty(exports, "invalidMethodNameError", { enumerable: true, get: function () { return instances_1.invalidMethodNameError; } });
 Object.defineProperty(exports, "missingDecimals", { enumerable: true, get: function () { return instances_1.missingDecimals; } });
 Object.defineProperty(exports, "missingFeeParamsError", { enumerable: true, get: function () { return instances_1.missingFeeParamsError; } });

package/dist/src/errors/instances.d.ts

@@ -17,7 +17,7 @@ export declare const emptyArrayError: (msg: string) => FetchError;
 export declare const invalidAssetType: FormatError;
 export declare const prepareMessageGroupError: (isBocSizeValid: boolean, isDepthValid: boolean) => PrepareMessageGroupError;
 export declare const noValidGroupFoundError: NoValidGroupFoundError;
-export declare const allEndpointsFailedError: (inner: unknown) => FetchError;
+export declare const allEndpointsFailedError: (inner: unknown, includeInnerStack?: boolean) => FetchError;
 export declare const allContractOpenerFailedError: (inner: unknown) => FetchError;
 export declare const insufficientBalanceError: (token: string) => InsufficientBalanceError;
 export declare const unknownTokenTypeError: (token: string, reason?: string) => TokenError;
@@ -36,3 +36,4 @@ export declare const convertCurrencyNegativeOrZeroValueError: FormatError;
 export declare const unknownAssetOriginError: (origin: Origin) => TokenError;
 export declare const gasPriceFetchError: (msg: string, inner?: unknown) => FetchError;
 export declare const txFinalizationError: (msg: string) => TransactionError;
+export declare const insufficientFeeParamsError: (feeName: string, provided: bigint, required: bigint) => FormatError;

package/dist/src/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.txFinalizationError = exports.gasPriceFetchError = exports.unknownAssetOriginError = exports.convertCurrencyNegativeOrZeroValueError = exports.sendCrossChainTransactionFailedError = exports.zeroRawAmountError = exports.missingJettonDataError = exports.missingDecimals = exports.missingGasLimitError = exports.missingTvmExecutorFeeError = exports.missingFeeParamsError = exports.getTONFeeInfoFetchError = exports.simulationFetchError = exports.convertCurrencyFetchError = exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.invalidMethodNameError = exports.emptySettingError = exports.prefixError = exports.notMultiplyOf8Error = exports.unsupportedFormatError = exports.unsupportedKeyError = exports.unknownWalletError = exports.evmAddressError = exports.tvmAddressError = exports.statusFetchError = exports.operationFetchError = exports.emptyContractError = void 0;
+exports.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,39 @@ 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 buildInnerErrorSummary(inner) {
+    if (inner && typeof inner === 'object') {
+        const err = inner;
+        const parts = [];
+        const httpStatus = typeof err.status === 'number'
+            ? err.status
+            : typeof err.response?.status === 'number'
+                ? err.response.status
+                : undefined;
+        if (typeof httpStatus === 'number') {
+            parts.push(`httpStatus=${httpStatus}`);
+        }
+        if (typeof err.errorCode === 'number') {
+            parts.push(`code=${err.errorCode}`);
+        }
+        if (typeof err.name === 'string' && err.name.length > 0) {
+            parts.push(`name=${err.name}`);
+        }
+        if (typeof err.message === 'string' && err.message.length > 0) {
+            parts.push(`message=${err.message}`);
+        }
+        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)}`, 117, inner, {
+    includeInnerStack,
+});
 exports.allEndpointsFailedError = allEndpointsFailedError;
 const allContractOpenerFailedError = (inner) => new errors_1.FetchError('All contract opener failed', 118, inner);
 exports.allContractOpenerFailedError = allContractOpenerFailedError;
@@ -62,3 +94,5 @@ const gasPriceFetchError = (msg, inner) => new errors_1.FetchError(`Failed to fe
 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/sdk/Configuration.d.ts

@@ -10,7 +10,7 @@ export declare class Configuration implements IConfiguration {
     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): Promise<Configuration>;
+    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;

package/dist/src/sdk/Configuration.js

@@ -10,6 +10,7 @@ const Fees_1 = require("./Fees");
 const Logger_1 = require("./Logger");
 const Utils_1 = require("./Utils");
 const Validator_1 = require("./Validator");
+const Consts_1 = require("./Consts");
 class Configuration {
     constructor(network, artifacts, TONParams, TACParams, liteSequencerEndpoints, logger) {
         this.network = network;
@@ -19,9 +20,9 @@ class Configuration {
         this.liteSequencerEndpoints = liteSequencerEndpoints;
         this.logger = logger;
     }
-    static async create(network, artifacts, TONParams, TACParams, customLiteSequencerEndpoints, delay, logger = new Logger_1.NoopLogger()) {
+    static async create(network, artifacts, TONParams, TACParams, customLiteSequencerEndpoints, delay, logger = new Logger_1.NoopLogger(), passLoggerToOpeners = true) {
         const [internalTONParams, internalTACParams] = await Promise.all([
-            this.prepareTONParams(network, artifacts, TONParams, delay, logger),
+            this.prepareTONParams(network, artifacts, TONParams, delay, logger, passLoggerToOpeners),
             this.prepareTACParams(network, TACParams),
         ]);
         let liteSequencerEndpoints;
@@ -36,7 +37,7 @@ class Configuration {
         }
         return new Configuration(network, artifacts, internalTONParams, internalTACParams, liteSequencerEndpoints, logger);
     }
-    static async prepareTONParams(network, artifacts, TONParams, delay, logger = new Logger_1.NoopLogger()) {
+    static async prepareTONParams(network, artifacts, TONParams, delay, logger = new Logger_1.NoopLogger(), passLoggerToOpeners = true) {
         let contractOpener;
         let settingsAddress;
         if (network === Struct_1.Network.DEV) {
@@ -52,10 +53,12 @@ class Configuration {
         else {
             contractOpener =
                 TONParams?.contractOpener ??
-                    (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, 5, delay, logger));
+                    (await (0, adapters_1.createDefaultRetryableOpener)(artifacts.TON_RPC_ENDPOINT_BY_TAC, network, Consts_1.DEFAULT_RETRY_MAX_COUNT, delay, passLoggerToOpeners ? logger : undefined));
             settingsAddress = TONParams?.settingsAddress ?? artifacts.TON_SETTINGS_ADDRESS;
         }
-        contractOpener.setLogger(logger);
+        if (passLoggerToOpeners) {
+            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/LiteSequencerClient.d.ts

@@ -5,6 +5,7 @@ export declare class LiteSequencerClient implements ILiteSequencerClient {
     private readonly maxChunkSize;
     private readonly httpClient;
     constructor(endpoint: string, maxChunkSize?: number, httpClient?: IHttpClient);
+    private getRequestLabel;
     getOperationIdByTransactionHash(transactionHash: string): Promise<string>;
     getOperationType(operationId: string): Promise<OperationType>;
     getOperationId(transactionLinker: TransactionLinker): Promise<string>;

package/dist/src/sdk/LiteSequencerClient.js

@@ -11,9 +11,13 @@ class LiteSequencerClient {
         this.maxChunkSize = maxChunkSize;
         this.httpClient = httpClient;
     }
+    getRequestLabel(method, path) {
+        return `${method} ${new URL(path, this.endpoint).toString()}`;
+    }
     async getOperationIdByTransactionHash(transactionHash) {
         const isEthHash = /^0x[a-fA-F0-9]{64}$/.test(transactionHash);
         const path = isEthHash ? 'tac/operation-id' : 'ton/operation-id';
+        const requestLabel = this.getRequestLabel('GET', path);
         try {
             if (isEthHash) {
                 const response = await this.httpClient.get(new URL(path, this.endpoint).toString(), {
@@ -33,12 +37,14 @@ class LiteSequencerClient {
             if (error?.response?.status === 404) {
                 return '';
             }
-            throw (0, errors_1.operationFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getOperationType(operationId) {
+        const path = 'operation-type';
+        const requestLabel = this.getRequestLabel('GET', path);
         try {
-            const response = await this.httpClient.get(new URL('operation-type', this.endpoint).toString(), {
+            const response = await this.httpClient.get(new URL(path, this.endpoint).toString(), {
                 params: {
                     operationId,
                 },
@@ -46,10 +52,12 @@ class LiteSequencerClient {
             return response.data.response || '';
         }
         catch (error) {
-            throw (0, errors_1.operationFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getOperationId(transactionLinker) {
+        const path = 'ton/operation-id';
+        const requestLabel = this.getRequestLabel('POST', path);
         const requestBody = {
             shardsKey: transactionLinker.shardsKey,
             caller: transactionLinker.caller,
@@ -57,7 +65,7 @@ class LiteSequencerClient {
             timestamp: transactionLinker.timestamp,
         };
         try {
-            const response = await this.httpClient.post(new URL('ton/operation-id', this.endpoint).toString(), requestBody);
+            const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), requestBody);
             return response.data.response || '';
         }
         catch (error) {
@@ -65,16 +73,18 @@ class LiteSequencerClient {
             if (error?.response?.status === 404) {
                 return '';
             }
-            throw (0, errors_1.operationFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getOperationIdsByShardsKeys(shardsKeys, caller, chunkSize = this.maxChunkSize) {
+        const path = 'operation-ids-by-shards-keys';
+        const requestLabel = this.getRequestLabel('POST', path);
         if (!shardsKeys || shardsKeys.length === 0) {
             throw (0, errors_1.emptyArrayError)('shardsKeys');
         }
         try {
             const response = await this.processChunkedRequest(shardsKeys, async (chunk) => {
-                const response = await this.httpClient.post(new URL('operation-ids-by-shards-keys', this.endpoint).toString(), {
+                const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), {
                     shardsKeys: chunk,
                     caller: caller,
                 });
@@ -83,16 +93,18 @@ class LiteSequencerClient {
             return response.response;
         }
         catch (error) {
-            throw (0, errors_1.operationFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.operationFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getStageProfilings(operationIds, chunkSize = this.maxChunkSize) {
+        const path = 'stage-profiling';
+        const requestLabel = this.getRequestLabel('POST', path);
         if (!operationIds || operationIds.length === 0) {
             throw (0, errors_1.emptyArrayError)('operationIds');
         }
         try {
             const response = await this.processChunkedRequest(operationIds, async (chunk) => {
-                const response = await this.httpClient.post(new URL('stage-profiling', this.endpoint).toString(), {
+                const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), {
                     operationIds: chunk,
                 }, {
                     transformResponse: [Utils_1.toCamelCaseTransformer],
@@ -102,16 +114,18 @@ class LiteSequencerClient {
             return response.response;
         }
         catch (error) {
-            throw (0, errors_1.profilingFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.profilingFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getOperationStatuses(operationIds, chunkSize = this.maxChunkSize) {
+        const path = 'status';
+        const requestLabel = this.getRequestLabel('POST', path);
         if (!operationIds || operationIds.length === 0) {
             throw (0, errors_1.emptyArrayError)('operationIds');
         }
         try {
             const response = await this.processChunkedRequest(operationIds, async (chunk) => {
-                const response = await this.httpClient.post(new URL('status', this.endpoint).toString(), {
+                const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), {
                     operationIds: chunk,
                 }, {
                     transformResponse: [Utils_1.toCamelCaseTransformer],
@@ -121,16 +135,18 @@ class LiteSequencerClient {
             return response.response;
         }
         catch (error) {
-            throw (0, errors_1.statusFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, errors_1.statusFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async convertCurrency(params) {
+        const path = 'convert_currency';
+        const requestLabel = this.getRequestLabel('POST', path);
         try {
             const payload = {
                 currency: params.currency,
                 value: params.value.toString(),
             };
-            const response = await this.httpClient.post(new URL('convert_currency', this.endpoint).toString(), payload, {
+            const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), payload, {
                 transformResponse: [Utils_1.toCamelCaseTransformer],
             });
             const raw = response.data.response;
@@ -152,29 +168,33 @@ class LiteSequencerClient {
             };
         }
         catch (error) {
-            throw (0, instances_1.convertCurrencyFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, instances_1.convertCurrencyFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async simulateTACMessage(params) {
+        const path = 'tac/simulator/simulate-message';
+        const requestLabel = this.getRequestLabel('POST', path);
         try {
-            const response = await this.httpClient.post(new URL('tac/simulator/simulate-message', this.endpoint).toString(), params, {
+            const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), params, {
                 transformResponse: [Utils_1.toCamelCaseTransformer],
             });
             return response.data.response;
         }
         catch (error) {
-            throw (0, instances_1.simulationFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, instances_1.simulationFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async getTVMExecutorFee(params) {
+        const path = '/ton/calculator/ton-executor-fee';
+        const requestLabel = this.getRequestLabel('POST', path);
         try {
-            const response = await this.httpClient.post(new URL('/ton/calculator/ton-executor-fee', this.endpoint).toString(), params, {
+            const response = await this.httpClient.post(new URL(path, this.endpoint).toString(), params, {
                 transformResponse: [Utils_1.toCamelCaseTransformer],
             });
             return response.data.response;
         }
         catch (error) {
-            throw (0, instances_1.getTONFeeInfoFetchError)(`endpoint ${this.endpoint} failed to complete request`, error);
+            throw (0, instances_1.getTONFeeInfoFetchError)(`request ${requestLabel} failed to complete request`, error);
         }
     }
     async processChunkedRequest(identifiers, requestFn, chunkSize = this.maxChunkSize) {

package/dist/src/sdk/OperationTracker.js

@@ -50,7 +50,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation id by transactionHash');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation ID by transaction hash')
@@ -72,7 +72,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation type');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation type')
@@ -94,7 +94,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation id');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation ID by transaction linker')
@@ -117,7 +117,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation ids by shards keys');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation IDs by shards keys')
@@ -144,7 +144,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get stage profiling');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting stage profiling')
@@ -167,7 +167,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get stage profilings');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting stage profilings')
@@ -190,7 +190,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation statuses');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation statuses')
@@ -208,7 +208,6 @@ class OperationTracker {
                         this.logger.warn(`No operation status for operationId=${operationId}`);
                         throw new Error(`No operation status for operationId=${operationId}`);
                     }
-                    this.logger.debug(`Operation status retrieved successfully`);
                     return result;
                 }
                 catch (error) {
@@ -217,11 +216,13 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get operation status');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
-        return waitOptions
+        const status = waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting operation status')
             : await requestFn();
+        this.logger.debug(`operation status resolved stage=${status.stage ?? 'unknown'} success=${(String(status.success))}`);
+        return status;
     }
     async getSimplifiedOperationStatus(transactionLinker) {
         this.logger.debug(`Getting simplified operation status for transaction linker: ${(0, Utils_1.formatObjectForLogging)(transactionLinker)}`);
@@ -258,7 +259,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to convert currency');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Converting currency')
@@ -281,7 +282,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to simulate TAC message');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Simulating TAC message')
@@ -303,7 +304,7 @@ class OperationTracker {
                 }
             }
             this.logger.error('All endpoints failed to get TVM executor fee');
-            throw (0, errors_1.allEndpointsFailedError)(lastError);
+            throw (0, errors_1.allEndpointsFailedError)(lastError, waitOptions?.includeErrorTrace ?? false);
         };
         return waitOptions
             ? await (0, Utils_1.waitUntilSuccess)(waitOptions, requestFn, 'OperationTracker: Getting TVM executor fee')

package/dist/src/sdk/TONTransactionManager.js

@@ -18,7 +18,7 @@ class TONTransactionManager {
         this.logger = logger;
     }
     async buildFeeParams(options, evmProxyMsg, sender, tx) {
-        const { withoutSimulation, protocolFee, evmExecutorFee, tvmExecutorFee, isRoundTrip } = options;
+        const { withoutSimulation, protocolFee, evmExecutorFee, tvmExecutorFee, isRoundTrip, shouldValidateFees = true, } = options;
         if (withoutSimulation) {
             if (protocolFee === undefined || evmExecutorFee === undefined) {
                 throw errors_1.missingFeeParamsError;
@@ -40,6 +40,20 @@ class TONTransactionManager {
         const simulationResult = await this.simulator.getSimulationInfo(sender, tx);
         if (!evmProxyMsg.gasLimit)
             evmProxyMsg.gasLimit = simulationResult.feeParams.gasLimit;
+        const shouldValidateSuggestedFees = shouldValidateFees && (simulationResult.simulation?.simulationStatus ?? true);
+        if (shouldValidateSuggestedFees) {
+            if (protocolFee !== undefined && protocolFee < simulationResult.feeParams.protocolFee) {
+                throw (0, errors_1.insufficientFeeParamsError)('protocolFee', protocolFee, simulationResult.feeParams.protocolFee);
+            }
+            if (evmExecutorFee !== undefined && evmExecutorFee < simulationResult.feeParams.evmExecutorFee) {
+                throw (0, errors_1.insufficientFeeParamsError)('evmExecutorFee', evmExecutorFee, simulationResult.feeParams.evmExecutorFee);
+            }
+            if (simulationResult.feeParams.isRoundTrip &&
+                tvmExecutorFee !== undefined &&
+                tvmExecutorFee < simulationResult.feeParams.tvmExecutorFee) {
+                throw (0, errors_1.insufficientFeeParamsError)('tvmExecutorFee', tvmExecutorFee, simulationResult.feeParams.tvmExecutorFee);
+            }
+        }
         return {
             protocolFee: protocolFee ?? simulationResult.feeParams.protocolFee,
             evmExecutorFee: evmExecutorFee ?? simulationResult.feeParams.evmExecutorFee,
@@ -168,10 +182,9 @@ class TONTransactionManager {
         if (!shouldWaitForOperationId) {
             return { sendTransactionResult, ...transactionLinker };
         }
-        const waitOptions = tx.options?.waitOptions ?? {
-            ensureTxExecuted: true,
-        };
-        if (waitOptions.ensureTxExecuted && sendTransactionResult.boc) {
+        const waitOptions = tx.options?.waitOptions ?? {};
+        const ensureTxExecuted = tx.options?.ensureTxExecuted ?? true;
+        if (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.config.TONParams.contractOpener.trackTransactionTree(sender.getSenderAddress(), hash, {

package/dist/src/sdk/TacSdk.js

@@ -26,6 +26,7 @@ class TacSdk {
     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:
@@ -40,7 +41,7 @@ class TacSdk {
             default:
                 throw new Error(`Unsupported network: ${network}`);
         }
-        const config = await Configuration_1.Configuration.create(network, artifacts, sdkParams.TONParams, sdkParams.TACParams, sdkParams.customLiteSequencerEndpoints, delay, logger);
+        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);
         const explorerClient = new TacExplorerClient_1.TacExplorerClient(artifacts.TAC_EXPLORER_API_ENDPOINT);
         const simulator = new Simulator_1.Simulator(config, operationTracker, logger);

package/dist/src/sdk/Utils.js

@@ -168,9 +168,8 @@ async function waitUntilSuccess(options = {}, operation, operationDescription, .
             if (result === undefined || result === null) {
                 throw new Error(`Empty result`);
             }
-            options.logger?.debug(`${contextPrefix}Result: ${formatObjectForLogging(result)}`);
             if (successCheck && !successCheck(result, context)) {
-                throw new Error(`Result is not successful`);
+                throw new Error(`Result is not successful: ${formatObjectForLogging(result)}`);
             }
             options.logger?.debug(`${contextPrefix}Attempt ${attempt} successful`);
             // Execute custom onSuccess callback if provided
@@ -193,8 +192,13 @@ async function waitUntilSuccess(options = {}, operation, operationDescription, .
                 options.logger?.debug(`${contextPrefix}Max attempts (${maxAttempts}) reached`);
                 throw error;
             }
-            options.logger?.debug(`${contextPrefix}Error on attempt ${attempt}: ${error}`);
-            options.logger?.debug(`${contextPrefix}Waiting ${delay}ms before next attempt`);
+            const pendingMessage = statusRetryMessageFromError(error, attempt, maxAttempts, delay);
+            if (pendingMessage) {
+                options.logger?.debug(`${contextPrefix}${pendingMessage}`);
+            }
+            else {
+                options.logger?.debug(`${contextPrefix}attempt=${attempt}/${maxAttempts} failed; retry_in=${delay}ms; error=${String(error)}`);
+            }
             await (0, exports.sleep)(delay);
             attempt++;
         }
@@ -203,6 +207,44 @@ async function waitUntilSuccess(options = {}, operation, operationDescription, .
 function formatObjectForLogging(obj) {
     return JSON.stringify(obj, (key, value) => (typeof value === 'bigint' ? value.toString() : value));
 }
+function statusRetryMessageFromError(error, attempt, maxAttempts, delay) {
+    const prefix = 'Result is not successful: ';
+    const message = String(error);
+    const index = message.indexOf(prefix);
+    if (index < 0) {
+        return null;
+    }
+    const payloadString = message.slice(index + prefix.length).trim();
+    let payload;
+    try {
+        payload = JSON.parse(payloadString);
+    }
+    catch {
+        return null;
+    }
+    if (typeof payload !== 'object' || payload === null) {
+        return null;
+    }
+    const statusPayload = payload;
+    if (statusPayload.stage === undefined &&
+        statusPayload.success === undefined &&
+        statusPayload.transactions === undefined) {
+        return null;
+    }
+    const stage = typeof statusPayload.stage === 'string' && statusPayload.stage ? statusPayload.stage : 'unknown';
+    const success = typeof statusPayload.success === 'boolean' ? String(statusPayload.success) : 'unknown';
+    let txHash = '-';
+    if (Array.isArray(statusPayload.transactions) && statusPayload.transactions.length > 0) {
+        const first = statusPayload.transactions[0];
+        if (typeof first === 'object' && first !== null && 'hash' in first) {
+            const maybeHash = first.hash;
+            if (typeof maybeHash === 'string' && maybeHash) {
+                txHash = maybeHash;
+            }
+        }
+    }
+    return `pending attempt=${attempt}/${maxAttempts} stage=${stage} success=${success} tx=${txHash} retry_in=${delay}ms`;
+}
 function getBouncedAddress(tvmAddress) {
     return ton_1.Address.parse(tvmAddress).toString({
         bounceable: true,

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

@@ -82,6 +82,11 @@ export type SDKParams = {
      * URLs of lite sequencers
      */
     customLiteSequencerEndpoints?: string[];
+    /**
+     * Whether SDK logger should be passed to TON contract opener(s).
+     * Default: true
+     */
+    passLoggerToOpeners?: boolean;
 };
 export declare enum AssetType {
     NFT = "NFT",
@@ -284,6 +289,16 @@ export type FeeParams = {
 export type evmDataBuilder = (transactionLinker: TransactionLinker, evmProxyMsg: EvmProxyMsg, validExecutors: ValidExecutors) => Cell;
 export type CrossChainTransactionOptions = {
     allowSimulationError?: boolean;
+    /**
+     * If true, ensures TON transaction execution is validated before waiting for operation id.
+     * @default true
+     */
+    ensureTxExecuted?: boolean;
+    /**
+     * If true, validates explicitly provided fee params against suggested values.
+     * @default true
+     */
+    shouldValidateFees?: boolean;
     isRoundTrip?: boolean;
     protocolFee?: bigint;
     evmValidExecutors?: string[];
@@ -297,7 +312,7 @@ export type CrossChainTransactionOptions = {
     waitOptions?: WaitOptions<string>;
     evmDataBuilder?: evmDataBuilder;
 };
-export type BatchCrossChainTransactionOptions = Omit<CrossChainTransactionOptions, 'waitOperationId' | 'waitOptions'>;
+export type BatchCrossChainTransactionOptions = Omit<CrossChainTransactionOptions, 'waitOperationId' | 'waitOptions' | 'ensureTxExecuted'>;
 export type CrossChainTransactionsOptions = {
     waitOperationIds?: boolean;
     waitOptions?: WaitOptions<OperationIdsByShardsKey>;
@@ -371,10 +386,10 @@ export interface WaitOptions<T = unknown, TContext = unknown> {
      */
     onSuccess?: (result: T, context?: TContext) => Promise<void> | void;
     /**
-     * Ensure that TON transaction is succesful
-     * @default true
+     * Include underlying error stack trace in FetchError (innerStack)
+     * @default false
      */
-    ensureTxExecuted?: boolean;
+    includeErrorTrace?: boolean;
 }
 export declare const defaultWaitOptions: WaitOptions;
 export declare enum Origin {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tonappchain/sdk",
-    "version": "0.7.2-alpha-15",
+    "version": "0.7.2-alpha-16",
     "repository": "https://github.com/TacBuild/tac-sdk.git",
     "author": "TAC. <developers@tac>",
     "license": "MIT",