Описание основных параметров и секций конфигурационного файла ноды¶
Для параметров в конфигурационном файле применяется несколько типов значений.
Числовое значение, используемое для указания точного количества элементов. Это может быть количество транзакций, блоков, соединений.
Числовое значение с указанием единиц измерения, используемое для определения временного периода или объёма памяти. В таком виде, как правило, указываются временные периоды в днях, часах или секундах, или объём кэш-памяти, например,
leveldb-cache-size = 256M
илиconnection-timeout = 30s
.Строковое значение, используемое для указания адресов, путей к директориям, паролям и т.д. Путь к директории указывается в формате, приемлемом для текущей ОС. Значение указывается в кавычках.
Массив, используемый для указания списков значений, например, адресов или публичных ключей. Значение указывается в квадратных скобках через запятую.
Логический тип
no
илиyes
, используемый для активации различных опций.
Пример конфигурационного файла представлен на странице подготовки конфигурационных файлов. В состав файла входят следующие секции:
node - общая секция, куда входят все секции и дополнительные параметры для настройки ноды.
ntp - настройка параметров NTP-сервера.
blockchain - настройка основных параметров блокчейна.
features - настройка дополнительных параметров ноды.
network - сетевые настройки.
wallet - настройка доступа к закрытым ключам ноды.
miner - настройка майнинга.
rest-api - настройка REST API и типа авторизации для доступа к REST API.
privacy - настройка групп доступа к конфиденциальной информации.
docker-engine - настройка Docker смарт-контрактов.
Секция node
¶
Дополнительные параметры секции:
waves-crypto
- тип шифрования в блокчейне. Возможные значения:yes
- выбор криптографии Waves,no
- выбор ГОСТ-криптографии.directory
- основная директория для хранения ПО ноды.data-directory
- директория для хранения данных блокчейна в LevelDB: блоки, транзакции, стейт ноды.logging-level
- уровень логирования работы ноды. Возможные значения:DEBUG
,INFO
,WARN
,ERROR
, по умолчанию установлено значениеINFO
.owner-address
- адрес ноды, которая будет владельцем конфигурационного файла. Если владелец ноды будет начальным участником сети, то его адрес и публичный ключ должны быть в genesis блоке.
Секция ntp
¶
servers
- список адресов NTP-серверов. Рекомендуемое значение -pool.ntp.org
.request-timeout
- таймаут для одного запроса на NTP-сервер. Рекомендуемое значение - 10 секунд.expiration-timeout
- таймаут синхронизации запросов к NTP-серверу. Рекомендуемое значение - 1 минута.fatal-timeout
- таймаут подключения к NTP-серверу. Рекомендуемое значение - 1 минута.
Секция blockchain
¶
type
- тип блокчейна. Возможные значенияMAINNET
илиCUSTOM
. ЗначениеMAINNET
позволяет использовать genesis-блок, консенсус и настройки сети Mainnet. При выборе значенияMAINNET
в конфигурационном файле ноды, которая подключается к сети Mainnet, не нужно указывать параметры блоковcustom
,genesis
иconsensus
.consensus.type
- тип консенсуса в блокчейне. Возможные значенияpos
илиpoa
. Вы можете подробно почитать о настройке консенсуса здесь.
Блок fees
enabled
- опция использования комиссий за выпуск транзакций. Возможные значенияfalse
илиtrue
.
Блок custom
address-scheme-character
- байт сети, для «Waves Enterprise Mainnet» -V
, для «Waves Enterprise Partnernet» -P
. Данный параметр используется для предотвращения конфликта адресов из разных сетей. Для сайдчейна или для тестовых версий блокчейн-платформы Waves Enterprise можно использовать любые буквы. Ноды в одной блокчейн-сети должны иметь одинаковый байт сети.functionality
- блок настройки основных параметров блокчейна.genesis
- блок настройки параметров генезис-блока.
Блок functionality
feature-check-blocks-period
- количество блоков, через которые выполняется проверка и активация опций блокчейна.blocks-for-feature-activation
- количество блоков, через которые применяется активированная опция.pre-activated-features
- набор опций блокчейна.
Блок genesis
average-block-delay
- средняя задержка создания блоков. Данный параметр используется для консенсуса PoS.initial-base-target
- начальное базовое число для регулирования процесса майнинга. Данный параметр используется для консенсуса PoS. От значения параметра зависит частота формирования блоков - чем больше значение, тем чаще создаются блоки. Также величина баланса майнера влияет на использование данного параметра в майнинге - чем больше баланс майнера, тем меньше становится значениеinitial-base-target
для выбора ноды-майнера. При выставлении значения данному параметру рекомендуется учитывать комбинацию балансов майнеров и ожидаемый интервал между блоками.block-timestamp
- числовой код даты и времени. Время указывается в миллисекундах, значение должно состоять из 13 цифр. Если вы берёте стандартное значениеtimpstamp
, состоящее из 10 цифр, то в конце необходимо добавить три любые цифры.initial-balance
- начальный баланс сети. Значение этого параметра влияет на процесс майнинга при PoS консенсусе. Чем больше баланс майнера, тем меньше становится значениеinitial-base-target
для определения ноды-майнера текущего раунда.genesis-public-key-base-58
- хеш публичного ключа генезис-блока, зашифрованный в Base58.signature
- подпись генезис-блока, зашифрованная в Base58.transactions
- список участников сети с первоначальным балансом, создание которых войдёт в генезис-блок в виде генезис-транзакций.network-participants
- список сетевых участников с ролями, создание которых войдёт в генезис-блок в виде генезис-транзакций.
Секция network
¶
bind-address
- сетевой адрес ноды.port
- номер порта.known-peers
- список известных сетевых адресов нод.declared-address
- сетевой адрес ноды вместе с номером порта для процедуры handshake.
Секция wallet
¶
file
- директория для хранения приватных ключей.password
- пароль для доступа к файлу с приватными ключами.
Секция miner
¶
enable
- активация опции майнинга.quorum
- необходимое количество нод-майнеров для создания блока. Значение0
позволит генерировать блоки оффлайн. При указании значения необходимо учитывать, что собственная нода-майнер не суммируется со значением этого параметра, т.е., если вы указываетеquorum = 2
, то для майнинга нужно минимум 3 ноды-майнера.interval-after-last-block-then-generation-is-allowed
- создание блока только в том случае, если последний блок не старше указанного периода времени.micro-block-interval
- интервал между микроблоками.min-micro-block-age
- минимальный возраст микроблока.max-transactions-in-micro-block
- максимальное количество транзакций в микроблоке.minimal-block-generation-offset
- минимальный временной интервал между блоками.
Секция features
¶
supported
- список поддерживаемых опций.