@ton/ton 13.5.1

package/CHANGELOG.md

@@ -0,0 +1,133 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [13.5.1] - 2023-07-14
+## Changed
+- Migrated to `@ton/crypto` package instead of `ton-crypto`
+- Migrated to `@ton/core` instead of `ton-core`
+- Migrated to `@ton/emulator` instead of `ton-emulator`
+- Renamed package to `@ton/ton`
+
+## [13.5.0] - 2023-05-10
+## Fixed
+- Replaced `io-ts` with `zod` to reduce web bundle size
+- Removed unimplemented method `getOneTransaction` from `TonClient4`
+
+## [13.4.1] - 2023-03-02
+
+## Added
+- call get method aliases for TonClient (#7)
+- add isContractDeployed to TonClient4 (#6)
+
+## Fixed
+- Updated `ton-core` to depend from 0.48.0
+- Fixed typos in `SendMode`
+
+## [13.4.0] - 2023-03-01
+
+## Added
+- `MultisigWallet`, `MultisigOrder` and `MultisigOrderBuilder`
+
+## [13.3.0] - 2023-01-05
+
+## Added
+- `getTransaction` to `TonClient4` to get a single transaction by id
+
+## [13.2.0] - 2022-12-31
+
+## Changed
+- Updaded `ton-core` and renambed `AccountState` to `ContractState`
+- Replaced internal usafe of a `openContract` with `ton-core` one
+
+## [13.1.0] - 2022-12-31
+
+## Changed
+- Upgraded `ton-core` and removed legacy usage of `Message` type
+
+## [13.0.0] - 2022-12-29
+
+## Changed
+- Large refactoring, removing a lot of obsolete features and replacing low level classes like `Cell` with `ton-core` implementation
+- New way to work with contracts
+- Explicit work with wallet contracts
+- Unify stack operations in `TonClient` and `TonClient4`
+- Merged `TupleSlice` and `TupleSlice4` into `TupleReader` from `ton-core`
+
+## Removed
+- Removed magical `Wallet` operations
+
+## [12.3.3] - 2022-12-22
+# Changed
+- Improved BOC serialization
+
+## [12.3.2]
+- Fix unicode symbols in `readString` function
+
+## [10.4.0]
+- `TonClient4` - client for new API
+
+## [10.0.0]-[10.3.0]
+- Exotic Cells parsing
+- `readBitString`
+- VM Stack parsing
+
+## [9.2.0]
+- Builder and dict builder
+
+## [9.1.0]
+- Support for API token
+
+## [9.0.0]
+- Synchronous Cell's `hash` and a lot of related functions like `contractAddress`.
+
+## [6.10.0]
+- Better compatibility with webpack
+
+## [6.8.0]
+- Allow large comments
+
+## [6.7.0]
+- Exported all parsing methods and `contractAddress`
+
+## [6.6.0]
+- ADNL address
+
+## [6.5.2]
+- Improve Internal/External messages typings
+
+## [6.5.0-6.5.1]
+- Ability to include first transaction in getTransactions method
+
+## [6.4.0]
+- Better webpack support
+
+## [6.3.0]
+
+- Added dictionary serialization
+- Added `equals` to Cell
+
+## [6.1.0-6.2.1]
+
+- Added parsing of int (as addition to uint) in `BitStreamReader` and `Slice`
+
+## [6.0.0]
+
+- [BREAKING] Change `RawMessage` to `CellMessage` and use `RawMessage` in parseTransaction
+- Improve parseTransaction typings. Added:
+    - RawAccountStatus
+    - RawCurrencyCollection
+    - RawCommonMessageInfo
+    - RawStateInit
+    - RawMessage
+    - RawHashUpdate
+    - RawAccountStatusChange
+    - RawStorageUsedShort
+    - RawStoragePhase
+    - RawComputePhase
+    - RawActionPhase
+    - RawBouncePhase
+    - RawTransactionDescription
+    - RawTransaction

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2021-2023 Whales Corp.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# TON JS Client
+
+[![Version npm](https://img.shields.io/npm/v/ton.svg?logo=npm)](https://www.npmjs.com/package/ton)
+
+Cross-platform client for TON blockchain.
+
+## Features
+
+- 🚀 Create new wallets
+- 🍰 Get balance
+- ✈️ Transfers
+
+## Install
+
+```bash
+yarn add @ton/ton @ton/crypto @ton/core buffer
+```
+
+#### Browser polyfill
+
+```js
+// Add before using library
+require("buffer");
+```
+
+## Usage
+
+To use this library you need HTTP API endpoint, you can use one of the public endpoints:
+
+- Mainnet: https://toncenter.com/api/v2/jsonRPC
+- Testnet: https://testnet.toncenter.com/api/v2/jsonRPC
+
+```js
+import { TonClient, WalletContractV4, internal } from "@ton/ton";
+import { mnemonicNew, mnemonicToPrivateKey } from "@ton/crypto";
+
+// Create Client
+const client = new TonClient({
+  endpoint: 'https://toncenter.com/api/v2/jsonRPC',
+});
+
+// Generate new key
+let mnemonics = await mnemonicNew();
+let keyPair = await mnemonicToPrivateKey(mnemonics);
+
+// Create wallet contract
+let workchain = 0; // Usually you need a workchain 0
+let wallet = WalletContractV4.create({ workchain, publicKey: keyPair.publicKey });
+let contract = client.open(wallet);
+
+// Get balance
+let balance: bigint = await contract.getBalance();
+
+// Create a transfer
+let seqno: number = await contract.getSeqno();
+let transfer = await contract.createTransfer({
+  seqno,
+  secretKey: keyPair.secretKey,
+  messages: [internal({
+    value: '1.5',
+    to: 'EQCD39VS5jcptHL8vMjEXrzGaRcCVYto7HUn4bpAOg8xqB2N',
+    body: 'Hello world',
+  })]
+});
+
+```
+
+## Docs
+
+[Documentation](https://ton-community.github.io/ton/)
+
+## Acknowledgements
+
+This library is developed by the [Whales Corp.](https://tonwhales.com/) and maintained by [Dan Volkov](https://github.com/dvlkv).
+
+## License
+
+MIT

package/dist/client/TonClient.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Copyright (c) Whales Corp.
+ * All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/// <reference types="node" />
+import { AxiosAdapter } from 'axios';
+import { Address, Cell, Contract, ContractProvider, Message, Transaction, TupleItem, TupleReader } from '@ton/core';
+export declare type TonClientParameters = {
+    /**
+     * API Endpoint
+     */
+    endpoint: string;
+    /**
+     * HTTP request timeout in milliseconds.
+     */
+    timeout?: number;
+    /**
+     * API Key
+     */
+    apiKey?: string;
+    /**
+     * HTTP Adapter for axios
+     */
+    httpAdapter?: AxiosAdapter;
+};
+export declare class TonClient {
+    #private;
+    readonly parameters: TonClientParameters;
+    constructor(parameters: TonClientParameters);
+    /**
+     * Get Address Balance
+     * @param address address for balance check
+     * @returns balance
+     */
+    getBalance(address: Address): Promise<bigint>;
+    /**
+     * Invoke get method
+     * @param address contract address
+     * @param name name of method
+     * @param params optional parameters
+     * @returns stack and gas_used field
+     */
+    runMethod(address: Address, name: string, stack?: TupleItem[]): Promise<{
+        gas_used: number;
+        stack: TupleReader;
+    }>;
+    /**
+     * Invoke get method
+     * @param address contract address
+     * @param name name of method
+     * @param params optional parameters
+     * @returns stack and gas_used field
+     * @deprecated use runMethod instead
+     */
+    callGetMethod(address: Address, name: string, stack?: TupleItem[]): Promise<{
+        gas_used: number;
+        stack: TupleReader;
+    }>;
+    /**
+     * Invoke get method that returns error code instead of throwing error
+     * @param address contract address
+     * @param name name of method
+     * @param params optional parameters
+     * @returns stack and gas_used field
+    */
+    runMethodWithError(address: Address, name: string, params?: any[]): Promise<{
+        gas_used: number;
+        stack: TupleReader;
+        exit_code: number;
+    }>;
+    /**
+     * Invoke get method that returns error code instead of throwing error
+     * @param address contract address
+     * @param name name of method
+     * @param params optional parameters
+     * @returns stack and gas_used field
+     * @deprecated use runMethodWithError instead
+     */
+    callGetMethodWithError(address: Address, name: string, stack?: TupleItem[]): Promise<{
+        gas_used: number;
+        stack: TupleReader;
+    }>;
+    /**
+     * Get transactions
+     * @param address address
+     */
+    getTransactions(address: Address, opts: {
+        limit: number;
+        lt?: string;
+        hash?: string;
+        to_lt?: string;
+        inclusive?: boolean;
+    }): Promise<Transaction[]>;
+    /**
+     * Get transaction by it's id
+     * @param address address
+     * @param lt logical time
+     * @param hash transaction hash
+     * @returns transaction or null if not exist
+     */
+    getTransaction(address: Address, lt: string, hash: string): Promise<{
+        address: bigint;
+        lt: bigint;
+        prevTransactionHash: bigint;
+        prevTransactionLt: bigint;
+        now: number;
+        outMessagesCount: number;
+        oldStatus: import("@ton/core").AccountStatus; /**
+         * Get Address Balance
+         * @param address address for balance check
+         * @returns balance
+         */
+        endStatus: import("@ton/core").AccountStatus;
+        inMessage: Message | undefined;
+        outMessages: import("@ton/core").Dictionary<number, Message>;
+        totalFees: import("@ton/core").CurrencyCollection;
+        stateUpdate: import("@ton/core").HashUpdate;
+        description: import("@ton/core").TransactionDescription;
+    } | null>;
+    /**
+     * Fetch latest masterchain info
+     * @returns masterchain info
+     */
+    getMasterchainInfo(): Promise<{
+        workchain: number;
+        shard: string;
+        initSeqno: number;
+        latestSeqno: number;
+    }>;
+    /**
+     * Fetch latest workchain shards
+     * @param seqno masterchain seqno
+     */
+    getWorkchainShards(seqno: number): Promise<{
+        workchain: number;
+        shard: string;
+        seqno: number;
+    }[]>;
+    /**
+     * Fetch transactions inf shards
+     * @param workchain
+     * @param seqno
+     * @param shard
+     */
+    getShardTransactions(workchain: number, seqno: number, shard: string): Promise<{
+        account: Address;
+        lt: string;
+        hash: string;
+    }[]>;
+    /**
+     * Send message to a network
+     * @param src source message
+     */
+    sendMessage(src: Message): Promise<void>;
+    /**
+     * Send file to a network
+     * @param src source file
+     */
+    sendFile(src: Buffer): Promise<void>;
+    /**
+     * Estimate fees for external message
+     * @param address target address
+     * @returns
+     */
+    estimateExternalMessageFee(address: Address, args: {
+        body: Cell;
+        initCode: Cell | null;
+        initData: Cell | null;
+        ignoreSignature: boolean;
+    }): Promise<{
+        '@type': "query.fees";
+        source_fees: {
+            '@type': "fees";
+            in_fwd_fee: number;
+            storage_fee: number;
+            gas_fee: number;
+            fwd_fee: number;
+        };
+    }>;
+    /**
+     * Send external message to contract
+     * @param contract contract to send message
+     * @param src message body
+     */
+    sendExternalMessage(contract: Contract, src: Cell): Promise<void>;
+    /**
+     * Check if contract is deployed
+     * @param address addres to check
+     * @returns true if contract is in active state
+     */
+    isContractDeployed(address: Address): Promise<boolean>;
+    /**
+     * Resolves contract state
+     * @param address contract address
+     */
+    getContractState(address: Address): Promise<{
+        balance: bigint;
+        state: "active" | "uninitialized" | "frozen";
+        code: Buffer | null;
+        data: Buffer | null;
+        lastTransaction: {
+            lt: string;
+            hash: string;
+        } | null;
+        blockId: {
+            workchain: number;
+            shard: string;
+            seqno: number;
+        };
+        timestampt: number;
+    }>;
+    /**
+     * Open contract
+     * @param src source contract
+     * @returns contract
+     */
+    open<T extends Contract>(src: T): import("@ton/core").OpenedContract<T>;
+    /**
+     * Create a provider
+     * @param address address
+     * @param init optional init
+     * @returns provider
+     */
+    provider(address: Address, init: {
+        code: Cell | null;
+        data: Cell | null;
+    } | null): ContractProvider;
+}