@hiero-ledger/sdk 2.70.0

package/lib/client/NodeClient.cjs

@@ -0,0 +1,316 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.Network = void 0;
+var _fs = _interopRequireDefault(require("fs"));
+var _util = _interopRequireDefault(require("util"));
+var _Client = _interopRequireDefault(require("./Client.cjs"));
+var _NodeChannel = _interopRequireDefault(require("../channel/NodeChannel.cjs"));
+var _NodeMirrorChannel = _interopRequireDefault(require("../channel/NodeMirrorChannel.cjs"));
+var _LedgerId = _interopRequireDefault(require("../LedgerId.cjs"));
+var _AccountId = _interopRequireDefault(require("../account/AccountId.cjs"));
+var _NodeAddressBook = _interopRequireDefault(require("../address_book/NodeAddressBook.cjs"));
+var mainnet = _interopRequireWildcard(require("./addressbooks/mainnet.cjs"));
+var testnet = _interopRequireWildcard(require("./addressbooks/testnet.cjs"));
+var previewnet = _interopRequireWildcard(require("./addressbooks/previewnet.cjs"));
+var hex = _interopRequireWildcard(require("../encoding/hex.cjs"));
+var _ClientConstants = require("../constants/ClientConstants.cjs");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+const readFileAsync = _util.default.promisify(_fs.default.readFile);
+
+/**
+ * @typedef {import("./Client.js").ClientConfiguration} ClientConfiguration
+ */
+
+const Network = exports.Network = {
+  LOCAL_NODE: {
+    "127.0.0.1:50211": new _AccountId.default(3)
+  }
+};
+
+/**
+ * @augments {Client<NodeChannel, NodeMirrorChannel>}
+ * Client for interacting with the Hedera network using Node.js.
+ * Extends the base Client class with Node.js specific implementations.
+ */
+class NodeClient extends _Client.default {
+  /**
+   * @param {ClientConfiguration} [props]
+   */
+  constructor(props) {
+    super(props);
+
+    /** @private */
+    this._maxExecutionTime = 10000;
+    if (props != null) {
+      if (typeof props.network === "string") {
+        this._setNetworkFromName(props.network);
+      } else if (props.network != null) {
+        _Client.default._validateNetworkConsistency(props.network);
+        const {
+          shard,
+          realm
+        } = _Client.default._extractShardRealm(props.network);
+
+        // Shard and realm are inferred from the network, so we need to set them here
+        // to ensure that the client is properly configured.
+        this._shard = shard;
+        this._realm = realm;
+        this.setNetwork(props.network);
+      }
+      if (typeof props.mirrorNetwork === "string") {
+        switch (props.mirrorNetwork) {
+          case "mainnet":
+            this.setMirrorNetwork(_ClientConstants.MirrorNetwork.MAINNET);
+            break;
+          case "testnet":
+            this.setMirrorNetwork(_ClientConstants.MirrorNetwork.TESTNET);
+            break;
+          case "previewnet":
+            this.setMirrorNetwork(_ClientConstants.MirrorNetwork.PREVIEWNET);
+            break;
+          default:
+            this.setMirrorNetwork([props.mirrorNetwork]);
+            break;
+        }
+      } else if (props.mirrorNetwork != null) {
+        this.setMirrorNetwork(props.mirrorNetwork);
+      }
+    }
+  }
+
+  /**
+   * @param {string | ClientConfiguration} data
+   * @returns {NodeClient}
+   */
+  static fromConfig(data) {
+    return new NodeClient(typeof data === "string" ? (/** @type {ClientConfiguration | undefined} */
+    JSON.parse(data)) : data);
+  }
+
+  /**
+   * @param {string} filename
+   * @returns {Promise<NodeClient>}
+   */
+  static async fromConfigFile(filename) {
+    return NodeClient.fromConfig(await readFileAsync(filename, "utf8"));
+  }
+
+  /**
+   * Construct a client for a specific network.
+   *
+   * It is the responsibility of the caller to ensure that all nodes in the map are part of the
+   * same Hedera network. Failure to do so will result in undefined behavior.
+   *
+   * The client will load balance all requests to Hedera using a simple round-robin scheme to
+   * chose nodes to send transactions to. For one transaction, at most 1/3 of the nodes will be
+   * tried.
+   *
+   * @param {{[key: string]: (string | AccountId)}} network
+   * @param {ClientConfiguration} [props]
+   * @returns {NodeClient}
+   */
+  static forNetwork(network, props) {
+    return new NodeClient({
+      network,
+      ...props
+    });
+  }
+
+  /**
+   * @param {string} network
+   * @param {object} [props]
+   * @param {boolean} [props.scheduleNetworkUpdate]
+   * @returns {NodeClient}
+   */
+  static forName(network, props = {}) {
+    return new NodeClient({
+      network,
+      ...props
+    });
+  }
+
+  /**
+   * Construct a Hedera client pre-configured for Mainnet access.
+   *
+   * @param {object} [props]
+   * @param {boolean} [props.scheduleNetworkUpdate]
+   * @returns {NodeClient}
+   */
+  static forMainnet(props = {}) {
+    return new NodeClient({
+      network: "mainnet",
+      ...props
+    });
+  }
+
+  /**
+   * Construct a Hedera client pre-configured for Testnet access.
+   *
+   * @param {object} [props]
+   * @param {boolean} [props.scheduleNetworkUpdate]
+   * @returns {NodeClient}
+   */
+  static forTestnet(props = {}) {
+    return new NodeClient({
+      network: "testnet",
+      ...props
+    });
+  }
+
+  /**
+   * @param {string[] | string} mirrorNetwork
+   * @param {number} [shard]
+   * @param {number} [realm]
+   * @returns {Promise<NodeClient>}
+   */
+  static async forMirrorNetwork(mirrorNetwork, shard, realm) {
+    const INITIAL_UPDATE_PERIOD = 10_000;
+    const client = new NodeClient({
+      mirrorNetwork,
+      shard,
+      realm
+    }).setNetworkUpdatePeriod(INITIAL_UPDATE_PERIOD);
+    await client.updateNetwork();
+    return client;
+  }
+
+  /**
+   * Construct a Hedera client pre-configured for Previewnet access.
+   *
+   * @param {object} [props]
+   * @param {boolean} [props.scheduleNetworkUpdate]
+   * @returns {NodeClient}
+   */
+  static forPreviewnet(props = {}) {
+    return new NodeClient({
+      network: "previewnet",
+      ...props
+    });
+  }
+
+  /**
+   * Construct a Hedera client pre-configured for local-node access.
+   *
+   * @param {object} [props]
+   * @param {boolean} [props.scheduleNetworkUpdate]
+   * @returns {NodeClient}
+   */
+  static forLocalNode(props = {
+    scheduleNetworkUpdate: false
+  }) {
+    return new NodeClient({
+      network: "local-node",
+      ...props
+    });
+  }
+
+  /**
+   * @param {{[key: string]: (string | AccountId)} | string} network
+   * @returns {void}
+   */
+  setNetwork(network) {
+    if (typeof network === "string") {
+      this._setNetworkFromName(network);
+    } else {
+      this._network.setNetwork(network);
+    }
+  }
+
+  /**
+   * Available only for NodeClient
+   *
+   * @param {number} maxExecutionTime
+   * @returns {this}
+   */
+  setMaxExecutionTime(maxExecutionTime) {
+    this._maxExecutionTime = maxExecutionTime;
+    return this;
+  }
+
+  /**
+   * @private
+   * @param {string} name
+   * @returns {this}
+   */
+  _setNetworkFromName(name) {
+    switch (name) {
+      case "mainnet":
+        this.setNetworkFromAddressBook(_NodeAddressBook.default.fromBytes(hex.decode(mainnet.addressBook)));
+        this.setMirrorNetwork(_ClientConstants.MirrorNetwork.MAINNET);
+        this.setLedgerId(_LedgerId.default.MAINNET);
+        break;
+      case "testnet":
+        this.setNetworkFromAddressBook(_NodeAddressBook.default.fromBytes(hex.decode(testnet.addressBook)));
+        this.setMirrorNetwork(_ClientConstants.MirrorNetwork.TESTNET);
+        this.setLedgerId(_LedgerId.default.TESTNET);
+        break;
+      case "previewnet":
+        this.setNetworkFromAddressBook(_NodeAddressBook.default.fromBytes(hex.decode(previewnet.addressBook)));
+        this.setMirrorNetwork(_ClientConstants.MirrorNetwork.PREVIEWNET);
+        this.setLedgerId(_LedgerId.default.PREVIEWNET);
+        break;
+      case "local-node":
+        this.setNetwork(Network.LOCAL_NODE);
+        this.setMirrorNetwork(_ClientConstants.MirrorNetwork.LOCAL_NODE);
+        this.setLedgerId(_LedgerId.default.LOCAL_NODE);
+        break;
+      default:
+        throw new Error(
+        // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+        `unknown network: ${name}`);
+    }
+    return this;
+  }
+
+  /**
+   * @param {string[] | string} mirrorNetwork
+   * @returns {this}
+   */
+  setMirrorNetwork(mirrorNetwork) {
+    if (typeof mirrorNetwork === "string") {
+      switch (mirrorNetwork) {
+        case "local-node":
+          this._mirrorNetwork.setNetwork(_ClientConstants.MirrorNetwork.LOCAL_NODE);
+          break;
+        case "previewnet":
+          this._mirrorNetwork.setNetwork(_ClientConstants.MirrorNetwork.PREVIEWNET);
+          break;
+        case "testnet":
+          this._mirrorNetwork.setNetwork(_ClientConstants.MirrorNetwork.TESTNET);
+          break;
+        case "mainnet":
+          this._mirrorNetwork.setNetwork(_ClientConstants.MirrorNetwork.MAINNET);
+          break;
+        default:
+          this._mirrorNetwork.setNetwork([mirrorNetwork]);
+      }
+    } else {
+      this._mirrorNetwork.setNetwork(mirrorNetwork);
+    }
+    return this;
+  }
+
+  /**
+   * @override
+   * @returns {(address: string, cert?: string) => NodeChannel}
+   */
+  _createNetworkChannel() {
+    return address => new _NodeChannel.default(address, this._maxExecutionTime);
+  }
+
+  /**
+   * @override
+   * @returns {(address: string) => NodeMirrorChannel}
+   */
+  _createMirrorNetworkChannel() {
+    return address => new _NodeMirrorChannel.default(address);
+  }
+}
+exports.default = NodeClient;

package/lib/client/NodeClient.d.ts

@@ -0,0 +1,129 @@
+export namespace Network {
+    let LOCAL_NODE: {
+        "127.0.0.1:50211": AccountId;
+    };
+}
+/**
+ * @augments {Client<NodeChannel, NodeMirrorChannel>}
+ * Client for interacting with the Hedera network using Node.js.
+ * Extends the base Client class with Node.js specific implementations.
+ */
+export default class NodeClient extends Client<NodeChannel, NodeMirrorChannel> {
+    /**
+     * @param {string | ClientConfiguration} data
+     * @returns {NodeClient}
+     */
+    static fromConfig(data: string | ClientConfiguration): NodeClient;
+    /**
+     * @param {string} filename
+     * @returns {Promise<NodeClient>}
+     */
+    static fromConfigFile(filename: string): Promise<NodeClient>;
+    /**
+     * Construct a client for a specific network.
+     *
+     * It is the responsibility of the caller to ensure that all nodes in the map are part of the
+     * same Hedera network. Failure to do so will result in undefined behavior.
+     *
+     * The client will load balance all requests to Hedera using a simple round-robin scheme to
+     * chose nodes to send transactions to. For one transaction, at most 1/3 of the nodes will be
+     * tried.
+     *
+     * @param {{[key: string]: (string | AccountId)}} network
+     * @param {ClientConfiguration} [props]
+     * @returns {NodeClient}
+     */
+    static forNetwork(network: {
+        [key: string]: (string | AccountId);
+    }, props?: ClientConfiguration): NodeClient;
+    /**
+     * @param {string} network
+     * @param {object} [props]
+     * @param {boolean} [props.scheduleNetworkUpdate]
+     * @returns {NodeClient}
+     */
+    static forName(network: string, props?: {
+        scheduleNetworkUpdate?: boolean | undefined;
+    }): NodeClient;
+    /**
+     * Construct a Hedera client pre-configured for Mainnet access.
+     *
+     * @param {object} [props]
+     * @param {boolean} [props.scheduleNetworkUpdate]
+     * @returns {NodeClient}
+     */
+    static forMainnet(props?: {
+        scheduleNetworkUpdate?: boolean | undefined;
+    }): NodeClient;
+    /**
+     * Construct a Hedera client pre-configured for Testnet access.
+     *
+     * @param {object} [props]
+     * @param {boolean} [props.scheduleNetworkUpdate]
+     * @returns {NodeClient}
+     */
+    static forTestnet(props?: {
+        scheduleNetworkUpdate?: boolean | undefined;
+    }): NodeClient;
+    /**
+     * @param {string[] | string} mirrorNetwork
+     * @param {number} [shard]
+     * @param {number} [realm]
+     * @returns {Promise<NodeClient>}
+     */
+    static forMirrorNetwork(mirrorNetwork: string[] | string, shard?: number, realm?: number): Promise<NodeClient>;
+    /**
+     * Construct a Hedera client pre-configured for Previewnet access.
+     *
+     * @param {object} [props]
+     * @param {boolean} [props.scheduleNetworkUpdate]
+     * @returns {NodeClient}
+     */
+    static forPreviewnet(props?: {
+        scheduleNetworkUpdate?: boolean | undefined;
+    }): NodeClient;
+    /**
+     * Construct a Hedera client pre-configured for local-node access.
+     *
+     * @param {object} [props]
+     * @param {boolean} [props.scheduleNetworkUpdate]
+     * @returns {NodeClient}
+     */
+    static forLocalNode(props?: {
+        scheduleNetworkUpdate?: boolean | undefined;
+    }): NodeClient;
+    /**
+     * @param {ClientConfiguration} [props]
+     */
+    constructor(props?: ClientConfiguration);
+    /** @private */
+    private _maxExecutionTime;
+    /**
+     * Available only for NodeClient
+     *
+     * @param {number} maxExecutionTime
+     * @returns {this}
+     */
+    setMaxExecutionTime(maxExecutionTime: number): this;
+    /**
+     * @private
+     * @param {string} name
+     * @returns {this}
+     */
+    private _setNetworkFromName;
+    /**
+     * @param {string[] | string} mirrorNetwork
+     * @returns {this}
+     */
+    setMirrorNetwork(mirrorNetwork: string[] | string): this;
+    /**
+     * @override
+     * @returns {(address: string, cert?: string) => NodeChannel}
+     */
+    override _createNetworkChannel(): (address: string, cert?: string) => NodeChannel;
+}
+export type ClientConfiguration = import("./Client.js").ClientConfiguration;
+import AccountId from "../account/AccountId.js";
+import NodeChannel from "../channel/NodeChannel.js";
+import NodeMirrorChannel from "../channel/NodeMirrorChannel.js";
+import Client from "./Client.js";

package/lib/client/NodeClient.js

@@ -0,0 +1,2 @@
+import e from"fs";import r from"util";import t from"./Client.js";import o from"../channel/NodeChannel.js";import s from"../channel/NodeMirrorChannel.js";import i from"../LedgerId.js";import n from"../account/AccountId.js";import a from"../address_book/NodeAddressBook.js";import{addressBook as w}from"./addressbooks/mainnet.js";import{addressBook as k}from"./addressbooks/testnet.js";import{addressBook as N}from"./addressbooks/previewnet.js";import{decode as m}from"../encoding/hex.js";import{MirrorNetwork as d}from"../constants/ClientConstants.js";const c=r.promisify(e.readFile),h={LOCAL_NODE:{"127.0.0.1:50211":new n(3)}};class f extends t{constructor(e){if(super(e),this._maxExecutionTime=1e4,null!=e){if("string"==typeof e.network)this._setNetworkFromName(e.network);else if(null!=e.network){t._validateNetworkConsistency(e.network);const{shard:r,realm:o}=t._extractShardRealm(e.network);this._shard=r,this._realm=o,this.setNetwork(e.network)}if("string"==typeof e.mirrorNetwork)switch(e.mirrorNetwork){case"mainnet":this.setMirrorNetwork(d.MAINNET);break;case"testnet":this.setMirrorNetwork(d.TESTNET);break;case"previewnet":this.setMirrorNetwork(d.PREVIEWNET);break;default:this.setMirrorNetwork([e.mirrorNetwork])}else null!=e.mirrorNetwork&&this.setMirrorNetwork(e.mirrorNetwork)}}static fromConfig(e){return new f("string"==typeof e?JSON.parse(e):e)}static async fromConfigFile(e){return f.fromConfig(await c(e,"utf8"))}static forNetwork(e,r){return new f({network:e,...r})}static forName(e,r={}){return new f({network:e,...r})}static forMainnet(e={}){return new f({network:"mainnet",...e})}static forTestnet(e={}){return new f({network:"testnet",...e})}static async forMirrorNetwork(e,r,t){const o=new f({mirrorNetwork:e,shard:r,realm:t}).setNetworkUpdatePeriod(1e4);return await o.updateNetwork(),o}static forPreviewnet(e={}){return new f({network:"previewnet",...e})}static forLocalNode(e={scheduleNetworkUpdate:!1}){return new f({network:"local-node",...e})}setNetwork(e){"string"==typeof e?this._setNetworkFromName(e):this._network.setNetwork(e)}setMaxExecutionTime(e){return this._maxExecutionTime=e,this}_setNetworkFromName(e){switch(e){case"mainnet":this.setNetworkFromAddressBook(a.fromBytes(m(w))),this.setMirrorNetwork(d.MAINNET),this.setLedgerId(i.MAINNET);break;case"testnet":this.setNetworkFromAddressBook(a.fromBytes(m(k))),this.setMirrorNetwork(d.TESTNET),this.setLedgerId(i.TESTNET);break;case"previewnet":this.setNetworkFromAddressBook(a.fromBytes(m(N))),this.setMirrorNetwork(d.PREVIEWNET),this.setLedgerId(i.PREVIEWNET);break;case"local-node":this.setNetwork(h.LOCAL_NODE),this.setMirrorNetwork(d.LOCAL_NODE),this.setLedgerId(i.LOCAL_NODE);break;default:throw new Error(`unknown network: ${e}`)}return this}setMirrorNetwork(e){if("string"==typeof e)switch(e){case"local-node":this._mirrorNetwork.setNetwork(d.LOCAL_NODE);break;case"previewnet":this._mirrorNetwork.setNetwork(d.PREVIEWNET);break;case"testnet":this._mirrorNetwork.setNetwork(d.TESTNET);break;case"mainnet":this._mirrorNetwork.setNetwork(d.MAINNET);break;default:this._mirrorNetwork.setNetwork([e])}else this._mirrorNetwork.setNetwork(e);return this}_createNetworkChannel(){return e=>new o(e,this._maxExecutionTime)}_createMirrorNetworkChannel(){return e=>new s(e)}}export{h as Network,f as default};
+//# sourceMappingURL=NodeClient.js.map

package/lib/client/NodeClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeClient.js","sources":["../../src/client/NodeClient.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport fs from \"fs\";\nimport util from \"util\";\nimport Client from \"./Client.js\";\nimport NodeChannel from \"../channel/NodeChannel.js\";\nimport NodeMirrorChannel from \"../channel/NodeMirrorChannel.js\";\nimport LedgerId from \"../LedgerId.js\";\nimport AccountId from \"../account/AccountId.js\";\nimport NodeAddressBook from \"../address_book/NodeAddressBook.js\";\nimport * as mainnet from \"./addressbooks/mainnet.js\";\nimport * as testnet from \"./addressbooks/testnet.js\";\nimport * as previewnet from \"./addressbooks/previewnet.js\";\nimport * as hex from \"../encoding/hex.js\";\nimport { MirrorNetwork } from \"../constants/ClientConstants.js\";\n\nconst readFileAsync = util.promisify(fs.readFile);\n\n/**\n * @typedef {import(\"./Client.js\").ClientConfiguration} ClientConfiguration\n */\n\nexport const Network = {\n    LOCAL_NODE: {\n        \"127.0.0.1:50211\": new AccountId(3),\n    },\n};\n\n/**\n * @augments {Client<NodeChannel, NodeMirrorChannel>}\n * Client for interacting with the Hedera network using Node.js.\n * Extends the base Client class with Node.js specific implementations.\n */\nexport default class NodeClient extends Client {\n    /**\n     * @param {ClientConfiguration} [props]\n     */\n    constructor(props) {\n        super(props);\n\n        /** @private */\n        this._maxExecutionTime = 10000;\n\n        if (props != null) {\n            if (typeof props.network === \"string\") {\n                this._setNetworkFromName(props.network);\n            } else if (props.network != null) {\n                Client._validateNetworkConsistency(props.network);\n\n                const { shard, realm } = Client._extractShardRealm(\n                    props.network,\n                );\n\n                // Shard and realm are inferred from the network, so we need to set them here\n                // to ensure that the client is properly configured.\n                this._shard = shard;\n                this._realm = realm;\n\n                this.setNetwork(props.network);\n            }\n\n            if (typeof props.mirrorNetwork === \"string\") {\n                switch (props.mirrorNetwork) {\n                    case \"mainnet\":\n                        this.setMirrorNetwork(MirrorNetwork.MAINNET);\n                        break;\n\n                    case \"testnet\":\n                        this.setMirrorNetwork(MirrorNetwork.TESTNET);\n                        break;\n\n                    case \"previewnet\":\n                        this.setMirrorNetwork(MirrorNetwork.PREVIEWNET);\n                        break;\n\n                    default:\n                        this.setMirrorNetwork([props.mirrorNetwork]);\n                        break;\n                }\n            } else if (props.mirrorNetwork != null) {\n                this.setMirrorNetwork(props.mirrorNetwork);\n            }\n        }\n    }\n\n    /**\n     * @param {string | ClientConfiguration} data\n     * @returns {NodeClient}\n     */\n    static fromConfig(data) {\n        return new NodeClient(\n            typeof data === \"string\"\n                ? /** @type {ClientConfiguration | undefined} */ (\n                      JSON.parse(data)\n                  )\n                : data,\n        );\n    }\n\n    /**\n     * @param {string} filename\n     * @returns {Promise<NodeClient>}\n     */\n    static async fromConfigFile(filename) {\n        return NodeClient.fromConfig(await readFileAsync(filename, \"utf8\"));\n    }\n\n    /**\n     * Construct a client for a specific network.\n     *\n     * It is the responsibility of the caller to ensure that all nodes in the map are part of the\n     * same Hedera network. Failure to do so will result in undefined behavior.\n     *\n     * The client will load balance all requests to Hedera using a simple round-robin scheme to\n     * chose nodes to send transactions to. For one transaction, at most 1/3 of the nodes will be\n     * tried.\n     *\n     * @param {{[key: string]: (string | AccountId)}} network\n     * @param {ClientConfiguration} [props]\n     * @returns {NodeClient}\n     */\n    static forNetwork(network, props) {\n        return new NodeClient({\n            network,\n            ...props,\n        });\n    }\n\n    /**\n     * @param {string} network\n     * @param {object} [props]\n     * @param {boolean} [props.scheduleNetworkUpdate]\n     * @returns {NodeClient}\n     */\n    static forName(network, props = {}) {\n        return new NodeClient({ network, ...props });\n    }\n\n    /**\n     * Construct a Hedera client pre-configured for Mainnet access.\n     *\n     * @param {object} [props]\n     * @param {boolean} [props.scheduleNetworkUpdate]\n     * @returns {NodeClient}\n     */\n    static forMainnet(props = {}) {\n        return new NodeClient({ network: \"mainnet\", ...props });\n    }\n\n    /**\n     * Construct a Hedera client pre-configured for Testnet access.\n     *\n     * @param {object} [props]\n     * @param {boolean} [props.scheduleNetworkUpdate]\n     * @returns {NodeClient}\n     */\n    static forTestnet(props = {}) {\n        return new NodeClient({ network: \"testnet\", ...props });\n    }\n\n    /**\n     * @param {string[] | string} mirrorNetwork\n     * @param {number} [shard]\n     * @param {number} [realm]\n     * @returns {Promise<NodeClient>}\n     */\n    static async forMirrorNetwork(mirrorNetwork, shard, realm) {\n        const INITIAL_UPDATE_PERIOD = 10_000;\n\n        const client = new NodeClient({\n            mirrorNetwork,\n            shard,\n            realm,\n        }).setNetworkUpdatePeriod(INITIAL_UPDATE_PERIOD);\n\n        await client.updateNetwork();\n\n        return client;\n    }\n\n    /**\n     * Construct a Hedera client pre-configured for Previewnet access.\n     *\n     * @param {object} [props]\n     * @param {boolean} [props.scheduleNetworkUpdate]\n     * @returns {NodeClient}\n     */\n    static forPreviewnet(props = {}) {\n        return new NodeClient({ network: \"previewnet\", ...props });\n    }\n\n    /**\n     * Construct a Hedera client pre-configured for local-node access.\n     *\n     * @param {object} [props]\n     * @param {boolean} [props.scheduleNetworkUpdate]\n     * @returns {NodeClient}\n     */\n    static forLocalNode(props = { scheduleNetworkUpdate: false }) {\n        return new NodeClient({\n            network: \"local-node\",\n            ...props,\n        });\n    }\n\n    /**\n     * @param {{[key: string]: (string | AccountId)} | string} network\n     * @returns {void}\n     */\n    setNetwork(network) {\n        if (typeof network === \"string\") {\n            this._setNetworkFromName(network);\n        } else {\n            this._network.setNetwork(network);\n        }\n    }\n\n    /**\n     * Available only for NodeClient\n     *\n     * @param {number} maxExecutionTime\n     * @returns {this}\n     */\n    setMaxExecutionTime(maxExecutionTime) {\n        this._maxExecutionTime = maxExecutionTime;\n        return this;\n    }\n\n    /**\n     * @private\n     * @param {string} name\n     * @returns {this}\n     */\n    _setNetworkFromName(name) {\n        switch (name) {\n            case \"mainnet\":\n                this.setNetworkFromAddressBook(\n                    NodeAddressBook.fromBytes(hex.decode(mainnet.addressBook)),\n                );\n                this.setMirrorNetwork(MirrorNetwork.MAINNET);\n                this.setLedgerId(LedgerId.MAINNET);\n                break;\n\n            case \"testnet\":\n                this.setNetworkFromAddressBook(\n                    NodeAddressBook.fromBytes(hex.decode(testnet.addressBook)),\n                );\n                this.setMirrorNetwork(MirrorNetwork.TESTNET);\n                this.setLedgerId(LedgerId.TESTNET);\n                break;\n\n            case \"previewnet\":\n                this.setNetworkFromAddressBook(\n                    NodeAddressBook.fromBytes(\n                        hex.decode(previewnet.addressBook),\n                    ),\n                );\n                this.setMirrorNetwork(MirrorNetwork.PREVIEWNET);\n                this.setLedgerId(LedgerId.PREVIEWNET);\n                break;\n\n            case \"local-node\":\n                this.setNetwork(Network.LOCAL_NODE);\n                this.setMirrorNetwork(MirrorNetwork.LOCAL_NODE);\n                this.setLedgerId(LedgerId.LOCAL_NODE);\n                break;\n\n            default:\n                throw new Error(\n                    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n                    `unknown network: ${name}`,\n                );\n        }\n        return this;\n    }\n\n    /**\n     * @param {string[] | string} mirrorNetwork\n     * @returns {this}\n     */\n    setMirrorNetwork(mirrorNetwork) {\n        if (typeof mirrorNetwork === \"string\") {\n            switch (mirrorNetwork) {\n                case \"local-node\":\n                    this._mirrorNetwork.setNetwork(MirrorNetwork.LOCAL_NODE);\n                    break;\n                case \"previewnet\":\n                    this._mirrorNetwork.setNetwork(MirrorNetwork.PREVIEWNET);\n                    break;\n                case \"testnet\":\n                    this._mirrorNetwork.setNetwork(MirrorNetwork.TESTNET);\n                    break;\n                case \"mainnet\":\n                    this._mirrorNetwork.setNetwork(MirrorNetwork.MAINNET);\n                    break;\n                default:\n                    this._mirrorNetwork.setNetwork([mirrorNetwork]);\n            }\n        } else {\n            this._mirrorNetwork.setNetwork(mirrorNetwork);\n        }\n\n        return this;\n    }\n\n    /**\n     * @override\n     * @returns {(address: string, cert?: string) => NodeChannel}\n     */\n    _createNetworkChannel() {\n        return (address) => new NodeChannel(address, this._maxExecutionTime);\n    }\n\n    /**\n     * @override\n     * @returns {(address: string) => NodeMirrorChannel}\n     */\n    _createMirrorNetworkChannel() {\n        return (address) => new NodeMirrorChannel(address);\n    }\n}\n"],"names":["readFileAsync","util","promisify","fs","readFile","Network","LOCAL_NODE","AccountId","NodeClient","Client","constructor","props","super","this","_maxExecutionTime","network","_setNetworkFromName","_validateNetworkConsistency","shard","realm","_extractShardRealm","_shard","_realm","setNetwork","mirrorNetwork","setMirrorNetwork","MirrorNetwork","MAINNET","TESTNET","PREVIEWNET","fromConfig","data","JSON","parse","fromConfigFile","filename","forNetwork","forName","forMainnet","forTestnet","forMirrorNetwork","client","setNetworkUpdatePeriod","updateNetwork","forPreviewnet","forLocalNode","scheduleNetworkUpdate","_network","setMaxExecutionTime","maxExecutionTime","name","setNetworkFromAddressBook","NodeAddressBook","fromBytes","hex.decode","mainnet.addressBook","setLedgerId","LedgerId","testnet.addressBook","previewnet.addressBook","Error","_mirrorNetwork","_createNetworkChannel","address","NodeChannel","_createMirrorNetworkChannel","NodeMirrorChannel"],"mappings":"uiBAgBA,MAAMA,EAAgBC,EAAKC,UAAUC,EAAGC,UAM3BC,EAAU,CACnBC,WAAY,CACR,kBAAmB,IAAIC,EAAU,KAS1B,MAAMC,UAAmBC,EAIpC,WAAAC,CAAYC,GAMR,GALAC,MAAMD,GAGNE,KAAKC,kBAAoB,IAEZ,MAATH,EAAe,CACf,GAA6B,iBAAlBA,EAAMI,QACbF,KAAKG,oBAAoBL,EAAMI,cAC5B,GAAqB,MAAjBJ,EAAMI,QAAiB,CAC9BN,EAAOQ,4BAA4BN,EAAMI,SAEzC,MAAMG,MAAEA,EAAKC,MAAEA,GAAUV,EAAOW,mBAC5BT,EAAMI,SAKVF,KAAKQ,OAASH,EACdL,KAAKS,OAASH,EAEdN,KAAKU,WAAWZ,EAAMI,QACtC,CAEY,GAAmC,iBAAxBJ,EAAMa,cACb,OAAQb,EAAMa,eACV,IAAK,UACDX,KAAKY,iBAAiBC,EAAcC,SACpC,MAEJ,IAAK,UACDd,KAAKY,iBAAiBC,EAAcE,SACpC,MAEJ,IAAK,aACDf,KAAKY,iBAAiBC,EAAcG,YACpC,MAEJ,QACIhB,KAAKY,iBAAiB,CAACd,EAAMa,qBAGP,MAAvBb,EAAMa,eACbX,KAAKY,iBAAiBd,EAAMa,cAE5C,CACA,CAMI,iBAAOM,CAAWC,GACd,OAAO,IAAIvB,EACS,iBAATuB,EAEGC,KAAKC,MAAMF,GAEfA,EAElB,CAMI,2BAAaG,CAAeC,GACxB,OAAO3B,EAAWsB,iBAAiB9B,EAAcmC,EAAU,QACnE,CAgBI,iBAAOC,CAAWrB,EAASJ,GACvB,OAAO,IAAIH,EAAW,CAClBO,aACGJ,GAEf,CAQI,cAAO0B,CAAQtB,EAASJ,EAAQ,IAC5B,OAAO,IAAIH,EAAW,CAAEO,aAAYJ,GAC5C,CASI,iBAAO2B,CAAW3B,EAAQ,IACtB,OAAO,IAAIH,EAAW,CAAEO,QAAS,aAAcJ,GACvD,CASI,iBAAO4B,CAAW5B,EAAQ,IACtB,OAAO,IAAIH,EAAW,CAAEO,QAAS,aAAcJ,GACvD,CAQI,6BAAa6B,CAAiBhB,EAAeN,EAAOC,GAChD,MAEMsB,EAAS,IAAIjC,EAAW,CAC1BgB,gBACAN,QACAC,UACDuB,uBAN2B,KAU9B,aAFMD,EAAOE,gBAENF,CACf,CASI,oBAAOG,CAAcjC,EAAQ,IACzB,OAAO,IAAIH,EAAW,CAAEO,QAAS,gBAAiBJ,GAC1D,CASI,mBAAOkC,CAAalC,EAAQ,CAAEmC,uBAAuB,IACjD,OAAO,IAAItC,EAAW,CAClBO,QAAS,gBACNJ,GAEf,CAMI,UAAAY,CAAWR,GACgB,iBAAZA,EACPF,KAAKG,oBAAoBD,GAEzBF,KAAKkC,SAASxB,WAAWR,EAErC,CAQI,mBAAAiC,CAAoBC,GAEhB,OADApC,KAAKC,kBAAoBmC,EAClBpC,IACf,CAOI,mBAAAG,CAAoBkC,GAChB,OAAQA,GACJ,IAAK,UACDrC,KAAKsC,0BACDC,EAAgBC,UAAUC,EAAWC,KAEzC1C,KAAKY,iBAAiBC,EAAcC,SACpCd,KAAK2C,YAAYC,EAAS9B,SAC1B,MAEJ,IAAK,UACDd,KAAKsC,0BACDC,EAAgBC,UAAUC,EAAWI,KAEzC7C,KAAKY,iBAAiBC,EAAcE,SACpCf,KAAK2C,YAAYC,EAAS7B,SAC1B,MAEJ,IAAK,aACDf,KAAKsC,0BACDC,EAAgBC,UACZC,EAAWK,KAGnB9C,KAAKY,iBAAiBC,EAAcG,YACpChB,KAAK2C,YAAYC,EAAS5B,YAC1B,MAEJ,IAAK,aACDhB,KAAKU,WAAWlB,EAAQC,YACxBO,KAAKY,iBAAiBC,EAAcpB,YACpCO,KAAK2C,YAAYC,EAASnD,YAC1B,MAEJ,QACI,MAAM,IAAIsD,MAEN,oBAAoBV,KAGhC,OAAOrC,IACf,CAMI,gBAAAY,CAAiBD,GACb,GAA6B,iBAAlBA,EACP,OAAQA,GACJ,IAAK,aACDX,KAAKgD,eAAetC,WAAWG,EAAcpB,YAC7C,MACJ,IAAK,aACDO,KAAKgD,eAAetC,WAAWG,EAAcG,YAC7C,MACJ,IAAK,UACDhB,KAAKgD,eAAetC,WAAWG,EAAcE,SAC7C,MACJ,IAAK,UACDf,KAAKgD,eAAetC,WAAWG,EAAcC,SAC7C,MACJ,QACId,KAAKgD,eAAetC,WAAW,CAACC,SAGxCX,KAAKgD,eAAetC,WAAWC,GAGnC,OAAOX,IACf,CAMI,qBAAAiD,GACI,OAAQC,GAAY,IAAIC,EAAYD,EAASlD,KAAKC,kBAC1D,CAMI,2BAAAmD,GACI,OAAQF,GAAY,IAAIG,EAAkBH,EAClD"}