@tonappchain/sdk 0.7.0-rc14 → 0.7.0-rc16

package/dist/interfaces/ITransactionManager.d.ts

@@ -1,35 +0,0 @@
-import { Wallet } from 'ethers';
-import type { SenderAbstraction } from '../sender';
-import { CrossChainTransactionOptions, CrosschainTx, EvmProxyMsg, OperationIdsByShardsKey, TransactionLinkerWithOperationId, WaitOptions } from '../structs/Struct';
-import { Asset } from './Asset';
-export interface ITransactionManager {
-    /**
-     * Sends a single cross-chain transaction.
-     * @param evmProxyMsg Encoded EVM proxy message to bridge.
-     * @param sender Sender abstraction for TVM message sending.
-     * @param assets Optional assets to attach to the cross-chain message.
-     * @param options Optional cross-chain execution options (fees, executors, extra data).
-     * @param waitOptions Optional policy to wait for operation id resolution.
-     * @returns Transaction linker with operation id for tracking.
-     */
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: Asset[], options?: CrossChainTransactionOptions, waitOptions?: WaitOptions<string>): 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 broadcast.
-     * @param waitOptions Optional policy for waiting on operation ids by shard keys.
-     * @returns Array of transaction linkers, one per submitted transaction.
-     */
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTx[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
-    /**
-     * 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/sdk/TransactionManager.d.ts

@@ -1,22 +0,0 @@
-import { Cell } from '@ton/ton';
-import { Wallet } from 'ethers';
-import { Asset, IConfiguration, ILogger, IOperationTracker, ISimulator, ITransactionManager } from '../interfaces';
-import type { SenderAbstraction } from '../sender';
-import { CrossChainTransactionOptions, CrosschainTx, EvmProxyMsg, OperationIdsByShardsKey, TransactionLinker, TransactionLinkerWithOperationId, ValidExecutors, WaitOptions } from '../structs/Struct';
-export declare class TransactionManager implements ITransactionManager {
-    private readonly config;
-    private readonly simulator;
-    private readonly operationTracker;
-    private readonly logger;
-    private readonly evmDataCellBuilder;
-    constructor(config: IConfiguration, simulator: ISimulator, operationTracker: IOperationTracker, logger?: ILogger, options?: {
-        evmDataCellBuilder?: (transactionLinker: TransactionLinker, evmProxyMsg: EvmProxyMsg, validExecutors: ValidExecutors) => Cell;
-    });
-    private prepareCrossChainTransaction;
-    private generateCrossChainMessages;
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: Asset[], options?: CrossChainTransactionOptions, waitOptions?: WaitOptions<string>): Promise<TransactionLinkerWithOperationId>;
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTx[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
-    private prepareCrossChainTransactions;
-    private waitForOperationIds;
-    bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: Asset[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
-}

package/dist/sdk/TransactionManager.js

@@ -1,272 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TransactionManager = void 0;
-const assets_1 = require("../assets");
-const Struct_1 = require("../structs/Struct");
-const Consts_1 = require("./Consts");
-const Logger_1 = require("./Logger");
-const Utils_1 = require("./Utils");
-const Validator_1 = require("./Validator");
-class TransactionManager {
-    constructor(config, simulator, operationTracker, logger = new Logger_1.NoopLogger(), options) {
-        this.config = config;
-        this.simulator = simulator;
-        this.operationTracker = operationTracker;
-        this.logger = logger;
-        this.evmDataCellBuilder = options?.evmDataCellBuilder ?? Utils_1.buildEvmDataCell;
-    }
-    async prepareCrossChainTransaction(evmProxyMsg, caller, assets, options) {
-        this.logger.debug('Preparing cross-chain transaction');
-        const { allowSimulationError = false, isRoundTrip = undefined, protocolFee = undefined, evmExecutorFee = undefined, tvmExecutorFee = undefined, calculateRollbackFee = true, } = options || {};
-        let { evmValidExecutors = [], tvmValidExecutors = [] } = options || {};
-        Validator_1.Validator.validateEVMAddress(evmProxyMsg.evmTargetAddress);
-        Validator_1.Validator.validateEVMAddresses(options?.evmValidExecutors);
-        Validator_1.Validator.validateTVMAddresses(options?.tvmValidExecutors);
-        const aggregatedData = await (0, Utils_1.aggregateTokens)(assets);
-        await Promise.all(aggregatedData.jettons.map((jetton) => jetton.checkCanBeTransferredBy(caller)));
-        await Promise.all(aggregatedData.nfts.map((nft) => nft.checkCanBeTransferredBy(caller)));
-        await aggregatedData.ton?.checkCanBeTransferredBy(caller);
-        const tokensLength = aggregatedData.jettons.length + aggregatedData.nfts.length;
-        this.logger.debug(`Tokens length: ${tokensLength}`);
-        const transactionLinkerShardCount = tokensLength == 0 ? 1 : tokensLength;
-        this.logger.debug(`Transaction linker shard count: ${transactionLinkerShardCount}`);
-        const transactionLinker = (0, Utils_1.generateTransactionLinker)(caller, transactionLinkerShardCount);
-        this.logger.debug(`Generated transaction linker: ${(0, Utils_1.formatObjectForLogging)(transactionLinker)}`);
-        if (evmValidExecutors.length == 0) {
-            evmValidExecutors = this.config.getTrustedTACExecutors;
-        }
-        if (tvmValidExecutors.length == 0) {
-            tvmValidExecutors = this.config.getTrustedTONExecutors;
-        }
-        const { feeParams } = await this.simulator.getSimulationInfoForTransaction(evmProxyMsg, transactionLinker, assets ?? [], allowSimulationError, isRoundTrip, evmValidExecutors, tvmValidExecutors, calculateRollbackFee);
-        if (evmProxyMsg.gasLimit == undefined) {
-            evmProxyMsg.gasLimit = feeParams.gasLimit;
-        }
-        if (evmExecutorFee != undefined) {
-            feeParams.evmExecutorFee = evmExecutorFee;
-        }
-        if (feeParams.isRoundTrip && tvmExecutorFee != undefined) {
-            feeParams.tvmExecutorFee = tvmExecutorFee;
-        }
-        if (protocolFee != undefined) {
-            feeParams.protocolFee = protocolFee;
-        }
-        this.logger.debug(`Resulting fee params: ${(0, Utils_1.formatObjectForLogging)(feeParams)}`);
-        const validExecutors = {
-            tac: evmValidExecutors,
-            ton: tvmValidExecutors,
-        };
-        this.logger.debug(`Valid executors: ${(0, Utils_1.formatObjectForLogging)(validExecutors)}`);
-        const evmData = this.evmDataCellBuilder(transactionLinker, evmProxyMsg, validExecutors);
-        const messages = await this.generateCrossChainMessages(caller, evmData, aggregatedData, feeParams);
-        const transaction = {
-            validUntil: +new Date() + 15 * 60 * 1000,
-            messages,
-            network: this.config.network,
-        };
-        this.logger.debug('Transaction prepared');
-        return { transaction, transactionLinker };
-    }
-    async generateCrossChainMessages(caller, evmData, aggregatedData, feeParams) {
-        this.logger.debug(`Generating cross-chain messages`);
-        const { jettons, nfts, ton = assets_1.TON.create(this.config) } = aggregatedData;
-        let crossChainTonAmount = ton.rawAmount;
-        let feeTonAmount = feeParams.protocolFee + feeParams.evmExecutorFee + feeParams.tvmExecutorFee;
-        this.logger.debug(`Crosschain ton amount: ${crossChainTonAmount}`);
-        this.logger.debug(`Fee ton amount: ${feeTonAmount}`);
-        if (jettons.length == 0 && nfts.length == 0) {
-            return [
-                {
-                    address: this.config.TONParams.crossChainLayerAddress,
-                    value: crossChainTonAmount + feeTonAmount + Consts_1.TRANSACTION_TON_AMOUNT,
-                    payload: await ton.generatePayload({
-                        excessReceiver: caller,
-                        evmData,
-                        feeParams,
-                    }),
-                },
-            ];
-        }
-        const messages = [];
-        let currentFeeParams = feeParams;
-        for (const jetton of aggregatedData.jettons) {
-            const payload = await jetton.generatePayload({
-                excessReceiver: caller,
-                evmData,
-                crossChainTonAmount,
-                forwardFeeTonAmount: feeTonAmount,
-                feeParams: currentFeeParams,
-            });
-            const jettonWalletAddress = await jetton.getUserWalletAddress(caller);
-            messages.push({
-                address: jettonWalletAddress,
-                value: crossChainTonAmount + feeTonAmount + Consts_1.TRANSACTION_TON_AMOUNT,
-                payload,
-            });
-            crossChainTonAmount = 0n;
-            feeTonAmount = 0n;
-            currentFeeParams = undefined;
-        }
-        for (const nft of aggregatedData.nfts) {
-            const payload = await nft.generatePayload({
-                excessReceiver: caller,
-                evmData,
-                crossChainTonAmount,
-                forwardFeeTonAmount: feeTonAmount,
-                feeParams: currentFeeParams,
-            });
-            messages.push({
-                address: nft.address,
-                value: crossChainTonAmount + feeTonAmount + Consts_1.TRANSACTION_TON_AMOUNT,
-                payload,
-            });
-            crossChainTonAmount = 0n;
-            feeTonAmount = 0n;
-            currentFeeParams = undefined;
-        }
-        this.logger.debug('Generating cross-chain messages success');
-        return messages;
-    }
-    async sendCrossChainTransaction(evmProxyMsg, sender, assets, options, waitOptions) {
-        const caller = sender.getSenderAddress();
-        this.logger.debug(`Caller: ${caller}`);
-        const { transaction, transactionLinker } = await this.prepareCrossChainTransaction(evmProxyMsg, caller, assets, options);
-        await assets_1.TON.checkBalance(sender, this.config, [transaction]);
-        this.logger.debug(`*****Sending transaction: ${(0, Utils_1.formatObjectForLogging)(transaction)}`);
-        const sendTransactionResult = await sender.sendShardTransaction(transaction, this.config.network, this.config.TONParams.contractOpener);
-        return waitOptions
-            ? {
-                sendTransactionResult,
-                operationId: await this.operationTracker
-                    .getOperationId(transactionLinker, {
-                    ...waitOptions,
-                    successCheck: (operationId) => !!operationId,
-                    logger: this.logger,
-                })
-                    .catch((error) => {
-                    this.logger.error(`Error while waiting for operation ID: ${error}`);
-                    return undefined;
-                }),
-                ...transactionLinker,
-            }
-            : { sendTransactionResult, ...transactionLinker };
-    }
-    async sendCrossChainTransactions(sender, txs, waitOptions) {
-        const caller = sender.getSenderAddress();
-        this.logger.debug(`Caller: ${caller}`);
-        this.logger.debug('Preparing multiple cross-chain transactions');
-        const { transactions, transactionLinkers } = await this.prepareCrossChainTransactions(txs, caller);
-        await assets_1.TON.checkBalance(sender, this.config, transactions);
-        this.logger.debug(`*****Sending transactions: ${(0, Utils_1.formatObjectForLogging)(transactions)}`);
-        await sender.sendShardTransactions(transactions, this.config.network, this.config.TONParams.contractOpener);
-        if (!waitOptions) {
-            return transactionLinkers;
-        }
-        return await this.waitForOperationIds(transactionLinkers, caller, waitOptions);
-    }
-    async prepareCrossChainTransactions(txs, caller) {
-        const transactions = [];
-        const transactionLinkers = [];
-        for (const { options, assets, evmProxyMsg } of txs) {
-            const { transaction, transactionLinker } = await this.prepareCrossChainTransaction(evmProxyMsg, caller, assets, options);
-            transactions.push(transaction);
-            transactionLinkers.push(transactionLinker);
-        }
-        return { transactions, transactionLinkers };
-    }
-    async waitForOperationIds(transactionLinkers, caller, waitOptions) {
-        this.logger.debug(`Waiting for operation IDs`);
-        try {
-            const operationIds = await this.operationTracker.getOperationIdsByShardsKeys(transactionLinkers.map((linker) => linker.shardsKey), caller, {
-                ...waitOptions,
-                logger: this.logger,
-                successCheck: (operationIds) => Object.keys(operationIds).length == transactionLinkers.length &&
-                    Object.values(operationIds).every((ids) => ids.operationIds.length > 0),
-            });
-            this.logger.debug(`Operation IDs: ${(0, Utils_1.formatObjectForLogging)(operationIds)}`);
-            return transactionLinkers.map((linker) => ({
-                ...linker,
-                operationId: operationIds[linker.shardsKey].operationIds.at(0),
-            }));
-        }
-        catch (error) {
-            this.logger.error(`Error while waiting for operation IDs: ${error}`);
-            return transactionLinkers;
-        }
-    }
-    async bridgeTokensToTON(signer, value, tonTarget, assets, tvmExecutorFee, tvmValidExecutors) {
-        this.logger.debug('Bridging tokens to TON');
-        if (assets == undefined) {
-            assets = [];
-        }
-        const tonAssets = [...assets];
-        if (value > 0n) {
-            tonAssets.push(await (await assets_1.AssetFactory.from(this.config, {
-                address: await this.config.nativeTACAddress(),
-                tokenType: Struct_1.AssetType.FT,
-            })).withAmount({ rawAmount: value }));
-        }
-        Validator_1.Validator.validateTVMAddress(tonTarget);
-        if (tvmExecutorFee == undefined) {
-            const suggestedTONExecutorFee = await this.simulator.getTVMExecutorFeeInfo(tonAssets, Consts_1.TAC_SYMBOL, tvmValidExecutors);
-            this.logger.debug(`Suggested TON executor fee: ${(0, Utils_1.formatObjectForLogging)(suggestedTONExecutorFee)}`);
-            tvmExecutorFee = BigInt(suggestedTONExecutorFee.inTAC);
-        }
-        const crossChainLayerAddress = await this.config.TACParams.crossChainLayer.getAddress();
-        for (const asset of assets) {
-            const evmAddress = await asset.getEVMAddress();
-            if (asset.type == Struct_1.AssetType.FT) {
-                this.logger.debug(`Approving token ${evmAddress} for ${crossChainLayerAddress}`);
-                const tokenContract = this.config.artifacts.tac.wrappers.ERC20FactoryTAC.connect(evmAddress, this.config.TACParams.provider);
-                const tx = await tokenContract.connect(signer).approve(crossChainLayerAddress, asset.rawAmount);
-                await tx.wait();
-                this.logger.debug(`Approved ${evmAddress} for ${crossChainLayerAddress}`);
-            }
-            if (asset.type == Struct_1.AssetType.NFT) {
-                this.logger.debug(`Approving collection ${evmAddress} for ${crossChainLayerAddress}`);
-                const tokenContract = this.config.artifacts.tac.wrappers.ERC721FactoryTAC.connect(evmAddress, this.config.TACParams.provider);
-                const tx = await tokenContract
-                    .connect(signer)
-                    .approve(crossChainLayerAddress, asset.addresses.index);
-                await tx.wait();
-                this.logger.debug(`Approved ${asset.address} for ${crossChainLayerAddress}`);
-            }
-        }
-        const shardsKey = BigInt(Math.round(Math.random() * 1e18));
-        this.logger.debug(`Shards key: ${shardsKey}`);
-        const protocolFee = await this.config.TACParams.crossChainLayer.getProtocolFee();
-        this.logger.debug(`Protocol fee: ${protocolFee}`);
-        const outMessage = {
-            shardsKey: shardsKey,
-            tvmTarget: tonTarget,
-            tvmPayload: '',
-            tvmProtocolFee: protocolFee,
-            tvmExecutorFee: tvmExecutorFee,
-            tvmValidExecutors: this.config.getTrustedTONExecutors,
-            toBridge: await Promise.all(assets
-                .filter((asset) => asset.type === Struct_1.AssetType.FT)
-                .map(async (asset) => ({
-                evmAddress: await asset.getEVMAddress(),
-                amount: asset.rawAmount,
-            }))),
-            toBridgeNFT: await Promise.all(assets
-                .filter((asset) => asset.type === Struct_1.AssetType.NFT)
-                .map(async (asset) => ({
-                evmAddress: await asset.getEVMAddress(),
-                amount: 1n,
-                tokenId: asset.addresses.index,
-            }))),
-        };
-        const encodedOutMessage = this.config.artifacts.tac.utils.encodeOutMessageV1(outMessage);
-        const outMsgVersion = 1n;
-        const totalValue = value + BigInt(outMessage.tvmProtocolFee) + BigInt(outMessage.tvmExecutorFee);
-        this.logger.debug(`Total value: ${totalValue}`);
-        const tx = await this.config.TACParams.crossChainLayer
-            .connect(signer)
-            .sendMessage(outMsgVersion, encodedOutMessage, { value: totalValue });
-        await tx.wait();
-        this.logger.debug(`Transaction hash: ${tx.hash}`);
-        return tx.hash;
-    }
-}
-exports.TransactionManager = TransactionManager;