@hiero-ledger/sdk 2.70.0

package/lib/native.cjs

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  Client: true,
+  AddressBookQuery: true
+};
+Object.defineProperty(exports, "AddressBookQuery", {
+  enumerable: true,
+  get: function () {
+    return _AddressBookQuery.default;
+  }
+});
+Object.defineProperty(exports, "Client", {
+  enumerable: true,
+  get: function () {
+    return _NativeClient.default;
+  }
+});
+var _exports = require("./exports.cjs");
+Object.keys(_exports).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _exports[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _exports[key];
+    }
+  });
+});
+var _NativeClient = _interopRequireDefault(require("./client/NativeClient.cjs"));
+var _AddressBookQuery = _interopRequireDefault(require("./network/AddressBookQuery.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/lib/native.d.ts

@@ -0,0 +1,3 @@
+export * from "./exports.js";
+export { default as Client } from "./client/NativeClient.js";
+export { default as AddressBookQuery } from "./network/AddressBookQuery.js";

package/lib/native.js

@@ -0,0 +1,2 @@
+export{NetworkName}from"./exports.js";export{default as Client}from"./client/NativeClient.js";export{default as AddressBookQuery}from"./network/AddressBookQuery.js";export{default as Cache}from"./Cache.js";export{default as PrivateKey}from"./PrivateKey.js";export{default as PublicKey}from"./PublicKey.js";export{default as KeyList}from"./KeyList.js";export{default as Key}from"./Key.js";export{default as Mnemonic}from"./Mnemonic.js";export{default as TokenAirdropTransaction}from"./token/TokenAirdropTransaction.js";export{default as TokenClaimAirdropTransaction}from"./token/TokenClaimAirdropTransaction.js";export{default as TokenCancelAirdropTransaction}from"./token/TokenCancelAirdropTransaction.js";export{default as AccountAllowanceAdjustTransaction}from"./account/AccountAllowanceAdjustTransaction.js";export{default as AccountAllowanceApproveTransaction}from"./account/AccountAllowanceApproveTransaction.js";export{default as AccountAllowanceDeleteTransaction}from"./account/AccountAllowanceDeleteTransaction.js";export{default as AccountBalance}from"./account/AccountBalance.js";export{default as AccountBalanceQuery}from"./account/AccountBalanceQuery.js";export{default as AccountCreateTransaction}from"./account/AccountCreateTransaction.js";export{default as AccountDeleteTransaction}from"./account/AccountDeleteTransaction.js";export{default as AccountId}from"./account/AccountId.js";export{default as AccountInfo}from"./account/AccountInfo.js";export{default as AccountInfoFlow}from"./account/AccountInfoFlow.js";export{default as AccountInfoQuery}from"./account/AccountInfoQuery.js";export{default as AccountRecordsQuery}from"./account/AccountRecordsQuery.js";export{default as AccountUpdateTransaction}from"./account/AccountUpdateTransaction.js";export{default as AssessedCustomFee}from"./token/AssessedCustomFee.js";export{default as BatchTransaction}from"./transaction/BatchTransaction.js";export{default as ContractByteCodeQuery}from"./contract/ContractByteCodeQuery.js";export{default as ContractCallQuery}from"./contract/ContractCallQuery.js";export{default as ContractCreateFlow}from"./contract/ContractCreateFlow.js";export{default as ContractCreateTransaction}from"./contract/ContractCreateTransaction.js";export{default as ContractDeleteTransaction}from"./contract/ContractDeleteTransaction.js";export{default as ContractExecuteTransaction}from"./contract/ContractExecuteTransaction.js";export{default as ContractFunctionParameters}from"./contract/ContractFunctionParameters.js";export{default as ContractFunctionResult}from"./contract/ContractFunctionResult.js";export{default as ContractFunctionSelector}from"./contract/ContractFunctionSelector.js";export{default as ContractId}from"./contract/ContractId.js";export{default as ContractInfo}from"./contract/ContractInfo.js";export{default as ContractInfoQuery}from"./contract/ContractInfoQuery.js";export{default as ContractLogInfo}from"./contract/ContractLogInfo.js";export{default as ContractNonceInfo}from"./contract/ContractNonceInfo.js";export{default as ContractUpdateTransaction}from"./contract/ContractUpdateTransaction.js";export{default as CustomFee}from"./token/CustomFee.js";export{default as CustomFixedFee}from"./token/CustomFixedFee.js";export{default as CustomFractionalFee}from"./token/CustomFractionalFee.js";export{default as CustomRoyaltyFee}from"./token/CustomRoyaltyFee.js";export{default as DelegateContractId}from"./contract/DelegateContractId.js";export{default as EthereumTransaction}from"./EthereumTransaction.js";export{default as EthereumTransactionDataLegacy}from"./EthereumTransactionDataLegacy.js";export{default as EthereumTransactionDataEip1559}from"./EthereumTransactionDataEip1559.js";export{default as EthereumTransactionDataEip2930}from"./EthereumTransactionDataEip2930.js";export{default as EthereumTransactionData}from"./EthereumTransactionData.js";export{default as EthereumFlow}from"./EthereumFlow.js";export{default as EvmAddress}from"./EvmAddress.js";export{default as ExchangeRate}from"./ExchangeRate.js";export{default as ExchangeRates}from"./ExchangeRates.js";export{default as Executable}from"./Executable.js";export{default as FeeAssessmentMethod}from"./token/FeeAssessmentMethod.js";export{default as FeeComponents}from"./FeeComponents.js";export{default as FeeData}from"./FeeData.js";export{default as FeeDataType}from"./FeeDataType.js";export{default as FeeSchedule}from"./FeeSchedule.js";export{default as FeeSchedules}from"./FeeSchedules.js";export{default as FileAppendTransaction}from"./file/FileAppendTransaction.js";export{default as FileContentsQuery}from"./file/FileContentsQuery.js";export{default as FileCreateTransaction}from"./file/FileCreateTransaction.js";export{default as FileDeleteTransaction}from"./file/FileDeleteTransaction.js";export{default as FileId}from"./file/FileId.js";export{default as FileInfo}from"./file/FileInfo.js";export{default as FileInfoQuery}from"./file/FileInfoQuery.js";export{default as FileUpdateTransaction}from"./file/FileUpdateTransaction.js";export{default as FreezeTransaction}from"./system/FreezeTransaction.js";export{default as Hbar}from"./Hbar.js";export{default as HbarAllowance}from"./account/HbarAllowance.js";export{default as HbarUnit}from"./HbarUnit.js";export{default as LiveHash}from"./account/LiveHash.js";export{default as LiveHashAddTransaction}from"./account/LiveHashAddTransaction.js";export{default as LiveHashDeleteTransaction}from"./account/LiveHashDeleteTransaction.js";export{default as LiveHashQuery}from"./account/LiveHashQuery.js";export{default as MaxQueryPaymentExceeded}from"./MaxQueryPaymentExceeded.js";export{default as MirrorNodeContractCallQuery}from"./query/MirrorNodeContractCallQuery.js";export{default as MirrorNodeContractEstimateQuery}from"./query/MirrorNodeContractEstimateQuery.js";export{default as NodeAddressBook}from"./address_book/NodeAddressBook.js";export{default as NetworkVersionInfo}from"./network/NetworkVersionInfo.js";export{default as NetworkVersionInfoQuery}from"./network/NetworkVersionInfoQuery.js";export{default as NftId}from"./token/NftId.js";export{default as PendingAirdropId}from"./token/PendingAirdropId.js";export{default as PrngTransaction}from"./PrngTransaction.js";export{default as ProxyStaker}from"./account/ProxyStaker.js";export{default as Query}from"./query/Query.js";export{default as RequestType}from"./RequestType.js";export{default as ScheduleCreateTransaction}from"./schedule/ScheduleCreateTransaction.js";export{default as ScheduleDeleteTransaction}from"./schedule/ScheduleDeleteTransaction.js";export{default as ScheduleId}from"./schedule/ScheduleId.js";export{default as ScheduleInfo}from"./schedule/ScheduleInfo.js";export{default as ScheduleInfoQuery}from"./schedule/ScheduleInfoQuery.js";export{default as ScheduleSignTransaction}from"./schedule/ScheduleSignTransaction.js";export{default as SemanticVersion}from"./network/SemanticVersion.js";export{default as SignatureMap}from"./transaction/SignatureMap.js";export{default as SignerSignature}from"./SignerSignature.js";export{default as Status}from"./Status.js";export{default as SubscriptionHandle}from"./topic/SubscriptionHandle.js";export{default as SystemDeleteTransaction}from"./system/SystemDeleteTransaction.js";export{default as SystemUndeleteTransaction}from"./system/SystemUndeleteTransaction.js";export{default as Timestamp}from"./Timestamp.js";export{default as TokenAllowance}from"./account/TokenAllowance.js";export{default as TokenAssociateTransaction}from"./token/TokenAssociateTransaction.js";export{default as TokenBurnTransaction}from"./token/TokenBurnTransaction.js";export{default as TokenRejectTransaction}from"./token/TokenRejectTransaction.js";export{default as TokenRejectFlow}from"./token/TokenRejectFlow.js";export{default as TokenCreateTransaction}from"./token/TokenCreateTransaction.js";export{default as TokenDeleteTransaction}from"./token/TokenDeleteTransaction.js";export{default as TokenDissociateTransaction}from"./token/TokenDissociateTransaction.js";export{default as TokenFeeScheduleUpdateTransaction}from"./token/TokenFeeScheduleUpdateTransaction.js";export{default as TokenFreezeTransaction}from"./token/TokenFreezeTransaction.js";export{default as TokenGrantKycTransaction}from"./token/TokenGrantKycTransaction.js";export{default as TokenId}from"./token/TokenId.js";export{default as TokenInfo}from"./token/TokenInfo.js";export{default as TokenInfoQuery}from"./token/TokenInfoQuery.js";export{default as TokenMintTransaction}from"./token/TokenMintTransaction.js";export{default as TokenNftAllowance}from"./account/TokenNftAllowance.js";export{default as TokenNftInfo}from"./token/TokenNftInfo.js";export{default as TokenNftInfoQuery}from"./token/TokenNftInfoQuery.js";export{default as TokenPauseTransaction}from"./token/TokenPauseTransaction.js";export{default as TokenRevokeKycTransaction}from"./token/TokenRevokeKycTransaction.js";export{default as TokenSupplyType}from"./token/TokenSupplyType.js";export{default as TokenType}from"./token/TokenType.js";export{default as TokenUnfreezeTransaction}from"./token/TokenUnfreezeTransaction.js";export{default as TokenUnpauseTransaction}from"./token/TokenUnpauseTransaction.js";export{default as TokenUpdateTransaction}from"./token/TokenUpdateTransaction.js";export{default as TokenWipeTransaction}from"./token/TokenWipeTransaction.js";export{default as TopicCreateTransaction}from"./topic/TopicCreateTransaction.js";export{default as TopicDeleteTransaction}from"./topic/TopicDeleteTransaction.js";export{default as TopicId}from"./topic/TopicId.js";export{default as TopicInfo}from"./topic/TopicInfo.js";export{default as TopicInfoQuery}from"./topic/TopicInfoQuery.js";export{default as TopicMessage}from"./topic/TopicMessage.js";export{default as TopicMessageChunk}from"./topic/TopicMessageChunk.js";export{default as TopicMessageQuery}from"./topic/TopicMessageQuery.js";export{default as TopicMessageSubmitTransaction}from"./topic/TopicMessageSubmitTransaction.js";export{default as TopicUpdateTransaction}from"./topic/TopicUpdateTransaction.js";export{default as CustomFeeLimit}from"./transaction/CustomFeeLimit.js";export{default as Transaction}from"./transaction/Transaction.js";export{default as TransactionFeeSchedule}from"./TransactionFeeSchedule.js";export{default as TransactionId}from"./transaction/TransactionId.js";export{default as TransactionReceipt}from"./transaction/TransactionReceipt.js";export{default as TransactionReceiptQuery}from"./transaction/TransactionReceiptQuery.js";export{default as TransactionRecord}from"./transaction/TransactionRecord.js";export{default as TransactionRecordQuery}from"./transaction/TransactionRecordQuery.js";export{default as TransactionResponse}from"./transaction/TransactionResponse.js";export{default as Transfer}from"./Transfer.js";export{default as TransferTransaction}from"./account/TransferTransaction.js";export{default as Wallet}from"./Wallet.js";export{default as Logger}from"./logger/Logger.js";export{default as LogLevel}from"./logger/LogLevel.js";export{default as FreezeType}from"./FreezeType.js";export{default as TokenKeyValidation}from"./token/TokenKeyValidation.js";export{default as StatusError}from"./StatusError.js";export{default as MaxAttemptsOrTimeoutError}from"./MaxAttemptsOrTimeoutError.js";export{default as PrecheckStatusError}from"./PrecheckStatusError.js";export{default as ReceiptStatusError}from"./ReceiptStatusError.js";export{default as LedgerId}from"./LedgerId.js";export{default as TokenUpdateNftsTransaction}from"./token/TokenUpdateNftsTransaction.js";export{default as NodeCreateTransaction}from"./node/NodeCreateTransaction.js";export{default as ServiceEndpoint}from"./node/ServiceEndpoint.js";export{default as NodeDeleteTransaction}from"./node/NodeDeleteTransaction.js";export{default as NodeUpdateTransaction}from"./node/NodeUpdateTransaction.js";export{default as WebClient}from"./client/WebClient.js";export{BadKeyError,BadMnemonicError,BadMnemonicReason,HEDERA_PATH,SLIP44_ECDSA_ETH_PATH,SLIP44_ECDSA_HEDERA_PATH}from"@hashgraph/cryptography";export{default as Provider}from"./Provider.js";export{default as Signer}from"./Signer.js";export{default as Long}from"long";import*as e from"./EntityIdHelper.js";export{e as EntityIdHelper};
+//# sourceMappingURL=native.js.map

package/lib/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/network/AddressBookQuery.cjs

@@ -0,0 +1,218 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _Query = _interopRequireDefault(require("../query/Query.cjs"));
+var _NodeAddress = _interopRequireDefault(require("../address_book/NodeAddress.cjs"));
+var _NodeAddressBook = _interopRequireDefault(require("../address_book/NodeAddressBook.cjs"));
+var HieroProto = _interopRequireWildcard(require("@hashgraph/proto"));
+var _FileId = _interopRequireDefault(require("../file/FileId.cjs"));
+var _Executable = require("../Executable.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
+
+/**
+ * @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>
+ */
+
+/**
+ * Query to get a list of Hedera network node addresses from a mirror node.
+ *
+ * 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 AddressBookQuery 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);
+    }
+
+    /**
+     * @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/2 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 = [];
+
+    /**
+     * @private
+     * @type {number}
+     */
+    this._attempt = 0;
+  }
+
+  /**
+   * @returns {?FileId}
+   */
+  get fileId() {
+    return this._fileId;
+  }
+
+  /**
+   * @param {FileId | string} fileId
+   * @returns {AddressBookQuery}
+   */
+  setFileId(fileId) {
+    this._fileId = typeof fileId === "string" ? _FileId.default.fromString(fileId) : fileId.clone();
+    return this;
+  }
+
+  /**
+   * @returns {?number}
+   */
+  get limit() {
+    return this._limit;
+  }
+
+  /**
+   * @param {number} limit
+   * @returns {AddressBookQuery}
+   */
+  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) => {
+      this._makeServerStreamRequest(client, /** @type {(value: NodeAddressBook) => void} */resolve, reject, requestTimeout);
+    });
+  }
+
+  /**
+   * @private
+   * @param {Client<Channel>} client
+   * @param {(value: NodeAddressBook) => void} resolve
+   * @param {(error: Error) => void} reject
+   * @param {number=} requestTimeout
+   */
+  _makeServerStreamRequest(client, resolve, reject, requestTimeout) {
+    const request = HieroProto.com.hedera.mirror.api.proto.AddressBookQuery.encode({
+      fileId: this._fileId != null ? this._fileId._toProtobuf() : null,
+      limit: this._limit
+    }).finish();
+    client._mirrorNetwork.getNextMirrorNode().getChannel().makeServerStreamRequest("NetworkService", "getNodes", request, data => {
+      this._addresses.push(_NodeAddress.default._fromProtobuf(HieroProto.proto.NodeAddress.decode(data)));
+      if (this._limit != null && this._limit > 0) {
+        this._limit = this._limit - 1;
+      }
+    }, error => {
+      const message = error instanceof Error ? error.message : error.details;
+      if (this._attempt < this._maxAttempts && !client.isClientShutDown && this._retryHandler(error)) {
+        const delay = Math.min(250 * 2 ** this._attempt, this._maxBackoff);
+        if (this._attempt >= this._maxAttempts) {
+          console.warn(`Error getting nodes from mirror for file ${this._fileId != null ? this._fileId.toString() : "UNKNOWN"} during attempt ${this._attempt}. Waiting ${delay} ms before next attempt: ${message}`);
+        }
+        if (this._logger) {
+          this._logger.debug(`Error getting nodes from mirror for file ${this._fileId != null ? this._fileId.toString() : "UNKNOWN"} during attempt ${this._attempt}. Waiting ${delay} ms before next attempt: ${message}`);
+        }
+        this._attempt += 1;
+        setTimeout(() => {
+          this._makeServerStreamRequest(client, resolve, reject, requestTimeout);
+        }, delay);
+      } else {
+        reject(new Error("failed to query address book"));
+      }
+    }, () => {
+      resolve(new _NodeAddressBook.default({
+        nodeAddresses: this._addresses
+      }));
+    });
+  }
+}
+exports.default = AddressBookQuery;

package/lib/network/AddressBookQuery.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @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>
+ */
+/**
+ * Query to get a list of Hedera network node addresses from a mirror node.
+ *
+ * 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 AddressBookQuery 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;
+    /**
+     * @private
+     * @type {?number}
+     */
+    private _limit;
+    /**
+     * @private
+     * @type {(error: MirrorError | Error | null) => boolean}
+     */
+    private _retryHandler;
+    /** @type {NodeAddress[]} */
+    _addresses: NodeAddress[];
+    /**
+     * @private
+     * @type {number}
+     */
+    private _attempt;
+    /**
+     * @returns {?FileId}
+     */
+    get fileId(): FileId | null;
+    /**
+     * @param {FileId | string} fileId
+     * @returns {AddressBookQuery}
+     */
+    setFileId(fileId: FileId | string): AddressBookQuery;
+    /**
+     * @returns {?number}
+     */
+    get limit(): number | null;
+    /**
+     * @param {number} limit
+     * @returns {AddressBookQuery}
+     */
+    setLimit(limit: number): AddressBookQuery;
+    /**
+     * @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 _makeServerStreamRequest;
+}
+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>;
+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/AddressBookQuery.js

@@ -0,0 +1,2 @@
+import t from"../query/Query.js";import e from"../address_book/NodeAddress.js";import r from"../address_book/NodeAddressBook.js";import*as i from"@hashgraph/proto";import s from"../file/FileId.js";import{RST_STREAM as o}from"../Executable.js";class m 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 o.test(t.details.toString());case 5:case 8:case 14:case 17:return!0;default:return!1}}return!1},this._addresses=[],this._attempt=0}get fileId(){return this._fileId}setFileId(t){return this._fileId="string"==typeof t?s.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,i)=>{this._makeServerStreamRequest(t,r,i,e)}))}_makeServerStreamRequest(t,s,o,m){const l=i.com.hedera.mirror.api.proto.AddressBookQuery.encode({fileId:null!=this._fileId?this._fileId._toProtobuf():null,limit:this._limit}).finish();t._mirrorNetwork.getNextMirrorNode().getChannel().makeServerStreamRequest("NetworkService","getNodes",l,(t=>{this._addresses.push(e._fromProtobuf(i.proto.NodeAddress.decode(t))),null!=this._limit&&this._limit>0&&(this._limit=this._limit-1)}),(e=>{const r=e instanceof Error?e.message:e.details;if(this._attempt<this._maxAttempts&&!t.isClientShutDown&&this._retryHandler(e)){const e=Math.min(250*2**this._attempt,this._maxBackoff);this._attempt>=this._maxAttempts&&console.warn(`Error getting nodes from mirror for file ${null!=this._fileId?this._fileId.toString():"UNKNOWN"} during attempt ${this._attempt}. Waiting ${e} ms before next attempt: ${r}`),this._logger&&this._logger.debug(`Error getting nodes from mirror for file ${null!=this._fileId?this._fileId.toString():"UNKNOWN"} during attempt ${this._attempt}. Waiting ${e} ms before next attempt: ${r}`),this._attempt+=1,setTimeout((()=>{this._makeServerStreamRequest(t,s,o,m)}),e)}else o(new Error("failed to query address book"))}),(()=>{s(new r({nodeAddresses:this._addresses}))}))}}export{m as default};
+//# sourceMappingURL=AddressBookQuery.js.map

package/lib/network/AddressBookQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddressBookQuery.js","sources":["../../src/network/AddressBookQuery.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Query from \"../query/Query.js\";\nimport NodeAddress from \"../address_book/NodeAddress.js\";\nimport NodeAddressBook from \"../address_book/NodeAddressBook.js\";\nimport * as HieroProto from \"@hashgraph/proto\";\nimport FileId from \"../file/FileId.js\";\nimport { RST_STREAM } from \"../Executable.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 * Query to get a list of Hedera network node addresses from a mirror node.\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 AddressBookQuery 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         * @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/2 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         * @private\n         * @type {number}\n         */\n        this._attempt = 0;\n    }\n\n    /**\n     * @returns {?FileId}\n     */\n    get fileId() {\n        return this._fileId;\n    }\n\n    /**\n     * @param {FileId | string} fileId\n     * @returns {AddressBookQuery}\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     * @returns {?number}\n     */\n    get limit() {\n        return this._limit;\n    }\n\n    /**\n     * @param {number} limit\n     * @returns {AddressBookQuery}\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            this._makeServerStreamRequest(\n                client,\n                /** @type {(value: NodeAddressBook) => void} */ (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    _makeServerStreamRequest(client, resolve, reject, requestTimeout) {\n        const request =\n            HieroProto.com.hedera.mirror.api.proto.AddressBookQuery.encode({\n                fileId:\n                    this._fileId != null ? this._fileId._toProtobuf() : null,\n                limit: this._limit,\n            }).finish();\n\n        client._mirrorNetwork\n            .getNextMirrorNode()\n            .getChannel()\n            .makeServerStreamRequest(\n                \"NetworkService\",\n                \"getNodes\",\n                request,\n                (data) => {\n                    this._addresses.push(\n                        NodeAddress._fromProtobuf(\n                            HieroProto.proto.NodeAddress.decode(data),\n                        ),\n                    );\n\n                    if (this._limit != null && this._limit > 0) {\n                        this._limit = this._limit - 1;\n                    }\n                },\n                (error) => {\n                    const message =\n                        error instanceof Error ? error.message : error.details;\n                    if (\n                        this._attempt < this._maxAttempts &&\n                        !client.isClientShutDown &&\n                        this._retryHandler(error)\n                    ) {\n                        const delay = Math.min(\n                            250 * 2 ** this._attempt,\n                            this._maxBackoff,\n                        );\n                        if (this._attempt >= this._maxAttempts) {\n                            console.warn(\n                                `Error getting nodes from mirror for file ${\n                                    this._fileId != null\n                                        ? this._fileId.toString()\n                                        : \"UNKNOWN\"\n                                } during attempt ${\n                                    this._attempt\n                                }. Waiting ${delay} ms before next attempt: ${message}`,\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                                    this._attempt\n                                }. Waiting ${delay} ms before next attempt: ${message}`,\n                            );\n                        }\n\n                        this._attempt += 1;\n\n                        setTimeout(() => {\n                            this._makeServerStreamRequest(\n                                client,\n                                resolve,\n                                reject,\n                                requestTimeout,\n                            );\n                        }, delay);\n                    } else {\n                        reject(new Error(\"failed to query address book\"));\n                    }\n                },\n                () => {\n                    resolve(\n                        new NodeAddressBook({ nodeAddresses: this._addresses }),\n                    );\n                },\n            );\n    }\n}\n"],"names":["AddressBookQuery","Query","constructor","props","super","this","_fileId","fileId","setFileId","_limit","limit","setLimit","_retryHandler","error","Error","code","RST_STREAM","test","details","toString","_addresses","_attempt","FileId","fromString","clone","setMaxAttempts","attempts","_maxAttempts","setMaxBackoff","backoff","_maxBackoff","execute","client","requestTimeout","_network","size","_timer","Promise","resolve","reject","_makeServerStreamRequest","request","HieroProto","com","hedera","mirror","api","proto","encode","_toProtobuf","finish","_mirrorNetwork","getNextMirrorNode","getChannel","makeServerStreamRequest","data","push","NodeAddress","_fromProtobuf","decode","message","isClientShutDown","delay","Math","min","console","warn","_logger","debug","setTimeout","NodeAddressBook","nodeAddresses"],"mappings":"mPA6Be,MAAMA,UAAyBC,EAM1C,WAAAC,CAAYC,EAAQ,IAChBC,QAMAC,KAAKC,QAAU,KACK,MAAhBH,EAAMI,QACNF,KAAKG,UAAUL,EAAMI,QAOzBF,KAAKI,OAAS,KACK,MAAfN,EAAMO,OACNL,KAAKM,SAASR,EAAMO,OAOxBL,KAAKO,cAAiBC,IAClB,GAAa,MAATA,EAAe,CACf,GAAIA,aAAiBC,MAGjB,OAAO,EAIP,OAAQD,EAAME,MAGV,KAAK,GACD,OAAOC,EAAWC,KAAKJ,EAAMK,QAAQC,YAGzC,KAAK,EAGL,KAAK,EAGL,KAAK,GACL,KAAK,GACD,OAAO,EACX,QACI,OAAO,EAGnC,CAEY,OAAO,CAAK,EAIhBd,KAAKe,WAAa,GAMlBf,KAAKgB,SAAW,CACxB,CAKI,UAAId,GACA,OAAOF,KAAKC,OACpB,CAMI,SAAAE,CAAUD,GAMN,OALAF,KAAKC,QACiB,iBAAXC,EACDe,EAAOC,WAAWhB,GAClBA,EAAOiB,QAEVnB,IACf,CAKI,SAAIK,GACA,OAAOL,KAAKI,MACpB,CAMI,QAAAE,CAASD,GAGL,OAFAL,KAAKI,OAASC,EAEPL,IACf,CAMI,cAAAoB,CAAeC,GAEX,OADArB,KAAKsB,aAAeD,EACbrB,IACf,CAMI,aAAAuB,CAAcC,GAEV,OADAxB,KAAKyB,YAAcD,EACZxB,IACf,CAOI,OAAA0B,CAAQC,EAAQC,GAEZ,GAAsC,IAAlCD,EAAOE,SAASA,SAASC,OAAeH,EAAOI,OAC/C,MAAM,IAAItB,MACN,0GAIR,OAAO,IAAIuB,SAAQ,CAACC,EAASC,KACzBlC,KAAKmC,yBACDR,EAChB,EACgBO,EACAN,EACH,GAEb,CASI,wBAAAO,CAAyBR,EAAQM,EAASC,EAAQN,GAC9C,MAAMQ,EACFC,EAAWC,IAAIC,OAAOC,OAAOC,IAAIC,MAAM/C,iBAAiBgD,OAAO,CAC3DzC,OACoB,MAAhBF,KAAKC,QAAkBD,KAAKC,QAAQ2C,cAAgB,KACxDvC,MAAOL,KAAKI,SACbyC,SAEPlB,EAAOmB,eACFC,oBACAC,aACAC,wBACG,iBACA,WACAb,GACCc,IACGlD,KAAKe,WAAWoC,KACZC,EAAYC,cACRhB,EAAWK,MAAMU,YAAYE,OAAOJ,KAIzB,MAAflD,KAAKI,QAAkBJ,KAAKI,OAAS,IACrCJ,KAAKI,OAASJ,KAAKI,OAAS,EACpD,IAEiBI,IACG,MAAM+C,EACF/C,aAAiBC,MAAQD,EAAM+C,QAAU/C,EAAMK,QACnD,GACIb,KAAKgB,SAAWhB,KAAKsB,eACpBK,EAAO6B,kBACRxD,KAAKO,cAAcC,GACrB,CACE,MAAMiD,EAAQC,KAAKC,IACf,IAAM,GAAK3D,KAAKgB,SAChBhB,KAAKyB,aAELzB,KAAKgB,UAAYhB,KAAKsB,cACtBsC,QAAQC,KACJ,4CACoB,MAAhB7D,KAAKC,QACCD,KAAKC,QAAQa,WACb,4BAENd,KAAKgB,qBACIyC,6BAAiCF,KAGlDvD,KAAK8D,SACL9D,KAAK8D,QAAQC,MACT,4CACoB,MAAhB/D,KAAKC,QACCD,KAAKC,QAAQa,WACb,4BAENd,KAAKgB,qBACIyC,6BAAiCF,KAItDvD,KAAKgB,UAAY,EAEjBgD,YAAW,KACPhE,KAAKmC,yBACDR,EACAM,EACAC,EACAN,EACH,GACF6B,EAC3B,MACwBvB,EAAO,IAAIzB,MAAM,gCACzC,IAEgB,KACIwB,EACI,IAAIgC,EAAgB,CAAEC,cAAelE,KAAKe,aAC7C,GAGrB"}