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.
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
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
Note that system requirements, especially memory, may increase drastically when performing chain upgrade or state sync.
- Recommended
- 2 CPU Cores
- 16GB RAM
- 500GB+ SSD
- Minimum
- 2 CPU Cores
- 4GB 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.
- 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.
- 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
Below are major steps to create a validator node:
- Secure the host
- Initialize the node
- Synchronize the node to the latest block
- Create operator account
- Create validator
Refer to Node Security page.
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.
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 thecd ~/likecoin-chaincommands.
cd ~
git clone https://github.com/likecoin/likecoin-chain.git --branch release/v3.x --single-branchThen, install required tools:
sudo apt update
sudo apt install makeThis 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
.likedfolder 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.
export MONIKER='<My Validator>'
export GENESIS_URL='https://raw.githubusercontent.com/likecoin/mainnet/master/genesis.json'
export LIKED_SEED_NODES='[email protected]:26656,[email protected]:26656'
export LIKED_VERSION='4.2.0'
cd ~/likecoin-chain
make -C deploy setup-nodeTestnet 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.
export MONIKER='<My Validator>'
export GENESIS_URL='https://raw.githubusercontent.com/likecoin/testnets/master/likecoin-public-testnet-5/genesis.json'
export LIKED_SEED_NODES='[email protected]:26656,[email protected]:26656'
export LIKED_VERSION='4.2.0'
cd ~/likecoin-chain
make -C deploy setup-nodeIf you decided not to using state sync as describe below, you may need to change the LIKED_VERSION=4.2.0. 4.2.0 is the version we start adpoting cosmovisor, it should upgrade itself to newer version during sync. There is still some manual upgrade need due to patch or bugs, please refer to syncing-from-genesis.md.
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
.likedfolder and the command to stop the node will be different.
First, rename the .liked folder generated by the script as .liked.template:
mv ~/.liked ~/.liked.templateThen, stop your existing node:
cd /path/to/old/repo/likecoin-chain
docker-compose downMove the old .liked folder to ~/.liked:
cd /path/to/old/repo/likecoin-chain
mv ./.liked ~/.likedAdd the new cosmovisor sub-folder created by the script to ~/.liked:
cp -r ~/.liked.template/cosmovisor ~/.liked/cosmovisorCheck that there are 4 folders within ~/.liked:
config
cosmovisor
data
keyring-fileFor 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:
<hash>.address
keyhash
<account name>.infoSkip 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.
Note that state sync requires at least 16GB (32GB recommended) of memory to complete successfully. After state sync is done, you can lower the amount of memory for daily operations.
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:
curl -s https://fotan-node-1.like.co:443/rpc/block{% hint style="info" %}
For testnet, it should be curl -s https://node.testnet.like.co/rpc/block
{% endhint %}
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:
[statesync]
enable = true
rpc_servers = "https://fotan-node-1.like.co:443/rpc/,https://fotan-node-2.like.co:443/rpc/"
trust_height = <known height>
trust_hash = "<known hash>"
trust_period = "168h0m0s"
discovery_time = "15s"
temp_dir = ""
chunk_request_timeout = "60s"
chunk_fetchers = "4"{% hint style="info" %}
Userpc_servers = "https://node.testnet.like.co:443/rpc/,https://node.testnet.like.co:443/rpc/" if you are setting up testnet.
{% endhint %}
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:
~/liked tendermint unsafe-reset-allYou 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:
minimum-gas-prices = "10000.0nanolike"
snapshot-interval = 1000{% hint style="info" %}
The unit for testnet is nanoekil
{% endhint %}
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.
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!
cd ~/likecoin-chain
make -C deploy initialize-systemctl
make -C deploy start-nodeNew nodes will now synchronize with the network. We can continue below steps to create a validator afterwards.
You can check the sync status by:
curl -s localhost:26657/statusThe 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.
Check the status of the service by:
sudo systemctl status likedFollow logs by journalctl:
journalctl -u liked.service -fThe service can be managed via systemctl:
sudo systemctl stop liked
sudo systemctl start likedWe 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.
export KEY_NAME='my-validator'
~/liked keys add $KEY_NAME --keyring-backend fileThe 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:
~/liked keys show $KEY_NAME --keyring-backend file --bech valPlease 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.
~/liked tx staking create-validator \
--amount=500000000000nanolike \
--pubkey=$(~/liked tendermint show-validator) \
--moniker=$MONIKER \
--commission-rate="0.10" \
--commission-max-rate="0.50" \
--commission-max-change-rate="0.05" \
--min-self-delegation="500000000000" \
--chain-id="likecoin-mainnet-2" \
--from=$KEY_NAME \
--keyring-backend=file \
--gas-prices 10000nanolikeYou can obtain the validator address by:
~/liked tendermint show-addressAt 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.
~/liked query tendermint-validator-set | grep "$(~/liked tendermint show-address)"You can also check via chain explorers: dao.like.co, Mintscan
You may edit validator details anytime:
~/liked tx staking edit-validator \
--moniker="New Name" \
--website="https://example.com" \
--details="Description of my validator" \
--commission-rate="0.05" \
--chain-id="likecoin-mainnet-2" \
--from=$KEY_NAME \
--keyring-backend=file \
--gas-prices 10000nanolikeAn important job of being an operator is to participate in DAO governance. To vote on a proposal:
~/liked tx gov vote 123 yes \
--chain-id='likecoin-mainnet-2' \
--from=$KEY_NAME \
--keyring-backend=filewhere 123 is the proposal number and yes is the vote
A validator may be jailed after some downtime. To resume receiving rewards, submit an unjail transaction:
~/liked tx slashing unjail \
--chain-id='likecoin-mainnet-2' \
--from=$KEY_NAME \
--keyring-backend=fileThis 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.
First, shut down the existing stack:
cd /path/to/cloned/repo/likecoin-chain
docker-compose downCheck out the new release tag to obtain the new version of docker-compose template:
git fetch --tags
git checkout release/v3.xBack up the existing docker-compose.yml and replace it with the new version:
mv docker-compose.yml docker-compose.yml.bak
cp docker-compose.yml.template docker-compose.ymlEdit .env to target new docker image tag:
LIKECOIN_DOCKER_IMAGE="likecoin/likecoin-chain:v4.2.0"Create cosmovisor folders structure:
mkdir .liked/cosmovisor
mkdir .liked/cosmovisor/upgradesWe can now start the stack again:
docker-compose up -d