Ecoball Chain
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
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
node directory structure
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: Staking.

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.
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 created early along with wallet creation above. Save and exit.
wallet password file

Modify the startup configuration file

vim config.toml
The initial value of the node configuration file:
initial node config
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:
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 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
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 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
node monitor

Running in Windows 10 environment

For now, there is only Linux version of the node program. If you do not have a Linux computer, Windows 10 could also work, a Linux running environment on Windows 10 will be required. Since the Linux subsystem is natively supported in Windows 10, you can run 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. Here we recommend the Ubuntu 20.04 LTS version.
Search for Linux to find and install Ubuntu:
Once Ubuntu is installed, run it:
The next time you use Ubuntu, you can run Ubuntu directly from the menu bar:
Start Ubuntu from the menu bar
Every other setup steps are the same as the ones for Linux system.

Become a validation node

Once the node software is installed, deploy and run, 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. Learn more at 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 are recommended the above 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 is on 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 indicates 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.
Last modified 9d ago