@ton/blueprint 0.40.0 → 0.41.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.41.0] - 2025-09-23
+
+### Added
+
+- Added `blueprint test --coverage` command 
+
+### Changed
+
+- When creating a contract, if the input contract name is invalid, blueprint does not exit, but asks for the name again
+
 ## [0.40.0] - 2025-08-18
 
 ### Added

package/README.md

@@ -41,7 +41,7 @@ npm create ton@latest
 
 ## Overview
 
-Blueprint is an all-in-one development environment designed to enhance the process of creating, testing, and deploying smart contracts on TON blockchain using [FunC](https://docs.ton.org/develop/func/overview), [Tolk](https://docs.ton.org/develop/tolk/overview), and [Tact](https://docs.tact-lang.org/) languages.
+Blueprint is an all-in-one development environment designed to enhance the process of creating, testing, and deploying smart contracts on TON blockchain using [Tolk](https://docs.ton.org/develop/tolk/overview), [FunC](https://docs.ton.org/develop/func/overview), and [Tact](https://docs.tact-lang.org/) languages.
 
 ### Core features
 
@@ -52,8 +52,8 @@ Blueprint is an all-in-one development environment designed to enhance the proce
 
 ### Tech stack
 
-1. Compiling FunC with https://github.com/ton-community/func-js
-2. Compiling Tolk with https://github.com/ton-blockchain/tolk-js
+1. Compiling Tolk with https://github.com/ton-blockchain/tolk-js
+2. Compiling FunC with https://github.com/ton-community/func-js
 3. Compiling Tact with https://github.com/tact-lang/tact
    * Uses [`tact.config.json`](https://docs.tact-lang.org/book/config/) as the build configuration file
 4. Testing smart contracts with https://github.com/ton-org/sandbox
@@ -63,9 +63,9 @@ 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), [Tolk plugin](https://marketplace.visualstudio.com/items?itemName=ton-core.tolk-vscode) or [Tact plugin](https://marketplace.visualstudio.com/items?itemName=tonstudio.vscode-tact)
+  * [Visual Studio Code](https://code.visualstudio.com/) with the [TON plugin](https://marketplace.visualstudio.com/items?itemName=ton-core.vscode-ton) or [Tact plugin](https://marketplace.visualstudio.com/items?itemName=tonstudio.vscode-tact)
   * [IntelliJ IDEA](https://www.jetbrains.com/idea/)
-    * [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton) for FunC, Tolk and Fift
+    * [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton) for Tolk, FunC and Fift
     * [Tact plugin by TON Studio](https://plugins.jetbrains.com/plugin/27290-tact) for Tact
 
 ## Features overview
@@ -139,9 +139,13 @@ Start by adding the following environment variables to your `.env` file:
 
 Once your environment is set up, you can use the mnemonic wallet for deployment with the appropriate configuration.
 
+### Updating Tolk version
+
+Tolk version can be updated to the latest using `npm update/yarn upgrade @ton/tolk-js` command
+
 ### Updating FunC version
 
-FunC version can be updated using `npx/yarn blueprint set func` command
+FunC version can be updated to a specific version using `npx/yarn blueprint set func` command, or to the latest using `npm update/yarn upgrade @ton-community/func-js` command
 
 ### Updating Tact version
 
@@ -158,8 +162,8 @@ Before developing, make sure that your current working directory is located in t
 ### Creating contracts
 
 1. Run interactive:    `npx blueprint create`   or   `yarn blueprint create`
-2. Non-interactive: &nbsp; `npx/yarn blueprint create <CONTRACT> --type <TYPE>` (type can be `func-empty`, `tolk-empty`, `tact-empty`, `func-counter`, `tolk-counter`, `tact-counter`)
-   * Example: `yarn blueprint create MyNewContract --type func-empty`
+2. Non-interactive: &nbsp; `npx/yarn blueprint create <CONTRACT> --type <TYPE>` (type can be `tolk-empty`, `func-empty`, `tact-empty`, `tolk-counter`, `func-counter`, `tact-counter`)
+   * Example: `yarn blueprint create MyNewContract --type tolk-empty`
 
 ### Renaming contracts
 
@@ -169,15 +173,15 @@ Before developing, make sure that your current working directory is located in t
 
 ### Writing contract code
 
+#### Tolk
+1. Implement the contract in `contracts/<CONTRACT>.tolk`; if you wish, split into multiple files
+2. Implement wrapper TypeScript class in `wrappers/<CONTRACT>.ts` to encode messages and decode getters
+
 #### FunC
 1. Implement the standalone FunC root contract in `contracts/<CONTRACT>.fc`
 2. Implement shared FunC imports (if breaking code to multiple files) in `contracts/imports/*.fc`
 3. Implement wrapper TypeScript class in `wrappers/<CONTRACT>.ts` to encode messages and decode getters
 
-#### Tolk
-1. Implement the contract in `contracts/<CONTRACT>.tolk`; if you wish, split into multiple files
-2. Implement wrapper TypeScript class in `wrappers/<CONTRACT>.ts` to encode messages and decode getters
-
 #### Tact
 1. Implement the contract in `contracts/<CONTRACT>.tact`
 2. Wrappers will be automatically generated in `build/<CONTRACT>/tact_<CONTRACT>.ts`
@@ -187,6 +191,10 @@ Before developing, make sure that your current working directory is located in t
 1. Implement TypeScript tests in `tests/<CONTRACT>.spec.ts`
 2. Rely on the wrapper TypeScript class from `wrappers/<CONTRACT>.ts` to interact with the contract
 
+#### Collecting coverage
+
+To collect coverage run `blueprint test --coverage`. Coverage will appear in coverage directory.
+
 > Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
 
 ### Publishing Wrapper Code

package/dist/cli/cli.js

@@ -55,6 +55,7 @@ const InquirerUIProvider_1 = require("../ui/InquirerUIProvider");
 const Runner_1 = require("./Runner");
 const utils_1 = require("../config/utils");
 const rename_1 = require("./rename");
+const constants_1 = require("./constants");
 const runners = {
     create: create_1.create,
     run: run_1.run,
@@ -121,34 +122,26 @@ main()
     .then(() => process.exit(0));
 function showHelp() {
     console.log(chalk_1.default.blueBright(`
-     ____  _    _   _ _____ ____  ____  ___ _   _ _____ 
+     ____  _    _   _ _____ ____  ____  ___ _   _ _____
     | __ )| |  | | | | ____|  _ \\|  _ \\|_ _| \\ | |_   _|
-    |  _ \\| |  | | | |  _| | |_) | |_) || ||  \\| | | |  
-    | |_) | |__| |_| | |___|  __/|  _ < | || |\\  | | |  
+    |  _ \\| |  | | | |  _| | |_) | |_) || ||  \\| | | |
+    | |_) | |__| |_| | |___|  __/|  _ < | || |\\  | | |
     |____/|_____\\___/|_____|_|   |_| \\_\\___|_| \\_| |_|  `));
     console.log(chalk_1.default.blue(`                     TON development for professionals`));
     console.log(``);
     console.log(` Usage: blueprint [OPTIONS] COMMAND [ARGS]`);
     console.log(``);
-    console.log(chalk_1.default.cyanBright(`  blueprint create`) +
-        `\t` +
-        chalk_1.default.whiteBright(`create a new contract with .fc source, .ts wrapper, .spec.ts test`));
-    console.log(`\t\t\t` + chalk_1.default.gray(`blueprint create ContractName`));
-    console.log(chalk_1.default.cyanBright(`  blueprint build`) +
-        `\t` +
-        chalk_1.default.whiteBright(`builds a contract that has a .compile.ts file`));
-    console.log(`\t\t\t` + chalk_1.default.gray(`blueprint build ContractName`));
-    console.log(chalk_1.default.cyanBright(`  blueprint test`) +
-        `\t` +
-        chalk_1.default.whiteBright(`run the full project test suite with all .spec.ts files`));
-    console.log(`\t\t\t` + chalk_1.default.gray(`blueprint test`));
-    console.log(chalk_1.default.cyanBright(`  blueprint run `) +
-        `\t` +
-        chalk_1.default.whiteBright(`runs a script from 'scripts' directory (eg. a deploy script)`));
-    console.log(`\t\t\t` + chalk_1.default.gray(`blueprint run deployContractName`));
-    console.log(chalk_1.default.cyanBright(`  blueprint help`) +
-        `\t` +
-        chalk_1.default.whiteBright(`shows more detailed help, also see https://github.com/ton-org/blueprint`));
-    console.log(`\t\t\t` + chalk_1.default.gray(`blueprint help`));
+    const mainPageCommands = new Set(['create', 'build', 'test', 'run', 'help']);
+    for (const cmd of constants_1.availableCommands) {
+        if (!mainPageCommands.has(cmd.name)) {
+            continue;
+        }
+        const commandName = `  blueprint ${cmd.name}`;
+        const description = cmd.description;
+        const cmdPadding = ' '.repeat(Math.max(0, 24 - commandName.length));
+        const examplePadding = ' '.repeat(cmdPadding.length + commandName.length);
+        console.log(chalk_1.default.cyanBright(commandName) + cmdPadding + chalk_1.default.whiteBright(description));
+        console.log(examplePadding + chalk_1.default.gray(cmd.example));
+    }
     console.log(``);
 }

package/dist/cli/constants.d.ts

@@ -6,6 +6,13 @@ export declare const helpArgs: {
     '--help': BooleanConstructor;
     '-h': string;
 };
+export type KnownCommandName = 'create' | 'run' | 'build' | 'set' | 'help' | 'test' | 'verify' | 'convert' | 'rename' | 'pack' | 'snapshot';
+export interface CommandInfo {
+    readonly name: KnownCommandName;
+    readonly description: string;
+    readonly example: string;
+}
+export declare const availableCommands: CommandInfo[];
 export declare const helpMessages: {
     help: string;
     create: string;

package/dist/cli/constants.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.helpMessages = exports.helpArgs = exports.templateTypes = void 0;
+exports.helpMessages = exports.availableCommands = exports.helpArgs = exports.templateTypes = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 exports.templateTypes = [
     {
@@ -32,18 +32,46 @@ exports.templateTypes = [
     },
 ];
 exports.helpArgs = { '--help': Boolean, '-h': '--help' };
-const availableCommands = [
-    'create',
-    'run',
-    'build',
-    'set',
-    'help',
-    'test',
-    'verify',
-    'convert',
-    'rename',
-    'pack',
-    'snapshot',
+exports.availableCommands = [
+    {
+        name: 'create',
+        description: 'create a new contract with .fc source, .ts wrapper, .spec.ts test',
+        example: 'blueprint create ContractName',
+    },
+    {
+        name: 'build',
+        description: 'builds a contract that has a .compile.ts file',
+        example: 'blueprint build ContractName',
+    },
+    { name: 'test', description: 'run the full project test suite with all .spec.ts files', example: 'blueprint test' },
+    {
+        name: 'run',
+        description: "runs a script from 'scripts' directory (eg. a deploy script)",
+        example: 'blueprint run deployContractName',
+    },
+    {
+        name: 'help',
+        description: 'shows more detailed help, also see https://github.com/ton-org/blueprint',
+        example: 'blueprint help',
+    },
+    { name: 'set', description: 'sets configuration values', example: 'blueprint set' },
+    { name: 'verify', description: 'verifies a deployed contract on verifier.ton.org', example: 'blueprint verify' },
+    {
+        name: 'convert',
+        description: 'converts legacy bash build scripts to Blueprint wrappers',
+        example: 'blueprint convert',
+    },
+    {
+        name: 'rename',
+        description: 'renames contract by matching in wrappers, scripts and tests',
+        example: 'blueprint rename',
+    },
+    { name: 'pack', description: 'builds and prepares a publish-ready package of wrappers', example: 'blueprint pack' },
+    {
+        name: 'snapshot',
+        description: 'creates snapshots with gas usage and cells sizes',
+        example: 'blueprint snapshot',
+    },
 ];
 exports.helpMessages = {
     help: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('help')} [${chalk_1.default.yellow('command')}]
@@ -54,7 +82,9 @@ Blueprint is generally invoked as follows:
   ${chalk_1.default.cyan('blueprint')} ${chalk_1.default.yellow('[command]')} ${chalk_1.default.gray('[command-args]')} ${chalk_1.default.gray('[flags]')}
 
 ${chalk_1.default.bold('List of available commands:')}
-${availableCommands.map((c) => `- ${chalk_1.default.green(c)}`).join('\n')}`,
+${exports.availableCommands.map((c) => `  ${chalk_1.default.cyanBright(c.name)}${' '.repeat(Math.max(0, 20 - c.name.length))}${c.description}`).join('\n')}
+
+To get more information about a command, run ${chalk_1.default.cyan('blueprint help <command>')}`,
     create: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('create')} ${chalk_1.default.yellow('[contract name]')} ${chalk_1.default.gray('[flags]')}
 
 Creates a new contract together with supporting files according to a template.

package/dist/cli/create.d.ts

@@ -1,2 +1,4 @@
 import { Runner } from './Runner';
+import { UIProvider } from '../ui/UIProvider';
 export declare const create: Runner;
+export declare function requestContractName(message: string, ui: UIProvider): Promise<string>;

package/dist/cli/create.js

@@ -4,10 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.create = void 0;
+exports.requestContractName = requestContractName;
 const path_1 = __importDefault(require("path"));
 const posix_1 = __importDefault(require("path/posix"));
 const promises_1 = require("fs/promises");
 const arg_1 = __importDefault(require("arg"));
+const chalk_1 = __importDefault(require("chalk"));
 const utils_1 = require("../config/utils");
 const tact_config_1 = require("../config/tact.config");
 const Runner_1 = require("./Runner");
@@ -80,8 +82,14 @@ const create = async (_args, ui) => {
         ui.write(constants_1.helpMessages['create']);
         return;
     }
-    const name = (0, Runner_1.extractFirstArg)(localArgs) ?? (await ui.input('Contract name (PascalCase)'));
-    (0, utils_2.assertValidContractName)(name);
+    const argName = (0, Runner_1.extractFirstArg)(localArgs);
+    if (argName !== undefined) {
+        const error = (0, utils_2.validateContractName)(argName);
+        if (error) {
+            throw new Error(error);
+        }
+    }
+    const name = argName ?? (await requestContractName('Contract name (PascalCase)', ui));
     const which = (await (0, utils_2.selectOption)(constants_1.templateTypes, {
         ui,
         msg: 'What type of contract do you want to create?',
@@ -109,3 +117,15 @@ const create = async (_args, ui) => {
     }
 };
 exports.create = create;
+async function requestContractName(message, ui) {
+    while (true) {
+        const name = await ui.input(message);
+        const error = (0, utils_2.validateContractName)(name);
+        if (error !== undefined) {
+            ui.write(chalk_1.default.redBright(`Error: `) + error);
+            // ask user again
+            continue;
+        }
+        return name;
+    }
+}

package/dist/cli/rename.js

@@ -13,6 +13,7 @@ const Runner_1 = require("./Runner");
 const utils_1 = require("../utils");
 const constants_1 = require("./constants");
 const build_1 = require("./build");
+const create_1 = require("./create");
 function renameExactIfRequired(str, replaces) {
     let renamedString = str;
     let isRenamed = false;
@@ -71,8 +72,14 @@ const rename = async (_args, ui, _context) => {
         return;
     }
     const oldName = await (0, build_1.selectContract)(ui, (0, Runner_1.extractFirstArg)(localArgs));
-    const newName = (0, Runner_1.extractSecondArg)(localArgs) ?? (await ui.input('New contract name (PascalCase)'));
-    (0, utils_1.assertValidContractName)(newName);
+    const argName = (0, Runner_1.extractSecondArg)(localArgs);
+    if (argName !== undefined) {
+        const error = (0, utils_1.validateContractName)(argName);
+        if (error) {
+            throw new Error(error);
+        }
+    }
+    const newName = argName ?? (await (0, create_1.requestContractName)('New contract name (PascalCase)', ui));
     const contracts = await (0, utils_1.findContracts)();
     if (contracts.includes(newName)) {
         ui.write(`Contract with name ${newName} already exists.`);

package/dist/cli/test.d.ts

@@ -2,5 +2,7 @@ import { Runner } from './Runner';
 export declare const argSpec: {
     '--gas-report': BooleanConstructor;
     '-g': string;
+    '--coverage': BooleanConstructor;
 };
+export declare function coverage(): Promise<void>;
 export declare const test: Runner;

package/dist/cli/test.js

@@ -4,13 +4,20 @@ 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");
 exports.argSpec = {
     '--gas-report': Boolean,
     '-g': '--gas-report',
+    '--coverage': Boolean,
 };
+async function coverage() {
+    (0, child_process_1.execSync)(`npm test -- --reporters @ton/blueprint/dist/jest/CoverageReporter --setupFilesAfterEnv @ton/blueprint/dist/jest/coverageSetup`, {
+        stdio: 'inherit',
+    });
+}
 const test = async (args, ui) => {
     const localArgs = (0, arg_1.default)({
         ...constants_1.helpArgs,
@@ -20,6 +27,10 @@ const test = async (args, ui) => {
         ui.write(constants_1.helpMessages['test']);
         return;
     }
+    if (localArgs['--coverage']) {
+        await coverage();
+        return;
+    }
     let testArgs = args._.slice(1); // first argument is `test`, need to get rid of it
     if (localArgs['--gas-report']) {
         testArgs = testArgs.slice(1);

package/dist/cli/verify.js

@@ -151,7 +151,7 @@ const verify = async (_args, ui, context) => {
     if (network === 'custom') {
         throw new Error('Cannot use custom network');
     }
-    const result = await (0, compile_1.doCompile)(selectedContract);
+    const result = await (0, compile_1.doCompile)(selectedContract, { buildLibrary: false });
     const resHash = result.code.hash();
     ui.write(`Compiled code hash hex: ${resHash.toString('hex')}`);
     ui.write('We can look up the address with such code hash in the blockchain automatically');

package/dist/jest/CoverageReporter.d.ts

@@ -0,0 +1,11 @@
+import type { Reporter } from '@jest/reporters';
+declare class CoverageReporter implements Reporter {
+    private contracts;
+    private get coverageDir();
+    private get blueprintCoverageDir();
+    onRunStart(): Promise<void>;
+    onRunComplete(): Promise<void>;
+    private printSummary;
+    private collectLogs;
+}
+export default CoverageReporter;

package/dist/jest/CoverageReporter.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const fs_1 = require("fs");
+const core_1 = require("@ton/core");
+// @ts-expect-error blueprint imported inside package
+const blueprint_1 = require("@ton/blueprint");
+const sandbox_1 = require("@ton/sandbox");
+const chalk_1 = __importDefault(require("chalk"));
+class CoverageReporter {
+    constructor() {
+        this.contracts = [];
+    }
+    get coverageDir() {
+        return node_path_1.default.join(process.cwd(), 'coverage');
+    }
+    get blueprintCoverageDir() {
+        return node_path_1.default.join(this.coverageDir, 'blueprint');
+    }
+    async onRunStart() {
+        console.log(`\n🛠️  Building contracts...`);
+        await (0, blueprint_1.buildAll)();
+        const buildDir = node_path_1.default.join(process.cwd(), 'build');
+        const buildFiles = (await promises_1.default.readdir(buildDir)).filter((f) => f.endsWith('.json'));
+        const contents = await Promise.all(buildFiles.map((f) => promises_1.default.readFile(node_path_1.default.join(buildDir, f), 'utf-8')));
+        this.contracts = contents.map((json, i) => ({
+            name: node_path_1.default.basename(buildFiles[i], '.compiled.json'),
+            ...JSON.parse(json),
+        }));
+        console.log(`✅ Built ${this.contracts.length} contracts: ${this.contracts.map((c) => c.name).join(', ')}`);
+        if ((0, fs_1.existsSync)(this.blueprintCoverageDir)) {
+            console.log(`🧹 Cleaning old coverage at ${this.blueprintCoverageDir}`);
+            await promises_1.default.rm(this.blueprintCoverageDir, { recursive: true, force: true });
+        }
+    }
+    async onRunComplete() {
+        if (!(0, fs_1.existsSync)(this.blueprintCoverageDir)) {
+            console.log(`⚠️  No blueprint coverage data found, skipping coverage reports.`);
+            return;
+        }
+        console.log(`\n📄 Collecting coverage logs...`);
+        const logs = await this.collectLogs();
+        console.log(`\n📝 Generating coverage reports...`);
+        for (const { name, hex } of this.contracts) {
+            const codeCell = core_1.Cell.fromHex(hex);
+            const merged = (0, sandbox_1.mergeCoverages)(...logs.map((l) => (0, sandbox_1.collectAsmCoverage)(codeCell, l)));
+            const coverage = new sandbox_1.Coverage(merged);
+            const report = coverage.report('html');
+            const reportPath = node_path_1.default.join(this.coverageDir, `${name}-report.html`);
+            await promises_1.default.writeFile(reportPath, report);
+            const summary = coverage.summary();
+            this.printSummary(name, summary, reportPath);
+        }
+        console.log(`\n✅ Coverage reports generated in ${this.coverageDir}\n`);
+    }
+    printSummary(name, summary, reportPath) {
+        const pct = summary.coveragePercentage.toFixed(2) + '%';
+        const line = chalk_1.default.bold(name.padEnd(20)) +
+            chalk_1.default.white(`${summary.coveredLines}/${summary.totalLines} lines`.padEnd(20)) +
+            (summary.coveragePercentage >= 80 ? chalk_1.default.green(pct.padEnd(10)) : chalk_1.default.red(pct.padEnd(10))) +
+            chalk_1.default.gray(reportPath);
+        console.log('   • ' + line);
+    }
+    async collectLogs() {
+        const files = (await promises_1.default.readdir(this.blueprintCoverageDir, { recursive: true })).filter((f) => f.endsWith('.json'));
+        const contents = await Promise.all(files.map((f) => promises_1.default.readFile(node_path_1.default.join(this.blueprintCoverageDir, f), 'utf-8')));
+        return contents.flatMap((content) => {
+            const { txLogs, getLogs } = JSON.parse(content);
+            return [...txLogs, ...getLogs];
+        });
+    }
+}
+exports.default = CoverageReporter;

package/dist/jest/coverageSetup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/jest/coverageSetup.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const sandbox_1 = require("@ton/sandbox");
+const txLogs = [];
+const getLogs = [];
+beforeAll(() => {
+    const originalCreate = sandbox_1.Blockchain.create.bind(sandbox_1.Blockchain);
+    sandbox_1.Blockchain.create = async (...args) => {
+        const blockchain = await originalCreate(...args);
+        blockchain.enableCoverage();
+        const originalVerbosity = { ...blockchain.verbosity };
+        originalVerbosity.print = false;
+        originalVerbosity.vmLogs = 'vm_logs_verbose';
+        Object.defineProperty(blockchain, 'verbosity', {
+            get() {
+                return originalVerbosity;
+            },
+            set(_) {
+                // prevent changes
+            },
+        });
+        blockchain.verbosity = originalVerbosity;
+        // @ts-expect-error error
+        const origRegisterTx = blockchain.registerTxsForCoverage.bind(blockchain);
+        // @ts-expect-error error
+        const origRegisterGet = blockchain.registerGetMethodForCoverage.bind(blockchain);
+        // @ts-expect-error error
+        blockchain.registerTxsForCoverage = (txs) => {
+            txLogs.push(...txs.map((tx) => tx.vmLogs));
+            return origRegisterTx(txs);
+        };
+        // @ts-expect-error error
+        blockchain.registerGetMethodForCoverage = (gets) => {
+            getLogs.push(gets.vmLogs);
+            return origRegisterGet(gets);
+        };
+        return blockchain;
+    };
+});
+afterAll(() => {
+    const coveragePath = node_path_1.default.join(process.cwd(), 'coverage');
+    const blueprintCoveragePath = node_path_1.default.join(coveragePath, 'blueprint');
+    const testPath = expect.getState().testPath;
+    const testRelative = node_path_1.default.relative(process.cwd(), testPath);
+    const logsFilePath = node_path_1.default.join(blueprintCoveragePath, testRelative + '.json');
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logsFilePath), { recursive: true });
+    node_fs_1.default.writeFileSync(logsFilePath, JSON.stringify({ txLogs, getLogs }, null, 2));
+});

package/dist/network/Explorer.d.ts

@@ -0,0 +1 @@
+export type Explorer = 'tonscan' | 'tonviewer' | 'toncx' | 'dton';

package/dist/network/Explorer.js

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

package/dist/network/NetworkProvider.d.ts

@@ -3,6 +3,7 @@ import { Address, Cell, Contract, ContractProvider, ContractState, OpenedContrac
 import { ContractAdapter } from '@ton-api/ton-adapter';
 import { LiteClient } from 'ton-lite-client';
 import { UIProvider } from '../ui/UIProvider';
+import { Explorer } from './Explorer';
 export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter | LiteClient;
 type BlockchainConfig = ReturnType<typeof parseFullConfig>;
 export interface SenderWithSendResult extends Sender {
@@ -17,6 +18,11 @@ export interface NetworkProvider {
      * @returns {'mainnet' | 'testnet' | 'custom'} The type of network.
      */
     network(): 'mainnet' | 'testnet' | 'custom';
+    /**
+     * Returns the current explorer type.
+     * @returns {Explorer} The type of explorer.
+     */
+    explorer(): Explorer;
     /**
      * Returns the sender used for transactions.
      * @example