@ton/blueprint 0.33.1 → 0.35.0

package/CHANGELOG.md

@@ -5,6 +5,43 @@ 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.35.0] - 2025-06-02
+
+### Added
+
+- Added ton lite client network provider
+- Added tolk verifier
+- Wallet v4 extended support: added v4r1, v4 is treated as v4r2
+- Added possibility to specify custom `manifestUrl` in blueprint configuration
+- Added documentation about the [Tact plugin by TON Studio](https://plugins.jetbrains.com/plugin/27290-tact)
+- Added tolk v0.13 support
+
+### Changed
+
+- Updated documentation about Tact wrappers
+
+## [0.34.0] - 2025-05-20
+
+### Added
+
+- Added config option to look for wrappers recursively
+- Exported `getCompilerConfigForContract` function for plugin support
+- Added request timout configuration
+- Added docs for script args
+- Added the `rename` command which renames contracts
+- Added the `pack` command which builds and prepares a publish-ready package of contracts' wrappers
+- Added support for wallet IDs in mnemonic provider. Environment variables `WALLET_ID` or `SUBWALLET_NUMBER` should be set, or a .env file with them must be present in order for it to be usable
+- Added command `blueprint snapshot` to run tests with metric collection and write new benchmark report
+- Added option `blueprint test --gas-report` to run tests and compare with the last snapshot metrics
+
+### Fixed
+
+- Fix address format in testnet
+
+### Changed
+
+- Updated FunC stdlib
+
 ## [0.33.1] - 2025-05-16
 
 ### Fixed

package/README.md

@@ -16,12 +16,14 @@ A development environment for TON blockchain for writing, testing, and deploying
   * [Directory structure](#directory-structure)
   * [Building contracts](#building-contracts)
   * [Running the test suites](#running-the-test-suites)
-  * [Deploying contracts](#deploying-contracts)
-  * [Custom scripts](#custom-scripts)
+  * [Running scripts](#running-scripts)
+    * [Deploying contracts](#deploying-contracts)
+    * [Using Mnemonic Provider](#using-mnemonic-provider)
 * [Contract development](#contract-development)
   * [Creating contracts](#creating-contracts)
   * [Writing contract code](#writing-contract-code)
   * [Testing contracts](#testing-contracts)
+  * [Benchmark contracts](#benchmark-contracts)
 * [Configuration](#configuration)
   * [Plugins](#plugins)
   * [Custom network](#custom-network)
@@ -53,6 +55,7 @@ Blueprint is an all-in-one development environment designed to enhance the proce
 1. Compiling FunC with https://github.com/ton-community/func-js
 2. Compiling Tolk with https://github.com/ton-blockchain/tolk-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
 5. Deploying smart contracts with [TON Connect 2](https://github.com/ton-connect) or a `ton://` deeplink
 
@@ -61,7 +64,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)
-  * [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton)
+  * [IntelliJ IDEA](https://www.jetbrains.com/idea/)
+    * [TON Development plugin](https://plugins.jetbrains.com/plugin/23382-ton) for FunC, Tolk and Fift
+    * [Tact plugin by TON Studio](https://plugins.jetbrains.com/plugin/27290-tact) for Tact
 
 ## Features overview
 
@@ -73,9 +78,11 @@ Blueprint is an all-in-one development environment designed to enhance the proce
 ### Directory structure
 
 * `contracts/` - Source code 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
+* `wrappers/` - TypeScript interface classes for all contracts **except Tact**. 
+  * Tact-generated wrappers are located according to the build path defined in [`tact.config.json`](https://docs.tact-lang.org/book/config/) 
+  * Each wrapper implements `Contract` interface from [@ton/core](https://www.npmjs.com/package/@ton/core)
+  * Includes 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
@@ -100,23 +107,58 @@ Blueprint is an all-in-one development environment designed to enhance the proce
 
 > Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
 
-### Deploying contracts
-
-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 deploy<CONTRACT> --<NETWORK> --<DEPLOY_METHOD>`
-   * Example: `yarn blueprint run deployCounter --mainnet --tonconnect`
-
-### Custom scripts
+### Running 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) {
+export async function run(provider: NetworkProvider, args: string[]) {
   // 
 }
 ```
-3. Script can be run using `npx/yarn blueprint run <SCRIPT>` command
+3. Script can be run using `npx/yarn blueprint run <SCRIPT> [arg1, arg2, ...]` command
+
+#### Deploying contracts
+
+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 deploy<CONTRACT> --<NETWORK> --<DEPLOY_METHOD>`
+  * Example: `yarn blueprint run deployCounter --mainnet --tonconnect`
+
+#### Using Mnemonic Provider
+
+To run scripts using a wallet by mnemonic authentication, you need to configure your environment and use the `Mnemonic` option when running scripts.
+
+Start by adding the following environment variables to your `.env` file:
+* **`WALLET_MNEMONIC`**: Your wallet's mnemonic phrase (space-separated words).
+* **`WALLET_VERSION`**: The wallet contract version to use. Supported versions: `v1r1`, `v1r2`, `v1r3`, `v2r1`, `v2r2`, `v3r1`, `v3r2`, `v4r1`, `v4r2` (or `v4`), `v5r1`.
+
+**Optional variables:**
+* **`WALLET_ID`**: The wallet ID (can be used with versions below `v5r1`).
+* **`SUBWALLET_NUMBER`**: The subwallet number used to build the wallet ID (can be used with `v5r1` wallets).
+
+Once your environment is set up, you can use the mnemonic wallet for deployment with the appropriate configuration.
+
+#### Deploying contracts
+
+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 deploy<CONTRACT> --<NETWORK> --<DEPLOY_METHOD>`
+  * Example: `yarn blueprint run deployCounter --mainnet --tonconnect`
+
+#### Using Mnemonic Provider
+
+To run scripts using a wallet by mnemonic authentication, you need to configure your environment and use the `Mnemonic` option when running scripts.
+
+Start by adding the following environment variables to your `.env` file:
+* **`WALLET_MNEMONIC`**: Your wallet's mnemonic phrase (space-separated words).
+* **`WALLET_VERSION`**: The wallet contract version to use. Supported versions: `v1r1`, `v1r2`, `v1r3`, `v2r1`, `v2r2`, `v3r1`, `v3r2`, `v4`, `v5r1`.
+
+**Optional variables:**
+* **`WALLET_ID`**: The wallet ID (required for versions below `v5r1`).
+* **`SUBWALLET_NUMBER`**: The subwallet number used to build the wallet ID (required for `v5r1` wallets).
+
+Once your environment is set up, you can use the mnemonic wallet for deployment with the appropriate configuration.
 
 ### Updating FunC version
 
@@ -140,6 +182,12 @@ Before developing, make sure that your current working directory is located in t
 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`
 
+### Renaming contracts
+
+1. Run interactive: &nbsp;&nbsp; `npx blueprint rename` &nbsp; or &nbsp; `yarn blueprint rename`
+2. Non-interactive: &nbsp; `npx/yarn blueprint rename <OLD_NAME> <NEW_NAME>`
+  * Example: `yarn blueprint rename OldContract NewContract `
+
 ### Writing contract code
 
 #### FunC
@@ -162,6 +210,37 @@ Before developing, make sure that your current working directory is located in t
 
 > Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
 
+### Publishing Wrapper Code
+
+1. **Authenticate with npm**
+Run `npm adduser` to log in to your npm account.
+> 📝 **Note:** You can learn more about advanced authentication in the official npm docs:
+> [npmrc – Auth-Related Configuration](https://docs.npmjs.com/cli/v9/configuring-npm/npmrc#auth-related-configuration)
+
+2. **Update the package version**
+Edit the `version` field in your `package.json` to reflect the new release (e.g., `1.0.1` → `1.0.2`).
+
+3. **Build the package**
+Run the following command to generate and bundle your contract wrappers:
+
+```bash
+blueprint pack
+```
+
+4. **Publish to npm**
+Push the package to the public npm registry:
+
+```bash
+npm publish --access public
+```
+
+### Benchmark contracts
+
+1. Run `npx blueprint snapshot [--label=<comment>|-l <comment>]` to collect metrics of contracts and save snapshot
+2. Run `npx blueprint test --gas-report|-g` to compare current metrics and saved snapshot
+
+> Learn more about collect metric from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#benchmark-contracts).
+
 ## 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:
@@ -218,12 +297,81 @@ npx blueprint run --custom https://toncenter.com/api/v2/jsonRPC --custom-version
 
 Properties of the `network` object have the same semantics as the `--custom` flags with respective names (see `blueprint help run`).
 
+### Liteclient Support
+
+Lite client is supported through the following configuration:
+
+```ts
+import { Config } from '@ton/blueprint';
+
+export const config: Config = {
+    network: {
+        endpoint: 'https://ton.org/testnet-global.config.json', // Use https://ton.org/global.config.json for mainnet or any custom configuration
+        version: 'liteclient',
+        type: 'testnet',
+    }
+};
+```
+
+You can also provide these parameters via CLI:
+
+```bash
+npx blueprint run \
+  --custom https://ton.org/testnet-global.config.json \
+  --custom-version liteclient \
+  --custom-type testnet
+```
+
+#### Contract Verification Using Custom Network
+
 You can also use custom network to verify contracts, like so:
 ```bash
 npx blueprint verify --custom https://toncenter.com/api/v2/jsonRPC --custom-version v2 --custom-type mainnet --custom-key YOUR_API_KEY
 ```
 (or similarly using the config), however custom type MUST be specified as either `mainnet` or `testnet` when verifying.
 
+### Request timeout
+
+You can optionally configure how long HTTP requests should wait before timing out using the `requestTimout` field. This can be especially useful when working with unstable or slow networks.
+
+```typescript
+import { Config } from '@ton/blueprint';
+
+export const config: Config = {
+    requestTimeout: 10000, // 10 seconds
+};
+```
+
+### Recursive wrappers
+
+You can configure whether the `wrappers` or `compilables` directories should be searched recursively for contracts configs by setting the `recursiveWrappers` field.
+
+```typescript
+import { Config } from '@ton/blueprint';
+
+export const config: Config = {
+    recursiveWrappers: true,
+};
+```
+
+By default, this is set to `false`.
+
+### TonConnect manifest URL
+
+If you're using a TonConnect provider, you can override the default manifest URL by specifying the `manifestUrl` field.
+```typescript
+import { Config } from '@ton/blueprint';
+
+export const config: Config = {
+    manifestUrl: 'https://yourdomain.com/custom-manifest.json',
+};
+```
+
+By default, the manifest URL is set to:
+```
+https://raw.githubusercontent.com/ton-org/blueprint/main/tonconnect/manifest.json
+```
+
 ## Contributors
 
 Special thanks to [@qdevstudio](https://t.me/qdevstudio) for their logo for blueprint.

package/dist/cli/Runner.d.ts

@@ -3,6 +3,8 @@ import { UIProvider } from '../ui/UIProvider';
 import { Config } from '../config/Config';
 export declare const argSpec: {};
 export type Args = arg.Result<typeof argSpec>;
+export declare function extractPosArg(args: Args, position: number): string | undefined;
+export declare function extractSecondArg(args: Args): string | undefined;
 export declare function extractFirstArg(args: Args): string | undefined;
 export type RunnerContext = {
     config?: Config;

package/dist/cli/Runner.js

@@ -1,8 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.argSpec = void 0;
+exports.extractPosArg = extractPosArg;
+exports.extractSecondArg = extractSecondArg;
 exports.extractFirstArg = extractFirstArg;
 exports.argSpec = {};
+function extractPosArg(args, position) {
+    return args._.length > position && args._[position].trim().length > 0 ? args._[position].trim() : undefined;
+}
+function extractSecondArg(args) {
+    return extractPosArg(args, 2);
+}
 function extractFirstArg(args) {
-    return args._.length > 1 && args._[1].trim().length > 0 ? args._[1].trim() : undefined;
+    return extractPosArg(args, 1);
 }

package/dist/cli/build.d.ts

@@ -1,6 +1,5 @@
-import { Args, Runner } from './Runner';
 import { UIProvider } from '../ui/UIProvider';
-export declare function extractBuildFile(args: Args): string | undefined;
+import { Runner } from './Runner';
 export declare function selectContract(ui: UIProvider, hint?: string): Promise<string>;
 export declare function selectContract(ui: UIProvider, hint?: string, withAllOption?: boolean): Promise<string | string[]>;
 export declare const build: Runner;

package/dist/cli/build.js

@@ -4,15 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.build = void 0;
-exports.extractBuildFile = extractBuildFile;
 exports.selectContract = selectContract;
-const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
+const utils_1 = require("../utils");
 const build_1 = require("../build");
 const constants_1 = require("./constants");
-function extractBuildFile(args) {
-    return args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined;
-}
+const Runner_1 = require("./Runner");
 async function selectContract(ui, hint, withAllOption = false) {
     const contracts = await (0, utils_1.findContracts)();
     const options = contracts.map((contract) => ({ name: contract, value: contract }));
@@ -47,7 +44,7 @@ const build = async (args, ui) => {
         await (0, build_1.buildAll)(ui);
     }
     else {
-        const selected = await selectContract(ui, extractBuildFile(args), true);
+        const selected = await selectContract(ui, (0, Runner_1.extractFirstArg)(args), true);
         if (typeof selected === 'string') {
             await (0, build_1.buildOne)(selected, ui);
         }

package/dist/cli/cli.js

@@ -41,6 +41,7 @@ const dotenv = __importStar(require("dotenv"));
 dotenv.config();
 const arg_1 = __importDefault(require("arg"));
 const chalk_1 = __importDefault(require("chalk"));
+const snapshot_1 = require("./snapshot");
 const create_1 = require("./create");
 const run_1 = require("./run");
 const build_1 = require("./build");
@@ -49,9 +50,11 @@ const test_1 = require("./test");
 const verify_1 = require("./verify");
 const convert_1 = require("./convert");
 const help_1 = require("./help");
+const pack_1 = require("./pack");
 const InquirerUIProvider_1 = require("../ui/InquirerUIProvider");
 const Runner_1 = require("./Runner");
 const utils_1 = require("../config/utils");
+const rename_1 = require("./rename");
 const runners = {
     create: create_1.create,
     run: run_1.run,
@@ -61,6 +64,9 @@ const runners = {
     help: help_1.help,
     verify: verify_1.verify,
     convert: convert_1.convert,
+    rename: rename_1.rename,
+    pack: pack_1.pack,
+    snapshot: snapshot_1.snapshot,
 };
 async function main() {
     require('ts-node/register');
@@ -95,7 +101,8 @@ async function main() {
     const command = args._[0];
     const runner = effectiveRunners[command];
     if (!runner) {
-        console.log(chalk_1.default.redBright(`Error: command ${command} not found.`) + `\nRunning ${chalk_1.default.cyanBright('blueprint help')}...`);
+        console.log(chalk_1.default.redBright(`Error: command ${command} not found.`) +
+            `\nRunning ${chalk_1.default.cyanBright('blueprint help')}...`);
         const helpMessage = (0, help_1.buildHelpMessage)();
         console.log(helpMessage);
         process.exit(1);

package/dist/cli/constants.d.ts

@@ -4,6 +4,7 @@ export declare const templateTypes: {
 }[];
 export declare const helpArgs: {
     '--help': BooleanConstructor;
+    '-h': string;
 };
 export declare const helpMessages: {
     help: string;
@@ -14,4 +15,7 @@ export declare const helpMessages: {
     test: string;
     verify: string;
     convert: string;
+    rename: string;
+    pack: string;
+    snapshot: string;
 };

package/dist/cli/constants.js

@@ -31,8 +31,20 @@ exports.templateTypes = [
         value: 'tact-counter',
     },
 ];
-exports.helpArgs = { '--help': Boolean };
-const availableCommands = ['create', 'run', 'build', 'set', 'help', 'test', 'verify', 'convert'];
+exports.helpArgs = { '--help': Boolean, '-h': '--help' };
+const availableCommands = [
+    'create',
+    'run',
+    'build',
+    'set',
+    'help',
+    'test',
+    'verify',
+    'convert',
+    'rename',
+    'pack',
+    'snapshot',
+];
 exports.helpMessages = {
     help: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('help')} [${chalk_1.default.yellow('command')}]
 
@@ -54,7 +66,7 @@ ${chalk_1.default.cyan('--type')} <type> - specifies the template type to use wh
 
 ${chalk_1.default.bold('List of available types:')}
 ${exports.templateTypes.map((t) => `${chalk_1.default.cyan(t.value)} - ${t.name}`).join('\n')}`,
-    run: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('run')} ${chalk_1.default.yellow('[script name]')} ${chalk_1.default.gray('[flags]')}
+    run: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('run')} ${chalk_1.default.yellow('[script name]')} ${chalk_1.default.gray('[flags]')} ${chalk_1.default.gray('[...args]')}
 
 Runs a script from the scripts directory.
 
@@ -67,7 +79,12 @@ ${chalk_1.default.cyan('--custom-version')} - API version (v2, v4)
 ${chalk_1.default.cyan('--custom-key')} - API key (v2 only)
 ${chalk_1.default.cyan('--custom-type')} - network type (custom, mainnet, testnet)
 ${chalk_1.default.cyan('--tonconnect')}, ${chalk_1.default.cyan('--deeplink')}, ${chalk_1.default.cyan('--mnemonic')} - deployer options
-${chalk_1.default.cyan('--tonscan')}, ${chalk_1.default.cyan('--tonviewer')}, ${chalk_1.default.cyan('--toncx')}, ${chalk_1.default.cyan('--dton')} - explorer (default: tonviewer)`,
+${chalk_1.default.cyan('--tonscan')}, ${chalk_1.default.cyan('--tonviewer')}, ${chalk_1.default.cyan('--toncx')}, ${chalk_1.default.cyan('--dton')} - explorer (default: tonviewer)
+${chalk_1.default.gray('[...args]')} (array of strings, optional) - Arguments passed directly to the script.
+                            
+${chalk_1.default.bold('Examples:')}
+blueprint run ${chalk_1.default.yellow('deployCounter')} ${chalk_1.default.cyan('--testnet')} ${chalk_1.default.cyan('--tonconnect')}
+blueprint run ${chalk_1.default.yellow('incrementCounter')} ${chalk_1.default.cyan('--testnet')} ${chalk_1.default.cyan('--tonconnect')} ${chalk_1.default.gray('0.05 1')}`,
     build: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('build')} ${chalk_1.default.yellow('[contract name]')} ${chalk_1.default.gray('[flags]')}
 
 Builds the specified contract according to the respective .compile.ts file. For Tact contracts, all generated files will be placed in the ${chalk_1.default.cyan('build/<contract name>')} folder.
@@ -78,9 +95,15 @@ ${chalk_1.default.cyan('--all')} - builds all available contracts.`,
 
 ${chalk_1.default.bold('Available keys:')}
 - ${chalk_1.default.cyan('func')} - overrides @ton-community/func-js-bin version.`,
-    test: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('test')} [...args]
+    test: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('test')} ${chalk_1.default.yellow('[--gas-report|-g ...args]')}
+Runs ${chalk_1.default.green('npm test [...args]')}, which by default executes ${chalk_1.default.green('jest')}
+
+${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
 
-Runs ${chalk_1.default.green('npm test [...args]')}, which by default executes ${chalk_1.default.green('jest')}.`,
+${chalk_1.default.bold('SEE ALSO')}
+  ${chalk_1.default.cyan('blueprint snapshot')}
+`,
     verify: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('verify')} ${chalk_1.default.yellow('[contract name]')} ${chalk_1.default.gray('[flags]')}
 
 Verifies a deployed contract on ${chalk_1.default.underline('https://verifier.ton.org')}.
@@ -94,4 +117,19 @@ ${chalk_1.default.cyan('--custom-type')} - network type (mainnet, testnet)`,
     convert: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('convert')} ${chalk_1.default.yellow('[path to build script]')}
 
 Attempts to convert a legacy bash build script to a Blueprint compile wrapper.`,
+    rename: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('rename')} ${chalk_1.default.yellow('[old contract name (PascalCase)]')} ${chalk_1.default.yellow('[new contract name (PascalCase)]')}
+
+Renames contract by exact matching in wrappers, scripts, tests and contracts folders.`,
+    pack: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('pack')}
+
+Builds and prepares a publish-ready package of contract wrappers.
+
+${chalk_1.default.bold('Flags:')}
+${chalk_1.default.cyan('--no-warn')}, ${chalk_1.default.cyan('-n')} - ignore warnings about modifying tsconfig.json, package.json, and removing the dist directory.`,
+    snapshot: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('snapshot')} ${chalk_1.default.yellow('[--label=<comment>|-l=<comment>]')}
+
+Run with gas usage and cells' sizes collected and write a new snapshot
+
+${chalk_1.default.bold('SEE ALSO')}
+  ${chalk_1.default.cyan('blueprint test --gas-report')}`,
 };

package/dist/cli/create.js

@@ -14,10 +14,6 @@ const template_1 = require("../template");
 const utils_2 = require("../utils");
 const build_1 = require("../build");
 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;
-}
 async function createFile(templatePath, realPath, replaces) {
     const template = (await (0, promises_1.readFile)(templatePath)).toString('utf-8');
     const lines = template.split('\n');
@@ -84,21 +80,14 @@ const create = async (args, ui) => {
         return;
     }
     const name = (0, Runner_1.extractFirstArg)(localArgs) ?? (await ui.input('Contract name (PascalCase)'));
-    if (name.length === 0)
-        throw new Error(`Cannot create a contract with an empty name`);
-    if (name.toLowerCase() === 'contract') {
-        throw new Error(`Cannot create a contract with the reserved name 'contract'. Please choose a different name.`);
-    }
-    if (!(0, utils_2.isPascalCase)(name)) {
-        throw new Error(`Contract name '${name}' is not in PascalCase. Please try ${(0, utils_2.toPascalCase)(name)}.`);
-    }
+    (0, utils_2.assertValidContractName)(name);
     const which = (await (0, utils_2.selectOption)(constants_1.templateTypes, {
         ui,
         msg: 'What type of contract do you want to create?',
         hint: localArgs['--type'],
     })).value;
     const [lang, template] = which.split('-');
-    const snakeName = toSnakeCase(name);
+    const snakeName = (0, utils_2.toSnakeCase)(name);
     const contractPath = path_1.default.join('contracts', snakeName + '.' + getFileExtension(lang));
     const replaces = {
         name,

package/dist/cli/help.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.help = exports.additionalHelpMessages = void 0;
 exports.buildHelpMessage = buildHelpMessage;
+const Runner_1 = require("./Runner");
 const constants_1 = require("./constants");
 exports.additionalHelpMessages = {};
 function buildHelpMessage(cmd = '') {
@@ -15,7 +16,7 @@ function buildHelpMessage(cmd = '') {
     return cmd in effectiveHelpMessages ? effectiveHelpMessages[cmd] : effectiveHelpMessages['help'];
 }
 const help = async (args, ui) => {
-    const cmd = args._.length >= 2 ? args._[1].toLowerCase() : '';
+    const cmd = (0, Runner_1.extractFirstArg)(args)?.toLowerCase();
     const helpMessage = buildHelpMessage(cmd);
     ui.write(helpMessage);
 };

package/dist/cli/pack.d.ts

@@ -0,0 +1,2 @@
+import { Runner } from './Runner';
+export declare const pack: Runner;

package/dist/cli/pack.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pack = void 0;
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const arg_1 = __importDefault(require("arg"));
+const fs_1 = require("fs");
+const constants_1 = require("./constants");
+const build_1 = require("../build");
+const paths_1 = require("../paths");
+const utils_1 = require("../utils");
+const compile_1 = require("../compile/compile");
+const CompilerConfig_1 = require("../compile/CompilerConfig");
+const compile_tact_1 = require("../compile/tact/compile.tact");
+async function correctTsConfig() {
+    if (!(0, fs_1.existsSync)(paths_1.TYPESCRIPT_CONFIG)) {
+        throw new Error('TypeScript config does not exist. Ensure the command runs in the correct environment.');
+    }
+    const tsConfig = JSON.parse(await fs_1.promises.readFile(paths_1.TYPESCRIPT_CONFIG, 'utf-8'));
+    const newConfig = {
+        ...tsConfig,
+        compilerOptions: {
+            ...tsConfig.compilerOptions,
+            outDir: 'dist',
+            declaration: true,
+            esModuleInterop: true,
+        },
+        include: (0, utils_1.distinct)([...(tsConfig.include ?? []), 'package.ts']),
+    };
+    await fs_1.promises.writeFile(paths_1.TYPESCRIPT_CONFIG, JSON.stringify(newConfig, null, 2), 'utf8');
+}
+async function getContractWrapperPath(contract) {
+    const config = await (0, compile_1.getCompilerConfigForContract)(contract);
+    if ((0, CompilerConfig_1.isCompilableConfig)(config)) {
+        return `./wrappers/${contract}`;
+    }
+    else {
+        const contractConfig = (0, compile_tact_1.extractContractConfig)(config, contract);
+        return `./${contractConfig.output}/${contract}_${contract}`;
+    }
+}
+async function generatePackageEntryPoint() {
+    const contracts = await (0, utils_1.findContracts)();
+    let entryPoint = 'import { Cell } from "@ton/core"\n';
+    for (const contract of contracts) {
+        const wrapperPath = await getContractWrapperPath(contract);
+        entryPoint += `import * as ${contract} from '${wrapperPath}';\n`;
+        entryPoint += `export { ${contract} };\n`;
+        const buildArtifactPath = path_1.default.join(paths_1.BUILD_DIR, `${contract}.compiled.json`);
+        const buildArtifact = JSON.parse(await fs_1.promises.readFile(buildArtifactPath, 'utf8'));
+        entryPoint += `export const ${contract}Code = Cell.fromHex("${buildArtifact.hex}");\n`;
+    }
+    await fs_1.promises.writeFile(paths_1.PACKAGE_ENTRY_POINT, entryPoint, 'utf8');
+}
+async function correctPackageJson() {
+    const packageJson = JSON.parse(await fs_1.promises.readFile(paths_1.PACKAGE_JSON, 'utf8'));
+    const newPackageJson = {
+        ...packageJson,
+        main: 'dist/package.js',
+        files: ['dist/**/*'],
+    };
+    await fs_1.promises.writeFile(paths_1.PACKAGE_JSON, JSON.stringify(newPackageJson, null, 2));
+}
+const pack = async (args, ui, context) => {
+    const localArgs = (0, arg_1.default)({
+        '--no-warn': Boolean,
+        '-n': '--no-warn',
+        ...constants_1.helpArgs,
+    });
+    if (localArgs['--help']) {
+        ui.write(constants_1.helpMessages['pack']);
+        return;
+    }
+    if (!localArgs['--no-warn']) {
+        ui.write('🚨 WARNING: This command may modify tsconfig.json, package.json, and remove the dist directory. Make sure these files are committed to your repository. If you wish to ignore this warning, use the -n or --no-warn flag.');
+        const answer = await ui.input('Are you sure you want to continue? (y/N)');
+        if (answer.toLowerCase() !== 'y') {
+            ui.write('Aborting...');
+            return;
+        }
+    }
+    ui.write('🔨 Building contracts... Please wait...');
+    await (0, build_1.buildAll)(ui);
+    ui.write('📦 Generating package entry point...');
+    await generatePackageEntryPoint();
+    ui.write('🛠️ Updating tsconfig.json...');
+    await correctTsConfig();
+    ui.write('🏗️ Building package...');
+    await fs_1.promises.rm(path_1.default.join(process.cwd(), 'dist'), { recursive: true, force: true });
+    (0, child_process_1.execSync)(`tsc`, { stdio: 'inherit' });
+    ui.write('📝 Updating package.json...');
+    await correctPackageJson();
+    ui.write('🎉 Package is ready and packed successfully! You can now publish it 🚀');
+};
+exports.pack = pack;