Установка

Обновляем пакеты системы

sudo apt update && sudo apt upgrade -y

Устанавливаем нужные программы

sudo apt-get install jq curl git mc nano gcc g++ make -y

Установим Golang версии 1.18

wget -O go1.18.linux-amd64.tar.gz https://go.dev/dl/go1.18.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.18.linux-amd64.tar.gz && rm go1.18.linux-amd64.tar.gz
cat <<'EOF' >> $HOME/.bash_profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF
. $HOME/.bash_profile
cp /usr/local/go/bin/go /usr/bin
go version

Установим Rizon.

Актуальные релизы можно посмотреть тут https://github.com/rizon-world/rizon/tags

git clone https://github.com/rizon-world/rizon.git
cd rizon
# git fetch - иногда вставляют
git checkout v0.3.0
git pull origin v0.3.0
make install

rizond version
# v0.3.0

The built binary - rizond - will be located in your $GOBIN

В нашем случае это переменная с путём PATH=$PATH:/usr/local/go/bin:$HOME/go/bin

Зададим переменные для удобной работы

Уточните актуальность chain-id тут https://github.com/rizon-world/mainnet. На момент написания гайда chain-id = titan-1

Rizon_moniker=<Your_Moniker>
echo $Rizon_moniker
echo 'export Rizon_moniker='\"${Rizon_moniker}\" >> $HOME/.bash_profile

Rizon_wallet=<Your_Wallet_Name>
echo $Rizon_wallet
echo 'export Rizon_wallet='\"${Rizon_wallet}\" >> $HOME/.bash_profile

chainName=titan-1
echo $chainName
echo 'export chainName='\"${chainName}\" >> $HOME/.bash_profile

Загрузим переменные. Как и для чего читайте [тут].

. $HOME/.bash_profile

# Это не нужно 100% (оставляю для истории)
cp $HOME/go/bin/rizond /usr/local/bin
cp $HOME/go/bin/rizond /usr/local/sbin

Инициализируем ноду

После установки бинарника rizond, пришло время сделать инит ноды.

Если rizond уже был установлен

То надо очистить конфигурации.

# remove old genesis.json file
rm -rf ~/.rizon/config/genesis.json

# reset old blockchain data
rizond unsafe-reset-all

[Init] Setup your initial node

rizond init $Rizon_moniker --chain-id titan-1

Под $Rizon_moniker - мы вставили имя ноды, которое будет отображаться в explorer.

Chain id смотрим тут https://github.com/rizon-world/mainnet

Меняем genesis.json

Генезис файл определяет состояние сети в момент запуска. В мен записанвсе необходимое: первоначальные аллокации, время запуска, параметры и так далее.

После инита ноды надо подгрузить его с гитхаба заменив genesis.json, который был создан при ините ноды, так как при rizond init был создан ложный genesis.json (сеть же запущена уже).

Надо загрузить его от сюда https://raw.githubusercontent.com/rizon-world/mainnet/master/genesis.json и подменить им файл по адресу ~/.rizon/config/genesis.json чтобы присоединиться к mainnet.

Два способа. Выберите свой. Первый - закачаем wget, а затем заменим cp:

wget https://raw.githubusercontent.com/rizon-world/mainnet/master/genesis.json
cp -f genesis.json ~/.rizon/config/genesis.json

Второй - ещё проще. Одной командой, через curl:

curl -o ~/.rizon/config/genesis.json https://raw.githubusercontent.com/rizon-world/mainnet/master/genesis.json

Проверка checksum файла genesis.json:

jq -S -c -M '' ~/.rizon/config/genesis.json | shasum -a 256
# You can see the below.
5f00af49e86f5388203b8681f4482673e96acf028a449c0894aa08b69ef58bcb  -

Настройка Конфигурации ноды

Нужно изменить два конфигурационных файла, это app.toml and config.toml.

app.toml

minimum-gas-prices Для предотвращения обработки спамных транзакций надо выставить параметр minimum-gas-prices равным 0.0001uatolo:

sed -i 's/minimum-gas-prices = ""/minimum-gas-prices = "0.0001uatolo"/g' ~/.rizon/config/app.toml
sed -i.bak -e "s/^minimum-gas-prices *=.*/minimum-gas-prices = \""0.0001uatolo"\"/" ~/.rizon/config/app.toml

config.toml

закомментируем строку log_level = "info" Это нужно чтобы прописать эту настройку в сервис файле для удобного изменения.

sed -i.bak 's/^log_level/# log_level/' $HOME/.rizon/config/config.toml

вставим в config.toml свой moniker

# Перед вставкой проверьте, в Rizon скорее всего при init уже вставился автоматом!
sed -i.bak -e "s/^moniker *=.*/moniker = \"$Rizon_moniker\"/" $HOME/.rizon/config/config.toml

seeds; peers Добавьте как минимум 1 сид ноду, для того, чтобы ваша нода смогла найти остальные пиры. Seed пиры найдите по адресу https://github.com/rizon-world/mainnet Это изменение проводим в секции [p2p], параметр seeds.

SEEDS="[e-mail]:26656,[e-mail]:26656,[e-mail]:26656"
PEERS="[e-mail]:26656"
sed -i.bak -e "s/^seeds *=.*/seeds = \"$SEEDS\"/; s/^persistent_peers *=.*/persistent_peers = \"$PEERS\"/" $HOME/.rizon/config/config.toml

Запуск

rizond.service

Создадим сервис файл для автономной работы Rizond. Одной командой:

sudo tee <<EOF >/dev/null /etc/systemd/system/rizond.service
[Unit]
Description=Rizon Cosmos daemon
After=network-online.target

[Service]
User=$USER
ExecStart=/root/go/bin/rizond start --log_level=info
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Замечу, что название сервис файла может быть другим, хоть сейчас это rizond.

А вот что мы не сможем изменить: rizond - это начало команды которое прописали разработчики в бинарный файл, это мы поменять не можем.

Выше, при установке Rizon мы определились, что переменная с путём PATH=$PATH:/usr/local/go/bin:$HOME/go/bin Поэтому мы и указали такой путь в строке ExecStart.

Теперь надо определиться как запустить синхронизацию. 3 варианта.

Выбрать способ запуска синхронизации.

Есть 3 варианта:

1. Запуститься по snapshot

2. С помощью опции state sync

Комьюнти сервисы для бсныстрой синхронизации: - https://nodejumper.io/rizon/sync - https://ping.pub/rizon/statesync

3. Начать синхронизацию с генезиса. Тоесть загружать все блоки, с начала сети. При этом, если были обновления сети, то на определенном блоке сеть остановится и нужно будет обновиться и запустить ноду вновь. До тех пор, пока синхронизация не догонит последние блоки.

Запуститься по snapshot

Специально для синхронизации по snapshot не надо настраивать app.toml или config.toml, достаточно базовой настройки.

Но перед загрузкой снапшота надо очистить папку data и сделать unsafe-reset-all (это сбросит конфигурацию priv_validator_state)

sudo systemctl stop rizond && rizond unsafe-reset-all
cd ~/.rizon/data; ls | grep -v 'priv_validator_state.json' | xargs rm -rf

После команды выше, мы остаемся в нужной нам папке cd ~/.rizon/data где и продолжим работу.

Это не обязательный пункт. Если вы случайно удалили и не забекапили priv_validator_stat, ничего страшного - это всего лишь файл состояние (не ключ) создать его можно rizond init $Rizon_moniker --chain-id titan-1 И раз уж вы опять сделали init, надо проверить и возможно опять загрузить genesis.json!

Теперь загрузим snapshot с помощью wget (ресурс взят с сайта https://nodejumper.io/rizon/sync):

Для начала установим программу для разархивации:

sudo apt install snapd -y; && sudo snap install lz4 -y

Этим мы скопируем на сервер снапшот, распакуем его и запустим вновь бинарный файл с помощью сервис файла:

rm -rf ~/.rizon/data && cd ~/.rizon
SNAP_NAME=$(curl -s https://snapshots1.nodejumper.io/rizon/ | egrep -o ">titan-1.*\.tar.lz4" | tr -d ">")
wget -O - https://snapshots1.nodejumper.io/rizon/${SNAP_NAME} | lz4 -dc - | tar -xf -
sudo systemctl restart rizond
sudo journalctl -u rizond -f --no-hostname

Проверка синхронизации

curl localhost:26657/status | jq '.result.sync_info'

Готово!

Запуститься по state sync

Для синхронизации по state sync надо настраивать app.toml .

Но перед этим надо: 1) очистить папку data, удалив все, кроме priv_validator_state.json 2) и сделать unsafe-reset-all (это сбросит конфигурацию priv_validator_state.json)

sudo systemctl stop rizond && rizond unsafe-reset-all
cd ~/.rizon/data; ls | grep -v 'priv_validator_state.json' | xargs rm -rf

Теперь следуем указанием с одного из сайтов для быстрой синхронизации: 1 https://nodejumper.io/rizon/sync 2 https://ping.pub/rizon/statesync

После того как отредактировали config.toml надо запустить сервис файл:

sudo systemctl enable rizond
sudo systemctl daemon-reload
sudo systemctl restart rizond

# Логи
echo 'Node status:'$(sudo service rizond status | grep active)
journalctl -u rizond -f --no-hostname
curl localhost:26657/status | jq '.result.sync_info'

Если все сделать правильно, все будет ок.

Запустить синхронизацию с первого блока

Тут есть одна сложность. Чтобы начать синхронизацию с первого блока какой либо сети, надо установить версию бинарника, с которой была запущена эта сеть.

На данный момент mainnet сеть titan-1. Для этой сети первым релизом считается v0.2.8.

Значит сначала переустановим Rizon (так как вначале мы установили v0.3.0):

# rizond unsafe-reset-all - если до этого синхронизировались по снепшоту
cd ~
rm -rf /root/rizon
git clone https://github.com/rizon-world/rizon.git
cd rizon
# git fetch - иногда вставляют
git checkout v0.2.8
git pull origin v0.2.8
make install
. $HOME/.bash_profile
rizond version
# v0.2.8


#Вариации:
# если хотите запуститься с путем "ExecStart=/usr/bin/rizond start"
cp /root/go/bin/rizond /usr/bin

# если ранее копировали так , то обновите копии, или просто удалите копии бинарника с одреса /usr/local/bin и адреса /usr/local/sbin
# cp $HOME/go/bin/rizond /usr/local/bin
# cp $HOME/go/bin/rizond /usr/local/sbin

Запустим сервис файл:

sudo systemctl enable rizond
sudo systemctl daemon-reload
sudo systemctl restart rizond

# Логи
echo 'Node status:'$(sudo service rizond status | grep active)
journalctl -u rizond -f --no-hostname

Ждем , когда синхронизация остановится. Это значит, что блокчейн догрузился до того блока, на котором произошло обновление версии блокчейна до следующей (в нашем случае с версии v0.2.8 до v0.3.0). Значит настало время обновить версию:

sudo systemctl stop rizond
cd ~
rm -rf /root/rizon
git clone https://github.com/rizon-world/rizon.git
cd rizon
# git fetch - иногда вставляют
git checkout v0.3.0
git pull origin v0.3.0
make install
. $HOME/.bash_profile
rizond version
# v0.3.0

# надо сделать если в сервис файле прописан путь "ExecStart=/usr/bin/rizond start"
cp /root/go/bin/rizond /usr/bin

Запустим вновь:

sudo systemctl daemon-reload
sudo systemctl restart rizond

# Логи
echo 'Node status:'$(sudo service rizond status | grep active)
journalctl -u rizond -f --no-hostname

Оптимизируем память

sed -i.bak -e "s/^indexer *=.*/indexer = \""null"\"/" $HOME/.rizon/config/config.toml

sed -i.bak -e "s/^pruning *=.*/pruning = \""custom"\"/" $HOME/.rizon/config/app.toml
sed -i.bak -e "s/^pruning-keep-recent *=.*/pruning-keep-recent = \""100"\"/" $HOME/.rizon/config/app.toml
sed -i.bak -e "s/^pruning-keep-every *=.*/pruning-keep-every = \""0"\"/" $HOME/.rizon/config/app.toml
sed -i.bak -e "s/^pruning-interval *=.*/pruning-interval = \""10"\"/" $HOME/.rizon/config/app.toml

# Проверим
sudo nano $HOME/.rizon/config/app.toml
sudo nano $HOME/.rizon/config/config.toml

sudo systemctl restart rizond
sudo rm ~/.rizon/data/tx_index.db/*

journalctl -u rizond -f

Создать аккаунт

https://docs.rizon.world/guide/validator-guide/join-the-rizon-mainnet#create-an-accountdocs.rizon.world

Если вы впервые создаете кошелек, то нужна команда:

rizond keys add $Rizon_wallet

Если надо восстановить кошелек по seed фразе или файлу private key:

# recover from mnemonic
rizond keys add $Rizon_wallet --recover

or

# import from private_key
rizond keys import $Rizon_wallet <private_key_file>

Создать валидатор

https://docs.rizon.world/guide/validator-guide/join-the-rizon-mainnet#create-validatordocs.rizon.world

Проверим статус синхронизации, так как только После полной синхронизации можно приступать к созданию валидатора:

curl localhost:26657/status | jq '.result.sync_info'

Если ответ false, значит нода синхронизирована. Отправим транзакцию:

rizond tx staking create-validator \
--amount="1000000uatolo" \
--pubkey=$(rizond tendermint show-validator) \
--moniker=$Rizon_moniker \
--from=$Rizon_wallet \
--commission-rate="0.03" \
--commission-max-rate="0.10" \
--commission-max-change-rate="0.01" \
--min-self-delegation="1" \
--chain-id=titan-1 \
--identity=<your_identity_code> \
--details="your details" \
--fees="1000uatolo"

Посмотреть, создался ли валидатор можно командой:

rizond q tendermint-validator-set | grep `rizond tendermint show-address`

Полезные команы

Balance

rizond q bank balances <rizon1...your..wallet...>