@ton/blueprint 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.42.0] - 2025-12-04
+
+### Added
+
+- Added `blueprint test --ui` command
+
+### Changed
+
+- Changed `@ton/sandbox` peer dependency to `>=0.40.0`
+
 ## [0.41.0] - 2025-09-23
 
 ### Added

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ton Tech
+
+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/dist/cli/constants.js

@@ -130,6 +130,8 @@ Runs ${chalk_1.default.green('npm test [...args]')}, which by default executes $
 
 ${chalk_1.default.bold('Options:')}
   ${chalk_1.default.cyan('--gas-report')}, ${chalk_1.default.cyan('-g')} - Run tests and compare with the last snapshot's metrics
+  ${chalk_1.default.cyan('--ui')} - Connects to sandbox UI server
+  ${chalk_1.default.cyan('--coverage')} - Collects tests coverage
 
 ${chalk_1.default.bold('SEE ALSO')}
   ${chalk_1.default.cyan('blueprint snapshot')}

package/dist/cli/test.d.ts

@@ -3,6 +3,6 @@ export declare const argSpec: {
     '--gas-report': BooleanConstructor;
     '-g': string;
     '--coverage': BooleanConstructor;
+    '--ui': BooleanConstructor;
 };
-export declare function coverage(): Promise<void>;
 export declare const test: Runner;

package/dist/cli/test.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = exports.argSpec = void 0;
-exports.coverage = coverage;
 const child_process_1 = require("child_process");
 const arg_1 = __importDefault(require("arg"));
 const constants_1 = require("./constants");
@@ -12,6 +11,7 @@ exports.argSpec = {
     '--gas-report': Boolean,
     '-g': '--gas-report',
     '--coverage': Boolean,
+    '--ui': Boolean,
 };
 async function coverage() {
     (0, child_process_1.execSync)(`npm test -- --reporters @ton/blueprint/dist/jest/CoverageReporter --setupFilesAfterEnv @ton/blueprint/dist/jest/coverageSetup`, {
@@ -35,6 +35,9 @@ const test = async (args, ui) => {
     if (localArgs['--gas-report']) {
         testArgs = testArgs.slice(1);
     }
+    if (localArgs['--ui']) {
+        testArgs = [...testArgs.slice(1), '--setupFilesAfterEnv', '@ton/sandbox/dist/jest/uiSetup'];
+    }
     (0, child_process_1.execSync)(`npm test -- ${testArgs.join(' ')}`, {
         stdio: 'inherit',
         env: {

package/dist/compile/SupportedLang.d.ts

@@ -0,0 +1 @@
+export type SupportedLang = 'tact' | 'tolk' | 'func';

package/dist/compile/SupportedLang.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/compile/compile.d.ts

@@ -3,6 +3,7 @@ import { CompilableConfig, CompilerConfig } from './CompilerConfig';
 import { FuncCompileResult } from './func/compile.func';
 import { TactCompileResult } from './tact/compile.tact';
 import { TolkCompileResult } from './tolk/compile.tolk';
+import { SupportedLang } from './SupportedLang';
 export declare function getCompilablesDirectory(): Promise<string>;
 export declare function extractCompilableConfig(path: string): CompilableConfig;
 export declare const COMPILE_END = ".compile.ts";
@@ -25,7 +26,7 @@ export declare const COMPILE_END = ".compile.ts";
 export declare function getCompilerConfigForContract(name: string): Promise<CompilerConfig>;
 export type CompileResult = TactCompileResult | FuncCompileResult | TolkCompileResult;
 export declare function getCompilerOptions(config: CompilerConfig): Promise<{
-    lang: 'tact' | 'tolk' | 'func';
+    lang: SupportedLang;
     version: string;
 }>;
 export declare function libraryCellFromCode(code: Cell): Cell;

package/dist/config/CustomNetwork.d.ts

@@ -1,6 +1,8 @@
+import { Network } from '../network/Network';
+import { NetworkVersion } from '../network/NetworkVersion';
 export type CustomNetwork = {
     endpoint: string;
-    version?: 'v2' | 'v4' | 'tonapi' | 'liteclient';
+    version?: NetworkVersion;
     key?: string;
-    type?: 'mainnet' | 'testnet' | 'custom';
+    type?: Network;
 };

package/dist/network/NetworkProvider.d.ts

@@ -4,6 +4,7 @@ import { ContractAdapter } from '@ton-api/ton-adapter';
 import { LiteClient } from 'ton-lite-client';
 import { UIProvider } from '../ui/UIProvider';
 import { Explorer } from './Explorer';
+import { Network } from './Network';
 export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter | LiteClient;
 type BlockchainConfig = ReturnType<typeof parseFullConfig>;
 export interface SenderWithSendResult extends Sender {
@@ -15,9 +16,9 @@ export interface SenderWithSendResult extends Sender {
 export interface NetworkProvider {
     /**
      * Returns the current network type.
-     * @returns {'mainnet' | 'testnet' | 'custom'} The type of network.
+     * @returns {Network} The type of network.
      */
-    network(): 'mainnet' | 'testnet' | 'custom';
+    network(): Network;
     /**
      * Returns the current explorer type.
      * @returns {Explorer} The type of explorer.

package/dist/network/NetworkVersion.d.ts

@@ -0,0 +1 @@
+export type NetworkVersion = 'v2' | 'v4' | 'tonapi' | 'liteclient';

package/dist/network/NetworkVersion.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/templates/func/counter/wrappers/wrapper.ts.template

@@ -1,5 +1,15 @@
 {{name}}.ts
-import { Address, beginCell, Cell, Contract, contractAddress, ContractProvider, Sender, SendMode } from '@ton/core';
+import {
+    Address,
+    beginCell,
+    Cell,
+    Contract,
+    ContractABI,
+    contractAddress,
+    ContractProvider,
+    Sender,
+    SendMode
+} from '@ton/core';
 
 export type {{name}}Config = {
     id: number;
@@ -15,6 +25,8 @@ export const Opcodes = {
 };
 
 export class {{name}} implements Contract {
+    abi: ContractABI = { name: '{{name}}' }
+
     constructor(readonly address: Address, readonly init?: { code: Cell; data: Cell }) {}
 
     static createFromAddress(address: Address) {

package/dist/templates/func/empty/wrappers/wrapper.ts.template

@@ -1,5 +1,15 @@
 {{name}}.ts
-import { Address, beginCell, Cell, Contract, contractAddress, ContractProvider, Sender, SendMode } from '@ton/core';
+import {
+    Address,
+    beginCell,
+    Cell,
+    Contract,
+    ContractABI,
+    contractAddress,
+    ContractProvider,
+    Sender,
+    SendMode
+} from '@ton/core';
 
 export type {{name}}Config = {};
 
@@ -8,6 +18,8 @@ export function {{loweredName}}ConfigToCell(config: {{name}}Config): Cell {
 }
 
 export class {{name}} implements Contract {
+    abi: ContractABI = { name: '{{name}}' }
+
     constructor(readonly address: Address, readonly init?: { code: Cell; data: Cell }) {}
 
     static createFromAddress(address: Address) {

package/dist/templates/tolk/counter/wrappers/wrapper.ts.template

@@ -1,5 +1,15 @@
 {{name}}.ts
-import { Address, beginCell, Cell, Contract, contractAddress, ContractProvider, Sender, SendMode } from '@ton/core';
+import {
+    Address,
+    beginCell,
+    Cell,
+    Contract,
+    ContractABI,
+    contractAddress,
+    ContractProvider,
+    Sender,
+    SendMode
+} from '@ton/core';
 
 export type {{name}}Config = {
     id: number;
@@ -16,6 +26,8 @@ export const Opcodes = {
 };
 
 export class {{name}} implements Contract {
+    abi: ContractABI = { name: '{{name}}' }
+
     constructor(readonly address: Address, readonly init?: { code: Cell; data: Cell }) {}
 
     static createFromAddress(address: Address) {

package/dist/templates/tolk/empty/wrappers/wrapper.ts.template

@@ -1,5 +1,15 @@
 {{name}}.ts
-import { Address, beginCell, Cell, Contract, contractAddress, ContractProvider, Sender, SendMode } from '@ton/core';
+import {
+    Address,
+    beginCell,
+    Cell,
+    Contract,
+    ContractABI,
+    contractAddress,
+    ContractProvider,
+    Sender,
+    SendMode
+} from '@ton/core';
 
 export type {{name}}Config = {};
 
@@ -8,6 +18,8 @@ export function {{loweredName}}ConfigToCell(config: {{name}}Config): Cell {
 }
 
 export class {{name}} implements Contract {
+    abi: ContractABI = { name: '{{name}}' }
+
     constructor(readonly address: Address, readonly init?: { code: Cell; data: Cell }) {}
 
     static createFromAddress(address: Address) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -26,10 +26,10 @@
     "@ton-community/func-js": "^0.10.0",
     "@ton/core": "^0.61.0",
     "@ton/crypto": "^3.3.0",
-    "@ton/sandbox": "^0.37.1",
+    "@ton/sandbox": "^0.40.0",
     "@ton/tolk-js": "^1.0.0",
     "@ton/ton": "^15.3.1",
-    "@ton/toolchain": "the-ton-tech/toolchain#v1.4.0",
+    "@ton/toolchain": "the-ton-tech/toolchain#v1.6.0",
     "@types/inquirer": "^8.2.6",
     "@types/jest": "^30.0.0",
     "@types/node": "^20.2.5",
@@ -45,7 +45,7 @@
     "@ton-community/func-js": ">=0.10.0",
     "@ton/core": ">=0.61.0",
     "@ton/crypto": ">=3.3.0",
-    "@ton/sandbox": "^0.37.1",
+    "@ton/sandbox": ">=0.40.0",
     "@ton/tolk-js": ">=0.13.0",
     "@ton/ton": ">=15.2.1"
   },