@tonappchain/sdk 0.7.0-rc14 → 0.7.0-rc16

package/README.md

@@ -40,16 +40,16 @@ The TAC SDK enables you to create frontends that:
 ### SDK Components
 
 - **[`TacSdk`](./docs/sdks/tac_sdk.md)**: The main class for interacting with the TAC protocol.
-  - [`create`](./docs/sdks/tac_sdk.md#create-static): Initializes the SDK instance.
+  - [`create`](./docs/sdks/tac_sdk.md#creating-an-instance-of-tacsdk): Initializes the SDK instance.
   - [`sendCrossChainTransaction`](./docs/sdks/tac_sdk.md#sendcrosschaintransaction): Sends a cross-chain transaction from TON to TAC.
   - [`getEVMTokenAddress`](./docs/sdks/tac_sdk.md#getevmtokenaddress): Gets the TAC address for a TON token.
   - [`getTVMTokenAddress`](./docs/sdks/tac_sdk.md#gettvmtokenaddress): Gets the TON address for a TAC token.
-  - [`getTransactionSimulationInfo`](./docs/sdks/tac_sdk.md#gettransactionsimulationinfo): Performs a complete simulation of a crosschain transaction to estimate fees and gather execution-related metadata.  
+  - [`getSimulationInfo`](./docs/sdks/tac_sdk.md#getsimulationinfo): Performs a complete simulation of a crosschain transaction to estimate fees and gather execution-related metadata.
   - [`getUserJettonBalance`](./docs/sdks/tac_sdk.md#getuserjettonbalance): Gets a user's Jetton balance (raw).
   - [`getUserJettonBalanceExtended`](./docs/sdks/tac_sdk.md#getuserjettonbalanceextended): Gets extended Jetton balance info (including decimals).
   - [`getUserJettonWalletAddress`](./docs/sdks/tac_sdk.md#getuserjettonwalletaddress): Calculates a user's Jetton wallet address.
-  - [`nativeTONAddress (getter)`](./docs/sdks/tac_sdk.md#nativetonaddress-getter): Placeholder address for native TON.
-  - [`nativeTACAddress (getter)`](./docs/sdks/tac_sdk.md#nativetacaddress-getter): Gets the native asset address on the TAC chain.
+  - [`nativeTONAddress (getter)`](./docs/sdks/tac_sdk.md#nativetonaddress): Placeholder address for native TON.
+  - [`nativeTACAddress (getter)`](./docs/sdks/tac_sdk.md#nativetacaddress): Gets the native asset address on the TAC chain.
   - *(See file for more...)*
 
 - **[`OperationTracker`](./docs/sdks/operation_tracker.md)**: Tools for monitoring cross-chain operation status.
@@ -75,9 +75,9 @@ The TAC SDK enables you to create frontends that:
   - [`StageName`](./docs/models/enums.md#stagename): Identifiers for tracking stages (`COLLECTED_IN_TAC`, `EXECUTED_IN_TAC`, etc.).
 
 - **[`Structs`](./docs/models/structs.md)**: Core data structures.
-  - [`AssetBridgingData`](./docs/models/structs.md#assetbridgingdata): Specifies assets to bridge (TON or Jettons).
-  - [`EvmProxyMsg`](./docs/models/structs.md#evmproxymsg): Defines the target EVM call details.
-  - [`TransactionLinker`](./docs/models/structs.md#transactionlinker): Identifies a cross-chain operation.
+  - [`AssetLike`](./docs/models/structs.md#assetlike): Flexible asset specification for cross-chain operations.
+  - [`EvmProxyMsg`](./docs/models/structs.md#evmproxymsg-type): Defines the target EVM call details.
+  - [`TransactionLinker`](./docs/models/structs.md#transactionlinker-type): Identifies a cross-chain operation.
   - *(See file for more...)*
 
 Navigate through the linked files for full details on parameters, return types, examples, and more.

package/dist/adapters/retryableContractOpener.js

@@ -86,7 +86,7 @@ class RetryableContractOpener {
     }
 }
 exports.RetryableContractOpener = RetryableContractOpener;
-async function createDefaultRetryableOpener(artifacts, maxRetries = 3, retryDelay = 1000) {
+async function createDefaultRetryableOpener(artifacts, maxRetries = 5, retryDelay = 1000) {
     const tonClient = new ton_1.TonClient({
         endpoint: new URL('api/v2/jsonRPC', artifacts.TON_RPC_ENDPOINT_BY_TAC).toString(),
     });

package/dist/assets/AssetFactory.js

@@ -16,7 +16,7 @@ class AssetFactory {
         }
         const cachedAsset = AssetCache_1.AssetCache.get(token);
         if (cachedAsset) {
-            return cachedAsset.clone.withAmount({ rawAmount: 0n });
+            return cachedAsset.clone.withRawAmount(0n);
         }
         const asset = token.tokenType === Struct_1.AssetType.FT
             ? await this.createFTAsset(configuration, token.address)

package/dist/assets/FT.d.ts

@@ -2,7 +2,7 @@ import { SandboxContract } from '@ton/sandbox';
 import { Cell, OpenedContract } from '@ton/ton';
 import { Asset, ContractOpener, IConfiguration } from '../interfaces';
 import { AssetOpType } from '../structs/InternalStruct';
-import { AssetType, EVMAddress, FeeParams, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
+import { AssetType, EVMAddress, FeeParams, FTOriginAndData, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 import { Origin } from '../structs/Struct';
 import { JettonMasterData } from '../wrappers/JettonMaster';
 import { JettonWallet } from '../wrappers/JettonWallet';
@@ -12,29 +12,25 @@ export declare class FT implements Asset {
     readonly origin: Origin;
     private _configuration;
     private _jettonMinter;
-    private _decimals?;
+    private _decimals;
     private _transferAmount;
     private _evmAddress?;
     get address(): string;
     static getJettonData(contractOpener: ContractOpener, address: TVMAddress): Promise<JettonMasterData>;
     getJettonData(): Promise<JettonMasterData>;
     static getOrigin(configuration: IConfiguration, address: TVMAddress): Promise<Origin>;
+    static getOriginAndData(configuration: IConfiguration, address: TVMAddress): Promise<FTOriginAndData>;
     static getTVMAddress(configuration: IConfiguration, address: EVMAddress): Promise<string>;
     static getEVMAddress(configuration: IConfiguration, address: TVMAddress): Promise<string>;
     private constructor();
+    private static getTACDecimals;
     static fromAddress(configuration: IConfiguration, address: TVMAddress | EVMAddress): Promise<FT>;
     get rawAmount(): bigint;
     get clone(): FT;
-    withAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<FT>;
-    addAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<FT>;
+    withAmount(amount: number): FT;
+    withRawAmount(rawAmount: bigint): FT;
+    addAmount(amount: number): FT;
+    addRawAmount(rawAmount: bigint): FT;
     getDecimals(): Promise<number>;
     getEVMAddress(): Promise<string>;
     getTVMAddress(): Promise<string>;

package/dist/assets/FT.js

@@ -25,16 +25,21 @@ class FT {
         return FT.getJettonData(this._configuration.TONParams.contractOpener, this._tvmAddress.toString());
     }
     static async getOrigin(configuration, address) {
+        const result = await this.getOriginAndData(configuration, address);
+        return result.origin;
+    }
+    static async getOriginAndData(configuration, address) {
         const { jettonMinterCode, crossChainLayerAddress, jettonWalletCode } = configuration.TONParams;
         const { code: thisCodeBOC } = await configuration.TONParams.contractOpener.getContractState(ton_1.Address.parse(address));
         if (!thisCodeBOC) {
             throw errors_1.emptyContractError;
         }
         const thisCode = ton_1.Cell.fromBoc(thisCodeBOC)[0];
+        const jettonMinter = configuration.TONParams.contractOpener.open(JettonMaster_1.JettonMaster.createFromAddress(ton_1.Address.parse(address)));
         if (!jettonMinterCode.equals(thisCode)) {
-            return Struct_2.Origin.TON;
+            const jettonData = await jettonMinter.getJettonData();
+            return { origin: Struct_2.Origin.TON, jettonMinter, jettonData };
         }
-        const jettonMinter = configuration.TONParams.contractOpener.open(JettonMaster_1.JettonMaster.createFromAddress(ton_1.Address.parse(address)));
         const evmAddress = await jettonMinter.getEVMAddress();
         const expectedMinterAddress = await (0, Utils_1.calculateContractAddress)(jettonMinterCode, (0, ton_1.beginCell)()
             .storeCoins(0)
@@ -45,20 +50,19 @@ class FT {
             .storeStringTail(evmAddress)
             .endCell());
         if (!expectedMinterAddress.equals(ton_1.Address.parse(address))) {
-            return Struct_2.Origin.TON;
+            const jettonData = await jettonMinter.getJettonData();
+            return { origin: Struct_2.Origin.TON, jettonMinter, jettonData };
         }
-        return Struct_2.Origin.TAC;
+        return { origin: Struct_2.Origin.TAC, jettonMinter, evmAddress };
     }
     static async getTVMAddress(configuration, address) {
         Validator_1.Validator.validateEVMAddress(address);
-        // If token is TON native
         const fromTVM = await configuration.TACParams.tokenUtils['exists(address)'](address);
         if (fromTVM) {
             const erc20Token = configuration.artifacts.tac.wrappers.CrossChainLayerERC20FactoryTAC.connect(address, configuration.TACParams.provider);
             const info = await erc20Token.getInfo();
             return info.tvmAddress;
         }
-        // If token is TAC native
         const jettonMaster = JettonMaster_1.JettonMaster.createFromConfig({
             evmTokenAddress: address,
             crossChainLayerAddress: ton_1.Address.parse(configuration.TONParams.crossChainLayerAddress),
@@ -78,25 +82,57 @@ class FT {
             return givenMinter.getEVMAddress();
         }
     }
-    constructor(address, origin, configuration) {
+    constructor(address, origin, configuration, decimals) {
         this.type = Struct_1.AssetType.FT;
         this._tvmAddress = ton_1.Address.parse(address);
         this._configuration = configuration;
         this._jettonMinter = this._configuration.TONParams.contractOpener.open(new JettonMaster_1.JettonMaster(this._tvmAddress));
         this.origin = origin;
         this._transferAmount = 0n;
+        this._decimals = decimals;
+    }
+    static async getTACDecimals(configuration, evmAddress) {
+        const nativeTACAddress = await configuration.nativeTACAddress();
+        if (evmAddress === nativeTACAddress) {
+            return 18; // Native TAC always has 18 decimals
+        }
+        // For ERC20 contracts, get decimals from contract
+        const erc20Token = configuration.artifacts.tac.wrappers.ERC20FactoryTAC.connect(evmAddress, configuration.TACParams.provider);
+        return Number(await erc20Token.decimals());
     }
     static async fromAddress(configuration, address) {
         const tvmAddress = (0, ethers_1.isAddress)(address) ? await this.getTVMAddress(configuration, address) : address;
-        const origin = await FT.getOrigin(configuration, tvmAddress).catch((e) => {
+        const { origin, jettonMinter, evmAddress: cachedEvmAddress, jettonData, } = await this.getOriginAndData(configuration, tvmAddress).catch((e) => {
             if (e instanceof errors_1.ContractError) {
-                return Struct_2.Origin.TAC;
+                const jettonMinter = configuration.TONParams.contractOpener.open(JettonMaster_1.JettonMaster.createFromAddress(ton_1.Address.parse(tvmAddress)));
+                return { origin: Struct_2.Origin.TAC, jettonMinter, evmAddress: undefined, jettonData: undefined };
             }
             throw e;
         });
-        const token = new FT(tvmAddress, origin, configuration);
-        if ((0, ethers_1.isAddress)(address)) {
-            token._evmAddress = address;
+        let decimals;
+        let finalEvmAddress;
+        if (origin === Struct_2.Origin.TON) {
+            if (!jettonData) {
+                throw errors_1.missingJettonDataError;
+            }
+            const decimalsRaw = jettonData.content.metadata.decimals;
+            if (decimalsRaw === undefined) {
+                throw errors_1.missingDecimals;
+            }
+            decimals = Number(decimalsRaw);
+        }
+        else {
+            if ((0, ethers_1.isAddress)(address)) {
+                finalEvmAddress = address;
+            }
+            else {
+                finalEvmAddress = cachedEvmAddress || (await jettonMinter.getEVMAddress());
+            }
+            decimals = await this.getTACDecimals(configuration, finalEvmAddress);
+        }
+        const token = new FT(tvmAddress, origin, configuration, decimals);
+        if (finalEvmAddress || (0, ethers_1.isAddress)(address)) {
+            token._evmAddress = finalEvmAddress || address;
         }
         return token;
     }
@@ -104,44 +140,41 @@ class FT {
         return this._transferAmount;
     }
     get clone() {
-        const ft = new FT(this._tvmAddress.toString(), this.origin, this._configuration);
+        const ft = new FT(this._tvmAddress.toString(), this.origin, this._configuration, this._decimals);
         ft._transferAmount = this._transferAmount;
         ft._evmAddress = this._evmAddress;
-        ft._decimals = this._decimals;
         return ft;
     }
-    async withAmount(amount) {
+    withAmount(amount) {
         if (this._transferAmount > 0n) {
-            // clone token if withAmount set before to avoid changing the original token
             const newToken = this.clone;
-            newToken._transferAmount =
-                'rawAmount' in amount ? amount.rawAmount : (0, Utils_1.calculateRawAmount)(amount.amount, await this.getDecimals());
+            const decimals = this._decimals;
+            newToken._transferAmount = (0, Utils_1.calculateRawAmount)(amount, decimals);
             return newToken;
         }
-        if ('rawAmount' in amount) {
-            this._transferAmount = amount.rawAmount;
-        }
-        else {
-            const decimals = await this.getDecimals();
-            this._transferAmount = (0, Utils_1.calculateRawAmount)(amount.amount, decimals);
-        }
+        const decimals = this._decimals;
+        this._transferAmount = (0, Utils_1.calculateRawAmount)(amount, decimals);
         return this;
     }
-    async addAmount(amount) {
-        if ('rawAmount' in amount) {
-            this._transferAmount = this._transferAmount + amount.rawAmount;
-        }
-        else {
-            const decimals = await this.getDecimals();
-            this._transferAmount = this._transferAmount + (0, Utils_1.calculateRawAmount)(amount.amount, decimals);
+    withRawAmount(rawAmount) {
+        if (this._transferAmount > 0n) {
+            const newToken = this.clone;
+            newToken._transferAmount = rawAmount;
+            return newToken;
         }
+        this._transferAmount = rawAmount;
+        return this;
+    }
+    addAmount(amount) {
+        const decimals = this._decimals;
+        this._transferAmount = this._transferAmount + (0, Utils_1.calculateRawAmount)(amount, decimals);
+        return this;
+    }
+    addRawAmount(rawAmount) {
+        this._transferAmount = this._transferAmount + rawAmount;
         return this;
     }
     async getDecimals() {
-        if (!this._decimals) {
-            const decimalsRaw = (await this._jettonMinter.getJettonData()).content.metadata.decimals;
-            this._decimals = decimalsRaw ? Number(decimalsRaw) : 9;
-        }
         return this._decimals;
     }
     async getEVMAddress() {

package/dist/assets/NFT.d.ts

@@ -46,8 +46,10 @@ export declare class NFT implements Asset {
     get address(): string;
     get rawAmount(): bigint;
     get clone(): NFT;
-    withAmount(): Promise<NFT>;
-    addAmount(): Promise<NFT>;
+    withAmount(_amount?: number): NFT;
+    withRawAmount(_rawAmount?: bigint): NFT;
+    addAmount(_amount?: number): NFT;
+    addRawAmount(_rawAmount?: bigint): NFT;
     getEVMAddress(): Promise<string>;
     getTVMAddress(): Promise<string>;
     generatePayload(params: {

package/dist/assets/NFT.js

@@ -139,10 +139,22 @@ class NFT {
     get clone() {
         return new NFT(this._addresses, this.origin, this._configuration);
     }
-    async withAmount() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    withAmount(_amount) {
+        // NFTs are non-fungible; amount is always 1. Keep API consistent.
         return this;
     }
-    async addAmount() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    withRawAmount(_rawAmount) {
+        // NFTs are non-fungible; raw amount concept is not applicable. Keep API consistent.
+        return this;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    addAmount(_amount) {
+        return this;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    addRawAmount(_rawAmount) {
         return this;
     }
     async getEVMAddress() {

package/dist/assets/TON.d.ts

@@ -12,16 +12,10 @@ export declare class TON implements Asset {
     static create(config: IConfiguration): TON;
     get rawAmount(): bigint;
     get clone(): TON;
-    withAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<TON>;
-    addAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<TON>;
+    withAmount(amount: number): TON;
+    withRawAmount(rawAmount: bigint): TON;
+    addAmount(amount: number): TON;
+    addRawAmount(rawAmount: bigint): TON;
     getEVMAddress(): Promise<string>;
     getTVMAddress(): Promise<string>;
     generatePayload(params: {

package/dist/assets/TON.js

@@ -24,28 +24,30 @@ class TON {
         ton._rawAmount = this._rawAmount;
         return ton;
     }
-    async withAmount(amount) {
+    withAmount(amount) {
         if (this._rawAmount > 0n) {
-            // clone token if withAmount set before to avoid changing the original token
             const newToken = this.clone;
-            newToken._rawAmount = 'rawAmount' in amount ? amount.rawAmount : (0, Utils_1.calculateRawAmount)(amount.amount, 9);
+            newToken._rawAmount = (0, Utils_1.calculateRawAmount)(amount, 9);
             return newToken;
         }
-        if ('rawAmount' in amount) {
-            this._rawAmount = amount.rawAmount;
-        }
-        else {
-            this._rawAmount = (0, Utils_1.calculateRawAmount)(amount.amount, 9);
-        }
+        this._rawAmount = (0, Utils_1.calculateRawAmount)(amount, 9);
         return this;
     }
-    async addAmount(amount) {
-        if ('rawAmount' in amount) {
-            this._rawAmount = this._rawAmount + amount.rawAmount;
-        }
-        else {
-            this._rawAmount = this._rawAmount + (0, Utils_1.calculateRawAmount)(amount.amount, 9);
+    withRawAmount(rawAmount) {
+        if (this._rawAmount > 0n) {
+            const newToken = this.clone;
+            newToken._rawAmount = rawAmount;
+            return newToken;
         }
+        this._rawAmount = rawAmount;
+        return this;
+    }
+    addAmount(amount) {
+        this._rawAmount = this._rawAmount + (0, Utils_1.calculateRawAmount)(amount, 9);
+        return this;
+    }
+    addRawAmount(rawAmount) {
+        this._rawAmount = this._rawAmount + rawAmount;
         return this;
     }
     async getEVMAddress() {

package/dist/errors/index.d.ts

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

package/dist/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.tvmAddressError = exports.statusFetchError = exports.simulationError = exports.profilingFetchError = exports.prefixError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.invalidMethodNameError = exports.insufficientBalanceError = exports.indexRequiredError = exports.evmAddressError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.allEndpointsFailedError = exports.WalletError = exports.TokenError = exports.SettingError = exports.MetadataError = exports.KeyError = exports.FormatError = exports.FetchError = exports.EVMCallError = exports.ContractError = exports.BitError = exports.AddressError = void 0;
+exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = 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.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,11 +22,16 @@ Object.defineProperty(exports, "evmAddressError", { enumerable: true, get: funct
 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, "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; } });
+Object.defineProperty(exports, "missingGasLimitError", { enumerable: true, get: function () { return instances_1.missingGasLimitError; } });
+Object.defineProperty(exports, "missingJettonDataError", { enumerable: true, get: function () { return instances_1.missingJettonDataError; } });
+Object.defineProperty(exports, "missingTvmExecutorFeeError", { enumerable: true, get: function () { return instances_1.missingTvmExecutorFeeError; } });
 Object.defineProperty(exports, "notMultiplyOf8Error", { enumerable: true, get: function () { return instances_1.notMultiplyOf8Error; } });
 Object.defineProperty(exports, "operationFetchError", { enumerable: true, get: function () { return instances_1.operationFetchError; } });
 Object.defineProperty(exports, "prefixError", { enumerable: true, get: function () { return instances_1.prefixError; } });
 Object.defineProperty(exports, "profilingFetchError", { enumerable: true, get: function () { return instances_1.profilingFetchError; } });
-Object.defineProperty(exports, "simulationError", { enumerable: true, get: function () { return instances_1.simulationError; } });
+Object.defineProperty(exports, "simulationFetchError", { enumerable: true, get: function () { return instances_1.simulationFetchError; } });
 Object.defineProperty(exports, "statusFetchError", { enumerable: true, get: function () { return instances_1.statusFetchError; } });
 Object.defineProperty(exports, "tvmAddressError", { enumerable: true, get: function () { return instances_1.tvmAddressError; } });
 Object.defineProperty(exports, "unknownTokenTypeError", { enumerable: true, get: function () { return instances_1.unknownTokenTypeError; } });

package/dist/errors/instances.d.ts

@@ -11,7 +11,6 @@ export declare const notMultiplyOf8Error: BitError;
 export declare const prefixError: MetadataError;
 export declare const emptySettingError: (setting: string) => SettingError;
 export declare const invalidMethodNameError: (methodName: string) => EVMCallError;
-export declare const simulationError: (inner: unknown) => FetchError;
 export declare const profilingFetchError: (msg: string, inner?: unknown) => FetchError;
 export declare const emptyArrayError: (msg: string) => FetchError;
 export declare const invalidAssetType: FormatError;
@@ -22,3 +21,11 @@ export declare const allContractOpenerFailedError: (inner: unknown) => FetchErro
 export declare const insufficientBalanceError: (token: string) => InsufficientBalanceError;
 export declare const unknownTokenTypeError: (token: string, reason?: string) => TokenError;
 export declare const indexRequiredError: (token: string) => TokenError;
+export declare const convertCurrencyFetchError: (msg: string, inner?: unknown) => FetchError;
+export declare const simulationFetchError: (msg: string, inner?: unknown) => FetchError;
+export declare const getTONFeeInfoFetchError: (msg: string, inner?: unknown) => FetchError;
+export declare const missingFeeParamsError: FormatError;
+export declare const missingTvmExecutorFeeError: FormatError;
+export declare const missingGasLimitError: FormatError;
+export declare const missingDecimals: MetadataError;
+export declare const missingJettonDataError: MetadataError;

package/dist/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.indexRequiredError = exports.unknownTokenTypeError = exports.insufficientBalanceError = exports.allContractOpenerFailedError = exports.allEndpointsFailedError = exports.noValidGroupFoundError = exports.prepareMessageGroupError = exports.invalidAssetType = exports.emptyArrayError = exports.profilingFetchError = exports.simulationError = 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.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);
@@ -22,26 +22,32 @@ const emptySettingError = (setting) => new errors_1.SettingError(`unexpected emp
 exports.emptySettingError = emptySettingError;
 const invalidMethodNameError = (methodName) => new errors_1.EVMCallError(`Invalid Solidity method name: "${methodName}". Method must be either a valid identifier or have parameters (bytes,bytes).`, 111);
 exports.invalidMethodNameError = invalidMethodNameError;
-const simulationError = (inner) => 
-// try to get meaningful error message from axios error
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-new errors_1.FetchError(`Failed to simulate EVM call: ${inner?.response?.data?.error}`, 112, inner);
-exports.simulationError = simulationError;
-const profilingFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch stage profiling: ${msg}`, 113, inner);
+const profilingFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch stage profiling: ${msg}`, 112, inner);
 exports.profilingFetchError = profilingFetchError;
-const emptyArrayError = (msg) => new errors_1.FetchError(`empty array: ${msg}`, 114);
+const emptyArrayError = (msg) => new errors_1.FetchError(`empty array: ${msg}`, 113);
 exports.emptyArrayError = emptyArrayError;
-exports.invalidAssetType = new errors_1.FormatError('Invalid asset type', 115);
-const prepareMessageGroupError = (isBocSizeValid, isDepthValid) => new errors_1.PrepareMessageGroupError(`Failed to prepare message group: BOC size valid: ${isBocSizeValid}, depth valid: ${isDepthValid}`, 116);
+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', 117);
-const allEndpointsFailedError = (inner) => new errors_1.FetchError('All endpoints failed', 118, inner);
+exports.noValidGroupFoundError = new errors_1.NoValidGroupFoundError('Failed to prepare valid message group', 116);
+const allEndpointsFailedError = (inner) => new errors_1.FetchError('All endpoints failed', 117, inner);
 exports.allEndpointsFailedError = allEndpointsFailedError;
-const allContractOpenerFailedError = (inner) => new errors_1.FetchError('All contract opener failed', 119, inner);
+const allContractOpenerFailedError = (inner) => new errors_1.FetchError('All contract opener failed', 118, inner);
 exports.allContractOpenerFailedError = allContractOpenerFailedError;
-const insufficientBalanceError = (token) => new errors_1.InsufficientBalanceError(`Insufficient balance of ${token}`, 120);
+const insufficientBalanceError = (token) => new errors_1.InsufficientBalanceError(`Insufficient balance of ${token}`, 119);
 exports.insufficientBalanceError = insufficientBalanceError;
-const unknownTokenTypeError = (token, reason) => new errors_1.TokenError(`Unknown token type of ${token}: ${reason}`, 121);
+const unknownTokenTypeError = (token, reason) => new errors_1.TokenError(`Unknown token type of ${token}: ${reason}`, 120);
 exports.unknownTokenTypeError = unknownTokenTypeError;
-const indexRequiredError = (token) => new errors_1.TokenError(`Index is required for collection ${token}`, 122);
+const indexRequiredError = (token) => new errors_1.TokenError(`Index is required for collection ${token}`, 121);
 exports.indexRequiredError = indexRequiredError;
+const convertCurrencyFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch convert currency: ${msg}`, 122, inner);
+exports.convertCurrencyFetchError = convertCurrencyFetchError;
+const simulationFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch simulate tac msg: ${msg}`, 123, inner);
+exports.simulationFetchError = simulationFetchError;
+const getTONFeeInfoFetchError = (msg, inner) => new errors_1.FetchError(`failed to fetch simulate tac msg: ${msg}`, 124, inner);
+exports.getTONFeeInfoFetchError = getTONFeeInfoFetchError;
+exports.missingFeeParamsError = new errors_1.FormatError('When withoutSimulation is true, protocolFee and evmExecutorFee must be provided in options', 125);
+exports.missingTvmExecutorFeeError = new errors_1.FormatError('When withoutSimulation is true and isRoundTrip is true, tvmExecutorFee must be provided in options', 126);
+exports.missingGasLimitError = new errors_1.FormatError('When withoutSimulation is true, gasLimit must be provided in evmProxyMsg', 127);
+exports.missingDecimals = new errors_1.MetadataError('Missing decimals in jetton metadata', 128);
+exports.missingJettonDataError = new errors_1.MetadataError('Jetton data should be available for TON origin', 129);

package/dist/index.d.ts

@@ -10,7 +10,8 @@ export { OperationTracker } from './sdk/OperationTracker';
 export { Simulator } from './sdk/Simulator';
 export { startTracking, startTrackingMultiple } from './sdk/StartTracking';
 export { TacSdk } from './sdk/TacSdk';
-export { TransactionManager } from './sdk/TransactionManager';
+export { TONTransactionManager } from './sdk/TONTransactionManager';
+export { TACTransactionManager } from './sdk/TACTransactionManager';
 export * from './sender';
 export * from './structs/Struct';
 export { Network, SimplifiedStatuses } from './structs/Struct';

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JettonWalletOpCodes = exports.JettonWallet = exports.HighloadWalletV3 = exports.readJettonMetadata = exports.SimplifiedStatuses = exports.Network = exports.TransactionManager = exports.TacSdk = exports.startTrackingMultiple = exports.startTracking = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.orbsOpener = exports.liteClientOpener = void 0;
+exports.JettonWalletOpCodes = exports.JettonWallet = exports.HighloadWalletV3 = exports.readJettonMetadata = exports.SimplifiedStatuses = exports.Network = exports.TACTransactionManager = exports.TONTransactionManager = exports.TacSdk = exports.startTrackingMultiple = exports.startTracking = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.orbsOpener = exports.liteClientOpener = void 0;
 var contractOpener_1 = require("./adapters/contractOpener");
 Object.defineProperty(exports, "liteClientOpener", { enumerable: true, get: function () { return contractOpener_1.liteClientOpener; } });
 Object.defineProperty(exports, "orbsOpener", { enumerable: true, get: function () { return contractOpener_1.orbsOpener; } });
@@ -39,8 +39,10 @@ Object.defineProperty(exports, "startTracking", { enumerable: true, get: functio
 Object.defineProperty(exports, "startTrackingMultiple", { enumerable: true, get: function () { return StartTracking_1.startTrackingMultiple; } });
 var TacSdk_1 = require("./sdk/TacSdk");
 Object.defineProperty(exports, "TacSdk", { enumerable: true, get: function () { return TacSdk_1.TacSdk; } });
-var TransactionManager_1 = require("./sdk/TransactionManager");
-Object.defineProperty(exports, "TransactionManager", { enumerable: true, get: function () { return TransactionManager_1.TransactionManager; } });
+var TONTransactionManager_1 = require("./sdk/TONTransactionManager");
+Object.defineProperty(exports, "TONTransactionManager", { enumerable: true, get: function () { return TONTransactionManager_1.TONTransactionManager; } });
+var TACTransactionManager_1 = require("./sdk/TACTransactionManager");
+Object.defineProperty(exports, "TACTransactionManager", { enumerable: true, get: function () { return TACTransactionManager_1.TACTransactionManager; } });
 __exportStar(require("./sender"), exports);
 __exportStar(require("./structs/Struct"), exports);
 var Struct_1 = require("./structs/Struct");

package/dist/interfaces/Asset.d.ts

@@ -6,28 +6,33 @@ export interface Asset {
     rawAmount: bigint;
     clone: Asset;
     /**
-     * Returns a new asset instance with the specified transfer amount.
-     * Use { rawAmount } for base units (e.g., nano units), or { amount } for human-readable units if supported by the implementation.
+     * Returns a new asset instance with the specified transfer amount in human-readable units.
      * Does not mutate the current asset instance.
-     * @param amount Object specifying either rawAmount (bigint base units) or amount (number in human units).
-     * @returns Promise that resolves to a new Asset reflecting the requested amount.
+     * @param amount Amount in human units (e.g., 1.5 TON). Decimals are resolved during asset creation.
+     * @returns A new Asset reflecting the requested amount.
      */
-    withAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<Asset>;
+    withAmount(amount: number): Asset;
     /**
-     * Increases the transfer amount by the specified value and returns a new asset instance.
+     * Returns a new asset instance with the specified transfer amount in raw base units.
      * Does not mutate the current asset instance.
-     * @param amount Object specifying either rawAmount (bigint base units) or amount (number in human units).
-     * @returns Promise that resolves to a new Asset with the increased amount.
+     * @param rawAmount Amount in raw base units (bigint).
+     * @returns A new Asset reflecting the requested raw amount.
      */
-    addAmount(amount: {
-        rawAmount: bigint;
-    } | {
-        amount: number;
-    }): Promise<Asset>;
+    withRawAmount(rawAmount: bigint): Asset;
+    /**
+     * Increases the transfer amount by the specified value (human-readable units) and returns a new asset instance.
+     * Does not mutate the current asset instance.
+     * @param amount Amount in human units (e.g., 1.5 TON). Decimals are resolved during asset creation.
+     * @returns A new Asset with the increased amount.
+     */
+    addAmount(amount: number): Asset;
+    /**
+     * Increases the transfer amount by the specified raw base units and returns a new asset instance.
+     * Does not mutate the current asset instance.
+     * @param rawAmount Amount in raw base units (bigint).
+     * @returns A new Asset with the increased amount in raw units.
+     */
+    addRawAmount(rawAmount: bigint): Asset;
     /**
      * Resolves the corresponding EVM token address for this asset.
      * Useful when bridging or interacting with EVM-compatible networks.

package/dist/interfaces/ILiteSequencerClient.d.ts

@@ -1,4 +1,4 @@
-import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, OperationIdsByShardsKey, OperationType, StatusInfosByOperationId, TransactionLinker } from '../structs/Struct';
+import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
 export interface ILiteSequencerClient {
     /** Retrieves the operation type by id. */
     getOperationType(operationId: string): Promise<OperationType>;
@@ -27,4 +27,17 @@ export interface ILiteSequencerClient {
     getOperationStatuses(operationIds: string[], chunkSize?: number): Promise<StatusInfosByOperationId>;
     /** Converts currency amount using the sequencer-provided rate source. */
     convertCurrency(params: ConvertCurrencyParams): Promise<ConvertedCurrencyResult>;
+    /**
+     * Gets TVM executor fee information for cross-chain operations.
+     * @param params Parameters for fee calculation including assets and fee symbol.
+     * @returns Promise resolving to suggested TVM executor fee information.
+     */
+    getTVMExecutorFee(params: GetTVMExecutorFeeParams): Promise<SuggestedTVMExecutorFee>;
+    /**
+     * Simulates TAC message execution without broadcasting it on-chain.
+     * Useful for estimating fees and validating transaction inputs.
+     * @param params Simulation request with encoded message and context.
+     * @returns Promise resolving to detailed simulation result.
+     */
+    simulateTACMessage(params: TACSimulationParams): Promise<TACSimulationResult>;
 }