Update a node

Updating a node updates the existing properties of a node.

Transaction Properties

Transaction Property
Description

Node Account ID

Update the ID of the account that will collect the node fees from transactions for this node. (example: 0.0.1234)

Node Description

Update the description of the node

Payer Account

The ID of the account paying for the transaction. Any account can be set as the transaction fee payer account

Service Endpoints

The updated 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.

Gossip Endpoints

The updated 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

New Admin Key

The updated administrative key controlled by the node operator

Transaction Signing Requirements

  • The node operator admin key must sign the transaction

    • This key cannot currently be added to the list of required signers automatically. These admin key signers will need to manually select which key is used to sign the transaction.

  • If a new node operator admin key was assigned, the new node admin key must also sign

  • The transaction fee payer account must sign the transaction

Last updated