How to Join the Kira Testnet - Node Setup Guide

1. Установка зависимостей

sudo apt update && sudo apt -y upgrade
sudo apt install -y network-manager
sudo apt update
sudo apt install -y apt-transport-https 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=amd64 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 update
sudo apt install -y docker-ce docker-ce-cli containerd.io

2. Создание sudoer пользователя

sudo useradd kira -m -s /bin/bash
sudo passwd kira
sudo usermod -aG sudo kira

Вся дальнейшая установка должна производиться sudoer пользователем. Не использовать root.

3. Установка ноды Kira

sudo su - kira
sudo -s

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

cd /tmp && read -p "Input branch name: " BRANCH && \
 wget https://raw.githubusercontent.com/KiraCore/kira/$BRANCH/workstation/init.sh -O ./i.sh && \
 chmod 555 -v ./i.sh && H=$(sha256sum ./i.sh | awk '{ print $1 }') && read -p "Is '$H' a [V]alid SHA256 ?: "$'\n' -n 1 V && \
 [ "${V,,}" != "v" ] && echo "INFO: Setup was cancelled by the user." || ./i.sh "$BRANCH"

Отвечаем на вопросы скрипта:

Input branch name: testnet-9
Is ‘9df6d282c0f7c85f36a0e95bf89b223c5be7fded44acf551206f1c2db475ebaa’ a [V]alid SHA256: Проверить хэш и нажать V

Внимательно прочитайте сообщение выше. Вкратце, в нём говорится о том, что скрипт может всё сломать и удалить, поэтому не запускайте его на своём основном компьютере. Если вы согласны, нажмите любую клавишу. В противном случае нажмите Ctrl+C

Kira-1

Нажмите 1

Kira-2

Введите свои старые мнемоники для validator account’а и validator signing key (если они у вас есть) или нажмите Enter для генерации новых.

Create [N]ew network or [J]oin existing one: Нажмите J

Kira-2 Kira-3

Нажмите S

Input address (IP/DNS) of the public node you trust: введите любой айпи из списка

Select E

Нажмите Enter

Kira-6

Нажмите A

Choose to [A]utomatically discover external seeds or [M]anually configure public and private connections: Нажмите A

Система автоматически перезагрузится.

После перезагрузки запустите kira manager командой

kira

Choose to [V]iew setup progress, [R]initalize new node, [D]ump logs or force open [K]IRA Manager: Выберите V

Нажмите Ctrl+C

3. Запуск Kira Manager

kira

Kira-8

4. Отправка формы

На картинке выше вы видите, что валидатор не активирован. Для активации необходимо заполнить форму здесь: https://forms.gle/3UPeksBrp9yDMNSA8

Для заполнения формы вам понадобится адрес валидатора. Его можно увидеть, если выбрать пункт Manage Validator в Kira Manager

Kira-9

5. Регистрация валидатора

После отправки формы вы получите on-chain разрешение стать валидатором. Это можно увидеть по статусу вашей ноды – он станет WAITING.

Входим в контейнер

sudo docker exec -it validator bash

Указываем желаемое значение имени ноды (moniker) и выполняем команду ниже. Внимание: вы не сможете изменить данные после отправки команды. Поэтому проверьте введённые данные очень внимательно.

sekaid tx customstaking claim-validator-seat --from validator \
  --keyring-backend=test --home=$SEKAID_HOME \
  --moniker="Public-Name-Of-Your-Node" \
  --chain-id=$NETWORK_NAME --fees=100ukex \
  --broadcast-mode=async --yes | txAwait

Выходим из контейнера

exit

Проверяем статус ноды в Kira Manager – он должен быть Active

Kira-11

6. Обновление Kira Manger

Чтобы установить обновление запустите Kira Manager и нажмите M чтобы войти в Maintenance Mode. Проверьте что статус ноды стал PAUSED.

Теперь нажмите I. Ответьте на вопросы скрипта.

После того, как установка обновления завершена, нажмите M для выхода из Maintenance mode

Проверьте ваш Kira Manager:

версия должна быть v0.2.1
статус – Active

7. Inactive Validator Node

Может так произойти, что ваш валидатор прекратил производить блоки из-за программных или хардварных проблем. Тогда его статус станет Inactive. Чтобы это исправить, выполните:

sudo docker exec -it validator bash

out="" && tx=$(sekaid tx customslashing activate --from validator --keyring-backend=test --home=$SEKAID_HOME --chain-id=$NETWORK_NAME --fees=1000ukex --broadcast-mode=async --yes --log_format=json | jq -rc '.txhash') && \
while [ -z "$out" ] ; do echo "Waiting for '$tx' to be included in the block..." && sleep 5 && \
out=$(sekaid query tx $tx --output=json 2> /dev/null | jq -rc '.' || echo "") ; done && \
echo $out | jq

exit

Запустите Kira Manager и проверьте, что статус стал Active

8. Полезные ссылки

Кран: https://testnet-rpc.kira.network/api/faucet?claim=<Ваш_kira_адрес>&token=ukex

Проверка баланса:

Войдите в контейнер валидатора. Это можно сделать двумя способами:

sudo docker exec -it validator bash

Или запустить Kira Manager, нажать 4 [Manage Validator], затем нажать I

Теперь можно выполнить команду проверки баланса:

sekaid query bank balances <address>

И выйти из контейнера командой

exit

Сохранение ключей: Чтобы посмотреть свои приватные ключи выполните

cat $HOME/.secrets/mnemonics.env

сохраните содержимое в безопасном месте.

Восстановление ключей:

Выполните перед запуском скрипта установки

sudo su - kira
mkdir -p $HOME/.secrets && nano $HOME/.secrets/mnemonics.env

затем вставьте сохранённые ключи и нажмите кмбинацию клавиш Ctrl+o, [ENTER], Ctrl+x чтобы сохранить изменения.