Deploy Node

Validator node software is a cross-platform command line program, which for now only supports Linux system.

Integration for MacOS, Windows will be coming soon.

Download node software

Create a folder and name it 'Ecoball' in the Linux system as the working directory of the Ecoball blockchain system, download the node software package to the folder:

mkdir ecoball

cd ecoball

git clone

The downloaded file:

ls -l

Decompress the file, then in the decompressed directory, the default directory file name is 'validator_node'. If you need to deploy multiple nodes, you may change rename the nodes to 'validator_node1', 'validator_node2', 'validator_node3' and so on.

cd validator_node

ls config.toml ecoball spec.json

  • is the node installation configuration description file

  • config.toml is the node startup configuration file

  • ecoball is the node software,executable binary files

  • spec.json is the initial data and structure specification file

The downloaded software usually does not have executable permissions, so it is necessary to authorize the node software.

chmod +x ecoball

In addition, the corresponding configuration needs to be performed according to the instructions of the file. Follow below steps for configuration:

Step 1: Create a wallet;

Step 2: Create a password file;

Step 3: Modify the startup configuration file;

Step 4: Launch the node software;

Step 5:Launch validator node software to background

Step 6: Become a candidate for staking mining。

Step 1:Create a wallet

Create a wallet:

./ecoball -c config.toml account new

A password prompt appears. Enter the wallet password twice to generate a wallet address. For example, here is the wallet address:


Write down your wallet address and password, keep them safe.

After the wallet is created, the system automatically creates a data directory in the current directory, which contains the keys/espuma/directory structure. The following is the keystore file of the wallet. For asset security, it is recommended that this file be backed up and stored properly.

Step 2:Create a password file

Create a password file.

vim passwd.txt

Then enter the password you created early along with wallet creation above. Save and exit.

Step 3:Modify the startup configuration file

vim config.toml

The initial value of the node configuration file:

Modify following parameters according to the instructions in the file:

  • engine signer address: engine signature wallet address, use the wallet address created before as the transaction signature wallet

  • password file: fill in the password file created before, and note that the brackets inside cannot be lost, otherwise an error will be reported

  • unlock: unlock the wallet address, same as the engine signer, fill in the wallet address created before, the brackets cannot be lost

Save and exit. The modified configuration file is as follows:

Step 4:Launch node software to console

Execute the following command to enter the console. If there is any error in the configuration file, the program will not run normally, and an error message will appear; if there is no error in the configuration file, you will be able to see the interface scrolling:

./ecoball --config config.toml

Step 5:Launch validator node software to background

Launch the node software to run in the background, and output the log to the log file. It will not be closed even if the console is closed or disconnected. The following operations are required:

nohup ./ecoball --config config.toml >ecoball.log 2>&1 &

If you need to monitor real-time logs, you can run the following command:

tail -f ecoball.log

Step 6:Become a candidate for staking mining

After the node software is installed, deployed and running, it becomes a node server, and it starts to synchronize node data and verify transactions normally.

To become a candidate/verifier of EcoBall, the following criteria must be met:

  1. Create a new wallet address on the staking mining page;

  2. Staking≥ 500,000 ECO to the address;

For the specific operation process, please refer to Pledge | Pledge on the web side.

It should be noted that to pledge to become a candidate, it is best to wait for the node synchronization to complete before proceeding. Otherwise, if the synchronization is not completed, the application becomes a candidate, and then becomes a verifier, but because the synchronization is not completed, the block cannot be generated, which may result in punishment and loss.

Last updated