@tonappchain/sdk 0.7.0-rc25 → 0.7.0-rc27

package/README.md

@@ -11,6 +11,8 @@ The TAC SDK makes it possible to create hybrid dApps that let TON users interact
 
 For full documentation and examples, please visit [TAC SDK Documentation](https://docs.tac.build/build/sdk/introduction).
 
+For practical examples and usage patterns, see [Examples Documentation](./docs/examples/examples.md).
+
 ### Installation
 
 ```bash

package/dist/src/agnosticSdk/AbiHandler.js

@@ -100,7 +100,14 @@ class AbiHandler {
             // Handle struct/tuple types
             if (param.components && Array.isArray(param.components)) {
                 const componentTypes = param.components
-                    .map((component) => this._buildParameterType(component))
+                    .map((component) => {
+                    const baseType = this._buildParameterType(component);
+                    // Include parameter name for struct components if available
+                    if (component.name) {
+                        return `${baseType} ${component.name}`;
+                    }
+                    return baseType;
+                })
                     .join(',');
                 return `(${componentTypes})`;
             }
@@ -110,7 +117,14 @@ class AbiHandler {
             // Handle array of structs
             if (param.components && Array.isArray(param.components)) {
                 const componentTypes = param.components
-                    .map((component) => this._buildParameterType(component))
+                    .map((component) => {
+                    const baseType = this._buildParameterType(component);
+                    // Include parameter name for struct components if available
+                    if (component.name) {
+                        return `${baseType} ${component.name}`;
+                    }
+                    return baseType;
+                })
                     .join(',');
                 return `(${componentTypes})[]`;
             }

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

@@ -1,21 +1,20 @@
 import type { SenderAbstraction } from '../sender';
-import { CrosschainTx, EvmProxyMsg, OperationIdsByShardsKey, TransactionLinkerWithOperationId, WaitOptions } from '../structs/Struct';
+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.
-     * @param waitOptions Optional policy to wait for operation id resolution.
      * @returns Transaction linker with operation id for tracking.
      */
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx, waitOptions?: WaitOptions<string>): Promise<TransactionLinkerWithOperationId>;
+    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 waitOptions Optional policy for waiting on operation ids by shard keys.
+     * @param options Optional options controlling waiting behavior for operation ids.
      * @returns Array of transaction linkers, one per submitted transaction.
      */
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTx[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
+    sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTx[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
 }

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

@@ -2,7 +2,7 @@ import { Wallet } from 'ethers';
 import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT } from '../assets';
 import type { SenderAbstraction } from '../sender';
-import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, CrossChainTransactionOptions, CrosschainTx, CrosschainTxWithAssetLike, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, OperationIdsByShardsKey, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
+import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
 import { Asset } from './Asset';
 import { IConfiguration } from './IConfiguration';
 import { IOperationTracker } from './IOperationTracker';
@@ -98,10 +98,10 @@ export interface ITacSDK {
      * Sends multiple cross-chain transactions in one batch and optionally waits for tracking info.
      * @param sender Sender abstraction for signing/sending TVM messages.
      * @param txs Array of cross-chain transactions to broadcast.
-     * @param waitOptions Optional waiting policy for operation ids by shard keys.
+     * @param options Optional options controlling waiting behavior for operation ids.
      * @returns Promise with an array of TransactionLinkerWithOperationId for each submitted transaction.
      */
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTxWithAssetLike[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
+    sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTxWithAssetLike[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
     /**
      * Bridges tokens/value from EVM to TON chain via the executor.
      * @param signer Ethers Wallet used to sign the EVM-side transaction.

package/dist/src/sdk/LiteSequencerClient.js

@@ -15,10 +15,18 @@ class LiteSequencerClient {
         const isEthHash = /^0x[a-fA-F0-9]{64}$/.test(transactionHash);
         const path = isEthHash ? 'tac/operation-id' : 'ton/operation-id';
         try {
-            const response = await this.httpClient.get(new URL(path, this.endpoint).toString(), {
-                params: { transactionHash },
-            });
-            return response.data.response || '';
+            if (isEthHash) {
+                const response = await this.httpClient.get(new URL(path, this.endpoint).toString(), {
+                    params: { transactionHash },
+                });
+                return response.data.response?.operationId || '';
+            }
+            else {
+                const response = await this.httpClient.get(new URL(path, this.endpoint).toString(), {
+                    params: { transactionHash },
+                });
+                return response.data.response || '';
+            }
         }
         catch (error) {
             if (error?.response?.status === 404) {

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

@@ -1,6 +1,6 @@
 import { IConfiguration, ILogger, IOperationTracker, ISimulator, ITONTransactionManager } from '../interfaces';
 import type { SenderAbstraction } from '../sender';
-import { CrosschainTx, EvmProxyMsg, OperationIdsByShardsKey, TransactionLinkerWithOperationId, WaitOptions } from '../structs/Struct';
+import { BatchCrossChainTx, CrossChainTransactionsOptions, CrosschainTx, EvmProxyMsg, TransactionLinkerWithOperationId } from '../structs/Struct';
 export declare class TONTransactionManager implements ITONTransactionManager {
     private readonly config;
     private readonly simulator;
@@ -10,8 +10,8 @@ export declare class TONTransactionManager implements ITONTransactionManager {
     private buildFeeParams;
     private prepareCrossChainTransaction;
     private generateCrossChainMessages;
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx, waitOptions?: WaitOptions<string>): Promise<TransactionLinkerWithOperationId>;
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTx[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
+    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, tx: CrosschainTx): Promise<TransactionLinkerWithOperationId>;
+    sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTx[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
     private prepareBatchTransactions;
     private waitForOperationIds;
 }

package/dist/src/sdk/TONTransactionManager.js

@@ -136,17 +136,18 @@ class TONTransactionManager {
         this.logger.debug('Cross-chain messages generated successfully');
         return messages;
     }
-    async sendCrossChainTransaction(evmProxyMsg, sender, tx, waitOptions) {
+    async sendCrossChainTransaction(evmProxyMsg, sender, tx) {
         const { transaction, transactionLinker } = await this.prepareCrossChainTransaction(evmProxyMsg, sender, tx.assets, tx.options);
         await assets_1.TON.checkBalance(sender, this.config, [transaction]);
         this.logger.debug(`Sending transaction: ${(0, Utils_1.formatObjectForLogging)(transactionLinker)}`);
         const sendTransactionResult = await sender.sendShardTransaction(transaction, this.config.network, this.config.TONParams.contractOpener);
-        if (!waitOptions) {
+        const shouldWaitForOperationId = tx.options?.waitOperationId ?? true;
+        if (!shouldWaitForOperationId) {
             return { sendTransactionResult, ...transactionLinker };
         }
         const operationId = await this.operationTracker
             .getOperationId(transactionLinker, {
-            ...waitOptions,
+            ...(tx.options?.waitOptions ?? {}),
             successCheck: (id) => !!id,
             logger: this.logger,
         })
@@ -156,15 +157,16 @@ class TONTransactionManager {
         });
         return { sendTransactionResult, operationId, ...transactionLinker };
     }
-    async sendCrossChainTransactions(sender, txs, waitOptions) {
+    async sendCrossChainTransactions(sender, txs, options) {
         const caller = sender.getSenderAddress();
         this.logger.debug(`Preparing ${txs.length} cross-chain transactions for ${caller}`);
         const { transactions, transactionLinkers } = await this.prepareBatchTransactions(txs, sender);
         await assets_1.TON.checkBalance(sender, this.config, transactions);
         this.logger.debug(`Sending transactions: ${(0, Utils_1.formatObjectForLogging)(transactionLinkers)}`);
         await sender.sendShardTransactions(transactions, this.config.network, this.config.TONParams.contractOpener);
-        return waitOptions
-            ? await this.waitForOperationIds(transactionLinkers, caller, waitOptions)
+        const shouldWaitForOperationIds = options?.waitOperationIds ?? true;
+        return shouldWaitForOperationIds
+            ? await this.waitForOperationIds(transactionLinkers, caller, options?.waitOptions ?? {})
             : transactionLinkers;
     }
     async prepareBatchTransactions(txs, sender) {

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

@@ -3,7 +3,7 @@ import { JettonMinterData, NFTItemData } from '../../artifacts/tonTypes';
 import { FT, NFT } from '../assets';
 import { IConfiguration, ILogger, IOperationTracker, ITacSDK } from '../interfaces';
 import type { SenderAbstraction } from '../sender';
-import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, CrossChainTransactionOptions, CrosschainTx, CrosschainTxWithAssetLike, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, OperationIdsByShardsKey, SDKParams, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended, WaitOptions } from '../structs/Struct';
+import { AssetFromFTArg, AssetFromNFTCollectionArg, AssetFromNFTItemArg, AssetLike, BatchCrossChainTxWithAssetLike, CrossChainTransactionOptions, CrossChainTransactionsOptions, CrosschainTx, EVMAddress, EvmProxyMsg, ExecutionFeeEstimationResult, NFTAddressType, SDKParams, SuggestedTVMExecutorFee, TACSimulationParams, TACSimulationResult, TransactionLinkerWithOperationId, TVMAddress, UserWalletBalanceExtended } from '../structs/Struct';
 export declare class TacSdk implements ITacSDK {
     readonly config: IConfiguration;
     readonly operationTracker: IOperationTracker;
@@ -20,8 +20,8 @@ export declare class TacSdk implements ITacSDK {
     get getTrustedTONExecutors(): string[];
     getSimulationInfo(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<ExecutionFeeEstimationResult>;
     getTVMExecutorFeeInfo(assets: AssetLike[], feeSymbol: string, tvmValidExecutors?: string[]): Promise<SuggestedTVMExecutorFee>;
-    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions, waitOptions?: WaitOptions<string>): Promise<TransactionLinkerWithOperationId>;
-    sendCrossChainTransactions(sender: SenderAbstraction, txs: CrosschainTxWithAssetLike[], waitOptions?: WaitOptions<OperationIdsByShardsKey>): Promise<TransactionLinkerWithOperationId[]>;
+    sendCrossChainTransaction(evmProxyMsg: EvmProxyMsg, sender: SenderAbstraction, assets?: AssetLike[], options?: CrossChainTransactionOptions): Promise<TransactionLinkerWithOperationId>;
+    sendCrossChainTransactions(sender: SenderAbstraction, txs: BatchCrossChainTxWithAssetLike[], options?: CrossChainTransactionsOptions): Promise<TransactionLinkerWithOperationId[]>;
     bridgeTokensToTON(signer: Wallet, value: bigint, tonTarget: string, assets?: AssetLike[], tvmExecutorFee?: bigint, tvmValidExecutors?: string[]): Promise<string>;
     isContractDeployedOnTVM(address: string): Promise<boolean>;
     simulateTACMessage(req: TACSimulationParams): Promise<TACSimulationResult>;

package/dist/src/sdk/TacSdk.js

@@ -77,18 +77,18 @@ class TacSdk {
         };
         return this.operationTracker.getTVMExecutorFee(params);
     }
-    async sendCrossChainTransaction(evmProxyMsg, sender, assets = [], options, waitOptions) {
+    async sendCrossChainTransaction(evmProxyMsg, sender, assets = [], options) {
         const normalizedAssets = await (0, Utils_1.normalizeAssets)(this.config, assets);
         const tx = { evmProxyMsg, assets: normalizedAssets, options };
-        return this.tonTransactionManager.sendCrossChainTransaction(evmProxyMsg, sender, tx, waitOptions);
+        return this.tonTransactionManager.sendCrossChainTransaction(evmProxyMsg, sender, tx);
     }
-    async sendCrossChainTransactions(sender, txs, waitOptions) {
+    async sendCrossChainTransactions(sender, txs, options) {
         const normalizedTxs = await Promise.all(txs.map(async (tx) => ({
             evmProxyMsg: tx.evmProxyMsg,
             options: tx.options,
             assets: await (0, Utils_1.normalizeAssets)(this.config, tx.assets),
         })));
-        return this.tonTransactionManager.sendCrossChainTransactions(sender, normalizedTxs, waitOptions);
+        return this.tonTransactionManager.sendCrossChainTransactions(sender, normalizedTxs, options);
     }
     async bridgeTokensToTON(signer, value, tonTarget, assets, tvmExecutorFee, tvmValidExecutors) {
         const normalizedAssets = await (0, Utils_1.normalizeAssets)(this.config, assets);

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

@@ -54,6 +54,11 @@ export type StageProfilingResponse = ResponseBase<ExecutionStagesByOperationId>;
 export type TACSimulationResponse = ResponseBase<TACSimulationResult>;
 export type SuggestedTVMExecutorFeeResponse = ResponseBase<SuggestedTVMExecutorFee>;
 export type ConvertCurrencyResponse = ResponseBase<ConvertedCurrencyRawResult>;
+export type OperationIdWithLogIndex = {
+    operationId: string;
+    logIndex: number;
+};
+export type OperationIdWithLogIndexResponse = ResponseBase<OperationIdWithLogIndex>;
 export interface SendResult {
     success: boolean;
     result?: unknown;

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

@@ -287,6 +287,13 @@ export type CrossChainTransactionOptions = {
     calculateRollbackFee?: boolean;
     withoutSimulation?: boolean;
     validateAssetsBalance?: boolean;
+    waitOperationId?: boolean;
+    waitOptions?: WaitOptions<string>;
+};
+export type BatchCrossChainTransactionOptions = Omit<CrossChainTransactionOptions, 'waitOperationId' | 'waitOptions'>;
+export type CrossChainTransactionsOptions = {
+    waitOperationIds?: boolean;
+    waitOptions?: WaitOptions<OperationIdsByShardsKey>;
 };
 export type ExecutionFeeEstimationResult = {
     feeParams: FeeParams;
@@ -297,6 +304,11 @@ export type CrosschainTx = {
     assets?: Asset[];
     options?: CrossChainTransactionOptions;
 };
+export type BatchCrossChainTx = {
+    evmProxyMsg: EvmProxyMsg;
+    assets?: Asset[];
+    options?: BatchCrossChainTransactionOptions;
+};
 export type AssetLike = Asset | FT | NFT | {
     rawAmount: bigint;
 } | {
@@ -313,7 +325,7 @@ export type AssetLike = Asset | FT | NFT | {
     address: TVMAddress | EVMAddress;
     itemIndex: bigint;
 };
-export type CrosschainTxWithAssetLike = Omit<CrosschainTx, 'assets'> & {
+export type BatchCrossChainTxWithAssetLike = Omit<BatchCrossChainTx, 'assets'> & {
     assets?: AssetLike[];
 };
 export interface WaitOptions<T = unknown, TContext = unknown> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonappchain/sdk",
-  "version": "0.7.0-rc25",
+  "version": "0.7.0-rc27",
   "repository": "https://github.com/TacBuild/tac-sdk.git",
   "author": "TAC. <developers@tac>",
   "license": "MIT",
@@ -51,16 +51,16 @@
   "scripts": {
     "prebuild": "git submodule update --init --recursive --remote",
     "litebuild": "rm -rf dist && tsc --declaration",
-    "build": "rm -rf dist && yarn build:artifacts && tsc --declaration",
+    "build": "rm -rf dist && npm run build:artifacts && tsc --declaration",
     "build:artifacts:tac:dev": "cd artifacts/dev/l2-evm && npm i && npx hardhat compile && rsync -avh --delete ./artifacts ./scripts ./typechain-types ../tac/internal/",
     "build:artifacts:ton:dev": "cd artifacts/dev/l1_tvm_ton && npm i && npm run compile:ts && npm run build:all && rsync -avh --delete ./build ./wrappers ../ton/internal/",
     "build:artifacts:tac:testnet": "cd artifacts/testnet/l2-evm && npm i && npx hardhat compile && rsync -avh --delete ./artifacts ./scripts ./typechain-types ../tac/internal/",
     "build:artifacts:ton:testnet": "cd artifacts/testnet/l1_tvm_ton && npm i && npm run compile:ts && npm run build:all && rsync -avh --delete ./build ./wrappers ../ton/internal/",
     "build:artifacts:tac:mainnet": "cd artifacts/mainnet/l2-evm && npm i && npx hardhat compile && rsync -avh --delete ./artifacts ./scripts ./typechain-types ../tac/internal/",
     "build:artifacts:ton:mainnet": "cd artifacts/mainnet/l1_tvm_ton && npm i && npm run compile:ts && npm run build:all && rsync -avh --delete ./build ./wrappers ../ton/internal/",
-    "build:artifacts:ton:all": "yarn build:artifacts:ton:dev && yarn build:artifacts:ton:testnet && yarn build:artifacts:ton:mainnet",
-    "build:artifacts:tac:all": "yarn build:artifacts:tac:dev && yarn build:artifacts:tac:testnet && yarn build:artifacts:tac:mainnet",
-    "build:artifacts": "yarn prebuild && yarn build:artifacts:ton:all && yarn build:artifacts:tac:all",
+    "build:artifacts:ton:all": "npm run build:artifacts:ton:dev && npm run build:artifacts:ton:testnet && npm run build:artifacts:ton:mainnet",
+    "build:artifacts:tac:all": "npm run build:artifacts:tac:dev && npm run build:artifacts:tac:testnet && npm run build:artifacts:tac:mainnet",
+    "build:artifacts": "npm run prebuild && npm run build:artifacts:ton:all && npm run build:artifacts:tac:all",
     "test": "jest --verbose --runInBand",
     "release": "yarn build && yarn release-it --npm.yarn1",
     "lint": "eslint .",
@@ -77,8 +77,7 @@
     "cli-table3": "^0.6.5",
     "dotenv": "^16.4.7",
     "ethers": "^6.13.5",
-    "ton-crypto": "^3.2.0",
-    "yarn": "^1.22.22"
+    "ton-crypto": "^3.2.0"
   },
   "keywords": [],
   "description": "",
@@ -98,7 +97,8 @@
     "ts-jest": "^29.2.6",
     "ts-node": "^10.9.2",
     "typescript": "^5.7.3",
-    "typescript-eslint": "^8.17.0"
+    "typescript-eslint": "^8.17.0",
+    "yarn": "^1.22.22"
   },
   "publishConfig": {
     "access": "public",