This guide will explain how to install the fxcored mainnet or fxcored testnet command line interface (CLI) on your system with Binaries option. With these installed on a server, you can participate on the mainnet or testnet as a .
Note: Monikers can contain only ASCII characters. Using Unicode characters is not supported and renders the node unreachable.
The moniker can be edited in the ~/.fxcore/config/config.toml file:
# A custom human readable name for this node
moniker = "<custom_moniker>"
Initializing fxcored will result in the creation of a few directories and most importantly the .fxcore directory (for more information on the directory tree, refer to the validator-recovery section). This will be where your validator keys are stored and this is important for recovery of your validator.
Fetching genesis file (copy this entire line of code and hit ENTER):
you can optionally download the . Make sure to move this to ~/.fxcore/config/addrbook.json.
** IMPORTANT At this stage **BEFORE **starting the node, please download the latest snapshot, refer to this .
Additionally, what is important is that your validator keys that is stored in a .json file for you to do a recovery in the future. For more how to access the files.
Also, you can consider generating a new consensus key and .
Start Node:
nohup fxcored start 2>&1 > fxcore.log &
Check logs:
tail -f fxcore.log
View more startup configurations:
fxcored start -h
For example, Start and open the 1317 restful service port:
The execution of the previous command will return something like this (this is to check the status of nodes and which blocks are being synced/are syncing):
Stop Node (will be running in the background if not stopped):
ps -ef | grep fxcored
kill -9 <PID>
Running Server as a Daemon
It is important to keep fxcored running at all times. There are several ways to achieve this, and the simplest solution we recommend is to register fxcored as a systemd service so that it will automatically get started upon system reboots and other events.
Register fxcored as a service
First, create a service definition file in /etc/systemd/system.
Run this command to create the sample file above in the file path/etc/systemd/system/fxcored.service (if you are in the fx-core directory):
cat > /etc/systemd/system/fxcored.service
hit the ENTER button on your keyboard and copy and paste the contents of the file below into the command line:
Then hit the ENTER button on your keyboard before using Ctrl+D on your keyboard, your file with the above contents will be created. It should look like this:
run the command:which fxcored and replace the ExecStart file path with the return value of the command
Modify the Service section from the given sample above to suit your settings. Note that even if we raised the number of open files for a process, we still need to include LimitNOFILE.
After creating a service definition file, you should execute:
To start the node, run sudo systemctl start fxcored, and thereafter run journalctl -t fxcored -f to see the latest and continuous logs.
Accessing logs
journalctl -u fxcored
journalctl -u fxcored -r
journalctl -u fxcored -f
Concluding tips: It is always better to sync Pundi AIFX using the Daemon method because this ensures stability and that your syncing is continuously running in the background.
Secret and updating consensus key
Use this at your own risk❗ I suggest trying it out on testnet first and also backing up your priv_validator_key.json if you already have this set up for a validator. The file can be found in this file path ~/.fxcore/config/priv_validator_key.json.
Updating your consensus key and tagging it to a pin
Before setting up your validator if you would like to have a backup of your keys with a pin. You may run the following command:
the <secret> key here must be longer than 32 characters
Running the above command will return:
WARNING: The consensus private key of the node will be replaced.
Ensure that the backup is complete.
USE AT YOUR OWN RISK. Continue? [y/N]
After inputting y, your priv_validator_key.json will be replaced with a new file. This means you will have a new consensus private key and it will be tagged to your <secret> pin.
Checking to see if the pin works
If your .fxcore folder is in the root directory
cat ~/.fxcore/config/priv_validator_key.json
Record the previous output before running the next command to remove this file:
rm ~/.fxcore/config/priv_validator_key.json
The following command will recover your original consensus key:
To ensure that the blocks are synced up with your node, under "sync_info", "catching_up value" should be false "catching_up value": false. This may take a few hours and your node has to be fully synced up before proceeding to the next step. You may cross reference the latest block you are synced to "sync_info": "latest_block_height" and the latest block height of our Testnet blockchain on our or our .