Running a Full Node
Konstellation Mainnet Full Node Quick Start
With each version of the Konstellation Hub, the chain is restarted from a new genesis state. We are currently on darchub
.
Get Mainnet Configuration files from here.
Hardware requirements
CPU: 8 core
RAM: 32 GB
DISK Storage: SSD 500 GB ~ 2 TB
Build from code
This guideline assumes that you're running Linux or MacOS with Go 1.18+.
This guide helps you to : Build, Install, and Name your Node.
Currently, latest release is v0.6.2
# Clone Konstellation from the latest release found here: https://github.com/konstellation/konstellation/releases
git clone -b v0.6.2 https://github.com/konstellation/konstellation
# Enter the folder Konstellation was cloned into
cd konstellation
# Compile and install Konstellation
make build
# alias binary file
# alias knstld=/your/path/to/repo/build/knstld
# Check konstellation version
knstld version
Initialize data and folders
WARNING : command unsafe-reset-all
will erase your database in node directory if exists, which is $HOME/.knstld
if no customs have been made. If you are already running validator, be sure to back up your priv_validator_key.json
in $HOME/.knstld/config
directory. Though this command won't erase the file, it has to be backed up in somewhere safe.
# Reset current node's data
knstld tendermint unsafe-reset-all --keep-addr-book
Create a key
Add new
build/knstld keys add <key_name>
Or import via mnemonic
build/knstld keys add <key_name> -i
As a result, you got
- name: <key_name>
type: local
address: <key_address>
pubkey: <key_pubkey>
mnemonic: ""
threshold: 0
pubkeys: []
**Important** write this mnemonic phrase in a safe place.
It is the only way to recover your account if you ever forget your password.
<key_mnemonic>
Genesis & Seeds
Download genesis.json
wget -O $HOME/.knstld/config/genesis.json https://raw.githubusercontent.com/Konstellation/konstellation/master/config/genesis.json
Download config.toml with predefined seeds and persistent peers
wget -O $HOME/.knstld/config/config.toml https://raw.githubusercontent.com/Konstellation/konstellation/master/config/config.toml
Alternatively enter persistent peers to config.toml provided here
Open ~/.knstld/config/config.toml with text editor. Alternatively you can use cli editor, like nano
nano ~/.knstld/config/config.toml
Scroll down to persistant peers in
config.toml
, and add the persistant peers as a comma-separated list
Setting Up a New Node
You can edit this moniker, in the ~/.knstld/config/config.toml file:
# A custom human readable name for this node
moniker = "<your_custom_moniker>"
You can edit the ~/.knstld/config/app.toml file in order to enable the anti spam mechanism and reject incoming transactions with less than the minimum gas prices:
# This is a TOML config file.
# For more information, see https://github.com/toml-lang/toml
##### main base config options #####
# The minimum gas prices a validator is willing to accept for processing a
# transaction. A transaction's fees must meet the minimum of any denomination
# specified in this config (e.g. 10udarc).
minimum-gas-prices = ""
Your full node has been initialized!
Run Pruning Node
Download Snapshot of previous blocks data
Install lz4 if not installed
sudo apt update
sudo apt install snapd -y
sudo snap install lz4
Check current height on polkachu and download snapshot // I think its not working right now. WIll test later
# Download snapshot until current-height
wget -O konstellation_6445823.tar.lz4 https://snapshots.polkachu.com/snapshots/konstellation/konstellation_[current-height].tar.lz4 --inet4-only
# Unzip snapshot and move to database directory
lz4 -c -d konstellation_6445823.tar.lz4 | tar -x -C $HOME/.knstld
Run a Full Node
# Start Konstellation
build/knstld start
# to run process in background run
screen -dmSL knstld build/knstld start
# Check your node's status with konstellation cli
build/knstld status
Wait for the konstellation block synchroniztion complete. Since this will take a lot of times and disk spaces, you may want to download snapshots.
Block 1826999
At block 1826999 chain will halt, this is the upgrade requirement block. You will get an error
INF committed state app_hash=76B4066182CB3D3E984E09CB5226FD9734F0DFB91EA25AC4CFAC326D26E8D346 height=1826999 module=state num_txs=0
ERR UPGRADE "v0.44" NEEDED at height: 1827000:
INF indexed block height=1826999 module=txindex
UPGRADE "v0.44" NEEDED at height: 1827000:
This indicates the next steps are ready and you must upgrade the chain.
Change git release branch v0.5.0
git checkout v0.5.0
Compile and install Konstellation
make build
Check konstellation version
build/knstld version
Should return 0.5.0
Start Konstellation
build/knstld start
Again to run process in background run
screen -dmSL knstld build/knstld start
Block 6179999
At block 6179999 chain will halt, reason same as above.
Change git release branch v0.6.0
git checkout v0.6.0
Compile and install Konstellation
make build
Check konstellation version
build/knstld version
Should return 0.6.0
Start Konstellation
build/knstld start
Again to run process in background run
screen -dmSL knstld build/knstld start
Block 6564999
At block 6564999 chain will halt, reason same as above.
Change git release branch v0.6.2
git checkout v0.6.2
Compile and install Konstellation
make build
Check konstellation version
build/knstld version
Should return 0.6.2
Start Konstellation
build/knstld start
Again to run process in background run
screen -dmSL knstld build/knstld start
Last updated