Everscale/Venom node and validator with tools
Implementation of Everscal/Venom node and validator in safe Rust. This repository also contains a collection of tools used to manage the Everscale/Venom node.
Rust complier v1.76+.
apt-get update
apt-get install pkg-config make clang libssl-dev libzstd-dev libgoogle-perftools-dev
git clone --recurse-submodules https://github.com/everx-labs/ever-node.git
cd ever-node
cargo build --release
cargo test --release --package catchain -- --nocapture --test-threads=1
cargo test --release --package storage -- --nocapture --test-threads=1
cargo test --release --package validator_session -- --nocapture --test-threads=1
cargo test --release -- --nocapture --test-threads=1
To get help about command line arguments, run
ever-node --help
This tool serves the purpose of generating election requests for the Rust Node. The tool is compatible with TONOS-CLI and allows to perform all actions necessary to obtain a signed election request.
console -C console.json -c "commamd with parameters" -c "another command" -t timeoutWhere
console.json - path to configuration file
commamd with parameters/ another command – any of the supported console commands with necessary parameters
timeout – command timeout in seconds
Configuration file should be created manually and have the following format:
{
"config": {
"server_address": "127.0.0.1:4924",
"server_key": {
"type_id": 1209251014,
"pub_key": "cujCRU4rQbSw48yHVHxQtRPhUlbo+BuZggFTQSu04Y8="
},
"client_key": {
"type_id": 1209251014,
"pvt_key": "oEivbTDjSOSCgooUM0DAS2z2hIdnLw/PT82A/OFLDmA="
}
},
"wallet_id": "-1:af17db43f40b6aa24e7203a9f8c8652310c88c125062d1129fe883eaa1bd6763",
"max_factor": 2.7
}Where
server_address – address and port of the node.
server_key – structure containing server public key. Can be generated with keygen tool.
client_key – structure containing client private key. Can be generated with keygen tool.
type_id – key type, indicating ed25519 is used. Should not be changed.
wallet_id – validator wallet address.
max_factor – max_factor stake parameter (maximum ratio allowed between your stake and the minimal
validator stake in the elected validator group), should be ≥ 1
addadnl – sets key as ADNL address.
params:
• perm_key_hash - ed25519 hash of permanent public key in hex or base64 format.
• key_hash - ed25519 hash of public key in hex or base64 format.
• expire-at - time the ADNL address expires and is deleted from node, in unixtime.
Example:
console -c "addadnl 4374376452376543 6783978551824553 1608288600"addpermkey - adds validator permanent key
params:
• key_hash - ed25519 hash of public key in hex or base64 format.
• election-date - election start in unixtime.
• expire-at- time the key expires and is deleted from node, in unixtime.
Example:
console -c "addpermkey 4374376452376543 1608205174 1608288600"addtempkey - adds validator temporary key.
params:
• perm_key_hash - ed25519 hash of permanent public key in hex or base64 format.
• key_hash - ed25519 hash of public key in hex or base64 format.
• expire-at - time the key expires and is deleted from node, in unixtime.
Example:
console -c "addtempkey 4374376452376543 6783978551824553 1608288600"addvalidatoraddr - adds validator ADNL address.
params:
• perm_key_hash - ed25519 hash of permanent public key in hex or base64 format.
• key_hash - ed25519 hash of public key in hex or base64 format.
• expire-at- time the ADNL address expires and is deleted from node, in unixtime.
Example:
console -c "addvalidatoraddr 4374376452376543 6783978551824553 1608288600"election-bid - obtains required information from the blockchain, generates all the necessary keys for validator, prepares the message in predefined format, asks to sign it and sends to the blockchain.
params:
• election-start - unixtime of election start.
• election-end - unixtime of election end.
• filename - filename with path to save body of message ("validator-query.boc" by default)
Example:
console -c "election-bid 1608205174 1608288600"Command calls all other necessary subcommands automatically. Election request is written to file.
exportpub - exports public key by key hash.
params:
• key_hash - ed25519 hash of public key in hex or base64 format.
Returns public_key - ed25519 public key in hex and base64 format.
Example:
console -c "exportpub 4374376452376543"getaccount - load and save (optional) account information in json-format.
params:
• account_address - is the account address.
• file_name - is the file's name to save account information in json-format. This param is optional.
Returns json with account information.
Base json-fields:
• acc_type - account type description;
• balance - account balance;
• last_trans_lt - logical time of the last account's transaction;
• data(boc) - account`s boc.
Example:
console -c "getaccount 0:000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F"getaccountstate - save account to the file (in bag of cells format).
params:
• account_address - is the account address.
• file_name - is the file's name to save account's boc.
Returns account's boc.
Example:
console -c "getaccountstate 0:000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1F account.boc"getblockchainconfig - get current config from masterchain state.
Returns boc with current config.
Example:
console -c "getblockchainconfig"getconfig - get current config param from masterchain state.
params:
• param_number - config parameter number.
Returns boc with current config param.
Example:
console -c "getconfig 15"getstats - get node status, validation status (if node is validator) and other information.
Command has no parameters.
Returns node's information in JSON-format.
base json-fields:
• sync_status - synchronization status description;
• masterchainblocktime - field with time of last masterchain block, downloaded by node;
• masterchainblocknumber - field with number of last masterchain block, downloaded by node;
• timediff - field with time difference between now and last loaded masterchain block's time;
• in_current_vset_p34 - true, if config param p34 contains this node's key;
• in_current_vset_p36 - true, if config param p36 contains this node's key;
• last applied masterchain block id - field with information about last applied masterchain block's id;
• processed workchain - field with information about the processed workchain;
• validation_stats - field with information about validated workchains;
• tps_10 - transactions per second average over 10 seconds;
• tps_300 - transactions per second average over 300 seconds;
Example:
console -c "getstats"newkey - generates new key pair on server.
Command has no parameters.
Returns ed25519 hash of public key in hex and base64 format.
Example:
console -c "newkey"recover_stake – recovers all or part of the validator stake from elector.
params:
• filename - filename with path to save body of message ("recover-query.boc" by default)
Example:
console -c "recover_stake"sendmessage - loads a serialized message from file and sends it to nodes as an external message.
params:
• file_name - serialized message file (in bag of cells format).
Example:
console -c "sendmessage message.boc"sign - signs bytestring with private key.
params:
• key_hash - ed25519 hash of public key in hex or base64 format.
• data - data in hex or base64 format.
Example:
console -c "sign 4374376452376543 af17db43f40b6aa24e7203a9f8c8652310c88c125062d1129f"This tool generates config and zerostate for network launch from json zerostate file.
zerostate -i zerostate.jsonWhere
zerostate.json – is the zerostate file.
This tool generates an Ed25519 key and prints it out in different formats.
keygenCommand has no parameters.
This tool generates the node DHT record, for example, for the purposes of adding it to the global blockchain config.
gendht ip:port pvt_keyWhere
ip:port – Node IP address and port.
pvt_key – Node private key.
Example:
gendht 51.210.114.123:30303 ABwHd2EavvLJk789BjSF3OJBfX6c26Uzx1tMbnLnRTM=This tool scans DHT for node records.
dhtscan [--jsonl] [--overlay] [--workchain0] path-to-global-configWhere
--jsonl – optional flag that sets the output as single line json. Default output is multiline json.
--overlay – optional flag to search for overlay nodes.
--workchain0 – optional flag to search both in masterchain and basechain. By default only masterchain is searched.
path-to-global-config – path to network global config file.
This tool prints a state or block from the database.
print -d path [-s state_id] [-b block_id] [--accounts]Where
path – path to node database.
block_id – id of the block to be printed.
state_id – id of the state to be printed.
accounts - short info of all accounts will be printed as json
Contribution to the project is expected to be done via pull requests submission.
See the LICENSE file for details.
blockchain everscale rust venom-blockchain venom-developer-program venom-node venom-validator