@hiero-ledger/sdk
Version:
412 lines (372 loc) • 13.8 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var _AccountId = _interopRequireDefault(require("../account/AccountId.cjs"));
var _Key = _interopRequireDefault(require("../Key.cjs"));
var _Transaction = _interopRequireWildcard(require("../transaction/Transaction.cjs"));
var _ServiceEndpoint = _interopRequireDefault(require("./ServiceEndpoint.cjs"));
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); }
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
// SPDX-License-Identifier: Apache-2.0
const DESCRIPTION_MAX_LENGTH = 100;
const GOSSIP_ENDPOINTS_MAX_LENGTH = 10;
const SERVICE_ENDPOINTS_MAX_LENGTH = 8;
/**
* @namespace proto
* @typedef {import("@hashgraph/proto").proto.ITransaction} ITransaction
* @typedef {import("@hashgraph/proto").proto.ITransaction} ISignedTransaction
* @typedef {import("@hashgraph/proto").proto.TransactionBody} TransactionBody
* @typedef {import("@hashgraph/proto").proto.ITransactionBody} ITransactionBody
* @typedef {import("@hashgraph/proto").proto.ITransactionResponse} ITransactionResponse
*/
/**
* @namespace com.hedera.hapi.node.addressbook
* @typedef {import("@hashgraph/proto").com.hedera.hapi.node.addressbook.INodeCreateTransactionBody} INodeCreateTransactionBody
*/
/**
* @typedef {import("../channel/Channel.js").default} Channel
* @typedef {import("../transaction/TransactionId.js").default} TransactionId
* @typedef {import("../client/Client.js").default<*, *>} Client
*/
/**
* A transaction to create a new consensus node in the network.
*/
class NodeCreateTransaction extends _Transaction.default {
/**
* @param {object} [props]
* @param {AccountId} [props.accountId]
* @param {?string} [props.description]
* @param {Array<ServiceEndpoint>} [props.gossipEndpoints]
* @param {?Array<ServiceEndpoint>} [props.serviceEndpoints]
* @param {Uint8Array} [props.gossipCaCertificate]
* @param {Uint8Array} [props.grpcCertificateHash]
* @param {ServiceEndpoint} [props.grpcWebProxyEndpoint]
* @param {Key} [props.adminKey]
* @param {boolean} [props.declineReward]
*/
constructor(props) {
super();
/**
* @private
* @type {?AccountId}
* @description Node account identifier. It's required.
*/
this._accountId = props?.accountId != null ? props.accountId : null;
/**
* @private
* @type {?string}
* @description Short description of the node.
*/
this._description = props?.description != null ? props.description : null;
/**
* @private
* @type {?Array<ServiceEndpoint>}
* @description List of service endpoints for gossip. It's required.
*/
this._gossipEndpoints = props?.gossipEndpoints != null ? props.gossipEndpoints : null;
/**
* @private
* @type {?Array<ServiceEndpoint>}
* @description List of service endpoints for gRPC calls.
*/
this._serviceEndpoints = props?.serviceEndpoints != null ? props.serviceEndpoints : null;
/**
* @private
* @type {?Uint8Array}
* @description Certificate used to sign gossip events. It's required.
*/
this._gossipCaCertificate = props?.gossipCaCertificate != null ? props.gossipCaCertificate : null;
/**
* @private
* @type {?Uint8Array}
* @description Hash of the node gRPC TLS certificate.
*/
this._grpcCertificateHash = props?.grpcCertificateHash != null ? props.grpcCertificateHash : null;
/**
* @private
* @type {?ServiceEndpoint}
* @description Proxy endpoint for gRPC web calls.
*/
this._grpcWebProxyEndpoint = props?.grpcWebProxyEndpoint || null;
/**
* @private
* @type {?Key}
* @description Administrative key controlled by the node operator. It's required.
*/
this._adminKey = props?.adminKey != null ? props.adminKey : null;
/**
* @private
* @type {?boolean}
* @description Whether the node declines rewards.
*/
this._declineReward = props?.declineReward != null ? props.declineReward : null;
}
/**
* @internal
* @param {ITransaction[]} transactions
* @param {ISignedTransaction[]} signedTransactions
* @param {TransactionId[]} transactionIds
* @param {AccountId[]} nodeIds
* @param {ITransactionBody[]} bodies
* @returns {NodeCreateTransaction}
*/
static _fromProtobuf(transactions, signedTransactions, transactionIds, nodeIds, bodies) {
const body = bodies[0];
const nodeCreate = /** @type {INodeCreateTransactionBody} */
body.nodeCreate;
return _Transaction.default._fromProtobufTransactions(new NodeCreateTransaction({
accountId: nodeCreate.accountId != null ? _AccountId.default._fromProtobuf(nodeCreate.accountId) : undefined,
description: nodeCreate.description != null ? nodeCreate.description : undefined,
gossipEndpoints: nodeCreate.gossipEndpoint != null ? nodeCreate.gossipEndpoint.map(endpoint => _ServiceEndpoint.default._fromProtobuf(endpoint)) : undefined,
serviceEndpoints: nodeCreate.serviceEndpoint != null ? nodeCreate.serviceEndpoint.map(endpoint => _ServiceEndpoint.default._fromProtobuf(endpoint)) : undefined,
gossipCaCertificate: nodeCreate.gossipCaCertificate != null ? nodeCreate.gossipCaCertificate : undefined,
grpcCertificateHash: nodeCreate.grpcCertificateHash != null ? nodeCreate.grpcCertificateHash : undefined,
adminKey: nodeCreate.adminKey != null ? _Key.default._fromProtobufKey(nodeCreate.adminKey) : undefined,
declineReward: nodeCreate.declineReward != null ? nodeCreate.declineReward : undefined,
grpcWebProxyEndpoint: nodeCreate.grpcProxyEndpoint != null ? _ServiceEndpoint.default._fromProtobuf(nodeCreate.grpcProxyEndpoint) : undefined
}), transactions, signedTransactions, transactionIds, nodeIds, bodies);
}
/**
* @param {AccountId | string} accountId
* @description Set node account identifier.
* @returns {NodeCreateTransaction}
*/
setAccountId(accountId) {
this._requireNotFrozen();
this._accountId = accountId instanceof _AccountId.default ? accountId : _AccountId.default.fromString(accountId);
return this;
}
/**
* @description Get node account identifier.
* @returns {?AccountId}
*/
get accountId() {
return this._accountId;
}
/**
* @param {string} description
* @description Set description of the node.
* @returns {NodeCreateTransaction}
*/
setDescription(description) {
this._requireNotFrozen();
if (description.length > DESCRIPTION_MAX_LENGTH) {
throw new Error(`Description must be at most ${DESCRIPTION_MAX_LENGTH} characters.`);
}
this._description = description;
return this;
}
/**
* @description Get description of the node.
* @returns {?string}
*/
get description() {
return this._description;
}
/**
* @param {ServiceEndpoint[]} gossipEndpoints
* @description Set list of service endpoints for gossip.
* @returns {NodeCreateTransaction}
*/
setGossipEndpoints(gossipEndpoints) {
this._requireNotFrozen();
if (gossipEndpoints.length == 0) {
throw new Error("GossipEndpoints list must not be empty.");
}
if (gossipEndpoints.length > GOSSIP_ENDPOINTS_MAX_LENGTH) {
throw new Error(`GossipEndpoints list must not contain more than ${GOSSIP_ENDPOINTS_MAX_LENGTH} entries.`);
}
this._gossipEndpoints = [...gossipEndpoints];
return this;
}
/**
* @description Get list of service endpoints for gossip.
* @returns {?Array<ServiceEndpoint>}
*/
get gossipEndpoints() {
return this._gossipEndpoints;
}
/**
* @param {ServiceEndpoint} endpoint
* @description Add an endpoint to the list of service endpoints for gossip.
* @returns {NodeCreateTransaction}
*/
addGossipEndpoint(endpoint) {
if (this._gossipEndpoints != null) {
this._gossipEndpoints.push(endpoint);
}
return this;
}
/**
* @param {ServiceEndpoint[]} serviceEndpoints
* @description Set list of service endpoints for gRPC calls.
* @returns {NodeCreateTransaction}
*/
setServiceEndpoints(serviceEndpoints) {
this._requireNotFrozen();
if (serviceEndpoints.length == 0) {
throw new Error("ServiceEndpoints list must not be empty.");
}
if (serviceEndpoints.length > SERVICE_ENDPOINTS_MAX_LENGTH) {
throw new Error(`ServiceEndpoints list must not contain more than ${SERVICE_ENDPOINTS_MAX_LENGTH} entries.`);
}
this._serviceEndpoints = [...serviceEndpoints];
return this;
}
/**
* @description Get list of service endpoints for gRPC calls.
* @returns {?Array<ServiceEndpoint>}
*/
get serviceEndpoints() {
return this._serviceEndpoints;
}
/**
* @param {ServiceEndpoint} endpoint
* @description Add an endpoint to the list of service endpoints for gRPC calls.
* @returns {NodeCreateTransaction}
*/
addServiceEndpoint(endpoint) {
if (this._serviceEndpoints != null) {
this._serviceEndpoints.push(endpoint);
}
return this;
}
/**
* @param {Uint8Array} bytes
* @description Set certificate used to sign gossip events.
* @returns {NodeCreateTransaction}
*/
setGossipCaCertificate(bytes) {
this._requireNotFrozen();
if (bytes.length == 0) {
throw new Error("GossipCaCertificate must not be empty.");
}
this._gossipCaCertificate = bytes;
return this;
}
/**
* @description Get certificate used to sign gossip events.
* @returns {?Uint8Array}
*/
get gossipCaCertificate() {
return this._gossipCaCertificate;
}
/**
* @param {Uint8Array} bytes
* @description Set hash of the node gRPC TLS certificate.
* @returns {NodeCreateTransaction}
*/
setCertificateHash(bytes) {
this._requireNotFrozen();
this._grpcCertificateHash = bytes;
return this;
}
/**
* @description Get hash of the node gRPC TLS certificate.
* @returns {?Uint8Array}
*/
get certificateHash() {
return this._grpcCertificateHash;
}
/**
* @param {ServiceEndpoint} endpoint
* @description Set proxy endpoint for gRPC web calls.
* @returns {NodeCreateTransaction}
*/
setGrpcWebProxyEndpoint(endpoint) {
this._requireNotFrozen();
this._grpcWebProxyEndpoint = endpoint;
return this;
}
/**
* @description Get proxy endpoint for gRPC web calls.
* @returns {?ServiceEndpoint}
*/
get grpcWebProxyEndpoint() {
return this._grpcWebProxyEndpoint;
}
/**
* @param {Key} adminKey
* @description Set administrative key controlled by the node operator.
* @returns {NodeCreateTransaction}
*/
setAdminKey(adminKey) {
this._requireNotFrozen();
this._adminKey = adminKey;
return this;
}
/**
* @description Get administrative key controlled by the node operator.
* @returns {?Key}
*/
get adminKey() {
return this._adminKey;
}
/**
* @param {boolean} declineReward
* @description Set whether the node declines rewards.
* @returns {NodeCreateTransaction}
*/
setDeclineReward(declineReward) {
this._requireNotFrozen();
this._declineReward = declineReward;
return this;
}
/**
* @description Get whether the node declines rewards.
* @returns {?boolean}
*/
get declineReward() {
return this._declineReward;
}
/**
* @override
* @internal
* @param {Channel} channel
* @param {ITransaction} request
* @returns {Promise<ITransactionResponse>}
*/
_execute(channel, request) {
return channel.addressBook.createNode(request);
}
/**
* @override
* @protected
* @returns {NonNullable<TransactionBody["data"]>}
*/
_getTransactionDataCase() {
return "nodeCreate";
}
/**
* @override
* @protected
* @returns {INodeCreateTransactionBody}
*/
_makeTransactionData() {
return {
accountId: this._accountId != null ? this._accountId._toProtobuf() : null,
description: this._description != null ? this._description : null,
gossipEndpoint: this._gossipEndpoints != null ? this._gossipEndpoints.map((/** @type {ServiceEndpoint} */endpoint) => endpoint._toProtobuf()) : null,
serviceEndpoint: this._serviceEndpoints != null ? this._serviceEndpoints.map((/** @type {ServiceEndpoint} */endpoint) => endpoint._toProtobuf()) : null,
gossipCaCertificate: this._gossipCaCertificate != null ? this._gossipCaCertificate : null,
grpcCertificateHash: this._grpcCertificateHash != null ? this._grpcCertificateHash : null,
adminKey: this._adminKey != null ? this._adminKey._toProtobufKey() : null,
declineReward: this._declineReward != null ? this._declineReward : null,
grpcProxyEndpoint: this._grpcWebProxyEndpoint != null ? this._grpcWebProxyEndpoint._toProtobuf() : null
};
}
/**
* @returns {string}
*/
_getLogId() {
const timestamp = /** @type {import("../Timestamp.js").default} */
this._transactionIds.current.validStart;
return `NodeCreateTransaction:${timestamp.toString()}`;
}
}
exports.default = NodeCreateTransaction;
_Transaction.TRANSACTION_REGISTRY.set("nodeCreate",
// eslint-disable-next-line @typescript-eslint/unbound-method
NodeCreateTransaction._fromProtobuf);