An Introduction to Radix Nodes

27th Jun 2022Radix Node 1.3.0 released

Use the radixnode CLI to update your node or install a new node from scratch – or refer to the update instructions for Docker or systemd install methods.

What is a Radix Node?

The Radix Node (GitHub) is the building block of Radix Network infrastructure. Nodes connect together to conduct consensus on transactions, maintain the ledger, and provide other useful functions.

It can be configured in two different ways depending on its purpose:

A Full Node simply connects to the network, synchronizes ledger state, and observes the status of the network. It can also be thought of as a kind of “wallet” that is connected directly to the network, with the Node’s own account available for programmatic control. A full node can be configured to store the ledger transaction stream, which can be exposed by the Core API.

A Validator Node starts life as a Full Node, but has also “registered” itself to the network as a Validator by submitting a special transaction from its account. Registration means that it may now accept XRD token “stake” and potentially be included in the validator set of 100 nodes that conduct network consensus.

For more information on the APIs a node exposes, see the page on Radix Node APIs.

Before release 1.1.0, Nodes also supported an Archive Node configuration, exposing a JSON RPC API for consumption by Wallets and Explorers. This functionality has been replaced by the Network Gateway.

Running a Node

If you’re looking to run a node for its APIs, first read the Node and Gateway overview to check if you should also be running a Gateway, to get a Gateway API.

See the Node Setup Docs for information on how to set up or configure a node, and check out the Maintenance and Additional Resources sections for further information.

For more technical information on the incentive tokens available to validator node runners, see Validators and Incentives, or for general information see Staking & Validating on Radix on our Knowledge Base.