Setup a node (mainnet / public testnet)

Search…
Welcome
Thank you for your interest in joining our validator community! Your participation is important to the security of LikeCoin chain.
This guide covers steps to host a validator node with Cosmovisor via Linux Systemd or Docker Compose.
We recommend all operators to adopt the Systemd method. The Docker Compose method is deprecated and will not be maintained in the future.
To Existing Operators
Why the change?
Since the v1.2.0 release, LikeCoin chain binary supports Cosmovisor, a process manager that manages chain binaries and monitors for upgrade proposals.
Cosmovisor allows future chain upgrades to utilize upgrade proposals and in-place store migrations, which vastly reduces the coordination effort and chain downtime required compared to the past manual upgrades.
Under this new workflow, once an upgrade proposal is approved by the community and the chain reaches the defined upgrade block height, validators will automatically swap to the new binary version and run state migration scripts. Operators will only be required to place the next binary into the upgrades folder of cosmovisor before upgrade time.
Optionally, operators can opt into using the auto-download feature, which automatically downloads the new binary from url defined in the upgrade proposal before upgrade.
For usage and folder layout of Cosmovisor, please refer to Cosmovisor quick start guide​
Before we continue
Existing operators migrating their node should ensure that there is only one instance running concurrently at all times to avoid double signing.
Be aware of blocks like this for migration specific notes
System Requirements
Hardware
Recommended
4 CPU Cores
2GB RAM
500GB+ SSD
Minimum
2 CPU Cores
2GB RAM
250GB+ SSD
Current snapshot size is 120GB with 70GB growth each year.
We expect the growth rate to increase after our NFT module and new dApps are rolled out.
OS
Ubuntu 20.04 LTS
YMMV on other Linux distros
Debian-based ones will likely work fine with this guide
Using non-Linux host is not recommended
The Docker Compose method works on other OS, but it will be discontinued in the future.
Network Ports
Required
TCP 26656 for P2P
Optional, if you use the node as RPC endpoint
TCP 9090 for gRPC
TCP 1317 for REST
TCP 26657 for Tendermint RPC
Outline
Below are major steps to create a validator node:
1.Secure the host
2.Initialize the node
3.Synchronize the node to the latest block
4.Create operator account
5.Create validator
Secure the host
Refer to Node Security page.
Systemd Route (Recommended)
We will run a setup script to download the latest binary release, write config files and start up the service.
Again, this method is supported on Linux only. We prepared this guide with Ubuntu 20.04 LTS. YMMV on other distros.
When you see <Placeholder> in code blocks below, please replace them with correct values.
Obtain dependencies
We will first clone the likecoin-chain repo to obtain required scripts
For validator migration, we recommend cloning a new copy to avoid confusion, since the previous guide stored data within the repo folder.
If your existing repo folder is already at ~, appending the clone command with a new folder name, and adopt this guide by changing the cd ~/likecoin-chain commands.
1
cd ~
2
git clone https://github.com/likecoin/likecoin-chain.git --branch release/v2.x --single-branch
Copied!
Then, install required tools:
1
sudo apt update
2
sudo apt install make
Copied!
Run the setup-node script
This script will download cosmovisor, chain binary, and the genesis file. Then, it will run liked init and prepare a systemd service file.
By default, binaries will be downloaded to the user's home directory ~/, and the liked data directory will be ~/.liked
For advanced configuration, such as changing folder locations or specifying binary versions, refer to the developer facing guide​
If you are migrating an existing node on the same host, please ensure that your existing .liked folder is not at your home directory, otherwise this might overwrite your files!
For latest genesis url and seed node, we host the latest info on Github: Mainnet. Following is the command for running the setup-node script for mainnet. Please confirm the LIKED_VERSION to be used in the above Mainnet Github repository.
1
export MONIKER='<My Validator>'
2
export GENESIS_URL='https://raw.githubusercontent.com/likecoin/mainnet/master/genesis.json'
3
export LIKED_SEED_NODES='[email protected]:26656,[email protected]:26656'
4
export LIKED_VERSION='2.0.2'
5
cd ~/likecoin-chain
6
make -C deploy setup-node
Copied!
Testnet Info of can find here: Public Testnet, current active testnet is likecoin-public-testnet-5. Following is the command for running the setup-node script for testnet. Please confirm the latest testnet and parameters to be used in the testnet Github repository.
1
export MONIKER='<My Validator>'
2
export GENESIS_URL='https://raw.githubusercontent.com/likecoin/testnets/master/likecoin-public-testnet-5/genesis.json'
3
export LIKED_SEED_NODES='[email protected]:26656,[email protected]:26656'
4
export LIKED_VERSION='2.0.2'
5
cd ~/likecoin-chain
6
make -C deploy setup-node
Copied!
If you decided not to using state sync as describe below, you may need to change the LIKED_VERSION=1.2.0. 1.2.0 is the version we start adpoting cosmovisor, it should upgrade itself to newer version during sync.
Import existing validator files
For existing validators hosted with the Docker Compose guide only. New operators should skip this section.
Steps below generally applies to custom setups but paths to your old .liked folder and the command to stop the node will be different.
First, rename the .liked folder generated by the script as .liked.template:
1
mv ~/.liked ~/.liked.template
Copied!
Then, stop your existing node:
1
cd /path/to/old/repo/likecoin-chain
2
docker-compose down
Copied!
Move the old .liked folder to ~/.liked:
1
cd /path/to/old/repo/likecoin-chain
2
mv ./.liked ~/.liked
Copied!
Add the new cosmovisor sub-folder created by the script to ~/.liked:
1
cp -r ~/.liked.template/cosmovisor ~/.liked/cosmovisor
Copied!
Check that there are 4 folders within ~/.liked:
1
config
2
cosmovisor
3
data
4
keyring-file
Copied!
For some setups, the keyring files may be on the root of .liked directly instead of inside keyring-file folder, please move the following files to ~/.liked/keyring-file folder so the liked flag --keyring-backend=file works:
1
<hash>.address
2
keyhash
3
<account name>.info
Copied!
State Sync
Skip this section for migrating operators
Syncing a node from genesis often requires hours if not days. To save time, we can start the new node from a known block.
Firstly, obtain two trusted rpc endpoints. These info can often be found on the same repos hosting genesis files. We have included the addresses of mainnet public nodes below.
Then, we will need to obtain the latest block height and hash from one of the rpc endpoints:
1
curl -s https://fotan-node-1.like.co:443/rpc/block
Copied!
For testnet, it should be curl -s https://likecoin-public-testnet-5.oursky.dev/rpc/block
The height is result.block.header.height, while the hash is result.block_id.hash
Next, we will edit ~/.liked/config/config.toml. Locate the [statesync] section and update it to the following values:
1
[statesync]
2
enable = true
3
rpc_servers = "https://fotan-node-1.like.co:443/rpc/,https://fotan-node-2.like.co:443/rpc/"
4
trust_height = <known height>
5
trust_hash = "<known hash>"
6
trust_period = "168h0m0s"
7
discovery_time = "15s"
8
temp_dir = ""
9
chunk_request_timeout = "60s"
10
chunk_fetchers = "4"
Copied!
Userpc_servers = "https://likecoin-public-testnet-5.oursky.dev:443/rpc/,https://likecoin-public-testnet-5-node2.oursky.dev:443/rpc/" if you are setting up testnet.
Then, the node will use state sync to synchronize with the network instead of replaying from genesis at launch.
If you have already started the service once, i.e. there is an ongoing sync, you will have to reset the state back to genesis, otherwise state sync will not start:
1
~/liked tendermint unsafe-reset-all
Copied!
Change node configuration
You are recommended to review ~/.liked/config/config.toml and ~/.liked/config/app.toml, then change the defaults as desired.
In particular, please set a minimum gas price for your node and enable state sync in app.toml:
1
minimum-gas-prices = "1.0nanolike"
2
snapshot-interval = 1000
Copied!
The unit for testnet is nanoekil
This avoids spams on the network and help new nodes sync to the latest state quickly.
For more details, please refer to Node Configuration docs.
Activate the service
Now we will call the setup script again to activate the systemd config and start the node.
The service is configured to start the node via Cosmovisor. It will auto-start whenever the machine is booted.
The service file will be placed at /etc/systemd/system/liked.service.
For migrating validators, please ensure the old instance is turned off before you proceed!
1
cd ~/likecoin-chain
2
make -C deploy initialize-systemctl
3
make -C deploy start-node
Copied!
New nodes will now synchronize with the network. We can continue below steps to create a validator afterwards.
You can check the sync status by:
1
curl -s localhost:26657/status
Copied!
The synced height is result.sync_info.latest_block_height, while result.sync_info.catching_up reflects if the node has finished sync up.
For migrating validators, this is the final step. The validator node should resume operation immediately.
View status and logs
Check the status of the service by:
1
sudo systemctl status liked
Copied!
Follow logs by journalctl:
1
journalctl -u liked.service -f
Copied!
Managing the service
The service can be managed via systemctl:
1
sudo systemctl stop liked
2
sudo systemctl start liked
Copied!
Create operator account
We will generate a new operator account. The key will be stored in password-protected files in ~/.liked/keyring-file. This account is required to manage the validator and cast votes on proposals.
1
export KEY_NAME='my-validator'
2
~/liked keys add $KEY_NAME --keyring-backend file
Copied!
The mnemonic phrase will then be displayed. Write this phrase down physically and keep it in secure storage. Do not type the phrase on a computer.
To display the operator key address:
1
~/liked keys show $KEY_NAME --keyring-backend file --bech val
Copied!
Becoming a validator node
Please ensure your account owns more than the initial self-delegate amount.
Note that commission-max-rate and commission-max-change-rate cannot be changed afterwards.
Below values are examples and can be customized.
1
~/liked tx staking create-validator \
2
--amount=500000000000nanolike \
3
--pubkey=$(~/liked tendermint show-validator) \
4
--moniker=$MONIKER \
5
--commission-rate="0.10" \
6
--commission-max-rate="0.50" \
7
--commission-max-change-rate="0.05" \
8
--min-self-delegation="500000000000" \
9
--chain-id="likecoin-mainnet-2" \
10
--from=$KEY_NAME \
11
--keyring-backend=file \
12
--gas-prices 10nanolike
Copied!
You can obtain the validator address by:
1
~/liked tendermint show-address
Copied!
At this stage, you should back up ~/.liked/config and ~/.liked/keyring-file which contains your node key, consensus key and operator key. For security, please consider encrypting your backup with tools like GPG before transferring off the host.
Confirm the validator is running
1
~/liked query tendermint-validator-set | grep "$(~/liked tendermint show-address)"
Copied!
You can also check via chain explorers: dao.like.co, Big Dipper​
Common operations for validator
Edit Validator
You may edit validator details anytime:
1
~/liked tx staking edit-validator \
2
--moniker="New Name" \
3
--website="https://example.com" \
4
--details="Description of my validator" \
5
--commission-rate="0.05" \
6
--chain-id="likecoin-mainnet-2" \
7
--from=$KEY_NAME \
8
--keyring-backend=file \
9
--gas-prices 10nanolike
Copied!
Vote
An important job of being an operator is to participate in DAO governance. To vote on a proposal:
1
~/liked tx gov vote 123 yes \
2
--chain-id='likecoin-mainnet-2' \
3
--from=$KEY_NAME \
4
--keyring-backend=file
Copied!
where 123 is the proposal number and yes is the vote
Unjail
A validator may be jailed after some downtime. To resume receiving rewards, submit an unjail transaction:
1
~/liked tx slashing unjail \
2
--chain-id='likecoin-mainnet-2' \
3
--from=$KEY_NAME \
4
--keyring-backend=file
Copied!
Docker Compose Route (Deprecated)
This route is transitional for existing operators who followed our old setup guide to quickly adopt cosmovisor in time for the next chain upgrade.
In newer docker image releases, cosmovisor is bundled in the image. When an upgrade is announced and approved, operators should prepare and place the next version liked binary within .liked/cosmovisor/upgrades folder before the upgrade time. Please refer to related chain upgrade guides for exact steps.
Adopt Cosmovisor for existing validators on Docker
First, shut down the existing stack:
1
cd /path/to/cloned/repo/likecoin-chain
2
docker-compose down
Copied!
Check out the new release tag to obtain the new version of docker-compose template:
1
git fetch --tags
2
git checkout release/v1.x
Copied!
Back up the existing docker-compose.yml and replace it with the new version:
1
mv docker-compose.yml docker-compose.yml.bak
2
cp docker-compose.yml.template docker-compose.yml
Copied!
Edit .env to target new docker image tag:
1
LIKECOIN_DOCKER_IMAGE="likecoin/likecoin-chain:v1.2.0"
Copied!
Create cosmovisor folders structure:
1
mkdir .liked/cosmovisor
2
mkdir .liked/cosmovisor/upgrades
Copied!
We can now start the stack again:
1
docker-compose up -d
Copied!
Create a new validator
Please note that we will stop maintaining this method soon.
If you insist to setup a new validator this way, you may refer to the old docker setup guide.