@ton/blueprint 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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).
 
+## [0.26.0] - 2024-11-26
+
+### Added
+
+- Added support for tonapi as an API provider
+
 ## [0.25.0] - 2024-11-02
 
 ### Added

package/README.md

@@ -188,6 +188,7 @@ export const config: Config = {
 
 Here are some of the plugins developed by the community:
 - [scaffold](https://github.com/1IxI1/blueprint-scaffold) - allows developers to quickly create a simple dapp automatically using the wrappers' code
+- [misti](https://github.com/nowarp/blueprint-misti) - simplifies workflow with the [Misti](https://nowarp.github.io/tools/misti/) static analyzer
 
 ### Custom network
 

package/dist/cli/constants.js

@@ -63,11 +63,11 @@ Script name is matched (ignoring case) to a file in the scripts directory. If no
 Flags:
 --mainnet, --testnet - specifies the network to use when running the script. If not specified on the command line, it will be asked interactively.
 --custom [api-endpoint] - indicates that a custom API should be used when running the script, and the API URL optionally. (example: https://testnet.toncenter.com/api/v2/)
---custom-version - specifies the API version to use with the custom API. Options: v2 (defualt), v4.
+--custom-version - specifies the API version to use with the custom API. Options: v2 (default), v4.
 --custom-key - specifies the API key to use with the custom API, can only be used with API v2.
 --custom-type - specifies the network type to be indicated to scripts. Options: custom (default), mainnet, testnet.
 --tonconnect, --deeplink, --mnemonic - specifies the deployer to use when running the script. If not specified on the command line, it will be asked interactively.
---tonscan, --tonviewer, --toncx, --dton - specifies the network explorer to use when displaying links to the deployed contracts. Default: tonscan.`,
+--tonscan, --tonviewer, --toncx, --dton - specifies the network explorer to use when displaying links to the deployed contracts. Default: tonviewer.`,
     build: `Usage: blueprint build [contract name] [flags]
 
 Builds the specified contract according to the respective .compile.ts file. If the contract is written in TACT, all TACT-generated files (wrapper class, etc) will be placed in the build/<contract name> folder.

package/dist/config/CustomNetwork.d.ts

@@ -1,6 +1,6 @@
 export type CustomNetwork = {
     endpoint: string;
-    version?: 'v2' | 'v4';
+    version?: 'v2' | 'v4' | 'tonapi';
     key?: string;
     type?: 'mainnet' | 'testnet' | 'custom';
 };

package/dist/network/NetworkProvider.d.ts

@@ -1,10 +1,12 @@
 import { TonClient, TonClient4 } from '@ton/ton';
 import { Address, Cell, Contract, ContractProvider, OpenedContract, Sender } from '@ton/core';
+import { ContractAdapter } from '@ton-api/ton-adapter';
 import { UIProvider } from '../ui/UIProvider';
+export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter;
 export interface NetworkProvider {
     network(): 'mainnet' | 'testnet' | 'custom';
     sender(): Sender;
-    api(): TonClient4 | TonClient;
+    api(): BlueprintTonClient;
     provider(address: Address, init?: {
         code?: Cell;
         data?: Cell;

package/dist/network/createNetworkProvider.js

@@ -21,6 +21,8 @@ const DeeplinkProvider_1 = require("./send/DeeplinkProvider");
 const TonConnectProvider_1 = require("./send/TonConnectProvider");
 const core_1 = require("@ton/core");
 const ton_1 = require("@ton/ton");
+const ton_adapter_1 = require("@ton-api/ton-adapter");
+const client_1 = require("@ton-api/client");
 const FSStorage_1 = require("./storage/FSStorage");
 const path_1 = __importDefault(require("path"));
 const paths_1 = require("../paths");
@@ -127,16 +129,15 @@ class NetworkProviderImpl {
         return __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f");
     }
     provider(address, init) {
-        const factory = (params) => __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(params.address, params.init);
+        const factory = (params) => __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(params.address, params.init && {
+            ...params.init,
+            data: params.init.data ?? undefined,
+            code: params.init.code ?? undefined,
+        });
         return new WrappedContractProvider(address, factory, init);
     }
     async isContractDeployed(address) {
-        if (__classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f") instanceof ton_1.TonClient4) {
-            return __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").isContractDeployed((await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").getLastBlock()).last.seqno, address);
-        }
-        else {
-            return (await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").getContractState(address)).state === 'active';
-        }
+        return (await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address).getState()).state.type === 'active';
     }
     async waitForDeploy(address, attempts = 20, sleepDuration = 2000) {
         if (attempts <= 0) {
@@ -328,6 +329,12 @@ class NetworkProviderBuilder {
                     endpoint: configNetwork.endpoint,
                 });
             }
+            else if (configNetwork.version === 'tonapi') {
+                tc = new ton_adapter_1.ContractAdapter(new client_1.TonApiClient({
+                    baseUrl: configNetwork.endpoint,
+                    apiKey: configNetwork.key,
+                }));
+            }
             else {
                 throw new Error('Unknown API version: ' + configNetwork.version);
             }
@@ -365,7 +372,9 @@ class NetworkProviderBuilder {
                 }
             };
             tc = new ton_1.TonClient({
-                endpoint: network === 'mainnet' ? 'https://toncenter.com/api/v2/jsonRPC' : 'https://testnet.toncenter.com/api/v2/jsonRPC',
+                endpoint: network === 'mainnet'
+                    ? 'https://toncenter.com/api/v2/jsonRPC'
+                    : 'https://testnet.toncenter.com/api/v2/jsonRPC',
                 httpAdapter,
             });
         }

package/dist/network/send/MnemonicProvider.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="node" />
-import { TonClient, TonClient4 } from '@ton/ton';
 import { Address, Cell, StateInit } from '@ton/core';
 import { SendProvider } from './SendProvider';
 import { UIProvider } from '../../ui/UIProvider';
+import { BlueprintTonClient } from '../NetworkProvider';
 export type WalletVersion = 'v1r1' | 'v1r2' | 'v1r3' | 'v2r1' | 'v2r2' | 'v3r1' | 'v3r2' | 'v4' | 'v5r1';
 export declare class MnemonicProvider implements SendProvider {
     #private;
@@ -10,7 +10,7 @@ export declare class MnemonicProvider implements SendProvider {
         version: WalletVersion;
         workchain?: number;
         secretKey: Buffer;
-        client: TonClient4 | TonClient;
+        client: BlueprintTonClient;
         ui: UIProvider;
     });
     connect(): Promise<void>;

package/dist/network/send/MnemonicProvider.js

@@ -41,7 +41,11 @@ class MnemonicProvider {
         __classPrivateFieldSet(this, _MnemonicProvider_wallet, (0, core_1.openContract)(wallets[params.version].create({
             workchain: params.workchain ?? 0,
             publicKey: kp.publicKey,
-        }), (params) => __classPrivateFieldGet(this, _MnemonicProvider_client, "f").provider(params.address, params.init)), "f");
+        }), (params) => __classPrivateFieldGet(this, _MnemonicProvider_client, "f").provider(params.address, params.init && {
+            ...params.init,
+            data: params.init.data ?? undefined,
+            code: params.init.code ?? undefined,
+        })), "f");
         __classPrivateFieldSet(this, _MnemonicProvider_secretKey, kp.secretKey, "f");
         __classPrivateFieldSet(this, _MnemonicProvider_ui, params.ui, "f");
     }

package/dist/utils/ton.utils.js

@@ -18,7 +18,7 @@ function getExplorerLink(address, network, explorer) {
         case 'dton':
             return `https://${networkPrefix}dton.io/a/${address}`;
         default:
-            return `https://${networkPrefix}tonscan.org/address/${address}`;
+            return `https://${networkPrefix}tonviewer.com/${address}`;
     }
 }
 exports.getExplorerLink = getExplorerLink;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -35,6 +35,8 @@
   },
   "dependencies": {
     "@tact-lang/compiler": "^1.4.0",
+    "@ton-api/client": "^0.2.0",
+    "@ton-api/ton-adapter": "^0.2.0",
     "@ton-community/func-js": "^0.7.0",
     "@ton/tolk-js": "^0.6.0",
     "@tonconnect/sdk": "^2.2.0",