@ton/blueprint 0.34.0 → 0.36.0-dev.20250609174628.e67475d

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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).
 
+## Unreleased
+
+### Added
+
+- Added `getConfig` and `getContractState` methods to network provider
+
+## [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

package/README.md

@@ -55,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
 
@@ -63,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
 
@@ -75,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
@@ -126,7 +131,7 @@ To run scripts using a wallet by mnemonic authentication, you need to configure
 
 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`.
+* **`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`).
@@ -292,6 +297,33 @@ 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
@@ -310,6 +342,36 @@ export const config: Config = {
 };
 ```
 
+### 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/build.js

@@ -17,8 +17,9 @@ async function buildOne(contract, ui) {
     const buildArtifactPath = path_1.default.join(paths_1.BUILD_DIR, `${contract}.compiled.json`);
     try {
         await promises_1.default.unlink(buildArtifactPath);
+        // eslint-disable-next-line no-empty
     }
-    catch (e) { }
+    catch (_) { }
     ui?.setActionPrompt('⏳ Compiling...');
     try {
         const config = await (0, compile_1.getCompilerConfigForContract)(contract);
@@ -83,9 +84,6 @@ async function buildAllTact(ui) {
         .filter((file) => (0, compile_1.extractCompilableConfig)(file.path).lang === 'tact')
         .map((file) => file.name);
     const tactConfig = (0, tact_config_1.getRootTactConfig)();
-    const tactContracts = [
-        ...legacyTactContract,
-        ...tactConfig.projects.map((project) => project.name),
-    ];
+    const tactContracts = [...legacyTactContract, ...tactConfig.projects.map((project) => project.name)];
     await buildContracts(tactContracts, ui);
 }

package/dist/cli/cli.js

@@ -69,6 +69,7 @@ const runners = {
     snapshot: snapshot_1.snapshot,
 };
 async function main() {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
     require('ts-node/register');
     const args = (0, arg_1.default)(Runner_1.argSpec, {
         permissive: true,

package/dist/cli/constants.js

@@ -54,7 +54,7 @@ Blueprint is generally invoked as follows:
   ${chalk_1.default.cyan('blueprint')} ${chalk_1.default.yellow('[command]')} ${chalk_1.default.gray('[command-args]')} ${chalk_1.default.gray('[flags]')}
 
 ${chalk_1.default.bold('List of available commands:')}
-${availableCommands.map(c => `- ${chalk_1.default.green(c)}`).join('\n')}`,
+${availableCommands.map((c) => `- ${chalk_1.default.green(c)}`).join('\n')}`,
     create: `${chalk_1.default.bold('Usage:')} blueprint ${chalk_1.default.cyan('create')} ${chalk_1.default.yellow('[contract name]')} ${chalk_1.default.gray('[flags]')}
 
 Creates a new contract together with supporting files according to a template.

package/dist/cli/convert.js

@@ -44,7 +44,7 @@ function findFile(dir, filename) {
     }
     return foundPath;
 }
-function parseCompileString(str, src_dir, ui) {
+function parseCompileString(str, src_dir, _ui) {
     // Naive but does the job
     const tokens = str.split(/\\?\s+/).filter((t) => t != '\\');
     const outputIdx = tokens.indexOf('-o');
@@ -52,7 +52,7 @@ function parseCompileString(str, src_dir, ui) {
         throw new Error('No output flag (-o) found in command:' + str);
     }
     const outFile = tokens[outputIdx + 1];
-    const outputName = outFile.match(/([A-Za-z0-9\-_\\\/]*)/);
+    const outputName = outFile.match(/([A-Za-z0-9\-_\\/]*)/);
     if (outputName === null) {
         throw new Error(`Something went wrong when parsing output from ${outFile}`);
     }
@@ -80,7 +80,7 @@ function parseCompileString(str, src_dir, ui) {
         targets: sourceFiles.join(','),
     };
 }
-const convert = async (args, ui) => {
+const convert = async (_args, ui) => {
     const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
     if (localArgs['--help']) {
         ui.write(constants_1.helpMessages['convert']);

package/dist/cli/create.js

@@ -70,7 +70,7 @@ function addToTactConfig(contractName, contractPath) {
     };
     (0, tact_config_1.updateRootTactConfig)(newConfig);
 }
-const create = async (args, ui) => {
+const create = async (_args, ui) => {
     const localArgs = (0, arg_1.default)({
         '--type': String,
         ...constants_1.helpArgs,

package/dist/cli/pack.js

@@ -6,8 +6,8 @@ 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 arg_1 = __importDefault(require("arg"));
 const constants_1 = require("./constants");
 const build_1 = require("../build");
 const paths_1 = require("../paths");
@@ -64,7 +64,7 @@ async function correctPackageJson() {
     };
     await fs_1.promises.writeFile(paths_1.PACKAGE_JSON, JSON.stringify(newPackageJson, null, 2));
 }
-const pack = async (args, ui, context) => {
+const pack = async (_args, ui, _context) => {
     const localArgs = (0, arg_1.default)({
         '--no-warn': Boolean,
         '-n': '--no-warn',
@@ -89,7 +89,10 @@ const pack = async (args, ui, context) => {
     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 });
+    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();

package/dist/cli/rename.js

@@ -5,9 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rename = void 0;
 exports.renameExactIfRequired = renameExactIfRequired;
-const arg_1 = __importDefault(require("arg"));
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
+const arg_1 = __importDefault(require("arg"));
 const paths_1 = require("../paths");
 const Runner_1 = require("./Runner");
 const utils_1 = require("../utils");
@@ -35,7 +35,10 @@ class RenameContext {
         if (!(0, fs_1.existsSync)(directory)) {
             return;
         }
-        const dir = await fs_1.promises.readdir(directory, { recursive: true, withFileTypes: true });
+        const dir = await fs_1.promises.readdir(directory, {
+            recursive: true,
+            withFileTypes: true,
+        });
         await Promise.all(dir.map(async (dir) => {
             if (!dir.isFile()) {
                 return;
@@ -61,7 +64,7 @@ class RenameContext {
         }
     }
 }
-const rename = async (args, ui, context) => {
+const rename = async (_args, ui, _context) => {
     const localArgs = (0, arg_1.default)(constants_1.helpArgs);
     if (localArgs['--help']) {
         ui.write(constants_1.helpMessages['rename']);

package/dist/cli/run.js

@@ -4,12 +4,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = void 0;
+const arg_1 = __importDefault(require("arg"));
 const Runner_1 = require("./Runner");
 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 run = async (_args, ui, context) => {
     const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
     if (localArgs['--help']) {
         ui.write(constants_1.helpMessages['run']);

package/dist/cli/set.js

@@ -23,7 +23,7 @@ const getVersions = (pkg, ui) => {
                             resolve(resJson);
                         }
                         else {
-                            reject(new TypeError("Expect json array on stdout, but got:\n" + stdout));
+                            reject(new TypeError('Expect json array on stdout, but got:\n' + stdout));
                         }
                     }
                     catch (e) {
@@ -36,7 +36,7 @@ const getVersions = (pkg, ui) => {
                 }
             }
             if (error) {
-                ui.write("Failed to get func-js-bin package versions!");
+                ui.write('Failed to get func-js-bin package versions!');
                 reject(error);
             }
         });

package/dist/cli/verify.js

@@ -4,14 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.verify = void 0;
+const path_1 = __importDefault(require("path"));
 const core_1 = require("@ton/core");
+const arg_1 = __importDefault(require("arg"));
 const compile_1 = require("../compile/compile");
 const Runner_1 = require("./Runner");
-const path_1 = __importDefault(require("path"));
 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: {
@@ -121,7 +121,7 @@ async function lookupCodeHash(hash, ui, retryCount = 5) {
     } while (!done && retryCount > 0);
     return foundAddr;
 }
-const verify = async (args, ui, context) => {
+const verify = async (_args, ui, context) => {
     const localArgs = (0, arg_1.default)({ ...createNetworkProvider_1.argSpec, ...constants_1.helpArgs });
     if (localArgs['--help']) {
         ui.write(constants_1.helpMessages['verify']);
@@ -217,6 +217,27 @@ const verify = async (args, ui, context) => {
             senderAddress: senderAddress.toString(),
         };
     }
+    else if (result.lang === 'tolk') {
+        for (const f of result.snapshot) {
+            fd.append(f.filename, new Blob([f.content]), path_1.default.basename(f.filename));
+        }
+        src = {
+            compiler: 'tolk',
+            compilerSettings: {
+                tolkVersion: result.version,
+            },
+            knownContractAddress: addr,
+            knownContractHash: result.code.hash().toString('base64'),
+            sources: result.snapshot.map((s) => ({
+                includeInCommand: true,
+                isStdLib: false,
+                hasIncludeDirectives: true,
+                isEntrypoint: s === result.snapshot[0],
+                folder: path_1.default.dirname(s.filename),
+            })),
+            senderAddress: senderAddress.toString(),
+        };
+    }
     else {
         // future proofing
         throw new Error('Unsupported language ' + result.lang);

package/dist/compile/compile.js

@@ -23,6 +23,7 @@ async function getCompilablesDirectory() {
     return paths_1.WRAPPERS_DIR;
 }
 function extractCompilableConfig(path) {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
     const mod = require(path);
     if (typeof mod.compile !== 'object') {
         throw new Error(`Object 'compile' is missing`);

package/dist/config/Config.d.ts

@@ -52,4 +52,10 @@ export interface Config {
      * @default false
      */
     recursiveWrappers?: boolean;
+    /**
+     * Manifest url passed to TonConnect provider.
+     *
+     * @default https://raw.githubusercontent.com/ton-org/blueprint/main/tonconnect/manifest.json
+     */
+    manifestUrl?: string;
 }

package/dist/config/CustomNetwork.d.ts

@@ -1,6 +1,6 @@
 export type CustomNetwork = {
     endpoint: string;
-    version?: 'v2' | 'v4' | 'tonapi';
+    version?: 'v2' | 'v4' | 'tonapi' | 'liteclient';
     key?: string;
     type?: 'mainnet' | 'testnet' | 'custom';
 };

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, TolkCompileResult, FuncCompileResult, TactCompileResult, CompileResult } from './compile/compile';
+export { compile, CompileOpts, TolkCompileResult, FuncCompileResult, TactCompileResult, CompileResult, } from './compile/compile';
 export { CompilerConfig, HookParams } from './compile/CompilerConfig';
 export { UIProvider } from './ui/UIProvider';
 export { Config } from './config/Config';
@@ -9,5 +9,5 @@ export { Args, Runner, RunnerContext } from './cli/Runner';
 export { PluginRunner, Plugin } from './config/Plugin';
 export { CustomNetwork } from './config/CustomNetwork';
 export { buildOne, buildAll, buildAllTact } from './build';
-export { SourceSnapshot } from "./compile/SourceSnapshot";
+export { SourceSnapshot } from './compile/SourceSnapshot';
 export { getCompilerConfigForContract } from './compile/compile';

package/dist/network/NetworkProvider.d.ts

@@ -1,8 +1,10 @@
-import { TonClient, TonClient4 } from '@ton/ton';
-import { Address, Cell, Contract, ContractProvider, OpenedContract, Sender } from '@ton/core';
+import { parseFullConfig, TonClient, TonClient4 } from '@ton/ton';
+import { Address, Cell, Contract, ContractProvider, ContractState, OpenedContract, Sender } from '@ton/core';
 import { ContractAdapter } from '@ton-api/ton-adapter';
+import { LiteClient } from 'ton-lite-client';
 import { UIProvider } from '../ui/UIProvider';
-export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter;
+export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter | LiteClient;
+type BlockchainConfig = ReturnType<typeof parseFullConfig>;
 /**
  * Interface representing a network provider for interacting with TON blockchain.
  */
@@ -69,6 +71,35 @@ export interface NetworkProvider {
      * @returns {Promise<void>} A promise that resolves when the contract is deployed or the attempts are exhausted.
      */
     waitForDeploy(address: Address, attempts?: number, sleepDuration?: number): Promise<void>;
+    /**
+     * Retrieves the state of a contract at the specified address.
+     *
+     * @param {Address} address - The address of the contract.
+     *
+     * @example
+     * const address = Address.parse('YOUR_CONTRACT_ADDRESS');
+     * const state = await provider.getContractState(address);
+     * console.log(`Contract balance: ${fromNano(state.balance)} TON`);
+     *
+     * @returns {Promise<ContractState>} A promise that resolves to the contract's state.
+     */
+    getContractState(address: Address): Promise<ContractState>;
+    /**
+     * Fetches the current blockchain configuration.
+     *
+     * This method retrieves the configuration from the masterchain. If no address is provided,
+     * it defaults to the standard config address:
+     * `-1:5555555555555555555555555555555555555555555555555555555555555555`.
+     *
+     * @param {Address} [configAddress] - Optional configuration address.
+     *
+     * @example
+     * const config = await provider.getConfig();
+     * console.log('Global config version:', config.globalVersion.version);
+     *
+     @returns {Promise<BlockchainConfig>} A promise that resolves to the blockchain configuration.
+     */
+    getConfig(configAddress?: Address): Promise<BlockchainConfig>;
     /**
      * @deprecated
      *
@@ -94,3 +125,4 @@ export interface NetworkProvider {
      */
     ui(): UIProvider;
 }
+export {};

package/dist/network/createNetworkProvider.js

@@ -17,21 +17,23 @@ var _SendProviderSender_provider, _WrappedContractProvider_address, _WrappedCont
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.argSpec = void 0;
 exports.createNetworkProvider = createNetworkProvider;
-const utils_1 = require("../utils");
-const DeeplinkProvider_1 = require("./send/DeeplinkProvider");
-const TonConnectProvider_1 = require("./send/TonConnectProvider");
+const path_1 = __importDefault(require("path"));
 const core_1 = require("@ton/core");
 const ton_1 = require("@ton/ton");
 const ton_adapter_1 = require("@ton-api/ton-adapter");
 const client_1 = require("@ton-api/client");
+const crypto_1 = require("@ton/crypto");
+const axios_1 = __importDefault(require("axios"));
+const ton_lite_client_1 = require("ton-lite-client");
+const utils_1 = require("../utils");
+const DeeplinkProvider_1 = require("./send/DeeplinkProvider");
+const TonConnectProvider_1 = require("./send/TonConnectProvider");
 const FSStorage_1 = require("./storage/FSStorage");
-const path_1 = __importDefault(require("path"));
 const paths_1 = require("../paths");
-const crypto_1 = require("@ton/crypto");
 const MnemonicProvider_1 = require("./send/MnemonicProvider");
-const axios_1 = __importDefault(require("axios"));
 const INITIAL_DELAY = 400;
 const MAX_ATTEMPTS = 4;
+const CONFIG_ADDRESS = core_1.Address.parse('-1:5555555555555555555555555555555555555555555555555555555555555555');
 exports.argSpec = {
     '--mainnet': Boolean,
     '--testnet': Boolean,
@@ -140,6 +142,25 @@ class NetworkProviderImpl {
     async isContractDeployed(address) {
         return (await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address).getState()).state.type === 'active';
     }
+    async getConfig(address = CONFIG_ADDRESS) {
+        const state = await this.getContractState(address);
+        if (state.state.type !== 'active' || !state.state.data) {
+            throw new Error('Configuration contract not active');
+        }
+        const paramsDict = core_1.Cell.fromBoc(state.state.data)[0]
+            .beginParse()
+            .loadRef()
+            .beginParse()
+            .loadDictDirect(core_1.Dictionary.Keys.Int(32), core_1.Dictionary.Values.Cell());
+        const params = new Map();
+        for (const [key, value] of paramsDict) {
+            params.set(key, value.beginParse());
+        }
+        return (0, ton_1.parseFullConfig)(params);
+    }
+    async getContractState(address) {
+        return await __classPrivateFieldGet(this, _NetworkProviderImpl_tc, "f").provider(address).getState();
+    }
     async waitForDeploy(address, attempts = 20, sleepDuration = 2000) {
         if (attempts <= 0) {
             throw new Error('Attempt number must be positive');
@@ -216,6 +237,33 @@ async function createMnemonicProvider(client, network, ui) {
         network,
     });
 }
+function intToIP(int) {
+    const part1 = int & 255;
+    const part2 = (int >> 8) & 255;
+    const part3 = (int >> 16) & 255;
+    const part4 = (int >> 24) & 255;
+    return `${(part4 + 256) % 256}.${(part3 + 256) % 256}.${(part2 + 256) % 256}.${(part1 + 256) % 256}`;
+}
+async function buildLiteClient(configEndpoint) {
+    const { data } = await axios_1.default.get(configEndpoint);
+    if (!Array.isArray(data.liteservers)) {
+        throw new Error(`Invalid liteclient configuration on ${configEndpoint}. Use https://ton.org/testnet-global.config.json for testnet or https://ton.org/global.config.json for mainnet.`);
+    }
+    const engines = data.liteservers.map((server) => {
+        if (typeof server?.ip !== 'number' ||
+            typeof server?.port !== 'number' ||
+            typeof server?.id !== 'object' ||
+            typeof server?.id?.key !== 'string') {
+            throw new Error(`Invalid liteclient configuration on ${configEndpoint}`);
+        }
+        return new ton_lite_client_1.LiteSingleEngine({
+            host: `tcp://${intToIP(server.ip)}:${server.port}`,
+            publicKey: Buffer.from(server.id.key, 'base64'),
+        });
+    });
+    const engine = new ton_lite_client_1.LiteRoundRobinEngine(engines);
+    return new ton_lite_client_1.LiteClient({ engine });
+}
 class NetworkProviderBuilder {
     constructor(args, ui, config, allowCustom = true) {
         this.args = args;
@@ -283,7 +331,7 @@ class NetworkProviderBuilder {
             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, network);
+                provider = new TonConnectProvider_1.TonConnectProvider(new FSStorage_1.FSStorage(storagePath), this.ui, network, this.config?.manifestUrl);
                 break;
             case 'mnemonic':
                 provider = await createMnemonicProvider(client, network, this.ui);
@@ -349,6 +397,9 @@ class NetworkProviderBuilder {
                     apiKey: configNetwork.key,
                 }));
             }
+            else if (configNetwork.version === 'liteclient') {
+                tc = await buildLiteClient(configNetwork.endpoint);
+            }
             else {
                 throw new Error('Unknown API version: ' + configNetwork.version);
             }
@@ -397,7 +448,7 @@ class NetworkProviderBuilder {
         try {
             await sendProvider.connect();
         }
-        catch (e) {
+        catch (_) {
             console.error('Unable to connect to wallet.');
             process.exit(1);
         }

package/dist/network/send/DeeplinkProvider.js

@@ -17,8 +17,8 @@ var _DeeplinkProvider_network, _DeeplinkProvider_ui;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeeplinkProvider = void 0;
 const core_1 = require("@ton/core");
-const utils_1 = require("../../utils");
 const qrcode_terminal_1 = __importDefault(require("qrcode-terminal"));
+const utils_1 = require("../../utils");
 class DeeplinkProvider {
     constructor(network, ui) {
         _DeeplinkProvider_network.set(this, void 0);

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

@@ -1,9 +1,10 @@
+import { Buffer } from 'buffer';
 import { Address, Cell, StateInit } from '@ton/core';
 import { SendProvider } from './SendProvider';
 import { UIProvider } from '../../ui/UIProvider';
 import { BlueprintTonClient } from '../NetworkProvider';
 import { Network } from '../Network';
-export type WalletVersion = 'v1r1' | 'v1r2' | 'v1r3' | 'v2r1' | 'v2r2' | 'v3r1' | 'v3r2' | 'v4' | 'v5r1';
+import { WalletVersion } from './wallets';
 type MnemonicProviderParams = {
     version: WalletVersion;
     workchain?: number;

package/dist/network/send/MnemonicProvider.js

@@ -13,20 +13,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _MnemonicProvider_wallet, _MnemonicProvider_secretKey, _MnemonicProvider_client, _MnemonicProvider_ui, _MnemonicProvider_network;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MnemonicProvider = void 0;
-const ton_1 = require("@ton/ton");
 const core_1 = require("@ton/core");
 const crypto_1 = require("@ton/crypto");
-const wallets = {
-    v1r1: ton_1.WalletContractV1R1,
-    v1r2: ton_1.WalletContractV1R2,
-    v1r3: ton_1.WalletContractV1R3,
-    v2r1: ton_1.WalletContractV2R1,
-    v2r2: ton_1.WalletContractV2R2,
-    v3r1: ton_1.WalletContractV3R1,
-    v3r2: ton_1.WalletContractV3R2,
-    v4: ton_1.WalletContractV4,
-    v5r1: ton_1.WalletContractV5R1,
-};
+const wallets_1 = require("./wallets");
 class MnemonicProvider {
     constructor(params) {
         _MnemonicProvider_wallet.set(this, void 0);
@@ -34,8 +23,8 @@ class MnemonicProvider {
         _MnemonicProvider_client.set(this, void 0);
         _MnemonicProvider_ui.set(this, void 0);
         _MnemonicProvider_network.set(this, void 0);
-        if (!(params.version in wallets)) {
-            throw new Error(`Unknown wallet version ${params.version}`);
+        if (!(params.version in wallets_1.wallets)) {
+            throw new Error(`Unknown wallet version ${params.version}, expected one of ${Object.keys(wallets_1.wallets).join(', ')}`);
         }
         __classPrivateFieldSet(this, _MnemonicProvider_client, params.client, "f");
         __classPrivateFieldSet(this, _MnemonicProvider_network, params.network, "f");
@@ -50,7 +39,7 @@ class MnemonicProvider {
     }
     createWallet(params, kp) {
         if (params.version === 'v5r1') {
-            return wallets[params.version].create({
+            return wallets_1.wallets[params.version].create({
                 publicKey: kp.publicKey,
                 walletId: {
                     networkGlobalId: params.network === 'testnet' ? -3 : -239, // networkGlobalId: -3 for Testnet, -239 for Mainnet
@@ -62,14 +51,17 @@ class MnemonicProvider {
                 },
             });
         }
-        return wallets[params.version].create({
+        return wallets_1.wallets[params.version].create({
             workchain: params.workchain ?? 0,
             publicKey: kp.publicKey,
             walletId: params.walletId,
         });
     }
     async connect() {
-        const formattedAddress = this.address().toString({ testOnly: __classPrivateFieldGet(this, _MnemonicProvider_network, "f") === 'testnet', bounceable: false });
+        const formattedAddress = this.address().toString({
+            testOnly: __classPrivateFieldGet(this, _MnemonicProvider_network, "f") === 'testnet',
+            bounceable: false,
+        });
         __classPrivateFieldGet(this, _MnemonicProvider_ui, "f").write(`Connected to wallet at address: ${formattedAddress}\n`);
     }
     async sendTransaction(address, amount, payload, stateInit) {

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

@@ -5,7 +5,7 @@ import { UIProvider } from '../../ui/UIProvider';
 import { Network } from '../Network';
 export declare class TonConnectProvider implements SendProvider {
     #private;
-    constructor(storage: Storage, ui: UIProvider, network: Network);
+    constructor(storage: Storage, ui: UIProvider, network: Network, manifestUrl?: string);
     connect(): Promise<void>;
     address(): Address | undefined;
     private connectWallet;

package/dist/network/send/TonConnectProvider.js

@@ -39,13 +39,13 @@ function isRemote(walletInfo) {
     return 'universalLink' in walletInfo && 'bridgeUrl' in walletInfo;
 }
 class TonConnectProvider {
-    constructor(storage, ui, network) {
+    constructor(storage, ui, network, manifestUrl = 'https://raw.githubusercontent.com/ton-org/blueprint/main/tonconnect/manifest.json') {
         _TonConnectProvider_connector.set(this, void 0);
         _TonConnectProvider_ui.set(this, void 0);
         _TonConnectProvider_network.set(this, void 0);
         __classPrivateFieldSet(this, _TonConnectProvider_connector, new sdk_1.default({
             storage: new TonConnectStorage(storage),
-            manifestUrl: 'https://raw.githubusercontent.com/ton-org/blueprint/main/tonconnect/manifest.json',
+            manifestUrl,
         }), "f");
         __classPrivateFieldSet(this, _TonConnectProvider_ui, ui, "f");
         __classPrivateFieldSet(this, _TonConnectProvider_network, network, "f");

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

@@ -0,0 +1,25 @@
+import { Buffer } from 'buffer';
+import { WalletContractV4 as WalletContractV4R2 } from '@ton/ton/dist/wallets/WalletContractV4';
+import { WalletContractV1R1, WalletContractV1R2, WalletContractV1R3, WalletContractV2R1, WalletContractV2R2, WalletContractV3R1, WalletContractV3R2, WalletContractV5R1 } from '@ton/ton';
+export type WalletVersion = 'v1r1' | 'v1r2' | 'v1r3' | 'v2r1' | 'v2r2' | 'v3r1' | 'v3r2' | 'v4' | 'v4r1' | 'v4r2' | 'v5r1';
+declare class WalletContractV4R1 {
+    static create(args: {
+        workchain: number;
+        publicKey: Buffer;
+        walletId?: number | null;
+    }): WalletContractV4R2;
+}
+export declare const wallets: {
+    v1r1: typeof WalletContractV1R1;
+    v1r2: typeof WalletContractV1R2;
+    v1r3: typeof WalletContractV1R3;
+    v2r1: typeof WalletContractV2R1;
+    v2r2: typeof WalletContractV2R2;
+    v3r1: typeof WalletContractV3R1;
+    v3r2: typeof WalletContractV3R2;
+    v4: typeof WalletContractV4R2;
+    v4r1: typeof WalletContractV4R1;
+    v4r2: typeof WalletContractV4R2;
+    v5r1: typeof WalletContractV5R1;
+};
+export {};

package/dist/network/send/wallets.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wallets = void 0;
+const buffer_1 = require("buffer");
+const WalletContractV4_1 = require("@ton/ton/dist/wallets/WalletContractV4");
+const core_1 = require("@ton/core");
+const ton_1 = require("@ton/ton");
+class WalletContractV4R1 {
+    static create(args) {
+        const wallet = WalletContractV4_1.WalletContractV4.create(args);
+        const { data } = wallet.init;
+        const code = core_1.Cell.fromBoc(buffer_1.Buffer.from('B5EE9C72410215010002F5000114FF00F4A413F4BCF2C80B010201200203020148040504F8F28308D71820D31FD31FD31F02F823BBF263ED44D0D31FD31FD3FFF404D15143BAF2A15151BAF2A205F901541064F910F2A3F80024A4C8CB1F5240CB1F5230CBFF5210F400C9ED54F80F01D30721C0009F6C519320D74A96D307D402FB00E830E021C001E30021C002E30001C0039130E30D03A4C8CB1F12CB1FCBFF1112131403EED001D0D3030171B0915BE021D749C120915BE001D31F218210706C7567BD228210626C6E63BDB022821064737472BDB0925F03E002FA403020FA4401C8CA07CBFFC9D0ED44D0810140D721F404305C810108F40A6FA131B3925F05E004D33FC8258210706C7567BA9131E30D248210626C6E63BAE30004060708020120090A005001FA00F404308210706C7567831EB17080185005CB0527CF165003FA02F40012CB69CB1F5210CB3F0052F8276F228210626C6E63831EB17080185005CB0527CF1624FA0214CB6A13CB1F5230CB3F01FA02F4000092821064737472BA8E3504810108F45930ED44D0810140D720C801CF16F400C9ED54821064737472831EB17080185004CB0558CF1622FA0212CB6ACB1FCB3F9410345F04E2C98040FB000201200B0C0059BD242B6F6A2684080A06B90FA0218470D4080847A4937D29910CE6903E9FF9837812801B7810148987159F31840201580D0E0011B8C97ED44D0D70B1F8003DB29DFB513420405035C87D010C00B23281F2FFF274006040423D029BE84C600201200F100019ADCE76A26840206B90EB85FFC00019AF1DF6A26840106B90EB858FC0006ED207FA00D4D422F90005C8CA0715CBFFC9D077748018C8CB05CB0222CF165005FA0214CB6B12CCCCC971FB00C84014810108F451F2A702006C810108D718C8542025810108F451F2A782106E6F746570748018C8CB05CB025004CF16821005F5E100FA0213CB6A12CB1FC971FB00020072810108D718305202810108F459F2A7F82582106473747270748018C8CB05CB025005CF16821005F5E100FA0214CB6A13CB1F12CB3FC973FB00000AF400C9ED5446A9F34F', 'hex'))[0];
+        wallet.init = { data, code };
+        wallet.address = (0, core_1.contractAddress)(args.workchain, wallet.init);
+        return wallet;
+    }
+}
+exports.wallets = {
+    v1r1: ton_1.WalletContractV1R1,
+    v1r2: ton_1.WalletContractV1R2,
+    v1r3: ton_1.WalletContractV1R3,
+    v2r1: ton_1.WalletContractV2R1,
+    v2r2: ton_1.WalletContractV2R2,
+    v3r1: ton_1.WalletContractV3R1,
+    v3r2: ton_1.WalletContractV3R2,
+    v4: WalletContractV4_1.WalletContractV4, // left for backward compatibility
+    v4r1: WalletContractV4R1,
+    v4r2: WalletContractV4_1.WalletContractV4,
+    v5r1: ton_1.WalletContractV5R1,
+};

package/dist/network/storage/FSStorage.js

@@ -44,7 +44,7 @@ _FSStorage_path = new WeakMap(), _FSStorage_instances = new WeakSet(), _FSStorag
     try {
         return JSON.parse((await promises_1.default.readFile(__classPrivateFieldGet(this, _FSStorage_path, "f"))).toString('utf-8'));
     }
-    catch (e) {
+    catch (_) {
         return {};
     }
 }, _FSStorage_writeObject = async function _FSStorage_writeObject(obj) {

package/dist/templates/tolk/counter/contracts/contract.tolk.template

@@ -1,33 +1,33 @@
 {{snakeName}}.tolk
 // simple counter contract in Tolk language
 
-const OP_INCREASE = 0x7e8764ef;  // arbitrary 32-bit number, equal to OP_INCREASE in wrappers/CounterContract.ts
+// using unions to represent contract messages
 
-// storage variables
-
-// id is required to be able to create different instances of counters
-// since addresses in TON depend on the initial state of the contract
-global ctxID: int;
-global ctxCounter: int;
+// the struct uses a 32-bit opcode prefix for message identification
+struct (0x7e8764ef) IncreaseMessage {
+    queryID: uint64;  // query id, typically included in messages
+    increaseBy: uint32;
+}
 
-// loadData populates storage variables from persistent storage
-fun loadData() {
-    var ds = contract.getData().beginParse();
+// incoming message definition using a union for extensibility
+// this union could be extended like below to support more message types
+// type IncomingMessage = IncreaseMessage | DecreaseMessage | ...;
+type IncomingMessage = IncreaseMessage;
 
-    ctxID = ds.loadUint(32);
-    ctxCounter = ds.loadUint(32);
+// contract storage, auto-serialized to/from cells.
+struct Storage {
+    id: uint32; // required to allow multiple independent counter instances, since contract address depends on initial state
+    counter: uint32;
+}
 
-    ds.assertEnd();
+// load contract data using auto-deserialization
+fun loadData() {
+    return Storage.fromCell(contract.getData());
 }
 
-// saveData stores storage variables as a cell into persistent storage
-fun saveData() {
-    contract.setData(
-        beginCell()
-        .storeUint(ctxID, 32)
-        .storeUint(ctxCounter, 32)
-        .endCell()
-    );
+// save contract data into persistent storage using auto-serialization
+fun saveData(data: Storage) {
+    contract.setData(data.toCell());
 }
 
 // onInternalMessage is the main entrypoint; it's called when a contract receives an internal message from other contracts
@@ -36,36 +36,39 @@ fun onInternalMessage(myBalance: int, msgValue: int, msgFull: cell, msgBody: sli
         return;
     }
 
-    var cs: slice = msgFull.beginParse();
+    var cs = msgFull.beginParse();
     val flags = cs.loadMessageFlags();
     if (isMessageBounced(flags)) { // ignore all bounced messages
         return;
     }
 
-    loadData(); // here we populate the storage variables
-
-    val op = msgBody.loadMessageOp(); // by convention, the first 32 bits of incoming message is the op
-    val queryID = msgBody.loadMessageQueryId(); // also by convention, the next 64 bits contain the "query id", although this is not always the case
-
-    if (op == OP_INCREASE) {
-        val increaseBy = msgBody.loadUint(32);
-        ctxCounter += increaseBy;
-        saveData();
-        return;
+    val msg = IncomingMessage.fromSlice(msgBody);  // 63 error code is thrown if the message opcode is unknown
+
+    match (msg) {
+        IncreaseMessage => {
+            var storage = loadData(); // here we load contract data
+            storage.counter += msg.increaseBy;
+            saveData(storage); // here we updating contract data
+        }
+        /* other messages could be supported via extending this match block
+        DecreaseMessage => {
+            var storage = loadData();
+            storage.counter -= msg.decreaseBy;
+            saveData(storage);
+        }
+        */
     }
-
-    throw 0xffff; // if the message contains an op that is not known to this contract, we throw
 }
 
 // get methods are a means to conveniently read contract data using, for example, HTTP APIs
 // note that unlike in many other smart contract VMs, get methods cannot be called by other contracts
 
 get currentCounter(): int {
-    loadData();
-    return ctxCounter;
+    val storage = loadData();
+    return storage.counter;
 }
 
 get initialId(): int {
-    loadData();
-    return ctxID;
+    val storage = loadData();
+    return storage.id;
 }

package/dist/ui/InquirerUIProvider.d.ts

@@ -1,5 +1,5 @@
-import { UIProvider } from '../ui/UIProvider';
 import { Address } from '@ton/core';
+import { UIProvider } from '../ui/UIProvider';
 export declare class InquirerUIProvider implements UIProvider {
     #private;
     constructor();

package/dist/ui/InquirerUIProvider.js

@@ -46,7 +46,7 @@ class InquirerUIProvider {
             try {
                 return addr === '' && fallback !== undefined ? fallback : core_1.Address.parse(addr);
             }
-            catch (e) {
+            catch (_) {
                 this.write(addr + ' is not valid!\n');
             }
         }

package/dist/utils/selection.utils.js

@@ -52,7 +52,10 @@ const findCompiles = async (directory) => {
     if (!(0, fs_1.existsSync)(dir)) {
         return [];
     }
-    const files = await promises_1.default.readdir(dir, { recursive: (await (0, utils_1.getConfig)())?.recursiveWrappers ?? false, withFileTypes: true });
+    const files = await promises_1.default.readdir(dir, {
+        recursive: (await (0, utils_1.getConfig)())?.recursiveWrappers ?? false,
+        withFileTypes: true,
+    });
     const compilables = files.filter((file) => file.isFile() && file.name.endsWith(compile_1.COMPILE_END));
     return compilables.map((file) => ({
         path: path_1.default.join(file.path, file.name),
@@ -70,7 +73,10 @@ const findContracts = async () => {
 };
 exports.findContracts = findContracts;
 const findScripts = async () => {
-    const dirents = await promises_1.default.readdir(paths_1.SCRIPTS_DIR, { recursive: true, withFileTypes: true });
+    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) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.34.0",
+  "version": "0.36.0-dev.20250609174628.e67475d",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",
@@ -15,29 +15,33 @@
   ],
   "scripts": {
     "build": "rm -rf dist && tsc && cp -r src/templates dist/",
+    "test": "echo \"Error: no test specified\" && exit 0",
     "release": "yarn build && yarn publish --access public",
-    "format": "prettier --write src"
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --max-warnings 0 --fix"
   },
+  "prettier": "@ton/toolchain/prettier",
   "devDependencies": {
     "@tact-lang/compiler": "^1.6.5",
     "@ton-community/func-js": "^0.9.0",
-    "@ton/core": "^0.59.0",
+    "@ton/core": "^0.60.1",
     "@ton/crypto": "^3.3.0",
     "@ton/tolk-js": "^0.12.0",
-    "@ton/ton": "^15.0.0",
+    "@ton/ton": "^15.2.1",
+    "@ton/toolchain": "the-ton-tech/toolchain#v1.4.0",
     "@types/inquirer": "^8.2.6",
     "@types/node": "^20.2.5",
     "@types/qrcode-terminal": "^0.12.0",
-    "prettier": "^3.0.3",
+    "eslint": "^9.28.0",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
     "@tact-lang/compiler": ">=1.6.5",
     "@ton-community/func-js": ">=0.9.0",
-    "@ton/core": ">=0.59.0",
+    "@ton/core": ">=0.60.1",
     "@ton/crypto": ">=3.3.0",
-    "@ton/tolk-js": ">=0.12.0",
-    "@ton/ton": ">=15.0.0"
+    "@ton/tolk-js": ">=0.13.0",
+    "@ton/ton": ">=15.2.1"
   },
   "dependencies": {
     "@ton-api/client": "^0.2.0",
@@ -49,7 +53,8 @@
     "dotenv": "^16.1.4",
     "inquirer": "^8.2.5",
     "qrcode-terminal": "^0.12.0",
+    "ton-lite-client": "^3.1.0",
     "ts-node": "^10.9.1"
   },
-  "packageManager": "yarn@4.3.1"
+  "packageManager": "yarn@4.9.2"
 }