@tonappchain/sdk 0.7.2 → 0.7.3-rc1

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

@@ -1,7 +1,7 @@
 import { Cell } from '@ton/ton';
 import { NFTCollectionData, NFTItemData } from '../../artifacts/tonTypes';
 import { Asset, IConfiguration } from '../interfaces';
-import { AssetType, EVMAddress, FeeParams, Origin, TVMAddress } from '../structs/Struct';
+import { AssetType, BlockchainType, EVMAddress, FeeParams, Origin, TVMAddress } from '../structs/Struct';
 export declare class NFT implements Asset {
     private readonly _addresses;
     readonly origin: Origin;
@@ -61,8 +61,8 @@ export declare class NFT implements Asset {
         feeParams?: FeeParams;
     }): Cell;
     isOwnedBy(userAddress: string): Promise<boolean>;
-    checkCanBeTransferredBy(userAddress: string): Promise<void>;
-    getBalanceOf(userAddress: string): Promise<bigint>;
+    checkCanBeTransferredBy(userAddress: string, blockchainType?: BlockchainType): Promise<void>;
+    getBalanceOf(userAddress: string, blockchainType?: BlockchainType): Promise<bigint>;
     private getBurnPayload;
     private getTransferPayload;
 }

package/dist/src/assets/NFT.js

@@ -207,13 +207,19 @@ class NFT {
         const nftData = await NFT.getItemData(this._configuration, this.address.toString());
         return !!nftData.ownerAddress?.equals(ton_1.Address.parse(userAddress));
     }
-    async checkCanBeTransferredBy(userAddress) {
-        if (!(await this.isOwnedBy(userAddress))) {
+    async checkCanBeTransferredBy(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if ((await this.getBalanceOf(userAddress, blockchainType)) < 1n) {
             throw (0, errors_1.insufficientBalanceError)(this.address.toString());
         }
     }
-    async getBalanceOf(userAddress) {
-        return (await this.isOwnedBy(userAddress)) ? 1n : 0n;
+    async getBalanceOf(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if (blockchainType === Struct_1.BlockchainType.TON) {
+            Validator_1.Validator.validateTVMAddress(userAddress);
+            return (await this.isOwnedBy(userAddress)) ? 1n : 0n;
+        }
+        Validator_1.Validator.validateEVMAddress(userAddress);
+        const nft = new ethers_1.ethers.Contract(await this.getEVMAddress(), this._configuration.artifacts.tac.compilationArtifacts.IERC721.abi, this._configuration.TACParams.provider);
+        return (await nft.ownerOf(this._addresses.index)).toLowerCase() === userAddress.toLowerCase() ? 1n : 0n;
     }
     getBurnPayload(crossChainLayerAddress, evmData, crossChainTonAmount, feeData) {
         const queryId = (0, Utils_1.generateRandomNumberByTimestamp)().randomNumber;

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

@@ -0,0 +1,24 @@
+import type { Cell } from '@ton/ton';
+import { Asset, IConfiguration } from '../interfaces';
+import { AssetType, BlockchainType, GeneratePayloadParams, Origin } from '../structs/Struct';
+export declare class TAC implements Asset {
+    private readonly _configuration;
+    private readonly _evmAddress;
+    private _wrappedAsset;
+    readonly type: AssetType;
+    readonly origin: Origin;
+    private constructor();
+    static create(configuration: IConfiguration): Promise<TAC>;
+    get address(): string;
+    get rawAmount(): bigint;
+    get clone(): TAC;
+    withAmount(amount: number): TAC;
+    withRawAmount(rawAmount: bigint): TAC;
+    addAmount(amount: number): TAC;
+    addRawAmount(rawAmount: bigint): TAC;
+    getEVMAddress(): Promise<string>;
+    getTVMAddress(): Promise<string>;
+    generatePayload(params: GeneratePayloadParams): Cell;
+    checkCanBeTransferredBy(userAddress: string, blockchainType?: BlockchainType): Promise<void>;
+    getBalanceOf(userAddress: string, blockchainType?: BlockchainType): Promise<bigint>;
+}

package/dist/src/assets/TAC.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAC = void 0;
+const errors_1 = require("../errors");
+const Validator_1 = require("../sdk/Validator");
+const Struct_1 = require("../structs/Struct");
+const FT_1 = require("./FT");
+class TAC {
+    constructor(_configuration, _evmAddress, _wrappedAsset) {
+        this._configuration = _configuration;
+        this._evmAddress = _evmAddress;
+        this._wrappedAsset = _wrappedAsset;
+        this.type = Struct_1.AssetType.FT;
+        this.origin = Struct_1.Origin.TAC;
+    }
+    static async create(configuration) {
+        const evmAddress = await configuration.nativeTACAddress();
+        const wrappedAsset = await FT_1.FT.fromAddress(configuration, evmAddress);
+        return new TAC(configuration, evmAddress, wrappedAsset);
+    }
+    get address() {
+        return this._wrappedAsset.address;
+    }
+    get rawAmount() {
+        return this._wrappedAsset.rawAmount;
+    }
+    get clone() {
+        return new TAC(this._configuration, this._evmAddress, this._wrappedAsset.clone);
+    }
+    withAmount(amount) {
+        const nextWrappedAsset = this._wrappedAsset.withAmount(amount);
+        if (nextWrappedAsset === this._wrappedAsset) {
+            return this;
+        }
+        return new TAC(this._configuration, this._evmAddress, nextWrappedAsset);
+    }
+    withRawAmount(rawAmount) {
+        const nextWrappedAsset = this._wrappedAsset.withRawAmount(rawAmount);
+        if (nextWrappedAsset === this._wrappedAsset) {
+            return this;
+        }
+        return new TAC(this._configuration, this._evmAddress, nextWrappedAsset);
+    }
+    addAmount(amount) {
+        this._wrappedAsset = this._wrappedAsset.addAmount(amount);
+        return this;
+    }
+    addRawAmount(rawAmount) {
+        this._wrappedAsset = this._wrappedAsset.addRawAmount(rawAmount);
+        return this;
+    }
+    async getEVMAddress() {
+        return this._evmAddress;
+    }
+    async getTVMAddress() {
+        return this.address;
+    }
+    generatePayload(params) {
+        return this._wrappedAsset.generatePayload(params);
+    }
+    async checkCanBeTransferredBy(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if ((await this.getBalanceOf(userAddress, blockchainType)) < this.rawAmount) {
+            throw (0, errors_1.insufficientBalanceError)(this.address);
+        }
+    }
+    async getBalanceOf(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if (blockchainType === Struct_1.BlockchainType.TAC) {
+            Validator_1.Validator.validateEVMAddress(userAddress);
+            return this._configuration.TACParams.provider.getBalance(userAddress);
+        }
+        return this._wrappedAsset.getBalanceOf(userAddress, blockchainType);
+    }
+}
+exports.TAC = TAC;

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

@@ -2,7 +2,7 @@ import { Cell } from '@ton/ton';
 import { Asset, IConfiguration } from '../interfaces';
 import type { SenderAbstraction } from '../sender';
 import type { ShardTransaction } from '../structs/InternalStruct';
-import { AssetType, FeeParams, Origin } from '../structs/Struct';
+import { AssetType, BlockchainType, FeeParams, Origin } from '../structs/Struct';
 export declare class TON implements Asset {
     readonly address: string;
     readonly type: AssetType;
@@ -29,6 +29,6 @@ export declare class TON implements Asset {
     }): Cell;
     getUserBalance(userAddress: string): Promise<bigint>;
     static checkBalance(sender: SenderAbstraction, config: IConfiguration, transactions: ShardTransaction[]): Promise<void>;
-    checkCanBeTransferredBy(userAddress: string): Promise<void>;
-    getBalanceOf(userAddress: string): Promise<bigint>;
+    checkCanBeTransferredBy(userAddress: string, blockchainType?: BlockchainType): Promise<void>;
+    getBalanceOf(userAddress: string, blockchainType?: BlockchainType): Promise<bigint>;
 }

package/dist/src/assets/TON.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TON = void 0;
 const ton_1 = require("@ton/ton");
+const ethers_1 = require("ethers");
 const errors_1 = require("../errors");
 const Consts_1 = require("../sdk/Consts");
 const Utils_1 = require("../sdk/Utils");
+const Validator_1 = require("../sdk/Validator");
 const Struct_1 = require("../structs/Struct");
 class TON {
     constructor(config) {
@@ -85,14 +87,19 @@ class TON {
             throw (0, errors_1.insufficientBalanceError)(Consts_1.TON_SYMBOL);
         }
     }
-    async checkCanBeTransferredBy(userAddress) {
-        const balance = await this.getUserBalance(userAddress);
-        if (balance < this._rawAmount) {
+    async checkCanBeTransferredBy(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if ((await this.getBalanceOf(userAddress, blockchainType)) < this._rawAmount) {
             throw (0, errors_1.insufficientBalanceError)(Consts_1.TON_SYMBOL);
         }
     }
-    async getBalanceOf(userAddress) {
-        return this.getUserBalance(userAddress);
+    async getBalanceOf(userAddress, blockchainType = Struct_1.BlockchainType.TON) {
+        if (blockchainType === Struct_1.BlockchainType.TON) {
+            Validator_1.Validator.validateTVMAddress(userAddress);
+            return this.getUserBalance(userAddress);
+        }
+        Validator_1.Validator.validateEVMAddress(userAddress);
+        const token = new ethers_1.ethers.Contract(await this.getEVMAddress(), this._config.artifacts.tac.compilationArtifacts.IERC20WithDecimals.abi, this._config.TACParams.provider);
+        return token.balanceOf(userAddress);
     }
 }
 exports.TON = TON;

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

@@ -1,4 +1,5 @@
 export { AssetFactory } from './AssetFactory';
 export { FT } from './FT';
 export { NFT } from './NFT';
+export { TAC } from './TAC';
 export { TON } from './TON';

package/dist/src/assets/index.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TON = exports.NFT = exports.FT = exports.AssetFactory = void 0;
+exports.TON = exports.TAC = exports.NFT = exports.FT = exports.AssetFactory = void 0;
 var AssetFactory_1 = require("./AssetFactory");
 Object.defineProperty(exports, "AssetFactory", { enumerable: true, get: function () { return AssetFactory_1.AssetFactory; } });
 var FT_1 = require("./FT");
 Object.defineProperty(exports, "FT", { enumerable: true, get: function () { return FT_1.FT; } });
 var NFT_1 = require("./NFT");
 Object.defineProperty(exports, "NFT", { enumerable: true, get: function () { return NFT_1.NFT; } });
+var TAC_1 = require("./TAC");
+Object.defineProperty(exports, "TAC", { enumerable: true, get: function () { return TAC_1.TAC; } });
 var TON_1 = require("./TON");
 Object.defineProperty(exports, "TON", { enumerable: true, get: function () { return TON_1.TON; } });

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, insufficientFeeParamsError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, prefixError, profilingFetchError, simulationFetchError, statusFetchError, tvmAddressError, txFinalizationError, unknownTokenTypeError, unknownWalletError, unsupportedFormatError, unsupportedKeyError, zeroRawAmountError, } from './instances';
+export { allEndpointsFailedError, blockGasLimitFetchError, emptyArrayError, emptyContractError, emptySettingError, estimatedGasExceedsBlockGasLimitError, evmAddressError, executedInTONStageFailedError, gasPriceFetchError, indexRequiredError, insufficientBalanceError, insufficientFeeParamsError, invalidMethodNameError, missingDecimals, missingFeeParamsError, missingGasLimitError, missingJettonDataError, missingTvmExecutorFeeError, notMultiplyOf8Error, operationFetchError, operationIdRequiredForFinalizationError, 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.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;
+exports.zeroRawAmountError = exports.unsupportedKeyError = exports.unsupportedFormatError = exports.unknownWalletError = exports.unknownTokenTypeError = exports.txFinalizationError = exports.tvmAddressError = exports.statusFetchError = exports.simulationFetchError = exports.profilingFetchError = exports.prefixError = exports.operationIdRequiredForFinalizationError = exports.operationFetchError = exports.notMultiplyOf8Error = exports.missingTvmExecutorFeeError = exports.missingJettonDataError = exports.missingGasLimitError = exports.missingFeeParamsError = exports.missingDecimals = exports.invalidMethodNameError = exports.insufficientFeeParamsError = exports.insufficientBalanceError = exports.indexRequiredError = exports.gasPriceFetchError = exports.executedInTONStageFailedError = exports.evmAddressError = exports.estimatedGasExceedsBlockGasLimitError = exports.emptySettingError = exports.emptyContractError = exports.emptyArrayError = exports.blockGasLimitFetchError = 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; } });
@@ -16,10 +16,14 @@ Object.defineProperty(exports, "TransactionError", { enumerable: true, get: func
 Object.defineProperty(exports, "WalletError", { enumerable: true, get: function () { return errors_1.WalletError; } });
 var instances_1 = require("./instances");
 Object.defineProperty(exports, "allEndpointsFailedError", { enumerable: true, get: function () { return instances_1.allEndpointsFailedError; } });
+Object.defineProperty(exports, "blockGasLimitFetchError", { enumerable: true, get: function () { return instances_1.blockGasLimitFetchError; } });
 Object.defineProperty(exports, "emptyArrayError", { enumerable: true, get: function () { return instances_1.emptyArrayError; } });
 Object.defineProperty(exports, "emptyContractError", { enumerable: true, get: function () { return instances_1.emptyContractError; } });
 Object.defineProperty(exports, "emptySettingError", { enumerable: true, get: function () { return instances_1.emptySettingError; } });
+Object.defineProperty(exports, "estimatedGasExceedsBlockGasLimitError", { enumerable: true, get: function () { return instances_1.estimatedGasExceedsBlockGasLimitError; } });
 Object.defineProperty(exports, "evmAddressError", { enumerable: true, get: function () { return instances_1.evmAddressError; } });
+Object.defineProperty(exports, "executedInTONStageFailedError", { enumerable: true, get: function () { return instances_1.executedInTONStageFailedError; } });
+Object.defineProperty(exports, "gasPriceFetchError", { enumerable: true, get: function () { return instances_1.gasPriceFetchError; } });
 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; } });
@@ -31,6 +35,7 @@ Object.defineProperty(exports, "missingJettonDataError", { enumerable: true, get
 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, "operationIdRequiredForFinalizationError", { enumerable: true, get: function () { return instances_1.operationIdRequiredForFinalizationError; } });
 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, "simulationFetchError", { enumerable: true, get: function () { return instances_1.simulationFetchError; } });

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

@@ -37,3 +37,7 @@ 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;
+export declare const operationIdRequiredForFinalizationError: TransactionError;
+export declare const executedInTONStageFailedError: TransactionError;
+export declare const blockGasLimitFetchError: (msg: string, inner?: unknown) => FetchError;
+export declare const estimatedGasExceedsBlockGasLimitError: (txName: string, estimatedGas: bigint, blockGasLimit: bigint) => TransactionError;

package/dist/src/errors/instances.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.estimatedGasExceedsBlockGasLimitError = exports.blockGasLimitFetchError = exports.executedInTONStageFailedError = exports.operationIdRequiredForFinalizationError = 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);
@@ -121,3 +121,9 @@ const txFinalizationError = (msg) => new errors_1.TransactionError(`Transaction
 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;
+exports.operationIdRequiredForFinalizationError = new errors_1.TransactionError('Operation ID is required to wait for operation finalization', 137);
+exports.executedInTONStageFailedError = new errors_1.TransactionError('executedInTON stage failed', 138);
+const blockGasLimitFetchError = (msg, inner) => new errors_1.FetchError(`Failed to fetch latest block gas limit: ${msg}`, 139, inner);
+exports.blockGasLimitFetchError = blockGasLimitFetchError;
+const estimatedGasExceedsBlockGasLimitError = (txName, estimatedGas, blockGasLimit) => new errors_1.TransactionError(`Estimated gas for ${txName} (${estimatedGas}) exceeds current TAC block gas limit (${blockGasLimit})`, 140);
+exports.estimatedGasExceedsBlockGasLimitError = estimatedGasExceedsBlockGasLimitError;

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

@@ -1,5 +1,5 @@
 import type { Cell } from '@ton/ton';
-import { AssetType, GeneratePayloadParams, Origin } from '../structs/Struct';
+import { AssetType, BlockchainType, GeneratePayloadParams, Origin } from '../structs/Struct';
 export interface Asset {
     address: string;
     type: AssetType;
@@ -64,14 +64,19 @@ export interface Asset {
     /**
      * 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).
-     * @param userAddress TVM address of the user attempting to transfer the asset.
+     * @param userAddress User address on the selected blockchain.
+     * @param blockchainType Blockchain where the transferability should be checked. Defaults to TON.
      * @returns Promise that resolves if transfer is allowed; rejects with an error otherwise.
      */
-    checkCanBeTransferredBy(userAddress: string): Promise<void>;
+    checkCanBeTransferredBy(userAddress: string, blockchainType?: BlockchainType): Promise<void>;
     /**
-     * Retrieves the current balance of this asset for the given user address.
-     * @param userAddress TVM address of the user.
+     * Retrieves the current balance of this asset for the given user address on the selected blockchain.
+     * For NFTs, implementations should return 1n when the user owns the token and 0n otherwise.
+     * Implementations must validate the address format according to the selected blockchain:
+     * TVM address for TON, EVM address for TAC.
+     * @param userAddress User address on the selected blockchain.
+     * @param blockchainType Blockchain where the balance should be read. Defaults to TON.
      * @returns Promise that resolves to the balance in raw base units (bigint).
      */
-    getBalanceOf(userAddress: string): Promise<bigint>;
+    getBalanceOf(userAddress: string, blockchainType?: BlockchainType): Promise<bigint>;
 }

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

@@ -14,9 +14,7 @@ export interface IConfiguration {
     readonly liteSequencerEndpoints: string[];
     /** Native TON coin master address for the configured network. */
     readonly nativeTONAddress: string;
-    /**
-     * Returns the native TAC token (Jetton master) address for the configured network.
-     */
+    /** Returns the native TAC coin address on the TAC chain for the configured network. */
     nativeTACAddress(): Promise<string>;
     /** Whitelisted EVM (TAC) executor addresses considered trusted. */
     readonly getTrustedTACExecutors: string[];

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

@@ -1,7 +1,9 @@
-import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
+import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, OperationTypeV2Info, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
 export interface ILiteSequencerClient {
     /** Retrieves the operation type by id. */
     getOperationType(operationId: string): Promise<OperationType>;
+    /** Retrieves the v2 operation route/finalization state by id. */
+    getOperationTypeV2(operationId: string): Promise<OperationTypeV2Info>;
     /** Resolves operation id by a transaction linker. */
     getOperationId(transactionLinker: TransactionLinker): Promise<string>;
     /** Resolves operation id by the originating transaction hash. */
@@ -19,6 +21,12 @@ export interface ILiteSequencerClient {
      * @param chunkSize Optional batching size.
      */
     getStageProfilings(operationIds: string[], chunkSize?: number): Promise<ExecutionStagesByOperationId>;
+    /**
+     * Fetches stage profiling v2 data for a set of operation ids.
+     * @param operationIds Operation ids to get profiling for.
+     * @param chunkSize Optional batching size.
+     */
+    getStageProfilingsV2(operationIds: string[], chunkSize?: number): Promise<ExecutionStagesV2ByOperationId>;
     /**
      * Fetches statuses for a set of operation ids.
      * @param operationIds Operation ids to get statuses for.

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

@@ -1,4 +1,4 @@
-import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStages, ExecutionStagesByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, SimplifiedStatuses, StatusInfo, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker, WaitOptions } from '../structs/Struct';
+import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStages, ExecutionStagesByOperationId, ExecutionStagesV2, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, OperationTypeV2Info, SimplifiedStatuses, StatusInfo, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker, WaitOptions } from '../structs/Struct';
 export interface IOperationTracker {
     /**
      * Returns the operation type for the given id, optionally waiting according to the provided policy.
@@ -6,6 +6,12 @@ export interface IOperationTracker {
      * @param waitOptions Optional waiting and polling settings. Pass `null` to disable retries and use a single attempt.
      */
     getOperationType(operationId: string, waitOptions?: WaitOptions<OperationType> | null): Promise<OperationType>;
+    /**
+     * Returns the v2 operation route and finalized flag for the given id.
+     * @param operationId Operation identifier.
+     * @param waitOptions Optional waiting and polling settings. Pass `null` to disable retries and use a single attempt.
+     */
+    getOperationTypeV2(operationId: string, waitOptions?: WaitOptions<OperationTypeV2Info> | null): Promise<OperationTypeV2Info>;
     /**
      * Resolves an operation id for the given transaction linker, optionally waiting until available.
      * @param transactionLinker Reference to originating transaction across chains.
@@ -39,6 +45,19 @@ export interface IOperationTracker {
      * @param chunkSize Optional batching size for requests.
      */
     getStageProfilings(operationIds: string[], waitOptions?: WaitOptions<ExecutionStagesByOperationId> | null, chunkSize?: number): Promise<ExecutionStagesByOperationId>;
+    /**
+     * Gets detailed v2 stage profiling for a single operation, including finalized/status/rollback fields.
+     * @param operationId Operation identifier.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
+     */
+    getStageProfilingV2(operationId: string, waitOptions?: WaitOptions<ExecutionStagesV2> | null): Promise<ExecutionStagesV2>;
+    /**
+     * Gets v2 stage profiling for multiple operations in bulk.
+     * @param operationIds Operation identifiers.
+     * @param waitOptions Optional waiting settings. Pass `null` to disable retries and use a single attempt.
+     * @param chunkSize Optional batching size for requests.
+     */
+    getStageProfilingsV2(operationIds: string[], waitOptions?: WaitOptions<ExecutionStagesV2ByOperationId> | null, chunkSize?: number): Promise<ExecutionStagesV2ByOperationId>;
     /**
      * Gets statuses for multiple operations.
      * @param operationIds Operation identifiers.

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

@@ -1,15 +1,33 @@
 import { Wallet } from 'ethers';
+import { BridgeTokensToTONOptions, TACCrossChainTransactionResult } from '../structs/Struct';
 import { Asset } from './Asset';
 export interface ITACTransactionManager {
+    /**
+     * Sends a single TAC -> TON cross-chain transaction and optionally waits for operation tracking data.
+     * Native TAC amount is bridged separately from required bridge fees. This high-level method
+     * performs production-oriented TAC prechecks: requires EIP-1559 fee data from the TAC provider,
+     * optionally validates balances / ownership of non-native TAC assets, uses provider gas estimates as-is,
+     * validates those estimates against the latest TAC block gas limit,
+     * computes the worst-case upfront TAC balance requirement, and then submits approvals plus the bridge message.
+     * @param signer Ethers Wallet used to sign EVM transaction.
+     * @param tonTarget Recipient TVM address on TON.
+     * @param assets Optional list of TAC assets to include. Native TAC should be passed here as a TAC asset.
+     * @param options Optional bridge configuration object.
+     * @returns TAC transaction hash and optional operationId.
+     */
+    sendCrossChainTransactionToTON(signer: Wallet, tonTarget: string, assets?: Asset[], options?: BridgeTokensToTONOptions): Promise<TACCrossChainTransactionResult>;
     /**
      * Bridges native EVM value and optional assets to TON chain via executor.
+     * This is a low-level send-only method: it approves assets, sends the TAC -> TON message and
+     * returns the TAC transaction hash. It does not perform provider-backed TAC fee / gas-limit
+     * prechecks or TAC balance sufficiency validation; use sendCrossChainTransactionToTON for that flow.
      * @param signer Ethers Wallet used to sign EVM transaction.
      * @param value Amount of native EVM currency (wei as bigint).
      * @param tonTarget Recipient TVM address on TON.
      * @param assets Optional list of TAC assets to include.
      * @param tvmExecutorFee Optional explicit TON-side executor fee.
      * @param tvmValidExecutors Optional whitelist of allowed TVM executors.
-     * @returns EVM transaction hash or bridge identifier.
+     * @returns EVM transaction hash.
      */
     bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: Asset[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
 }

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

@@ -1,8 +1,8 @@
 import { Wallet } from 'ethers';
 import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
-import { FT, NFT } from '../assets';
+import { FT, NFT, TAC, TON } from '../assets';
 import type { SenderAbstraction } from '../sender';
-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 { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, BridgeTokensToTONOptions, CrossChainPayloadResult, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TACCrossChainTransactionResult, TacGasPrice, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 import { Asset } from './Asset';
 import { ContractOpener } from './ContractOpener';
 import { IConfiguration } from './IConfiguration';
@@ -35,16 +35,17 @@ export interface ITacSDK {
     closeConnections(): unknown;
     /**
      * Creates a typed asset wrapper instance based on provided arguments.
-     * Pass FT, NFT collection or NFT item parameters; the returned type will match the input.
+     * Pass FT, NFT collection or NFT item parameters.
+     * FT inputs may resolve to FT, TON, or TAC for native assets.
      * @param args Parameters that describe the asset to wrap (FT/NFT collection/NFT item).
      * @returns Promise resolving to a generic Asset. Use overloads for stronger typing.
      */
     getAsset(args: AssetFromFTArg | AssetFromNFTCollectionArg | AssetFromNFTItemArg): Promise<Asset>;
-    getAsset(args: AssetFromFTArg): Promise<FT>;
+    getAsset(args: AssetFromFTArg): Promise<FT | TAC | TON>;
     getAsset(args: AssetFromNFTCollectionArg): Promise<NFT>;
     getAsset(args: AssetFromNFTItemArg): Promise<NFT>;
     /**
-     * Returns a fungible token (Jetton) asset wrapper by its TVM or EVM address.
+     * Returns a fungible asset wrapper by its TVM or EVM address.
      * @param address TVM or EVM token address.
      * @returns Promise resolving to an FT wrapper.
      */
@@ -92,10 +93,27 @@ export interface ITacSDK {
      * @param sender Sender abstraction responsible for signing/sending TVM messages.
      * @param assets Optional list of assets to attach to the cross-chain message.
      * @param options Optional cross-chain options (fees, executors, extra data, etc.).
-     * @param waitOptions Optional waiting policy for operation id resolution.
+     * Includes operationId wait options and full-operation finalization controls.
+     * Finalization waiting is enabled by default and performs profiling resolution plus
+     * TON transaction tree validation for EXECUTED_IN_TON transactions when they exist.
      * @returns Promise with a TransactionLinkerWithOperationId to track the operation across chains.
      */
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions, waitOptions?: WaitOptions<string>): Promise<TransactionLinkerWithOperationId>;
+    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<TransactionLinkerWithOperationId>;
+    /**
+     * Sends a single TAC -> TON cross-chain transaction and optionally waits for operation tracking information.
+     * Native TAC should be passed as a TAC asset in `assets`; there is no separate `value` argument.
+     * The sender must still have enough extra TAC balance to pay bridge fees and TAC gas on top of
+     * the bridged native TAC amount. The SDK requires EIP-1559 fee data from the TAC provider, can
+     * validate balances / ownership of non-native TAC assets, uses provider gas estimates as-is,
+     * validates those estimates against the latest TAC block gas limit,
+     * computes the worst-case upfront TAC balance requirement, and only then submits the TAC transactions.
+     * @param signer Ethers Wallet used to sign EVM transaction on TAC side.
+     * @param tonTarget Recipient TVM address on TON.
+     * @param assets Optional list of TAC assets to include in the bridge transaction.
+     * @param options Optional TAC -> TON bridge configuration.
+     * @returns Promise with TAC transaction hash and optional operationId.
+     */
+    sendCrossChainTransactionToTON(signer: Wallet, tonTarget: string, assets?: AssetLike[], options?: BridgeTokensToTONOptions): Promise<TACCrossChainTransactionResult>;
     /**
      * Sends multiple cross-chain transactions in one batch and optionally waits for tracking info.
      * @param sender Sender abstraction for signing/sending TVM messages.
@@ -106,13 +124,16 @@ export interface ITacSDK {
     sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTxWithAssetLike[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
     /**
      * Bridges tokens/value from EVM to TON chain via the executor.
+     * This is a low-level send-only method. It prepares the TAC -> TON message, performs approvals,
+     * submits the TAC transaction and returns its hash. It does not run the provider-backed TAC
+     * fee / gas-limit checks and balance prechecks performed by sendCrossChainTransactionToTON.
      * @param signer Ethers Wallet used to sign the EVM-side transaction.
      * @param value Amount of native EVM currency to bridge (in wei as bigint).
      * @param tonTarget Recipient TVM address on TON.
      * @param assets Optional list of TAC assets to include for the bridge.
      * @param tvmExecutorFee Optional explicit TON-side executor fee.
      * @param tvmValidExecutors Optional whitelist of allowed TVM executors.
-     * @returns Promise resolving to the EVM transaction hash or bridge identifier.
+     * @returns Promise resolving to the EVM transaction hash.
      */
     bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: AssetLike[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
     /**

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

@@ -30,4 +30,8 @@ export declare const DEFAULT_RETRY_ON_NOT_FOUND = true;
 export declare const DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = 10;
 export declare const DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS = 5000;
 export declare const IGNORE_MSG_VALUE_1_NANO = 1n;
+export declare const CROSS_CHAIN_MESSAGE_VERSION_V1 = 1n;
+export declare const NFT_BRIDGE_AMOUNT = 1n;
+export declare const DEFAULT_EIP1559_PRIORITY_FEE = 0n;
+export declare const SHARDS_KEY_RANDOM_RANGE = 1000000000000000000;
 export declare const IGNORE_OPCODE: number[];

package/dist/src/sdk/Consts.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IGNORE_OPCODE = exports.IGNORE_MSG_VALUE_1_NANO = exports.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS = exports.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = exports.DEFAULT_RETRY_ON_NOT_FOUND = exports.DEFAULT_FIND_TX_MAX_DEPTH = exports.DEFAULT_FIND_TX_ARCHIVAL = exports.DEFAULT_MAX_SCANNED_TRANSACTIONS = exports.DEFAULT_FIND_TX_LIMIT = exports.DEFAULT_WAIT_DELAY_MS = exports.DEFAULT_WAIT_MAX_ATTEMPTS = exports.DEFAULT_WAIT_TIMEOUT_MS = exports.DEFAULT_RETRY_DELAY_MS = exports.DEFAULT_RETRY_MAX_COUNT = exports.DEFAULT_HTTP_CLIENT_TIMEOUT_MS = exports.TON_BURN_ADDRESS = exports.MINUTE = exports.FIVE_MINUTES = exports.TAC_DECIMALS = exports.TON_DECIMALS = exports.ONE_YEAR_SECONDS = exports.FIFTEEN_MINUTES = exports.TAC_SYMBOL = exports.TON_SYMBOL = exports.MAX_MSG_DEPTH = exports.MAX_HIGHLOAD_GROUP_MSG_NUM = exports.MAX_EXT_MSG_SIZE = exports.SOLIDITY_METHOD_NAME_REGEX = exports.SOLIDITY_SIGNATURE_REGEX = exports.DEFAULT_DELAY = exports.MAX_ITERATION_COUNT = exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = void 0;
+exports.IGNORE_OPCODE = exports.SHARDS_KEY_RANDOM_RANGE = exports.DEFAULT_EIP1559_PRIORITY_FEE = exports.NFT_BRIDGE_AMOUNT = exports.CROSS_CHAIN_MESSAGE_VERSION_V1 = exports.IGNORE_MSG_VALUE_1_NANO = exports.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS = exports.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = exports.DEFAULT_RETRY_ON_NOT_FOUND = exports.DEFAULT_FIND_TX_MAX_DEPTH = exports.DEFAULT_FIND_TX_ARCHIVAL = exports.DEFAULT_MAX_SCANNED_TRANSACTIONS = exports.DEFAULT_FIND_TX_LIMIT = exports.DEFAULT_WAIT_DELAY_MS = exports.DEFAULT_WAIT_MAX_ATTEMPTS = exports.DEFAULT_WAIT_TIMEOUT_MS = exports.DEFAULT_RETRY_DELAY_MS = exports.DEFAULT_RETRY_MAX_COUNT = exports.DEFAULT_HTTP_CLIENT_TIMEOUT_MS = exports.TON_BURN_ADDRESS = exports.MINUTE = exports.FIVE_MINUTES = exports.TAC_DECIMALS = exports.TON_DECIMALS = exports.ONE_YEAR_SECONDS = exports.FIFTEEN_MINUTES = exports.TAC_SYMBOL = exports.TON_SYMBOL = exports.MAX_MSG_DEPTH = exports.MAX_HIGHLOAD_GROUP_MSG_NUM = exports.MAX_EXT_MSG_SIZE = exports.SOLIDITY_METHOD_NAME_REGEX = exports.SOLIDITY_SIGNATURE_REGEX = exports.DEFAULT_DELAY = exports.MAX_ITERATION_COUNT = exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = void 0;
 const ton_1 = require("@ton/ton");
 exports.JETTON_TRANSFER_FORWARD_TON_AMOUNT = (0, ton_1.toNano)(0.2);
 exports.NFT_TRANSFER_FORWARD_TON_AMOUNT = (0, ton_1.toNano)(0.3);
@@ -34,6 +34,10 @@ exports.DEFAULT_RETRY_ON_NOT_FOUND = true;
 exports.DEFAULT_RETRY_ON_NOT_FOUND_RETRIES = 10;
 exports.DEFAULT_RETRY_ON_NOT_FOUND_DELAY_MS = 5000;
 exports.IGNORE_MSG_VALUE_1_NANO = 1n;
+exports.CROSS_CHAIN_MESSAGE_VERSION_V1 = 1n;
+exports.NFT_BRIDGE_AMOUNT = 1n;
+exports.DEFAULT_EIP1559_PRIORITY_FEE = 0n;
+exports.SHARDS_KEY_RANDOM_RANGE = 1e18;
 exports.IGNORE_OPCODE = [
     0xd53276db, // Excess
 ];

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

@@ -1,5 +1,5 @@
 import { IHttpClient, ILiteSequencerClient } from '../interfaces';
-import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
+import { ConvertCurrencyParams, ConvertedCurrencyResult, ExecutionStagesByOperationId, ExecutionStagesV2ByOperationId, GetTVMExecutorFeeParams, OperationIdsByShardsKey, OperationType, OperationTypeV2Info, StatusInfosByOperationId, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinker } from '../structs/Struct';
 export declare class LiteSequencerClient implements ILiteSequencerClient {
     private readonly endpoint;
     private readonly maxChunkSize;
@@ -8,9 +8,11 @@ export declare class LiteSequencerClient implements ILiteSequencerClient {
     private getRequestLabel;
     getOperationIdByTransactionHash(transactionHash: string): Promise<string>;
     getOperationType(operationId: string): Promise<OperationType>;
+    getOperationTypeV2(operationId: string): Promise<OperationTypeV2Info>;
     getOperationId(transactionLinker: TransactionLinker): Promise<string>;
     getOperationIdsByShardsKeys(shardsKeys: string[], caller: string, chunkSize?: number): Promise<OperationIdsByShardsKey>;
     getStageProfilings(operationIds: string[], chunkSize?: number): Promise<ExecutionStagesByOperationId>;
+    getStageProfilingsV2(operationIds: string[], chunkSize?: number): Promise<ExecutionStagesV2ByOperationId>;
     getOperationStatuses(operationIds: string[], chunkSize?: number): Promise<StatusInfosByOperationId>;
     convertCurrency(params: ConvertCurrencyParams): Promise<ConvertedCurrencyResult>;
     simulateTACMessage(params: TACSimulationParams): Promise<TACSimulationResult>;