Registering a Validator Node using the RadixNode CLI

In this short exercise, you’re going to register the node you created in the Provisioning a Docker Node with the RadixNode CLI guide.


You should have completed Provisioning a Docker Node with the RadixNode CLI first to ensure that radixnode is installed, and your node is up and running.

1. Register your Node as a Validator

If you wish to register your node as a validator, you must first send it some tokens from your wallet to cover the transaction fee. You’ll need the address of your node to send the tokens, which you can check with the radixnode get-node-address command we looked at previously:

radixnode get-node-address

Once you have sent the tokens, you can then use the following command to register your node as a validator:

radixnode register-validator

The program will ask you for the name of your validator and its URL address. These values will be given to users who request information from your node through the Radix API.

If you receive an error similar to this:

{"error": {"message": "Not enough balance to for fee burn. (Substate not found)"}}

then it’s likely that your node hasn’t synced with the network yet. If the problem persists then please consult the troubleshooting page.

2. Show your Validator Node Details

You can show your validator node status with this command:

radixnode validator-info

which will return something like this:

{"validator": {"address": "brx1qsp2jfx4cnhl0vgd80q5qq0qk4wcz076pzgzdj3pefghp8vrxmxsnng02k4fu", "stakes": [], "name": "", "registered": true, "totalStake": 0.0, "url": ""}}

More information on RadixNode Usage

You can use RadixNode to carry out more administration tasks. For example:

You can find more information about the RadixNode command set on the Node Runner Repository site.

If you have any questions or run into problems, then check our troubleshooting guide, or the FAQ page. You can also get help from the community and Radix engineers on the Discord channel.