@tonappchain/sdk 0.6.6-mainnet-alpha → 0.7.0-rc10

package/dist/structs/Struct.d.ts

@@ -1,16 +1,12 @@
-import { SandboxContract } from '@ton/sandbox';
-import type { Address, Cell, Contract, OpenedContract } from '@ton/ton';
-import { AbstractProvider, Addressable, Interface, InterfaceAbi } from 'ethers';
+import type { Address, Cell } from '@ton/ton';
+import { AbstractProvider, Addressable } from 'ethers';
+import type { ILogger, IContractOpener, IAsset } from '../interfaces';
+export type { IContractOpener, IAsset } from '../interfaces';
 export type ContractState = {
     balance: bigint;
     state: 'active' | 'uninitialized' | 'frozen';
     code: Buffer | null;
 };
-export interface ContractOpener {
-    open<T extends Contract>(src: T): OpenedContract<T> | SandboxContract<T>;
-    getContractState(address: Address): Promise<ContractState>;
-    closeConnections?: () => unknown;
-}
 export declare enum SimplifiedStatuses {
     PENDING = "PENDING",
     FAILED = "FAILED",
@@ -25,6 +21,10 @@ export declare enum BlockchainType {
     TAC = "TAC",
     TON = "TON"
 }
+export declare enum CurrencyType {
+    TAC = "TAC",
+    TON = "TON"
+}
 export declare enum OperationType {
     PENDING = "PENDING",
     TON_TAC_TON = "TON-TAC-TON",
@@ -42,36 +42,12 @@ export type TACParams = {
      * Address of TAC settings contract. Use only for tests.
      */
     settingsAddress?: string | Addressable;
-    /**
-     * ABI of TAC settings contract. Use only for tests.
-     */
-    settingsABI?: Interface | InterfaceAbi;
-    /**
-     * ABI of TAC CCL contract. Use only for tests.
-     */
-    crossChainLayerABI?: Interface | InterfaceAbi;
-    /**
-     * ABI of TAC CrossChainLayerToken contract. Use only for tests.
-     */
-    crossChainLayerTokenABI?: Interface | InterfaceAbi;
-    /**
-     * bytecode of TAC CrossChainLayerToken contract. Use only for tests.
-     */
-    crossChainLayerTokenBytecode?: string;
-    /**
-     * ABI of TAC CrossChainLayerNFT contract. Use only for tests.
-     */
-    crossChainLayerNFTABI?: Interface | InterfaceAbi;
-    /**
-     * bytecode of TAC CrossChainLayerNFT contract. Use only for tests.
-     */
-    crossChainLayerNFTBytecode?: string;
 };
 export type TONParams = {
     /**
      * Provider for TON side. Use your own provider for tests or to increase ratelimit
      */
-    contractOpener?: ContractOpener;
+    contractOpener?: IContractOpener;
     /**
      * Address of TON settings contract. Use only for tests.
      */
@@ -98,10 +74,6 @@ export type SDKParams = {
      * URLs of lite sequencers
      */
     customLiteSequencerEndpoints?: string[];
-    /**
-     * Debug flag
-     */
-    debug?: boolean;
 };
 export declare enum AssetType {
     NFT = "NFT",
@@ -111,52 +83,6 @@ export declare enum NFTAddressType {
     ITEM = "ITEM",
     COLLECTION = "COLLECTION"
 }
-export type WithAddressFT = {
-    type: AssetType.FT;
-    /**
-     * Address of TAC or TON token.
-     * Empty if sending native TON coin.
-     */
-    address?: string;
-};
-export type WithAddressNFTItem = {
-    type: AssetType.NFT;
-    /**
-     * Address NFT item token.
-     */
-    address: string;
-};
-export type WithAddressNFTCollectionItem = {
-    type: AssetType.NFT;
-    /**
-     * Address NFT collection.
-     */
-    collectionAddress: string;
-    /**
-     * Index of NFT item in collection.
-     */
-    itemIndex: bigint;
-};
-export type WithAddressNFT = WithAddressNFTItem | WithAddressNFTCollectionItem;
-export type WithAddress = WithAddressFT | WithAddressNFT;
-export type RawAssetBridgingData<NFTFormatRequired extends WithAddressNFT = WithAddressNFTItem> = {
-    /** Raw format, e.g. 12340000000 (=12.34 tokens if decimals is 9) */
-    rawAmount: bigint;
-} & (WithAddressFT | NFTFormatRequired);
-export type UserFriendlyAssetBridgingData = {
-    /**
-     * User friendly format, e.g. 12.34 tokens
-     * Specified value will be converted automatically to raw format: 12.34 * (10^decimals).
-     * No decimals should be specified.
-     */
-    amount: number;
-    /**
-     * Decimals may be specified manually.
-     * Otherwise, SDK tries to extract them from chain.
-     */
-    decimals?: number;
-} & WithAddress;
-export type AssetBridgingData = RawAssetBridgingData | UserFriendlyAssetBridgingData;
 export type UserWalletBalanceExtended = {
     exists: true;
     amount: number;
@@ -170,6 +96,7 @@ export type EvmProxyMsg = {
     methodName?: string;
     encodedParameters?: string;
     gasLimit?: bigint;
+    [key: string]: unknown;
 };
 export type TransactionLinker = {
     caller: string;
@@ -187,9 +114,9 @@ export type TACSimulationRequest = {
         methodName: string;
         target: string;
     };
-    evmValidExecutors: string[];
-    tvmValidExecutors: string[];
-    extraData: string;
+    evmValidExecutors?: string[];
+    tvmValidExecutors?: string[];
+    extraData?: string;
     shardsKey: string;
     tonAssets: {
         amount: string;
@@ -197,6 +124,7 @@ export type TACSimulationRequest = {
         assetType: string;
     }[];
     tonCaller: string;
+    calculateRollbackFee?: boolean;
 };
 export declare enum StageName {
     COLLECTED_IN_TAC = "collectedInTAC",
@@ -246,18 +174,42 @@ export type GeneralFeeInfo = {
     executorFee: string;
     tokenFeeSymbol: TokenSymbol;
 };
+export type AdditionalFeeInfo = {
+    attachedProtocolFee: string;
+    tokenFeeSymbol: TokenSymbol;
+};
 export type FeeInfo = {
-    tac: GeneralFeeInfo;
-    ton: GeneralFeeInfo;
+    additionalFeeInfo: AdditionalFeeInfo | null;
+    tac: GeneralFeeInfo | null;
+    ton: GeneralFeeInfo | null;
+};
+export type AssetMovement = {
+    assetType: AssetType;
+    tvmAddress: string;
+    evmAddress: string;
+    amount: string;
+    tokenId: string | null;
+};
+export type TransactionHash = {
+    hash: string;
+    blockchainType: BlockchainType;
+};
+export type AssetMovementInfo = {
+    caller: InitialCallerInfo;
+    target: InitialCallerInfo;
+    transactionHash: TransactionHash | null;
+    assetMovements: AssetMovement[] | null;
 };
 export type MetaInfo = {
     initialCaller: InitialCallerInfo;
     validExecutors: ValidExecutors;
     feeInfo: FeeInfo;
+    sentAssets: AssetMovementInfo | null;
+    receivedAssets: AssetMovementInfo | null;
 };
 export type ExecutionStages = {
     operationType: OperationType;
-    metaInfo: MetaInfo;
+    metaInfo: MetaInfo | null;
 } & Record<StageName, ProfilingStageData>;
 export type ExecutionStagesByOperationId = Record<string, ExecutionStages>;
 export type StatusInfosByOperationId = Record<string, StatusInfo>;
@@ -320,21 +272,22 @@ export type FeeParams = {
     tvmExecutorFee: bigint;
 };
 export type CrossChainTransactionOptions = {
-    forceSend?: boolean;
+    allowSimulationError?: boolean;
     isRoundTrip?: boolean;
     protocolFee?: bigint;
     evmValidExecutors?: string[];
     evmExecutorFee?: bigint;
     tvmValidExecutors?: string[];
     tvmExecutorFee?: bigint;
+    calculateRollbackFee?: boolean;
 };
 export type ExecutionFeeEstimationResult = {
     feeParams: FeeParams;
-    simulation: TACSimulationResult;
+    simulation?: TACSimulationResult;
 };
 export type CrosschainTx = {
     evmProxyMsg: EvmProxyMsg;
-    assets?: AssetBridgingData[];
+    assets?: IAsset[];
     options?: CrossChainTransactionOptions;
 };
 export type NFTItemData = {
@@ -344,6 +297,11 @@ export type NFTItemData = {
     ownerAddress: Address | null;
     content: Cell | null;
 };
+export type NFTCollectionData = {
+    nextIndex: number;
+    content: Cell;
+    adminAddress: Address;
+};
 export interface WaitOptions<T = unknown> {
     /**
      * Timeout in milliseconds
@@ -361,9 +319,9 @@ export interface WaitOptions<T = unknown> {
      */
     delay?: number;
     /**
-     * Function to log debug messages
+     * Logger
      */
-    log?: (message: string) => void;
+    logger?: ILogger;
     /**
      * Function to check if the result is successful
      * If not provided, any non-error result is considered successful
@@ -371,3 +329,43 @@ export interface WaitOptions<T = unknown> {
     successCheck?: (result: T) => boolean;
 }
 export declare const defaultWaitOptions: WaitOptions;
+export declare enum Origin {
+    TON = "TON",
+    TAC = "TAC"
+}
+export type TVMAddress = string;
+export type EVMAddress = string;
+export type AssetFromFTArg = {
+    address: TVMAddress | EVMAddress;
+    tokenType: AssetType.FT;
+};
+export type AssetFromNFTCollectionArg = {
+    address: TVMAddress | EVMAddress;
+    tokenType: AssetType.NFT;
+    addressType: NFTAddressType.COLLECTION;
+    index: bigint;
+};
+export type AssetFromNFTItemArg = {
+    address: TVMAddress;
+    tokenType: AssetType.NFT;
+    addressType: NFTAddressType.ITEM;
+};
+export type ConvertCurrencyParams = {
+    rawValue: bigint;
+    currencyType: CurrencyType;
+};
+export type TokenPriceInfo = {
+    spot: bigint;
+    ema: bigint;
+};
+export type ConvertedCurrencyResult = {
+    spotRawValue: bigint;
+    spotFriendlyValue: string;
+    emaValue: bigint;
+    emaFriendlyValue: string;
+    spotValueInUSD: number;
+    emaValueInUSD: number;
+    currencyType: CurrencyType;
+    tacPrice: TokenPriceInfo;
+    tonPrice: TokenPriceInfo;
+};

package/dist/structs/Struct.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultWaitOptions = exports.TokenSymbol = exports.StageName = exports.NFTAddressType = exports.AssetType = exports.OperationType = exports.BlockchainType = exports.Network = exports.SimplifiedStatuses = void 0;
+exports.Origin = exports.defaultWaitOptions = exports.TokenSymbol = exports.StageName = exports.NFTAddressType = exports.AssetType = exports.OperationType = exports.CurrencyType = exports.BlockchainType = exports.Network = exports.SimplifiedStatuses = void 0;
 var SimplifiedStatuses;
 (function (SimplifiedStatuses) {
     SimplifiedStatuses["PENDING"] = "PENDING";
@@ -18,6 +18,11 @@ var BlockchainType;
     BlockchainType["TAC"] = "TAC";
     BlockchainType["TON"] = "TON";
 })(BlockchainType || (exports.BlockchainType = BlockchainType = {}));
+var CurrencyType;
+(function (CurrencyType) {
+    CurrencyType["TAC"] = "TAC";
+    CurrencyType["TON"] = "TON";
+})(CurrencyType || (exports.CurrencyType = CurrencyType = {}));
 var OperationType;
 (function (OperationType) {
     OperationType["PENDING"] = "PENDING";
@@ -56,3 +61,8 @@ exports.defaultWaitOptions = {
     maxAttempts: 30,
     delay: 10000,
 };
+var Origin;
+(function (Origin) {
+    Origin["TON"] = "TON";
+    Origin["TAC"] = "TAC";
+})(Origin || (exports.Origin = Origin = {}));

package/dist/wrappers/HighloadQueryId.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HighloadQueryId = void 0;
 const BIT_NUMBER_SIZE = 10n; // 10 bit
-const SHIFT_SIZE = 13n; // 13 bit
 const MAX_BIT_NUMBER = 1022n;
 const MAX_SHIFT = 8191n; // 2^13 = 8192
 class HighloadQueryId {

package/dist/wrappers/HighloadWalletV3.d.ts

@@ -1,6 +1,6 @@
 import { Address, Cell, ContractProvider, MessageRelaxed, OutAction, OutActionSendMsg, SendMode } from '@ton/ton';
 import { HighloadQueryId } from './HighloadQueryId';
-import { WalletInstance } from '../sender';
+import { IWallet } from '../interfaces';
 export declare enum OP {
     InternalTransfer = 2923619748
 }
@@ -14,7 +14,7 @@ export declare const DEFAULT_TIMEOUT: number;
 export declare const TIMESTAMP_SIZE = 64;
 export declare const TIMEOUT_SIZE = 22;
 export declare function highloadWalletV3ConfigToCell(config: HighloadWalletV3Config): Cell;
-export declare class HighloadWalletV3 implements WalletInstance {
+export declare class HighloadWalletV3 implements IWallet {
     readonly address: Address;
     readonly init?: {
         code: Cell;
@@ -24,7 +24,7 @@ export declare class HighloadWalletV3 implements WalletInstance {
         code: Cell;
         data: Cell;
     } | undefined);
-    getSeqno(_: ContractProvider): Promise<number>;
+    getSeqno(): Promise<number>;
     sendTransfer(provider: ContractProvider, args: {
         seqno?: number;
         secretKey: Buffer;
@@ -35,6 +35,7 @@ export declare class HighloadWalletV3 implements WalletInstance {
         createdAt?: number;
     }): Promise<void>;
     static create(config: HighloadWalletV3Config, code?: Cell, workchain?: number): HighloadWalletV3;
+    static generateCreatedAt(): number;
     sendExternalMessage(provider: ContractProvider, secretKey: Buffer, opts: {
         message: MessageRelaxed | Cell;
         mode: number;

package/dist/wrappers/HighloadWalletV3.js

@@ -27,7 +27,7 @@ class HighloadWalletV3 {
         this.address = address;
         this.init = init;
     }
-    async getSeqno(_) {
+    async getSeqno() {
         return 0; // will not be used
     }
     async sendTransfer(provider, args) {
@@ -50,6 +50,9 @@ class HighloadWalletV3 {
         const init = { code, data };
         return new HighloadWalletV3((0, ton_1.contractAddress)(workchain, init), init);
     }
+    static generateCreatedAt() {
+        return Math.floor(Date.now() / 1000) - 40; // -40 is used to pass check created_at <= now() in smart contract for sure
+    }
     async sendExternalMessage(provider, secretKey, opts) {
         let messageCell;
         if (opts.message instanceof ton_1.Cell) {
@@ -73,7 +76,7 @@ class HighloadWalletV3 {
     }
     async sendBatch(provider, secretKey, messages, subwallet, timeout, createdAt, value = 0n) {
         if (createdAt == undefined) {
-            createdAt = Math.floor(Date.now() / 1000) - 40; // -40 is used to pass check created_at <= now() in smart contract for sure
+            createdAt = HighloadWalletV3.generateCreatedAt();
         }
         const queryId = this.getQueryIdFromCreatedAt(createdAt);
         return await this.sendExternalMessage(provider, secretKey, {

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "@tonappchain/sdk",
-  "version": "0.6.6-mainnet-alpha",
-  "repository": "https://github.com/TacBuild/tac-sdk.git",
-  "author": "TAC. <developers@tac>",
-  "license": "MIT",
-  "main": "dist/index.js",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "rm -rf dist && tsc --declaration",
-    "test": "jest --verbose --runInBand",
-    "release": "yarn build && yarn release-it --npm.yarn1",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "prettier": "prettier --ignore-path .gitignore --write \"./src/**/*.+(js|ts|json)\""
-  },
-  "dependencies": {
-    "@aws-crypto/sha256-js": "^5.2.0",
-    "@orbs-network/ton-access": "^2.3.3",
-    "@ton/ton": "15.1.0",
-    "@tonappchain/artifacts": "0.0.19-smart-accounts-4",
-    "@tonappchain/ton-lite-client": "3.0.6",
-    "@tonconnect/ui": "^2.0.11",
-    "bn.js": "^5.2.1",
-    "cli-table3": "^0.6.5",
-    "dotenv": "^16.4.7",
-    "ethers": "^6.13.5",
-    "ton-crypto": "^3.2.0"
-  },
-  "keywords": [],
-  "description": "",
-  "devDependencies": {
-    "@eslint/js": "^9.21.0",
-    "@jest/globals": "^29.7.0",
-    "@release-it/keep-a-changelog": "^6.0.0",
-    "@ton/sandbox": "^0.27.1",
-    "@ton/test-utils": "^0.5.0",
-    "@types/bn.js": "^5.1.6",
-    "@types/jest": "^29.5.14",
-    "eslint": "^9.21.0",
-    "eslint-config-prettier": "^10.0.2",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
-    "jest": "^29.7.0",
-    "prettier": "^3.5.3",
-    "ts-jest": "^29.2.6",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.17.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "release-it": {
-    "plugins": {
-      "@release-it/keep-a-changelog": {
-        "filename": "CHANGELOG.md"
-      }
-    },
-    "npm": {
-      "publish": false
-    }
-  },
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+{
+  "name": "@tonappchain/sdk",
+  "version": "0.7.0-rc10",
+  "repository": "https://github.com/TacBuild/tac-sdk.git",
+  "author": "TAC. <developers@tac>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc --declaration",
+    "test": "jest --verbose --runInBand",
+    "release": "yarn build && yarn release-it --npm.yarn1",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prettier": "prettier --ignore-path .gitignore --write \"./src/**/*.+(js|ts|json)\""
+  },
+  "dependencies": {
+    "@aws-crypto/sha256-js": "^5.2.0",
+    "@orbs-network/ton-access": "^2.3.3",
+    "@ton/ton": "15.1.0",
+    "@tonappchain/artifacts": "0.0.19-smart-accounts-4",
+    "@tonappchain/ton-lite-client": "3.0.6",
+    "@tonconnect/ui": "^2.0.11",
+    "bn.js": "^5.2.1",
+    "cli-table3": "^0.6.5",
+    "dotenv": "^16.4.7",
+    "ethers": "^6.13.5",
+    "ton-crypto": "^3.2.0"
+  },
+  "keywords": [],
+  "description": "",
+  "devDependencies": {
+    "@eslint/js": "^9.21.0",
+    "@jest/globals": "^29.7.0",
+    "@release-it/keep-a-changelog": "^6.0.0",
+    "@ton/sandbox": "^0.27.1",
+    "@ton/test-utils": "^0.5.0",
+    "@types/bn.js": "^5.1.6",
+    "@types/jest": "^29.5.14",
+    "eslint": "^9.21.0",
+    "eslint-config-prettier": "^10.0.2",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.17.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "release-it": {
+    "plugins": {
+      "@release-it/keep-a-changelog": {
+        "filename": "CHANGELOG.md"
+      }
+    },
+    "npm": {
+      "publish": false
+    }
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}

package/dist/sender/SenderAbstraction.d.ts

@@ -1,20 +0,0 @@
-import type { Contract, ContractProvider, MessageRelaxed, SendMode } from '@ton/ton';
-import type { ContractOpener } from '../structs/Struct';
-import type { SendResult, ShardTransaction } from '../structs/InternalStruct';
-import { Network } from '../structs/Struct';
-export declare const sleep: (ms: number) => Promise<unknown>;
-export interface WalletInstance extends Contract {
-    getSeqno(provider: ContractProvider): Promise<number>;
-    sendTransfer(provider: ContractProvider, args: {
-        seqno: number;
-        secretKey: Buffer;
-        messages: MessageRelaxed[];
-        sendMode: SendMode;
-        timeout?: number;
-    }): Promise<void>;
-}
-export interface SenderAbstraction {
-    sendShardTransaction(shardTransaction: ShardTransaction, delay: number, chain?: Network, contractOpener?: ContractOpener): Promise<SendResult>;
-    sendShardTransactions(shardTransactions: ShardTransaction[], delay: number, chain?: Network, contractOpener?: ContractOpener): Promise<SendResult[]>;
-    getSenderAddress(): string;
-}

package/dist/sender/SenderAbstraction.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sleep = void 0;
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-exports.sleep = sleep;