@hiero-ledger/sdk 2.70.0

package/lib/network/AddressBookQueryWeb.cjs

@@ -0,0 +1,326 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Query = _interopRequireDefault(require("../query/Query.cjs"));
+var _NodeAddressBook = _interopRequireDefault(require("../address_book/NodeAddressBook.cjs"));
+var _FileId = _interopRequireDefault(require("../file/FileId.cjs"));
+var _Executable = require("../Executable.cjs");
+var _NodeAddress = _interopRequireDefault(require("../address_book/NodeAddress.cjs"));
+var _ClientConstants = require("../constants/ClientConstants.cjs");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+ * @typedef {import("../channel/MirrorChannel.js").MirrorError} MirrorError
+ */
+
+/**
+ * @template {Channel} ChannelT
+ * @typedef {import("../client/Client.js").default<ChannelT, MirrorChannel>} Client<ChannelT, MirrorChannel>
+ */
+
+/**
+ * @typedef {object} EndpointWebResponse
+ * @property {string} domain_name
+ * @property {string} ip_address_v4
+ * @property {number} port
+ */
+
+/**
+ * @typedef {object} AddressBookQueryWebResponse
+ * @property {Array<{
+ *   admin_key: {
+ *     key: string,
+ *     _type: string,
+ *   },
+ *   decline_reward: boolean,
+ *   grpc_proxy_endpoint: EndpointWebResponse,
+ *   file_id: string,
+ *   memo: string,
+ *   public_key: string,
+ *   node_id: number,
+ *   node_account_id: string,
+ *   node_cert_hash: string,
+ *   address: string,
+ *   service_endpoints: EndpointWebResponse[],
+ *   description: string,
+ *   stake: number
+ * }>} nodes
+ */
+
+/**
+ * Web-compatible query to get a list of Hedera network node addresses from a mirror node.
+ * Uses fetch API instead of gRPC for web environments.
+ *
+ * This query can be used to retrieve node addresses either from a specific file ID
+ * or from the most recent address book if no file ID is specified. The response
+ * contains node metadata including IP addresses and ports for both node and mirror
+ * node services.
+ * @augments {Query<NodeAddressBook>}
+ */
+class AddressBookQueryWeb extends _Query.default {
+  /**
+   * @param {object} props
+   * @param {FileId | string} [props.fileId]
+   * @param {number} [props.limit]
+   */
+  constructor(props = {}) {
+    super();
+
+    /**
+     * @private
+     * @type {?FileId}
+     */
+    this._fileId = null;
+    if (props.fileId != null) {
+      this.setFileId(props.fileId);
+    }
+
+    /**
+     * Page limit for the query
+     * @private
+     * @type {?number}
+     */
+    this._limit = null;
+    if (props.limit != null) {
+      this.setLimit(props.limit);
+    }
+
+    /**
+     * @private
+     * @type {(error: MirrorError | Error | null) => boolean}
+     */
+    this._retryHandler = error => {
+      if (error != null) {
+        if (error instanceof Error) {
+          // Retry on all errors which are not `MirrorError` because they're
+          // likely lower level HTTP errors
+          return true;
+        } else {
+          // Retry on `NOT_FOUND`, `RESOURCE_EXHAUSTED`, `UNAVAILABLE`, and conditionally on `INTERNAL`
+          // if the message matches the right regex.
+          switch (error.code) {
+            // INTERNAL
+            // eslint-disable-next-line no-fallthrough
+            case 13:
+              return _Executable.RST_STREAM.test(error.details.toString());
+            // NOT_FOUND
+            // eslint-disable-next-line no-fallthrough
+            case 5:
+            // RESOURCE_EXHAUSTED
+            // eslint-disable-next-line no-fallthrough
+            case 8:
+            // UNAVAILABLE
+            // eslint-disable-next-line no-fallthrough
+            case 14:
+            case 17:
+              return true;
+            default:
+              return false;
+          }
+        }
+      }
+      return false;
+    };
+
+    /** @type {NodeAddress[]} */
+    this._addresses = [];
+  }
+
+  /**
+   * @returns {?FileId}
+   */
+  get fileId() {
+    return this._fileId;
+  }
+
+  /**
+   * @param {FileId | string} fileId
+   * @returns {AddressBookQueryWeb}
+   */
+  setFileId(fileId) {
+    this._fileId = typeof fileId === "string" ? _FileId.default.fromString(fileId) : fileId.clone();
+    return this;
+  }
+
+  /**
+   * Page limit for the query
+   * @returns {?number}
+   */
+  get limit() {
+    return this._limit;
+  }
+
+  /**
+   * Set the page limit for the query
+   * @param {number} limit
+   * @returns {AddressBookQueryWeb}
+   */
+  setLimit(limit) {
+    this._limit = limit;
+    return this;
+  }
+
+  /**
+   * @param {number} attempts
+   * @returns {this}
+   */
+  setMaxAttempts(attempts) {
+    this._maxAttempts = attempts;
+    return this;
+  }
+
+  /**
+   * @param {number} backoff
+   * @returns {this}
+   */
+  setMaxBackoff(backoff) {
+    this._maxBackoff = backoff;
+    return this;
+  }
+
+  /**
+   * @param {Client<Channel>} client
+   * @param {number=} requestTimeout
+   * @returns {Promise<NodeAddressBook>}
+   */
+  execute(client, requestTimeout) {
+    // Extra validation when initializing the client with only a mirror network
+    if (client._network._network.size === 0 && !client._timer) {
+      throw new Error("The client's network update period is required. Please set it using the setNetworkUpdatePeriod method.");
+    }
+    return new Promise((resolve, reject) => {
+      void this._makeFetchRequest(client, resolve, reject, requestTimeout);
+    });
+  }
+
+  /**
+   * @private
+   * @param {Client<Channel>} client
+   * @param {(value: NodeAddressBook) => void} resolve
+   * @param {(error: Error) => void} reject
+   * @param {number=} requestTimeout
+   */
+  async _makeFetchRequest(client, resolve, reject, requestTimeout) {
+    const {
+      port,
+      address
+    } = client._mirrorNetwork.getNextMirrorNode().address;
+    let baseUrl = `${address.includes("127.0.0.1") || address.includes("localhost") ? "http" : "https"}://${address}`;
+    if (port) {
+      baseUrl = `${baseUrl}:${port}`;
+    }
+    const url = new URL(`${baseUrl}/api/v1/network/nodes`);
+    if (this._fileId != null) {
+      url.searchParams.append("file.id", this._fileId.toString());
+    }
+    if (this._limit != null) {
+      url.searchParams.append("limit", this._limit.toString());
+    }
+    for (let attempt = 0; attempt <= this._maxAttempts; attempt++) {
+      try {
+        // eslint-disable-next-line n/no-unsupported-features/node-builtins
+        const response = await fetch(url.toString(), {
+          method: "GET",
+          headers: {
+            Accept: "application/json"
+          },
+          signal: requestTimeout ? AbortSignal.timeout(requestTimeout) : undefined
+        });
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const data = /** @type {AddressBookQueryWebResponse} */
+        await response.json();
+        const nodes = data.nodes || [];
+
+        // eslint-disable-next-line ie11/no-loop-func
+        this._addresses = nodes.map(node => _NodeAddress.default.fromJSON({
+          nodeId: node.node_id.toString(),
+          accountId: node.node_account_id,
+          addresses: this._handleAddressesFromGrpcProxyEndpoint(node, client),
+          certHash: node.node_cert_hash,
+          publicKey: node.public_key,
+          description: node.description,
+          stake: node.stake.toString()
+        }));
+        const addressBook = new _NodeAddressBook.default({
+          nodeAddresses: this._addresses
+        });
+        resolve(addressBook);
+        return;
+      } catch (error) {
+        console.error("Error in _makeFetchRequest:", error);
+        const message = error instanceof Error ? error.message : String(error);
+
+        // Check if we should retry
+        if (attempt < this._maxAttempts && !client.isClientShutDown && this._retryHandler(/** @type {MirrorError | Error | null} */error)) {
+          const delay = Math.min(250 * 2 ** attempt, this._maxBackoff);
+          if (this._logger) {
+            this._logger.debug(`Error getting nodes from mirror for file ${this._fileId != null ? this._fileId.toString() : "UNKNOWN"} during attempt ${attempt + 1}. Waiting ${delay} ms before next attempt: ${message}`);
+          }
+
+          // Wait before next attempt
+          // eslint-disable-next-line ie11/no-loop-func
+          await new Promise(resolve => setTimeout(resolve, delay));
+          continue;
+        }
+
+        // If we shouldn't retry or have exhausted attempts, reject
+        const maxAttemptsReached = attempt >= this._maxAttempts;
+        const errorMessage = maxAttemptsReached ? `Failed to query address book after ${this._maxAttempts + 1} attempts. Last error: ${message}` : `Failed to query address book: ${message}`;
+        reject(new Error(errorMessage));
+        return;
+      }
+    }
+
+    // This should never be reached, but just in case
+    reject(new Error("failed to query address book"));
+  }
+
+  /**
+   * Handles the grpc_proxy_endpoint fallback logic for a node.
+   * @param {AddressBookQueryWebResponse['nodes'][number]} node - The node object from the mirror node response.
+   * @param {Client<Channel>} client - The client instance.
+   * @returns {Array<{address: string, port: string}>}
+   */
+  _handleAddressesFromGrpcProxyEndpoint(node, client) {
+    const grpcProxyEndpoint = node.grpc_proxy_endpoint;
+    if (grpcProxyEndpoint && grpcProxyEndpoint.domain_name && grpcProxyEndpoint.port) {
+      return [{
+        address: grpcProxyEndpoint.domain_name,
+        port: grpcProxyEndpoint.port.toString()
+      }];
+    }
+    let networkConstant;
+    const ledgerId = client._network.ledgerId;
+    if (ledgerId && ledgerId.isMainnet()) {
+      networkConstant = _ClientConstants.MAINNET;
+    } else if (ledgerId && ledgerId.isTestnet()) {
+      networkConstant = _ClientConstants.WEB_TESTNET;
+    } else if (ledgerId && ledgerId.isPreviewnet()) {
+      networkConstant = _ClientConstants.WEB_PREVIEWNET;
+    } else {
+      return [];
+    }
+    const nodeAccountId = node.node_account_id;
+    for (const [address, accountIdObj] of Object.entries(networkConstant)) {
+      if (accountIdObj.toString() === nodeAccountId) {
+        const [domain_name, port] = address.split(":");
+        return [{
+          address: domain_name,
+          port
+        }];
+      }
+    }
+    return [];
+  }
+}
+exports.default = AddressBookQueryWeb;

package/lib/network/AddressBookQueryWeb.d.ts

@@ -0,0 +1,165 @@
+/**
+ * @typedef {import("../channel/Channel.js").default} Channel
+ * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+ * @typedef {import("../channel/MirrorChannel.js").MirrorError} MirrorError
+ */
+/**
+ * @template {Channel} ChannelT
+ * @typedef {import("../client/Client.js").default<ChannelT, MirrorChannel>} Client<ChannelT, MirrorChannel>
+ */
+/**
+ * @typedef {object} EndpointWebResponse
+ * @property {string} domain_name
+ * @property {string} ip_address_v4
+ * @property {number} port
+ */
+/**
+ * @typedef {object} AddressBookQueryWebResponse
+ * @property {Array<{
+ *   admin_key: {
+ *     key: string,
+ *     _type: string,
+ *   },
+ *   decline_reward: boolean,
+ *   grpc_proxy_endpoint: EndpointWebResponse,
+ *   file_id: string,
+ *   memo: string,
+ *   public_key: string,
+ *   node_id: number,
+ *   node_account_id: string,
+ *   node_cert_hash: string,
+ *   address: string,
+ *   service_endpoints: EndpointWebResponse[],
+ *   description: string,
+ *   stake: number
+ * }>} nodes
+ */
+/**
+ * Web-compatible query to get a list of Hedera network node addresses from a mirror node.
+ * Uses fetch API instead of gRPC for web environments.
+ *
+ * This query can be used to retrieve node addresses either from a specific file ID
+ * or from the most recent address book if no file ID is specified. The response
+ * contains node metadata including IP addresses and ports for both node and mirror
+ * node services.
+ * @augments {Query<NodeAddressBook>}
+ */
+export default class AddressBookQueryWeb extends Query<NodeAddressBook> {
+    /**
+     * @param {object} props
+     * @param {FileId | string} [props.fileId]
+     * @param {number} [props.limit]
+     */
+    constructor(props?: {
+        fileId?: string | FileId | undefined;
+        limit?: number | undefined;
+    });
+    /**
+     * @private
+     * @type {?FileId}
+     */
+    private _fileId;
+    /**
+     * Page limit for the query
+     * @private
+     * @type {?number}
+     */
+    private _limit;
+    /**
+     * @private
+     * @type {(error: MirrorError | Error | null) => boolean}
+     */
+    private _retryHandler;
+    /** @type {NodeAddress[]} */
+    _addresses: NodeAddress[];
+    /**
+     * @returns {?FileId}
+     */
+    get fileId(): FileId | null;
+    /**
+     * @param {FileId | string} fileId
+     * @returns {AddressBookQueryWeb}
+     */
+    setFileId(fileId: FileId | string): AddressBookQueryWeb;
+    /**
+     * Page limit for the query
+     * @returns {?number}
+     */
+    get limit(): number | null;
+    /**
+     * Set the page limit for the query
+     * @param {number} limit
+     * @returns {AddressBookQueryWeb}
+     */
+    setLimit(limit: number): AddressBookQueryWeb;
+    /**
+     * @param {number} attempts
+     * @returns {this}
+     */
+    setMaxAttempts(attempts: number): this;
+    /**
+     * @param {number} backoff
+     * @returns {this}
+     */
+    setMaxBackoff(backoff: number): this;
+    /**
+     * @param {Client<Channel>} client
+     * @param {number=} requestTimeout
+     * @returns {Promise<NodeAddressBook>}
+     */
+    execute(client: Client<Channel>, requestTimeout?: number | undefined): Promise<NodeAddressBook>;
+    /**
+     * @private
+     * @param {Client<Channel>} client
+     * @param {(value: NodeAddressBook) => void} resolve
+     * @param {(error: Error) => void} reject
+     * @param {number=} requestTimeout
+     */
+    private _makeFetchRequest;
+    /**
+     * Handles the grpc_proxy_endpoint fallback logic for a node.
+     * @param {AddressBookQueryWebResponse['nodes'][number]} node - The node object from the mirror node response.
+     * @param {Client<Channel>} client - The client instance.
+     * @returns {Array<{address: string, port: string}>}
+     */
+    _handleAddressesFromGrpcProxyEndpoint(node: AddressBookQueryWebResponse["nodes"][number], client: Client<Channel>): Array<{
+        address: string;
+        port: string;
+    }>;
+}
+export type Channel = import("../channel/Channel.js").default;
+export type MirrorChannel = import("../channel/MirrorChannel.js").default;
+export type MirrorError = import("../channel/MirrorChannel.js").MirrorError;
+/**
+ * <ChannelT, MirrorChannel>
+ */
+export type Client<ChannelT extends Channel> = import("../client/Client.js").default<ChannelT, MirrorChannel>;
+export type EndpointWebResponse = {
+    domain_name: string;
+    ip_address_v4: string;
+    port: number;
+};
+export type AddressBookQueryWebResponse = {
+    nodes: Array<{
+        admin_key: {
+            key: string;
+            _type: string;
+        };
+        decline_reward: boolean;
+        grpc_proxy_endpoint: EndpointWebResponse;
+        file_id: string;
+        memo: string;
+        public_key: string;
+        node_id: number;
+        node_account_id: string;
+        node_cert_hash: string;
+        address: string;
+        service_endpoints: EndpointWebResponse[];
+        description: string;
+        stake: number;
+    }>;
+};
+import NodeAddressBook from "../address_book/NodeAddressBook.js";
+import Query from "../query/Query.js";
+import NodeAddress from "../address_book/NodeAddress.js";
+import FileId from "../file/FileId.js";

package/lib/network/AddressBookQueryWeb.js

@@ -0,0 +1,2 @@
+import t from"../query/Query.js";import e from"../address_book/NodeAddressBook.js";import r from"../file/FileId.js";import{RST_STREAM as s}from"../Executable.js";import i from"../address_book/NodeAddress.js";import{MAINNET as o,WEB_TESTNET as n,WEB_PREVIEWNET as d}from"../constants/ClientConstants.js";class a extends t{constructor(t={}){super(),this._fileId=null,null!=t.fileId&&this.setFileId(t.fileId),this._limit=null,null!=t.limit&&this.setLimit(t.limit),this._retryHandler=t=>{if(null!=t){if(t instanceof Error)return!0;switch(t.code){case 13:return s.test(t.details.toString());case 5:case 8:case 14:case 17:return!0;default:return!1}}return!1},this._addresses=[]}get fileId(){return this._fileId}setFileId(t){return this._fileId="string"==typeof t?r.fromString(t):t.clone(),this}get limit(){return this._limit}setLimit(t){return this._limit=t,this}setMaxAttempts(t){return this._maxAttempts=t,this}setMaxBackoff(t){return this._maxBackoff=t,this}execute(t,e){if(0===t._network._network.size&&!t._timer)throw new Error("The client's network update period is required. Please set it using the setNetworkUpdatePeriod method.");return new Promise(((r,s)=>{this._makeFetchRequest(t,r,s,e)}))}async _makeFetchRequest(t,r,s,o){const{port:n,address:d}=t._mirrorNetwork.getNextMirrorNode().address;let a=`${d.includes("127.0.0.1")||d.includes("localhost")?"http":"https"}://${d}`;n&&(a=`${a}:${n}`);const l=new URL(`${a}/api/v1/network/nodes`);null!=this._fileId&&l.searchParams.append("file.id",this._fileId.toString()),null!=this._limit&&l.searchParams.append("limit",this._limit.toString());for(let n=0;n<=this._maxAttempts;n++)try{const s=await fetch(l.toString(),{method:"GET",headers:{Accept:"application/json"},signal:o?AbortSignal.timeout(o):void 0});if(!s.ok)throw new Error(`HTTP error! status: ${s.status}`);const n=(await s.json()).nodes||[];this._addresses=n.map((e=>i.fromJSON({nodeId:e.node_id.toString(),accountId:e.node_account_id,addresses:this._handleAddressesFromGrpcProxyEndpoint(e,t),certHash:e.node_cert_hash,publicKey:e.public_key,description:e.description,stake:e.stake.toString()})));return void r(new e({nodeAddresses:this._addresses}))}catch(e){console.error("Error in _makeFetchRequest:",e);const r=e instanceof Error?e.message:String(e);if(n<this._maxAttempts&&!t.isClientShutDown&&this._retryHandler(e)){const t=Math.min(250*2**n,this._maxBackoff);this._logger&&this._logger.debug(`Error getting nodes from mirror for file ${null!=this._fileId?this._fileId.toString():"UNKNOWN"} during attempt ${n+1}. Waiting ${t} ms before next attempt: ${r}`),await new Promise((e=>setTimeout(e,t)));continue}const i=n>=this._maxAttempts?`Failed to query address book after ${this._maxAttempts+1} attempts. Last error: ${r}`:`Failed to query address book: ${r}`;return void s(new Error(i))}s(new Error("failed to query address book"))}_handleAddressesFromGrpcProxyEndpoint(t,e){const r=t.grpc_proxy_endpoint;if(r&&r.domain_name&&r.port)return[{address:r.domain_name,port:r.port.toString()}];let s;const i=e._network.ledgerId;if(i&&i.isMainnet())s=o;else if(i&&i.isTestnet())s=n;else{if(!i||!i.isPreviewnet())return[];s=d}const a=t.node_account_id;for(const[t,e]of Object.entries(s))if(e.toString()===a){const[e,r]=t.split(":");return[{address:e,port:r}]}return[]}}export{a as default};
+//# sourceMappingURL=AddressBookQueryWeb.js.map

package/lib/network/AddressBookQueryWeb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressBookQueryWeb.js","sources":["../../src/network/AddressBookQueryWeb.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Query from \"../query/Query.js\";\nimport NodeAddressBook from \"../address_book/NodeAddressBook.js\";\nimport FileId from \"../file/FileId.js\";\nimport { RST_STREAM } from \"../Executable.js\";\nimport NodeAddress from \"../address_book/NodeAddress.js\";\nimport {\n    MAINNET,\n    WEB_TESTNET,\n    WEB_PREVIEWNET,\n} from \"../constants/ClientConstants.js\";\n\n/**\n * @typedef {import(\"../channel/Channel.js\").default} Channel\n * @typedef {import(\"../channel/MirrorChannel.js\").default} MirrorChannel\n * @typedef {import(\"../channel/MirrorChannel.js\").MirrorError} MirrorError\n */\n\n/**\n * @template {Channel} ChannelT\n * @typedef {import(\"../client/Client.js\").default<ChannelT, MirrorChannel>} Client<ChannelT, MirrorChannel>\n */\n\n/**\n * @typedef {object} EndpointWebResponse\n * @property {string} domain_name\n * @property {string} ip_address_v4\n * @property {number} port\n */\n\n/**\n * @typedef {object} AddressBookQueryWebResponse\n * @property {Array<{\n *   admin_key: {\n *     key: string,\n *     _type: string,\n *   },\n *   decline_reward: boolean,\n *   grpc_proxy_endpoint: EndpointWebResponse,\n *   file_id: string,\n *   memo: string,\n *   public_key: string,\n *   node_id: number,\n *   node_account_id: string,\n *   node_cert_hash: string,\n *   address: string,\n *   service_endpoints: EndpointWebResponse[],\n *   description: string,\n *   stake: number\n * }>} nodes\n */\n\n/**\n * Web-compatible query to get a list of Hedera network node addresses from a mirror node.\n * Uses fetch API instead of gRPC for web environments.\n *\n * This query can be used to retrieve node addresses either from a specific file ID\n * or from the most recent address book if no file ID is specified. The response\n * contains node metadata including IP addresses and ports for both node and mirror\n * node services.\n * @augments {Query<NodeAddressBook>}\n */\nexport default class AddressBookQueryWeb extends Query {\n    /**\n     * @param {object} props\n     * @param {FileId | string} [props.fileId]\n     * @param {number} [props.limit]\n     */\n    constructor(props = {}) {\n        super();\n\n        /**\n         * @private\n         * @type {?FileId}\n         */\n        this._fileId = null;\n        if (props.fileId != null) {\n            this.setFileId(props.fileId);\n        }\n\n        /**\n         * Page limit for the query\n         * @private\n         * @type {?number}\n         */\n        this._limit = null;\n        if (props.limit != null) {\n            this.setLimit(props.limit);\n        }\n\n        /**\n         * @private\n         * @type {(error: MirrorError | Error | null) => boolean}\n         */\n        this._retryHandler = (error) => {\n            if (error != null) {\n                if (error instanceof Error) {\n                    // Retry on all errors which are not `MirrorError` because they're\n                    // likely lower level HTTP errors\n                    return true;\n                } else {\n                    // Retry on `NOT_FOUND`, `RESOURCE_EXHAUSTED`, `UNAVAILABLE`, and conditionally on `INTERNAL`\n                    // if the message matches the right regex.\n                    switch (error.code) {\n                        // INTERNAL\n                        // eslint-disable-next-line no-fallthrough\n                        case 13:\n                            return RST_STREAM.test(error.details.toString());\n                        // NOT_FOUND\n                        // eslint-disable-next-line no-fallthrough\n                        case 5:\n                        // RESOURCE_EXHAUSTED\n                        // eslint-disable-next-line no-fallthrough\n                        case 8:\n                        // UNAVAILABLE\n                        // eslint-disable-next-line no-fallthrough\n                        case 14:\n                        case 17:\n                            return true;\n                        default:\n                            return false;\n                    }\n                }\n            }\n\n            return false;\n        };\n\n        /** @type {NodeAddress[]} */\n        this._addresses = [];\n    }\n\n    /**\n     * @returns {?FileId}\n     */\n    get fileId() {\n        return this._fileId;\n    }\n\n    /**\n     * @param {FileId | string} fileId\n     * @returns {AddressBookQueryWeb}\n     */\n    setFileId(fileId) {\n        this._fileId =\n            typeof fileId === \"string\"\n                ? FileId.fromString(fileId)\n                : fileId.clone();\n\n        return this;\n    }\n\n    /**\n     * Page limit for the query\n     * @returns {?number}\n     */\n    get limit() {\n        return this._limit;\n    }\n\n    /**\n     * Set the page limit for the query\n     * @param {number} limit\n     * @returns {AddressBookQueryWeb}\n     */\n    setLimit(limit) {\n        this._limit = limit;\n\n        return this;\n    }\n\n    /**\n     * @param {number} attempts\n     * @returns {this}\n     */\n    setMaxAttempts(attempts) {\n        this._maxAttempts = attempts;\n        return this;\n    }\n\n    /**\n     * @param {number} backoff\n     * @returns {this}\n     */\n    setMaxBackoff(backoff) {\n        this._maxBackoff = backoff;\n        return this;\n    }\n\n    /**\n     * @param {Client<Channel>} client\n     * @param {number=} requestTimeout\n     * @returns {Promise<NodeAddressBook>}\n     */\n    execute(client, requestTimeout) {\n        // Extra validation when initializing the client with only a mirror network\n        if (client._network._network.size === 0 && !client._timer) {\n            throw new Error(\n                \"The client's network update period is required. Please set it using the setNetworkUpdatePeriod method.\",\n            );\n        }\n\n        return new Promise((resolve, reject) => {\n            void this._makeFetchRequest(\n                client,\n                resolve,\n                reject,\n                requestTimeout,\n            );\n        });\n    }\n\n    /**\n     * @private\n     * @param {Client<Channel>} client\n     * @param {(value: NodeAddressBook) => void} resolve\n     * @param {(error: Error) => void} reject\n     * @param {number=} requestTimeout\n     */\n    async _makeFetchRequest(client, resolve, reject, requestTimeout) {\n        const { port, address } =\n            client._mirrorNetwork.getNextMirrorNode().address;\n\n        let baseUrl = `${address.includes(\"127.0.0.1\") || address.includes(\"localhost\") ? \"http\" : \"https\"}://${address}`;\n\n        if (port) {\n            baseUrl = `${baseUrl}:${port}`;\n        }\n\n        const url = new URL(`${baseUrl}/api/v1/network/nodes`);\n\n        if (this._fileId != null) {\n            url.searchParams.append(\"file.id\", this._fileId.toString());\n        }\n        if (this._limit != null) {\n            url.searchParams.append(\"limit\", this._limit.toString());\n        }\n\n        for (let attempt = 0; attempt <= this._maxAttempts; attempt++) {\n            try {\n                // eslint-disable-next-line n/no-unsupported-features/node-builtins\n                const response = await fetch(url.toString(), {\n                    method: \"GET\",\n                    headers: {\n                        Accept: \"application/json\",\n                    },\n                    signal: requestTimeout\n                        ? AbortSignal.timeout(requestTimeout)\n                        : undefined,\n                });\n\n                if (!response.ok) {\n                    throw new Error(`HTTP error! status: ${response.status}`);\n                }\n\n                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n                const data = /** @type {AddressBookQueryWebResponse} */ (\n                    await response.json()\n                );\n\n                const nodes = data.nodes || [];\n\n                // eslint-disable-next-line ie11/no-loop-func\n                this._addresses = nodes.map((node) =>\n                    NodeAddress.fromJSON({\n                        nodeId: node.node_id.toString(),\n                        accountId: node.node_account_id,\n                        addresses: this._handleAddressesFromGrpcProxyEndpoint(\n                            node,\n                            client,\n                        ),\n                        certHash: node.node_cert_hash,\n                        publicKey: node.public_key,\n                        description: node.description,\n                        stake: node.stake.toString(),\n                    }),\n                );\n\n                const addressBook = new NodeAddressBook({\n                    nodeAddresses: this._addresses,\n                });\n\n                resolve(addressBook);\n                return;\n            } catch (error) {\n                console.error(\"Error in _makeFetchRequest:\", error);\n                const message =\n                    error instanceof Error ? error.message : String(error);\n\n                // Check if we should retry\n                if (\n                    attempt < this._maxAttempts &&\n                    !client.isClientShutDown &&\n                    this._retryHandler(\n                        /** @type {MirrorError | Error | null} */ (error),\n                    )\n                ) {\n                    const delay = Math.min(\n                        250 * 2 ** attempt,\n                        this._maxBackoff,\n                    );\n\n                    if (this._logger) {\n                        this._logger.debug(\n                            `Error getting nodes from mirror for file ${\n                                this._fileId != null\n                                    ? this._fileId.toString()\n                                    : \"UNKNOWN\"\n                            } during attempt ${\n                                attempt + 1\n                            }. Waiting ${delay} ms before next attempt: ${message}`,\n                        );\n                    }\n\n                    // Wait before next attempt\n                    // eslint-disable-next-line ie11/no-loop-func\n                    await new Promise((resolve) => setTimeout(resolve, delay));\n                    continue;\n                }\n\n                // If we shouldn't retry or have exhausted attempts, reject\n                const maxAttemptsReached = attempt >= this._maxAttempts;\n                const errorMessage = maxAttemptsReached\n                    ? `Failed to query address book after ${this._maxAttempts + 1} attempts. Last error: ${message}`\n                    : `Failed to query address book: ${message}`;\n                reject(new Error(errorMessage));\n                return;\n            }\n        }\n\n        // This should never be reached, but just in case\n        reject(new Error(\"failed to query address book\"));\n    }\n\n    /**\n     * Handles the grpc_proxy_endpoint fallback logic for a node.\n     * @param {AddressBookQueryWebResponse['nodes'][number]} node - The node object from the mirror node response.\n     * @param {Client<Channel>} client - The client instance.\n     * @returns {Array<{address: string, port: string}>}\n     */\n    _handleAddressesFromGrpcProxyEndpoint(node, client) {\n        const grpcProxyEndpoint = node.grpc_proxy_endpoint;\n\n        if (\n            grpcProxyEndpoint &&\n            grpcProxyEndpoint.domain_name &&\n            grpcProxyEndpoint.port\n        ) {\n            return [\n                {\n                    address: grpcProxyEndpoint.domain_name,\n                    port: grpcProxyEndpoint.port.toString(),\n                },\n            ];\n        }\n\n        let networkConstant;\n        const ledgerId = client._network.ledgerId;\n\n        if (ledgerId && ledgerId.isMainnet()) {\n            networkConstant = MAINNET;\n        } else if (ledgerId && ledgerId.isTestnet()) {\n            networkConstant = WEB_TESTNET;\n        } else if (ledgerId && ledgerId.isPreviewnet()) {\n            networkConstant = WEB_PREVIEWNET;\n        } else {\n            return [];\n        }\n\n        const nodeAccountId = node.node_account_id;\n\n        for (const [address, accountIdObj] of Object.entries(networkConstant)) {\n            if (accountIdObj.toString() === nodeAccountId) {\n                const [domain_name, port] = address.split(\":\");\n\n                return [\n                    {\n                        address: domain_name,\n                        port,\n                    },\n                ];\n            }\n        }\n\n        return [];\n    }\n}\n"],"names":["AddressBookQueryWeb","Query","constructor","props","super","this","_fileId","fileId","setFileId","_limit","limit","setLimit","_retryHandler","error","Error","code","RST_STREAM","test","details","toString","_addresses","FileId","fromString","clone","setMaxAttempts","attempts","_maxAttempts","setMaxBackoff","backoff","_maxBackoff","execute","client","requestTimeout","_network","size","_timer","Promise","resolve","reject","_makeFetchRequest","port","address","_mirrorNetwork","getNextMirrorNode","baseUrl","includes","url","URL","searchParams","append","attempt","response","fetch","method","headers","Accept","signal","AbortSignal","timeout","undefined","ok","status","nodes","json","map","node","NodeAddress","fromJSON","nodeId","node_id","accountId","node_account_id","addresses","_handleAddressesFromGrpcProxyEndpoint","certHash","node_cert_hash","publicKey","public_key","description","stake","NodeAddressBook","nodeAddresses","console","message","String","isClientShutDown","delay","Math","min","_logger","debug","setTimeout","errorMessage","grpcProxyEndpoint","grpc_proxy_endpoint","domain_name","networkConstant","ledgerId","isMainnet","MAINNET","isTestnet","WEB_TESTNET","isPreviewnet","WEB_PREVIEWNET","nodeAccountId","accountIdObj","Object","entries","split"],"mappings":"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"}

package/lib/network/NetworkVersionInfo.cjs

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _SemanticVersion = _interopRequireDefault(require("./SemanticVersion.cjs"));
+var HieroProto = _interopRequireWildcard(require("@hashgraph/proto"));
+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
+
+/**
+ * Response when the client sends the node CryptoGetVersionInfoQuery.
+ */
+class NetworkVersionInfo {
+  /**
+   * @private
+   * @param {object} props
+   * @param {SemanticVersion} props.protobufVersion
+   * @param {SemanticVersion} props.servicesVersion
+   */
+  constructor(props) {
+    /**
+     * The account ID for which this information applies.
+     *
+     * @readonly
+     */
+    this.protobufVersion = props.protobufVersion;
+
+    /**
+     * The account ID for which this information applies.
+     *
+     * @readonly
+     */
+    this.servicesVersion = props.servicesVersion;
+    Object.freeze(this);
+  }
+
+  /**
+   * @internal
+   * @param {HieroProto.proto.INetworkGetVersionInfoResponse} info
+   * @returns {NetworkVersionInfo}
+   */
+  static _fromProtobuf(info) {
+    return new NetworkVersionInfo({
+      protobufVersion: _SemanticVersion.default._fromProtobuf(/** @type {HieroProto.proto.ISemanticVersion} */
+      info.hapiProtoVersion),
+      servicesVersion: _SemanticVersion.default._fromProtobuf(/** @type {HieroProto.proto.ISemanticVersion} */
+      info.hederaServicesVersion)
+    });
+  }
+
+  /**
+   * @internal
+   * @returns {HieroProto.proto.INetworkGetVersionInfoResponse}
+   */
+  _toProtobuf() {
+    return {
+      hapiProtoVersion: this.protobufVersion._toProtobuf(),
+      hederaServicesVersion: this.servicesVersion._toProtobuf()
+    };
+  }
+
+  /**
+   * @param {Uint8Array} bytes
+   * @returns {NetworkVersionInfo}
+   */
+  static fromBytes(bytes) {
+    return NetworkVersionInfo._fromProtobuf(HieroProto.proto.NetworkGetVersionInfoResponse.decode(bytes));
+  }
+
+  /**
+   * @returns {Uint8Array}
+   */
+  toBytes() {
+    return HieroProto.proto.NetworkGetVersionInfoResponse.encode(this._toProtobuf()).finish();
+  }
+}
+exports.default = NetworkVersionInfo;

package/lib/network/NetworkVersionInfo.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Response when the client sends the node CryptoGetVersionInfoQuery.
+ */
+export default class NetworkVersionInfo {
+    /**
+     * @internal
+     * @param {HieroProto.proto.INetworkGetVersionInfoResponse} info
+     * @returns {NetworkVersionInfo}
+     */
+    static _fromProtobuf(info: HieroProto.proto.INetworkGetVersionInfoResponse): NetworkVersionInfo;
+    /**
+     * @param {Uint8Array} bytes
+     * @returns {NetworkVersionInfo}
+     */
+    static fromBytes(bytes: Uint8Array): NetworkVersionInfo;
+    /**
+     * @private
+     * @param {object} props
+     * @param {SemanticVersion} props.protobufVersion
+     * @param {SemanticVersion} props.servicesVersion
+     */
+    private constructor();
+    /**
+     * The account ID for which this information applies.
+     *
+     * @readonly
+     */
+    readonly protobufVersion: SemanticVersion;
+    /**
+     * The account ID for which this information applies.
+     *
+     * @readonly
+     */
+    readonly servicesVersion: SemanticVersion;
+    /**
+     * @internal
+     * @returns {HieroProto.proto.INetworkGetVersionInfoResponse}
+     */
+    _toProtobuf(): HieroProto.proto.INetworkGetVersionInfoResponse;
+    /**
+     * @returns {Uint8Array}
+     */
+    toBytes(): Uint8Array;
+}
+import SemanticVersion from "./SemanticVersion.js";
+import * as HieroProto from "@hashgraph/proto";

package/lib/network/NetworkVersionInfo.js

@@ -0,0 +1,2 @@
+import o from"./SemanticVersion.js";import*as r from"@hashgraph/proto";class e{constructor(o){this.protobufVersion=o.protobufVersion,this.servicesVersion=o.servicesVersion,Object.freeze(this)}static _fromProtobuf(r){return new e({protobufVersion:o._fromProtobuf(r.hapiProtoVersion),servicesVersion:o._fromProtobuf(r.hederaServicesVersion)})}_toProtobuf(){return{hapiProtoVersion:this.protobufVersion._toProtobuf(),hederaServicesVersion:this.servicesVersion._toProtobuf()}}static fromBytes(o){return e._fromProtobuf(r.proto.NetworkGetVersionInfoResponse.decode(o))}toBytes(){return r.proto.NetworkGetVersionInfoResponse.encode(this._toProtobuf()).finish()}}export{e as default};
+//# sourceMappingURL=NetworkVersionInfo.js.map