@hiero-ledger/sdk
Version:
346 lines (320 loc) • 11.2 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var _Query = _interopRequireWildcard(require("../query/Query.cjs"));
var _Status = _interopRequireDefault(require("../Status.cjs"));
var _TransactionReceipt = _interopRequireDefault(require("./TransactionReceipt.cjs"));
var _TransactionId = _interopRequireDefault(require("./TransactionId.cjs"));
var _PrecheckStatusError = _interopRequireDefault(require("../PrecheckStatusError.cjs"));
var _ReceiptStatusError = _interopRequireDefault(require("../ReceiptStatusError.cjs"));
var _Executable = require("../Executable.cjs");
var HieroProto = _interopRequireWildcard(require("@hiero-ledger/proto"));
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
// SPDX-License-Identifier: Apache-2.0
const {
proto
} = HieroProto;
/**
* @typedef {import("../account/AccountId.js").default} AccountId
* @typedef {import("../channel/Channel.js").default} Channel
* @typedef {import("../client/Client.js").default<*, *>} Client
*/
/**
* Get the receipt of a transaction, given its transaction ID.
*
* <p>Once a transaction reaches consensus, then information about whether it succeeded or failed
* will be available until the end of the receipt period.
*
* <p>This query is free.
* @augments {Query<TransactionReceipt>}
*/
class TransactionReceiptQuery extends _Query.default {
/**
* @param {object} [props]
* @param {TransactionId | string} [props.transactionId]
* @param {boolean} [props.includeDuplicates]
* @param {boolean} [props.includeChildren]
* @param {boolean} [props.validateStatus]
*/
constructor(props = {}) {
super();
/**
* @private
* @type {?TransactionId}
*/
this._transactionId = null;
/**
* @private
* @type {?boolean}
*/
this._includeChildren = null;
/**
* @private
* @type {?boolean}
*/
this._includeDuplicates = null;
this._validateStatus = true;
if (props.transactionId != null) {
this.setTransactionId(props.transactionId);
}
if (props.includeChildren != null) {
this.setIncludeChildren(props.includeChildren);
}
if (props.includeDuplicates != null) {
this.setIncludeDuplicates(props.includeDuplicates);
}
if (props.validateStatus != null) {
this.setValidateStatus(props.validateStatus);
}
}
/**
* @internal
* @param {HieroProto.proto.IQuery} query
* @returns {TransactionReceiptQuery}
*/
static _fromProtobuf(query) {
const receipt = /** @type {HieroProto.proto.ITransactionGetReceiptQuery} */
query.transactionGetReceipt;
return new TransactionReceiptQuery({
transactionId: receipt.transactionID ? _TransactionId.default._fromProtobuf(receipt.transactionID) : undefined,
includeDuplicates: receipt.includeDuplicates != null ? receipt.includeDuplicates : undefined,
includeChildren: receipt.includeChildReceipts != null ? receipt.includeChildReceipts : undefined
});
}
/**
* @returns {?TransactionId}
*/
get transactionId() {
return this._transactionId;
}
/**
* Set the transaction ID for which the receipt is being requested.
*
* @param {TransactionId | string} transactionId
* @returns {this}
*/
setTransactionId(transactionId) {
this._transactionId = typeof transactionId === "string" ? _TransactionId.default.fromString(transactionId) : transactionId.clone();
return this;
}
/**
* @param {boolean} includeDuplicates
* @returns {TransactionReceiptQuery}
*/
setIncludeDuplicates(includeDuplicates) {
this._includeDuplicates = includeDuplicates;
return this;
}
/**
* @returns {boolean}
*/
get includeDuplicates() {
return this._includeDuplicates != null ? this._includeDuplicates : false;
}
/**
* @param {boolean} includeChildren
* @returns {TransactionReceiptQuery}
*/
setIncludeChildren(includeChildren) {
this._includeChildren = includeChildren;
return this;
}
/**
* @returns {boolean}
*/
get includeChildren() {
return this._includeChildren != null ? this._includeChildren : false;
}
/**
* @param {boolean} validateStatus
* @returns {this}
*/
setValidateStatus(validateStatus) {
this._validateStatus = validateStatus;
return this;
}
/**
* @returns {boolean}
*/
get validateStatus() {
return this._validateStatus;
}
/**
* @override
* @protected
* @returns {boolean}
*/
_isPaymentRequired() {
return false;
}
/**
* @override
* @internal
* @param {HieroProto.proto.IQuery} request
* @param {HieroProto.proto.IResponse} response
* @returns {[Status, ExecutionState]}
*/
// eslint-disable-next-line @typescript-eslint/no-unused-vars
_shouldRetry(request, response) {
const {
nodeTransactionPrecheckCode
} = this._mapResponseHeader(response);
let status = _Status.default._fromCode(nodeTransactionPrecheckCode != null ? nodeTransactionPrecheckCode : proto.ResponseCodeEnum.OK);
if (this._logger) {
this._logger.debug(`[${this._getLogId()}] received node precheck status ${status.toString()}`);
}
switch (status) {
case _Status.default.Busy:
case _Status.default.Unknown:
case _Status.default.ReceiptNotFound:
case _Status.default.PlatformNotActive:
return [status, _Executable.ExecutionState.Retry];
case _Status.default.Ok:
break;
default:
return [status, _Executable.ExecutionState.Error];
}
const transactionGetReceipt = /** @type {HieroProto.proto.ITransactionGetReceiptResponse} */
response.transactionGetReceipt;
const receipt = /** @type {HieroProto.proto.ITransactionReceipt} */
transactionGetReceipt.receipt;
const receiptStatusCode = /** @type {HieroProto.proto.ResponseCodeEnum} */receipt.status;
status = _Status.default._fromCode(receiptStatusCode);
if (this._logger) {
this._logger.debug(`[${this._getLogId()}] received receipt status ${status.toString()}`);
}
switch (status) {
case _Status.default.Busy:
case _Status.default.Unknown:
case _Status.default.ReceiptNotFound:
return [status, _Executable.ExecutionState.Retry];
case _Status.default.Success:
case _Status.default.FeeScheduleFilePartUploaded:
return [status, _Executable.ExecutionState.Finished];
default:
return [status, this._validateStatus ? _Executable.ExecutionState.Error : _Executable.ExecutionState.Finished];
}
}
/**
* @returns {TransactionId}
*/
_getTransactionId() {
if (this._transactionId != null) {
return this._transactionId;
}
return super._getTransactionId();
}
/**
* @override
* @internal
* @param {HieroProto.proto.IQuery} request
* @param {HieroProto.proto.IResponse} response
* @param {AccountId} nodeId
* @returns {Error}
*/
// eslint-disable-next-line @typescript-eslint/no-unused-vars
_mapStatusError(request, response, nodeId) {
const {
nodeTransactionPrecheckCode
} = this._mapResponseHeader(response);
let status = _Status.default._fromCode(nodeTransactionPrecheckCode != null ? nodeTransactionPrecheckCode : proto.ResponseCodeEnum.OK);
switch (status) {
case _Status.default.Ok:
// Do nothing
break;
default:
return new _PrecheckStatusError.default({
nodeId,
status,
transactionId: this._getTransactionId(),
contractFunctionResult: null
});
}
const transactionGetReceipt = /** @type {HieroProto.proto.ITransactionGetReceiptResponse} */
response.transactionGetReceipt;
const receipt = /** @type {HieroProto.proto.ITransactionReceipt} */
transactionGetReceipt.receipt;
const receiptStatusCode = /** @type {HieroProto.proto.ResponseCodeEnum} */receipt.status;
status = _Status.default._fromCode(receiptStatusCode);
if (this._transactionId == null) {
throw new Error("Failed to construct `ReceiptStatusError` because `transactionId` is `null`");
}
return new _ReceiptStatusError.default({
status,
transactionId: this._transactionId,
transactionReceipt: _TransactionReceipt.default._fromProtobuf(transactionGetReceipt)
});
}
/**
* @param {Client} client
*/
_validateChecksums(client) {
if (this._transactionId != null && this._transactionId.accountId != null) {
this._transactionId.accountId.validateChecksum(client);
}
}
/**
* @override
* @internal
* @param {Channel} channel
* @param {HieroProto.proto.IQuery} request
* @returns {Promise<HieroProto.proto.IResponse>}
*/
_execute(channel, request) {
return channel.crypto.getTransactionReceipts(request);
}
/**
* @override
* @internal
* @param {HieroProto.proto.IResponse} response
* @returns {HieroProto.proto.IResponseHeader}
*/
_mapResponseHeader(response) {
const transactionGetReceipt = /** @type {HieroProto.proto.ITransactionGetReceiptResponse} */
response.transactionGetReceipt;
return /** @type {HieroProto.proto.IResponseHeader} */transactionGetReceipt.header;
}
/**
* @protected
* @override
* @param {HieroProto.proto.IResponse} response
* @param {AccountId} nodeAccountId
* @param {HieroProto.proto.IQuery} request
* @returns {Promise<TransactionReceipt>}
*/
// eslint-disable-next-line @typescript-eslint/no-unused-vars
_mapResponse(response, nodeAccountId, request) {
const transactionGetReceipt = /** @type {HieroProto.proto.ITransactionGetReceiptResponse} */
response.transactionGetReceipt;
return Promise.resolve(_TransactionReceipt.default._fromProtobuf(transactionGetReceipt));
}
/**
* @override
* @internal
* @param {HieroProto.proto.IQueryHeader} header
* @returns {HieroProto.proto.IQuery}
*/
_onMakeRequest(header) {
return {
transactionGetReceipt: {
header,
transactionID: this._transactionId != null ? this._transactionId._toProtobuf() : null,
includeDuplicates: this._includeDuplicates,
includeChildReceipts: this._includeChildren
}
};
}
/**
* @returns {string}
*/
_getLogId() {
return `TransactionReceiptQuery:${this._timestamp.toString()}`;
}
}
exports.default = TransactionReceiptQuery;
_Query.QUERY_REGISTRY.set("transactionGetReceipt",
// eslint-disable-next-line @typescript-eslint/unbound-method
TransactionReceiptQuery._fromProtobuf);