@ton/blueprint 0.44.0-dev.20260220152830.3fec080 → 0.44.0

package/README.md

@@ -136,6 +136,7 @@ Start by adding the following environment variables to your `.env` file:
 **Optional variables:**
 * **`WALLET_ID`**: The wallet ID (can be used with versions below `v5r1`).
 * **`SUBWALLET_NUMBER`**: The subwallet number used to build the wallet ID (can be used with `v5r1` wallets).
+* **`WALLET_NETWORK_ID`**: Network ID used to build the wallet ID (v5 wallets). Defaults: `-3` testnet, `-239` mainnet and other networks (tetra, custom).
 
 Once your environment is set up, you can use the mnemonic wallet for deployment with the appropriate configuration.
 

package/dist/cli/constants.js

@@ -108,8 +108,7 @@ ${chalk_1.default.cyan('--custom')} [api-endpoint] - use a custom API
 ${chalk_1.default.cyan('--custom-version')} - API version (v2, v4)
 ${chalk_1.default.cyan('--custom-key')} - API key (v2 only)
 ${chalk_1.default.cyan('--custom-type')} - network type (custom, mainnet, testnet)
-${chalk_1.default.cyan('--custom-domain')} - network domain (for custom l2 domain)
-${chalk_1.default.cyan('--custom-network-id')} - network global ID (for custom network)
+${chalk_1.default.cyan('--custom-global-id')} - network global ID (for custom l2 domain)
 ${chalk_1.default.cyan('--tonconnect')}, ${chalk_1.default.cyan('--deeplink')}, ${chalk_1.default.cyan('--mnemonic')} - deployer options
 ${chalk_1.default.cyan('--tonscan')}, ${chalk_1.default.cyan('--tonviewer')}, ${chalk_1.default.cyan('--toncx')}, ${chalk_1.default.cyan('--dton')} - explorer (default: tonviewer)
 ${chalk_1.default.gray('[...args]')} (array of strings, optional) - Arguments passed directly to the script.
@@ -143,7 +142,7 @@ ${chalk_1.default.bold('SEE ALSO')}
 Verifies a deployed contract on ${chalk_1.default.underline('https://verifier.ton.org')}.
 
 ${chalk_1.default.bold('Flags:')}
-${chalk_1.default.cyan('--mainnet')}, ${chalk_1.default.cyan('--testnet')} - selects network
+${chalk_1.default.cyan('--mainnet')}, ${chalk_1.default.cyan('--testnet')}, ${chalk_1.default.cyan('--tetra')} - selects network
 ${chalk_1.default.cyan('--verifier')} - specifies the verifier ID to use (default: ${chalk_1.default.cyan('verifier.ton.org')})
 ${chalk_1.default.cyan('--list-verifiers')} - lists all available verifiers for the selected network (or both networks if none selected)
 ${chalk_1.default.cyan('--compiler-version')} - specifies the exact compiler version to use (e.g. ${chalk_1.default.cyan('0.4.4-newops.1')}). Note: this does not change the underlying compiler itself.

package/dist/config/Config.d.ts

@@ -30,8 +30,6 @@ export interface Config {
      * };
      */
     network?: 'mainnet' | 'testnet' | 'tetra' | CustomNetwork;
-    domain?: number;
-    networkId?: number;
     /**
      * If true, keeps compilable files (`*.compile.ts`) in a separate directory `compilables`.
      * When false or unset, compilables are stored in `wrappers` directory.

package/dist/config/CustomNetwork.d.ts

@@ -5,4 +5,5 @@ export type CustomNetwork = {
     version?: NetworkVersion;
     key?: string;
     type?: Network;
+    globalId?: number;
 };

package/dist/network/Network.d.ts

@@ -1 +1,2 @@
-export type Network = 'mainnet' | 'testnet' | 'tetra' | 'custom';
+import { AVAILABLE_NETWORKS } from './constants';
+export type Network = (typeof AVAILABLE_NETWORKS)[number];

package/dist/network/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const AVAILABLE_NETWORKS: ["mainnet", "testnet", "tetra", "custom"];
+export declare const MAINNET_NETWORK_GLOBAL_ID = -239;
+export declare const TESTNET_NETWORK_GLOBAL_ID = -3;
+export declare const TETRA_DOMAIN: {
+    readonly type: "l2";
+    readonly globalId: 662387;
+};

package/dist/network/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TETRA_DOMAIN = exports.TESTNET_NETWORK_GLOBAL_ID = exports.MAINNET_NETWORK_GLOBAL_ID = exports.AVAILABLE_NETWORKS = void 0;
+exports.AVAILABLE_NETWORKS = ['mainnet', 'testnet', 'tetra', 'custom'];
+exports.MAINNET_NETWORK_GLOBAL_ID = -239;
+exports.TESTNET_NETWORK_GLOBAL_ID = -3;
+const TETRA_NETWORK_GLOBAL_ID = 662387;
+exports.TETRA_DOMAIN = {
+    type: 'l2',
+    globalId: TETRA_NETWORK_GLOBAL_ID,
+};

package/dist/network/createNetworkProvider.d.ts

@@ -10,8 +10,7 @@ export declare const argSpec: {
     '--custom-type': StringConstructor;
     '--custom-version': StringConstructor;
     '--custom-key': StringConstructor;
-    '--custom-domain': NumberConstructor;
-    '--custom-network-id': NumberConstructor;
+    '--custom-global-id': NumberConstructor;
     '--compiler-version': StringConstructor;
     '--tonconnect': BooleanConstructor;
     '--deeplink': BooleanConstructor;

package/dist/network/createNetworkProvider.js

@@ -19,6 +19,7 @@ const TonConnectProvider_1 = require("./send/TonConnectProvider");
 const FSStorage_1 = require("./storage/FSStorage");
 const paths_1 = require("../paths");
 const MnemonicProvider_1 = require("./send/MnemonicProvider");
+const constants_1 = require("./constants");
 const INITIAL_DELAY = 400;
 const MAX_ATTEMPTS = 4;
 const CONFIG_ADDRESS = core_1.Address.parse('-1:5555555555555555555555555555555555555555555555555555555555555555');
@@ -30,8 +31,7 @@ exports.argSpec = {
     '--custom-type': String,
     '--custom-version': String,
     '--custom-key': String,
-    '--custom-domain': Number,
-    '--custom-network-id': Number,
+    '--custom-global-id': Number,
     '--compiler-version': String,
     '--tonconnect': Boolean,
     '--deeplink': Boolean,
@@ -279,7 +279,7 @@ function getOptionalNumberEnv(envName) {
     }
     return value;
 }
-async function createMnemonicProvider(client, network, ui, domain, networkId) {
+async function createMnemonicProvider(client, network, ui, globalId) {
     const mnemonic = process.env.WALLET_MNEMONIC ?? '';
     const walletVersion = process.env.WALLET_VERSION ?? '';
     if (mnemonic.length === 0 || walletVersion.length === 0) {
@@ -287,6 +287,7 @@ async function createMnemonicProvider(client, network, ui, domain, networkId) {
     }
     const walletId = getOptionalNumberEnv('WALLET_ID');
     const subwalletNumber = getOptionalNumberEnv('SUBWALLET_NUMBER');
+    const walletNetworkId = getOptionalNumberEnv('WALLET_NETWORK_ID');
     const keyPair = await (0, crypto_1.mnemonicToPrivateKey)(mnemonic.split(' '));
     return new MnemonicProvider_1.MnemonicProvider({
         version: walletVersion.toLowerCase(),
@@ -296,8 +297,8 @@ async function createMnemonicProvider(client, network, ui, domain, networkId) {
         walletId,
         subwalletNumber,
         network,
-        domain,
-        networkId,
+        globalId,
+        networkId: walletNetworkId,
     });
 }
 function intToIP(int) {
@@ -347,7 +348,7 @@ class NetworkProviderBuilder {
         if (this.config?.network !== undefined) {
             return typeof this.config.network === 'string' ? this.config.network : 'custom';
         }
-        network = await this.ui.choose('Which network do you want to use?', ['mainnet', 'testnet', 'tetra', 'custom'], (c) => c);
+        network = await this.ui.choose('Which network do you want to use?', constants_1.AVAILABLE_NETWORKS, (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();
@@ -397,9 +398,14 @@ class NetworkProviderBuilder {
                     throw new Error('Tonkeeper cannot work with custom 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, this.config?.domain, this.config?.networkId);
+            case 'mnemonic': {
+                let globalId = undefined;
+                if (typeof this.config?.network === 'object') {
+                    globalId = this.config.network.globalId;
+                }
+                provider = await createMnemonicProvider(client, network, this.ui, globalId);
                 break;
+            }
             default:
                 throw new Error('Unknown deploy option');
         }
@@ -407,7 +413,6 @@ class NetworkProviderBuilder {
     }
     async build() {
         let network = await this.chooseNetwork();
-        const explorer = this.chooseExplorer();
         if (network !== 'custom' &&
             (this.args['--custom-key'] !== undefined ||
                 this.args['--custom-type'] !== undefined ||
@@ -431,19 +436,14 @@ class NetworkProviderBuilder {
                 if (inputType !== undefined) {
                     type = inputType; // checks come later
                 }
+                const globalId = this.args['--custom-global-id'];
                 configNetwork = {
                     endpoint: this.args['--custom'],
                     version,
                     key: this.args['--custom-key'],
+                    globalId,
                     type,
                 };
-                if (this.config && this.args['--custom-domain']) {
-                    const customDomain = this.args['--custom-domain'];
-                    this.config.domain = customDomain;
-                }
-                if (this.config && this.args['--custom-network-id']) {
-                    this.config.networkId = this.args['--custom-network-id'];
-                }
             }
             if (configNetwork === undefined) {
                 throw new Error('Custom network is (somehow) undefined');
@@ -476,7 +476,7 @@ class NetworkProviderBuilder {
             }
             if (configNetwork.type !== undefined) {
                 const ct = configNetwork.type.toLowerCase();
-                if (!['mainnet', 'testnet', 'custom', 'tetra'].includes(ct)) {
+                if (!constants_1.AVAILABLE_NETWORKS.includes(ct)) {
                     throw new Error('Unknown network type: ' + ct);
                 }
                 network = ct;
@@ -534,6 +534,7 @@ class NetworkProviderBuilder {
             this.ui.setActionPrompt('');
         }
         const sender = new SendProviderSender(sendProvider);
+        const explorer = network === 'tetra' ? 'tonviewer' : this.chooseExplorer();
         return new NetworkProviderImpl(tc, sender, network, explorer, this.ui);
     }
 }

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

@@ -14,7 +14,7 @@ type MnemonicProviderParams = {
     client: BlueprintTonClient;
     ui: UIProvider;
     network: Network;
-    domain?: number;
+    globalId?: number;
     networkId?: number;
 };
 export declare class MnemonicProvider implements SendProvider {
@@ -24,6 +24,7 @@ export declare class MnemonicProvider implements SendProvider {
     private readonly ui;
     private readonly network;
     constructor(params: MnemonicProviderParams);
+    private getDomain;
     private createWallet;
     connect(): Promise<void>;
     sendTransaction(address: Address, amount: bigint, payload?: Cell | undefined, stateInit?: StateInit | undefined): Promise<void>;

package/dist/network/send/MnemonicProvider.js

@@ -4,7 +4,8 @@ exports.MnemonicProvider = void 0;
 const core_1 = require("@ton/core");
 const crypto_1 = require("@ton/crypto");
 const wallets_1 = require("./wallets");
-const network_utils_1 = require("../../utils/network.utils");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
 class MnemonicProvider {
     constructor(params) {
         if (!(params.version in wallets_1.wallets)) {
@@ -21,11 +22,19 @@ class MnemonicProvider {
         this.secretKey = kp.secretKey;
         this.ui = params.ui;
     }
+    getDomain(params) {
+        if (params.globalId !== undefined) {
+            return { type: 'l2', globalId: params.globalId };
+        }
+        if (params.network === 'tetra') {
+            return constants_1.TETRA_DOMAIN;
+        }
+        return undefined;
+    }
     createWallet(params, kp) {
-        const networkDomain = params.network === 'tetra' ? network_utils_1.TETRA_DOMAIN : undefined;
-        const domain = params.domain ? { type: 'l2', globalId: params.domain } : networkDomain;
-        const networkGlobalId = params.networkId ?? (0, network_utils_1.getW5NetworkGlobalId)(params.network);
+        const domain = this.getDomain(params);
         if (params.version === 'v5r1') {
+            const networkGlobalId = params.networkId ?? (0, utils_1.getW5NetworkGlobalId)(params.network);
             return wallets_1.wallets[params.version].create({
                 publicKey: kp.publicKey,
                 walletId: {

package/dist/network/utils.d.ts

@@ -0,0 +1,2 @@
+import { Network } from './Network';
+export declare function getW5NetworkGlobalId(network: Network): number;

package/dist/network/utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getW5NetworkGlobalId = getW5NetworkGlobalId;
+const constants_1 = require("./constants");
+function getW5NetworkGlobalId(network) {
+    switch (network) {
+        case 'testnet':
+            return constants_1.TESTNET_NETWORK_GLOBAL_ID;
+        case 'mainnet':
+            return constants_1.MAINNET_NETWORK_GLOBAL_ID;
+        case 'tetra':
+            return constants_1.MAINNET_NETWORK_GLOBAL_ID;
+    }
+    return constants_1.MAINNET_NETWORK_GLOBAL_ID;
+}

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

@@ -22,7 +22,7 @@ export declare const tonDeepLink: (address: Address, amount: bigint, body?: Cell
  * dynamically adds the testnet prefix when needed.
  *
  * @param {string} address - The TON address to view in explorer.
- * @param {string} network - The target network, either 'mainnet' or 'testnet'.
+ * @param {string} network - The target network.
  * @param {string} explorer - The desired explorer. Supported values: 'tonscan', 'tonviewer', 'toncx', 'dton'.
  * @returns {string} A full URL pointing to the address in the selected explorer.
  *

package/dist/utils/ton.utils.js

@@ -25,6 +25,12 @@ const tonDeepLink = (address, amount, body, stateInit, testOnly) => `ton://trans
     bounceable: true,
 })}?amount=${amount.toString()}${body ? '&bin=' + body.toBoc().toString('base64url') : ''}${stateInit ? '&init=' + stateInit.toBoc().toString('base64url') : ''}`;
 exports.tonDeepLink = tonDeepLink;
+function getNetworkPrefix(network) {
+    if (network === 'testnet' || network === 'tetra') {
+        return `${network}.`;
+    }
+    return '';
+}
 /**
  * Generates a link to view a TON address in a selected blockchain explorer.
  *
@@ -32,7 +38,7 @@ exports.tonDeepLink = tonDeepLink;
  * dynamically adds the testnet prefix when needed.
  *
  * @param {string} address - The TON address to view in explorer.
- * @param {string} network - The target network, either 'mainnet' or 'testnet'.
+ * @param {string} network - The target network.
  * @param {string} explorer - The desired explorer. Supported values: 'tonscan', 'tonviewer', 'toncx', 'dton'.
  * @returns {string} A full URL pointing to the address in the selected explorer.
  *
@@ -41,7 +47,7 @@ exports.tonDeepLink = tonDeepLink;
  * // "https://testnet.tonscan.org/address/EQC..."
  */
 function getExplorerLink(address, network, explorer) {
-    const networkPrefix = network === 'testnet' ? 'testnet.' : '';
+    const networkPrefix = getNetworkPrefix(network);
     switch (explorer) {
         case 'tonscan':
             return `https://${networkPrefix}tonscan.org/address/${address}`;

package/package.json

@@ -1,71 +1,71 @@
 {
-  "name": "@ton/blueprint",
-  "version": "0.44.0-dev.20260220152830.3fec080",
-  "description": "Framework for development of TON smart contracts",
-  "main": "dist/index.js",
-  "bin": "./dist/cli/cli.js",
-  "author": "TonTech",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ton-org/blueprint.git"
-  },
-  "files": [
-    "dist/**/*"
-  ],
-  "scripts": {
-    "build": "rm -rf dist && tsc && cp -r src/templates dist/",
-    "test": "jest src",
-    "release": "yarn build && yarn publish --access public",
-    "lint": "eslint . --max-warnings 0",
-    "lint:fix": "eslint . --max-warnings 0 --fix"
-  },
-  "prettier": "@ton/toolchain/prettier",
-  "devDependencies": {
-    "@tact-lang/compiler": "^1.6.13",
-    "@ton-community/func-js": "^0.10.0",
-    "@ton/core": "^0.63.1",
-    "@ton/crypto": "^3.3.0",
-    "@ton/sandbox": "^0.40.0",
-    "@ton/tolk-js": "^1.0.0",
-    "@ton/ton": "^16.2.2",
-    "@ton/toolchain": "the-ton-tech/toolchain#v1.6.0",
-    "@types/inquirer": "^8.2.6",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^20.2.5",
-    "@types/qrcode-terminal": "^0.12.0",
-    "eslint": "^9.28.0",
-    "globals": "^16.4.0",
-    "jest": "^30.0.5",
-    "ts-jest": "^29.4.1",
-    "typescript": "^5.8.3"
-  },
-  "peerDependencies": {
-    "@tact-lang/compiler": ">=1.6.5",
-    "@ton-community/func-js": ">=0.10.0",
-    "@ton/core": ">=0.63.1",
-    "@ton/crypto": ">=3.3.0",
-    "@ton/sandbox": ">=0.40.0",
-    "@ton/tolk-js": ">=0.13.0",
-    "@ton/ton": ">=16.2.2"
-  },
-  "peerDependenciesMeta": {
-    "@ton/sandbox": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@ton-api/client": "^0.2.0",
-    "@ton-api/ton-adapter": "^0.2.0",
-    "@tonconnect/sdk": "^2.2.0",
-    "arg": "^5.0.2",
-    "axios": "^1.7.7",
-    "chalk": "^4.1.0",
-    "dotenv": "^16.1.4",
-    "inquirer": "^8.2.5",
-    "qrcode-terminal": "^0.12.0",
-    "ton-lite-client": "^3.1.1",
-    "ts-node": "^10.9.1"
-  },
-  "packageManager": "yarn@4.9.2"
+    "name": "@ton/blueprint",
+    "version": "0.44.0",
+    "description": "Framework for development of TON smart contracts",
+    "main": "dist/index.js",
+    "bin": "./dist/cli/cli.js",
+    "author": "TonTech",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ton-org/blueprint.git"
+    },
+    "files": [
+        "dist/**/*"
+    ],
+    "scripts": {
+        "build": "rm -rf dist && tsc && cp -r src/templates dist/",
+        "test": "jest src",
+        "release": "yarn build && yarn publish --access public",
+        "lint": "eslint . --max-warnings 0",
+        "lint:fix": "eslint . --max-warnings 0 --fix"
+    },
+    "prettier": "@ton/toolchain/prettier",
+    "devDependencies": {
+        "@tact-lang/compiler": "^1.6.13",
+        "@ton-community/func-js": "^0.10.0",
+        "@ton/core": "^0.63.1",
+        "@ton/crypto": "^3.3.0",
+        "@ton/sandbox": "^0.40.0",
+        "@ton/tolk-js": "^1.0.0",
+        "@ton/ton": "^16.2.2",
+        "@ton/toolchain": "the-ton-tech/toolchain#v1.6.0",
+        "@types/inquirer": "^8.2.6",
+        "@types/jest": "^30.0.0",
+        "@types/node": "^20.2.5",
+        "@types/qrcode-terminal": "^0.12.0",
+        "eslint": "^9.28.0",
+        "globals": "^16.4.0",
+        "jest": "^30.0.5",
+        "ts-jest": "^29.4.1",
+        "typescript": "^5.8.3"
+    },
+    "peerDependencies": {
+        "@tact-lang/compiler": ">=1.6.5",
+        "@ton-community/func-js": ">=0.10.0",
+        "@ton/core": ">=0.63.1",
+        "@ton/crypto": ">=3.3.0",
+        "@ton/sandbox": ">=0.40.0",
+        "@ton/tolk-js": ">=0.13.0",
+        "@ton/ton": ">=16.2.2"
+    },
+    "peerDependenciesMeta": {
+        "@ton/sandbox": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "@ton-api/client": "^0.2.0",
+        "@ton-api/ton-adapter": "^0.2.0",
+        "@tonconnect/sdk": "^2.2.0",
+        "arg": "^5.0.2",
+        "axios": "^1.7.7",
+        "chalk": "^4.1.0",
+        "dotenv": "^16.1.4",
+        "inquirer": "^8.2.5",
+        "qrcode-terminal": "^0.12.0",
+        "ton-lite-client": "^3.1.1",
+        "ts-node": "^10.9.1"
+    },
+    "packageManager": "yarn@4.9.2"
 }

package/dist/utils/network.utils.d.ts

@@ -1,6 +0,0 @@
-import { Network } from '../network/Network';
-export declare const TETRA_DOMAIN: {
-    readonly type: "l2";
-    readonly globalId: 662387;
-};
-export declare function getW5NetworkGlobalId(network: Network): number;

package/dist/utils/network.utils.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TETRA_DOMAIN = void 0;
-exports.getW5NetworkGlobalId = getW5NetworkGlobalId;
-const MAINNET_NETWORK_GLOBAL_ID = -239;
-const TESTNET_NETWORK_GLOBAL_ID = -3;
-const TETRA_NETWORK_GLOBAL_ID = 662387;
-exports.TETRA_DOMAIN = {
-    type: 'l2',
-    globalId: TETRA_NETWORK_GLOBAL_ID,
-};
-function getW5NetworkGlobalId(network) {
-    switch (network) {
-        case 'testnet':
-            return TESTNET_NETWORK_GLOBAL_ID;
-        case 'mainnet':
-            return MAINNET_NETWORK_GLOBAL_ID;
-        case 'tetra':
-            return MAINNET_NETWORK_GLOBAL_ID;
-    }
-    return TESTNET_NETWORK_GLOBAL_ID;
-}