cerc-io/laconicd
18
0
Fork 2
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases 10 Wiki Activity
6b04c0ee5e
laconicd/testnet/genesis-validators.md
Ivan Zubok ca8c83999c Updated documentation for laconic_81337-5 
Documented running in Docker
2022-11-07 20:40:02 +00:00

7.6 KiB
Raw Blame History

Validator Guide for laconic_81337-5 Testnet

Hardware Prerequisites

Supported

  • Operating System (OS): Ubuntu 20.04
  • CPU: 2 core
  • RAM: 8GB
  • Storage: 25GB SSD

Recommended

  • Operating System (OS): Ubuntu 20.04
  • CPU: 2 core
  • RAM: 8GB
  • Storage: 50GB SSD

Network Prerequisites

  • TCP 26656 for Peer-to-Peer Network Communication
  • TCP 26660 for Prometheus Metrics (doesn't have to be exposed publicly)

Blockchain client Setup

There are two options of running a laconicd

  1. As a systemd service
  2. In a docker container

Systemd service

Skip this section if you use docker

Install required software packages

# Update Ubuntu
sudo apt update
sudo apt upgrade -y

# Install required software packages
sudo apt install git curl build-essential make jq -y

Install Go

# Remove any existing installation of `go`
sudo rm -rf /usr/local/go

# Install Go version 1.17.2
curl https://dl.google.com/go/go1.17.2.linux-amd64.tar.gz | sudo tar -C/usr/local -zxvf -

# Update env variables to include go
cat <<'EOF' >>$HOME/.profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF

source $HOME/.profile

Check the version of go installed

go version

# Should return something like: go version go1.17.2 linux/amd64

Install laconic

git clone https://github.com/cerc-io/laconicd.git
cd laconicd

# Checkout main branch
git fetch --all
git checkout v0.6.0

# Build and install laconic
make install

Verify your installation

laconicd version --long

On running the above command, you should see a similar response like this. Make sure that the version and commit hash are accurate

name: laconic
server_name: laconicd

Docker container

There are different commands to initialize a validator and to run a validator node. See "Docker" section in corresponding chapters. It is important to mount a host directory (~/.laconicd in this documentation) to /root/.laconicd directory inside the container, so all blockchain data, configuration and keys persist between container restarts. For running a validator node it is also required to publish container's port 26656 and (optionally) 26660 to the host.

Initialize Validator Node

Not required if you have already initialized before

Make sure the directory ~/.laconicd does not exist or is empty

Docker
In order to run the below commands in a docker container:

docker run -ti -v ~/.laconicd:/root/.laconicd \
git.vdb.to/cerc-io/laconicd/laconicd:v0.6.0 /bin/sh

# Initialize the validator node
laconicd init <your-node-moniker> --chain-id laconic_81337-5

Running the above commands will initialize the validator node with default configuration. The config files will be saved in the default location (~/.laconicd/config).

NOTE: Backup your node and validator keys. You will need to use these keys at a later point in time.

Create Account keys

If you have participated in a previous testnet and have a mnemonic phrase, use below command to recover your account:

laconicd keys add <key-name> --recover

To create a new account use:

laconicd keys add <key-name>

NOTE: Save the mnemonic and related account details (public key). You will need to use the mnemonic and / or private key to recover accounts at a later point in time.

Add Genesis Account

NOTE: Don't add more than 12,900 CHK , if you add more than that, your gentx will be ignored.

laconicd add-genesis-account <key-name> 12900000000000000000000achk --keyring-backend os

Create Your gentx transaction file

laconicd gentx <key-name> 12900000000000000000000achk \
  --pubkey=$(laconicd tendermint show-validator) \
  --chain-id="laconic_81337-5" \
  --moniker="<your-moniker-name>" \
  --website="<your-validator-website>" \
  --details="<your-validator-description>" \
  --identity="<your-keybase-public-key>" \
  --ip="<your-node-public-ip-address>" \
  --commission-rate="0.10" \
  --commission-max-rate="0.20" \
  --commission-max-change-rate="0.01" \
  --min-self-delegation="1"

NOTE:

  • <key-name> and chain-id are required. other flags are optional
  • Don't change the amount value while creating your gentx
  • Genesis transaction file will be saved in ~/.laconicd/config/gentx folder

Submit Your gentx

Submit your gentx file to the https://github.com/cerc-io/laconic-testnet repository in the following format: <validator-moniker>-gentx.json

NOTE: (Do NOT use spaces in the file name)

To submit the gentx file, follow the below process:

The genesis file will be published in the laconic_81337-5/config/ folder within the https://github.com/cerc-io/laconic-testnet repository.

CONTINUE WITH BELOW STEPS ONLY AFTER GENESIS FILE HAS BEEN PUBLISHED

Adjust validator node configuration

# Set seed & peers variable
seeds="<seeds node list here>"
peers="<peers node list here>"
external_address="<node public IP address>"
moniker="<your moniker>"

# Update seeds, persistent_peers and prometheus parameters in config.toml
sed -i.bak -e "s/^seeds *=.*/seeds = \"$seeds\"/; s/^persistent_peers *=.*/persistent_peers = \"$peers\"/; s/^prometheus *=.*/prometheus = true/; s/^moniker *=.*/moniker = \"$moniker\"/; s/^external_address *=.*/external_address = \"tcp:\/\/$external_address:26656\"/" $HOME/.laconicd/config/config.toml

Create systemd validator service (skip for Docker)

sudo tee /etc/systemd/system/laconicd.service > /dev/null <<EOF
[Unit]
Description=laconicd Daemon
After=network-online.target

[Service]
User=$USER
ExecStart=$(which laconicd) start --mode validator --gql-playground --gql-server --log_level=warn
Restart=always
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

#Reload systemd and start the validator node
sudo systemctl daemon-reload
sudo systemctl enable laconicd
sudo systemctl start laconicd

Check status of service

sudo systemctl status laconicd

Helpful Commands for systemd service

# Check logs
journalctl -u laconicd

# Most recent logs
journalctl -xeu laconicd

# Logs from previous day
journalctl --since "1 day ago" -u laconicd

# Check logs with follow flag
journalctl -f -u laconicd

Run validator node in Docker container

Create docker container

In this example the Tendermint RPC and Prometheus metrics ports are exposed only to localhost. You may want to change 127.0.0.1 to private or public network interface of your host if you need to access these ports remotely.

docker create --name laconic-testnet-5 -v ~/.laconicd:/root/.laconicd -p 26656:26656 -p 127.0.0.1:26657:26657 -p 127.0.0.1:26660:26660 git.vdb.to/cerc-io/laconicd/laconicd:v0.6.0 laconicd start --gql-playground --gql-server --log_level=warn

Run validator node

docker start laconic-testnet-5

Check validator node logs

docker logs laconic-testnet-5

Run shell inside docker container

docker exec -ti laconic-testnet-5 /bin/sh

Helpful commands

# Check discovered peers
curl http://localhost:26657/net_info

# Check network consensus state
curl http://localhost:26657/consensus_state

# Check the sync status of your validator node (for docker need to run shell inside the container fist)
laconicd status | jq .SyncInfo