1. Install dependencies

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 -y install docker-ce docker-ce-cli containerd.io

2. Create sudoer user

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

All further installation should be performed under sudoer user. Not root.

3. Install Kira Node

sudo su - kira
sudo -s

Start installation script

 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"

Answer the questions:

• Input branch name: testnet-9
• Is ‘9df6d282c0f7c85f36a0e95bf89b223c5be7fded44acf551206f1c2db475ebaa’ a [V]alid SHA256: Check hash and Press V

Check the message above very carefully. If you are agree, press any key. Otherwise, press Ctrl+C

Press 1

Paste your old passphrases for validator account and validator signing key (if you have) or press Enter to generate a new passphrases.

Create [N]ew network or [J]oin existing one: Press J

Press S

Input address (IP/DNS) of the public node you trust: insert one of the ip address from the link

Select E

Press Enter

Press A

Choose to [A]utomatically discover external seeds or [M]anually configure public and private connections: Press A

System will be rebooted. After reboot start kira manager:

kira

Choose to [V]iew setup progress, [R]initalize new node, [D]ump logs or force open [K]IRA Manager: Press V

Press Ctrl+C

3. Start Kira Manager

kira

 

4. Sending form

At the picture above you can see that your validator is not active. To activate it you have to fill out a validator form here: https://forms.gle/3UPeksBrp9yDMNSA8

You have to put your Validator Address into the form. To find it select Manage Validator in Kira Manager

5. Validator registration

After submitting request form to join Public Testnet you will receive an on-chain permission to become a validator. You can see that your node status is WAITING.

Enter to validator container:

sudo docker exec -it validator bash

Put desired name of your node (moniker) and execute the following. Note: you will not be able to change any data after submitting. So check it very carefully.

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 from container

exit

Check your node status in Kira manager. It should be Active

6. Kira Manger upgrade

To perform update start Kira Manager, press M to enter to Maintenance Mode. Check that your node status is PAUSED.

Now Press I. Answer to script questions.

Once installation is finished press M to exit from Maintenance mode

Check your manager:

• version should be v0.2.1
• status – Active

7. Unjailing Stopped Validator Nodes

It might happen that your running validator stops producing blocks due to hardware or software malfunction. You can see that node status is Inactive. To fix it execute the following:

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

Start Kira Manager and check that status is active

8. Useful

Faucet: https://testnet-rpc.kira.network/api/faucet?claim=<your_kira_address_here>&token=ukex

Balance check:

Enter to Validator container. You have 2 options:

sudo docker exec -it validator bash

Or start Kira Manager, press 4 [Manage Validator] then press I

Now you can execute command to check your balance:

sekaid query bank balances <address>

And exit from container using

exit

Keys Backup: To persist your private keys type

cat $HOME/.secrets/mnemonics.env

and save the content so that you can recover your accounts easily.

Keys Recovery:

Execute the commands below before starting of installation script.

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

then paste your saved secrets and press a combination of Ctrl+o, [ENTER], Ctrl+x to save changes.