@hiero-ledger/sdk 2.73.1 → 2.74.0

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;
     }

package/src/transaction/Transaction.js

@@ -1291,6 +1291,65 @@ export default class Transaction extends Executable {
         );
     }
 
+    /**
+     * 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
@@ -1667,6 +1726,10 @@ export default class Transaction extends Executable {
             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);

package/src/util.js

@@ -291,6 +291,32 @@ export function convertToBigNumber(variable) {
     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}
+ */
+export 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.isBigNumber(amount)) {
+        return Long.fromValue(
+            amount.integerValue(BigNumber.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.
  *