@ton/blueprint 0.12.1 → 0.14.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.14.0] - 2023-11-23
+
+### Added
+
+- Added `verify` command to quickly verify contracts on [verifier.ton.org](https://verifier.ton.org)
+
+## [0.13.0] - 2023-11-05
+
+### Added
+
+- Added plugin support
+- Added custom API v2 endpoints
+
+### Changed
+
+- Improved docs
+- Changed deployed contract explorer link to use tonviewer
+- Moved `deployer` to the global `describe` context in default tests
 
 ## [0.12.1] - 2023-07-31
 

package/README.md

@@ -30,7 +30,7 @@ npm create ton@latest
 ### 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)
+* 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/18541-ton-development)
 
  
 
@@ -49,11 +49,11 @@ npm create ton@latest
 * `scripts/` - Deployment scripts to mainnet/testnet and other scripts interacting with live contracts
 * `build/` - Compilation artifacts created here after running a build command
 
-### Build one of the contracts
+### Build contracts
 
 1. You need a compilation script in `wrappers/<CONTRACT>.compile.ts` - [example](/example/wrappers/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>`
+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`
 
@@ -62,6 +62,8 @@ npm create ton@latest
 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`
 
+> Learn more about writing tests from the Sandbox's documentation - [here](https://github.com/ton-org/sandbox#writing-tests).
+
 ### Deploy one of the contracts
 
 1. You need a deploy script in `scripts/deploy<CONTRACT>.ts` - [example](/example/scripts/deployCounter.ts)
@@ -93,13 +95,33 @@ Run in terminal: &nbsp; `npx blueprint help` &nbsp; or &nbsp; `yarn blueprint he
 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
 
-&nbsp;
+## Plugins
+
+Blueprint has a plugin system to allow the community to develop their own additions for the ecosystem without the need to change blueprint's code.
+
+In order to use plugins, create a `blueprint.config.ts` file in the root of your project with something like this:
+```typescript
+import { Config } from '@ton/blueprint';
+import { ScaffoldPlugin } from 'blueprint-scaffold';
+
+export const config: Config = {
+   plugins: [new ScaffoldPlugin()],
+};
+```
+(This example shows how to add the [scaffold](https://github.com/1IxI1/blueprint-scaffold) plugin)
+
+It is important that the config is exported, is named `config`, and is not `default` exported.
+
+Here are some of the plugins developed by the community:
+- [scaffold](https://github.com/1IxI1/blueprint-scaffold) - allows developers to quickly create a simple dapp automatically using the wrappers' code
 
 ## Contributors
 

package/dist/build.d.ts

@@ -0,0 +1,3 @@
+import { UIProvider } from './ui/UIProvider';
+export declare function buildOne(contract: string, ui?: UIProvider): Promise<void>;
+export declare function buildAll(ui?: UIProvider): Promise<void>;

package/dist/build.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAll = exports.buildOne = void 0;
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
+const compile_1 = require("./compile/compile");
+const paths_1 = require("./paths");
+const utils_1 = require("./utils");
+async function buildOne(contract, ui) {
+    ui?.write(`Build script running, compiling ${contract}`);
+    const buildArtifactPath = path_1.default.join(paths_1.BUILD_DIR, `${contract}.compiled.json`);
+    try {
+        await promises_1.default.unlink(buildArtifactPath);
+    }
+    catch (e) { }
+    ui?.setActionPrompt('⏳ Compiling...');
+    try {
+        const result = await (0, compile_1.doCompile)(contract);
+        if (result.lang === 'tact') {
+            for (const [k, v] of result.fs) {
+                await promises_1.default.mkdir(path_1.default.dirname(k), {
+                    recursive: true,
+                });
+                await promises_1.default.writeFile(k, v);
+            }
+        }
+        const cell = result.code;
+        ui?.clearActionPrompt();
+        ui?.write('\n✅ Compiled successfully! Cell BOC hex result:\n\n');
+        ui?.write(cell.toBoc().toString('hex'));
+        await promises_1.default.mkdir(paths_1.BUILD_DIR, { recursive: true });
+        await promises_1.default.writeFile(buildArtifactPath, JSON.stringify({
+            hex: cell.toBoc().toString('hex'),
+        }));
+        ui?.write(`\n✅ Wrote compilation artifact to ${path_1.default.relative(process.cwd(), buildArtifactPath)}`);
+    }
+    catch (e) {
+        if (ui) {
+            ui?.clearActionPrompt();
+            ui?.write(e.toString());
+            process.exit(1);
+        }
+        else {
+            throw e;
+        }
+    }
+}
+exports.buildOne = buildOne;
+async function buildAll(ui) {
+    for (const file of await (0, utils_1.findCompiles)()) {
+        await buildOne(file.name, ui);
+    }
+}
+exports.buildAll = buildAll;

package/dist/cli/Runner.d.ts

@@ -0,0 +1,5 @@
+import arg from 'arg';
+import { UIProvider } from '../ui/UIProvider';
+export declare const argSpec: {};
+export type Args = arg.Result<typeof argSpec>;
+export type Runner = (args: Args, ui: UIProvider) => Promise<void>;

package/dist/cli/Runner.js

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

package/dist/cli/build.d.ts

@@ -1,4 +1,8 @@
-import { Runner } from './cli';
+import { Args, Runner } from './Runner';
 import { UIProvider } from '../ui/UIProvider';
-export declare function buildOne(contract: string, ui: UIProvider): Promise<void>;
+export declare function selectCompile(ui: UIProvider, args: Args): Promise<{
+    module: any;
+    name: string;
+    path: string;
+}>;
 export declare const build: Runner;

package/dist/cli/build.js

@@ -3,64 +3,28 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.build = exports.buildOne = void 0;
-const path_1 = __importDefault(require("path"));
-const paths_1 = require("../paths");
+exports.build = exports.selectCompile = void 0;
 const utils_1 = require("../utils");
-const promises_1 = __importDefault(require("fs/promises"));
-const compile_1 = require("../compile/compile");
 const arg_1 = __importDefault(require("arg"));
-async function buildOne(contract, ui) {
-    ui.write(`Build script running, compiling ${contract}\n`);
-    const buildArtifactPath = path_1.default.join(paths_1.BUILD_DIR, `${contract}.compiled.json`);
-    try {
-        await promises_1.default.unlink(buildArtifactPath);
-    }
-    catch (e) { }
-    ui.write('⏳ Compiling...\n');
-    try {
-        const result = await (0, compile_1.doCompile)(contract);
-        if (result.lang === 'tact') {
-            for (const [k, v] of result.fs) {
-                await promises_1.default.mkdir(path_1.default.dirname(k), {
-                    recursive: true,
-                });
-                await promises_1.default.writeFile(k, v);
-            }
-        }
-        const cell = result.code;
-        ui.write('✅ Compiled successfully! Cell BOC hex result:\n\n');
-        ui.write(cell.toBoc().toString('hex'));
-        await promises_1.default.mkdir(paths_1.BUILD_DIR, { recursive: true });
-        await promises_1.default.writeFile(buildArtifactPath, JSON.stringify({
-            hex: cell.toBoc().toString('hex'),
-        }));
-        ui.write(`\n✅ Wrote compilation artifact to ${path_1.default.relative(process.cwd(), buildArtifactPath)}`);
-    }
-    catch (e) {
-        ui.write(e.toString());
-        process.exit(1);
-    }
+const build_1 = require("../build");
+async function selectCompile(ui, args) {
+    return await (0, utils_1.selectFile)(await (0, utils_1.findCompiles)(), {
+        ui,
+        hint: args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined,
+        import: false,
+    });
 }
-exports.buildOne = buildOne;
+exports.selectCompile = selectCompile;
 const build = async (args, ui) => {
-    require('ts-node/register');
     const localArgs = (0, arg_1.default)({
         '--all': Boolean,
     });
-    const files = await (0, utils_1.findCompiles)();
     if (localArgs['--all']) {
-        for (const file of files) {
-            await buildOne(file.name, ui);
-        }
+        await (0, build_1.buildAll)();
     }
     else {
-        const sel = await (0, utils_1.selectFile)(files, {
-            ui,
-            hint: args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined,
-            import: false,
-        });
-        await buildOne(sel.name, ui);
+        const sel = await selectCompile(ui, args);
+        await (0, build_1.buildOne)(sel.name, ui);
     }
 };
 exports.build = build;

package/dist/cli/cli.d.ts

@@ -1,7 +1,2 @@
 #!/usr/bin/env node
-import arg from 'arg';
-import { UIProvider } from '../ui/UIProvider';
-declare const argSpec: {};
-export type Args = arg.Result<typeof argSpec>;
-export type Runner = (args: Args, ui: UIProvider) => Promise<void>;
 export {};

package/dist/cli/cli.js

@@ -35,33 +35,77 @@ const create_1 = require("./create");
 const run_1 = require("./run");
 const build_1 = require("./build");
 const test_1 = require("./test");
+const verify_1 = require("./verify");
 const help_1 = require("./help");
 const InquirerUIProvider_1 = require("../ui/InquirerUIProvider");
-const argSpec = {};
+const Runner_1 = require("./Runner");
+const path_1 = __importDefault(require("path"));
 const runners = {
     create: create_1.create,
     run: run_1.run,
     build: build_1.build,
     test: test_1.test,
     help: help_1.help,
+    verify: verify_1.verify,
 };
 async function main() {
-    const args = (0, arg_1.default)(argSpec, {
+    var _a;
+    require('ts-node/register');
+    const args = (0, arg_1.default)(Runner_1.argSpec, {
         permissive: true,
     });
     if (args._.length === 0) {
         showHelp();
         process.exit(0);
     }
-    const runner = runners[args._[0]];
+    let effectiveRunners = {};
+    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;
+                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
+    }
+    effectiveRunners = {
+        ...effectiveRunners,
+        ...runners,
+    };
+    const runner = effectiveRunners[args._[0]];
     if (!runner) {
         console.log(chalk_1.default.redBright(` Error: command not found.`) + ` Run 'blueprint help' to see available commands\n`);
         process.exit(1);
     }
     const ui = new InquirerUIProvider_1.InquirerUIProvider();
+    const waitingForCustomLink = args._.includes('--custom');
     await runner({
         ...args,
-        _: args._.filter((a) => !(a.length > 1 && a[0] === '-')), // filter out the flags pushed by `permissive`
+        _: args._.filter((a, inx) => {
+            // filter out the flags
+            if (a.length > 1 && a[0] === '-')
+                return false;
+            // and endpoint urls
+            if (waitingForCustomLink) {
+                if (args._[inx - 1] === '--custom' && // url goes after --custom
+                    a.startsWith('http'))
+                    return false;
+            }
+            return true;
+        }),
     }, ui);
     ui.close();
 }

package/dist/cli/create.d.ts

@@ -1,4 +1,4 @@
-import { Runner } from './cli';
+import { Runner } from './Runner';
 export declare const templateTypes: {
     name: string;
     value: string;

package/dist/cli/create.js

@@ -9,7 +9,7 @@ const path_1 = __importDefault(require("path"));
 const template_1 = require("../template");
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
-const build_1 = require("./build");
+const build_1 = require("../build");
 function toSnakeCase(v) {
     const r = v.replace(/[A-Z]/g, (sub) => '_' + sub.toLowerCase());
     return r[0] === '_' ? r.substring(1) : r;

package/dist/cli/help.d.ts

@@ -1,2 +1,3 @@
-import { Runner } from './cli';
+import { Runner } from './Runner';
+export declare let additionalHelpMessages: Record<string, string>;
 export declare const help: Runner;

package/dist/cli/help.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.help = void 0;
+exports.help = exports.additionalHelpMessages = void 0;
 const create_1 = require("./create");
 const helpMessages = {
     help: `Usage: blueprint help [command]
@@ -14,7 +14,8 @@ List of available commands:
 - run
 - build
 - help
-- test`,
+- test
+- verify`,
     create: `Usage: blueprint create [contract name] [flags]
 
 Creates a new contract together with supporting files according to a template.
@@ -33,8 +34,9 @@ Script name is matched (ignoring case) to a file in the scripts directory. If no
 
 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-v2-endpoint] - indicates that a custom API should be used when running the script, and the API URL optionally.
 --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, --tonapi, --toncx, --dton - specifies the network explorer to use when displaying links to the deployed contracts. Default: tonscan.`,
+--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.
@@ -46,10 +48,24 @@ Flags:
     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 on which to verify the contract. If not specified on the command line, it will be asked interactively.`
 };
+exports.additionalHelpMessages = {};
 const help = async (args, ui) => {
     const cmd = args._.length >= 2 ? args._[1].toLowerCase() : '';
-    const helpMessage = cmd in helpMessages ? helpMessages[cmd] : helpMessages['help'];
+    const effectiveHelpMessages = {
+        ...exports.additionalHelpMessages,
+        ...helpMessages,
+    };
+    for (const k in exports.additionalHelpMessages) {
+        effectiveHelpMessages.help += '\n- ' + k;
+    }
+    const helpMessage = cmd in effectiveHelpMessages ? effectiveHelpMessages[cmd] : effectiveHelpMessages['help'];
     ui.write(helpMessage);
 };
 exports.help = help;

package/dist/cli/run.d.ts

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

package/dist/cli/run.js

@@ -4,7 +4,6 @@ exports.run = void 0;
 const createNetworkProvider_1 = require("../network/createNetworkProvider");
 const utils_1 = require("../utils");
 const run = async (args, ui) => {
-    require('ts-node/register');
     const { module: mod } = await (0, utils_1.selectFile)(await (0, utils_1.findScripts)(), {
         ui,
         hint: args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined,

package/dist/cli/test.d.ts

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

package/dist/cli/test.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.test = void 0;
 const child_process_1 = require("child_process");
 const test = async () => {
-    require('ts-node/register');
     (0, child_process_1.execSync)('npm test', { stdio: 'inherit' });
 };
 exports.test = test;

package/dist/cli/verify.d.ts

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

package/dist/cli/verify.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verify = void 0;
+const core_1 = require("@ton/core");
+const compile_1 = require("../compile/compile");
+const path_1 = __importDefault(require("path"));
+const createNetworkProvider_1 = require("../network/createNetworkProvider");
+const build_1 = require("./build");
+const backends = {
+    mainnet: {
+        verifierRegistry: core_1.Address.parse('EQDS0AW7NV1w3nFwx-mmryfpH4OGQ3PXnoFGOJA_8PTHuLrw'),
+        backends: [
+            'https://ton-source-prod-1.herokuapp.com',
+            'https://ton-source-prod-2.herokuapp.com',
+            'https://ton-source-prod-3.herokuapp.com',
+        ],
+        id: 'orbs.com',
+    },
+    testnet: {
+        verifierRegistry: core_1.Address.parse('EQB--CRXUbqYbqJKScEWeOrnk0TKJxB071M-WwvMpMEvq6Ed'),
+        backends: ['https://ton-source-prod-testnet-1.herokuapp.com'],
+        id: 'orbs-testnet',
+    },
+};
+function removeRandom(els) {
+    return els.splice(Math.floor(Math.random() * els.length), 1)[0];
+}
+class VerifierRegistry {
+    constructor(address) {
+        this.address = address;
+    }
+    async getVerifiers(provider) {
+        const res = await provider.get('get_verifiers', []);
+        const item = res.stack.readCell();
+        const c = item.beginParse();
+        const d = c.loadDict(core_1.Dictionary.Keys.BigUint(256), {
+            serialize: () => {
+                throw undefined;
+            },
+            parse: (s) => s,
+        });
+        return Array.from(d.values()).map((v) => {
+            const admin = v.loadAddress();
+            const quorom = v.loadUint(8);
+            const pubKeyEndpoints = v.loadDict(core_1.Dictionary.Keys.BigUint(256), core_1.Dictionary.Values.Uint(32));
+            return {
+                admin: admin,
+                quorum: quorom,
+                pubKeyEndpoints: new Map(Array.from(pubKeyEndpoints).map(([k, v]) => [k, v])),
+                name: v.loadRef().beginParse().loadStringTail(),
+                url: v.loadRef().beginParse().loadStringTail(),
+            };
+        });
+    }
+}
+const verify = async (args, ui) => {
+    const sel = await (0, build_1.selectCompile)(ui, args);
+    const networkProvider = await (0, createNetworkProvider_1.createNetworkProvider)(ui, false);
+    const sender = networkProvider.sender();
+    const senderAddress = sender.address;
+    if (senderAddress === undefined) {
+        throw new Error('Sender address needs to be known');
+    }
+    const network = networkProvider.network();
+    if (network === 'custom') {
+        throw new Error('Cannot use custom network');
+    }
+    const addr = await ui.input('Deployed contract address');
+    const result = await (0, compile_1.doCompile)(sel.name);
+    let src;
+    const fd = new FormData();
+    if (result.lang === 'func') {
+        for (const f of result.snapshot) {
+            fd.append(f.filename, new Blob([f.content]), path_1.default.basename(f.filename));
+        }
+        src = {
+            compiler: 'func',
+            compilerSettings: {
+                funcVersion: result.version,
+                commandLine: '-SPA ' + result.targets.join(' '),
+            },
+            knownContractAddress: addr,
+            knownContractHash: result.code.hash().toString('base64'),
+            sources: result.snapshot.map((s) => ({
+                includeInCommand: result.targets.includes(s.filename),
+                isEntrypoint: result.targets.includes(s.filename),
+                isStdLib: false,
+                hasIncludeDirectives: true,
+                folder: path_1.default.dirname(s.filename),
+            })),
+            senderAddress: senderAddress.toString(),
+        };
+    }
+    else if (result.lang === 'tact') {
+        let pkg = undefined;
+        for (const [k, v] of result.fs) {
+            if (k.endsWith('.pkg')) {
+                pkg = {
+                    name: k,
+                    content: v,
+                };
+                break;
+            }
+        }
+        if (pkg === undefined) {
+            throw new Error('Could not find .pkg in compilation results');
+        }
+        fd.append(path_1.default.basename(pkg.name), new Blob([pkg.content]), path_1.default.basename(pkg.name));
+        src = {
+            compiler: 'tact',
+            compilerSettings: {
+                tactVersion: '',
+            },
+            knownContractAddress: addr,
+            knownContractHash: result.code.hash().toString('base64'),
+            sources: [
+                {
+                    includeInCommand: true,
+                    isEntrypoint: false,
+                    isStdLib: false,
+                    hasIncludeDirectives: false,
+                    folder: '',
+                },
+            ],
+            senderAddress: senderAddress.toString(),
+        };
+    }
+    else {
+        // future proofing
+        throw new Error('Unsupported language ' + result.lang);
+    }
+    fd.append('json', new Blob([JSON.stringify(src)], {
+        type: 'application/json',
+    }), 'blob');
+    const backend = backends[network];
+    const verifierRegistry = networkProvider.open(new VerifierRegistry(backend.verifierRegistry));
+    const verifier = (await verifierRegistry.getVerifiers()).find((v) => v.name === backend.id);
+    if (verifier === undefined) {
+        throw new Error('Could not find verifier');
+    }
+    const remainingBackends = [...backend.backends];
+    const sourceResponse = await fetch(removeRandom(remainingBackends) + '/source', {
+        method: 'POST',
+        body: fd,
+    });
+    if (sourceResponse.status !== 200) {
+        throw new Error('Could not compile on backend:\n' + (await sourceResponse.text()));
+    }
+    const sourceResult = await sourceResponse.json();
+    if (sourceResult.compileResult.result !== 'similar') {
+        throw new Error('The code is not similar');
+    }
+    let msgCell = sourceResult.msgCell;
+    let acquiredSigs = 1;
+    while (acquiredSigs < verifier.quorum) {
+        const signResponse = await fetch(removeRandom(remainingBackends) + '/sign', {
+            method: 'POST',
+            body: JSON.stringify({
+                messageCell: msgCell,
+            }),
+        });
+        if (signResponse.status !== 200) {
+            throw new Error('Could not compile on backend:\n' + (await signResponse.text()));
+        }
+        const signResult = await signResponse.json();
+        msgCell = signResult.msgCell;
+        acquiredSigs++;
+    }
+    const c = core_1.Cell.fromBoc(Buffer.from(msgCell.data))[0];
+    await networkProvider.sender().send({
+        to: backend.verifierRegistry,
+        value: (0, core_1.toNano)('0.5'),
+        body: c,
+    });
+};
+exports.verify = verify;

package/dist/compile/compile.d.ts

@@ -1,8 +1,12 @@
 /// <reference types="node" />
+import { SourcesArray } from '@ton-community/func-js';
 import { Cell } from '@ton/core';
 export type FuncCompileResult = {
     lang: 'func';
     code: Cell;
+    targets: string[];
+    snapshot: SourcesArray;
+    version: string;
 };
 export type TactCompileResult = {
     lang: 'tact';

package/dist/compile/compile.js

@@ -36,7 +36,6 @@ const compiler_1 = require("@tact-lang/compiler");
 const OverwritableVirtualFileSystem_1 = require("./OverwritableVirtualFileSystem");
 async function getCompilerConfigForContract(name) {
     var _a;
-    require('ts-node/register');
     const mod = await (_a = path_1.default.join(paths_1.WRAPPERS_DIR, name + '.compile.ts'), Promise.resolve().then(() => __importStar(require(_a))));
     if (typeof mod.compile !== 'object') {
         throw new Error(`Object 'compile' is missing`);
@@ -47,9 +46,19 @@ async function doCompileFunc(config) {
     const cr = await (0, func_js_1.compileFunc)(config);
     if (cr.status === 'error')
         throw new Error(cr.message);
+    let targets = [];
+    if (config.targets) {
+        targets = config.targets;
+    }
+    else if (Array.isArray(config.sources)) {
+        targets = config.sources.map((s) => s.filename);
+    }
     return {
         lang: 'func',
         code: core_1.Cell.fromBase64(cr.codeBoc),
+        targets,
+        snapshot: cr.snapshot,
+        version: (await (0, func_js_1.compilerVersion)()).funcVersion,
     };
 }
 function findTactBoc(fs) {

package/dist/config/Config.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from './Plugin';
+export interface Config {
+    plugins: Plugin[];
+}

package/dist/config/Config.js

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

package/dist/config/Plugin.d.ts

@@ -0,0 +1,9 @@
+import { Runner } from '../cli/Runner';
+export interface PluginRunner {
+    name: string;
+    runner: Runner;
+    help: string;
+}
+export interface Plugin {
+    runners(): PluginRunner[];
+}

package/dist/config/Plugin.js

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

package/dist/index.d.ts

@@ -4,3 +4,7 @@ export { createNetworkProvider } from './network/createNetworkProvider';
 export { compile } from './compile/compile';
 export { CompilerConfig } from './compile/CompilerConfig';
 export { UIProvider } from './ui/UIProvider';
+export { Config } from './config/Config';
+export { Args, Runner } from './cli/Runner';
+export { PluginRunner, Plugin } from './config/Plugin';
+export { buildOne, buildAll } from './build';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compile = exports.createNetworkProvider = exports.sleep = exports.tonDeepLink = void 0;
+exports.buildAll = exports.buildOne = 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,3 +8,6 @@ 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; } });
+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/NetworkProvider.d.ts

@@ -1,10 +1,10 @@
-import { TonClient4 } from '@ton/ton';
+import { TonClient, TonClient4 } from '@ton/ton';
 import { Address, Cell, Contract, ContractProvider, OpenedContract, Sender } from '@ton/core';
 import { UIProvider } from '../ui/UIProvider';
 export interface NetworkProvider {
-    network(): 'mainnet' | 'testnet';
+    network(): 'mainnet' | 'testnet' | 'custom';
     sender(): Sender;
-    api(): TonClient4;
+    api(): TonClient4 | TonClient;
     provider(address: Address, init?: {
         code?: Cell;
         data?: Cell;

package/dist/network/createNetworkProvider.d.ts

@@ -1,3 +1,3 @@
 import { UIProvider } from '../ui/UIProvider';
 import { NetworkProvider } from './NetworkProvider';
-export declare function createNetworkProvider(ui: UIProvider): Promise<NetworkProvider>;
+export declare function createNetworkProvider(ui: UIProvider, allowCustom?: boolean): Promise<NetworkProvider>;

package/dist/network/createNetworkProvider.js

@@ -32,12 +32,13 @@ const MnemonicProvider_1 = require("./send/MnemonicProvider");
 const argSpec = {
     '--mainnet': Boolean,
     '--testnet': Boolean,
+    '--custom': String,
     '--tonconnect': Boolean,
     '--deeplink': Boolean,
     '--tonhub': Boolean,
     '--mnemonic': Boolean,
     '--tonscan': Boolean,
-    '--tonapi': Boolean,
+    '--tonviewer': Boolean,
     '--toncx': Boolean,
     '--dton': Boolean,
 };
@@ -52,7 +53,7 @@ class SendProviderSender {
             console.warn("Warning: blueprint's Sender does not support `bounce` flag, because it is ignored by all used Sender APIs");
             console.warn('To silence this warning, change your `bounce` flags passed to Senders to unset or undefined');
         }
-        if (!(args.sendMode === undefined || args.sendMode == core_1.SendMode.PAY_GAS_SEPARATELY)) {
+        if (!(args.sendMode === undefined || args.sendMode === core_1.SendMode.PAY_GAS_SEPARATELY)) {
             throw new Error('Deployer sender does not support `sendMode` other than `PAY_GAS_SEPARATELY`');
         }
         await __classPrivateFieldGet(this, _SendProviderSender_provider, "f").sendTransaction(args.to, args.value, args.body ?? undefined, args.init ?? undefined);
@@ -116,10 +117,20 @@ class NetworkProviderImpl {
         return __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f");
     }
     provider(address, init) {
-        return new WrappedContractProvider(address, __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address, init ? { code: init.code ?? new core_1.Cell(), data: init.data ?? new core_1.Cell() } : undefined), init);
+        if (__classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f") instanceof ton_1.TonClient4) {
+            return new WrappedContractProvider(address, __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address, init ? { code: init.code ?? new core_1.Cell(), data: init.data ?? new core_1.Cell() } : undefined), init);
+        }
+        else {
+            return new WrappedContractProvider(address, __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address, { code: init?.code ?? new core_1.Cell(), data: init?.data ?? new core_1.Cell() }), init);
+        }
     }
     async isContractDeployed(address) {
-        return __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").isContractDeployed((await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").getLastBlock()).last.seqno, address);
+        if (__classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f") instanceof ton_1.TonClient4) {
+            return __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").isContractDeployed((await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").getLastBlock()).last.seqno, address);
+        }
+        else {
+            return (await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").getContractState(address)).state === 'active';
+        }
     }
     async waitForDeploy(address, attempts = 10, sleepDuration = 2000) {
         if (attempts <= 0) {
@@ -185,24 +196,40 @@ async function createMnemonicProvider(client, ui) {
     });
 }
 class NetworkProviderBuilder {
-    constructor(args, ui) {
+    constructor(args, ui, allowCustom = true) {
         this.args = args;
         this.ui = ui;
+        this.allowCustom = allowCustom;
     }
     async chooseNetwork() {
         let network = (0, utils_1.oneOrZeroOf)({
             mainnet: this.args['--mainnet'],
             testnet: this.args['--testnet'],
+            custom: this.args['--custom'] !== undefined,
         });
         if (!network) {
-            network = await this.ui.choose('Which network do you want to use?', ['mainnet', 'testnet'], (c) => c);
+            let nets = ['mainnet', 'testnet'];
+            if (this.allowCustom) {
+                nets = ['mainnet', 'testnet', 'custom'];
+            }
+            network = await this.ui.choose('Which network do you want to use?', nets, (c) => c);
+            if (network === 'custom') {
+                const defaultCustomEndpoint = 'http://localhost:8081/';
+                this.args['--custom'] = (await this.ui.input(`Provide a custom API v2 endpoint (default is ${defaultCustomEndpoint})`)).trim();
+                if (this.args['--custom'] === '')
+                    this.args['--custom'] = defaultCustomEndpoint;
+                this.args['--custom'] += 'jsonRPC';
+            }
+        }
+        if (network === 'custom' && !this.allowCustom) {
+            throw new Error('Custom network is not allowed');
         }
         return network;
     }
     chooseExplorer() {
         return ((0, utils_1.oneOrZeroOf)({
             tonscan: this.args['--tonscan'],
-            tonapi: this.args['--tonapi'],
+            tonviewer: this.args['--tonviewer'],
             toncx: this.args['--toncx'],
             dton: this.args['--dton'],
         }) ?? 'tonscan');
@@ -241,9 +268,13 @@ class NetworkProviderBuilder {
                 provider = new DeeplinkProvider_1.DeeplinkProvider(this.ui);
                 break;
             case 'tonconnect':
+                if (network === 'custom')
+                    throw new Error('Tonkeeper cannot work with custom network.');
                 provider = new TonConnectProvider_1.TonConnectProvider(new FSStorage_1.FSStorage(storagePath), this.ui);
                 break;
             case 'tonhub':
+                if (network === 'custom')
+                    throw new Error('TonHub cannot work with custom network.');
                 provider = new TonHubProvider_1.TonHubProvider(network, new FSStorage_1.FSStorage(storagePath), this.ui);
                 break;
             case 'mnemonic':
@@ -257,9 +288,15 @@ class NetworkProviderBuilder {
     async build() {
         const network = await this.chooseNetwork();
         const explorer = this.chooseExplorer();
-        const tc = new ton_1.TonClient4({
-            endpoint: await (0, ton_access_1.getHttpV4Endpoint)({ network }),
-        });
+        let tc;
+        if (network === 'custom') {
+            tc = new ton_1.TonClient({ endpoint: this.args['--custom'] });
+        }
+        else {
+            tc = new ton_1.TonClient4({
+                endpoint: await (0, ton_access_1.getHttpV4Endpoint)({ network }),
+            });
+        }
         const sendProvider = await this.chooseSendProvider(network, tc);
         try {
             await sendProvider.connect();
@@ -275,8 +312,8 @@ class NetworkProviderBuilder {
         return new NetworkProviderImpl(tc, sender, network, explorer, this.ui);
     }
 }
-async function createNetworkProvider(ui) {
+async function createNetworkProvider(ui, allowCustom = true) {
     const args = (0, arg_1.default)(argSpec);
-    return await new NetworkProviderBuilder(args, ui).build();
+    return await new NetworkProviderBuilder(args, ui, allowCustom).build();
 }
 exports.createNetworkProvider = createNetworkProvider;

package/dist/network/send/MnemonicProvider.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { TonClient4 } from '@ton/ton';
+import { TonClient, TonClient4 } from '@ton/ton';
 import { Address, Cell, StateInit } from '@ton/core';
 import { SendProvider } from './SendProvider';
 import { UIProvider } from '../../ui/UIProvider';
@@ -10,7 +10,7 @@ export declare class MnemonicProvider implements SendProvider {
         version: WalletVersion;
         workchain?: number;
         secretKey: Buffer;
-        client: TonClient4;
+        client: TonClient4 | TonClient;
         ui: UIProvider;
     });
     connect(): Promise<void>;

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

@@ -13,6 +13,7 @@ describe('{{name}}', () => {
     });
 
     let blockchain: Blockchain;
+    let deployer: SandboxContract<TreasuryContract>;
     let {{loweredName}}: SandboxContract<{{name}}>;
 
     beforeEach(async () => {
@@ -28,7 +29,7 @@ describe('{{name}}', () => {
             )
         );
 
-        const deployer = await blockchain.treasury('deployer');
+        deployer = await blockchain.treasury('deployer');
 
         const deployResult = await {{loweredName}}.sendDeploy(deployer.getSender(), toNano('0.05'));
 

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

@@ -13,6 +13,7 @@ describe('{{name}}', () => {
     });
 
     let blockchain: Blockchain;
+    let deployer: SandboxContract<TreasuryContract>;
     let {{loweredName}}: SandboxContract<{{name}}>;
 
     beforeEach(async () => {
@@ -20,7 +21,7 @@ describe('{{name}}', () => {
 
         {{loweredName}} = blockchain.openContract({{name}}.createFromConfig({}, code));
 
-        const deployer = await blockchain.treasury('deployer');
+        deployer = await blockchain.treasury('deployer');
 
         const deployResult = await {{loweredName}}.sendDeploy(deployer.getSender(), toNano('0.05'));
 

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

@@ -6,6 +6,7 @@ import '@ton/test-utils';
 
 describe('{{name}}', () => {
     let blockchain: Blockchain;
+    let deployer: SandboxContract<TreasuryContract>;
     let {{loweredName}}: SandboxContract<{{name}}>;
 
     beforeEach(async () => {
@@ -13,7 +14,7 @@ describe('{{name}}', () => {
 
         {{loweredName}} = blockchain.openContract(await {{name}}.fromInit(0n));
 
-        const deployer = await blockchain.treasury('deployer');
+        deployer = await blockchain.treasury('deployer');
 
         const deployResult = await {{loweredName}}.send(
             deployer.getSender(),

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

@@ -6,6 +6,7 @@ import '@ton/test-utils';
 
 describe('{{name}}', () => {
     let blockchain: Blockchain;
+    let deployer: SandboxContract<TreasuryContract>;
     let {{loweredName}}: SandboxContract<{{name}}>;
 
     beforeEach(async () => {
@@ -13,7 +14,7 @@ describe('{{name}}', () => {
 
         {{loweredName}} = blockchain.openContract(await {{name}}.fromInit());
 
-        const deployer = await blockchain.treasury('deployer');
+        deployer = await blockchain.treasury('deployer');
 
         const deployResult = await {{loweredName}}.send(
             deployer.getSender(),

package/dist/utils.js

@@ -109,8 +109,8 @@ function getExplorerLink(address, network, explorer) {
     switch (explorer) {
         case 'tonscan':
             return `https://${networkPrefix}tonscan.org/address/${address}`;
-        case 'tonapi':
-            return `https://${networkPrefix}tonapi.io/account/${address}`;
+        case 'tonviewer':
+            return `https://${networkPrefix}tonviewer.com/${address}`;
         case 'toncx':
             return `https://${networkPrefix}ton.cx/address/${address}`;
         case 'dton':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.12.1",
+  "version": "0.14.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -25,7 +25,7 @@
     "@types/inquirer": "^8.2.6",
     "@types/node": "^20.2.5",
     "@types/qrcode-terminal": "^0.12.0",
-    "prettier": "^2.8.8",
+    "prettier": "^3.0.3",
     "typescript": "^4.9.5"
   },
   "peerDependencies": {