@tonappchain/sdk 0.7.0-rc9 → 0.7.1

package/dist/{index.js → src/index.js}

@@ -10,15 +10,42 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 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);
 };
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 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.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; } });
+exports.TONTransactionManager = exports.TACTransactionManager = exports.TacSdk = exports.startTrackingMultiple = exports.startTracking = exports.Simulator = exports.OperationTracker = exports.NoopLogger = exports.ConsoleLogger = exports.LiteSequencerClient = exports.Configuration = exports.AxiosHttpClient = exports.AgnosticStructs = exports.AgnosticProxySDK = void 0;
+__exportStar(require("./adapters"), exports);
+var AgnosticSdk_1 = require("./agnosticSdk/AgnosticSdk");
+Object.defineProperty(exports, "AgnosticProxySDK", { enumerable: true, get: function () { return AgnosticSdk_1.AgnosticProxySDK; } });
+exports.AgnosticStructs = __importStar(require("./agnosticSdk/AgnosticStructs"));
+__exportStar(require("./assets"), exports);
 __exportStar(require("./errors"), exports);
+__exportStar(require("./interfaces"), exports);
+var AxiosHttpClient_1 = require("./sdk/AxiosHttpClient");
+Object.defineProperty(exports, "AxiosHttpClient", { enumerable: true, get: function () { return AxiosHttpClient_1.AxiosHttpClient; } });
 var Configuration_1 = require("./sdk/Configuration");
 Object.defineProperty(exports, "Configuration", { enumerable: true, get: function () { return Configuration_1.Configuration; } });
 var LiteSequencerClient_1 = require("./sdk/LiteSequencerClient");
@@ -35,19 +62,12 @@ 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 TACTransactionManager_1 = require("./sdk/TACTransactionManager");
+Object.defineProperty(exports, "TACTransactionManager", { enumerable: true, get: function () { return TACTransactionManager_1.TACTransactionManager; } });
+var TONTransactionManager_1 = require("./sdk/TONTransactionManager");
+Object.defineProperty(exports, "TONTransactionManager", { enumerable: true, get: function () { return TONTransactionManager_1.TONTransactionManager; } });
 __exportStar(require("./sender"), exports);
-__exportStar(require("./structs/Services"), exports);
 __exportStar(require("./structs/Struct"), exports);
-var Struct_1 = require("./structs/Struct");
-Object.defineProperty(exports, "Network", { enumerable: true, get: function () { return Struct_1.Network; } });
-Object.defineProperty(exports, "SimplifiedStatuses", { enumerable: true, get: function () { return Struct_1.SimplifiedStatuses; } });
-__exportStar(require("./assets"), exports);
-var ContentUtils_1 = require("./wrappers/ContentUtils");
-Object.defineProperty(exports, "readJettonMetadata", { enumerable: true, get: function () { return ContentUtils_1.readJettonMetadata; } });
-var HighloadWalletV3_1 = require("./wrappers/HighloadWalletV3");
-Object.defineProperty(exports, "HighloadWalletV3", { enumerable: true, get: function () { return HighloadWalletV3_1.HighloadWalletV3; } });
-var JettonWallet_1 = require("./wrappers/JettonWallet");
-Object.defineProperty(exports, "JettonWallet", { enumerable: true, get: function () { return JettonWallet_1.JettonWallet; } });
-Object.defineProperty(exports, "JettonWalletOpCodes", { enumerable: true, get: function () { return JettonWallet_1.JettonWalletOpCodes; } });
+__exportStar(require("./wrappers/ContentUtils"), exports);
+__exportStar(require("./wrappers/HighloadQueryId"), exports);
+__exportStar(require("./wrappers/HighloadWalletV3"), exports);

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

@@ -0,0 +1,78 @@
+import type { Cell } from '@ton/ton';
+import { AssetType, FeeParams } from '../structs/Struct';
+export interface Asset {
+    address: string;
+    type: AssetType;
+    rawAmount: bigint;
+    clone: Asset;
+    /**
+     * Returns a new asset instance with the specified transfer amount in human-readable units.
+     * 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 reflecting the requested amount.
+     */
+    withAmount(amount: number): Asset;
+    /**
+     * Returns a new asset instance with the specified transfer amount in raw base units.
+     * Does not mutate the current asset instance.
+     * @param rawAmount Amount in raw base units (bigint).
+     * @returns A new Asset reflecting the requested raw amount.
+     */
+    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.
+     * @returns Promise that resolves to the EVM address as a checksum string.
+     */
+    getEVMAddress(): Promise<string>;
+    /**
+     * Returns the TVM (TON Virtual Machine) address for this asset.
+     * @returns Promise that resolves to the TVM address as a friendly or raw string depending on implementation.
+     */
+    getTVMAddress(): Promise<string>;
+    /**
+     * Generates a TVM payload for transferring or interacting with this asset across chains.
+     * Implementations may include cross-chain metadata, fees, and forwarding info.
+     * @param params Parameters that describe the payload composition.
+     * @param params.excessReceiver Address that will receive the excess TON after execution.
+     * @param params.evmData Serialized EVM-side call data to be forwarded via the bridge.
+     * @param params.crossChainTonAmount Optional TON amount to transfer cross-chain with the message.
+     * @param params.forwardFeeTonAmount Optional TON amount used to cover forwarding fees on TON.
+     * @param params.feeParams Optional fee parameters to fine-tune execution costs.
+     * @returns Promise that resolves to a Cell containing the encoded payload.
+     */
+    generatePayload(params: {
+        excessReceiver: string;
+        evmData: Cell;
+        crossChainTonAmount?: bigint;
+        forwardFeeTonAmount?: bigint;
+        feeParams?: FeeParams;
+    }): Promise<Cell>;
+    /**
+     * Validates whether the specified user is allowed to transfer this asset.
+     * Implementations should throw if the transfer is not permitted (e.g., frozen asset, missing wallet, insufficient permissions).
+     * @param userAddress TVM address of the user attempting to transfer the asset.
+     * @returns Promise that resolves if transfer is allowed; rejects with an error otherwise.
+     */
+    checkCanBeTransferredBy(userAddress: string): Promise<void>;
+    /**
+     * Retrieves the current balance of this asset for the given user address.
+     * @param userAddress TVM address of the user.
+     * @returns Promise that resolves to the balance in raw base units (bigint).
+     */
+    getBalanceOf(userAddress: string): Promise<bigint>;
+}

package/dist/src/interfaces/Asset.js

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

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

@@ -0,0 +1,21 @@
+import { SandboxContract } from '@ton/sandbox';
+import type { Address, Contract, OpenedContract } from '@ton/ton';
+import { ContractState } from '../structs/Struct';
+export interface ContractOpener {
+    /**
+     * Opens a contract for interaction using the underlying client (lite client, sandbox, etc.).
+     * @param src Contract source instance to open.
+     * @returns Opened contract ready for method calls and sending messages.
+     */
+    open<T extends Contract>(src: T): OpenedContract<T> | SandboxContract<T>;
+    /**
+     * Fetches on-chain contract state for a given address.
+     * @param address TVM address of the contract.
+     * @returns Promise with the contract state (code/data/existence).
+     */
+    getContractState(address: Address): Promise<ContractState>;
+    /**
+     * Closes any underlying connections if supported by the implementation.
+     */
+    closeConnections?: () => unknown;
+}

package/dist/src/interfaces/ContractOpener.js

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

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

@@ -0,0 +1,35 @@
+import { dev, mainnet, testnet } from '../../artifacts';
+import { InternalTACParams, InternalTONParams } from '../structs/InternalStruct';
+import { Network } from '../structs/Struct';
+export interface IConfiguration {
+    /** Current network the SDK is configured for (e.g., MAINNET/TESTNET). */
+    readonly network: Network;
+    /** Resolved artifacts bundle for the selected network (contract ABIs/addresses). */
+    readonly artifacts: typeof testnet | typeof mainnet | typeof dev;
+    /** Low-level TON client parameters and dependencies. */
+    readonly TONParams: InternalTONParams;
+    /** Low-level TAC (EVM-side) client parameters and dependencies. */
+    readonly TACParams: InternalTACParams;
+    /** List of Lite Sequencer API endpoints used for tracking and utilities. */
+    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.
+     */
+    nativeTACAddress(): Promise<string>;
+    /** Whitelisted EVM (TAC) executor addresses considered trusted. */
+    readonly getTrustedTACExecutors: string[];
+    /** Whitelisted TVM (TON) executor addresses considered trusted. */
+    readonly getTrustedTONExecutors: string[];
+    /**
+     * Closes any underlying connections/resources held by configuration-level clients.
+     * Implementations should be idempotent.
+     */
+    closeConnections(): unknown;
+    /**
+     * Checks if a given TVM address is a deployed contract on the current network.
+     * @param address TVM address to verify.
+     */
+    isContractDeployedOnTVM(address: string): Promise<boolean>;
+}

package/dist/src/interfaces/IConfiguration.js

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

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

@@ -0,0 +1,16 @@
+import { AxiosRequestConfig, AxiosResponse } from 'axios';
+export interface IHttpClient {
+    /**
+     * Sends an HTTP GET request and returns a typed Axios response.
+     * @param url Target URL.
+     * @param config Optional Axios request configuration.
+     */
+    get<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    /**
+     * Sends an HTTP POST request and returns a typed Axios response.
+     * @param url Target URL.
+     * @param data Request body payload.
+     * @param config Optional Axios request configuration.
+     */
+    post<T>(url: string, data: unknown, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+}

package/dist/src/interfaces/IHttpClient.js

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

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

@@ -0,0 +1,43 @@
+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>;
+    /** Resolves operation id by a transaction linker. */
+    getOperationId(transactionLinker: TransactionLinker): Promise<string>;
+    /** Resolves operation id by the originating transaction hash. */
+    getOperationIdByTransactionHash(transactionHash: string): Promise<string>;
+    /**
+     * Resolves operation ids for multiple shard keys.
+     * @param shardsKeys Shard keys to query.
+     * @param caller Human-readable identifier of the caller (for rate limiting/observability).
+     * @param chunkSize Optional chunk size for batching requests.
+     */
+    getOperationIdsByShardsKeys(shardsKeys: string[], caller: string, chunkSize?: number): Promise<OperationIdsByShardsKey>;
+    /**
+     * Fetches stage profiling data for a set of operation ids.
+     * @param operationIds Operation ids to get profiling for.
+     * @param chunkSize Optional batching size.
+     */
+    getStageProfilings(operationIds: string[], chunkSize?: number): Promise<ExecutionStagesByOperationId>;
+    /**
+     * Fetches statuses for a set of operation ids.
+     * @param operationIds Operation ids to get statuses for.
+     * @param chunkSize Optional batching size.
+     */
+    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>;
+}

package/dist/src/interfaces/ILiteSequencerClient.js

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

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

@@ -0,0 +1,9 @@
+import { ILiteSequencerClient } from './ILiteSequencerClient';
+export interface ILiteSequencerClientFactory {
+    /**
+     * Creates Lite Sequencer clients for the provided HTTP endpoints.
+     * @param endpoints List of base URLs.
+     * @returns Array of ILiteSequencerClient instances, one per endpoint.
+     */
+    createClients(endpoints: string[]): ILiteSequencerClient[];
+}

package/dist/src/interfaces/ILiteSequencerClientFactory.js

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

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

@@ -0,0 +1,10 @@
+export interface ILogger {
+    /** Logs verbose diagnostic information useful during development. */
+    debug(...arg: unknown[]): void;
+    /** Logs general informational messages about normal operation. */
+    info(...arg: unknown[]): void;
+    /** Logs warnings about unexpected but non-fatal conditions. */
+    warn(...arg: unknown[]): void;
+    /** Logs errors for failures and exceptional conditions. */
+    error(...arg: unknown[]): void;
+}

package/dist/src/interfaces/ILogger.js

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

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

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

package/dist/src/interfaces/IOperationTracker.js

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

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

@@ -0,0 +1,18 @@
+import type { SenderAbstraction } from '../sender';
+import { CrosschainTx, ExecutionFeeEstimationResult } from '../structs/Struct';
+export interface ISimulator {
+    /**
+     * Simulates a list of cross-chain transactions for a given sender.
+     * @param sender Sender abstraction used to provide context (e.g., wallet state).
+     * @param txs Cross-chain transactions to simulate.
+     * @returns Promise with fee estimation results, one for each input transaction.
+     */
+    getSimulationsInfo(sender: SenderAbstraction, txs: CrosschainTx[]): Promise<ExecutionFeeEstimationResult[]>;
+    /**
+     * Get tvm fees and simulation info for a tvm transaction using sender abstraction.
+     * @param sender Sender abstraction used to provide context (e.g., wallet state).
+     * @param tx Cross-chain transaction to simulate.
+     * @returns Promise with fee estimation and execution info.
+     */
+    getSimulationInfo(sender: SenderAbstraction, tx: CrosschainTx): Promise<ExecutionFeeEstimationResult>;
+}

package/dist/src/interfaces/ISimulator.js

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

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

@@ -0,0 +1,15 @@
+import { Wallet } from 'ethers';
+import { Asset } from './Asset';
+export interface ITACTransactionManager {
+    /**
+     * Bridges native EVM value and optional assets to TON chain via executor.
+     * @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.
+     */
+    bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: Asset[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
+}

package/dist/src/interfaces/ITACTransactionManager.js

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

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

@@ -0,0 +1,20 @@
+import type { SenderAbstraction } from '../sender';
+import { BatchCrossChainTx, CrossChainTransactionsOptions, CrosschainTx, EvmProxyMsg, TransactionLinkerWithOperationId } from '../structs/Struct';
+export interface ITONTransactionManager {
+    /**
+     * Sends a single cross-chain transaction.
+     * @param evmProxyMsg Encoded EVM proxy message to bridge.
+     * @param sender Sender abstraction for TVM message sending.
+     * @param tx cross-chain transaction to bridge.
+     * @returns Transaction linker with operation id for tracking.
+     */
+    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx): Promise<TransactionLinkerWithOperationId>;
+    /**
+     * Sends multiple cross-chain transactions in a batch.
+     * @param sender Sender abstraction for TVM message sending.
+     * @param txs List of cross-chain transactions to bridge.
+     * @param options Optional options controlling waiting behavior for operation ids.
+     * @returns Array of transaction linkers, one per submitted transaction.
+     */
+    sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTx[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
+}

package/dist/src/interfaces/ITONTransactionManager.js

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