Create a node
Create a node adds a new node to the specified network. Below are the properties you can set for a given node upon creation, their description, and whether they are required or not.
Transaction Properties
Node Account ID
The ID of the account that will collect the node fees from transactions for this node. (example: 0.0.1234)
Y
Node Description
A short description up to 100 bytes
N
Payer Account
The ID of the account paying for the transaction.
Y
Service Endpoints
A list of service endpoints for gRPC calls. No more than 8 entries. Endpoints in this list MAY supply either IP address or FQDN, but MUST NOT supply both values for the same endpoint.
Y
Gossip Endpoints
List of service endpoints for the node.
These endpoints SHALL represent the published endpoints to which other consensus nodes may gossip transactions.
These endpoints MUST specify a port.
This list MUST NOT be empty
This list MUST NOT contain more than 10 entries
The first two entries in this list SHALL be the endpoints published to all consensus nodes. Currently, the first endpoint MUST be the internal endpoint and the second endpoint MUST be the external endpoint.
All other entries SHALL be reserved for future use.
Each network may have additional requirements for these endpoints.
A client MUST check network-specific documentation for those details
If the network configuration value gossipFqdnRestricted is set, then all endpoints in this list MUST supply only IP address.
If the network configuration value gossipFqdnRestricted is not set, then endpoints in this list MAY supply either IP address or FQDN, but MUST NOT supply both values for the same endpoint
Y
Gossip CA Certificate
A certificate used to sign gossip events.
Y
New Admin Key
The administrative key controlled by the node operator
Y
Transaction Signing Requirements
The node operator admin key must sign the transaction
The transaction fee payer account must sign the transaction
Transaction Receipt
Returns the Node ID for the node that was added upon successful execution.
Last updated