Tools for Everscale/Venom blockchains were merged into Everscale/Venom node repository https://github.com/tonlabs/ever-node.git

Tools for Everscale/Venom blockchains

• About
• Getting Started
• Usage
• Contributing
• License

This repository contains a collection of tools used to manage the Everscale/Venom node.

• Rust complier v1.65+.
• OpenSSL

  sudo apt-get install libssl-dev (openssl-devel on Fedora)
  sudo apt-get install pkg-config

git clone --recurse-submodules https://github.com/tonlabs/ever-rldp.git
cd ever-rldp
cargo build --release

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 timeout

Where

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

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.

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"

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"

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"

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"

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"

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"

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"

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"

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"

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"

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"

getblockchainconfig - get current config from masterchain state.

Returns boc with current config.

Example:

console -c "getblockchainconfig"

This tool generates config and zerostate for network launch from json zerostate file.

zerostate -i zerostate.json

Where

zerostate.json – is the zerostate file.

This tool generates an ed25519 key and prints it out in different formats.

keygen

Command 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_key

Where

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

Where

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