@hiero-ledger/sdk 2.73.2 → 2.75.0

package/dist/umd.js

@@ -4758,6 +4758,32 @@
       throw new Error(FUNCTION_CONVERT_TO_BIGNUMBER_ERROR);
   }
 
+  /**
+   * Converts amount (number, Long, BigNumber, or bigint) to Long.
+   * This utility ensures consistent amount handling across the SDK.
+   *
+   * @param {number | Long | BigNumber | bigint} amount
+   * @returns {Long}
+   */
+  function convertAmountToLong(amount) {
+      requireNonNull(amount);
+
+      // Preserve exact original behavior for existing types
+      if (Long.isLong(amount)) {
+          return amount;
+      } else if (typeof amount === "number") {
+          return Long.fromNumber(amount);
+      } else if (BigNumber$1.isBigNumber(amount)) {
+          return Long.fromValue(
+              amount.integerValue(BigNumber$1.ROUND_DOWN).toString(),
+          );
+      } else if (typeof amount === "bigint") {
+          return Long.fromValue(amount.toString());
+      } else {
+          // Handle other types that can be converted to string
+          return Long.fromValue(String(amount));
+      }
+  }
   /**
    * Converts Array of Numbers or Strings to Array of BigNumbers.
    *
@@ -45006,18 +45032,10 @@
        * @returns {Promise<ContractId>}
        */
       async populateAccountNum(client) {
-          if (this.evmAddress === null) {
-              throw new Error("field `evmAddress` should not be null");
-          }
-          const mirrorUrl = client.mirrorNetwork[0].slice(
-              0,
-              client.mirrorNetwork[0].indexOf(":"),
-          );
+          const mirrorRestApiBaseUrl = client.mirrorRestApiBaseUrl;
+          const url = `${mirrorRestApiBaseUrl}/contracts/${this.toEvmAddress()}`;
 
           /* eslint-disable */
-          const url = `https://${mirrorUrl}/api/v1/contracts/${encode$5(
-            this.evmAddress,
-        )}`;
           const response = await fetch(url);
           const data = await response.json();
           const mirrorAccountId = data.contract_id;
@@ -54097,6 +54115,10 @@
    * @typedef {import("@hashgraph/proto").proto.IAccountID} HieroProto.proto.IAccountID
    */
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   /**
    * @augments {ObjectMap<TokenId, TokenTransferAccountMap>}
    */
@@ -54109,7 +54131,7 @@
        * @internal
        * @param {TokenId} tokenId
        * @param {AccountId} accountId
-       * @param {Long} amount
+       * @param {Long | number | BigNumber | bigint} amount
        */
       __set(tokenId, accountId, amount) {
           const token = tokenId.toString();
@@ -54121,7 +54143,7 @@
               this.__map.set(tokenId, _map);
           }
 
-          _map._set(accountId, amount);
+          _map._set(accountId, convertAmountToLong(amount));
       }
 
       /**
@@ -54316,6 +54338,10 @@
   // SPDX-License-Identifier: Apache-2.0
 
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   /**
    * @namespace proto
    * @typedef {import("@hashgraph/proto").proto.IAssessedCustomFee} HieroProto.proto.IAssessedCustomFee
@@ -54339,7 +54365,7 @@
        * @param {object} props
        * @param {AccountId | string} [props.feeCollectorAccountId]
        * @param {TokenId | string} [props.tokenId]
-       * @param {Long | number} [props.amount]
+       * @param {Long | number | BigNumber | bigint} [props.amount]
        * @param {AccountId[]} [props.payerAccountIds]
        */
       constructor(props = {}) {
@@ -54424,12 +54450,11 @@
       }
 
       /**
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {AssessedCustomFee}
        */
       setAmount(amount) {
-          this._amount =
-              typeof amount === "number" ? Long.fromNumber(amount) : amount;
+          this._amount = convertAmountToLong(amount);
           return this;
       }
 
@@ -54668,7 +54693,7 @@
        * @param {TokenId | string} props.tokenId
        * @param {AccountId | string} props.accountId
        * @param {number | null} props.expectedDecimals
-       * @param {Long | number} props.amount
+       * @param {Long | number | BigNumber | bigint} props.amount
        * @param {boolean} props.isApproved
        */
       constructor(props) {
@@ -54693,7 +54718,7 @@
                   : AccountId.fromString(props.accountId);
 
           this.expectedDecimals = props.expectedDecimals;
-          this.amount = Long.fromValue(props.amount);
+          this.amount = convertAmountToLong(props.amount);
           this.isApproved = props.isApproved;
       }
 
@@ -55029,15 +55054,19 @@
    */
 
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   class PendingAirdropRecord {
       /**
        * @param {object} props
        * @param {PendingAirdropId} props.airdropId
-       * @param {Long} props.amount
+       * @param {Long | number | BigNumber | bigint} props.amount
        */
       constructor(props) {
           this.airdropId = props.airdropId;
-          this.amount = props.amount;
+          this.amount = convertAmountToLong(props.amount);
       }
 
       /**
@@ -56648,6 +56677,10 @@
   // SPDX-License-Identifier: Apache-2.0
 
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   /**
    * @namespace proto
    * @typedef {import("@hashgraph/proto").proto.ICustomFee} HieroProto.proto.ICustomFee
@@ -56661,7 +56694,7 @@
        * @param {AccountId | string} [props.feeCollectorAccountId]
        * @param {boolean} [props.allCollectorsAreExempt]
        * @param {TokenId | string} [props.denominatingTokenId]
-       * @param {Long | number} [props.amount]
+       * @param {Long | number | BigNumber | bigint} [props.amount]
        */
       constructor(props = {}) {
           super(props);
@@ -56739,12 +56772,11 @@
       }
 
       /**
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {CustomFixedFee}
        */
       setAmount(amount) {
-          this._amount =
-              typeof amount === "number" ? Long.fromNumber(amount) : amount;
+          this._amount = convertAmountToLong(amount);
           return this;
       }
 
@@ -58251,6 +58283,65 @@
           );
       }
 
+      /**
+       * Apply maxNodesPerTransaction limit to an already frozen transaction.
+       * This trims the node list to the first N nodes while preserving existing signatures.
+       *
+       * Note: This method assumes the caller has already verified that trimming is needed.
+       *
+       * @private
+       * @param {import("../client/Client.js").default<Channel, *>} client
+       */
+      _applyMaxNodesPerTransactionLimit(client) {
+          const maxNodes = client.maxNodesPerTransaction;
+
+          if (maxNodes <= 0 || this._nodeAccountIds.length <= maxNodes) {
+              return;
+          }
+
+          if (this._logger) {
+              this._logger.debug(
+                  `Trimming frozen transaction from ${this._nodeAccountIds.length} nodes to ${maxNodes} nodes based on maxNodesPerTransaction setting`,
+              );
+          }
+
+          // Trim the node account IDs to the first N nodes
+          const trimmedNodeIds = this._nodeAccountIds.list.slice(0, maxNodes);
+
+          // Trim the signed transactions to match the trimmed node list
+          // Each chunk has transactions for all nodes, so we need to trim each chunk
+          const nodeCount = this._nodeAccountIds.length;
+          const chunkCount = this._transactionIds.length;
+          const trimmedSignedTransactions = [];
+
+          for (let chunkIndex = 0; chunkIndex < chunkCount; chunkIndex++) {
+              const chunkStart = chunkIndex * nodeCount;
+
+              // Add the first maxNodes transactions from this chunk
+              for (let nodeIndex = 0; nodeIndex < maxNodes; nodeIndex++) {
+                  const transactionIndex = chunkStart + nodeIndex;
+                  if (transactionIndex < this._signedTransactions.length) {
+                      trimmedSignedTransactions.push(
+                          this._signedTransactions.get(transactionIndex),
+                      );
+                  }
+              }
+          }
+
+          // Clear and rebuild the transactions list since it's derived from signed transactions
+          this._transactions.clear();
+
+          // Update the node account IDs (we need to unlock, update, and relock)
+          this._nodeAccountIds.locked = false;
+
+          this._nodeAccountIds.setList(trimmedNodeIds);
+
+          this._nodeAccountIds.locked = true;
+
+          // Update the signed transactions
+          this._signedTransactions.setList(trimmedSignedTransactions);
+      }
+
       /**
        * @description Set the key that will sign the batch of which this Transaction is a part of.
        * @param {Key} batchKey
@@ -58627,6 +58718,10 @@
               this.freezeWith(client);
           }
 
+          // Apply maxNodesPerTransaction limit to already frozen transaction
+          // This allows changing the node count even after freezing while preserving signatures
+          this._applyMaxNodesPerTransactionLimit(client);
+
           // Valid checksums if the option is enabled
           if (client.isAutoValidateChecksumsEnabled()) {
               this._validateChecksums(client);
@@ -59393,6 +59488,10 @@
 
   // SPDX-License-Identifier: Apache-2.0
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   /**
    * @namespace proto
    * @typedef {import("@hashgraph/proto").proto.ITokenAirdropTransactionBody} HieroProto.proto.ITokenAirdropTransactionBody
@@ -59402,7 +59501,7 @@
    * @typedef {object} TransferTokensInput
    * @property {TokenId | string} tokenId
    * @property {AccountId | string} accountId
-   * @property {Long | number} amount
+   * @property {Long | number | BigNumber | bigint} amount
    */
 
   /**
@@ -59481,7 +59580,7 @@
       /**
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} accountId
-       * @param {number | Long} amount
+       * @param {number | Long | BigNumber | bigint} amount
        * @param {boolean} isApproved
        * @param {number | null} expectedDecimals
        * @returns {this}
@@ -59501,7 +59600,7 @@
               accountId instanceof AccountId
                   ? accountId
                   : AccountId.fromString(accountId);
-          const value = amount instanceof Long ? amount : Long.fromNumber(amount);
+          const value = convertAmountToLong(amount);
 
           for (const tokenTransfer of this._tokenTransfers) {
               if (
@@ -59530,7 +59629,7 @@
       /**
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} accountId
-       * @param {number | Long} amount
+       * @param {number | Long | BigNumber | bigint} amount
        * @returns {this}
        */
       addTokenTransfer(tokenId, accountId, amount) {
@@ -59672,7 +59771,7 @@
       /**
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} accountId
-       * @param {number | Long} amount
+       * @param {number | Long | BigNumber | bigint} amount
        * @returns {this}
        */
       addApprovedTokenTransfer(tokenId, accountId, amount) {
@@ -59682,7 +59781,7 @@
       /**
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} accountId
-       * @param {number | Long} amount
+       * @param {number | Long | BigNumber | bigint} amount
        * @param {number} decimals
        * @returns {this}
        */
@@ -59695,7 +59794,7 @@
               accountId instanceof AccountId
                   ? accountId
                   : AccountId.fromString(accountId);
-          const value = amount instanceof Long ? amount : Long.fromNumber(amount);
+          const value = convertAmountToLong(amount);
 
           let found = false;
 
@@ -59990,6 +60089,7 @@
    * @typedef {import("../account/AccountId.js").default} AccountId
    * @typedef {import("./NftId.js").default} NftId
    * @typedef {import("./TokenId.js").default} TokenId
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -60085,7 +60185,7 @@
        *
        * @param {TokenId} tokenId
        * @param {AccountId} accountId
-       * @param {Long} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @param {number} expectedDecimals
        * @returns {this}
        */
@@ -60636,6 +60736,7 @@
 
   /**
    * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -60652,7 +60753,7 @@
        * @param {TokenId} props.tokenId
        * @param {AccountId | null} props.spenderAccountId
        * @param {AccountId | null} props.ownerAccountId
-       * @param {Long | null} props.amount
+       * @param {Long | number | BigNumber | bigint | null} props.amount
        */
       constructor(props) {
           /**
@@ -60683,7 +60784,8 @@
            *
            * @readonly
            */
-          this.amount = props.amount;
+          this.amount =
+              props.amount != null ? convertAmountToLong(props.amount) : null;
 
           Object.freeze(this);
       }
@@ -61700,12 +61802,15 @@
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} ownerAccountId
        * @param {AccountId | ContractId | string} spenderAccountId
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {AccountAllowanceApproveTransaction}
        */
       approveTokenAllowance(tokenId, ownerAccountId, spenderAccountId, amount) {
           this._requireNotFrozen();
 
+          // Convert amount to Long
+          const amountLong = convertAmountToLong(amount);
+
           this._tokenApprovals.push(
               new TokenAllowance({
                   tokenId:
@@ -61732,10 +61837,7 @@
                                 ownerAccountId.toEvmAddress(),
                             )
                           : ownerAccountId,
-                  amount:
-                      typeof amount === "number"
-                          ? Long.fromNumber(amount)
-                          : amount,
+                  amount: amountLong,
               }),
           );
 
@@ -61746,12 +61848,15 @@
        * @deprecated - Use `approveTokenAllowance()` instead
        * @param {TokenId | string} tokenId
        * @param {AccountId | string} spenderAccountId
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {AccountAllowanceApproveTransaction}
        */
       addTokenAllowance(tokenId, spenderAccountId, amount) {
           this._requireNotFrozen();
 
+          // Convert amount to Long
+          const amountLong = convertAmountToLong(amount);
+
           this._tokenApprovals.push(
               new TokenAllowance({
                   tokenId:
@@ -61762,10 +61867,7 @@
                       typeof spenderAccountId === "string"
                           ? AccountId.fromString(spenderAccountId)
                           : spenderAccountId,
-                  amount:
-                      typeof amount === "number"
-                          ? Long.fromNumber(amount)
-                          : amount,
+                  amount: amountLong,
                   ownerAccountId: null,
               }),
           );
@@ -79573,7 +79675,8 @@
           const isLocalEnvironment = host === "localhost" || host === "127.0.0.1";
 
           if (isLocalEnvironment) {
-              // For local environments, use HTTP scheme and port 8545
+              // For local environments, use HTTP scheme and port 8545 for contract calls
+              // (different from general mirror node REST API port 5551)
               const url = new URL(mirrorRestApiBaseUrl);
               url.protocol = "http:";
               url.port = "8545";
@@ -82924,6 +83027,7 @@
    * @typedef {import("../client/Client.js").default<*, *>} Client
    * @typedef {import("../account/AccountId.js").default} AccountId
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -82933,7 +83037,7 @@
       /**
        * @param {object} [props]
        * @param {TokenId | string} [props.tokenId]
-       * @param {Long | number} [props.amount]
+       * @param {Long | number | BigNumber | bigint} [props.amount]
        * @param {(Long | number)[]} [props.serials]
        */
       constructor(props = {}) {
@@ -83041,12 +83145,12 @@
       }
 
       /**
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {this}
        */
       setAmount(amount) {
           this._requireNotFrozen();
-          this._amount = amount instanceof Long ? amount : Long.fromValue(amount);
+          this._amount = convertAmountToLong(amount);
 
           return this;
       }
@@ -84077,7 +84181,7 @@
        * @param {string} [props.tokenName]
        * @param {string} [props.tokenSymbol]
        * @param {Long | number} [props.decimals]
-       * @param {Long | number} [props.initialSupply]
+       * @param {Long | number | BigNumber | bigint} [props.initialSupply]
        * @param {AccountId | string} [props.treasuryAccountId]
        * @param {Key} [props.adminKey]
        * @param {Key} [props.kycKey]
@@ -84094,7 +84198,7 @@
        * @param {CustomFee[]} [props.customFees]
        * @param {TokenType} [props.tokenType]
        * @param {TokenSupplyType} [props.supplyType]
-       * @param {Long | number} [props.maxSupply]
+       * @param {Long | number | BigNumber | bigint} [props.maxSupply]
        * @param {Key} [props.metadataKey]
        * @param {Uint8Array} [props.metadata]
        */
@@ -84519,12 +84623,12 @@
       }
 
       /**
-       * @param {Long | number} initialSupply
+       * @param {Long | number | BigNumber | bigint} initialSupply
        * @returns {this}
        */
       setInitialSupply(initialSupply) {
           this._requireNotFrozen();
-          this._initialSupply = Long.fromValue(initialSupply);
+          this._initialSupply = convertAmountToLong(initialSupply);
 
           return this;
       }
@@ -84852,14 +84956,11 @@
       }
 
       /**
-       * @param {Long | number} maxSupply
+       * @param {Long | number | BigNumber | bigint} maxSupply
        * @returns {this}
        */
       setMaxSupply(maxSupply) {
-          this._maxSupply =
-              typeof maxSupply === "number"
-                  ? Long.fromNumber(maxSupply)
-                  : maxSupply;
+          this._maxSupply = convertAmountToLong(maxSupply);
           return this;
       }
 
@@ -86400,6 +86501,7 @@
    * @typedef {import("../client/Client.js").default<*, *>} Client
    * @typedef {import("../account/AccountId.js").default} AccountId
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -86409,7 +86511,7 @@
       /**
        * @param {object} [props]
        * @param {TokenId | string} [props.tokenId]
-       * @param {Long | number} [props.amount]
+       * @param {Long | number | BigNumber | bigint} [props.amount]
        * @param {Uint8Array[]} [props.metadata]
        */
       constructor(props = {}) {
@@ -86515,12 +86617,12 @@
       }
 
       /**
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {this}
        */
       setAmount(amount) {
           this._requireNotFrozen();
-          this._amount = amount instanceof Long ? amount : Long.fromValue(amount);
+          this._amount = convertAmountToLong(amount);
 
           return this;
       }
@@ -88749,6 +88851,7 @@
    * @typedef {import("../channel/Channel.js").default} Channel
    * @typedef {import("../client/Client.js").default<*, *>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -88759,7 +88862,7 @@
        * @param {object} [props]
        * @param {TokenId | string} [props.tokenId]
        * @param {AccountId | string} [props.accountId]
-       * @param {Long | number} [props.amount]
+       * @param {Long | number | BigNumber | bigint} [props.amount]
        * @param {(Long | number)[]} [props.serials]
        */
       constructor(props = {}) {
@@ -88902,12 +89005,12 @@
       }
 
       /**
-       * @param {Long | number} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @returns {this}
        */
       setAmount(amount) {
           this._requireNotFrozen();
-          this._amount = amount instanceof Long ? amount : Long.fromValue(amount);
+          this._amount = convertAmountToLong(amount);
 
           return this;
       }
@@ -96609,6 +96712,55 @@
       getKey() {
           return this._address.toString();
       }
+
+      /**
+       * Gets the base URL for this mirror node's REST API.
+       *
+       * @returns {string} The base URL for the mirror node REST API
+       * @throws {Error} When the mirror node has invalid address configuration
+       */
+      get mirrorRestApiBaseUrl() {
+          const host = this.address.address;
+          const port = this.address.port;
+
+          if (!host || !port) {
+              throw new Error("Mirror node has invalid address configuration");
+          }
+
+          // For localhost/127.0.0.1, mirror node gRPC and REST API use different ports
+          // gRPC typically uses port 5600, but REST API uses port 5551
+          // Note: Contract calls may use port 8545 (handled separately in MirrorNodeContractQuery)
+          if (host === "localhost" || host === "127.0.0.1") {
+              return `http://${host}:5551/api/v1`;
+          }
+
+          const scheme = this._getSchemeFromHostAndPort(host, port);
+
+          return `${scheme}://${host}:${port}/api/v1`;
+      }
+
+      /**
+       * Determines the appropriate scheme (http/https) based on the host and port.
+       *
+       * @private
+       * @param {string} host - The host address
+       * @param {number} port - The port number
+       * @returns {string} - The scheme ('http' or 'https')
+       */
+      _getSchemeFromHostAndPort(host, port) {
+          // For localhost and 127.0.0.1, use HTTP scheme
+          if (host === "localhost" || host === "127.0.0.1") {
+              return "http";
+          }
+
+          // Standard HTTP ports
+          if (port === 80) {
+              return "http";
+          }
+
+          // For other ports, assume HTTPS for security
+          return "https";
+      }
   }
 
   // SPDX-License-Identifier: Apache-2.0
@@ -96695,6 +96847,24 @@
       getNextMirrorNode() {
           return this._getNumberOfMostHealthyNodes(1)[0];
       }
+
+      /**
+       * Gets the base URL for the mirror node REST API.
+       *
+       * @returns {string} The base URL for the mirror node REST API
+       * @throws {Error} When no mirror network is configured or available
+       */
+      get mirrorRestApiBaseUrl() {
+          try {
+              const mirrorNode = this.getNextMirrorNode();
+              return mirrorNode.mirrorRestApiBaseUrl;
+          } catch (error) {
+              // Re-throw with a more descriptive error message
+              throw new Error(
+                  "Client has no mirror network configured or no healthy mirror nodes are available",
+              );
+          }
+      }
   };
 
   /* NOSONAR */
@@ -96729,6 +96899,9 @@
       "node29.swirldslabs.com:443": new AccountId(32),
       "node30.swirldslabs.com:443": new AccountId(33),
       "node31.swirldslabs.com:443": new AccountId(34),
+      // "node32.swirldslabs.com:443": new AccountId(35), - temporarily disabled
+      "node33.swirldslabs.com:443": new AccountId(36),
+      "node34.swirldslabs.com:443": new AccountId(37),
   };
 
   const WEB_TESTNET = {
@@ -96859,8 +97032,15 @@
    *   description: string,
    *   stake: number
    * }>} nodes
+   * @property {?{next: ?string}} links - Links object containing pagination information
    */
 
+  /**
+   * Default page size limit for optimal pagination performance
+   * @constant {number}
+   */
+  const DEFAULT_PAGE_SIZE = 25;
+
   /**
    * 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.
@@ -96875,7 +97055,7 @@
       /**
        * @param {object} props
        * @param {FileId | string} [props.fileId]
-       * @param {number} [props.limit]
+       * @param {number} [props.limit] - Page size limit (defaults to 25 for optimal performance)
        */
       constructor(props = {}) {
           super();
@@ -97042,111 +97222,135 @@
               baseUrl = `${baseUrl}:${port}`;
           }
 
-          const url = new URL(`${baseUrl}/api/v1/network/nodes`);
+          // Initialize aggregated results
+          this._addresses = [];
+          let nextUrl = null;
+          let isLastPage = false;
 
+          // Build initial URL
+          const initialUrl = 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());
+              initialUrl.searchParams.append("file.id", this._fileId.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,
-                  });
+          // Use the specified limit, or default to DEFAULT_PAGE_SIZE for optimal pagination performance
+          const effectiveLimit =
+              this._limit != null ? this._limit : DEFAULT_PAGE_SIZE;
+          initialUrl.searchParams.append("limit", effectiveLimit.toString());
 
-                  if (!response.ok) {
-                      throw new Error(`HTTP error! status: ${response.status}`);
-                  }
+          // Fetch all pages
+          while (!isLastPage) {
+              const currentUrl = nextUrl ? new URL(nextUrl, baseUrl) : initialUrl;
 
-                  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-                  const data = /** @type {AddressBookQueryWebResponse} */ (
-                      await response.json()
-                  );
+              for (let attempt = 0; attempt <= this._maxAttempts; attempt++) {
+                  try {
+                      // eslint-disable-next-line n/no-unsupported-features/node-builtins
+                      const response = await fetch(currentUrl.toString(), {
+                          method: "GET",
+                          headers: {
+                              Accept: "application/json",
+                          },
+                          signal: requestTimeout
+                              ? AbortSignal.timeout(requestTimeout)
+                              : undefined,
+                      });
 
-                  const nodes = data.nodes || [];
+                      if (!response.ok) {
+                          throw new Error(
+                              `HTTP error! status: ${response.status}`,
+                          );
+                      }
 
-                  // eslint-disable-next-line ie11/no-loop-func
-                  this._addresses = nodes.map((node) =>
-                      NodeAddress.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(),
-                      }),
-                  );
+                      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                      const data = /** @type {AddressBookQueryWebResponse} */ (
+                          await response.json()
+                      );
 
-                  const addressBook = new NodeAddressBook({
-                      nodeAddresses: this._addresses,
-                  });
+                      const nodes = data.nodes || [];
+
+                      // Aggregate nodes from this page
+                      const pageNodes = nodes.map((node) =>
+                          NodeAddress.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(),
+                          }),
+                      );
 
-                  resolve(addressBook);
-                  return;
-              } catch (error) {
-                  console.error("Error in _makeFetchRequest:", error);
-                  const message =
-                      error instanceof Error ? error.message : String(error);
+                      this._addresses.push(...pageNodes);
+                      nextUrl = data.links?.next || null;
 
-                  // 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 no more pages, set flag to exit loop
+                      if (!nextUrl) {
+                          isLastPage = true;
+                      }
 
-                      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}`,
+                      // Move to next page
+                      break;
+                  } 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;
                       }
 
-                      // 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;
                   }
-
-                  // 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"));
+          // Return the aggregated results
+          const addressBook = new NodeAddressBook({
+              nodeAddresses: this._addresses,
+          });
+          resolve(addressBook);
       }
 
       /**
@@ -97465,26 +97669,7 @@
        * @throws {Error} When no mirror network is configured or available
        */
       get mirrorRestApiBaseUrl() {
-          try {
-              const mirrorNode = this._mirrorNetwork.getNextMirrorNode();
-              const host = mirrorNode.address.address;
-              const port = mirrorNode.address.port;
-
-              if (!host || !port) {
-                  throw new Error(
-                      "Mirror node has invalid address configuration",
-                  );
-              }
-
-              const scheme = this._getSchemeFromHostAndPort(host, port);
-
-              return `${scheme}://${host}:${port}/api/v1`;
-          } catch (error) {
-              // Re-throw with a more descriptive error message
-              throw new Error(
-                  "Client has no mirror network configured or no healthy mirror nodes are available",
-              );
-          }
+          return this._mirrorNetwork.mirrorRestApiBaseUrl;
       }
 
       /**
@@ -97755,15 +97940,24 @@
       }
 
       /**
-       * @returns {number}
+       * Gets the maximum number of nodes that a transaction or query will attempt to execute against.
+       *
+       * @returns {number} The current maximum nodes per transaction setting.
+       *   Returns -1 if no limit is set (uses network defaults).
        */
       get maxNodesPerTransaction() {
           return this._network.maxNodesPerTransaction;
       }
 
       /**
-       * @param {number} maxNodesPerTransaction
-       * @returns {this}
+       * Sets the maximum number of nodes that a transaction or query will execute against.
+       *
+       * - **Before freezing**: Limits automatic node selection when no explicit nodes are set
+       * - **After freezing**: Trims frozen transactions to the first N nodes while preserving signatures
+       * - **Special values**: 0 disables limiting, values > available nodes cause no trimming
+       *
+       * @param {number} maxNodesPerTransaction - Maximum nodes per transaction. Set to 0 to disable.
+       * @returns {this} The client instance for method chaining
        */
       setMaxNodesPerTransaction(maxNodesPerTransaction) {
           this._network.setMaxNodesPerTransaction(maxNodesPerTransaction);
@@ -98025,34 +98219,6 @@
           }, this._networkUpdatePeriod);
       }
 
-      /**
-       * Determines the appropriate scheme (http/https) based on the host and port.
-       *
-       * @private
-       * @param {string} host - The host address
-       * @param {number} port - The port number
-       * @returns {string} - The scheme ('http' or 'https')
-       */
-      _getSchemeFromHostAndPort(host, port) {
-          // For localhost and 127.0.0.1, use HTTP scheme
-          if (host === "localhost" || host === "127.0.0.1") {
-              return "http";
-          }
-
-          // Standard HTTPS ports
-          if (port === 443) {
-              return "https";
-          }
-
-          // Standard HTTP ports
-          if (port === 80) {
-              return "http";
-          }
-
-          // For other ports, assume HTTPS for security
-          return "https";
-      }
-
       /**
        * @returns {boolean}
        */
@@ -98122,7 +98288,7 @@
 
   const SDK_NAME = "hiero-sdk-js";
   const SDK_VERSION =
-      "2.73.2" ;
+      "2.75.0" ;
 
   // SPDX-License-Identifier: Apache-2.0