@hiero-ledger/sdk 2.70.0

package/lib/transaction/TransactionResponse.cjs

@@ -0,0 +1,242 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _ReceiptStatusError = _interopRequireDefault(require("../ReceiptStatusError.cjs"));
+var _Status = _interopRequireDefault(require("../Status.cjs"));
+var _TransactionReceiptQuery = _interopRequireDefault(require("./TransactionReceiptQuery.cjs"));
+var _TransactionRecordQuery = _interopRequireDefault(require("./TransactionRecordQuery.cjs"));
+var _AccountId = _interopRequireDefault(require("../account/AccountId.cjs"));
+var _TransactionId = _interopRequireDefault(require("./TransactionId.cjs"));
+var hex = _interopRequireWildcard(require("../encoding/hex.cjs"));
+var _util = require("../util.cjs");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @typedef {import("../client/Client.js").default<*, *>} Client
+ * @typedef {import("./Transaction.js").default} Transaction
+ * @typedef {import("./TransactionReceipt.js").default} TransactionReceipt
+ * @typedef {import("./TransactionRecord.js").default} TransactionRecord
+ * @typedef {import("../Signer.js").Signer} Signer
+ * @typedef {import("../logger/Logger.js").default} Logger
+ */
+
+/**
+ * @typedef {object} TransactionResponseJSON
+ * @property {string} nodeId
+ * @property {string} transactionHash
+ * @property {string} transactionId
+ */
+
+/**
+ * When the client sends the node a transaction of any kind, the node
+ * replies with this, which simply says that the transaction passed
+ * the pre-check (so the node will submit it to the network) or it failed
+ * (so it won't). To learn the consensus result, the client should later
+ * obtain a receipt (free), or can buy a more detailed record (not free).
+ * <br>
+ * See <a href="https://docs.hedera.com/guides/docs/hedera-api/miscellaneous/transactionresponse">Hedera Documentation</a>
+ */
+class TransactionResponse {
+  /**
+   * @internal
+   * @param {object} props
+   * @param {AccountId} props.nodeId
+   * @param {Uint8Array} props.transactionHash
+   * @param {TransactionId} props.transactionId
+   * @param {Transaction} [props.transaction]
+   * @param {Logger | null} [props.logger]
+   */
+  constructor(props) {
+    /** @readonly */
+    this.nodeId = props.nodeId;
+
+    /** @readonly */
+    this.transactionHash = props.transactionHash;
+    this.transactionId = props.transactionId;
+    this.transaction = props.transaction;
+    this.logger = props.logger;
+  }
+
+  /**
+   * @param {TransactionResponseJSON} json
+   * @returns {TransactionResponse}
+   */
+  static fromJSON(json) {
+    return new TransactionResponse({
+      nodeId: _AccountId.default.fromString(json.nodeId),
+      transactionHash: hex.decode(json.transactionHash),
+      transactionId: _TransactionId.default.fromString(json.transactionId)
+    });
+  }
+
+  /**
+   * @param {Client} client
+   * @returns {Promise<TransactionReceipt>}
+   */
+  async getReceipt(client) {
+    let receipt;
+    try {
+      receipt = await this.getReceiptQuery().execute(client);
+    } catch (err) {
+      if (err instanceof _ReceiptStatusError.default && err.status === _Status.default.ThrottledAtConsensus) {
+        this.logger?.info("Transaction throttled at consensus");
+        // need to reset the transaction to its initial state before retrying
+        return this._retryTransaction(client);
+      }
+      throw err;
+    }
+    if (receipt.status !== _Status.default.Success && receipt.status !== _Status.default.FeeScheduleFilePartUploaded) {
+      throw new _ReceiptStatusError.default({
+        transactionReceipt: receipt,
+        status: receipt.status,
+        transactionId: this.transactionId
+      });
+    }
+    return receipt;
+  }
+
+  /**
+   * getRecord is calling getReceipt and in case the receipt status code is not OK, only the receipt is returned.
+   *
+   * @param {Client} client
+   * @returns {Promise<TransactionRecord>}
+   */
+  async getRecord(client) {
+    await this.getReceipt(client);
+    return this.getRecordQuery().execute(client);
+  }
+
+  /**
+   * getVerboseRecord is calling getReceipt and in case the receipt status code is not OK, the record is returned.
+   *
+   * @param {Client} client
+   * @returns {Promise<TransactionRecord>}
+   */
+  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);
+    } catch (e) {
+      return this.getRecordQuery().execute(client);
+    }
+  }
+
+  /**
+   * @param {Signer} signer
+   * @returns {Promise<TransactionReceipt>}
+   */
+  async getReceiptWithSigner(signer) {
+    const receipt = await this.getReceiptQuery().executeWithSigner(signer);
+    if (receipt.status !== _Status.default.Success) {
+      throw new _ReceiptStatusError.default({
+        transactionReceipt: receipt,
+        status: receipt.status,
+        transactionId: this.transactionId
+      });
+    }
+    return receipt;
+  }
+
+  /**
+   * @param {Signer} signer
+   * @returns {Promise<TransactionRecord>}
+   */
+  async getRecordWithSigner(signer) {
+    await this.getReceiptWithSigner(signer);
+    return this.getRecordQuery().executeWithSigner(signer);
+  }
+
+  /**
+   * @returns {TransactionReceiptQuery}
+   */
+  getReceiptQuery() {
+    return new _TransactionReceiptQuery.default().setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId]);
+  }
+
+  /**
+   * @returns {TransactionRecordQuery}
+   */
+  getRecordQuery() {
+    return new _TransactionRecordQuery.default().setTransactionId(this.transactionId).setNodeAccountIds([this.nodeId]);
+  }
+
+  /**
+   * @returns {TransactionResponseJSON}
+   */
+  toJSON() {
+    return {
+      nodeId: this.nodeId.toString(),
+      transactionHash: hex.encode(this.transactionHash),
+      transactionId: this.transactionId.toString()
+    };
+  }
+
+  /**
+   *
+   * @param {Client} client
+   * @returns {Promise<TransactionReceipt>}
+   */
+  async _retryTransaction(client) {
+    if (!this.transaction) {
+      throw new Error("If you retry transaction you should have the transaction set");
+    }
+    if (client.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 (client.operatorAccountId === null) {
+      throw new Error("Operator account is not set");
+    }
+    const MAX_RETRIES = 5;
+    const MAX_BACKOFF = 16000;
+    let BACKOFF = 250; // milliseconds
+
+    for (let i = 0; i < MAX_RETRIES; i++) {
+      this.logger?.trace(`Transaction throttled, retry attempt ${i}`);
+      this.transaction?._resetTransaction(client);
+      if (this.transaction == null || this.transaction.transactionId == null) {
+        throw new Error("Transaction or Transaction ID is null after reset");
+      }
+      // need to set the transactionId again in case we are doing getRecord afterwards
+      this.transactionId = this.transaction.transactionId;
+      if (i > 0) {
+        // Wait with exponential backoff before retrying
+        await (0, _util.wait)(Math.min(BACKOFF, MAX_BACKOFF));
+        BACKOFF *= 2; // Double the backoff for next retry
+      }
+      try {
+        this.transaction._resetTransaction(client);
+        const resp = await this.transaction.execute(client);
+        const receipt = await new _TransactionReceiptQuery.default().setTransactionId(resp.transactionId).setNodeAccountIds([resp.nodeId]).execute(client);
+        if (receipt.status !== _Status.default.ThrottledAtConsensus) {
+          this.logger?.info(`Transaction throttle retry succeeded after attempt ${i}`);
+          return receipt;
+        }
+      } catch (err) {
+        if (err instanceof _ReceiptStatusError.default && err.status === _Status.default.ThrottledAtConsensus) {
+          this.logger?.info("Transaction throttled at consensus");
+          // Continue to next retry on error
+          continue;
+        }
+        this.logger?.error(`An error occurred after throttle retry: ${err instanceof Error ? err.message : String(err)}`);
+        throw err;
+      }
+    }
+    this.logger?.error("Transaction throttle retry failed after maximum attempts");
+    throw new Error("Transaction retry failed after maximum attempts");
+  }
+
+  /**
+   * @returns {string}
+   */
+  toString() {
+    return JSON.stringify(this.toJSON());
+  }
+}
+exports.default = TransactionResponse;

package/lib/transaction/TransactionResponse.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @typedef {import("../client/Client.js").default<*, *>} Client
+ * @typedef {import("./Transaction.js").default} Transaction
+ * @typedef {import("./TransactionReceipt.js").default} TransactionReceipt
+ * @typedef {import("./TransactionRecord.js").default} TransactionRecord
+ * @typedef {import("../Signer.js").Signer} Signer
+ * @typedef {import("../logger/Logger.js").default} Logger
+ */
+/**
+ * @typedef {object} TransactionResponseJSON
+ * @property {string} nodeId
+ * @property {string} transactionHash
+ * @property {string} transactionId
+ */
+/**
+ * When the client sends the node a transaction of any kind, the node
+ * replies with this, which simply says that the transaction passed
+ * the pre-check (so the node will submit it to the network) or it failed
+ * (so it won't). To learn the consensus result, the client should later
+ * obtain a receipt (free), or can buy a more detailed record (not free).
+ * <br>
+ * See <a href="https://docs.hedera.com/guides/docs/hedera-api/miscellaneous/transactionresponse">Hedera Documentation</a>
+ */
+export default class TransactionResponse {
+    /**
+     * @param {TransactionResponseJSON} json
+     * @returns {TransactionResponse}
+     */
+    static fromJSON(json: TransactionResponseJSON): TransactionResponse;
+    /**
+     * @internal
+     * @param {object} props
+     * @param {AccountId} props.nodeId
+     * @param {Uint8Array} props.transactionHash
+     * @param {TransactionId} props.transactionId
+     * @param {Transaction} [props.transaction]
+     * @param {Logger | null} [props.logger]
+     */
+    constructor(props: {
+        nodeId: AccountId;
+        transactionHash: Uint8Array;
+        transactionId: TransactionId;
+        transaction?: import("./Transaction.js").default | undefined;
+        logger?: import("../logger/Logger.js").default | null | undefined;
+    });
+    /** @readonly */
+    readonly nodeId: AccountId;
+    /** @readonly */
+    readonly transactionHash: Uint8Array<ArrayBufferLike>;
+    transactionId: TransactionId;
+    transaction: import("./Transaction.js").default | undefined;
+    logger: import("../logger/Logger.js").default | null | undefined;
+    /**
+     * @param {Client} client
+     * @returns {Promise<TransactionReceipt>}
+     */
+    getReceipt(client: Client): Promise<TransactionReceipt>;
+    /**
+     * getRecord is calling getReceipt and in case the receipt status code is not OK, only the receipt is returned.
+     *
+     * @param {Client} client
+     * @returns {Promise<TransactionRecord>}
+     */
+    getRecord(client: Client): Promise<TransactionRecord>;
+    /**
+     * getVerboseRecord is calling getReceipt and in case the receipt status code is not OK, the record is returned.
+     *
+     * @param {Client} client
+     * @returns {Promise<TransactionRecord>}
+     */
+    getVerboseRecord(client: Client): Promise<TransactionRecord>;
+    /**
+     * @param {Signer} signer
+     * @returns {Promise<TransactionReceipt>}
+     */
+    getReceiptWithSigner(signer: Signer): Promise<TransactionReceipt>;
+    /**
+     * @param {Signer} signer
+     * @returns {Promise<TransactionRecord>}
+     */
+    getRecordWithSigner(signer: Signer): Promise<TransactionRecord>;
+    /**
+     * @returns {TransactionReceiptQuery}
+     */
+    getReceiptQuery(): TransactionReceiptQuery;
+    /**
+     * @returns {TransactionRecordQuery}
+     */
+    getRecordQuery(): TransactionRecordQuery;
+    /**
+     * @returns {TransactionResponseJSON}
+     */
+    toJSON(): TransactionResponseJSON;
+    /**
+     *
+     * @param {Client} client
+     * @returns {Promise<TransactionReceipt>}
+     */
+    _retryTransaction(client: Client): Promise<TransactionReceipt>;
+    /**
+     * @returns {string}
+     */
+    toString(): string;
+}
+export type Client = import("../client/Client.js").default<any, any>;
+export type Transaction = import("./Transaction.js").default;
+export type TransactionReceipt = import("./TransactionReceipt.js").default;
+export type TransactionRecord = import("./TransactionRecord.js").default;
+export type Signer = import("../Signer.js").Signer;
+export type Logger = import("../logger/Logger.js").default;
+export type TransactionResponseJSON = {
+    nodeId: string;
+    transactionHash: string;
+    transactionId: string;
+};
+import AccountId from "../account/AccountId.js";
+import TransactionId from "./TransactionId.js";
+import TransactionReceiptQuery from "./TransactionReceiptQuery.js";
+import TransactionRecordQuery from "./TransactionRecordQuery.js";

package/lib/transaction/TransactionResponse.js

@@ -0,0 +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};
+//# sourceMappingURL=TransactionResponse.js.map

package/lib/transaction/TransactionResponse.js.map

@@ -0,0 +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: ${err instanceof Error ? err.message : String(err)}`,\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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"}

package/lib/util/ASN1-Decoder.cjs

@@ -0,0 +1,276 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.asn1DecodeStringDer = exports.ASN1Decoder = void 0;
+var _proto = require("@hashgraph/proto");
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/**
+ * A class to decode ASN.1 encoded data, typically used for parsing cryptographic key data.
+ * @class
+ */
+class ASN1Decoder {
+  /**
+   * Creates a new ASN1Decoder instance.
+   * @param {Uint8Array|ArrayBuffer} data - The ASN.1 encoded data to decode.
+   */
+  constructor(data) {
+    /**
+     * @private
+     * @type {Uint8Array}
+     */
+    this.data = new Uint8Array(data);
+
+    /**
+     * @private
+     * @type {number}
+     */
+    this.pos = 0;
+
+    /**
+     * @private
+     * @type {string[]}
+     */
+    this.oids = [];
+
+    /**
+     * @private
+     * @type {{[key: string]: string}}
+     */
+    this.oidMap = {
+      "1.3.132.0.10": "ecdsa",
+      "1.3.101.112": "ed25519",
+      "1.2.840.10045.2.1": "pubkey"
+    };
+
+    /**
+     * @private
+     * @type {boolean}
+     */
+    this.isPublicKey = false;
+  }
+
+  /**
+   * Reads the length field from the ASN.1 data.
+   * @private
+   * @returns {number} The length value.
+   */
+  readLength() {
+    let length = this.data[this.pos++];
+    if (length & 0x80) {
+      let numBytes = length & 0x7f;
+      length = 0;
+      for (let i = 0; i < numBytes; i++) {
+        length = length << 8 | this.data[this.pos++];
+      }
+    }
+    return length;
+  }
+
+  /**
+   * Reads the type field from the ASN.1 data.
+   * @private
+   * @returns {number} The type value.
+   */
+  readType() {
+    return this.data[this.pos++];
+  }
+
+  /**
+   * Reads an integer value from the ASN.1 data.
+   * @private
+   * @returns {{integer: number}} Object containing the integer value.
+   */
+  readInteger() {
+    const length = this.readLength();
+    let value = 0;
+    for (let i = 0; i < length; i++) {
+      value = value << 8 | this.data[this.pos++];
+    }
+    return {
+      integer: value
+    };
+  }
+
+  /**
+   * Reads an octet string from the ASN.1 data.
+   * @private
+   * @returns {{pkey: Uint8Array}} Object containing the private key data.
+   */
+  readOctetString() {
+    const length = this.readLength();
+    const value = this.data.slice(this.pos, this.pos + length);
+    this.pos += length;
+    return {
+      pkey: value
+    };
+  }
+
+  /**
+   * Reads a bit string from the ASN.1 data.
+   * @private
+   * @returns {{unusedBits: number, pubkey: Uint8Array}} Object containing the public key data and unused bits.
+   */
+  readBitString() {
+    const length = this.readLength();
+    const unusedBits = this.data[this.pos++]; // First byte indicates the number of unused bits
+    const value = this.data.slice(this.pos, this.pos + length - 1);
+    this.pos += length - 1;
+    return {
+      unusedBits,
+      pubkey: value
+    };
+  }
+
+  /**
+   * Reads an object identifier from the ASN.1 data.
+   * @private
+   * @returns {{oid: string}} Object containing the OID as a string.
+   */
+  readObjectIdentifier() {
+    const length = this.readLength();
+    const endPos = this.pos + length;
+    const oid = [];
+    let value = 0;
+
+    // The first byte contains the first two components
+    const firstByte = this.data[this.pos++];
+    oid.push(Math.floor(firstByte / 40));
+    oid.push(firstByte % 40);
+    while (this.pos < endPos) {
+      const byte = this.data[this.pos++];
+      value = value << 7 | byte & 0x7f;
+      if (!(byte & 0x80)) {
+        oid.push(value);
+        value = 0;
+      }
+    }
+    const oidStr = oid.join(".");
+    this.oids.push(oidStr);
+    return {
+      oid: oidStr
+    }; // Return OID as a string
+  }
+
+  /**
+   * Gets the list of object identifiers found during decoding.
+   * @returns {string[]} Array of OID strings.
+   */
+  getOids() {
+    return this.oids;
+  }
+
+  /**
+   * Gets the key types corresponding to the OIDs found during decoding.
+   * @returns {string[]} Array of key type strings.
+   */
+  getOidKeyTypes() {
+    return this.oids.map(oid => this.oidMap[oid] || "unknown");
+  }
+
+  /**
+   * Reads a sequence from the ASN.1 data.
+   * @private
+   * @returns {Array<any>} Array of decoded items in the sequence.
+   */
+  readSequence() {
+    const length = this.readLength();
+    const endPos = this.pos + length;
+    const items = []; // this would better be map or obj
+    while (this.pos < endPos) {
+      items.push(this.read());
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return items;
+  }
+
+  /**
+   * Reads and decodes the next ASN.1 element.
+   * @returns {any} The decoded ASN.1 element.
+   * @throws {Error} If an unsupported type is encountered.
+   */
+  read() {
+    const type = this.readType();
+    switch (type) {
+      case 0x02:
+        // INTEGER
+        return this.readInteger();
+      case 0x03:
+        // BIT STRING FOR PUBKEY
+        return this.readBitString();
+      case 0x04:
+        // OCTET STRING FOR PKEY
+        return this.readOctetString();
+      case 0x06:
+        // OBJECT IDENTIFIER FOR CURVE TYPE
+        return this.readObjectIdentifier();
+      case 0x30:
+        // SEQUENCE
+        return this.readSequence();
+      case 0xa0:
+        // NODE TAG COULD BE TREATED AS SEQUENCE
+        return this.readSequence();
+      case 0xa1:
+        // NODE TAG COULD BE TREATED AS SEQUENCE
+        return this.readSequence();
+      default:
+        throw new Error(`Unsupported type: ${type}`);
+    }
+  }
+
+  /**
+   * Checks if the decoded key is a public key.
+   * @returns {boolean} True if the key is a public key, false otherwise.
+   */
+  isPublicKeyType() {
+    return this.isPublicKey;
+  }
+}
+
+/**
+ * Processes a hexadecimal string representation of an ASN.1 encoded key.
+ * Checks if the input is a list of keys in hexadecimal format. If not, it decodes
+ * the ASN.1 data to extract key types and identify if the key is a public key.
+ *
+ * @param {string} keyString - The hexadecimal string representation of the ASN.1 encoded key.
+ * @returns {{keyTypes: string[], isPublicKey: boolean, isKeyListHex: boolean}} Object containing information about the decoded key.
+ */
+exports.ASN1Decoder = ASN1Decoder;
+const asn1DecodeStringDer = keyString => {
+  const isKeyListHex = isHexKeyList(keyString);
+  if (isKeyListHex) {
+    return {
+      keyTypes: [],
+      isPublicKey: false,
+      isKeyListHex
+    };
+  }
+  const signerData = Uint8Array.from(Buffer.from(keyString, "hex"));
+  const decoder = new ASN1Decoder(signerData);
+  decoder.read();
+  const keyTypes = decoder.getOidKeyTypes();
+  const isPublicKey = decoder.isPublicKeyType();
+  return {
+    keyTypes,
+    isPublicKey,
+    isKeyListHex: false
+  };
+};
+
+/**
+ * Checks if the input is a list of keys in hexadecimal format.
+ * @param {string} hexString - The hexadecimal string representation of the ASN.1 encoded key.
+ * @returns {boolean} True if the key is a public key, false otherwise.
+ */
+exports.asn1DecodeStringDer = asn1DecodeStringDer;
+const isHexKeyList = hexString => {
+  try {
+    const binaryData = Buffer.from(hexString, "hex");
+    const decodedData = _proto.proto.KeyList.decode(binaryData);
+    return !!decodedData.keys && Array.isArray(decodedData.keys);
+  } catch (error) {
+    return false;
+  }
+};