@hiero-ledger/sdk 2.73.1 → 2.74.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.
    *
@@ -37038,17 +37064,15 @@
           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}/accounts/${this.evmAddress.toString()}`;
 
           await new Promise((resolve) => {
               setTimeout(resolve, 3000);
           });
 
           /* eslint-disable */
-          const url = `https://${mirrorUrl}/api/v1/accounts/${this.evmAddress.toString()}`;
           const response = await fetch(url);
           const data = await response.json();
           const mirrorAccountId = data.account;
@@ -37070,17 +37094,15 @@
           if (this.num === null) {
               throw new Error("field `num` should not be null");
           }
-          const mirrorUrl = client.mirrorNetwork[0].slice(
-              0,
-              client.mirrorNetwork[0].indexOf(":"),
-          );
+          const mirrorRestApiBaseUrl = client.mirrorRestApiBaseUrl;
+
+          const url = `${mirrorRestApiBaseUrl}/accounts/${this.num.toString()}`;
 
           await new Promise((resolve) => {
               setTimeout(resolve, 3000);
           });
 
           /* eslint-disable */
-          const url = `https://${mirrorUrl}/api/v1/accounts/${this.num.toString()}`;
           const response = await fetch(url);
           const data = await response.json();
           const mirrorAccountId = data.evm_address;
@@ -45010,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;
@@ -54101,6 +54115,10 @@
    * @typedef {import("@hashgraph/proto").proto.IAccountID} HieroProto.proto.IAccountID
    */
 
+  /**
+   * @typedef {import("bignumber.js").default} BigNumber
+   */
+
   /**
    * @augments {ObjectMap<TokenId, TokenTransferAccountMap>}
    */
@@ -54113,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();
@@ -54125,7 +54143,7 @@
               this.__map.set(tokenId, _map);
           }
 
-          _map._set(accountId, amount);
+          _map._set(accountId, convertAmountToLong(amount));
       }
 
       /**
@@ -54320,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
@@ -54343,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 = {}) {
@@ -54428,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;
       }
 
@@ -54672,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) {
@@ -54697,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;
       }
 
@@ -55033,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);
       }
 
       /**
@@ -56652,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
@@ -56665,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);
@@ -56743,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;
       }
 
@@ -58255,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
@@ -58631,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);
@@ -59397,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
@@ -59406,7 +59501,7 @@
    * @typedef {object} TransferTokensInput
    * @property {TokenId | string} tokenId
    * @property {AccountId | string} accountId
-   * @property {Long | number} amount
+   * @property {Long | number | BigNumber | bigint} amount
    */
 
   /**
@@ -59485,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}
@@ -59505,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 (
@@ -59534,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) {
@@ -59676,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) {
@@ -59686,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}
        */
@@ -59699,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;
 
@@ -59994,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
    */
 
   /**
@@ -60089,7 +60185,7 @@
        *
        * @param {TokenId} tokenId
        * @param {AccountId} accountId
-       * @param {Long} amount
+       * @param {Long | number | BigNumber | bigint} amount
        * @param {number} expectedDecimals
        * @returns {this}
        */
@@ -60640,6 +60736,7 @@
 
   /**
    * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("bignumber.js").default} BigNumber
    */
 
   /**
@@ -60656,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) {
           /**
@@ -60687,7 +60784,8 @@
            *
            * @readonly
            */
-          this.amount = props.amount;
+          this.amount =
+              props.amount != null ? convertAmountToLong(props.amount) : null;
 
           Object.freeze(this);
       }
@@ -61704,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:
@@ -61736,10 +61837,7 @@
                                 ownerAccountId.toEvmAddress(),
                             )
                           : ownerAccountId,
-                  amount:
-                      typeof amount === "number"
-                          ? Long.fromNumber(amount)
-                          : amount,
+                  amount: amountLong,
               }),
           );
 
@@ -61750,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:
@@ -61766,10 +61867,7 @@
                       typeof spenderAccountId === "string"
                           ? AccountId.fromString(spenderAccountId)
                           : spenderAccountId,
-                  amount:
-                      typeof amount === "number"
-                          ? Long.fromNumber(amount)
-                          : amount,
+                  amount: amountLong,
                   ownerAccountId: null,
               }),
           );
@@ -79568,29 +79666,27 @@
               throw new Error("Contract ID is not set");
           }
           this._fillEvmAddress();
-          let mirrorNetworkAddress = client.mirrorNetwork[0];
-          const contractCallEndpoint = "/api/v1/contracts/call";
-
-          if (!client.ledgerId || client.ledgerId?.isLocalNode()) {
-              const currentMirrorNetworkPort =
-                  client.mirrorNetwork[0].split(":")[1];
-              mirrorNetworkAddress = "http://"
-                  .concat(
-                      client.mirrorNetwork[0].replace(
-                          currentMirrorNetworkPort,
-                          "8545",
-                      ),
-                  )
-                  .concat(contractCallEndpoint);
-          } else {
-              let trimmed = client.mirrorNetwork[0].split(":");
-              mirrorNetworkAddress = "https://"
-                  .concat(trimmed[0])
-                  .concat(contractCallEndpoint);
+          let mirrorRestApiBaseUrl = client.mirrorRestApiBaseUrl;
+          const contractCallEndpointPath = "/contracts/call";
+
+          // Check if this is a local environment (localhost or 127.0.0.1)
+          const mirrorNode = client._mirrorNetwork.getNextMirrorNode();
+          const host = mirrorNode.address.address;
+          const isLocalEnvironment = host === "localhost" || host === "127.0.0.1";
+
+          if (isLocalEnvironment) {
+              // 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";
+              mirrorRestApiBaseUrl = url.toString();
           }
 
+          const contractCallEndpointUrl = `${mirrorRestApiBaseUrl}${contractCallEndpointPath}`;
+
           // eslint-disable-next-line n/no-unsupported-features/node-builtins
-          const response = await fetch(mirrorNetworkAddress, {
+          const response = await fetch(contractCallEndpointUrl, {
               method: "POST",
               headers: {
                   "Content-Type": "application/json",
@@ -82931,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
    */
 
   /**
@@ -82940,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 = {}) {
@@ -83048,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;
       }
@@ -84084,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]
@@ -84101,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]
        */
@@ -84526,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;
       }
@@ -84859,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;
       }
 
@@ -86407,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
    */
 
   /**
@@ -86416,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 = {}) {
@@ -86522,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;
       }
@@ -88756,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
    */
 
   /**
@@ -88766,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 = {}) {
@@ -88909,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;
       }
@@ -96616,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
@@ -96702,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 */
@@ -96736,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 = {
@@ -97467,6 +97633,14 @@
           return this._mirrorNetwork.network;
       }
 
+      /**
+       * @returns {string}
+       * @throws {Error} When no mirror network is configured or available
+       */
+      get mirrorRestApiBaseUrl() {
+          return this._mirrorNetwork.mirrorRestApiBaseUrl;
+      }
+
       /**
        * @returns {boolean}
        */
@@ -97735,15 +97909,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);
@@ -98074,7 +98257,7 @@
 
   const SDK_NAME = "hiero-sdk-js";
   const SDK_VERSION =
-      "2.73.1" ;
+      "2.74.0" ;
 
   // SPDX-License-Identifier: Apache-2.0