@ton/blueprint 0.21.0 → 0.23.0-debugger.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ 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.22.0] - 2024-07-08
+
+### Added
+
+- Added support for scripts in subdirectories, for example `scripts/counter/deploy.ts`
+- Added the ability to specify test files in `blueprint test` command, for example `blueprint test Counter` 
+
+### Changed
+
+- Separated compilables and wrappers
+
+### Fixed
+
+- Fixed `code overflow` error when generating QR code for ton:// link
+
 ## [0.21.0] - 2024-05-27
 
 ### Changed

package/README.md

@@ -4,106 +4,155 @@
 
 A development environment for TON blockchain for writing, testing, and deploying smart contracts.
 
-### Quick start 🚀
-
-Run the following in terminal to create a new project and follow the on-screen instructions:
+## Table of Contents
+
+* [Quick start](#quick-start-)
+* [Overview](#overview)
+  * [Core features](#core-features)
+  * [Tech stack](#tech-stack)
+  * [Requirements](#requirements)
+* [Features overview](#features-overview)
+  * [Project creation](#project-creation)
+  * [Directory structure](#directory-structure)
+  * [Building contracts](#building-contracts)
+  * [Running the test suites](#running-the-test-suites)
+  * [Deploying contracts](#deploying-contracts)
+  * [Custom scripts](#custom-scripts)
+* [Contract development](#contract-development)
+  * [Creating contracts](#creating-contracts)
+  * [Writing contract code](#writing-contract-code)
+  * [Testing contracts](#testing-contracts)
+* [Configuration](#configuration)
+  * [Plugins](#plugins)
+  * [Custom network](#custom-network)
+* [Contributors](#contributors)
+* [License](#license)
+* [Donations](#donations)
+
+## Quick start 🚀
+
+Run the command in terminal to create a new project and follow the on-screen instructions:
 
 ```console
 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) and [Tact](https://docs.tact-lang.org/) languages
 
-### Core features 🔥
+### Core features
 
-* Create a development environment from template in one click - `npm create ton@latest`
+* Create a development environment from template - `npm create ton@latest`
 * Streamlined workflow for building, testing and deploying smart contracts
 * Dead simple deployment to mainnet/testnet using your favorite wallet (eg. Tonkeeper)
 * Blazing fast testing of multiple smart contracts in an isolated blockchain running in-process
 
 ### Tech stack
 
-1. Compiling FunC with https://github.com/ton-community/func-js (no CLI)
-2. Testing smart contracts with https://github.com/ton-org/sandbox
-3. Deploying smart contracts with [TON Connect 2](https://github.com/ton-connect), [Tonhub wallet](https://tonhub.com/) or a `ton://` deeplink
+1. Compiling FunC with https://github.com/ton-community/func-js
+2. Compiling Tact with https://github.com/tact-lang/tact
+3. Testing smart contracts with https://github.com/ton-org/sandbox
+4. Deploying smart contracts with [TON Connect 2](https://github.com/ton-connect), [Tonhub wallet](https://tonhub.com/) or a `ton://` deeplink
 
 ### 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/23382-ton)
+* [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)
+  * [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton)
 
- 
+## Features overview
 
-## Create a new project
+### Project creation
 
-1. Run and follow the on-screen instructions:    `npm create ton@latest`   or   `npx create-ton@latest`
-2. (Optional) Then from the project directory:   `npm install`   or   `yarn install`
+1. Run and follow the on-screen instructions:   `npm create ton@latest`   or   `npx create-ton@latest`
+2. From the project directory run   `npm/yarn install`   to install dependencies
 
 ### Directory structure
 
-* `contracts/` - Source code in [FunC](https://ton.org/docs/develop/func/overview) for all smart contracts and their imports
+* `contracts/` - Source code in [FunC](https://docs.ton.org/develop/func/overview) or [Tact](https://tact-lang.org/) for all smart contracts and their imports
 * `wrappers/` - TypeScript interface classes for all contracts (implementing `Contract` from [@ton/core](https://www.npmjs.com/package/@ton/core))
   * include message [de]serialization primitives, getter wrappers and compilation functions
   * used by the test suite and client code to interact with the contracts from TypeScript
+* `compilables/` - Compilations scripts for contracts
 * `tests/` - TypeScript test suite for all contracts (relying on [Sandbox](https://github.com/ton-org/sandbox) for in-process tests)
 * `scripts/` - Deployment scripts to mainnet/testnet and other scripts interacting with live contracts
 * `build/` - Compilation artifacts created here after running a build command
 
-### Build contracts
+### Building contracts
 
-1. You need a compilation script in `wrappers/<CONTRACT>.compile.ts` - [example](/example/wrappers/Counter.compile.ts)
+1. You need a compilation script in `compilables/<CONTRACT>.compile.ts` - [example](/example/compilables/Counter.compile.ts)
 2. Run interactive: &nbsp;&nbsp; `npx blueprint build` &nbsp; or &nbsp; `yarn blueprint build`
 3. Non-interactive: &nbsp; `npx/yarn blueprint build <CONTRACT>` &nbsp; OR build all contracts &nbsp; `yarn blueprint build --all`
    * Example: `yarn blueprint build counter`
 4. Build results are generated in `build/<CONTRACT>.compiled.json`
+5. Tact generated files are located in `build/<CONTRACT>` directory
 
-### Run the test suite
+### Running the test suites
 
 1. Run in terminal: &nbsp; `npx blueprint test` &nbsp; or &nbsp; `yarn blueprint test`
 2. Alternative method: &nbsp; `npm test` &nbsp; or &nbsp; `yarn test`
+3. You can specify test file to run:  &nbsp; `npm/yarn test <CONTRACT>`
+    * Example: `yarn test counter`
 
 > Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
 
-### Deploy one of the contracts
+### Deploying contracts
 
-1. You need a deploy script in `scripts/deploy<CONTRACT>.ts` - [example](/example/scripts/deployCounter.ts)
+1. You need a deployment script in `scripts/deploy<CONTRACT>.ts` - [example](/example/scripts/deployCounter.ts)
 2. Run interactive: &nbsp;&nbsp; `npx blueprint run` &nbsp; or &nbsp; `yarn blueprint run`
-3. Non-interactive: &nbsp; `npx/yarn blueprint run <CONTRACT> --<NETWORK> --<DEPLOY_METHOD>`
+3. Non-interactive: &nbsp; `npx/yarn blueprint run deploy<CONTRACT> --<NETWORK> --<DEPLOY_METHOD>`
    * Example: `yarn blueprint run deployCounter --mainnet --tonconnect`
 
+### Custom scripts
+
+1. Custom scripts should be located in `scripts` folder
+2. Script file must have exported function `run`
+```ts
+export async function run(provider: NetworkProvider) {
+  // 
+}
+```
+3. Script can be run using `npx/yarn blueprint run <SCRIPT>` command
+
+### Updating FunC version
+
+FunC version can be updated using `npx/yarn blueprint set func` command
+
 ### Help and additional commands
 
 Run in terminal: &nbsp; `npx blueprint help` &nbsp; or &nbsp; `yarn blueprint help`
 
-&nbsp;
+## Contract development
+
+Before developing, make sure that your current working directory is located in the root of the project created using `npm create ton@latest`
 
-## Develop a new contract
+### Creating contracts
 
-1. Make sure you have a project to host the contract
-2. Run interactive: &nbsp;&nbsp; `npx blueprint create` &nbsp; or &nbsp; `yarn blueprint create`
-3. Non-interactive: &nbsp; `npx/yarn blueprint create <CONTRACT> --type <TYPE>` (type can be `func-empty`, `func-counter`, `tact-empty`, `tact-counter`)
+1. Run interactive: &nbsp;&nbsp; `npx blueprint create` &nbsp; or &nbsp; `yarn blueprint create`
+2. Non-interactive: &nbsp; `npx/yarn blueprint create <CONTRACT> --type <TYPE>` (type can be `func-empty`, `func-counter`, `tact-empty`, `tact-counter`)
    * Example: `yarn blueprint create MyNewContract --type func-empty`
 
-### Contract code
+### Writing contract code
 
+#### 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
 
-### Test suite
+#### Tact
+1. Implement tact contract in `contracts/<CONTRACT>.tact`
+2. Wrappers will be automatically generated in `build/<CONTRACT>/tact_<CONTRACT>.ts`
+
+### Testing contracts
 
 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
 
 > Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
 
-### Compilation and deployment
-
-1. Implement a compilation script in `wrappers/<CONTRACT>.compile.ts`
-2. Implement a deployment script in `scripts/deploy<CONTRACT>.ts`
-3. Rely on the wrapper TypeScript class from `wrappers/<CONTRACT>.ts` to initialize the contract
-
-## Config
+## Configuration
 
 A config may be created in order to control some of blueprint's features. If a config is needed, create a `blueprint.config.ts` file in the root of your project with something like this:
 ```typescript

package/dist/cli/build.js

@@ -7,6 +7,7 @@ exports.build = exports.selectCompile = void 0;
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
 const build_1 = require("../build");
+const constants_1 = require("./constants");
 async function selectCompile(ui, args) {
     return await (0, utils_1.selectFile)(await (0, utils_1.findCompiles)(), {
         ui,
@@ -18,7 +19,12 @@ exports.selectCompile = selectCompile;
 const build = async (args, ui) => {
     const localArgs = (0, arg_1.default)({
         '--all': Boolean,
+        ...constants_1.helpArgs,
     });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['build']);
+        return;
+    }
     if (localArgs['--all']) {
         await (0, build_1.buildAll)();
     }

package/dist/cli/cli.js

@@ -41,7 +41,7 @@ const convert_1 = require("./convert");
 const help_1 = require("./help");
 const InquirerUIProvider_1 = require("../ui/InquirerUIProvider");
 const Runner_1 = require("./Runner");
-const path_1 = __importDefault(require("path"));
+const utils_1 = require("../config/utils");
 const runners = {
     create: create_1.create,
     run: run_1.run,
@@ -53,7 +53,6 @@ const runners = {
     convert: convert_1.convert,
 };
 async function main() {
-    var _a;
     require('ts-node/register');
     const args = (0, arg_1.default)(Runner_1.argSpec, {
         permissive: true,
@@ -64,28 +63,20 @@ async function main() {
     }
     let effectiveRunners = {};
     const runnerContext = {};
+    const config = await (0, utils_1.getConfig)();
     try {
-        const configModule = await (_a = path_1.default.join(process.cwd(), 'blueprint.config.ts'), Promise.resolve().then(() => __importStar(require(_a))));
-        try {
-            if ('config' in configModule && typeof configModule.config === 'object') {
-                const config = configModule.config;
-                runnerContext.config = config;
-                for (const plugin of config.plugins ?? []) {
-                    for (const runner of plugin.runners()) {
-                        effectiveRunners[runner.name] = runner.runner;
-                        help_1.additionalHelpMessages[runner.name] = runner.help;
-                    }
-                }
+        runnerContext.config = config;
+        for (const plugin of config?.plugins ?? []) {
+            for (const runner of plugin.runners()) {
+                effectiveRunners[runner.name] = runner.runner;
+                help_1.additionalHelpMessages[runner.name] = runner.help;
             }
         }
-        catch (e) {
-            // if plugin.runners() throws
-            console.error('Could not load one or more plugins');
-            console.error(e);
-        }
     }
     catch (e) {
-        // no config
+        // if plugin.runners() throws
+        console.error('Could not load one or more plugins');
+        console.error(e);
     }
     effectiveRunners = {
         ...effectiveRunners,

package/dist/cli/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const templateTypes: {
+    name: string;
+    value: string;
+}[];
+export declare const helpArgs: {
+    '--help': BooleanConstructor;
+};
+export declare const helpMessages: {
+    help: string;
+    create: string;
+    run: string;
+    build: string;
+    set: string;
+    test: string;
+    verify: string;
+    convert: string;
+};

package/dist/cli/constants.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpMessages = exports.helpArgs = exports.templateTypes = void 0;
+exports.templateTypes = [
+    {
+        name: 'An empty contract (FunC)',
+        value: 'func-empty',
+    },
+    {
+        name: 'A simple counter contract (FunC)',
+        value: 'func-counter',
+    },
+    {
+        name: 'An empty contract (TACT)',
+        value: 'tact-empty',
+    },
+    {
+        name: 'A simple counter contract (TACT)',
+        value: 'tact-counter',
+    },
+];
+exports.helpArgs = { '--help': Boolean };
+exports.helpMessages = {
+    help: `Usage: blueprint help [command]
+
+Displays this message if no command is specified, or displays detailed help for the specified command.
+
+Blueprint is generally invoked as follows: blueprint [command] [command-args] [flags]
+
+List of available commands:
+- create
+- run
+- build
+- set
+- help
+- test
+- verify
+- convert`,
+    create: `Usage: blueprint create [contract name] [flags]
+
+Creates a new contract together with supporting files according to a template.
+
+Contract name must be specified in PascalCase and may only include characters a-z, A-Z, 0-9. If not specified on the command line, it will be asked interactively.
+
+Flags:
+--type <type> - specifies the template type to use when creating the contract. If not specified on the command line, it will be asked interactively.
+List of available types:
+${exports.templateTypes.map((t) => `${t.value} - ${t.name}`).join('\n')}`,
+    run: `Usage: blueprint run [script name] [flags]
+
+Runs a script from the scripts directory.
+
+Script name is matched (ignoring case) to a file in the scripts directory. If not specified on the command line, the available scripts will be presented interactively.
+
+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-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, --tonhub, --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.`,
+    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.
+
+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.
+
+Flags:
+--all - builds all buildable contracts instead of just one.`,
+    set: `Usage: blueprint set <key> [value]
+Available keys:
+- func - overrides @ton-community/func-js-bin version, effectively setting the func version. The required version may be passed as the value, otherwise available versions will be displayed.`,
+    test: `Usage: blueprint test [...args]
+
+Just runs \`npm test [...args]\`, which by default runs \`jest\`.`,
+    verify: `Usage: blueprint verify [contract name] [flags]
+
+Builds a contract (similar to build command) and verifies it on https://verifier.ton.org. The contract must be already deployed on the network. If the contract's name is not specified on the command line, it will be asked interactively.
+
+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/) Requires --custom-type to be specified.
+--custom-version - specifies the API version to use with the custom API. Options: v2 (defualt), 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: mainnet, testnet.`,
+    convert: `Usage: blueprint convert [path to build script]
+Atempts to convert legacy bash build script to a blueprint compile wrapper.`,
+};

package/dist/cli/convert.js

@@ -10,6 +10,7 @@ const arg_1 = __importDefault(require("arg"));
 const createNetworkProvider_1 = require("../network/createNetworkProvider");
 const template_1 = require("../template");
 const paths_1 = require("../paths");
+const constants_1 = require("./constants");
 function createWrapperName(old) {
     return old
         .split(/[-_]/)
@@ -80,7 +81,11 @@ function parseCompileString(str, src_dir, ui) {
     };
 }
 const convert = async (args, ui) => {
-    const localArgs = (0, arg_1.default)(createNetworkProvider_1.argSpec);
+    const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['convert']);
+        return;
+    }
     let filePath;
     if (localArgs._.length < 2) {
         filePath = await ui.input('Please specify path to convert from:');

package/dist/cli/create.js

@@ -10,6 +10,8 @@ const template_1 = require("../template");
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
 const build_1 = require("../build");
+const utils_2 = require("../config/utils");
+const constants_1 = require("./constants");
 function toSnakeCase(v) {
     const r = v.replace(/[A-Z]/g, (sub) => '_' + sub.toLowerCase());
     return r[0] === '_' ? r.substring(1) : r;
@@ -66,7 +68,12 @@ exports.templateTypes = [
 const create = async (args, ui) => {
     const localArgs = (0, arg_1.default)({
         '--type': String,
+        ...constants_1.helpArgs,
     });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['create']);
+        return;
+    }
     const name = localArgs._.length > 1 && localArgs._[1].trim().length > 0
         ? localArgs._[1].trim()
         : await ui.input('Contract name (PascalCase)');
@@ -87,7 +94,9 @@ const create = async (args, ui) => {
         snakeName,
         contractPath: 'contracts/' + snakeName + '.' + (lang === 'func' ? 'fc' : 'tact'),
     };
-    await createFiles(path_1.default.join(template_1.TEMPLATES_DIR, lang, 'common'), process.cwd(), replaces);
+    const config = await (0, utils_2.getConfig)();
+    const commonPath = config?.separateCompilables ? 'common' : 'not-separated-common';
+    await createFiles(path_1.default.join(template_1.TEMPLATES_DIR, lang, commonPath), process.cwd(), replaces);
     await createFiles(path_1.default.join(template_1.TEMPLATES_DIR, lang, template), process.cwd(), replaces);
     if (lang === 'tact') {
         await (0, build_1.buildOne)(name, ui);

package/dist/cli/help.js

@@ -1,80 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.help = exports.additionalHelpMessages = void 0;
-const create_1 = require("./create");
-const helpMessages = {
-    help: `Usage: blueprint help [command]
-
-Displays this message if no command is specified, or displays detailed help for the specified command.
-
-Blueprint is generally invoked as follows: blueprint [command] [command-args] [flags]
-
-List of available commands:
-- create
-- run
-- build
-- custom
-- help
-- test
-- verify
-- convert`,
-    create: `Usage: blueprint create [contract name] [flags]
-
-Creates a new contract together with supporting files according to a template.
-
-Contract name must be specified in PascalCase and may only include characters a-z, A-Z, 0-9. If not specified on the command line, it will be asked interactively.
-
-Flags:
---type <type> - specifies the template type to use when creating the contract. If not specified on the command line, it will be asked interactively.
-List of available types:
-${create_1.templateTypes.map((t) => `${t.value} - ${t.name}`).join('\n')}`,
-    run: `Usage: blueprint run [script name] [flags]
-
-Runs a script from the scripts directory.
-
-Script name is matched (ignoring case) to a file in the scripts directory. If not specified on the command line, the available scripts will be presented interactively.
-
-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-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, --tonhub, --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.`,
-    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.
-
-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.
-
-Flags:
---all - builds all buildable contracts instead of just one.`,
-    set: `Usage: blueprint set <key> [value]
-Available keys:
-- func - overrides @ton-community/func-js-bin version, effectively setting the func version. The required version may be passed as the value, otherwise available versions will be displayed.`,
-    test: `Usage: blueprint test
-
-Just runs \`npm test\`, which by default runs \`jest\`.`,
-    verify: `Usage: blueprint verify [contract name] [flags]
-
-Builds a contract (similar to build command) and verifies it on https://verifier.ton.org. The contract must be already deployed on the network. If the contract's name is not specified on the command line, it will be asked interactively.
-
-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/) Requires --custom-type to be specified.
---custom-version - specifies the API version to use with the custom API. Options: v2 (defualt), 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: mainnet, testnet.`,
-    convert: `Usage: blueprint convert [path to build script]
-Atempts to convert legacy bash build script to a blueprint compile wrapper.`,
-};
+const constants_1 = require("./constants");
 exports.additionalHelpMessages = {};
 const help = async (args, ui) => {
     const cmd = args._.length >= 2 ? args._[1].toLowerCase() : '';
     const effectiveHelpMessages = {
         ...exports.additionalHelpMessages,
-        ...helpMessages,
+        ...constants_1.helpMessages,
     };
     for (const k in exports.additionalHelpMessages) {
         effectiveHelpMessages.help += '\n- ' + k;

package/dist/cli/run.js

@@ -7,8 +7,13 @@ exports.run = void 0;
 const createNetworkProvider_1 = require("../network/createNetworkProvider");
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
+const constants_1 = require("./constants");
 const run = async (args, ui, context) => {
-    const localArgs = (0, arg_1.default)(createNetworkProvider_1.argSpec);
+    const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['run']);
+        return;
+    }
     const { module: mod } = await (0, utils_1.selectFile)(await (0, utils_1.findScripts)(), {
         ui,
         hint: localArgs._.length > 1 && localArgs._[1].length > 0 ? localArgs._[1] : undefined,

package/dist/cli/set.js

@@ -7,6 +7,8 @@ exports.set = void 0;
 const promises_1 = require("fs/promises");
 const node_child_process_1 = require("node:child_process");
 const path_1 = __importDefault(require("path"));
+const arg_1 = __importDefault(require("arg"));
+const constants_1 = require("./constants");
 const getVersions = (pkg, ui) => {
     return new Promise((resolve, reject) => {
         (0, node_child_process_1.exec)(`npm view ${pkg} versions --json`, (error, stdout, stderr) => {
@@ -58,6 +60,11 @@ const install = (cmd, ui) => {
     });
 };
 const set = async (args, ui) => {
+    const localArgs = (0, arg_1.default)(constants_1.helpArgs);
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['set']);
+        return;
+    }
     if (args._.length < 2) {
         throw new Error('Please pass a key');
     }

package/dist/cli/test.js

@@ -1,8 +1,19 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = void 0;
 const child_process_1 = require("child_process");
-const test = async () => {
-    (0, child_process_1.execSync)('npm test', { stdio: 'inherit' });
+const arg_1 = __importDefault(require("arg"));
+const constants_1 = require("./constants");
+const test = async (args, ui) => {
+    const localArgs = (0, arg_1.default)(constants_1.helpArgs);
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['test']);
+        return;
+    }
+    const testArgs = args._.slice(1); // first argument is `test`, need to get rid of it
+    (0, child_process_1.execSync)(`npm test ${testArgs.join(' ')}`, { stdio: 'inherit' });
 };
 exports.test = test;

package/dist/cli/verify.js

@@ -11,6 +11,7 @@ const createNetworkProvider_1 = require("../network/createNetworkProvider");
 const build_1 = require("./build");
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
+const constants_1 = require("./constants");
 const backends = {
     mainnet: {
         sourceRegistry: core_1.Address.parse('EQD-BJSVUJviud_Qv7Ymfd3qzXdrmV525e3YDzWQoHIAiInL'),
@@ -120,7 +121,11 @@ async function lookupCodeHash(hash, ui, retryCount = 5) {
     return foundAddr;
 }
 const verify = async (args, ui, context) => {
-    const localArgs = (0, arg_1.default)(createNetworkProvider_1.argSpec);
+    const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['verify']);
+        return;
+    }
     const sel = await (0, build_1.selectCompile)(ui, localArgs);
     const networkProvider = await (0, createNetworkProvider_1.createNetworkProvider)(ui, localArgs, context.config, false);
     const sender = networkProvider.sender();

package/dist/compile/CompilerConfig.d.ts

@@ -16,6 +16,7 @@ export type TactCompilerConfig = {
 export type FuncCompilerConfig = {
     lang?: 'func';
     optLevel?: number;
+    debugInfo?: boolean;
 } & ({
     targets: string[];
     sources?: SourceResolver | SourcesMap;

package/dist/compile/compile.d.ts

@@ -1,13 +1,16 @@
 /// <reference types="node" />
-import { SourcesArray } from '@ton-community/func-js';
+import { SourcesArray, DebugInfoEntry } from '@ton-community/func-js';
 import { Cell } from '@ton/core';
 import { TactCompilerConfig } from './CompilerConfig';
+export declare function getCompilablesDirectory(): Promise<string>;
+export declare const COMPILE_END = ".compile.ts";
 export type FuncCompileResult = {
     lang: 'func';
     code: Cell;
     targets: string[];
     snapshot: SourcesArray;
     version: string;
+    debugInfo?: DebugInfoEntry[];
 };
 export type TactCompileResult = {
     lang: 'tact';
@@ -19,5 +22,6 @@ export type CompileResult = TactCompileResult | FuncCompileResult;
 export declare function doCompile(name: string, opts?: CompileOpts): Promise<CompileResult>;
 export type CompileOpts = {
     hookUserData?: any;
+    debugInfo?: boolean;
 };
 export declare function compile(name: string, opts?: CompileOpts): Promise<Cell>;

package/dist/compile/compile.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compile = exports.doCompile = void 0;
+exports.compile = exports.doCompile = exports.COMPILE_END = exports.getCompilablesDirectory = void 0;
 const func_js_1 = require("@ton-community/func-js");
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
@@ -34,9 +34,20 @@ const core_1 = require("@ton/core");
 const paths_1 = require("../paths");
 const Tact = __importStar(require("@tact-lang/compiler"));
 const OverwritableVirtualFileSystem_1 = require("./OverwritableVirtualFileSystem");
+const utils_1 = require("../config/utils");
+async function getCompilablesDirectory() {
+    const config = await (0, utils_1.getConfig)();
+    if (config?.separateCompilables) {
+        return paths_1.COMPILABLES_DIR;
+    }
+    return paths_1.WRAPPERS_DIR;
+}
+exports.getCompilablesDirectory = getCompilablesDirectory;
+exports.COMPILE_END = '.compile.ts';
 async function getCompilerConfigForContract(name) {
     var _a;
-    const mod = await (_a = path_1.default.join(paths_1.WRAPPERS_DIR, name + '.compile.ts'), Promise.resolve().then(() => __importStar(require(_a))));
+    const compilablesDirectory = await getCompilablesDirectory();
+    const mod = await (_a = path_1.default.join(compilablesDirectory, name + exports.COMPILE_END), Promise.resolve().then(() => __importStar(require(_a))));
     if (typeof mod.compile !== 'object') {
         throw new Error(`Object 'compile' is missing`);
     }
@@ -59,6 +70,7 @@ async function doCompileFunc(config) {
         targets,
         snapshot: cr.snapshot,
         version: (await (0, func_js_1.compilerVersion)()).funcVersion,
+        debugInfo: cr.debugInfo,
     };
 }
 function findTactBoc(fs) {
@@ -119,10 +131,14 @@ async function doCompileInner(name, config) {
         targets: config.targets,
         sources: config.sources ?? ((path) => (0, fs_1.readFileSync)(path).toString()),
         optLevel: config.optLevel,
+        debugInfo: config.debugInfo,
     });
 }
 async function doCompile(name, opts) {
     const config = await getCompilerConfigForContract(name);
+    if (opts?.debugInfo && config.lang === 'func') {
+        config.debugInfo = true;
+    }
     if (config.preCompileHook !== undefined) {
         await config.preCompileHook({
             userData: opts?.hookUserData,

package/dist/config/Config.d.ts

@@ -3,4 +3,5 @@ import { Plugin } from './Plugin';
 export interface Config {
     plugins?: Plugin[];
     network?: 'mainnet' | 'testnet' | CustomNetwork;
+    separateCompilables?: boolean;
 }

package/dist/config/utils.d.ts

@@ -0,0 +1,2 @@
+import { Config } from './Config';
+export declare function getConfig(): Promise<Config | undefined>;

package/dist/config/utils.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = void 0;
+const paths_1 = require("../paths");
+let config;
+async function getConfig() {
+    if (config) {
+        return config;
+    }
+    try {
+        const configModule = await (_a = paths_1.BLUEPRINT_CONFIG, Promise.resolve().then(() => __importStar(require(_a))));
+        if (!('config' in configModule) || typeof configModule.config !== 'object') {
+            return undefined;
+        }
+        config = configModule.config;
+        return config;
+    }
+    catch {
+        return undefined;
+    }
+}
+exports.getConfig = getConfig;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { tonDeepLink, sleep } from './utils';
 export { NetworkProvider } from './network/NetworkProvider';
 export { createNetworkProvider } from './network/createNetworkProvider';
-export { compile, CompileOpts } from './compile/compile';
+export { compile, CompileOpts, CompileResult, FuncCompileResult, TactCompileResult, doCompile } from './compile/compile';
 export { CompilerConfig, HookParams } from './compile/CompilerConfig';
 export { UIProvider } from './ui/UIProvider';
 export { Config } from './config/Config';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAll = exports.buildOne = exports.compile = exports.createNetworkProvider = exports.sleep = exports.tonDeepLink = void 0;
+exports.buildAll = exports.buildOne = exports.doCompile = exports.compile = exports.createNetworkProvider = exports.sleep = exports.tonDeepLink = void 0;
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "tonDeepLink", { enumerable: true, get: function () { return utils_1.tonDeepLink; } });
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return utils_1.sleep; } });
@@ -8,6 +8,7 @@ var createNetworkProvider_1 = require("./network/createNetworkProvider");
 Object.defineProperty(exports, "createNetworkProvider", { enumerable: true, get: function () { return createNetworkProvider_1.createNetworkProvider; } });
 var compile_1 = require("./compile/compile");
 Object.defineProperty(exports, "compile", { enumerable: true, get: function () { return compile_1.compile; } });
+Object.defineProperty(exports, "doCompile", { enumerable: true, get: function () { return compile_1.doCompile; } });
 var build_1 = require("./build");
 Object.defineProperty(exports, "buildOne", { enumerable: true, get: function () { return build_1.buildOne; } });
 Object.defineProperty(exports, "buildAll", { enumerable: true, get: function () { return build_1.buildAll; } });

package/dist/network/send/DeeplinkProvider.js

@@ -29,12 +29,23 @@ class DeeplinkProvider {
     }
     async sendTransaction(address, amount, payload, stateInit) {
         const deepLink = (0, utils_1.tonDeepLink)(address, amount, payload, stateInit ? (0, core_1.beginCell)().storeWritable((0, core_1.storeStateInit)(stateInit)).endCell() : undefined);
-        __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\n');
-        qrcode_terminal_1.default.generate(deepLink, { small: true }, (qr) => __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write(qr));
-        __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\n');
-        __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write(deepLink);
-        __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\nScan the QR code above, or open the ton:// link to send this transaction');
-        await __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").prompt('Press enter when transaction was issued');
+        try {
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\n');
+            qrcode_terminal_1.default.generate(deepLink, { small: true }, (qr) => __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write(qr));
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\n');
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write(deepLink);
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\nScan the QR code above, or open the ton:// link to send this transaction');
+            await __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").prompt('Press enter when transaction was issued');
+        }
+        catch (err) {
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write(deepLink);
+            __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('\n');
+            if (err instanceof Error && err.message.includes('code length overflow')) {
+                __classPrivateFieldGet(this, _DeeplinkProvider_ui, "f").write('Message is too large to be sent via QR code. Please use the ton:// link or another method.');
+                process.exit(1);
+            }
+            throw err;
+        }
     }
     address() {
         return undefined;

package/dist/paths.d.ts

@@ -1,13 +1,16 @@
 export declare const CONTRACTS = "contracts";
 export declare const TESTS = "tests";
+export declare const COMPILABLES = "compilables";
 export declare const WRAPPERS = "wrappers";
 export declare const SCRIPTS = "scripts";
 export declare const TEMP = "temp";
 export declare const BUILD = "build";
+export declare const COMPILABLES_DIR: string;
 export declare const WRAPPERS_DIR: string;
 export declare const SCRIPTS_DIR: string;
 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 BLUEPRINT_CONFIG: string;
 export declare const TACT_ROOT_CONFIG: string;

package/dist/paths.js

@@ -3,18 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.TACT_ROOT_CONFIG = exports.BLUEPRINT_CONFIG = exports.TESTS_DIR = exports.CONTRACTS_DIR = exports.TEMP_DIR = exports.BUILD_DIR = exports.SCRIPTS_DIR = exports.WRAPPERS_DIR = exports.COMPILABLES_DIR = exports.BUILD = exports.TEMP = exports.SCRIPTS = exports.WRAPPERS = exports.COMPILABLES = exports.TESTS = exports.CONTRACTS = void 0;
 const path_1 = __importDefault(require("path"));
 exports.CONTRACTS = 'contracts';
 exports.TESTS = 'tests';
+exports.COMPILABLES = 'compilables';
 exports.WRAPPERS = 'wrappers';
 exports.SCRIPTS = 'scripts';
 exports.TEMP = 'temp';
 exports.BUILD = 'build';
+exports.COMPILABLES_DIR = path_1.default.join(process.cwd(), exports.COMPILABLES);
 exports.WRAPPERS_DIR = path_1.default.join(process.cwd(), exports.WRAPPERS);
 exports.SCRIPTS_DIR = path_1.default.join(process.cwd(), exports.SCRIPTS);
 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.BLUEPRINT_CONFIG = path_1.default.join(process.cwd(), 'blueprint.config.ts');
 exports.TACT_ROOT_CONFIG = path_1.default.join(process.cwd(), 'tact.config.json');

package/dist/templates/func/not-separated-common/wrappers/compile.ts.template

@@ -0,0 +1,7 @@
+{{name}}.compile.ts
+import { CompilerConfig } from '@ton/blueprint';
+
+export const compile: CompilerConfig = {
+    lang: 'func',
+    targets: ['{{contractPath}}'],
+};

package/dist/templates/tact/not-separated-common/wrappers/compile.ts.template

@@ -0,0 +1,10 @@
+{{name}}.compile.ts
+import { CompilerConfig } from '@ton/blueprint';
+
+export const compile: CompilerConfig = {
+    lang: 'tact',
+    target: '{{contractPath}}',
+    options: {
+        debug: true,
+    },
+};

package/dist/templates/tact/not-separated-common/wrappers/wrapper.ts.template

@@ -0,0 +1,2 @@
+{{name}}.ts
+export * from '../build/{{name}}/tact_{{name}}';

package/dist/types/file.d.ts

@@ -0,0 +1,4 @@
+export type File = {
+    name: string;
+    path: string;
+};

package/dist/types/file.js

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

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './object.utils';
+export * from './timer.utils';
+export * from './ton.utils';
+export * from './selection.utils';

package/dist/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./object.utils"), exports);
+__exportStar(require("./timer.utils"), exports);
+__exportStar(require("./ton.utils"), exports);
+__exportStar(require("./selection.utils"), exports);

package/dist/utils/object.utils.d.ts

@@ -0,0 +1,3 @@
+export declare function oneOrZeroOf<T extends {
+    [k: string]: boolean | undefined;
+}>(options: T): keyof T | undefined;

package/dist/utils/object.utils.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oneOrZeroOf = void 0;
+function oneOrZeroOf(options) {
+    let opt = undefined;
+    for (const k in options) {
+        if (options[k]) {
+            if (opt === undefined) {
+                opt = k;
+            }
+            else {
+                throw new Error(`Please pick only one of the options: ${Object.keys(options).join(', ')}`);
+            }
+        }
+    }
+    return opt;
+}
+exports.oneOrZeroOf = oneOrZeroOf;

package/dist/utils/selection.utils.d.ts

@@ -0,0 +1,24 @@
+import { UIProvider } from '../ui/UIProvider';
+import { File } from '../types/file';
+export declare const findCompiles: (directory?: string) => Promise<File[]>;
+export declare const findScripts: () => Promise<File[]>;
+export declare function selectOption(options: {
+    name: string;
+    value: string;
+}[], opts: {
+    ui: UIProvider;
+    msg: string;
+    hint?: string;
+}): Promise<{
+    name: string;
+    value: string;
+}>;
+export declare function selectFile(files: File[], opts: {
+    ui: UIProvider;
+    hint?: string;
+    import?: boolean;
+}): Promise<{
+    module: any;
+    name: string;
+    path: string;
+}>;

package/dist/{utils.js → utils/selection.utils.js}

@@ -27,44 +27,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getExplorerLink = exports.selectFile = exports.selectOption = exports.findScripts = exports.findCompiles = exports.oneOrZeroOf = exports.sleep = exports.tonDeepLink = void 0;
+exports.selectFile = exports.selectOption = exports.findScripts = exports.findCompiles = void 0;
 const path_1 = __importDefault(require("path"));
 const promises_1 = __importDefault(require("fs/promises"));
-const paths_1 = require("./paths");
-const tonDeepLink = (address, amount, body, stateInit) => `ton://transfer/${address.toString({
-    urlSafe: true,
-    bounceable: true,
-})}?amount=${amount.toString()}${body ? '&bin=' + body.toBoc().toString('base64url') : ''}${stateInit ? '&init=' + stateInit.toBoc().toString('base64url') : ''}`;
-exports.tonDeepLink = tonDeepLink;
-function sleep(ms) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, ms);
-    });
-}
-exports.sleep = sleep;
-function oneOrZeroOf(options) {
-    let opt = undefined;
-    for (const k in options) {
-        if (options[k]) {
-            if (opt === undefined) {
-                opt = k;
-            }
-            else {
-                throw new Error(`Please pick only one of the options: ${Object.keys(options).join(', ')}`);
-            }
-        }
-    }
-    return opt;
-}
-exports.oneOrZeroOf = oneOrZeroOf;
-const compileEnd = '.compile.ts';
-const findCompiles = async () => (await promises_1.default.readdir(paths_1.WRAPPERS_DIR))
-    .filter((f) => f.endsWith(compileEnd))
-    .map((f) => ({ path: path_1.default.join(paths_1.WRAPPERS_DIR, f), name: f.slice(0, f.length - compileEnd.length) }));
+const paths_1 = require("../paths");
+const compile_1 = require("../compile/compile");
+const findCompiles = async (directory) => {
+    const dir = directory ?? await (0, compile_1.getCompilablesDirectory)();
+    const files = await promises_1.default.readdir(dir);
+    const compilables = files.filter((file) => file.endsWith(compile_1.COMPILE_END));
+    return compilables.map((file) => ({
+        path: path_1.default.join(dir, file),
+        name: file.slice(0, file.length - compile_1.COMPILE_END.length),
+    }));
+};
 exports.findCompiles = findCompiles;
-const findScripts = async () => (await promises_1.default.readdir(paths_1.SCRIPTS_DIR))
-    .filter((f) => f.endsWith('.ts'))
-    .map((f) => ({ path: path_1.default.join(paths_1.SCRIPTS_DIR, f), name: path_1.default.parse(f).name }));
+const findScripts = async () => {
+    const dirents = await promises_1.default.readdir(paths_1.SCRIPTS_DIR, { recursive: true, withFileTypes: true });
+    const scripts = dirents.filter((dirent) => dirent.isFile() && dirent.name.endsWith('.ts'));
+    return scripts
+        .map((script) => ({
+        name: path_1.default.join(script.path.slice(paths_1.SCRIPTS_DIR.length + 1), path_1.default.parse(script.name).name),
+        path: path_1.default.join(script.path, script.name),
+    }))
+        .sort((a, b) => (a.name >= b.name ? 1 : -1));
+};
 exports.findScripts = findScripts;
 async function selectOption(options, opts) {
     if (opts.hint) {
@@ -104,19 +91,3 @@ async function selectFile(files, opts) {
     };
 }
 exports.selectFile = selectFile;
-function getExplorerLink(address, network, explorer) {
-    const networkPrefix = network === 'testnet' ? 'testnet.' : '';
-    switch (explorer) {
-        case 'tonscan':
-            return `https://${networkPrefix}tonscan.org/address/${address}`;
-        case 'tonviewer':
-            return `https://${networkPrefix}tonviewer.com/${address}`;
-        case 'toncx':
-            return `https://${networkPrefix}ton.cx/address/${address}`;
-        case 'dton':
-            return `https://${networkPrefix}dton.io/a/${address}`;
-        default:
-            return `https://${networkPrefix}tonscan.org/address/${address}`;
-    }
-}
-exports.getExplorerLink = getExplorerLink;

package/dist/utils/timer.utils.d.ts

@@ -0,0 +1 @@
+export declare function sleep(ms: number): Promise<unknown>;

package/dist/utils/timer.utils.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = void 0;
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+exports.sleep = sleep;

package/dist/utils/ton.utils.d.ts

@@ -0,0 +1,3 @@
+import { Address, Cell } from '@ton/core';
+export declare const tonDeepLink: (address: Address, amount: bigint, body?: Cell, stateInit?: Cell) => string;
+export declare function getExplorerLink(address: string, network: string, explorer: string): string;

package/dist/utils/ton.utils.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExplorerLink = exports.tonDeepLink = void 0;
+const tonDeepLink = (address, amount, body, stateInit) => `ton://transfer/${address.toString({
+    urlSafe: true,
+    bounceable: true,
+})}?amount=${amount.toString()}${body ? '&bin=' + body.toBoc().toString('base64url') : ''}${stateInit ? '&init=' + stateInit.toBoc().toString('base64url') : ''}`;
+exports.tonDeepLink = tonDeepLink;
+function getExplorerLink(address, network, explorer) {
+    const networkPrefix = network === 'testnet' ? 'testnet.' : '';
+    switch (explorer) {
+        case 'tonscan':
+            return `https://${networkPrefix}tonscan.org/address/${address}`;
+        case 'tonviewer':
+            return `https://${networkPrefix}tonviewer.com/${address}`;
+        case 'toncx':
+            return `https://${networkPrefix}ton.cx/address/${address}`;
+        case 'dton':
+            return `https://${networkPrefix}dton.io/a/${address}`;
+        default:
+            return `https://${networkPrefix}tonscan.org/address/${address}`;
+    }
+}
+exports.getExplorerLink = getExplorerLink;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.21.0",
+  "version": "0.23.0-debugger.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -35,8 +35,8 @@
   },
   "dependencies": {
     "@orbs-network/ton-access": "^2.3.3",
-    "@tact-lang/compiler": "^1.3.0",
-    "@ton-community/func-js": "^0.7.0",
+    "@tact-lang/compiler": "^1.4.0",
+    "@ton-community/func-js": "^0.8.0-debuginfo.0",
     "@tonconnect/sdk": "^2.2.0",
     "arg": "^5.0.2",
     "chalk": "^4.1.0",
@@ -46,5 +46,5 @@
     "ton-x": "^2.1.0",
     "ts-node": "^10.9.1"
   },
-  "packageManager": "yarn@3.6.1"
+  "packageManager": "yarn@4.3.1"
 }

package/dist/utils.d.ts

@@ -1,39 +0,0 @@
-import { Address, Cell } from '@ton/core';
-import { UIProvider } from './ui/UIProvider';
-export declare const tonDeepLink: (address: Address, amount: bigint, body?: Cell, stateInit?: Cell) => string;
-export declare function sleep(ms: number): Promise<unknown>;
-export declare function oneOrZeroOf<T extends {
-    [k: string]: boolean | undefined;
-}>(options: T): keyof T | undefined;
-export declare const findCompiles: () => Promise<{
-    path: string;
-    name: string;
-}[]>;
-export declare const findScripts: () => Promise<{
-    path: string;
-    name: string;
-}[]>;
-export declare function selectOption(options: {
-    name: string;
-    value: string;
-}[], opts: {
-    ui: UIProvider;
-    msg: string;
-    hint?: string;
-}): Promise<{
-    name: string;
-    value: string;
-}>;
-export declare function selectFile(files: {
-    name: string;
-    path: string;
-}[], opts: {
-    ui: UIProvider;
-    hint?: string;
-    import?: boolean;
-}): Promise<{
-    module: any;
-    name: string;
-    path: string;
-}>;
-export declare function getExplorerLink(address: string, network: string, explorer: string): string;