@hiero-ledger/sdk 2.73.2 → 2.75.0

package/src/network/AddressBookQueryWeb.js

@@ -49,8 +49,15 @@ import {
  *   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.
@@ -65,7 +72,7 @@ export default class AddressBookQueryWeb extends Query {
     /**
      * @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();
@@ -232,111 +239,135 @@ export default class AddressBookQueryWeb extends Query {
             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());
+
+        // Fetch all pages
+        while (!isLastPage) {
+            const currentUrl = nextUrl ? new URL(nextUrl, baseUrl) : initialUrl;
+
+            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,
+                    });
+
+                    if (!response.ok) {
+                        throw new Error(
+                            `HTTP error! status: ${response.status}`,
+                        );
+                    }
 
-                if (!response.ok) {
-                    throw new Error(`HTTP error! status: ${response.status}`);
-                }
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                    const data = /** @type {AddressBookQueryWebResponse} */ (
+                        await response.json()
+                    );
 
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-                const data = /** @type {AddressBookQueryWebResponse} */ (
-                    await response.json()
-                );
-
-                const nodes = data.nodes || [];
-
-                // eslint-disable-next-line ie11/no-loop-func
-                this._addresses = nodes.map((node) =>
-                    NodeAddress.fromJSON({
-                        nodeId: node.node_id.toString(),
-                        accountId: node.node_account_id,
-                        addresses: this._handleAddressesFromGrpcProxyEndpoint(
-                            node,
-                            client,
-                        ),
-                        certHash: node.node_cert_hash,
-                        publicKey: node.public_key,
-                        description: node.description,
-                        stake: node.stake.toString(),
-                    }),
-                );
-
-                const addressBook = new NodeAddressBook({
-                    nodeAddresses: this._addresses,
-                });
-
-                resolve(addressBook);
-                return;
-            } catch (error) {
-                console.error("Error in _makeFetchRequest:", error);
-                const message =
-                    error instanceof Error ? error.message : String(error);
-
-                // Check if we should retry
-                if (
-                    attempt < this._maxAttempts &&
-                    !client.isClientShutDown &&
-                    this._retryHandler(
-                        /** @type {MirrorError | Error | null} */ (error),
-                    )
-                ) {
-                    const delay = Math.min(
-                        250 * 2 ** attempt,
-                        this._maxBackoff,
+                    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(),
+                        }),
                     );
 
-                    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}`,
+                    this._addresses.push(...pageNodes);
+                    nextUrl = data.links?.next || null;
+
+                    // If no more pages, set flag to exit loop
+                    if (!nextUrl) {
+                        isLastPage = true;
+                    }
+
+                    // 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);
     }
 
     /**

package/src/query/MirrorNodeContractQuery.js

@@ -226,7 +226,8 @@ export default class MirrorNodeContractQuery {
         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";

package/src/token/AbstractTokenTransferTransaction.js

@@ -5,11 +5,15 @@ import TokenId from "./TokenId.js";
 import NftId from "./NftId.js";
 import AccountId from "../account/AccountId.js";
 import Transaction from "../transaction/Transaction.js";
-import Long from "long";
 import NullableTokenDecimalMap from "../account/NullableTokenDecimalMap.js";
 import TokenNftTransferMap from "../account/TokenNftTransferMap.js";
 import TokenTransferMap from "../account/TokenTransferMap.js";
 import TokenTransferAccountMap from "../account/TokenTransferAccountMap.js";
+import { convertAmountToLong } from "../util.js";
+
+/**
+ * @typedef {import("bignumber.js").default} BigNumber
+ */
 
 /**
  * @namespace proto
@@ -20,7 +24,7 @@ import TokenTransferAccountMap from "../account/TokenTransferAccountMap.js";
  * @typedef {object} TransferTokensInput
  * @property {TokenId | string} tokenId
  * @property {AccountId | string} accountId
- * @property {Long | number} amount
+ * @property {Long | number | BigNumber | bigint} amount
  */
 
 /**
@@ -99,7 +103,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
     /**
      * @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}
@@ -119,7 +123,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
             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 (
@@ -148,7 +152,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
     /**
      * @param {TokenId | string} tokenId
      * @param {AccountId | string} accountId
-     * @param {number | Long} amount
+     * @param {number | Long | BigNumber | bigint} amount
      * @returns {this}
      */
     addTokenTransfer(tokenId, accountId, amount) {
@@ -290,7 +294,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
     /**
      * @param {TokenId | string} tokenId
      * @param {AccountId | string} accountId
-     * @param {number | Long} amount
+     * @param {number | Long | BigNumber | bigint} amount
      * @returns {this}
      */
     addApprovedTokenTransfer(tokenId, accountId, amount) {
@@ -300,7 +304,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
     /**
      * @param {TokenId | string} tokenId
      * @param {AccountId | string} accountId
-     * @param {number | Long} amount
+     * @param {number | Long | BigNumber | bigint} amount
      * @param {number} decimals
      * @returns {this}
      */
@@ -313,7 +317,7 @@ export default class AbstractTokenTransferTransaction extends Transaction {
             accountId instanceof AccountId
                 ? accountId
                 : AccountId.fromString(accountId);
-        const value = amount instanceof Long ? amount : Long.fromNumber(amount);
+        const value = convertAmountToLong(amount);
 
         let found = false;
 

package/src/token/AssessedCustomFee.js

@@ -2,7 +2,11 @@
 
 import TokenId from "./TokenId.js";
 import AccountId from "../account/AccountId.js";
-import Long from "long";
+import { convertAmountToLong } from "../util.js";
+
+/**
+ * @typedef {import("bignumber.js").default} BigNumber
+ */
 
 /**
  * @namespace proto
@@ -27,7 +31,7 @@ export default class AssessedCustomFee {
      * @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 = {}) {
@@ -112,12 +116,11 @@ export default class AssessedCustomFee {
     }
 
     /**
-     * @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;
     }
 

package/src/token/CustomFixedFee.js

@@ -3,8 +3,12 @@
 import TokenId from "./TokenId.js";
 import CustomFee from "./CustomFee.js";
 import AccountId from "../account/AccountId.js";
-import Long from "long";
 import Hbar from "../Hbar.js";
+import { convertAmountToLong } from "../util.js";
+
+/**
+ * @typedef {import("bignumber.js").default} BigNumber
+ */
 
 /**
  * @namespace proto
@@ -19,7 +23,7 @@ export default class CustomFixedFee extends CustomFee {
      * @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);
@@ -97,12 +101,11 @@ export default class CustomFixedFee extends CustomFee {
     }
 
     /**
-     * @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;
     }
 

package/src/token/PendingAirdropRecord.js

@@ -6,16 +6,21 @@
 
 import Long from "long";
 import PendingAirdropId from "./PendingAirdropId.js";
+import { convertAmountToLong } from "../util.js";
+
+/**
+ * @typedef {import("bignumber.js").default} BigNumber
+ */
 
 export default 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);
     }
 
     /**

package/src/token/TokenAirdropTransaction.js

@@ -24,6 +24,7 @@ import AbstractTokenTransferTransaction from "./AbstractTokenTransferTransaction
  * @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
  */
 
 /**
@@ -119,7 +120,7 @@ export default class TokenAirdropTransaction extends AbstractTokenTransferTransa
      *
      * @param {TokenId} tokenId
      * @param {AccountId} accountId
-     * @param {Long} amount
+     * @param {Long | number | BigNumber | bigint} amount
      * @param {number} expectedDecimals
      * @returns {this}
      */

package/src/token/TokenBurnTransaction.js

@@ -5,6 +5,7 @@ import Transaction, {
     TRANSACTION_REGISTRY,
 } from "../transaction/Transaction.js";
 import Long from "long";
+import { convertAmountToLong } from "../util.js";
 
 /**
  * @namespace proto
@@ -22,6 +23,7 @@ import Long from "long";
  * @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
  */
 
 /**
@@ -31,7 +33,7 @@ export default class TokenBurnTransaction extends Transaction {
     /**
      * @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 = {}) {
@@ -139,12 +141,12 @@ export default class TokenBurnTransaction extends Transaction {
     }
 
     /**
-     * @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;
     }

package/src/token/TokenCreateTransaction.js

@@ -7,6 +7,7 @@ import Transaction, {
 } from "../transaction/Transaction.js";
 import Long from "long";
 import AccountId from "../account/AccountId.js";
+import { convertAmountToLong } from "../util.js";
 import Timestamp from "../Timestamp.js";
 import Duration from "../Duration.js";
 import CustomFixedFee from "./CustomFixedFee.js";
@@ -44,7 +45,7 @@ export default class TokenCreateTransaction extends Transaction {
      * @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]
@@ -61,7 +62,7 @@ export default class TokenCreateTransaction extends Transaction {
      * @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]
      */
@@ -486,12 +487,12 @@ export default class TokenCreateTransaction extends Transaction {
     }
 
     /**
-     * @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;
     }
@@ -819,14 +820,11 @@ export default class TokenCreateTransaction extends Transaction {
     }
 
     /**
-     * @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;
     }
 

package/src/token/TokenMintTransaction.js

@@ -4,8 +4,8 @@ import TokenId from "./TokenId.js";
 import Transaction, {
     TRANSACTION_REGISTRY,
 } from "../transaction/Transaction.js";
-import Long from "long";
 import * as hex from "../encoding/hex.js";
+import { convertAmountToLong } from "../util.js";
 
 /**
  * @namespace proto
@@ -23,6 +23,7 @@ import * as hex from "../encoding/hex.js";
  * @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
  */
 
 /**
@@ -32,7 +33,7 @@ export default class TokenMintTransaction extends Transaction {
     /**
      * @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 = {}) {
@@ -138,12 +139,12 @@ export default class TokenMintTransaction extends Transaction {
     }
 
     /**
-     * @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;
     }

package/src/token/TokenTransfer.js

@@ -3,6 +3,7 @@
 import Long from "long";
 import AccountId from "../account/AccountId.js";
 import TokenId from "./TokenId.js";
+import { convertAmountToLong } from "../util.js";
 
 /**
  * @namespace proto
@@ -35,7 +36,7 @@ export default class TokenTransfer {
      * @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) {
@@ -60,7 +61,7 @@ export default class TokenTransfer {
                 : AccountId.fromString(props.accountId);
 
         this.expectedDecimals = props.expectedDecimals;
-        this.amount = Long.fromValue(props.amount);
+        this.amount = convertAmountToLong(props.amount);
         this.isApproved = props.isApproved;
     }
 

package/src/token/TokenWipeTransaction.js

@@ -6,6 +6,7 @@ import Transaction, {
     TRANSACTION_REGISTRY,
 } from "../transaction/Transaction.js";
 import Long from "long";
+import { convertAmountToLong } from "../util.js";
 
 /**
  * @namespace proto
@@ -22,6 +23,7 @@ import Long from "long";
  * @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
  */
 
 /**
@@ -32,7 +34,7 @@ export default class TokenWipeTransaction extends Transaction {
      * @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 = {}) {
@@ -175,12 +177,12 @@ export default class TokenWipeTransaction extends Transaction {
     }
 
     /**
-     * @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;
     }