@hiero-ledger/sdk 2.80.0 → 2.81.0

package/dist/umd.js

@@ -274,7 +274,7 @@
       if (value < 0) return UZERO;
       if (value >= TWO_PWR_64_DBL) return MAX_UNSIGNED_VALUE;
     } else {
-      if (value <= -9223372036854776e3) return MIN_VALUE;
+      if (value <= -TWO_PWR_63_DBL) return MIN_VALUE;
       if (value + 1 >= TWO_PWR_63_DBL) return MAX_VALUE;
     }
     if (value < 0) return fromNumber(-value, unsigned).neg();
@@ -2145,12 +2145,12 @@
           if (obj.hasOwnProperty(p = 'EXPONENTIAL_AT')) {
             v = obj[p];
             if (v && v.pop) {
-              intCheck(v[0], -1e9, 0, p);
+              intCheck(v[0], -MAX, 0, p);
               intCheck(v[1], 0, MAX, p);
               TO_EXP_NEG = v[0];
               TO_EXP_POS = v[1];
             } else {
-              intCheck(v, -1e9, MAX, p);
+              intCheck(v, -MAX, MAX, p);
               TO_EXP_NEG = -(TO_EXP_POS = v < 0 ? -v : v);
             }
           }
@@ -2161,12 +2161,12 @@
           if (obj.hasOwnProperty(p = 'RANGE')) {
             v = obj[p];
             if (v && v.pop) {
-              intCheck(v[0], -1e9, -1, p);
+              intCheck(v[0], -MAX, -1, p);
               intCheck(v[1], 1, MAX, p);
               MIN_EXP = v[0];
               MAX_EXP = v[1];
             } else {
-              intCheck(v, -1e9, MAX, p);
+              intCheck(v, -MAX, MAX, p);
               if (v) {
                 MIN_EXP = -(MAX_EXP = v < 0 ? -v : v);
               } else {
@@ -2283,7 +2283,7 @@
 
       out: if ({}.toString.call(c) == '[object Array]') {
 
-        if ((s === 1 || s === -1) && e >= -1e9 && e <= MAX && e === mathfloor(e)) {
+        if ((s === 1 || s === -1) && e >= -MAX && e <= MAX && e === mathfloor(e)) {
 
           // If the first element is zero, the BigNumber value must be zero.
           if (c[0] === 0) {
@@ -4044,7 +4044,7 @@
      * '[BigNumber Error] Argument {not a primitive number|not an integer|out of range}: {k}'
      */
     P.shiftedBy = function (k) {
-      intCheck(k, -9007199254740991, MAX_SAFE_INTEGER$1);
+      intCheck(k, -MAX_SAFE_INTEGER$1, MAX_SAFE_INTEGER$1);
       return this.times('1e' + k);
     };
 
@@ -5216,14 +5216,14 @@
   function requireBase64 () {
   	if (hasRequiredBase64) return base64;
   	hasRequiredBase64 = 1;
-  	(function (exports) {
+  	(function (exports$1) {
 
   		/**
   		 * A minimal base64 implementation for number arrays.
   		 * @memberof util
   		 * @namespace
   		 */
-  		var base64 = exports;
+  		var base64 = exports$1;
 
   		/**
   		 * Calculates the byte length of a base64 encoded string.
@@ -5535,7 +5535,7 @@
   	 */
 
   	// Factory function for the purpose of node-based testing in modified global environments
-  	function factory(exports) {
+  	function factory(exports$1) {
 
   	    // float: typed array
   	    if (typeof Float32Array !== "undefined") (function() {
@@ -5561,9 +5561,9 @@
   	        }
 
   	        /* istanbul ignore next */
-  	        exports.writeFloatLE = le ? writeFloat_f32_cpy : writeFloat_f32_rev;
+  	        exports$1.writeFloatLE = le ? writeFloat_f32_cpy : writeFloat_f32_rev;
   	        /* istanbul ignore next */
-  	        exports.writeFloatBE = le ? writeFloat_f32_rev : writeFloat_f32_cpy;
+  	        exports$1.writeFloatBE = le ? writeFloat_f32_rev : writeFloat_f32_cpy;
 
   	        function readFloat_f32_cpy(buf, pos) {
   	            f8b[0] = buf[pos    ];
@@ -5582,9 +5582,9 @@
   	        }
 
   	        /* istanbul ignore next */
-  	        exports.readFloatLE = le ? readFloat_f32_cpy : readFloat_f32_rev;
+  	        exports$1.readFloatLE = le ? readFloat_f32_cpy : readFloat_f32_rev;
   	        /* istanbul ignore next */
-  	        exports.readFloatBE = le ? readFloat_f32_rev : readFloat_f32_cpy;
+  	        exports$1.readFloatBE = le ? readFloat_f32_rev : readFloat_f32_cpy;
 
   	    // float: ieee754
   	    })(); else (function() {
@@ -5608,8 +5608,8 @@
   	            }
   	        }
 
-  	        exports.writeFloatLE = writeFloat_ieee754.bind(null, writeUintLE);
-  	        exports.writeFloatBE = writeFloat_ieee754.bind(null, writeUintBE);
+  	        exports$1.writeFloatLE = writeFloat_ieee754.bind(null, writeUintLE);
+  	        exports$1.writeFloatBE = writeFloat_ieee754.bind(null, writeUintBE);
 
   	        function readFloat_ieee754(readUint, buf, pos) {
   	            var uint = readUint(buf, pos),
@@ -5625,8 +5625,8 @@
   	                : sign * Math.pow(2, exponent - 150) * (mantissa + 8388608);
   	        }
 
-  	        exports.readFloatLE = readFloat_ieee754.bind(null, readUintLE);
-  	        exports.readFloatBE = readFloat_ieee754.bind(null, readUintBE);
+  	        exports$1.readFloatLE = readFloat_ieee754.bind(null, readUintLE);
+  	        exports$1.readFloatBE = readFloat_ieee754.bind(null, readUintBE);
 
   	    })();
 
@@ -5662,9 +5662,9 @@
   	        }
 
   	        /* istanbul ignore next */
-  	        exports.writeDoubleLE = le ? writeDouble_f64_cpy : writeDouble_f64_rev;
+  	        exports$1.writeDoubleLE = le ? writeDouble_f64_cpy : writeDouble_f64_rev;
   	        /* istanbul ignore next */
-  	        exports.writeDoubleBE = le ? writeDouble_f64_rev : writeDouble_f64_cpy;
+  	        exports$1.writeDoubleBE = le ? writeDouble_f64_rev : writeDouble_f64_cpy;
 
   	        function readDouble_f64_cpy(buf, pos) {
   	            f8b[0] = buf[pos    ];
@@ -5691,9 +5691,9 @@
   	        }
 
   	        /* istanbul ignore next */
-  	        exports.readDoubleLE = le ? readDouble_f64_cpy : readDouble_f64_rev;
+  	        exports$1.readDoubleLE = le ? readDouble_f64_cpy : readDouble_f64_rev;
   	        /* istanbul ignore next */
-  	        exports.readDoubleBE = le ? readDouble_f64_rev : readDouble_f64_cpy;
+  	        exports$1.readDoubleBE = le ? readDouble_f64_rev : readDouble_f64_cpy;
 
   	    // double: ieee754
   	    })(); else (function() {
@@ -5728,8 +5728,8 @@
   	            }
   	        }
 
-  	        exports.writeDoubleLE = writeDouble_ieee754.bind(null, writeUintLE, 0, 4);
-  	        exports.writeDoubleBE = writeDouble_ieee754.bind(null, writeUintBE, 4, 0);
+  	        exports$1.writeDoubleLE = writeDouble_ieee754.bind(null, writeUintLE, 0, 4);
+  	        exports$1.writeDoubleBE = writeDouble_ieee754.bind(null, writeUintBE, 4, 0);
 
   	        function readDouble_ieee754(readUint, off0, off1, buf, pos) {
   	            var lo = readUint(buf, pos + off0),
@@ -5746,12 +5746,12 @@
   	                : sign * Math.pow(2, exponent - 1075) * (mantissa + 4503599627370496);
   	        }
 
-  	        exports.readDoubleLE = readDouble_ieee754.bind(null, readUintLE, 0, 4);
-  	        exports.readDoubleBE = readDouble_ieee754.bind(null, readUintBE, 4, 0);
+  	        exports$1.readDoubleLE = readDouble_ieee754.bind(null, readUintLE, 0, 4);
+  	        exports$1.readDoubleBE = readDouble_ieee754.bind(null, readUintBE, 4, 0);
 
   	    })();
 
-  	    return exports;
+  	    return exports$1;
   	}
 
   	// uint helpers
@@ -5818,14 +5818,14 @@
   function requireUtf8 () {
   	if (hasRequiredUtf8) return utf8;
   	hasRequiredUtf8 = 1;
-  	(function (exports) {
+  	(function (exports$1) {
 
   		/**
   		 * A minimal UTF8 implementation for number arrays.
   		 * @memberof util
   		 * @namespace
   		 */
-  		var utf8 = exports;
+  		var utf8 = exports$1;
 
   		/**
   		 * Calculates the UTF8 byte length of a string.
@@ -6196,8 +6196,8 @@
   function requireMinimal$1 () {
   	if (hasRequiredMinimal$1) return minimal$1;
   	hasRequiredMinimal$1 = 1;
-  	(function (exports) {
-  		var util = exports;
+  	(function (exports$1) {
+  		var util = exports$1;
 
   		// used to return a Promise where callback is omitted
   		util.asPromise = requireAspromise();
@@ -7844,13 +7844,13 @@
   function requireRpc () {
   	if (hasRequiredRpc) return rpc;
   	hasRequiredRpc = 1;
-  	(function (exports) {
+  	(function (exports$1) {
 
   		/**
   		 * Streaming RPC helpers.
   		 * @namespace
   		 */
-  		var rpc = exports;
+  		var rpc = exports$1;
 
   		/**
   		 * RPC implementation passed to {@link Service#create} performing a service request on network level, i.e. by utilizing http requests or websockets.
@@ -7915,8 +7915,8 @@
   function requireIndexMinimal () {
   	if (hasRequiredIndexMinimal) return indexMinimal;
   	hasRequiredIndexMinimal = 1;
-  	(function (exports) {
-  		var protobuf = exports;
+  	(function (exports$1) {
+  		var protobuf = exports$1;
 
   		/**
   		 * Build type, one of `"full"`, `"light"` or `"minimal"`.
@@ -7974,15 +7974,15 @@
   function requireUmd () {
   	if (hasRequiredUmd) return umd$1.exports;
   	hasRequiredUmd = 1;
-  	(function (module, exports) {
+  	(function (module, exports$1) {
   		// GENERATED FILE. DO NOT EDIT.
   		(function (global, factory) {
-  		  function unwrapDefault(exports) {
-  		    return "default" in exports ? exports.default : exports;
+  		  function unwrapDefault(exports$1) {
+  		    return "default" in exports$1 ? exports$1.default : exports$1;
   		  }
   		  {
-  		    factory(exports);
-  		    module.exports = unwrapDefault(exports);
+  		    factory(exports$1);
+  		    module.exports = unwrapDefault(exports$1);
   		  }
   		})(
   		  typeof globalThis !== "undefined"
@@ -8247,7 +8247,7 @@
   		        if (value < 0) return UZERO;
   		        if (value >= TWO_PWR_64_DBL) return MAX_UNSIGNED_VALUE;
   		      } else {
-  		        if (value <= -9223372036854776e3) return MIN_VALUE;
+  		        if (value <= -TWO_PWR_63_DBL) return MIN_VALUE;
   		        if (value + 1 >= TWO_PWR_63_DBL) return MAX_VALUE;
   		      }
   		      if (value < 0) return fromNumber(-value, unsigned).neg();
@@ -9633,11 +9633,9 @@
   }
 
   var libExports = requireLib();
-  var index = /*@__PURE__*/getDefaultExportFromCjs(libExports);
 
   var HieroProto = /*#__PURE__*/_mergeNamespaces({
-    __proto__: null,
-    default: index
+    __proto__: null
   }, [libExports]);
 
   let Key$1 = class Key {};
@@ -12461,7 +12459,7 @@
    * Convert JS string to byte array.
    * @example utf8ToBytes('abc') // new Uint8Array([97, 98, 99])
    */
-  function utf8ToBytes$1(str) {
+  function utf8ToBytes(str) {
       if (typeof str !== 'string')
           throw new Error('utf8ToBytes expected string, got ' + typeof str);
       return new Uint8Array(new TextEncoder().encode(str)); // https://bugzil.la/1681809
@@ -12473,7 +12471,7 @@
    */
   function toBytes(data) {
       if (typeof data === 'string')
-          data = utf8ToBytes$1(data);
+          data = utf8ToBytes(data);
       abytes$1(data);
       return data;
   }
@@ -12935,10 +12933,6 @@
   function numberToBytesLE(n, len) {
       return numberToBytesBE(n, len).reverse();
   }
-  // Unpadded, rarely used
-  function numberToVarBytesBE(n) {
-      return hexToBytes(numberToHexUnpadded(n));
-  }
   /**
    * Takes hex string or Uint8Array, converts to Uint8Array.
    * Validates output length.
@@ -12989,23 +12983,6 @@
       }
       return res;
   }
-  // Compares 2 u8a-s in kinda constant time
-  function equalBytes$1(a, b) {
-      if (a.length !== b.length)
-          return false;
-      let diff = 0;
-      for (let i = 0; i < a.length; i++)
-          diff |= a[i] ^ b[i];
-      return diff === 0;
-  }
-  /**
-   * @example utf8ToBytes('abc') // new Uint8Array([97, 98, 99])
-   */
-  function utf8ToBytes(str) {
-      if (typeof str !== 'string')
-          throw new Error('string expected');
-      return new Uint8Array(new TextEncoder().encode(str)); // https://bugzil.la/1681809
-  }
   // Is positive bigint
   const isPosBig = (n) => typeof n === 'bigint' && _0n$3 <= n;
   function inRange(n, min, max) {
@@ -13036,20 +13013,6 @@
           ;
       return len;
   }
-  /**
-   * Gets single bit at position.
-   * NOTE: first bit position is 0 (same as arrays)
-   * Same as `!!+Array.from(n.toString(2)).reverse()[pos]`
-   */
-  function bitGet(n, pos) {
-      return (n >> BigInt(pos)) & _1n$4;
-  }
-  /**
-   * Sets single bit at position.
-   */
-  function bitSet(n, pos, value) {
-      return n | ((value ? _1n$4 : _0n$3) << BigInt(pos));
-  }
   /**
    * Calculate mask for N bits. Not using ** operator with bigints because of old engines.
    * Same as BigInt(`0b${Array(i).fill('1').join('')}`)
@@ -13147,20 +13110,6 @@
           checkField(fieldName, type, true);
       return object;
   }
-  // validate type tests
-  // const o: { a: number; b: number; c: number } = { a: 1, b: 5, c: 6 };
-  // const z0 = validateObject(o, { a: 'isSafeInteger' }, { c: 'bigint' }); // Ok!
-  // // Should fail type-check
-  // const z1 = validateObject(o, { a: 'tmp' }, { c: 'zz' });
-  // const z2 = validateObject(o, { a: 'isSafeInteger' }, { c: 'zz' });
-  // const z3 = validateObject(o, { test: 'boolean', z: 'bug' });
-  // const z4 = validateObject(o, { a: 'boolean', z: 'bug' });
-  /**
-   * throws not implemented error
-   */
-  const notImplemented = () => {
-      throw new Error('not implemented');
-  };
   /**
    * Memoizes (caches) computation result.
    * Uses WeakMap: the value is going auto-cleaned by GC after last reference is removed.
@@ -13182,28 +13131,22 @@
     aInRange: aInRange,
     abool: abool,
     abytes: abytes,
-    bitGet: bitGet,
     bitLen: bitLen,
     bitMask: bitMask,
-    bitSet: bitSet,
     bytesToHex: bytesToHex,
     bytesToNumberBE: bytesToNumberBE,
     bytesToNumberLE: bytesToNumberLE,
     concatBytes: concatBytes,
     createHmacDrbg: createHmacDrbg,
     ensureBytes: ensureBytes,
-    equalBytes: equalBytes$1,
     hexToBytes: hexToBytes,
     hexToNumber: hexToNumber,
     inRange: inRange,
     isBytes: isBytes$1,
     memoized: memoized,
-    notImplemented: notImplemented,
     numberToBytesBE: numberToBytesBE,
     numberToBytesLE: numberToBytesLE,
     numberToHexUnpadded: numberToHexUnpadded,
-    numberToVarBytesBE: numberToVarBytesBE,
-    utf8ToBytes: utf8ToBytes,
     validateObject: validateObject
   });
 
@@ -16580,7 +16523,7 @@
   function requireSparkMd5 () {
   	if (hasRequiredSparkMd5) return sparkMd5.exports;
   	hasRequiredSparkMd5 = 1;
-  	(function (module, exports) {
+  	(function (module, exports$1) {
   		(function (factory) {
   		    {
   		        // Node/CommonJS
@@ -17577,7 +17520,7 @@
   function requireBuffer () {
   	if (hasRequiredBuffer) return buffer;
   	hasRequiredBuffer = 1;
-  	(function (exports) {
+  	(function (exports$1) {
 
   		const base64 = requireBase64Js();
   		const ieee754 = requireIeee754();
@@ -17586,12 +17529,12 @@
   		    ? Symbol['for']('nodejs.util.inspect.custom') // eslint-disable-line dot-notation
   		    : null;
 
-  		exports.Buffer = Buffer;
-  		exports.SlowBuffer = SlowBuffer;
-  		exports.INSPECT_MAX_BYTES = 50;
+  		exports$1.Buffer = Buffer;
+  		exports$1.SlowBuffer = SlowBuffer;
+  		exports$1.INSPECT_MAX_BYTES = 50;
 
   		const K_MAX_LENGTH = 0x7fffffff;
-  		exports.kMaxLength = K_MAX_LENGTH;
+  		exports$1.kMaxLength = K_MAX_LENGTH;
 
   		/**
   		 * If `Buffer.TYPED_ARRAY_SUPPORT`:
@@ -18187,7 +18130,7 @@
 
   		Buffer.prototype.inspect = function inspect () {
   		  let str = '';
-  		  const max = exports.INSPECT_MAX_BYTES;
+  		  const max = exports$1.INSPECT_MAX_BYTES;
   		  str = this.toString('hex', 0, max).replace(/(.{2})/g, '$1 ').trim();
   		  if (this.length > max) str += ' ... ';
   		  return '<Buffer ' + str + '>'
@@ -43911,7 +43854,9 @@
       async execute(client, requestTimeout) {
           // we check if its local node then backoff mechanism should be disabled
           // and we increase the retry attempts
-          const isLocalNode = client.network["127.0.0.1:50211"] != null;
+          const isLocalNode =
+              client.network["127.0.0.1:50211"] != null ||
+              client.network["localhost:8080"] != null;
 
           if (this.isBatchedAndNotBatchTransaction()) {
               throw new Error(
@@ -44073,13 +44018,16 @@
                       this._nodeAccountIds.index ===
                       this._nodeAccountIds.list.length - 1;
 
-                  // Check if the request is a transaction receipt or record
-                  // request to retry 10 times, because getReceiptQuery/getRecordQuery
-                  // are single node requests
-                  if (
-                      isTransactionReceiptOrRecordRequest(request) ||
-                      isLocalNode
-                  ) {
+                  // Check if the request is a transaction receipt or record request
+                  // with a single node (traditional behavior), or if it's a local node.
+                  // For single-node receipt queries, we retry the same node with backoff.
+                  // For multi-node receipt queries (when failover is enabled), we allow
+                  // advancing to the next node like other queries.
+                  const isSingleNodeReceiptOrRecordRequest =
+                      isTransactionReceiptOrRecordRequest(request) &&
+                      this._nodeAccountIds.length <= 1;
+
+                  if (isSingleNodeReceiptOrRecordRequest || isLocalNode) {
                       await delayForAttempt(
                           isLocalNode,
                           attempt,
@@ -46911,7 +46859,8 @@
   /**
    * @typedef {import("../account/AccountId.js").default} AccountId
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -47539,7 +47488,7 @@
   	if (hasRequiredBn) return bn$1.exports;
   	hasRequiredBn = 1;
   	(function (module) {
-  		(function (module, exports) {
+  		(function (module, exports$1) {
 
   		  // Utils
   		  function assert (val, msg) {
@@ -47582,7 +47531,7 @@
   		  if (typeof module === 'object') {
   		    module.exports = BN;
   		  } else {
-  		    exports.BN = BN;
+  		    exports$1.BN = BN;
   		  }
 
   		  BN.BN = BN;
@@ -49352,6 +49301,7 @@
   		      this.words[i] = carry;
   		      this.length++;
   		    }
+  		    this.length = num === 0 ? 1 : this.length;
 
   		    return isNegNum ? this.ineg() : this;
   		  };
@@ -49557,6 +49507,11 @@
   		      this.words[this.length - 1] &= mask;
   		    }
 
+  		    if (this.length === 0) {
+  		      this.words[0] = 0;
+  		      this.length = 1;
+  		    }
+
   		    return this._strip();
   		  };
 
@@ -51074,7 +51029,7 @@
               if (value % 1) {
                   throwFault("underflow", "BigNumber.from", value);
               }
-              if (value >= MAX_SAFE || value <= -9007199254740991) {
+              if (value >= MAX_SAFE || value <= -MAX_SAFE) {
                   throwFault("overflow", "BigNumber.from", value);
               }
               return BigNumber.from(String(value));
@@ -56103,7 +56058,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../account/AccountId.js").default} AccountId
    */
 
@@ -56531,7 +56487,9 @@
 
 
   /**
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/Channel.js").default} Channel
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("./Transaction.js").default} Transaction
    * @typedef {import("./TransactionReceipt.js").default} TransactionReceipt
    * @typedef {import("./TransactionRecord.js").default} TransactionRecord
@@ -56564,6 +56522,7 @@
        * @param {TransactionId} props.transactionId
        * @param {Transaction} [props.transaction]
        * @param {Logger | null} [props.logger]
+       * @param {AccountId[]} [props.transactionNodeAccountIds]
        */
       constructor(props) {
           /** @readonly */
@@ -56577,6 +56536,14 @@
           this.transaction = props.transaction;
 
           this.logger = props.logger;
+
+          /**
+           * The node account IDs that were configured on the transaction.
+           * Used for receipt query failover when allowReceiptNodeFailover is enabled.
+           * @internal
+           * @type {AccountId[] | undefined}
+           */
+          this.transactionNodeAccountIds = props.transactionNodeAccountIds;
       }
 
       /**
@@ -56598,7 +56565,7 @@
       async getReceipt(client) {
           let receipt;
           try {
-              receipt = await this.getReceiptQuery().execute(client);
+              receipt = await this.getReceiptQuery(client).execute(client);
           } catch (err) {
               if (
                   err instanceof ReceiptStatusError &&
@@ -56634,7 +56601,7 @@
       async getRecord(client) {
           await this.getReceipt(client);
 
-          return this.getRecordQuery().execute(client);
+          return this.getRecordQuery(client).execute(client);
       }
 
       /**
@@ -56646,10 +56613,10 @@
       async getVerboseRecord(client) {
           try {
               // The receipt needs to be called in order to wait for transaction to be included in the consensus. Otherwise we are going to get "DUPLICATE_TRANSACTION".
-              await this.getReceiptQuery().execute(client);
-              return this.getRecordQuery().execute(client);
+              await this.getReceiptQuery(client).execute(client);
+              return this.getRecordQuery(client).execute(client);
           } catch (e) {
-              return this.getRecordQuery().execute(client);
+              return this.getRecordQuery(client).execute(client);
           }
       }
 
@@ -56682,21 +56649,97 @@
       }
 
       /**
+       * Create a receipt query for this transaction.
+       *
+       * By default, the query is pinned to the submitting node only. If the client has
+       * `allowReceiptNodeFailover` enabled, the query can fail over to other nodes while
+       * still starting with the submitting node first.
+       *
+       * When failover is enabled, the node list is determined by:
+       * 1. Transaction's configured nodes (if transaction had specific nodes set), or
+       * 2. Client's network nodes (as fallback)
+       *
+       * @param {Client} [client] - Optional client to enable failover behavior
        * @returns {TransactionReceiptQuery}
        */
-      getReceiptQuery() {
-          return new TransactionReceiptQuery()
-              .setTransactionId(this.transactionId)
-              .setNodeAccountIds([this.nodeId]);
+      getReceiptQuery(client) {
+          const query = new TransactionReceiptQuery().setTransactionId(
+              this.transactionId,
+          );
+
+          // If client is provided and failover is enabled, construct a node list
+          // that starts with the submitting node followed by other nodes
+          if (client != null && client.allowReceiptNodeFailover) {
+              // Use transaction's configured nodes if available, otherwise use client network
+              const availableNodes =
+                  this.transactionNodeAccountIds != null &&
+                  this.transactionNodeAccountIds.length > 0
+                      ? this.transactionNodeAccountIds
+                      : client._network.getNodeAccountIdsForExecute();
+
+              // Build node list: [submittedNode, ...otherNodes] without duplicates
+              const nodeList = [this.nodeId];
+              for (const node of availableNodes) {
+                  // Only add if it's not the submitting node (avoid duplicates)
+                  if (!node.equals(this.nodeId)) {
+                      nodeList.push(node);
+                  }
+              }
+
+              query.setNodeAccountIds(nodeList);
+          } else {
+              // Default behavior: pin to submitting node only
+              query.setNodeAccountIds([this.nodeId]);
+          }
+
+          return query;
       }
 
       /**
+       * Create a record query for this transaction.
+       *
+       * By default, the query is pinned to the submitting node only. If the client has
+       * `allowReceiptNodeFailover` enabled, the query can fail over to other nodes while
+       * still starting with the submitting node first.
+       *
+       * When failover is enabled, the node list is determined by:
+       * 1. Transaction's configured nodes (if transaction had specific nodes set), or
+       * 2. Client's network nodes (as fallback)
+       *
+       * @param {Client} [client] - Optional client to enable failover behavior
        * @returns {TransactionRecordQuery}
        */
-      getRecordQuery() {
-          return new TransactionRecordQuery()
-              .setTransactionId(this.transactionId)
-              .setNodeAccountIds([this.nodeId]);
+      getRecordQuery(client) {
+          const query = new TransactionRecordQuery().setTransactionId(
+              this.transactionId,
+          );
+
+          // If client is provided and failover is enabled, construct a node list
+          // that starts with the submitting node followed by other nodes
+          if (client != null && client.allowReceiptNodeFailover) {
+              // Use transaction's configured nodes if available, otherwise use client network
+              const availableNodes =
+                  this.transactionNodeAccountIds != null &&
+                  this.transactionNodeAccountIds.length > 0
+                      ? this.transactionNodeAccountIds
+                      : client._network.getNodeAccountIdsForExecute();
+
+              // Build node list: [submittedNode, ...otherNodes] without duplicates
+              const nodeList = [this.nodeId];
+              for (const node of availableNodes) {
+                  // Only add if it's not the submitting node (avoid duplicates)
+                  if (!node.equals(this.nodeId)) {
+                      nodeList.push(node);
+                  }
+              }
+
+              query.setNodeAccountIds(nodeList);
+          } else {
+              // Default behavior: pin to submitting node only
+              query.setNodeAccountIds([this.nodeId]);
+          }
+
+          return query;
       }
 
       /**
@@ -57367,7 +57410,8 @@
    * @typedef {import("../schedule/ScheduleCreateTransaction.js").default} ScheduleCreateTransaction
    * @typedef {import("../PrivateKey.js").default} PrivateKey
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../Signer.js").Signer} Signer
    */
 
@@ -57393,6 +57437,17 @@
   // This value can be overriden using `setChunkSize` when preparing to submit a messsage via `TopicMessageSubmitTransaction`.
   const CHUNK_SIZE = 1024;
 
+  /**
+   * @param {NonNullable<HieroProto.proto.TransactionBody["data"]>} transactionDataCase
+   * @returns {boolean}
+   */
+  function isMultiTransactionIdType(transactionDataCase) {
+      return (
+          transactionDataCase === "fileAppend" ||
+          transactionDataCase === "consensusSubmitMessage"
+      );
+  }
+
   /**
    * @type {Map<NonNullable<HieroProto.proto.TransactionBody["data"]>, (transactions: HieroProto.proto.ITransaction[], signedTransactions: HieroProto.proto.ISignedTransaction[], transactionIds: TransactionId[], nodeIds: AccountId[], bodies: HieroProto.proto.TransactionBody[]) => Transaction>}
    */
@@ -57775,7 +57830,7 @@
        * @description Batchify method is used to mark a transaction as part of a batch transaction or make it so-called inner transaction.
        * The Transaction will be frozen and signed by the operator of the client.
        *
-       * @param {import("../client/Client.js").default<Channel, *>} client
+       * @param {Client} client
        * @param {Key} batchKey
        * @returns {Promise<this>}
        */
@@ -57785,6 +57840,82 @@
           return await this.signWithOperator(client);
       }
 
+      /**
+       * Validate transaction list shape and consistency.
+       *
+       * @private
+       * @param {NonNullable<HieroProto.proto.TransactionBody["data"]>} transactionDataCase
+       * @param {TransactionId[]} transactionIds
+       * @param {AccountId[]} nodeIds
+       * @param {HieroProto.proto.ITransactionBody[]} bodies
+       * @returns {void}
+       */
+      static _validateTransactionBodies(
+          transactionDataCase,
+          transactionIds,
+          nodeIds,
+          bodies,
+      ) {
+          const hasNoTransactionIds = transactionIds.length === 0;
+          const hasNoBodies = bodies.length === 0;
+
+          if (hasNoTransactionIds || hasNoBodies) {
+              return;
+          }
+
+          const transactionCount = transactionIds.length;
+          const nodeCount = nodeIds.length;
+          const isChunkedTransactionType =
+              isMultiTransactionIdType(transactionDataCase);
+          const hasInvalidLogicalTransactionCount =
+              !isChunkedTransactionType && transactionCount !== 1;
+
+          if (nodeCount === 0) {
+              const hasUnexpectedBodyCountWithoutNodes =
+                  bodies.length !== transactionCount;
+
+              if (
+                  hasUnexpectedBodyCountWithoutNodes ||
+                  hasInvalidLogicalTransactionCount
+              ) {
+                  throw new Error("failed to validate transaction bodies");
+              }
+
+              return;
+          }
+
+          const expectedBodyCount = transactionCount * nodeCount;
+          const hasUnexpectedBodyCount = bodies.length !== expectedBodyCount;
+
+          if (hasUnexpectedBodyCount || hasInvalidLogicalTransactionCount) {
+              throw new Error("failed to validate transaction bodies");
+          }
+
+          const ignoredFields = new Set();
+          ignoredFields.add("nodeAccountID");
+
+          for (
+              let transactionIndex = 0;
+              transactionIndex < transactionCount;
+              transactionIndex++
+          ) {
+              const rowStart = transactionIndex * nodeCount;
+              const referenceBody = bodies[rowStart];
+
+              for (let nodeIndex = 1; nodeIndex < nodeCount; nodeIndex++) {
+                  if (
+                      !compare$1(
+                          referenceBody,
+                          bodies[rowStart + nodeIndex],
+                          ignoredFields,
+                      )
+                  ) {
+                      throw new Error("failed to validate transaction bodies");
+                  }
+              }
+          }
+      }
+
       /**
        * This method is called by each `*Transaction._fromProtobuf()` method. It does
        * all the finalization before the user gets hold of a complete `Transaction`
@@ -57807,22 +57938,12 @@
           bodies,
       ) {
           const body = bodies[0];
-
-          // "row" of the 2-D `bodies` array has all the same contents except for `nodeAccountID`
-          for (let i = 0; i < transactionIds.length; i++) {
-              for (let j = 0; j < nodeIds.length - 1; j++) {
-                  if (
-                      !compare$1(
-                          bodies[i * nodeIds.length + j],
-                          bodies[i * nodeIds.length + j + 1],
-                          // eslint-disable-next-line ie11/no-collection-args
-                          new Set(["nodeAccountID"]),
-                      )
-                  ) {
-                      throw new Error("failed to validate transaction bodies");
-                  }
-              }
-          }
+          Transaction._validateTransactionBodies(
+              transaction._getTransactionDataCase(),
+              transactionIds,
+              nodeIds,
+              bodies,
+          );
 
           // Remove node account IDs of 0
           // _IIRC_ this was initial due to some funny behavior with `ScheduleCreateTransaction`
@@ -58127,6 +58248,43 @@
           );
       }
 
+      /**
+       * Defense-in-depth validation before adding signatures.
+       *
+       * @private
+       * @returns {void}
+       */
+      _validateSignedTransactionBodies() {
+          if (
+              this._transactionIds.length === 0 ||
+              this._signedTransactions.length === 0
+          ) {
+              return;
+          }
+
+          /** @type {HieroProto.proto.ITransactionBody[]} */
+          const bodies = [];
+
+          for (const signedTransaction of this._signedTransactions.list) {
+              if (signedTransaction.bodyBytes == null) {
+                  throw new Error("failed to validate transaction bodies");
+              }
+
+              bodies.push(
+                  libExports.proto.TransactionBody.decode(
+                      /** @type {Uint8Array} */ (signedTransaction.bodyBytes),
+                  ),
+              );
+          }
+
+          Transaction._validateTransactionBodies(
+              this._getTransactionDataCase(),
+              this._transactionIds.list,
+              this._nodeAccountIds.list,
+              bodies,
+          );
+      }
+
       /**
        * Sign the transaction with the public key and signer function
        *
@@ -58158,6 +58316,8 @@
               return this;
           }
 
+          this._validateSignedTransactionBodies();
+
           // If we add a new signer, then we need to re-create all transactions
           this._transactions.clear();
 
@@ -59043,7 +59203,7 @@
        *
        * @override
        * @protected
-       * @param {import("../client/Client.js").default<Channel, *>} client
+       * @param {Client} client
        * @returns {Promise<void>}
        */
       async _beforeExecute(client) {
@@ -59393,6 +59553,9 @@
               transactionId,
               transaction: this,
               logger: this._logger,
+              transactionNodeAccountIds: !this._nodeAccountIds.isEmpty
+                  ? this._nodeAccountIds.list
+                  : undefined,
           });
       }
 
@@ -60938,7 +61101,9 @@
    */
 
   /**
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/Channel.js").default} Channel
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -61081,7 +61246,9 @@
    */
 
   /**
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/Channel.js").default} Channel
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("bignumber.js").default} BigNumber
    */
 
@@ -61234,7 +61401,9 @@
    */
 
   /**
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/Channel.js").default} Channel
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -61452,7 +61621,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../long.js").LongObject} LongObject
@@ -61983,7 +62153,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../long.js").LongObject} LongObject
@@ -62542,7 +62713,8 @@
    * @typedef {import("./HbarAllowance.js").default} HbarAllowance
    * @typedef {import("./TokenAllowance.js").default} TokenAllowance
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../long.js").LongObject} LongObject
@@ -62793,9 +62965,9 @@
            */
           this.hbars = props.hbars;
 
-          this.tokens = props.tokens;
+          this.tokens = props.tokens || new TokenBalanceMap();
 
-          this.tokenDecimals = props.tokenDecimals;
+          this.tokenDecimals = props.tokenDecimals || new TokenDecimalMap();
 
           Object.freeze(this);
       }
@@ -62852,17 +63024,11 @@
           /** @type {HieroProto.proto.ITokenBalance[]} */
           const list = [];
 
-          // eslint-disable-next-line deprecation/deprecation
-          for (const [key, value] of this.tokens != null ? this.tokens : []) {
+          for (const [key, value] of this.tokens) {
               list.push({
                   tokenId: key._toProtobuf(),
                   balance: value,
-                  decimals:
-                      // eslint-disable-next-line deprecation/deprecation
-                      this.tokenDecimals != null
-                          ? // eslint-disable-next-line deprecation/deprecation
-                            this.tokenDecimals.get(key)
-                          : null,
+                  decimals: this.tokenDecimals.get(key),
               });
           }
 
@@ -62893,11 +63059,9 @@
        */
       toJSON() {
           const tokens = [];
-          // eslint-disable-next-line deprecation/deprecation
-          for (const [key, value] of this.tokens != null ? this.tokens : []) {
-              const decimals =
-                  // eslint-disable-next-line deprecation/deprecation
-                  this.tokenDecimals != null ? this.tokenDecimals.get(key) : null;
+
+          for (const [key, value] of this.tokens) {
+              const decimals = this.tokenDecimals.get(key);
 
               tokens.push({
                   tokenId: key.toString(),
@@ -62928,7 +63092,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -63076,7 +63241,6 @@
       }
 
       /**
-       * @override
        * @override
        * @internal
        * @param {HieroProto.proto.IResponse} response
@@ -63093,16 +63257,13 @@
       }
 
       /**
-       * @override
        * @override
        * @internal
        * @param {HieroProto.proto.IResponse} response
-       * @param {AccountId} nodeAccountId
-       * @param {HieroProto.proto.IQuery} request
        * @returns {Promise<AccountBalance>}
        */
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      _mapResponse(response, nodeAccountId, request) {
+
+      _mapResponse(response) {
           const cryptogetAccountBalance =
               /** @type {HieroProto.proto.ICryptoGetAccountBalanceResponse} */ (
                   response.cryptogetAccountBalance
@@ -63144,8 +63305,7 @@
 
   QUERY_REGISTRY.set(
       "cryptogetAccountBalance",
-      // eslint-disable-next-line @typescript-eslint/unbound-method
-      AccountBalanceQuery._fromProtobuf,
+      AccountBalanceQuery._fromProtobuf.bind(null),
   );
 
   // SPDX-License-Identifier: Apache-2.0
@@ -63201,7 +63361,8 @@
   /**
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../Timestamp.js").default} Timestamp
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
@@ -63873,7 +64034,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -65089,7 +65251,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -65377,7 +65540,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -65561,7 +65725,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -71344,7 +71509,8 @@
   /**
    * @typedef {import("../PublicKey.js").default} PublicKey
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<Channel, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionResponse.js").default} TransactionResponse
    * @typedef {import("../schedule/ScheduleCreateTransaction.js").default} ScheduleCreateTransaction
    */
@@ -71657,7 +71823,7 @@
        * Will use the `Client`, if available, to generate a default Transaction ID and select 1/3
        * nodes to prepare this transaction for.
        *
-       * @param {?import("../client/Client.js").default<Channel, *>} client
+       * @param {?Client} client
        * @returns {this}
        */
       freezeWith(client) {
@@ -71721,7 +71887,7 @@
       }
 
       /**
-       * @param {import("../client/Client.js").default<Channel, *>} client
+       * @param {Client} client
        * @param {number=} requestTimeout
        * @returns {Promise<TransactionResponse>}
        */
@@ -71730,7 +71896,7 @@
       }
 
       /**
-       * @param {import("../client/Client.js").default<Channel, *>} client
+       * @param {Client} client
        * @param {number=} requestTimeout
        * @returns {Promise<TransactionResponse[]>}
        */
@@ -72086,7 +72252,8 @@
   /**
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -73299,7 +73466,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -74387,7 +74555,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -79346,7 +79515,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -79628,7 +79798,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -79822,7 +79993,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    */
 
   /**
@@ -81683,7 +81855,8 @@
   /**
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("../PublicKey.js").default} PublicKey
    * @typedef {import("../PrivateKey.js").default} PrivateKey
@@ -83379,7 +83552,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -84111,7 +84285,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -84308,7 +84483,9 @@
 
   /**
    * @typedef {import("../PrivateKey.js").default} PrivateKey
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/Channel.js").default} Channel
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../Signer.js").default} Signer
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("../transaction/Transaction.js").default} Transaction
@@ -84731,7 +84908,8 @@
   /**
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("./CustomFee.js").default} CustomFee
    */
@@ -86041,7 +86219,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -86240,7 +86419,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -87967,7 +88147,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -88166,7 +88347,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -88595,7 +88777,8 @@
   /**
    * @typedef {import("bignumber.js").default} BigNumber
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -89413,7 +89596,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    * @typedef {import("bignumber.js").default} BigNumber
    */
@@ -89679,7 +89863,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -92064,7 +92249,8 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -92766,7 +92952,9 @@
 
   /**
    * @typedef {import("../channel/Channel.js").default} Channel
-   * @typedef {import("../client/Client.js").default<*, *>} Client
+   * @typedef {import("../channel/MirrorChannel.js").default} MirrorChannel
+   * @typedef {import("../client/Client.js").default<Channel, MirrorChannel>} Client
+   * @typedef {import("../Timestamp.js").default} Timestamp
    * @typedef {import("../transaction/TransactionId.js").default} TransactionId
    */
 
@@ -93091,10 +93279,11 @@
       }
 
       /**
+       * @override
        * @returns {string}
        */
       _getLogId() {
-          const timestamp = /** @type {import("../Timestamp.js").default} */ (
+          const timestamp = /** @type {Timestamp} */ (
               this._transactionIds.current.validStart
           );
           return `TransferTransaction:${timestamp.toString()}`;
@@ -93103,8 +93292,7 @@
 
   TRANSACTION_REGISTRY.set(
       "cryptoTransfer",
-      // eslint-disable-next-line @typescript-eslint/unbound-method
-      TransferTransaction._fromProtobuf,
+      TransferTransaction._fromProtobuf.bind(null),
   );
 
   // SPDX-License-Identifier: Apache-2.0
@@ -98114,6 +98302,18 @@
           /** @private */
           this._defaultRegenerateTransactionId = true;
 
+          /**
+           * When enabled, allows receipt queries to fail over to other nodes
+           * if the submitting node is unresponsive. Default is false to preserve
+           * existing semantics where receipt queries are pinned to the submitting node.
+           *
+           * Tradeoff: Improved availability vs the rare case where only the submitting
+           * node may have final failure information.
+           *
+           * @private
+           */
+          this._allowReceiptNodeFailover = false;
+
           /** @private */
           this._requestTimeout = DEFAULT_REQUEST_TIMEOUT;
 
@@ -98462,6 +98662,32 @@
           return this;
       }
 
+      /**
+       * @returns {boolean}
+       */
+      get allowReceiptNodeFailover() {
+          return this._allowReceiptNodeFailover;
+      }
+
+      /**
+       * Enable or disable receipt query failover to other nodes when the submitting node
+       * is unresponsive. When enabled, receipt queries will start with the submitting node
+       * but can fail over to other nodes in the network if needed.
+       *
+       * Default is `false` to preserve existing behavior where receipt queries are pinned
+       * to the submitting node only.
+       *
+       * **Tradeoff**: Enabling this improves availability for high-throughput/relay use cases,
+       * but in rare cases only the submitting node may have the final failure information.
+       *
+       * @param {boolean} allowReceiptNodeFailover
+       * @returns {this}
+       */
+      setAllowReceiptNodeFailover(allowReceiptNodeFailover) {
+          this._allowReceiptNodeFailover = allowReceiptNodeFailover;
+          return this;
+      }
+
       /**
        * @returns {Hbar}
        */
@@ -98947,7 +99173,7 @@
 
   const SDK_NAME = "hiero-sdk-js";
   const SDK_VERSION =
-      "2.80.0" ;
+      "2.81.0" ;
 
   // SPDX-License-Identifier: Apache-2.0
 
@@ -100342,3 +100568,4 @@
   exports.WebClient = WebClient;
 
 }));
+//# sourceMappingURL=umd.js.map