@ton/blueprint 0.28.0 → 0.30.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.30.0] - 2025-04-08
+
+### Fixed
+
+- Fixed Tact compilation
+
+### Changed
+
+- Updated Tact templates and `@tact-lang/compiler` dependency to v1.6.5
+
+## [0.29.0] - 2025-03-02
+
+### Changed
+
+- Tolk's stderr is now printed on successful builds
+
 ## [0.28.0] - 2025-01-17
 
 ### Changed
@@ -193,18 +209,18 @@ This release contains a breaking change.
 
 ### Fixed
 
-- Fixed TACT imports
+- Fixed Tact imports
 - Fixed missing newlines when printing error messages while building contracts
 
 ## [0.11.0] - 2023-07-03
 
 ### Added
 
-- Added an `options` field to the `tact` variant of `CompilerConfig`, which is of the same type as the `options` of the TACT compiler, and includes fields such as `debug`, `experimental`, etc
+- Added an `options` field to the `tact` variant of `CompilerConfig`, which is of the same type as the `options` of the Tact compiler, and includes fields such as `debug`, `experimental`, etc
 
 ### Changed
 
-- Updated TACT to 1.1.3
+- Updated Tact to 1.1.3
 
 ## [0.10.0] - 2023-06-06
 
@@ -220,7 +236,7 @@ This release contains a breaking change.
 
 ### Changed
 
-- Updated dependencies, of note: func-js to use func 0.4.3, TACT to 1.1.1
+- Updated dependencies, of note: func-js to use func 0.4.3, Tact to 1.1.1
 
 ## [0.8.0] - 2023-04-07
 
@@ -249,7 +265,7 @@ This release contains a breaking change.
 
 ### Added
 
-- Added support for [TACT](https://github.com/tact-lang/tact), including TACT smart contract templates
+- Added support for [Tact](https://github.com/tact-lang/tact), including Tact smart contract templates
 - Added `--all` option for `build` command
 
 ### Changed

package/README.md

@@ -60,7 +60,7 @@ Blueprint is an all-in-one development environment designed to enhance the proce
 
 * [Node.js](https://nodejs.org) with a recent version like v18. Version can be verified with `node -v`
 * IDE with TON support:
-  * [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode) or [Tolk plugin](https://marketplace.visualstudio.com/items?itemName=ton-core.tolk-vscode)
+  * [Visual Studio Code](https://code.visualstudio.com/) with the [FunC plugin](https://marketplace.visualstudio.com/items?itemName=tonwhales.func-vscode), [Tolk plugin](https://marketplace.visualstudio.com/items?itemName=ton-core.tolk-vscode) or [Tact plugin](https://marketplace.visualstudio.com/items?itemName=tonstudio.vscode-tact)
   * [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton)
 
 ## Features overview

package/dist/build.js

@@ -39,6 +39,9 @@ async function buildOne(contract, ui) {
             hex: cell.toBoc().toString('hex'),
         };
         ui?.clearActionPrompt();
+        if (result.lang === 'tolk') {
+            ui?.write(`\n${result.stderr}`);
+        }
         ui?.write('\n✅ Compiled successfully! Cell BOC result:\n\n');
         ui?.write(JSON.stringify(res, null, 2));
         await promises_1.default.mkdir(paths_1.BUILD_DIR, { recursive: true });

package/dist/cli/constants.js

@@ -11,7 +11,7 @@ exports.templateTypes = [
         value: 'tolk-empty',
     },
     {
-        name: 'An empty contract (TACT)',
+        name: 'An empty contract (Tact)',
         value: 'tact-empty',
     },
     {
@@ -23,7 +23,7 @@ exports.templateTypes = [
         value: 'tolk-counter',
     },
     {
-        name: 'A simple counter contract (TACT)',
+        name: 'A simple counter contract (Tact)',
         value: 'tact-counter',
     },
 ];
@@ -70,7 +70,7 @@ Flags:
 --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.
+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.
 
 If contract name is not specified on the command line, the buildable contracts (that have the respective .compile.ts files under wrappers directory) will be presented interactively, unless --all flag is specified.
 

package/dist/compile/CompilerConfig.d.ts

@@ -1,6 +1,6 @@
 import { SourceResolver, SourcesMap, SourcesArray } from '@ton-community/func-js';
 import { Cell } from '@ton/core';
-import { ConfigProject } from '@tact-lang/compiler';
+import { Options } from '@tact-lang/compiler';
 export type HookParams = {
     userData?: any;
 };
@@ -11,7 +11,7 @@ export type CommonCompilerConfig = {
 export type TactCompilerConfig = {
     lang: 'tact';
     target: string;
-    options?: ConfigProject['options'];
+    options?: Options;
 };
 export type FuncCompilerConfig = {
     lang?: 'func';

package/dist/compile/compile.js

@@ -128,7 +128,7 @@ async function doCompileTact(config, name) {
         project: fs,
     };
     const res = await Tact.build(buildConfig);
-    if (!res) {
+    if (!res.ok) {
         throw new Error('Could not compile tact');
     }
     const code = findTactBoc(fs.overwrites);

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

@@ -1,25 +1,30 @@
 {{snakeName}}.tact
-import "@stdlib/deploy";
-
 message Add {
-    queryId: Int as uint64;
     amount: Int as uint32;
 }
 
-contract {{name}} with Deployable {
-    id: Int as uint32;
-    counter: Int as uint32;
-
-    init(id: Int) {
-        self.id = id;
-        self.counter = 0;
+contract {{name}}(
+    // Persistent state variables declared via the
+    // contract parameters syntax, which was introduced in v1.6.0
+    //
+    // See: https://docs.tact-lang.org/book/contracts/#parameters
+    id: Int as uint32,
+    counter: Int as uint32,
+) {
+    // Empty receiver for the deployment,
+    // which expects the `null` message body
+    receive() {
+        // Forward the remaining value in the
+        // incoming message back to the sender
+        cashback(sender());
     }
 
     receive(msg: Add) {
         self.counter += msg.amount;
 
-        // Notify the caller that the receiver was executed and forward remaining value back
-        self.notify("Cashback".asComment());
+        // Forward the remaining value in the
+        // incoming message back to the sender
+        cashback(sender());
     }
 
     get fun counter(): Int {

package/dist/templates/tact/counter/scripts/deploy.ts.template

@@ -4,17 +4,14 @@ import { {{name}} } from '../wrappers/{{name}}';
 import { NetworkProvider } from '@ton/blueprint';
 
 export async function run(provider: NetworkProvider) {
-    const {{loweredName}} = provider.open(await {{name}}.fromInit(BigInt(Math.floor(Math.random() * 10000))));
+    const {{loweredName}} = provider.open(await {{name}}.fromInit(BigInt(Math.floor(Math.random() * 10000))), 0n);
 
     await {{loweredName}}.send(
         provider.sender(),
         {
             value: toNano('0.05'),
         },
-        {
-            $$type: 'Deploy',
-            queryId: 0n,
-        }
+        null,
     );
 
     await provider.waitForDeploy({{loweredName}}.address);

package/dist/templates/tact/counter/scripts/increment.ts.template

@@ -24,7 +24,6 @@ export async function run(provider: NetworkProvider, args: string[]) {
         },
         {
             $$type: 'Add',
-            queryId: 0n,
             amount: 1n,
         }
     );

package/dist/templates/tact/counter/tests/spec.ts.template

@@ -12,7 +12,7 @@ describe('{{name}}', () => {
     beforeEach(async () => {
         blockchain = await Blockchain.create();
 
-        {{loweredName}} = blockchain.openContract(await {{name}}.fromInit(0n));
+        {{loweredName}} = blockchain.openContract(await {{name}}.fromInit(0n, 0n));
 
         deployer = await blockchain.treasury('deployer');
 
@@ -21,10 +21,7 @@ describe('{{name}}', () => {
             {
                 value: toNano('0.05'),
             },
-            {
-                $$type: 'Deploy',
-                queryId: 0n,
-            }
+            null,
         );
 
         expect(deployResult.transactions).toHaveTransaction({
@@ -62,7 +59,6 @@ describe('{{name}}', () => {
                 },
                 {
                     $$type: 'Add',
-                    queryId: 0n,
                     amount: increaseBy,
                 }
             );

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

@@ -1,9 +1,19 @@
 {{snakeName}}.tact
-import "@stdlib/deploy";
-
-contract {{name}} with Deployable {
-    // Empty init() function is present by default in all Tact contracts
-    // since v1.3.0, so the following may be omitted:
-    //
-    // init() {}
+// Since v1.6.0, Tact has a contract parameters syntax that can supersede
+// lazy initialization by init() for all contracts that do not require specific on-chain
+// deployment logic that must be run only once in the `init()` function.
+//
+// Note that the empty parameter list above is still a parameter list,
+// meaning that the contract won't have an implicit or explicit `init(){:tact}` function
+// and will enjoy storage write optimizations and use less gas overall.
+//
+// See: https://docs.tact-lang.org/book/contracts/#parameters
+contract {{name}}() {
+    // Empty receiver for the deployment,
+    // which expects the `null` message body
+    receive() {
+        // Forward the remaining value in the
+        // incoming message back to the sender
+        cashback(sender());
+    }
 }

package/dist/templates/tact/empty/scripts/deploy.ts.template

@@ -11,10 +11,7 @@ export async function run(provider: NetworkProvider) {
         {
             value: toNano('0.05'),
         },
-        {
-            $$type: 'Deploy',
-            queryId: 0n,
-        }
+        null,
     );
 
     await provider.waitForDeploy({{loweredName}}.address);

package/dist/templates/tact/empty/tests/spec.ts.template

@@ -21,10 +21,7 @@ describe('{{name}}', () => {
             {
                 value: toNano('0.05'),
             },
-            {
-                $$type: 'Deploy',
-                queryId: 0n,
-            }
+            null,
         );
 
         expect(deployResult.transactions).toHaveTransaction({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -19,7 +19,7 @@
     "format": "prettier --write src"
   },
   "devDependencies": {
-    "@tact-lang/compiler": "^1.5.3",
+    "@tact-lang/compiler": "^1.6.5",
     "@ton-community/func-js": "^0.9.0",
     "@ton/core": "^0.59.0",
     "@ton/crypto": "^3.3.0",
@@ -32,7 +32,7 @@
     "typescript": "^4.9.5"
   },
   "peerDependencies": {
-    "@tact-lang/compiler": ">=1.5.3",
+    "@tact-lang/compiler": ">=1.6.5",
     "@ton-community/func-js": ">=0.9.0",
     "@ton/core": ">=0.59.0",
     "@ton/crypto": ">=3.3.0",