Гайд для witness/seed ноды

Рекомендованные (минимальные) системные требования:

• 4 Гб оперативной памяти и 80 Гб SSD накопителя

• Linux-система, напр. Ubuntu 18.04/20.04 + стабильный интернет

Устанавливаем Docker

sudo apt-get update && 
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update && 
sudo apt-get install docker-ce docker-ce-cli containerd.io -y

Устанавливаем ноду

Скачиваем файл цепочки блоков only block_log (без него синхронизация от сети seed-нод занимает около 2-3 суток), либо полный backup witness node (с ним запуск займёт около часа).

Германия 1

only block_log

rsync --progress -e 'ssh -p23' --recursive [email protected]:block_log ~/home/blockchain/

backup witness node

rsync --progress -e 'ssh -p23' --recursive [email protected]: ~/home/blockchain/

password

veAujuuVZtivnUj7

Финляндия 1

Германия 2

Финляндия 2

Генерируем ключи

Для облегчения получения ключей, вместо запуска ноды без них, использования команды suggest_brain_key в cli-wallet для генерирования, правки конфига и перезапуска ноды, можно сразу сгенерировать их здесь, или на раз / два.

Только в Public-key (публичном ключе) заменить три начальных символа VIZ на GLS. Этот ключ нам понадобится для объявления себя делегатом позднее, а Private-key (приватный ключ) уже на следующем шаге.

Загружаем конфиг

Предварительно заменив значения witness и private-key на свои. В качестве witness запишем логин без @ от своего аккаунта на Голосе, private-key тот что сгенерировали на шаге выше.

mkdir ~/config && echo 'p2p-endpoint = 0.0.0.0:4243
webserver-thread-pool-size = 4
webserver-http-endpoint = 0.0.0.0:8090
webserver-ws-endpoint = 0.0.0.0:8091
read-wait-micro = 500000
max-read-wait-retries = 2
write-wait-micro = 500000
max-write-wait-retries = 3
single-write-thread = true
enable-plugins-on-push-transaction = false
block-num-check-free-size = 7200
plugin = chain p2p json_rpc webserver network_broadcast_api witness database_api witness_api
clear-votes-before-block = 4294967295
store-account-metadata = false
store-memo-in-savings-withdraws = false
store-comment-extras = false
skip-virtual-ops = true
enable-stale-production = false
required-participation = 33
witness = "ЛОГИН-ДЕЛЕГАТА"
private-key = ПРИВАТНЫЙ-КЛЮЧ-НОДЫ
[log.console_appender.stderr]
stream=std_error
[log.file_appender.p2p]
filename=logs/p2p/p2p.log
[logger.default]
level=debug
appenders=stderr
[logger.p2p]
level=none
appenders=stderr' | sudo tee -a ~/config/config.ini

Использование Docker-Compose

Для тех кто разбирается, обратите внимание на этот пост.

Запускаем контейнер

sudo docker run -it \
    -p 4243:4243 \
    -v ~/config/config.ini:/etc/golosd/config.ini \
    -v ~/home/blockchain:/var/lib/golosd/blockchain \
    -v ~/wallet:/golosd \
    --log-opt max-size=500m \
    --name golosd golosblockchain/golos:latest

Начнётся загрузка образа ноды и реплей (наполнение файла оперативных данных shared_memory.bin из блоков), который будет продолжаться от пары часов до суток (в зависимости от производительности вашего сервера).

Можно оставить окно терминала или закрыть его, подключившись позднее и зайдя в логи ноды командой:

sudo docker logs -f --tail 50 golosd

С появлением в логах ноды подобных сообщений о получении блоков, окно терминала можно закрыть (всё в порядке).

Телеграм-бот о пропуске блоков

Для отслеживания работы делегатских нод и пропуска ими блоков можно использовать бот @golos_witness_monitor_bot

Работа с cli-wallet

Эти действия нужны лишь для первого запуска ноды.

Заходим в cli_wallet ноды.

sudo docker exec -it golosd cli_wallet \
    -w /golosd/wallet.json \
    -s ws://localhost:8091

Добавляем свой пароль к cli_wallet (запишите его и сохраните):

set_password 123456789

Разблокируем доступ:

unlock 123456789

Импортируем в cli_wallet наш приватный активный ключ аккаунта-делегата (ключ, который смотреть тут https://golos.id/@lex/permissions, начинается с цифры 5).

import_key 5Js............

Объявляем себя делегатом, с публичным ключом GLS (который мы сгенерировали ранее в паре к приватному ключу для конфига ноды).

Нужно заменить логин, ссылку на пост/аккаунт делегата + публичный ключ.

update_witness "ЛОГИН" "https://golos.id/@ЛОГИН" GLS............. true

Публикуем свой первый прайс-фид, заменив на свой логин-делегата.

publish_feed ЛОГИН {"quote":"1.000 GOLOS", "base":"0.500 GBG"} true

Для выхода из cli_wallet вводим команду:

quit

Публикация прайсфидов

Запускаем в докере ещё один контейнер, подробнее об этом скрипте можно прочитать здесь.

sudo docker run -it \
    -e NODE=ws://localhost:8091 \
    -e WITNESS=ЛОГИН-ДЕЛЕГАТА \
    -e KEY=ПРИВАТНЫЙ-АКТИВНЫЙ-КЛЮЧ \
    --log-opt max-size=500m \
    --name feed --net=container:golosd vvk123/golos-witness-tools ./update_price_feed.py --monitor

* нужно заменить логин и приватный активный ключ аккаунта-делегата на свои

Пример скриншота после выполнения команды:

После появления логов с калькуляцией курса GBG, закрываем окно терминала.

Изменения в конфиге

Заходим в конфиг командой:

sudo nano ~/config/config.ini

Вносим нужные правки, нажимаем Ctrl+O, подтверждаем Enter, выходим Ctrl+X.

Перезапускаем контейнер ноды.

sudo docker restart golosd

Делегатские параметры

Заходим на https://golos.id/~witnesses и напротив своего делегата в столбце “Параметры” нажимаем на значок настроек (описание каждого параметра возникает при наведении мышкой).

Подробнее о значении медианных параметров. Изменить параметры можно и через cli_wallet ноды, заменив логин и выполнив команду. Параметры в порядке появления в хардфорках блокчейна:

16

update_chain_properties ЛОГИН {"account_creation_fee":"1.000 GOLOS", "maximum_block_size":65536, "sbd_interest_rate":0, "create_account_min_golos_fee":"0.100 GOLOS", "create_account_min_delegation":"1.000 GOLOS", "create_account_delegation_time":2592000, "min_delegation":"1.000 GOLOS"} true

19

22

23

24

26

27

28

Обновление ноды

Ставим “пустой ключ” для ноды чтобы приостановить подпись блоков через параметры на странице https://golos.id/@lex/witness (заменив на свой логин). Или через cli_wallet ноды командой

update_witness "ЛОГИН" "https://golos.id" GLS1111111111111111111111111111111114T1Anm true

Останавливаем докер-контейнер ноды и удаляем его

sudo docker stop golosd && sudo docker rm golosd

Если в анонсе обновления было указано что нужен реплей, удаляем файл shared_memory.bin

sudo rm ~/home/blockchain/shared_memory.bin

Останавливаем докер-контейнер скрипта прайсфида и удаляем его

sudo docker stop feed && sudo docker rm feed

Удаляем образы для ноды и скрипта прайсфида

sudo docker rmi golosblockchain/golos && sudo docker rmi vvk123/golos-witness-tools

Запускаем контейнер с новой версией

sudo docker run -it \
    -p 4243:4243 \
    -v ~/config/config.ini:/etc/golosd/config.ini \
    -v ~/home/blockchain:/var/lib/golosd/blockchain \
    -v ~/wallet:/golosd \
    --log-opt max-size=500m \
    --name golosd golosblockchain/golos:latest

После появления логов вида handle_block "Got 0 transactions on block 34563842 by ...", закрываем окно терминала.

Возвращаем публичный ключ ноды GLS.............. который ранее сбрасывали через параметры на странице https://golos.id/@lex/witness или через cli_wallet, заменив в команде ниже логин, ссылку на пост/аккаунт делегата + публичный ключ на свои:

update_witness "ЛОГИН" "https://golos.id/@ЛОГИН" GLS................. true

Возвращаем докер-контейнер скрипта публикации прайсфида (заменив логин и приватный активный ключ аккаунта-делегата на свои)

sudo docker run -it \
    -e NODE=ws://localhost:8091 \
    -e WITNESS=ЛОГИН-ДЕЛЕГАТА \
    -e KEY=ПРИВАТНЫЙ-АКТИВНЫЙ-КЛЮЧ \
    --log-opt max-size=500m \
    --name feed --net=container:golosd vvk123/golos-witness-tools ./update_price_feed.py --monitor

После появления логов с калькуляцией курса GBG, закрываем окно терминала.

Есть вопросы?

Можно уточнить в чате делегатов https://t.me/golos_witnesses