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

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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

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']);

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/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,9 +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';
-import { LiteClient } from "ton-lite-client";
 export type BlueprintTonClient = TonClient4 | TonClient | ContractAdapter | LiteClient;
+type BlockchainConfig = ReturnType<typeof parseFullConfig>;
 /**
  * Interface representing a network provider for interacting with TON blockchain.
  */
@@ -70,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
      *
@@ -95,3 +125,4 @@ export interface NetworkProvider {
      */
     ui(): UIProvider;
 }
+export {};

package/dist/network/createNetworkProvider.js

@@ -17,22 +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 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 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 paths_1 = require("../paths");
+const MnemonicProvider_1 = require("./send/MnemonicProvider");
 const INITIAL_DELAY = 400;
 const MAX_ATTEMPTS = 4;
+const CONFIG_ADDRESS = core_1.Address.parse('-1:5555555555555555555555555555555555555555555555555555555555555555');
 exports.argSpec = {
     '--mainnet': Boolean,
     '--testnet': Boolean,
@@ -141,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');
@@ -428,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,9 @@
+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';
-import { Buffer } from 'buffer';
 import { WalletVersion } from './wallets';
 type MnemonicProviderParams = {
     version: WalletVersion;

package/dist/network/send/MnemonicProvider.js

@@ -58,7 +58,10 @@ class MnemonicProvider {
         });
     }
     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/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/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.35.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,9 +15,12 @@
   ],
   "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",
@@ -25,10 +28,11 @@
     "@ton/crypto": "^3.3.0",
     "@ton/tolk-js": "^0.12.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": {
@@ -52,5 +56,5 @@
     "ton-lite-client": "^3.1.0",
     "ts-node": "^10.9.1"
   },
-  "packageManager": "yarn@4.3.1"
+  "packageManager": "yarn@4.9.2"
 }