Deploy Node

Validator node software is a cross-platform command line program, planned to support Linux, MacOS, Windows three operating system platforms. The installation and deployment methods for the three platforms are basically the same. For now, only Linux systems are supported.

Download node software

First, create a folder called Ecoball in the Linux system as the working directory of the Ecoball blockchain system, and enter this folder,download the node software package:

mkdir ecoball

cd ecoball

git clone

After downloading, take a look at the downloaded file:

ls -l

After decompressing, enter the decompressed directory to see what files.The default directory name is validator_node. If only one node is deployed, the default directory name is validator_node. If you need to deploy multiple nodes, you can change the name to validator_node1, validator_node2, validator_node3, and so on.

cd validator_node

ls config.toml ecoball spec.json

Among them:

  • 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

as follows:

node directory structure

In addition, the corresponding configuration needs to be performed according to the instructions of the file. Divided into the following steps:

Step 1: create a wallet;

Step 2: Create a password file;

Step 3: Modify the startup configuration file;

Step 4: Start the node software;

Step 5: staking.

The descriptions are made separately below.

Create a wallet

Create a wallet:

./ecoball -c config.toml account new

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


Make a note of your wallet address and password and keep them safe so you'll need them more often in the future.

create wallet on the node

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.

wallet keystore file

Create a password file

create a password file.

vim passwd.txt

Then enter the password you entered when you created the wallet above. Save and exit.

wallet password file

Modify the startup configuration file

vim config.toml

The initial value of the node configuration file is as follows:

initial node config

Modify several necessary parameters according to the instructions in the file.

Mainly the following parameters:

  • engine signer address: engine signature wallet address, fill in 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:

modified node config

Launch node software to console

Execute the following command to enter the console. If there is any error in the configuration file, the program cannot be started normally, and error message will appear; if there is no error in the configuration file, it will start normally, and you can observe the scrolling of the interface characters:

./ecoball --config config.toml

node run

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 because 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

node monitor

Running in Windows 10 environment

At present, there is only Linux version of the node program. If the user does not have a Linux computer and needs to test under Windows, he must install the Linux running environment on Windows. Windows10 is recommended here, because the Linux subsystem is native supported. You can play Linux directly on Windows 10, without the need for a separate installation of software like a virtual machine.

Users can first find the Microsoft Store on Windows 10, and then search “Linux” in the App Store. There are many versions that will appear. The recommended version is Ubuntu 20.04 LTS. If you have a Linux system installed, everything will work the same.

Search for Linux to find and install Ubuntu:

Search for Linux to find and install Ubuntu

If Ubuntu is installed, you can start it from this screen:

Start Ubuntu from search result screen

The next time you want to use ubuntu, you don't need to open the Microsoft Store. You can start Ubuntu directly from the menu bar:

Start Ubuntu from the menu bar

Become a validation node

Once the node software is installed, deployed and up and running, it is a normal node, synchronizing node data and validate transactions normally. However, normal nodes cannot generate blocks. In order to generate blocks, they must become validation nodes. At the current stage, to become a validation node, you must state 500,000 ECO. For details on the operation process, see the staking topic.

Node Hardware Configuration

The standard configuration

Only the core configuration of the node server is listed below:

  • CPU: 4 cores

  • Memory: 16G

  • Hard disk: 1T

  • Bandwidth: 10M

Normal nodes can adopt this standard configuration and perform tasks such as synchronizing data and validating transactions

Only the core configuration of the node server is listed below:

  • CPU: 8 cores

  • Memory: 32G

  • Hard disk: 2T

  • Bandwidth: 20M to 100M

The verification node recommends this recommended configuration to perform tasks such as synchronizing data, validating transactions, generating blocks, and so on.

Basic commands

Curl is a tool you need to test basic commands, and most Linux systems come with .

If the test is performed on a local node machine, the address and port of the node's external service is :

If the deployment to the public internet, and the domain name resolution, you can access through the domain name, such as

The first line of each of the following commands is the request execution and the second line is the return response.


Returns the client version number.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'



Returns the keccak-256 of the given value.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'



Returns the current network ID.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'



Returns the client listening network connection status.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'



Returns the number of nodes currently connected to the client.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'



Returns the current Ethereum protocol version number. Since EcoBall is Ethereum compatible, the protocol version number lets you know if the dApp is suitable for migration.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'



Returns the current gas price.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":71}'



Returns the wallet address of the current node.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":71}'



Returns the current block number.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":71}'



Returns the balance of the given wallet address.

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x01c9a1515ae1d0df16e30f48ab5cbddcfd9413d4", "latest"],"id":1}'


In the JSON object, result is the balance corresponding to the wallet address, the hexadecimal number, which can be converted to base 10, and then divided by 10**18, to get the number of ECO.