@ton/blueprint 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.20.0] - 2024-05-07
+
+### Added
+
+- Added auto-sourcing of root `tact.config.json` files for merging compilation options with `wrappers/*.compile.ts`
+- Added a warning for disabling `debug` in contract wrappers of Tact before doing production deployments
+
+### Changed
+
+- Changed `@tact-lang/compiler` dependency to be `^1.3.0` instead of `^1.2.0`
+- Changed `compile.ts.template` template for Tact to have `debug` set to `true` by default
+- Changed `contract.tact.template` empty template for Tact to mention implicit empty `init()` function
+
+## [0.19.1] - 2024-04-12
+
+### Fixed
+
+- Fixed `verify` command
+
+### Changed
+
+- Updated readme to reflect the fact that blueprint no longer automatically adds `jsonRPC` to custom v2 endpoints
+
 ## [0.19.0] - 2024-03-27
 
 ### Changed

package/README.md

@@ -30,7 +30,7 @@ npm create ton@latest
 ### Requirements
 
 * [Node.js](https://nodejs.org) with a recent version like v18, verify version with `node -v`
-* IDE with TypeScript and FunC support like [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) or [IntelliJ Idea](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/18541-ton-development)
+* IDE with TypeScript and FunC support like [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) or [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton)
 
  
 
@@ -143,7 +143,7 @@ import { Config } from '@ton/blueprint';
 
 export const config: Config = {
     network: {
-        endpoint: 'https://toncenter.com/api/v2/',
+        endpoint: 'https://toncenter.com/api/v2/jsonRPC',
         type: 'mainnet',
         version: 'v2',
         key: 'YOUR_API_KEY',
@@ -153,11 +153,17 @@ export const config: Config = {
 
 The above config parameters are equivalent to the arguments in the following command:
 ```bash
-npx blueprint run --custom https://toncenter.com/api/v2/ --custom-version v2 --custom-type mainnet --custom-key YOUR_API_KEY
+npx blueprint run --custom https://toncenter.com/api/v2/jsonRPC --custom-version v2 --custom-type mainnet --custom-key YOUR_API_KEY
 ```
 
 Properties of the `network` object have the same semantics as the `--custom` flags with respective names (see `blueprint help run`).
 
+You can also use custom network to verify contracts, like so:
+```bash
+npx blueprint verify --custom https://toncenter.com/api/v2/jsonRPC --custom-version v2 --custom-type mainnet --custom-key YOUR_API_KEY
+```
+(or similarly using the config), however custom type MUST be specified as either `mainnet` or `testnet` when verifying.
+
 ## Contributors
 
 Special thanks to [@qdevstudio](https://t.me/qdevstudio) for their logo for blueprint.

package/dist/build.js

@@ -26,13 +26,17 @@ async function buildOne(contract, ui) {
                 });
                 await promises_1.default.writeFile(k, v);
             }
+            if (result.options !== undefined && result.options?.debug === true) {
+                ui?.clearActionPrompt();
+                ui?.write('\n⚠️ Make sure to disable debug mode in contract wrappers before doing production deployments!');
+            }
         }
         const cell = result.code;
         const rHash = cell.hash();
         const res = {
             hash: rHash.toString('hex'),
             hashBase64: rHash.toString('base64'),
-            hex: cell.toBoc().toString('hex')
+            hex: cell.toBoc().toString('hex'),
         };
         ui?.clearActionPrompt();
         ui?.write('\n✅ Compiled successfully! Cell BOC result:\n\n');

package/dist/cli/verify.js

@@ -13,7 +13,7 @@ const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
 const backends = {
     mainnet: {
-        verifierRegistry: core_1.Address.parse('EQDS0AW7NV1w3nFwx-mmryfpH4OGQ3PXnoFGOJA_8PTHuLrw'),
+        sourceRegistry: core_1.Address.parse('EQD-BJSVUJviud_Qv7Ymfd3qzXdrmV525e3YDzWQoHIAiInL'),
         backends: [
             'https://ton-source-prod-1.herokuapp.com',
             'https://ton-source-prod-2.herokuapp.com',
@@ -22,7 +22,7 @@ const backends = {
         id: 'orbs.com',
     },
     testnet: {
-        verifierRegistry: core_1.Address.parse('EQB--CRXUbqYbqJKScEWeOrnk0TKJxB071M-WwvMpMEvq6Ed'),
+        sourceRegistry: core_1.Address.parse('EQCsdKYwUaXkgJkz2l0ol6qT_WxeRbE_wBCwnEybmR0u5TO8'),
         backends: ['https://ton-source-prod-testnet-1.herokuapp.com'],
         id: 'orbs-testnet',
     },
@@ -58,6 +58,15 @@ class VerifierRegistry {
         });
     }
 }
+class SourceRegistry {
+    constructor(address) {
+        this.address = address;
+    }
+    async getVerifierRegistry(provider) {
+        const { stack } = await provider.get('get_verifier_registry_address', []);
+        return stack.readAddress();
+    }
+}
 async function lookupCodeHash(hash, ui, retryCount = 5) {
     let queryResponse;
     let foundAddr;
@@ -210,7 +219,8 @@ const verify = async (args, ui, context) => {
         type: 'application/json',
     }), 'blob');
     const backend = backends[network];
-    const verifierRegistry = networkProvider.open(new VerifierRegistry(backend.verifierRegistry));
+    const sourceRegistry = networkProvider.open(new SourceRegistry(backend.sourceRegistry));
+    const verifierRegistry = networkProvider.open(new VerifierRegistry(await sourceRegistry.getVerifierRegistry()));
     const verifier = (await verifierRegistry.getVerifiers()).find((v) => v.name === backend.id);
     if (verifier === undefined) {
         throw new Error('Could not find verifier');
@@ -248,7 +258,7 @@ const verify = async (args, ui, context) => {
     }
     const c = core_1.Cell.fromBoc(Buffer.from(msgCell.data))[0];
     await networkProvider.sender().send({
-        to: backend.verifierRegistry,
+        to: verifierRegistry.address,
         value: (0, core_1.toNano)('0.5'),
         body: c,
     });

package/dist/compile/compile.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="node" />
 import { SourcesArray } from '@ton-community/func-js';
 import { Cell } from '@ton/core';
+import { TactCompilerConfig } from './CompilerConfig';
 export type FuncCompileResult = {
     lang: 'func';
     code: Cell;
@@ -12,6 +13,7 @@ export type TactCompileResult = {
     lang: 'tact';
     fs: Map<string, Buffer>;
     code: Cell;
+    options?: TactCompilerConfig['options'];
 };
 export type CompileResult = TactCompileResult | FuncCompileResult;
 export declare function doCompile(name: string, opts?: CompileOpts): Promise<CompileResult>;

package/dist/compile/compile.js

@@ -32,7 +32,7 @@ const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const core_1 = require("@ton/core");
 const paths_1 = require("../paths");
-const compiler_1 = require("@tact-lang/compiler");
+const Tact = __importStar(require("@tact-lang/compiler"));
 const OverwritableVirtualFileSystem_1 = require("./OverwritableVirtualFileSystem");
 async function getCompilerConfigForContract(name) {
     var _a;
@@ -74,18 +74,32 @@ function findTactBoc(fs) {
     }
     return core_1.Cell.fromBoc(buf)[0];
 }
+function getRootTactConfigOptionsForContract(name) {
+    if (!(0, fs_1.existsSync)(paths_1.TACT_ROOT_CONFIG)) {
+        return undefined;
+    }
+    const config = Tact.parseConfig((0, fs_1.readFileSync)(paths_1.TACT_ROOT_CONFIG).toString());
+    for (const project of config.projects) {
+        if (project.name === name) {
+            return project.options;
+        }
+    }
+    return undefined;
+}
 async function doCompileTact(config, name) {
+    const rootConfigOptions = getRootTactConfigOptionsForContract(name);
     const fs = new OverwritableVirtualFileSystem_1.OverwritableVirtualFileSystem(process.cwd());
-    const res = await (0, compiler_1.build)({
+    const buildConfig = {
         config: {
             name: 'tact',
             path: config.target,
             output: path_1.default.join(paths_1.BUILD_DIR, name),
-            options: config.options,
+            options: { ...rootConfigOptions, ...config.options },
         },
         stdlib: '/stdlib',
         project: fs,
-    });
+    };
+    const res = await Tact.build(buildConfig);
     if (!res) {
         throw new Error('Could not compile tact');
     }
@@ -94,6 +108,7 @@ async function doCompileTact(config, name) {
         lang: 'tact',
         fs: fs.overwrites,
         code,
+        options: buildConfig.config.options,
     };
 }
 async function doCompileInner(name, config) {

package/dist/paths.d.ts

@@ -10,3 +10,4 @@ export declare const BUILD_DIR: string;
 export declare const TEMP_DIR: string;
 export declare const CONTRACTS_DIR: string;
 export declare const TESTS_DIR: string;
+export declare const TACT_ROOT_CONFIG: string;

package/dist/paths.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TESTS_DIR = exports.CONTRACTS_DIR = exports.TEMP_DIR = exports.BUILD_DIR = exports.SCRIPTS_DIR = exports.WRAPPERS_DIR = exports.BUILD = exports.TEMP = exports.SCRIPTS = exports.WRAPPERS = exports.TESTS = exports.CONTRACTS = void 0;
+exports.TACT_ROOT_CONFIG = exports.TESTS_DIR = exports.CONTRACTS_DIR = exports.TEMP_DIR = exports.BUILD_DIR = exports.SCRIPTS_DIR = exports.WRAPPERS_DIR = exports.BUILD = exports.TEMP = exports.SCRIPTS = exports.WRAPPERS = exports.TESTS = exports.CONTRACTS = void 0;
 const path_1 = __importDefault(require("path"));
 exports.CONTRACTS = 'contracts';
 exports.TESTS = 'tests';
@@ -17,3 +17,4 @@ exports.BUILD_DIR = path_1.default.join(process.cwd(), exports.BUILD);
 exports.TEMP_DIR = path_1.default.join(process.cwd(), exports.TEMP);
 exports.CONTRACTS_DIR = path_1.default.join(process.cwd(), exports.CONTRACTS);
 exports.TESTS_DIR = path_1.default.join(process.cwd(), exports.TESTS);
+exports.TACT_ROOT_CONFIG = path_1.default.join(process.cwd(), 'tact.config.json');

package/dist/templates/tact/common/wrappers/compile.ts.template

@@ -4,4 +4,7 @@ import { CompilerConfig } from '@ton/blueprint';
 export const compile: CompilerConfig = {
     lang: 'tact',
     target: '{{contractPath}}',
+    options: {
+        debug: true,
+    },
 };

package/dist/templates/tact/empty/contracts/contract.tact.template

@@ -2,7 +2,8 @@
 import "@stdlib/deploy";
 
 contract {{name}} with Deployable {
-    init() {
-        
-    }
+    // Empty init() function is present by default in all Tact contracts
+    // since v1.3.0, so the following may be omitted:
+    //
+    // init() {}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@orbs-network/ton-access": "^2.3.3",
-    "@tact-lang/compiler": "^1.2.0",
+    "@tact-lang/compiler": "^1.3.0",
     "@ton-community/func-js": "^0.7.0",
     "@tonconnect/sdk": "^2.2.0",
     "arg": "^5.0.2",