@hiero-ledger/sdk 2.80.0 → 2.81.0-beta.1

package/lib/transaction/TransactionResponse.cjs

@@ -50,6 +50,7 @@ class TransactionResponse {
    * @param {TransactionId} props.transactionId
    * @param {Transaction} [props.transaction]
    * @param {Logger | null} [props.logger]
+   * @param {AccountId[]} [props.transactionNodeAccountIds]
    */
   constructor(props) {
     /** @readonly */
@@ -60,6 +61,14 @@ class TransactionResponse {
     this.transactionId = props.transactionId;
     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;
   }
 
   /**
@@ -81,7 +90,7 @@ class TransactionResponse {
   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.default && err.status === _Status.default.ThrottledAtConsensus) {
         this.logger?.info("Transaction throttled at consensus");
@@ -108,7 +117,7 @@ class TransactionResponse {
    */
   async getRecord(client) {
     await this.getReceipt(client);
-    return this.getRecordQuery().execute(client);
+    return this.getRecordQuery(client).execute(client);
   }
 
   /**
@@ -120,10 +129,10 @@ class TransactionResponse {
   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);
     }
   }
 
@@ -153,17 +162,81 @@ class TransactionResponse {
   }
 
   /**
+   * 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.default().setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId]);
+  getReceiptQuery(client) {
+    const query = new _TransactionReceiptQuery.default().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.default().setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId]);
+  getRecordQuery(client) {
+    const query = new _TransactionRecordQuery.default().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;
   }
 
   /**

package/lib/transaction/TransactionResponse.d.ts

@@ -35,6 +35,7 @@ export default class TransactionResponse {
      * @param {TransactionId} props.transactionId
      * @param {Transaction} [props.transaction]
      * @param {Logger | null} [props.logger]
+     * @param {AccountId[]} [props.transactionNodeAccountIds]
      */
     constructor(props: {
         nodeId: AccountId;
@@ -42,6 +43,7 @@ export default class TransactionResponse {
         transactionId: TransactionId;
         transaction?: import("./Transaction.js").default | undefined;
         logger?: import("../logger/Logger.js").default | null | undefined;
+        transactionNodeAccountIds?: AccountId[] | undefined;
     });
     /** @readonly */
     readonly nodeId: AccountId;
@@ -50,6 +52,13 @@ export default class TransactionResponse {
     transactionId: TransactionId;
     transaction: import("./Transaction.js").default | undefined;
     logger: import("../logger/Logger.js").default | null | undefined;
+    /**
+     * The node account IDs that were configured on the transaction.
+     * Used for receipt query failover when allowReceiptNodeFailover is enabled.
+     * @internal
+     * @type {AccountId[] | undefined}
+     */
+    transactionNodeAccountIds: AccountId[] | undefined;
     /**
      * @param {Client} client
      * @returns {Promise<TransactionReceipt>}
@@ -80,13 +89,35 @@ export default class TransactionResponse {
      */
     getRecordWithSigner(signer: Signer): Promise<TransactionRecord>;
     /**
+     * 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(): TransactionReceiptQuery;
+    getReceiptQuery(client?: Client): TransactionReceiptQuery;
     /**
+     * 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(): TransactionRecordQuery;
+    getRecordQuery(client?: Client): TransactionRecordQuery;
     /**
      * @returns {TransactionResponseJSON}
      */

package/lib/transaction/TransactionResponse.js

@@ -1,2 +1,2 @@
-import t from"../ReceiptStatusError.js";import r from"../Status.js";import e from"./TransactionReceiptQuery.js";import n from"./TransactionRecordQuery.js";import s from"../account/AccountId.js";import a from"./TransactionId.js";import{decode as o,encode as i}from"../encoding/hex.js";import{wait as c}from"../util.js";class h{constructor(t){this.nodeId=t.nodeId,this.transactionHash=t.transactionHash,this.transactionId=t.transactionId,this.transaction=t.transaction,this.logger=t.logger}static fromJSON(t){return new h({nodeId:s.fromString(t.nodeId),transactionHash:o(t.transactionHash),transactionId:a.fromString(t.transactionId)})}async getReceipt(e){let n;try{n=await this.getReceiptQuery().execute(e)}catch(n){if(n instanceof t&&n.status===r.ThrottledAtConsensus)return this.logger?.info("Transaction throttled at consensus"),this._retryTransaction(e);throw n}if(n.status!==r.Success&&n.status!==r.FeeScheduleFilePartUploaded)throw new t({transactionReceipt:n,status:n.status,transactionId:this.transactionId});return n}async getRecord(t){return await this.getReceipt(t),this.getRecordQuery().execute(t)}async getVerboseRecord(t){try{return await this.getReceiptQuery().execute(t),this.getRecordQuery().execute(t)}catch(r){return this.getRecordQuery().execute(t)}}async getReceiptWithSigner(e){const n=await this.getReceiptQuery().executeWithSigner(e);if(n.status!==r.Success)throw new t({transactionReceipt:n,status:n.status,transactionId:this.transactionId});return n}async getRecordWithSigner(t){return await this.getReceiptWithSigner(t),this.getRecordQuery().executeWithSigner(t)}getReceiptQuery(){return(new e).setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId])}getRecordQuery(){return(new n).setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId])}toJSON(){return{nodeId:this.nodeId.toString(),transactionHash:i(this.transactionHash),transactionId:this.transactionId.toString()}}async _retryTransaction(n){if(!this.transaction)throw new Error("If you retry transaction you should have the transaction set");if(n.operatorAccountId?.toString()!==this.transaction.transactionId?.accountId?.toString())throw new Error("Retry mechanism is not supported when tx id is not generated by the operator account");if(null===n.operatorAccountId)throw new Error("Operator account is not set");let s=250;for(let a=0;a<5;a++){if(this.logger?.trace(`Transaction throttled, retry attempt ${a}`),this.transaction?._resetTransaction(n),null==this.transaction||null==this.transaction.transactionId)throw new Error("Transaction or Transaction ID is null after reset");this.transactionId=this.transaction.transactionId,a>0&&(await c(Math.min(s,16e3)),s*=2);try{this.transaction._resetTransaction(n);const t=await this.transaction.execute(n),s=await(new e).setTransactionId(t.transactionId).setNodeAccountIds([t.nodeId]).execute(n);if(s.status!==r.ThrottledAtConsensus)return this.logger?.info(`Transaction throttle retry succeeded after attempt ${a}`),s}catch(e){if(e instanceof t&&e.status===r.ThrottledAtConsensus){this.logger?.info("Transaction throttled at consensus");continue}throw this.logger?.error(`An error occurred after throttle retry: ${e instanceof Error?e.message:String(e)}`),e}}throw this.logger?.error("Transaction throttle retry failed after maximum attempts"),new Error("Transaction retry failed after maximum attempts")}toString(){return JSON.stringify(this.toJSON())}}export{h as default};
+import t from"../ReceiptStatusError.js";import e from"../Status.js";import n from"./TransactionReceiptQuery.js";import r from"./TransactionRecordQuery.js";import o from"../account/AccountId.js";import s from"./TransactionId.js";import{decode as a,encode as i}from"../encoding/hex.js";import{wait as c}from"../util.js";class d{constructor(t){this.nodeId=t.nodeId,this.transactionHash=t.transactionHash,this.transactionId=t.transactionId,this.transaction=t.transaction,this.logger=t.logger,this.transactionNodeAccountIds=t.transactionNodeAccountIds}static fromJSON(t){return new d({nodeId:o.fromString(t.nodeId),transactionHash:a(t.transactionHash),transactionId:s.fromString(t.transactionId)})}async getReceipt(n){let r;try{r=await this.getReceiptQuery(n).execute(n)}catch(r){if(r instanceof t&&r.status===e.ThrottledAtConsensus)return this.logger?.info("Transaction throttled at consensus"),this._retryTransaction(n);throw r}if(r.status!==e.Success&&r.status!==e.FeeScheduleFilePartUploaded)throw new t({transactionReceipt:r,status:r.status,transactionId:this.transactionId});return r}async getRecord(t){return await this.getReceipt(t),this.getRecordQuery(t).execute(t)}async getVerboseRecord(t){try{return await this.getReceiptQuery(t).execute(t),this.getRecordQuery(t).execute(t)}catch(e){return this.getRecordQuery(t).execute(t)}}async getReceiptWithSigner(n){const r=await this.getReceiptQuery().executeWithSigner(n);if(r.status!==e.Success)throw new t({transactionReceipt:r,status:r.status,transactionId:this.transactionId});return r}async getRecordWithSigner(t){return await this.getReceiptWithSigner(t),this.getRecordQuery().executeWithSigner(t)}getReceiptQuery(t){const e=(new n).setTransactionId(this.transactionId);if(null!=t&&t.allowReceiptNodeFailover){const n=null!=this.transactionNodeAccountIds&&this.transactionNodeAccountIds.length>0?this.transactionNodeAccountIds:t._network.getNodeAccountIdsForExecute(),r=[this.nodeId];for(const t of n)t.equals(this.nodeId)||r.push(t);e.setNodeAccountIds(r)}else e.setNodeAccountIds([this.nodeId]);return e}getRecordQuery(t){const e=(new r).setTransactionId(this.transactionId);if(null!=t&&t.allowReceiptNodeFailover){const n=null!=this.transactionNodeAccountIds&&this.transactionNodeAccountIds.length>0?this.transactionNodeAccountIds:t._network.getNodeAccountIdsForExecute(),r=[this.nodeId];for(const t of n)t.equals(this.nodeId)||r.push(t);e.setNodeAccountIds(r)}else e.setNodeAccountIds([this.nodeId]);return e}toJSON(){return{nodeId:this.nodeId.toString(),transactionHash:i(this.transactionHash),transactionId:this.transactionId.toString()}}async _retryTransaction(r){if(!this.transaction)throw new Error("If you retry transaction you should have the transaction set");if(r.operatorAccountId?.toString()!==this.transaction.transactionId?.accountId?.toString())throw new Error("Retry mechanism is not supported when tx id is not generated by the operator account");if(null===r.operatorAccountId)throw new Error("Operator account is not set");let o=250;for(let s=0;s<5;s++){if(this.logger?.trace(`Transaction throttled, retry attempt ${s}`),this.transaction?._resetTransaction(r),null==this.transaction||null==this.transaction.transactionId)throw new Error("Transaction or Transaction ID is null after reset");this.transactionId=this.transaction.transactionId,s>0&&(await c(Math.min(o,16e3)),o*=2);try{this.transaction._resetTransaction(r);const t=await this.transaction.execute(r),o=await(new n).setTransactionId(t.transactionId).setNodeAccountIds([t.nodeId]).execute(r);if(o.status!==e.ThrottledAtConsensus)return this.logger?.info(`Transaction throttle retry succeeded after attempt ${s}`),o}catch(n){if(n instanceof t&&n.status===e.ThrottledAtConsensus){this.logger?.info("Transaction throttled at consensus");continue}throw this.logger?.error(`An error occurred after throttle retry: ${n instanceof Error?n.message:String(n)}`),n}}throw this.logger?.error("Transaction throttle retry failed after maximum attempts"),new Error("Transaction retry failed after maximum attempts")}toString(){return JSON.stringify(this.toJSON())}}export{d as default};
 //# sourceMappingURL=TransactionResponse.js.map

package/lib/transaction/TransactionResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionResponse.js","sources":["../../src/transaction/TransactionResponse.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport ReceiptStatusError from \"../ReceiptStatusError.js\";\nimport Status from \"../Status.js\";\nimport TransactionReceiptQuery from \"./TransactionReceiptQuery.js\";\nimport TransactionRecordQuery from \"./TransactionRecordQuery.js\";\nimport AccountId from \"../account/AccountId.js\";\nimport TransactionId from \"./TransactionId.js\";\nimport * as hex from \"../encoding/hex.js\";\nimport { wait } from \"../util.js\";\n\n/**\n * @typedef {import(\"../client/Client.js\").default<*, *>} Client\n * @typedef {import(\"./Transaction.js\").default} Transaction\n * @typedef {import(\"./TransactionReceipt.js\").default} TransactionReceipt\n * @typedef {import(\"./TransactionRecord.js\").default} TransactionRecord\n * @typedef {import(\"../Signer.js\").Signer} Signer\n * @typedef {import(\"../logger/Logger.js\").default} Logger\n */\n\n/**\n * @typedef {object} TransactionResponseJSON\n * @property {string} nodeId\n * @property {string} transactionHash\n * @property {string} transactionId\n */\n\n/**\n * When the client sends the node a transaction of any kind, the node\n * replies with this, which simply says that the transaction passed\n * the pre-check (so the node will submit it to the network) or it failed\n * (so it won't). To learn the consensus result, the client should later\n * obtain a receipt (free), or can buy a more detailed record (not free).\n * <br>\n * See <a href=\"https://docs.hedera.com/guides/docs/hedera-api/miscellaneous/transactionresponse\">Hedera Documentation</a>\n */\nexport default class TransactionResponse {\n    /**\n     * @internal\n     * @param {object} props\n     * @param {AccountId} props.nodeId\n     * @param {Uint8Array} props.transactionHash\n     * @param {TransactionId} props.transactionId\n     * @param {Transaction} [props.transaction]\n     * @param {Logger | null} [props.logger]\n     */\n    constructor(props) {\n        /** @readonly */\n        this.nodeId = props.nodeId;\n\n        /** @readonly */\n        this.transactionHash = props.transactionHash;\n\n        this.transactionId = props.transactionId;\n\n        this.transaction = props.transaction;\n\n        this.logger = props.logger;\n    }\n\n    /**\n     * @param {TransactionResponseJSON} json\n     * @returns {TransactionResponse}\n     */\n    static fromJSON(json) {\n        return new TransactionResponse({\n            nodeId: AccountId.fromString(json.nodeId),\n            transactionHash: hex.decode(json.transactionHash),\n            transactionId: TransactionId.fromString(json.transactionId),\n        });\n    }\n\n    /**\n     * @param {Client} client\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async getReceipt(client) {\n        let receipt;\n        try {\n            receipt = await this.getReceiptQuery().execute(client);\n        } catch (err) {\n            if (\n                err instanceof ReceiptStatusError &&\n                err.status === Status.ThrottledAtConsensus\n            ) {\n                this.logger?.info(\"Transaction throttled at consensus\");\n                // need to reset the transaction to its initial state before retrying\n                return this._retryTransaction(client);\n            }\n            throw err;\n        }\n\n        if (\n            receipt.status !== Status.Success &&\n            receipt.status !== Status.FeeScheduleFilePartUploaded\n        ) {\n            throw new ReceiptStatusError({\n                transactionReceipt: receipt,\n                status: receipt.status,\n                transactionId: this.transactionId,\n            });\n        }\n\n        return receipt;\n    }\n\n    /**\n     * getRecord is calling getReceipt and in case the receipt status code is not OK, only the receipt is returned.\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getRecord(client) {\n        await this.getReceipt(client);\n\n        return this.getRecordQuery().execute(client);\n    }\n\n    /**\n     * getVerboseRecord is calling getReceipt and in case the receipt status code is not OK, the record is returned.\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getVerboseRecord(client) {\n        try {\n            // 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\".\n            await this.getReceiptQuery().execute(client);\n            return this.getRecordQuery().execute(client);\n        } catch (e) {\n            return this.getRecordQuery().execute(client);\n        }\n    }\n\n    /**\n     * @param {Signer} signer\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async getReceiptWithSigner(signer) {\n        const receipt = await this.getReceiptQuery().executeWithSigner(signer);\n\n        if (receipt.status !== Status.Success) {\n            throw new ReceiptStatusError({\n                transactionReceipt: receipt,\n                status: receipt.status,\n                transactionId: this.transactionId,\n            });\n        }\n\n        return receipt;\n    }\n\n    /**\n     * @param {Signer} signer\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getRecordWithSigner(signer) {\n        await this.getReceiptWithSigner(signer);\n\n        return this.getRecordQuery().executeWithSigner(signer);\n    }\n\n    /**\n     * @returns {TransactionReceiptQuery}\n     */\n    getReceiptQuery() {\n        return new TransactionReceiptQuery()\n            .setTransactionId(this.transactionId)\n            .setNodeAccountIds([this.nodeId]);\n    }\n\n    /**\n     * @returns {TransactionRecordQuery}\n     */\n    getRecordQuery() {\n        return new TransactionRecordQuery()\n            .setTransactionId(this.transactionId)\n            .setNodeAccountIds([this.nodeId]);\n    }\n\n    /**\n     * @returns {TransactionResponseJSON}\n     */\n    toJSON() {\n        return {\n            nodeId: this.nodeId.toString(),\n            transactionHash: hex.encode(this.transactionHash),\n            transactionId: this.transactionId.toString(),\n        };\n    }\n\n    /**\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async _retryTransaction(client) {\n        if (!this.transaction) {\n            throw new Error(\n                \"If you retry transaction you should have the transaction set\",\n            );\n        }\n\n        if (\n            client.operatorAccountId?.toString() !==\n            this.transaction.transactionId?.accountId?.toString()\n        ) {\n            throw new Error(\n                \"Retry mechanism is not supported when tx id is not generated by the operator account\",\n            );\n        }\n\n        if (client.operatorAccountId === null) {\n            throw new Error(\"Operator account is not set\");\n        }\n\n        const MAX_RETRIES = 5;\n        const MAX_BACKOFF = 16000;\n        let BACKOFF = 250; // milliseconds\n\n        for (let i = 0; i < MAX_RETRIES; i++) {\n            this.logger?.trace(`Transaction throttled, retry attempt ${i}`);\n            this.transaction?._resetTransaction(client);\n            if (\n                this.transaction == null ||\n                this.transaction.transactionId == null\n            ) {\n                throw new Error(\n                    \"Transaction or Transaction ID is null after reset\",\n                );\n            }\n            // need to set the transactionId again in case we are doing getRecord afterwards\n            this.transactionId = this.transaction.transactionId;\n            if (i > 0) {\n                // Wait with exponential backoff before retrying\n                await wait(Math.min(BACKOFF, MAX_BACKOFF));\n                BACKOFF *= 2; // Double the backoff for next retry\n            }\n\n            try {\n                this.transaction._resetTransaction(client);\n                const resp = await this.transaction.execute(client);\n\n                const receipt = await new TransactionReceiptQuery()\n                    .setTransactionId(resp.transactionId)\n                    .setNodeAccountIds([resp.nodeId])\n                    .execute(client);\n\n                if (receipt.status !== Status.ThrottledAtConsensus) {\n                    this.logger?.info(\n                        `Transaction throttle retry succeeded after attempt ${i}`,\n                    );\n                    return receipt;\n                }\n            } catch (err) {\n                if (\n                    err instanceof ReceiptStatusError &&\n                    err.status === Status.ThrottledAtConsensus\n                ) {\n                    this.logger?.info(\"Transaction throttled at consensus\");\n                    // Continue to next retry on error\n                    continue;\n                }\n                this.logger?.error(\n                    `An error occurred after throttle retry: ${\n                        err instanceof Error ? err.message : String(err)\n                    }`,\n                );\n                throw err;\n            }\n        }\n\n        this.logger?.error(\n            \"Transaction throttle retry failed after maximum attempts\",\n        );\n        throw new Error(\"Transaction retry failed after maximum attempts\");\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON());\n    }\n}\n"],"names":["TransactionResponse","constructor","props","this","nodeId","transactionHash","transactionId","transaction","logger","fromJSON","json","AccountId","fromString","hex.decode","TransactionId","getReceipt","client","receipt","getReceiptQuery","execute","err","ReceiptStatusError","status","Status","ThrottledAtConsensus","info","_retryTransaction","Success","FeeScheduleFilePartUploaded","transactionReceipt","getRecord","getRecordQuery","getVerboseRecord","e","getReceiptWithSigner","signer","executeWithSigner","getRecordWithSigner","TransactionReceiptQuery","setTransactionId","setNodeAccountIds","TransactionRecordQuery","toJSON","toString","hex.encode","Error","operatorAccountId","accountId","BACKOFF","i","trace","_resetTransaction","wait","Math","min","resp","error","message","String","JSON","stringify"],"mappings":"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"}
+{"version":3,"file":"TransactionResponse.js","sources":["../../src/transaction/TransactionResponse.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport ReceiptStatusError from \"../ReceiptStatusError.js\";\nimport Status from \"../Status.js\";\nimport TransactionReceiptQuery from \"./TransactionReceiptQuery.js\";\nimport TransactionRecordQuery from \"./TransactionRecordQuery.js\";\nimport AccountId from \"../account/AccountId.js\";\nimport TransactionId from \"./TransactionId.js\";\nimport * as hex from \"../encoding/hex.js\";\nimport { wait } from \"../util.js\";\n\n/**\n * @typedef {import(\"../client/Client.js\").default<*, *>} Client\n * @typedef {import(\"./Transaction.js\").default} Transaction\n * @typedef {import(\"./TransactionReceipt.js\").default} TransactionReceipt\n * @typedef {import(\"./TransactionRecord.js\").default} TransactionRecord\n * @typedef {import(\"../Signer.js\").Signer} Signer\n * @typedef {import(\"../logger/Logger.js\").default} Logger\n */\n\n/**\n * @typedef {object} TransactionResponseJSON\n * @property {string} nodeId\n * @property {string} transactionHash\n * @property {string} transactionId\n */\n\n/**\n * When the client sends the node a transaction of any kind, the node\n * replies with this, which simply says that the transaction passed\n * the pre-check (so the node will submit it to the network) or it failed\n * (so it won't). To learn the consensus result, the client should later\n * obtain a receipt (free), or can buy a more detailed record (not free).\n * <br>\n * See <a href=\"https://docs.hedera.com/guides/docs/hedera-api/miscellaneous/transactionresponse\">Hedera Documentation</a>\n */\nexport default class TransactionResponse {\n    /**\n     * @internal\n     * @param {object} props\n     * @param {AccountId} props.nodeId\n     * @param {Uint8Array} props.transactionHash\n     * @param {TransactionId} props.transactionId\n     * @param {Transaction} [props.transaction]\n     * @param {Logger | null} [props.logger]\n     * @param {AccountId[]} [props.transactionNodeAccountIds]\n     */\n    constructor(props) {\n        /** @readonly */\n        this.nodeId = props.nodeId;\n\n        /** @readonly */\n        this.transactionHash = props.transactionHash;\n\n        this.transactionId = props.transactionId;\n\n        this.transaction = props.transaction;\n\n        this.logger = props.logger;\n\n        /**\n         * The node account IDs that were configured on the transaction.\n         * Used for receipt query failover when allowReceiptNodeFailover is enabled.\n         * @internal\n         * @type {AccountId[] | undefined}\n         */\n        this.transactionNodeAccountIds = props.transactionNodeAccountIds;\n    }\n\n    /**\n     * @param {TransactionResponseJSON} json\n     * @returns {TransactionResponse}\n     */\n    static fromJSON(json) {\n        return new TransactionResponse({\n            nodeId: AccountId.fromString(json.nodeId),\n            transactionHash: hex.decode(json.transactionHash),\n            transactionId: TransactionId.fromString(json.transactionId),\n        });\n    }\n\n    /**\n     * @param {Client} client\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async getReceipt(client) {\n        let receipt;\n        try {\n            receipt = await this.getReceiptQuery(client).execute(client);\n        } catch (err) {\n            if (\n                err instanceof ReceiptStatusError &&\n                err.status === Status.ThrottledAtConsensus\n            ) {\n                this.logger?.info(\"Transaction throttled at consensus\");\n                // need to reset the transaction to its initial state before retrying\n                return this._retryTransaction(client);\n            }\n            throw err;\n        }\n\n        if (\n            receipt.status !== Status.Success &&\n            receipt.status !== Status.FeeScheduleFilePartUploaded\n        ) {\n            throw new ReceiptStatusError({\n                transactionReceipt: receipt,\n                status: receipt.status,\n                transactionId: this.transactionId,\n            });\n        }\n\n        return receipt;\n    }\n\n    /**\n     * getRecord is calling getReceipt and in case the receipt status code is not OK, only the receipt is returned.\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getRecord(client) {\n        await this.getReceipt(client);\n\n        return this.getRecordQuery(client).execute(client);\n    }\n\n    /**\n     * getVerboseRecord is calling getReceipt and in case the receipt status code is not OK, the record is returned.\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getVerboseRecord(client) {\n        try {\n            // 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\".\n            await this.getReceiptQuery(client).execute(client);\n            return this.getRecordQuery(client).execute(client);\n        } catch (e) {\n            return this.getRecordQuery(client).execute(client);\n        }\n    }\n\n    /**\n     * @param {Signer} signer\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async getReceiptWithSigner(signer) {\n        const receipt = await this.getReceiptQuery().executeWithSigner(signer);\n\n        if (receipt.status !== Status.Success) {\n            throw new ReceiptStatusError({\n                transactionReceipt: receipt,\n                status: receipt.status,\n                transactionId: this.transactionId,\n            });\n        }\n\n        return receipt;\n    }\n\n    /**\n     * @param {Signer} signer\n     * @returns {Promise<TransactionRecord>}\n     */\n    async getRecordWithSigner(signer) {\n        await this.getReceiptWithSigner(signer);\n\n        return this.getRecordQuery().executeWithSigner(signer);\n    }\n\n    /**\n     * Create a receipt query for this transaction.\n     *\n     * By default, the query is pinned to the submitting node only. If the client has\n     * `allowReceiptNodeFailover` enabled, the query can fail over to other nodes while\n     * still starting with the submitting node first.\n     *\n     * When failover is enabled, the node list is determined by:\n     * 1. Transaction's configured nodes (if transaction had specific nodes set), or\n     * 2. Client's network nodes (as fallback)\n     *\n     * @param {Client} [client] - Optional client to enable failover behavior\n     * @returns {TransactionReceiptQuery}\n     */\n    getReceiptQuery(client) {\n        const query = new TransactionReceiptQuery().setTransactionId(\n            this.transactionId,\n        );\n\n        // If client is provided and failover is enabled, construct a node list\n        // that starts with the submitting node followed by other nodes\n        if (client != null && client.allowReceiptNodeFailover) {\n            // Use transaction's configured nodes if available, otherwise use client network\n            const availableNodes =\n                this.transactionNodeAccountIds != null &&\n                this.transactionNodeAccountIds.length > 0\n                    ? this.transactionNodeAccountIds\n                    : client._network.getNodeAccountIdsForExecute();\n\n            // Build node list: [submittedNode, ...otherNodes] without duplicates\n            const nodeList = [this.nodeId];\n            for (const node of availableNodes) {\n                // Only add if it's not the submitting node (avoid duplicates)\n                if (!node.equals(this.nodeId)) {\n                    nodeList.push(node);\n                }\n            }\n\n            query.setNodeAccountIds(nodeList);\n        } else {\n            // Default behavior: pin to submitting node only\n            query.setNodeAccountIds([this.nodeId]);\n        }\n\n        return query;\n    }\n\n    /**\n     * Create a record query for this transaction.\n     *\n     * By default, the query is pinned to the submitting node only. If the client has\n     * `allowReceiptNodeFailover` enabled, the query can fail over to other nodes while\n     * still starting with the submitting node first.\n     *\n     * When failover is enabled, the node list is determined by:\n     * 1. Transaction's configured nodes (if transaction had specific nodes set), or\n     * 2. Client's network nodes (as fallback)\n     *\n     * @param {Client} [client] - Optional client to enable failover behavior\n     * @returns {TransactionRecordQuery}\n     */\n    getRecordQuery(client) {\n        const query = new TransactionRecordQuery().setTransactionId(\n            this.transactionId,\n        );\n\n        // If client is provided and failover is enabled, construct a node list\n        // that starts with the submitting node followed by other nodes\n        if (client != null && client.allowReceiptNodeFailover) {\n            // Use transaction's configured nodes if available, otherwise use client network\n            const availableNodes =\n                this.transactionNodeAccountIds != null &&\n                this.transactionNodeAccountIds.length > 0\n                    ? this.transactionNodeAccountIds\n                    : client._network.getNodeAccountIdsForExecute();\n\n            // Build node list: [submittedNode, ...otherNodes] without duplicates\n            const nodeList = [this.nodeId];\n            for (const node of availableNodes) {\n                // Only add if it's not the submitting node (avoid duplicates)\n                if (!node.equals(this.nodeId)) {\n                    nodeList.push(node);\n                }\n            }\n\n            query.setNodeAccountIds(nodeList);\n        } else {\n            // Default behavior: pin to submitting node only\n            query.setNodeAccountIds([this.nodeId]);\n        }\n\n        return query;\n    }\n\n    /**\n     * @returns {TransactionResponseJSON}\n     */\n    toJSON() {\n        return {\n            nodeId: this.nodeId.toString(),\n            transactionHash: hex.encode(this.transactionHash),\n            transactionId: this.transactionId.toString(),\n        };\n    }\n\n    /**\n     *\n     * @param {Client} client\n     * @returns {Promise<TransactionReceipt>}\n     */\n    async _retryTransaction(client) {\n        if (!this.transaction) {\n            throw new Error(\n                \"If you retry transaction you should have the transaction set\",\n            );\n        }\n\n        if (\n            client.operatorAccountId?.toString() !==\n            this.transaction.transactionId?.accountId?.toString()\n        ) {\n            throw new Error(\n                \"Retry mechanism is not supported when tx id is not generated by the operator account\",\n            );\n        }\n\n        if (client.operatorAccountId === null) {\n            throw new Error(\"Operator account is not set\");\n        }\n\n        const MAX_RETRIES = 5;\n        const MAX_BACKOFF = 16000;\n        let BACKOFF = 250; // milliseconds\n\n        for (let i = 0; i < MAX_RETRIES; i++) {\n            this.logger?.trace(`Transaction throttled, retry attempt ${i}`);\n            this.transaction?._resetTransaction(client);\n            if (\n                this.transaction == null ||\n                this.transaction.transactionId == null\n            ) {\n                throw new Error(\n                    \"Transaction or Transaction ID is null after reset\",\n                );\n            }\n            // need to set the transactionId again in case we are doing getRecord afterwards\n            this.transactionId = this.transaction.transactionId;\n            if (i > 0) {\n                // Wait with exponential backoff before retrying\n                await wait(Math.min(BACKOFF, MAX_BACKOFF));\n                BACKOFF *= 2; // Double the backoff for next retry\n            }\n\n            try {\n                this.transaction._resetTransaction(client);\n                const resp = await this.transaction.execute(client);\n\n                const receipt = await new TransactionReceiptQuery()\n                    .setTransactionId(resp.transactionId)\n                    .setNodeAccountIds([resp.nodeId])\n                    .execute(client);\n\n                if (receipt.status !== Status.ThrottledAtConsensus) {\n                    this.logger?.info(\n                        `Transaction throttle retry succeeded after attempt ${i}`,\n                    );\n                    return receipt;\n                }\n            } catch (err) {\n                if (\n                    err instanceof ReceiptStatusError &&\n                    err.status === Status.ThrottledAtConsensus\n                ) {\n                    this.logger?.info(\"Transaction throttled at consensus\");\n                    // Continue to next retry on error\n                    continue;\n                }\n                this.logger?.error(\n                    `An error occurred after throttle retry: ${\n                        err instanceof Error ? err.message : String(err)\n                    }`,\n                );\n                throw err;\n            }\n        }\n\n        this.logger?.error(\n            \"Transaction throttle retry failed after maximum attempts\",\n        );\n        throw new Error(\"Transaction retry failed after maximum attempts\");\n    }\n\n    /**\n     * @returns {string}\n     */\n    toString() {\n        return JSON.stringify(this.toJSON());\n    }\n}\n"],"names":["TransactionResponse","constructor","props","this","nodeId","transactionHash","transactionId","transaction","logger","transactionNodeAccountIds","fromJSON","json","AccountId","fromString","hex.decode","TransactionId","getReceipt","client","receipt","getReceiptQuery","execute","err","ReceiptStatusError","status","Status","ThrottledAtConsensus","info","_retryTransaction","Success","FeeScheduleFilePartUploaded","transactionReceipt","getRecord","getRecordQuery","getVerboseRecord","e","getReceiptWithSigner","signer","executeWithSigner","getRecordWithSigner","query","TransactionReceiptQuery","setTransactionId","allowReceiptNodeFailover","availableNodes","length","_network","getNodeAccountIdsForExecute","nodeList","node","equals","push","setNodeAccountIds","TransactionRecordQuery","toJSON","toString","hex.encode","Error","operatorAccountId","accountId","BACKOFF","i","trace","_resetTransaction","wait","Math","min","resp","error","message","String","JSON","stringify"],"mappings":"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"}

package/lib/version.js

@@ -1,2 +1,2 @@
-const o="hiero-sdk-js",s="2.80.0";export{o as SDK_NAME,s as SDK_VERSION};
+const e="hiero-sdk-js",o="2.81.0-beta.1";export{e as SDK_NAME,o as SDK_VERSION};
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiero-ledger/sdk",
-  "version": "2.80.0",
+  "version": "2.81.0-beta.1",
   "description": "Hiero SDK",
   "types": "./lib/index.d.ts",
   "main": "./lib/index.cjs",
@@ -75,12 +75,12 @@
     "long": "5.3.1",
     "pino": "10.1.0",
     "pino-pretty": "13.0.0",
-    "protobufjs": "7.5.4",
+    "protobufjs": "8.0.0",
     "rfc4648": "1.5.3",
     "strip-ansi": "7.1.2",
     "utf8": "3.0.0",
-    "@hiero-ledger/cryptography": "1.16.0-beta.3",
-    "@hiero-ledger/proto": "2.26.0-beta.3"
+    "@hiero-ledger/proto": "2.26.0-beta.3",
+    "@hiero-ledger/cryptography": "1.16.0-beta.3"
   },
   "devDependencies": {
     "@babel/cli": "7.23.4",
@@ -106,25 +106,27 @@
     "@types/utf8": "3.0.1",
     "@typescript-eslint/eslint-plugin": "5.48.2",
     "@typescript-eslint/parser": "5.62.0",
-    "@vitest/browser": "3.2.4",
-    "@vitest/coverage-v8": "3.2.4",
+    "@vitest/browser": "4.0.18",
+    "@vitest/browser-playwright": "4.0.18",
+    "@vitest/coverage-istanbul": "4.0.18",
+    "@vitest/coverage-v8": "4.0.18",
     "babel-plugin-dynamic-import-node": "2.3.3",
     "babel-plugin-module-rewrite": "0.2.0",
     "c8": "10.1.3",
-    "chromedriver": "143.0.3",
+    "chromedriver": "145.0.1",
     "codecov": "3.8.3",
-    "dotenv": "17.0.1",
+    "dotenv": "17.2.3",
     "dpdm": "3.11.0",
     "eslint": "8.57.1",
-    "eslint-plugin-compat": "6.0.2",
+    "eslint-plugin-compat": "6.1.0",
     "eslint-plugin-deprecation": "3.0.0",
     "eslint-plugin-ie11": "1.0.0",
     "eslint-plugin-import": "2.28.1",
-    "eslint-plugin-jsdoc": "61.1.11",
+    "eslint-plugin-jsdoc": "62.5.5",
     "eslint-plugin-n": "17.16.1",
     "eslint-plugin-vitest": "0.3.25",
     "geckodriver": "6.0.1",
-    "jsdom": "27.0.0",
+    "jsdom": "28.1.0",
     "msw": "2.10.2",
     "npm-run-all": "4.1.5",
     "npx": "10.2.2",
@@ -135,8 +137,8 @@
     "sinon": "21.0.0",
     "typedoc": "0.28.1",
     "typescript": "5.7.2",
-    "vite": "6.4.1",
-    "vitest": "3.2.4"
+    "vite": "7.3.1",
+    "vitest": "4.0.18"
   },
   "peerDependencies": {
     "bn.js": "5.2.1"

package/src/Executable.js

@@ -665,13 +665,16 @@ export default class Executable {
                     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,

package/src/PublicKey.js

@@ -114,48 +114,65 @@ export default class PublicKey extends Key {
         // before we execute the transaction (execute -> makeRequest -> buildTransaction -> signTransaction).
         // However, in JavaScript, we build the `_signedTransactions` list while signing the transaction.
         for (const signedTransaction of transaction._signedTransactions.list) {
-            if (
-                signedTransaction.sigMap != null &&
-                signedTransaction.sigMap.sigPair != null
-            ) {
-                let found = false;
-                for (const sigPair of signedTransaction.sigMap.sigPair) {
-                    const pubKeyPrefix = /** @type {Uint8Array} */ (
-                        sigPair.pubKeyPrefix
-                    );
-                    if (arrayEqual(pubKeyPrefix, this.toBytesRaw())) {
-                        found = true;
-
-                        const bodyBytes = /** @type {Uint8Array} */ (
-                            signedTransaction.bodyBytes
-                        );
-
-                        let signature = null;
-                        if (sigPair.ed25519 != null) {
-                            signature = sigPair.ed25519;
-                        } else if (sigPair.ECDSASecp256k1 != null) {
-                            signature = sigPair.ECDSASecp256k1;
-                        }
-
-                        if (signature == null) {
-                            continue;
-                        }
-
-                        if (!this.verify(bodyBytes, signature)) {
-                            return false;
-                        }
-                    }
-                }
-
-                if (!found) {
-                    return false;
-                }
+            if (!this._verifySignedTransaction(signedTransaction)) {
+                return false;
             }
         }
 
         return true;
     }
 
+    /**
+     * @private
+     * @param {HieroProto.proto.ISignedTransaction} signedTransaction
+     * @returns {boolean}
+     */
+    _verifySignedTransaction(signedTransaction) {
+        const sigMap = signedTransaction.sigMap;
+        if (sigMap == null || sigMap.sigPair == null) {
+            return false;
+        }
+
+        const bodyBytes = /** @type {Uint8Array} */ (
+            signedTransaction.bodyBytes
+        );
+        const publicKeyBytes = this.toBytesRaw();
+
+        for (const sigPair of sigMap.sigPair) {
+            const pubKeyPrefix = /** @type {Uint8Array} */ (
+                sigPair.pubKeyPrefix
+            );
+
+            if (!arrayEqual(pubKeyPrefix, publicKeyBytes)) {
+                continue;
+            }
+
+            const signature = this._extractSignature(sigPair);
+            if (signature == null) {
+                return false;
+            }
+
+            return this.verify(bodyBytes, signature);
+        }
+
+        return false;
+    }
+
+    /**
+     * @private
+     * @param {HieroProto.proto.ISignaturePair} sigPair
+     * @returns {Uint8Array | null}
+     */
+    _extractSignature(sigPair) {
+        if (sigPair.ed25519 != null) {
+            return sigPair.ed25519;
+        }
+        if (sigPair.ECDSASecp256k1 != null) {
+            return sigPair.ECDSASecp256k1;
+        }
+        return null;
+    }
+
     /**
      * @returns {Uint8Array}
      */

package/src/RequestType.js

@@ -217,6 +217,10 @@ export default class RequestType {
                 return "LambdaSStore";
             case RequestType.HookDispatch:
                 return "HookDispatch";
+            case RequestType.HookStore:
+                return "HookStore";
+            case RequestType.LedgerIdPublication:
+                return "LedgerIdPublication";
             default:
                 return `UNKNOWN (${this._code})`;
         }
@@ -423,6 +427,10 @@ export default class RequestType {
                 return RequestType.LambdaSStore;
             case 110:
                 return RequestType.HookDispatch;
+            case 111:
+                return RequestType.HookStore;
+            case 112:
+                return RequestType.LedgerIdPublication;
         }
 
         throw new Error(
@@ -936,3 +944,13 @@ RequestType.LambdaSStore = new RequestType(109);
  * hook dispatch
  */
 RequestType.HookDispatch = new RequestType(110);
+
+/**
+ * Update one or more storage slots in an EVM hook.
+ */
+RequestType.HookStore = new RequestType(111);
+
+/**
+ * (Internal-only) Publish a new ledger id and chain-of-trust key.
+ */
+RequestType.LedgerIdPublication = new RequestType(112);