Description of the node configuration file parameters and sections

Several types of values are used for parameters in the configuration file.

  • Integer data which used to specify the exact number of elements. It can be the number of transactions, blocks or connections.

  • Integer data including measuring units to specify the time periods or memory volume. You typically specify the time periods in days, hours, or seconds, or the cache memory volume, for example, leveldb-cache-size = 256M or connection-timeout = 30s.

  • String which used to specify the addresses, directory paths, passwords and so on. The directory path is specifying in the acceptable format of your current OS and the value is quoted.

  • Array for the list of values like addresses or public keys. The value is specified in square brackets separated by commas.

  • Boolean no or yes which used for option activation.

An example of the node configuration file is represented on the configuration files prepare page. It includes the following sections:

  • node - general section, which includes all sections of blockchain settings.

  • ntp - NTP server parameters settings.

  • blockchain - common blockchain settings.

  • features - network settings.

  • network - network settings.

  • wallet - settings of the private keys access.

  • miner - mining settings.

  • rest-api - REST API settings.

  • privacy - confidential information access groups settings.

  • docker-engine - Docker smart contracts settings.

node section

Additional section parameters:

  • waves-crypto - cryptography type in the blockchain. Possible values: yes - Waves cryptography, no - GOST cryptography.

  • directory - the main directory for the storage of the node software.

  • data-directory - the main directory for the storage of the node software.

  • logging-level - logging level. Possible values: DEBUG, INFO, WARN, ERROR, default value is INFO.

  • owner-address - the node address, the future owner of the configuration file.

ntp section

  • fatal-timeout - the timeout of the connection to an NTP server. The recommended value is 1 minute.

  • server - адрес NTP-сервера. Рекомендуемое значение -

blockchain section

  • type - the blockchain type. Could be DEFAULT or CUSTOM. Default value is DEFAULT.

  • consensus.type - consensus type. Possible values are PoS or PoA.

fees unit

  • enabled - the option of using fees for the transaction release. Possible values are false or true.

custom unit

  • address-scheme-character - the address feature character which is used to prevent mixing up addresses from different networks. For the “Waves Enterprise Mainnet” - V and for the “Waves Enterprise Partnernet” - P. You can use any letter you like for the sidechain or test versions of the Waves Enterprise blockchain platform. Nodes must have the same network byte on the same blockchain network.

  • functionality - main blockchain settings.

  • genesis - genesis block settings.

functionality unit

  • feature-check-blocks-period - the blocks period for feature checking and activation.

  • blocks-for-feature-activation - the number of blocks required to accept feature.

  • pre-activated-features - a set of blockchain options.

genesis unit

  • average-block-delay - an average delay between the blocks creation.

  • initial-base-target - an initial base number for the managing the mining process.

  • block-timestamp - a time and data code. The time is specified in milliseconds and the value must consist of 13 digits. If you specify the standard value timestamp consisting of 10 digits, then you need to add any three digits at the end.

  • initial-balance - an initial balance in smallest units.

  • genesis-public-key-base-58 - the public key hash of the genesis block, encrypted in Base58.

  • signature - the genesis block signature, encrypted in Base58.

  • transactions - a list of network participants with an initial balance, the creation of which will be included in the genesis block.

  • network-participants - a list of network participants with specified roles, the creation of which will be included in the genesis block.

network section

  • bind-address - the node network address.

  • port - the port number.

  • known-peers - a list of IP addresses of well known nodes.

  • declared-address - a string with IP address and port to send as external address during the handshake.

wallet section

  • file - a path to the private keys storage.

  • password - a password for the private keys file access.

miner section

  • enable - a miner option activation.

  • quorum - required number of connections (both incoming and outgoing) to attempt block generation. Setting this value to 0 enables off-line generation.

  • interval-after-last-block-then-generation-is-allowed - enable block generation only if the last block is not older the given period of time.

  • micro-block-interval - an interval between microblocks.

  • min-micro-block-age - a minimal age of the microblock.

  • max-transactions-in-micro-block - a maximum number of transaction in the microblock.

  • minimal-block-generation-offset - a minimal time interval between blocks.

features section

  • supported - a list of supported options.