@hiero-ledger/sdk 2.70.0

package/lib/client/Client.d.ts

@@ -0,0 +1,487 @@
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+ * @typedef {import("../address_book/NodeAddressBook.js").default} NodeAddressBook
+ */
+/**
+ * @typedef {object} Operator
+ * @property {string | PrivateKey} privateKey
+ * @property {string | AccountId} accountId
+ */
+/**
+ * @typedef {object} ClientOperator
+ * @property {PublicKey} publicKey
+ * @property {AccountId} accountId
+ * @property {(message: Uint8Array) => Promise<Uint8Array>} transactionSigner
+ */
+/**
+ * @typedef {object} ClientConfiguration
+ * @property {{[key: string]: (string | AccountId)} | string} [network]
+ * @property {string[] | string} [mirrorNetwork]
+ * @property {Operator} [operator]
+ * @property {boolean} [scheduleNetworkUpdate]
+ * @property {number} [shard]
+ * @property {number} [realm]
+ */
+/**
+ * @typedef {"mainnet" | "testnet" | "previewnet"} NetworkName
+ */
+/**
+ * The `Client` class is the main entry point for interacting with the Hedera Hashgraph network.
+ * It provides methods for managing network connections, setting operators, handling transactions
+ * and queries, and configuring various client settings.
+ *
+ * @abstract
+ * @template {Channel} ChannelT
+ * @template {MirrorChannel} MirrorChannelT
+ */
+export default class Client<ChannelT extends Channel, MirrorChannelT extends MirrorChannel> {
+    /**
+     * Validates that all nodes in a network are in the same shard and realm.
+     *
+     * @param {{[key: string]: (string | AccountId)}} network
+     */
+    static _validateNetworkConsistency(network: {
+        [key: string]: (string | AccountId);
+    }): void;
+    /**
+     * Extracts shard and realm values from a network configuration.
+     * Note: This method assumes the network is consistent (all nodes in same shard/realm).
+     * Use validateNetworkConsistency() first to ensure this.
+     *
+     * @param {{[key: string]: (string | AccountId)}} network
+     * @returns {{shard: number, realm: number}}
+     */
+    static _extractShardRealm(network: {
+        [key: string]: (string | AccountId);
+    }): {
+        shard: number;
+        realm: number;
+    };
+    /**
+     * @protected
+     * @hideconstructor
+     * @param {ClientConfiguration} [props]
+     */
+    protected constructor();
+    /**
+     * List of mirror network URLs.
+     *
+     * @internal
+     * @type {MirrorNetwork}
+     */
+    _mirrorNetwork: MirrorNetwork;
+    /**
+     * Map of node account ID (as a string)
+     * to the node URL.
+     *
+     * @internal
+     * @type {Network}
+     */
+    _network: Network;
+    /**
+     * @internal
+     * @type {?ClientOperator}
+     */
+    _operator: ClientOperator | null;
+    /**
+     * @private
+     * @type {?Hbar}
+     */
+    private _defaultMaxTransactionFee;
+    /**
+     * @private
+     * @type {Hbar}
+     */
+    private _defaultMaxQueryPayment;
+    /** @type {number | null} */
+    _maxAttempts: number | null;
+    /** @private */
+    private _signOnDemand;
+    /** @private */
+    private _autoValidateChecksums;
+    /** @private */
+    private _minBackoff;
+    /** @private */
+    private _maxBackoff;
+    /** @private */
+    private _defaultRegenerateTransactionId;
+    /** @private */
+    private _requestTimeout;
+    /**
+     * @type {boolean}
+     */
+    _isUpdatingNetwork: boolean;
+    /** @private */
+    private _networkUpdatePeriod;
+    /** @private */
+    private _isShutdown;
+    _shard: number;
+    _realm: number;
+    /** @internal */
+    /** @type {NodeJS.Timeout} */
+    _timer: NodeJS.Timeout;
+    /**
+     * Logger
+     *
+     * @external
+     * @type {Logger | null}
+     */
+    _logger: Logger | null;
+    /**
+     * @deprecated
+     * @param {NetworkName} networkName
+     * @returns {this}
+     */
+    setNetworkName(networkName: NetworkName): this;
+    /**
+     * @deprecated
+     * @returns {string | null}
+     */
+    get networkName(): string | null;
+    /**
+     * @param {string|LedgerId} ledgerId
+     * @returns {this}
+     */
+    setLedgerId(ledgerId: string | LedgerId): this;
+    /**
+     * @returns {LedgerId | null}
+     */
+    get ledgerId(): LedgerId | null;
+    /**
+     * @param {{[key: string]: (string | AccountId)} | string} network
+     * @returns {void}
+     */
+    setNetwork(network: {
+        [key: string]: (string | AccountId);
+    } | string): void;
+    /**
+     * @param {NodeAddressBook} addressBook
+     * @returns {this}
+     */
+    setNetworkFromAddressBook(addressBook: NodeAddressBook): this;
+    /**
+     * @returns {{[key: string]: (string | AccountId)}}
+     */
+    get network(): {
+        [key: string]: (string | AccountId);
+    };
+    /**
+     * @returns {number}
+     */
+    get shard(): number;
+    /**
+     * @returns {number}
+     */
+    get realm(): number;
+    /**
+     * @param {string[] | string} mirrorNetwork
+     * @returns {void}
+     */
+    setMirrorNetwork(mirrorNetwork: string[] | string): void;
+    /**
+     * @returns {string[]}
+     */
+    get mirrorNetwork(): string[];
+    /**
+     * @returns {boolean}
+     */
+    get signOnDemand(): boolean;
+    /**
+     * @param {boolean} signOnDemand
+     */
+    setSignOnDemand(signOnDemand: boolean): void;
+    /**
+     * @returns {boolean}
+     */
+    isTransportSecurity(): boolean;
+    /**
+     * @param {boolean} transportSecurity
+     * @returns {this}
+     */
+    setTransportSecurity(transportSecurity: boolean): this;
+    /**
+     * Set the account that will, by default, pay for transactions and queries built with this client.
+     * NOTE: When using string for private key, the string needs to contain DER headers
+     *
+     * @param {AccountId | string} accountId
+     * @param {PrivateKey | string} privateKey
+     * @returns {this}
+     */
+    setOperator(accountId: AccountId | string, privateKey: PrivateKey | string): this;
+    /**
+     * @returns {?ClientOperator}
+     */
+    getOperator(): ClientOperator | null;
+    /**
+     * Sets the account that will, by default, pay for transactions and queries built with
+     * this client.
+     *
+     * @param {AccountId | string} accountId
+     * @param {PublicKey | string} publicKey
+     * @param {(message: Uint8Array) => Promise<Uint8Array>} transactionSigner
+     * @returns {this}
+     */
+    setOperatorWith(accountId: AccountId | string, publicKey: PublicKey | string, transactionSigner: (message: Uint8Array) => Promise<Uint8Array>): this;
+    /**
+     * @param {boolean} value
+     * @returns {this}
+     */
+    setAutoValidateChecksums(value: boolean): this;
+    /**
+     * @returns {boolean}
+     */
+    isAutoValidateChecksumsEnabled(): boolean;
+    /**
+     * @returns {?AccountId}
+     */
+    get operatorAccountId(): AccountId | null;
+    /**
+     * @returns {?PublicKey}
+     */
+    get operatorPublicKey(): PublicKey | null;
+    /**
+     * @returns {?Hbar}
+     */
+    get defaultMaxTransactionFee(): Hbar | null;
+    /**
+     * @deprecated - Use `defaultMaxTransactionFee` instead
+     * @returns {?Hbar}
+     */
+    get maxTransactionFee(): Hbar | null;
+    /**
+     * Set the defaultimum fee to be paid for transactions
+     * executed by this client.
+     *
+     * @param {Hbar} defaultMaxTransactionFee
+     * @returns {this}
+     */
+    setDefaultMaxTransactionFee(defaultMaxTransactionFee: Hbar): this;
+    /**
+     * @deprecated - Use `setDefaultMaxTransactionFee()` instead
+     * Set the maximum fee to be paid for transactions
+     * executed by this client.
+     * @param {Hbar} maxTransactionFee
+     * @returns {this}
+     */
+    setMaxTransactionFee(maxTransactionFee: Hbar): this;
+    /**
+     * @returns {boolean}
+     */
+    get defaultRegenerateTransactionId(): boolean;
+    /**
+     * Set if a new transaction ID should be generated when a `TRANSACTION_EXPIRED` status
+     * is returned.
+     *
+     * @param {boolean} defaultRegenerateTransactionId
+     * @returns {this}
+     */
+    setDefaultRegenerateTransactionId(defaultRegenerateTransactionId: boolean): this;
+    /**
+     * @returns {Hbar}
+     */
+    get defaultMaxQueryPayment(): Hbar;
+    /**
+     * @deprecated in a favor of defaultMaxQueryPayment
+     * @returns {Hbar}
+     */
+    get maxQueryPayment(): Hbar;
+    /**
+     * Set the maximum payment allowable for queries.
+     *
+     * @param {Hbar} defaultMaxQueryPayment
+     * @returns {Client<ChannelT, MirrorChannelT>}
+     */
+    setDefaultMaxQueryPayment(defaultMaxQueryPayment: Hbar): Client<ChannelT, MirrorChannelT>;
+    /**
+     * @deprecated in a favor of setDefaultMaxQueryPayment()
+     * Set the maximum payment allowable for queries.
+     * @param {Hbar} maxQueryPayment
+     * @returns {Client<ChannelT, MirrorChannelT>}
+     */
+    setMaxQueryPayment(maxQueryPayment: Hbar): Client<ChannelT, MirrorChannelT>;
+    /**
+     * @returns {number}
+     */
+    get maxAttempts(): number;
+    /**
+     * @param {number} maxAttempts
+     * @returns {this}
+     */
+    setMaxAttempts(maxAttempts: number): this;
+    /**
+     * @returns {number}
+     */
+    get maxNodeAttempts(): number;
+    /**
+     * @param {number} maxNodeAttempts
+     * @returns {this}
+     */
+    setMaxNodeAttempts(maxNodeAttempts: number): this;
+    /**
+     * @returns {number}
+     */
+    get nodeWaitTime(): number;
+    /**
+     * @param {number} nodeWaitTime
+     * @returns {this}
+     */
+    setNodeWaitTime(nodeWaitTime: number): this;
+    /**
+     * @returns {number}
+     */
+    get maxNodesPerTransaction(): number;
+    /**
+     * @param {number} maxNodesPerTransaction
+     * @returns {this}
+     */
+    setMaxNodesPerTransaction(maxNodesPerTransaction: number): this;
+    /**
+     * @param {?number} minBackoff
+     * @returns {this}
+     */
+    setMinBackoff(minBackoff: number | null): this;
+    /**
+     * @returns {number}
+     */
+    get minBackoff(): number;
+    /**
+     * @param {?number} maxBackoff
+     * @returns {this}
+     */
+    setMaxBackoff(maxBackoff: number | null): this;
+    /**
+     * @returns {number}
+     */
+    get maxBackoff(): number;
+    /**
+     * @param {number} nodeMinBackoff
+     * @returns {this}
+     */
+    setNodeMinBackoff(nodeMinBackoff: number): this;
+    /**
+     * @returns {number}
+     */
+    get nodeMinBackoff(): number;
+    /**
+     * @param {number} nodeMaxBackoff
+     * @returns {this}
+     */
+    setNodeMaxBackoff(nodeMaxBackoff: number): this;
+    /**
+     * @returns {number}
+     */
+    get nodeMaxBackoff(): number;
+    /**
+     * @param {number} nodeMinReadmitPeriod
+     * @returns {this}
+     */
+    setNodeMinReadmitPeriod(nodeMinReadmitPeriod: number): this;
+    /**
+     * @returns {number}
+     */
+    get nodeMinReadmitPeriod(): number;
+    /**
+     * @param {number} nodeMaxReadmitPeriod
+     * @returns {this}
+     */
+    setNodeMaxReadmitPeriod(nodeMaxReadmitPeriod: number): this;
+    /**
+     * @returns {number}
+     */
+    get nodeMaxReadmitPeriod(): number;
+    /**
+     * @param {number} requestTimeout - Number of milliseconds
+     * @returns {this}
+     */
+    setRequestTimeout(requestTimeout: number): this;
+    /**
+     * @returns {?number}
+     */
+    get requestTimeout(): number | null;
+    /**
+     * @returns {number}
+     */
+    get networkUpdatePeriod(): number;
+    /**
+     * @param {number} networkUpdatePeriod
+     * @returns {this}
+     */
+    setNetworkUpdatePeriod(networkUpdatePeriod: number): this;
+    /**
+     * Set logger
+     *
+     * @param {Logger} logger
+     * @returns {this}
+     */
+    setLogger(logger: Logger): this;
+    /**
+     * Get logger if set
+     *
+     * @returns {?Logger}
+     */
+    get logger(): Logger | null;
+    /**
+     * @param {AccountId | string} accountId
+     */
+    ping(accountId: AccountId | string): Promise<void>;
+    pingAll(): Promise<void>;
+    /**
+     * Update the network address book.
+     * @returns {Promise<void>}
+     */
+    updateNetwork(): Promise<void>;
+    /**
+     * @returns {void}
+     */
+    close(): void;
+    /**
+     * @abstract
+     * @returns {(address: string) => ChannelT}
+     */
+    _createNetworkChannel(): (address: string) => ChannelT;
+    /**
+     * @abstract
+     * @returns {(address: string) => MirrorChannelT}
+     */
+    _createMirrorNetworkChannel(): (address: string) => MirrorChannelT;
+    /**
+     * @private
+     */
+    private _scheduleNetworkUpdate;
+    /**
+     * @returns {boolean}
+     */
+    get isClientShutDown(): boolean;
+}
+export type Channel = import("../channel/Channel.js").default;
+export type MirrorChannel = import("../channel/MirrorChannel.js").default;
+export type NodeAddressBook = import("../address_book/NodeAddressBook.js").default;
+export type Operator = {
+    privateKey: string | PrivateKey;
+    accountId: string | AccountId;
+};
+export type ClientOperator = {
+    publicKey: PublicKey;
+    accountId: AccountId;
+    transactionSigner: (message: Uint8Array) => Promise<Uint8Array>;
+};
+export type ClientConfiguration = {
+    network?: string | {
+        [key: string]: string | AccountId;
+    } | undefined;
+    mirrorNetwork?: string | string[] | undefined;
+    operator?: Operator | undefined;
+    scheduleNetworkUpdate?: boolean | undefined;
+    shard?: number | undefined;
+    realm?: number | undefined;
+};
+export type NetworkName = "mainnet" | "testnet" | "previewnet";
+import MirrorNetwork from "./MirrorNetwork.js";
+import Network from "./Network.js";
+import Logger from "../logger/Logger.js";
+import LedgerId from "../LedgerId.js";
+import AccountId from "../account/AccountId.js";
+import PrivateKey from "../PrivateKey.js";
+import PublicKey from "../PublicKey.js";
+import Hbar from "../Hbar.js";

package/lib/client/Client.js

@@ -0,0 +1,2 @@
+import t from"../account/AccountId.js";import e from"../account/AccountBalanceQuery.js";import r from"../Hbar.js";import n from"./Network.js";import s from"./MirrorNetwork.js";import o from"../PublicKey.js";import i from"../PrivateKey.js";import a from"../LedgerId.js";import u from"../file/FileId.js";import"pino";import"../logger/LogLevel.js";import{convertToNumber as h}from"../util.js";import d from"../network/AddressBookQuery.js";class l{constructor(t){this._mirrorNetwork=new s(this._createMirrorNetworkChannel()),this._network=new n(this._createNetworkChannel()),this._operator=null,this._defaultMaxTransactionFee=null,this._defaultMaxQueryPayment=new r(1),null!=t&&null!=t.operator&&this.setOperator(t.operator.accountId,t.operator.privateKey),this._maxAttempts=null,this._signOnDemand=!1,this._autoValidateChecksums=!1,this._minBackoff=250,this._maxBackoff=8e3,this._defaultRegenerateTransactionId=!0,this._requestTimeout=null,this._isUpdatingNetwork=!1,this._networkUpdatePeriod=864e5,this._isShutdown=!1,this._shard=0,this._realm=0,null!=t&&!1!==t.scheduleNetworkUpdate&&this._scheduleNetworkUpdate(),null!=t&&null!=t.shard&&(this._shard=t.shard),null!=t&&null!=t.realm&&(this._realm=t.realm),this._timer,this._logger=null}setNetworkName(t){return console.warn("Deprecated: Use `setLedgerId` instead"),this.setLedgerId(t)}get networkName(){return console.warn("Deprecated: Use `ledgerId` instead"),null!=this.ledgerId?this.ledgerId.toString():null}setLedgerId(t){return this._network.setLedgerId("string"==typeof t?a.fromString(t):t),this}get ledgerId(){return null!=this._network._ledgerId?this._network.ledgerId:null}setNetwork(t){throw new Error("not implemented")}setNetworkFromAddressBook(t){return this._network.setNetworkFromAddressBook(t),this}get network(){return this._network.network}get shard(){return this._shard}get realm(){return this._realm}setMirrorNetwork(t){throw new Error("not implemented")}get mirrorNetwork(){return this._mirrorNetwork.network}get signOnDemand(){return this._signOnDemand}setSignOnDemand(t){this._signOnDemand=t}isTransportSecurity(){return this._network.isTransportSecurity()}setTransportSecurity(t){return this._network.setTransportSecurity(t),this}setOperator(t,e){const r="string"==typeof e?i.fromStringDer(e):e;return this.setOperatorWith(t,r.publicKey,(t=>Promise.resolve(r.sign(t))))}getOperator(){return this._operator}setOperatorWith(e,r,n){const s=e instanceof t?e:t.fromString(e);return null!=this._network._ledgerId&&s.validateChecksum(this),this._operator={transactionSigner:n,accountId:s,publicKey:r instanceof o?r:o.fromString(r)},this}setAutoValidateChecksums(t){return this._autoValidateChecksums=t,this}isAutoValidateChecksumsEnabled(){return this._autoValidateChecksums}get operatorAccountId(){return null!=this._operator?this._operator.accountId:null}get operatorPublicKey(){return null!=this._operator?this._operator.publicKey:null}get defaultMaxTransactionFee(){return this._defaultMaxTransactionFee}get maxTransactionFee(){return this.defaultMaxTransactionFee}setDefaultMaxTransactionFee(t){if(t.toTinybars().toInt()<0)throw new Error("defaultMaxTransactionFee must be non-negative");return this._defaultMaxTransactionFee=t,this}setMaxTransactionFee(t){return this.setDefaultMaxTransactionFee(t)}get defaultRegenerateTransactionId(){return this._defaultRegenerateTransactionId}setDefaultRegenerateTransactionId(t){return this._defaultRegenerateTransactionId=t,this}get defaultMaxQueryPayment(){return this._defaultMaxQueryPayment}get maxQueryPayment(){return this.defaultMaxQueryPayment}setDefaultMaxQueryPayment(t){if(h(t.toTinybars())<0)throw new Error("defaultMaxQueryPayment must be non-negative");return this._defaultMaxQueryPayment=t,this}setMaxQueryPayment(t){return this.setDefaultMaxQueryPayment(t)}get maxAttempts(){return null!=this._maxAttempts?this._maxAttempts:10}setMaxAttempts(t){return this._maxAttempts=t,this}get maxNodeAttempts(){return this._network.maxNodeAttempts}setMaxNodeAttempts(t){return this._network.setMaxNodeAttempts(t),this}get nodeWaitTime(){return this._network.minBackoff}setNodeWaitTime(t){return this._network.setMinBackoff(t),this}get maxNodesPerTransaction(){return this._network.maxNodesPerTransaction}setMaxNodesPerTransaction(t){return this._network.setMaxNodesPerTransaction(t),this}setMinBackoff(t){if(null==t)throw new Error("minBackoff cannot be null.");if(t>this._maxBackoff)throw new Error("minBackoff cannot be larger than maxBackoff.");return this._minBackoff=t,this}get minBackoff(){return this._minBackoff}setMaxBackoff(t){if(null==t)throw new Error("maxBackoff cannot be null.");if(t<this._minBackoff)throw new Error("maxBackoff cannot be smaller than minBackoff.");return this._maxBackoff=t,this}get maxBackoff(){return this._maxBackoff}setNodeMinBackoff(t){return this._network.setMinBackoff(t),this}get nodeMinBackoff(){return this._network.minBackoff}setNodeMaxBackoff(t){return this._network.setMaxBackoff(t),this}get nodeMaxBackoff(){return this._network.maxBackoff}setNodeMinReadmitPeriod(t){return this._network.setNodeMinReadmitPeriod(t),this}get nodeMinReadmitPeriod(){return this._network.nodeMinReadmitPeriod}setNodeMaxReadmitPeriod(t){return this._network.setNodeMaxReadmitPeriod(t),this}get nodeMaxReadmitPeriod(){return this._network.nodeMaxReadmitPeriod}setRequestTimeout(t){return this._requestTimeout=t,this}get requestTimeout(){return this._requestTimeout}get networkUpdatePeriod(){return this._networkUpdatePeriod}setNetworkUpdatePeriod(t){return clearTimeout(this._timer),this._networkUpdatePeriod=t,this._scheduleNetworkUpdate(),this}setLogger(t){return this._logger=t,this}get logger(){return this._logger}async ping(r){await new e({accountId:r}).setNodeAccountIds([r instanceof t?r:t.fromString(r)]).execute(this)}async pingAll(){for(const t of Object.values(this._network.network))await this.ping(t)}async updateNetwork(){if(!this._isUpdatingNetwork){this._isUpdatingNetwork=!0;try{const t=await(new d).setFileId(u.getAddressBookFileIdFor(this._shard,this._realm)).execute(this);this.setNetworkFromAddressBook(t)}catch(t){this._logger&&this._logger.trace(`failed to update client address book: ${t.toString()}`)}finally{this._isUpdatingNetwork=!1}}}close(){this._network.close(),this._mirrorNetwork.close(),this._isShutdown=!0,clearTimeout(this._timer)}_createNetworkChannel(){throw new Error("not implemented")}_createMirrorNetworkChannel(){throw new Error("not implemented")}_scheduleNetworkUpdate(){this._timer=setTimeout((async()=>{await this.updateNetwork(),this._isShutdown||this._scheduleNetworkUpdate()}),this._networkUpdatePeriod)}get isClientShutDown(){return this._isShutdown}static _validateNetworkConsistency(t){if(0===Object.keys(t).length)return;const[,e]=Object.entries(t)[0],r=e.toString(),[n,s]=r.split(".").map(Number),o=Object.values(t).every((t=>{const e=t.toString(),[r,o]=e.split(".").map(Number);return r===n&&o===s}));if(!o)throw new Error("Network is not valid, all nodes must be in the same shard and realm")}static _extractShardRealm(t){const e=Object.entries(t);if(0===e.length)return{shard:0,realm:0};const[,r]=e[0],n=r.toString(),[s,o]=n.split(".").map(Number);return{shard:s,realm:o}}}export{l as default};
+//# sourceMappingURL=Client.js.map

package/lib/client/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sources":["../../src/client/Client.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport AccountId from \"../account/AccountId.js\";\nimport AccountBalanceQuery from \"../account/AccountBalanceQuery.js\";\nimport Hbar from \"../Hbar.js\";\nimport Network from \"./Network.js\";\nimport MirrorNetwork from \"./MirrorNetwork.js\";\nimport PublicKey from \"../PublicKey.js\";\nimport PrivateKey from \"../PrivateKey.js\";\nimport LedgerId from \"../LedgerId.js\";\nimport FileId from \"../file/FileId.js\";\nimport Logger from \"../logger/Logger.js\"; // eslint-disable-line\nimport { convertToNumber } from \"../util.js\";\nimport AddressBookQuery from \"../network/AddressBookQuery.js\";\n\n/**\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../channel/MirrorChannel.js\").default} MirrorChannel\n * @typedef {import(\"../address_book/NodeAddressBook.js\").default} NodeAddressBook\n */\n\n/**\n * @typedef {object} Operator\n * @property {string | PrivateKey} privateKey\n * @property {string | AccountId} accountId\n */\n\n/**\n * @typedef {object} ClientOperator\n * @property {PublicKey} publicKey\n * @property {AccountId} accountId\n * @property {(message: Uint8Array) => Promise<Uint8Array>} transactionSigner\n */\n\n/**\n * @typedef {object} ClientConfiguration\n * @property {{[key: string]: (string | AccountId)} | string} [network]\n * @property {string[] | string} [mirrorNetwork]\n * @property {Operator} [operator]\n * @property {boolean} [scheduleNetworkUpdate]\n * @property {number} [shard]\n * @property {number} [realm]\n */\n\n/**\n * @typedef {\"mainnet\" | \"testnet\" | \"previewnet\"} NetworkName\n */\n\n/**\n * The `Client` class is the main entry point for interacting with the Hedera Hashgraph network.\n * It provides methods for managing network connections, setting operators, handling transactions\n * and queries, and configuring various client settings.\n *\n * @abstract\n * @template {Channel} ChannelT\n * @template {MirrorChannel} MirrorChannelT\n */\nexport default class Client {\n    /**\n     * @protected\n     * @hideconstructor\n     * @param {ClientConfiguration} [props]\n     */\n    constructor(props) {\n        /**\n         * List of mirror network URLs.\n         *\n         * @internal\n         * @type {MirrorNetwork}\n         */\n        this._mirrorNetwork = new MirrorNetwork(\n            this._createMirrorNetworkChannel(),\n        );\n\n        /**\n         * Map of node account ID (as a string)\n         * to the node URL.\n         *\n         * @internal\n         * @type {Network}\n         */\n        this._network = new Network(this._createNetworkChannel());\n\n        /**\n         * @internal\n         * @type {?ClientOperator}\n         */\n        this._operator = null;\n\n        /**\n         * @private\n         * @type {?Hbar}\n         */\n        this._defaultMaxTransactionFee = null;\n\n        /**\n         * @private\n         * @type {Hbar}\n         */\n        this._defaultMaxQueryPayment = new Hbar(1);\n\n        if (props != null) {\n            if (props.operator != null) {\n                this.setOperator(\n                    props.operator.accountId,\n                    props.operator.privateKey,\n                );\n            }\n        }\n\n        /** @type {number | null} */\n        this._maxAttempts = null;\n\n        /** @private */\n        this._signOnDemand = false;\n\n        /** @private */\n        this._autoValidateChecksums = false;\n\n        /** @private */\n        this._minBackoff = 250;\n\n        /** @private */\n        this._maxBackoff = 8000;\n\n        /** @private */\n        this._defaultRegenerateTransactionId = true;\n\n        /** @private */\n        this._requestTimeout = null;\n\n        /**\n         * @type {boolean}\n         */\n        this._isUpdatingNetwork = false;\n\n        /** @private */\n        this._networkUpdatePeriod = 24 * 60 * 60 * 1000;\n\n        /** @private */\n        this._isShutdown = false;\n\n        this._shard = 0;\n\n        this._realm = 0;\n\n        if (props != null && props.scheduleNetworkUpdate !== false) {\n            this._scheduleNetworkUpdate();\n        }\n\n        if (props != null && props.shard != null) {\n            this._shard = props.shard;\n        }\n\n        if (props != null && props.realm != null) {\n            this._realm = props.realm;\n        }\n\n        /** @internal */\n        /** @type {NodeJS.Timeout} */\n        this._timer;\n\n        /**\n         * Logger\n         *\n         * @external\n         * @type {Logger | null}\n         */\n        this._logger = null;\n    }\n\n    /**\n     * @deprecated\n     * @param {NetworkName} networkName\n     * @returns {this}\n     */\n    setNetworkName(networkName) {\n        // uses custom NetworkName type\n        // remove if phasing out set|get NetworkName\n        console.warn(\"Deprecated: Use `setLedgerId` instead\");\n        return this.setLedgerId(networkName);\n    }\n\n    /**\n     * @deprecated\n     * @returns {string | null}\n     */\n    get networkName() {\n        console.warn(\"Deprecated: Use `ledgerId` instead\");\n        return this.ledgerId != null ? this.ledgerId.toString() : null;\n    }\n\n    /**\n     * @param {string|LedgerId} ledgerId\n     * @returns {this}\n     */\n    setLedgerId(ledgerId) {\n        this._network.setLedgerId(\n            typeof ledgerId === \"string\"\n                ? LedgerId.fromString(ledgerId)\n                : ledgerId,\n        );\n\n        return this;\n    }\n\n    /**\n     * @returns {LedgerId | null}\n     */\n    get ledgerId() {\n        return this._network._ledgerId != null ? this._network.ledgerId : null;\n    }\n\n    /**\n     * @param {{[key: string]: (string | AccountId)} | string} network\n     * @returns {void}\n     */\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setNetwork(network) {\n        // TODO: This logic _can_ be de-duplicated and likely should\n        throw new Error(\"not implemented\");\n    }\n\n    /**\n     * @param {NodeAddressBook} addressBook\n     * @returns {this}\n     */\n    setNetworkFromAddressBook(addressBook) {\n        this._network.setNetworkFromAddressBook(addressBook);\n        return this;\n    }\n\n    /**\n     * @returns {{[key: string]: (string | AccountId)}}\n     */\n    get network() {\n        return this._network.network;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get shard() {\n        return this._shard;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get realm() {\n        return this._realm;\n    }\n\n    /**\n     * @param {string[] | string} mirrorNetwork\n     * @returns {void}\n     */\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    setMirrorNetwork(mirrorNetwork) {\n        throw new Error(\"not implemented\");\n    }\n\n    /**\n     * @returns {string[]}\n     */\n    get mirrorNetwork() {\n        return this._mirrorNetwork.network;\n    }\n\n    /**\n     * @returns {boolean}\n     */\n    get signOnDemand() {\n        return this._signOnDemand;\n    }\n\n    /**\n     * @param {boolean} signOnDemand\n     */\n    setSignOnDemand(signOnDemand) {\n        this._signOnDemand = signOnDemand;\n    }\n\n    /**\n     * @returns {boolean}\n     */\n    isTransportSecurity() {\n        return this._network.isTransportSecurity();\n    }\n\n    /**\n     * @param {boolean} transportSecurity\n     * @returns {this}\n     */\n    setTransportSecurity(transportSecurity) {\n        this._network.setTransportSecurity(transportSecurity);\n        return this;\n    }\n\n    /**\n     * Set the account that will, by default, pay for transactions and queries built with this client.\n     * NOTE: When using string for private key, the string needs to contain DER headers\n     *\n     * @param {AccountId | string} accountId\n     * @param {PrivateKey | string} privateKey\n     * @returns {this}\n     */\n    setOperator(accountId, privateKey) {\n        const key =\n            typeof privateKey === \"string\"\n                ? PrivateKey.fromStringDer(privateKey)\n                : privateKey;\n\n        return this.setOperatorWith(accountId, key.publicKey, (message) =>\n            Promise.resolve(key.sign(message)),\n        );\n    }\n\n    /**\n     * @returns {?ClientOperator}\n     */\n    getOperator() {\n        return this._operator;\n    }\n\n    /**\n     * Sets the account that will, by default, pay for transactions and queries built with\n     * this client.\n     *\n     * @param {AccountId | string} accountId\n     * @param {PublicKey | string} publicKey\n     * @param {(message: Uint8Array) => Promise<Uint8Array>} transactionSigner\n     * @returns {this}\n     */\n    setOperatorWith(accountId, publicKey, transactionSigner) {\n        const accountId_ =\n            accountId instanceof AccountId\n                ? accountId\n                : AccountId.fromString(accountId);\n\n        if (this._network._ledgerId != null) {\n            accountId_.validateChecksum(this);\n        }\n\n        this._operator = {\n            transactionSigner,\n\n            accountId: accountId_,\n\n            publicKey:\n                publicKey instanceof PublicKey\n                    ? publicKey\n                    : PublicKey.fromString(publicKey),\n        };\n\n        return this;\n    }\n\n    /**\n     * @param {boolean} value\n     * @returns {this}\n     */\n    setAutoValidateChecksums(value) {\n        this._autoValidateChecksums = value;\n        return this;\n    }\n\n    /**\n     * @returns {boolean}\n     */\n    isAutoValidateChecksumsEnabled() {\n        return this._autoValidateChecksums;\n    }\n\n    /**\n     * @returns {?AccountId}\n     */\n    get operatorAccountId() {\n        return this._operator != null ? this._operator.accountId : null;\n    }\n\n    /**\n     * @returns {?PublicKey}\n     */\n    get operatorPublicKey() {\n        return this._operator != null ? this._operator.publicKey : null;\n    }\n\n    /**\n     * @returns {?Hbar}\n     */\n    get defaultMaxTransactionFee() {\n        return this._defaultMaxTransactionFee;\n    }\n\n    /**\n     * @deprecated - Use `defaultMaxTransactionFee` instead\n     * @returns {?Hbar}\n     */\n    get maxTransactionFee() {\n        return this.defaultMaxTransactionFee;\n    }\n\n    /**\n     * Set the defaultimum fee to be paid for transactions\n     * executed by this client.\n     *\n     * @param {Hbar} defaultMaxTransactionFee\n     * @returns {this}\n     */\n    setDefaultMaxTransactionFee(defaultMaxTransactionFee) {\n        if (defaultMaxTransactionFee.toTinybars().toInt() < 0) {\n            throw new Error(\"defaultMaxTransactionFee must be non-negative\");\n        }\n        this._defaultMaxTransactionFee = defaultMaxTransactionFee;\n        return this;\n    }\n\n    /**\n     * @deprecated - Use `setDefaultMaxTransactionFee()` instead\n     * Set the maximum fee to be paid for transactions\n     * executed by this client.\n     * @param {Hbar} maxTransactionFee\n     * @returns {this}\n     */\n    setMaxTransactionFee(maxTransactionFee) {\n        return this.setDefaultMaxTransactionFee(maxTransactionFee);\n    }\n\n    /**\n     * @returns {boolean}\n     */\n    get defaultRegenerateTransactionId() {\n        return this._defaultRegenerateTransactionId;\n    }\n\n    /**\n     * Set if a new transaction ID should be generated when a `TRANSACTION_EXPIRED` status\n     * is returned.\n     *\n     * @param {boolean} defaultRegenerateTransactionId\n     * @returns {this}\n     */\n    setDefaultRegenerateTransactionId(defaultRegenerateTransactionId) {\n        this._defaultRegenerateTransactionId = defaultRegenerateTransactionId;\n        return this;\n    }\n\n    /**\n     * @returns {Hbar}\n     */\n    get defaultMaxQueryPayment() {\n        return this._defaultMaxQueryPayment;\n    }\n\n    /**\n     * @deprecated in a favor of defaultMaxQueryPayment\n     * @returns {Hbar}\n     */\n    get maxQueryPayment() {\n        return this.defaultMaxQueryPayment;\n    }\n\n    /**\n     * Set the maximum payment allowable for queries.\n     *\n     * @param {Hbar} defaultMaxQueryPayment\n     * @returns {Client<ChannelT, MirrorChannelT>}\n     */\n    setDefaultMaxQueryPayment(defaultMaxQueryPayment) {\n        const isMaxQueryPaymentNegative =\n            convertToNumber(defaultMaxQueryPayment.toTinybars()) < 0;\n        if (isMaxQueryPaymentNegative) {\n            throw new Error(\"defaultMaxQueryPayment must be non-negative\");\n        }\n        this._defaultMaxQueryPayment = defaultMaxQueryPayment;\n        return this;\n    }\n    /**\n     * @deprecated in a favor of setDefaultMaxQueryPayment()\n     * Set the maximum payment allowable for queries.\n     * @param {Hbar} maxQueryPayment\n     * @returns {Client<ChannelT, MirrorChannelT>}\n     */\n    setMaxQueryPayment(maxQueryPayment) {\n        return this.setDefaultMaxQueryPayment(maxQueryPayment);\n    }\n\n    /**\n     * @returns {number}\n     */\n    get maxAttempts() {\n        return this._maxAttempts != null ? this._maxAttempts : 10;\n    }\n\n    /**\n     * @param {number} maxAttempts\n     * @returns {this}\n     */\n    setMaxAttempts(maxAttempts) {\n        this._maxAttempts = maxAttempts;\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get maxNodeAttempts() {\n        return this._network.maxNodeAttempts;\n    }\n\n    /**\n     * @param {number} maxNodeAttempts\n     * @returns {this}\n     */\n    setMaxNodeAttempts(maxNodeAttempts) {\n        this._network.setMaxNodeAttempts(maxNodeAttempts);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get nodeWaitTime() {\n        return this._network.minBackoff;\n    }\n\n    /**\n     * @param {number} nodeWaitTime\n     * @returns {this}\n     */\n    setNodeWaitTime(nodeWaitTime) {\n        this._network.setMinBackoff(nodeWaitTime);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get maxNodesPerTransaction() {\n        return this._network.maxNodesPerTransaction;\n    }\n\n    /**\n     * @param {number} maxNodesPerTransaction\n     * @returns {this}\n     */\n    setMaxNodesPerTransaction(maxNodesPerTransaction) {\n        this._network.setMaxNodesPerTransaction(maxNodesPerTransaction);\n        return this;\n    }\n\n    /**\n     * @param {?number} minBackoff\n     * @returns {this}\n     */\n    setMinBackoff(minBackoff) {\n        if (minBackoff == null) {\n            throw new Error(\"minBackoff cannot be null.\");\n        }\n        if (minBackoff > this._maxBackoff) {\n            throw new Error(\"minBackoff cannot be larger than maxBackoff.\");\n        }\n        this._minBackoff = minBackoff;\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get minBackoff() {\n        return this._minBackoff;\n    }\n\n    /**\n     * @param {?number} maxBackoff\n     * @returns {this}\n     */\n    setMaxBackoff(maxBackoff) {\n        if (maxBackoff == null) {\n            throw new Error(\"maxBackoff cannot be null.\");\n        } else if (maxBackoff < this._minBackoff) {\n            throw new Error(\"maxBackoff cannot be smaller than minBackoff.\");\n        }\n        this._maxBackoff = maxBackoff;\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get maxBackoff() {\n        return this._maxBackoff;\n    }\n\n    /**\n     * @param {number} nodeMinBackoff\n     * @returns {this}\n     */\n    setNodeMinBackoff(nodeMinBackoff) {\n        this._network.setMinBackoff(nodeMinBackoff);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get nodeMinBackoff() {\n        return this._network.minBackoff;\n    }\n\n    /**\n     * @param {number} nodeMaxBackoff\n     * @returns {this}\n     */\n    setNodeMaxBackoff(nodeMaxBackoff) {\n        this._network.setMaxBackoff(nodeMaxBackoff);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get nodeMaxBackoff() {\n        return this._network.maxBackoff;\n    }\n\n    /**\n     * @param {number} nodeMinReadmitPeriod\n     * @returns {this}\n     */\n    setNodeMinReadmitPeriod(nodeMinReadmitPeriod) {\n        this._network.setNodeMinReadmitPeriod(nodeMinReadmitPeriod);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get nodeMinReadmitPeriod() {\n        return this._network.nodeMinReadmitPeriod;\n    }\n\n    /**\n     * @param {number} nodeMaxReadmitPeriod\n     * @returns {this}\n     */\n    setNodeMaxReadmitPeriod(nodeMaxReadmitPeriod) {\n        this._network.setNodeMaxReadmitPeriod(nodeMaxReadmitPeriod);\n        return this;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get nodeMaxReadmitPeriod() {\n        return this._network.nodeMaxReadmitPeriod;\n    }\n\n    /**\n     * @param {number} requestTimeout - Number of milliseconds\n     * @returns {this}\n     */\n    setRequestTimeout(requestTimeout) {\n        this._requestTimeout = requestTimeout;\n        return this;\n    }\n\n    /**\n     * @returns {?number}\n     */\n    get requestTimeout() {\n        return this._requestTimeout;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get networkUpdatePeriod() {\n        return this._networkUpdatePeriod;\n    }\n\n    /**\n     * @param {number} networkUpdatePeriod\n     * @returns {this}\n     */\n    setNetworkUpdatePeriod(networkUpdatePeriod) {\n        clearTimeout(this._timer);\n        this._networkUpdatePeriod = networkUpdatePeriod;\n        this._scheduleNetworkUpdate();\n        return this;\n    }\n    /**\n     * Set logger\n     *\n     * @param {Logger} logger\n     * @returns {this}\n     */\n    setLogger(logger) {\n        this._logger = logger;\n        return this;\n    }\n\n    /**\n     * Get logger if set\n     *\n     * @returns {?Logger}\n     */\n    get logger() {\n        return this._logger;\n    }\n\n    /**\n     * @param {AccountId | string} accountId\n     */\n    async ping(accountId) {\n        await new AccountBalanceQuery({ accountId })\n            .setNodeAccountIds([\n                accountId instanceof AccountId\n                    ? accountId\n                    : AccountId.fromString(accountId),\n            ])\n            .execute(this);\n    }\n\n    async pingAll() {\n        for (const nodeAccountId of Object.values(this._network.network)) {\n            await this.ping(nodeAccountId);\n        }\n    }\n\n    /**\n     * Update the network address book.\n     * @returns {Promise<void>}\n     */\n    async updateNetwork() {\n        if (this._isUpdatingNetwork) {\n            return;\n        }\n\n        this._isUpdatingNetwork = true;\n\n        try {\n            const addressBook = await new AddressBookQuery()\n                .setFileId(\n                    FileId.getAddressBookFileIdFor(this._shard, this._realm),\n                )\n                .execute(this);\n            this.setNetworkFromAddressBook(addressBook);\n        } catch (error) {\n            if (this._logger) {\n                this._logger.trace(\n                    `failed to update client address book: ${\n                        /** @type {Error} */ (error).toString()\n                    }`,\n                );\n            }\n        } finally {\n            this._isUpdatingNetwork = false;\n        }\n    }\n\n    /**\n     * @returns {void}\n     */\n    close() {\n        this._network.close();\n        this._mirrorNetwork.close();\n        this._isShutdown = true;\n        clearTimeout(this._timer);\n    }\n\n    /**\n     * @abstract\n     * @returns {(address: string) => ChannelT}\n     */\n    _createNetworkChannel() {\n        throw new Error(\"not implemented\");\n    }\n\n    /**\n     * @abstract\n     * @returns {(address: string) => MirrorChannelT}\n     */\n    _createMirrorNetworkChannel() {\n        throw new Error(\"not implemented\");\n    }\n\n    /**\n     * @private\n     */\n    _scheduleNetworkUpdate() {\n        // This is the automatic network update promise that _eventually_ completes\n        // eslint-disable-next-line @typescript-eslint/no-floating-promises,@typescript-eslint/no-misused-promises\n        this._timer = setTimeout(async () => {\n            await this.updateNetwork();\n\n            if (!this._isShutdown) {\n                // Recall this method to continuously update the network\n                // every `networkUpdatePeriod` amount of itme\n                this._scheduleNetworkUpdate();\n            }\n        }, this._networkUpdatePeriod);\n    }\n\n    /**\n     * @returns {boolean}\n     */\n    get isClientShutDown() {\n        return this._isShutdown;\n    }\n\n    /**\n     * Validates that all nodes in a network are in the same shard and realm.\n     *\n     * @param {{[key: string]: (string | AccountId)}} network\n     */\n    static _validateNetworkConsistency(network) {\n        if (Object.keys(network).length === 0) {\n            return;\n        }\n\n        const [, nodeAccountId] = Object.entries(network)[0];\n\n        const accountIdStr = nodeAccountId.toString();\n\n        const [firstNodeShard, firstNodeRealm] = accountIdStr\n            .split(\".\")\n            .map(Number);\n\n        const isNetworkValid = Object.values(network).every((accountId) => {\n            const accountIdStr = accountId.toString();\n\n            const [currentShard, currentRealm] = accountIdStr\n                .split(\".\")\n                .map(Number);\n            return (\n                currentShard === firstNodeShard &&\n                currentRealm === firstNodeRealm\n            );\n        });\n\n        if (!isNetworkValid) {\n            throw new Error(\n                \"Network is not valid, all nodes must be in the same shard and realm\",\n            );\n        }\n    }\n\n    /**\n     * Extracts shard and realm values from a network configuration.\n     * Note: This method assumes the network is consistent (all nodes in same shard/realm).\n     * Use validateNetworkConsistency() first to ensure this.\n     *\n     * @param {{[key: string]: (string | AccountId)}} network\n     * @returns {{shard: number, realm: number}}\n     */\n    static _extractShardRealm(network) {\n        const entries = Object.entries(network);\n        if (entries.length === 0) {\n            return { shard: 0, realm: 0 };\n        }\n\n        const [, firstNodeAccountId] = entries[0];\n\n        const accountIdStr = firstNodeAccountId.toString();\n        const [shard, realm] = accountIdStr.split(\".\").map(Number);\n\n        return { shard, realm };\n    }\n}\n"],"names":["Client","constructor","props","this","_mirrorNetwork","MirrorNetwork","_createMirrorNetworkChannel","_network","Network","_createNetworkChannel","_operator","_defaultMaxTransactionFee","_defaultMaxQueryPayment","Hbar","operator","setOperator","accountId","privateKey","_maxAttempts","_signOnDemand","_autoValidateChecksums","_minBackoff","_maxBackoff","_defaultRegenerateTransactionId","_requestTimeout","_isUpdatingNetwork","_networkUpdatePeriod","_isShutdown","_shard","_realm","scheduleNetworkUpdate","_scheduleNetworkUpdate","shard","realm","_timer","_logger","setNetworkName","networkName","console","warn","setLedgerId","ledgerId","toString","LedgerId","fromString","_ledgerId","setNetwork","network","Error","setNetworkFromAddressBook","addressBook","setMirrorNetwork","mirrorNetwork","signOnDemand","setSignOnDemand","isTransportSecurity","setTransportSecurity","transportSecurity","key","PrivateKey","fromStringDer","setOperatorWith","publicKey","message","Promise","resolve","sign","getOperator","transactionSigner","accountId_","AccountId","validateChecksum","PublicKey","setAutoValidateChecksums","value","isAutoValidateChecksumsEnabled","operatorAccountId","operatorPublicKey","defaultMaxTransactionFee","maxTransactionFee","setDefaultMaxTransactionFee","toTinybars","toInt","setMaxTransactionFee","defaultRegenerateTransactionId","setDefaultRegenerateTransactionId","defaultMaxQueryPayment","maxQueryPayment","setDefaultMaxQueryPayment","convertToNumber","setMaxQueryPayment","maxAttempts","setMaxAttempts","maxNodeAttempts","setMaxNodeAttempts","nodeWaitTime","minBackoff","setNodeWaitTime","setMinBackoff","maxNodesPerTransaction","setMaxNodesPerTransaction","setMaxBackoff","maxBackoff","setNodeMinBackoff","nodeMinBackoff","setNodeMaxBackoff","nodeMaxBackoff","setNodeMinReadmitPeriod","nodeMinReadmitPeriod","setNodeMaxReadmitPeriod","nodeMaxReadmitPeriod","setRequestTimeout","requestTimeout","networkUpdatePeriod","setNetworkUpdatePeriod","clearTimeout","setLogger","logger","ping","AccountBalanceQuery","setNodeAccountIds","execute","pingAll","nodeAccountId","Object","values","updateNetwork","AddressBookQuery","setFileId","FileId","getAddressBookFileIdFor","error","trace","close","setTimeout","async","isClientShutDown","_validateNetworkConsistency","keys","length","entries","accountIdStr","firstNodeShard","firstNodeRealm","split","map","Number","isNetworkValid","every","currentShard","currentRealm","_extractShardRealm","firstNodeAccountId"],"mappings":"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"}