search
Ctrlk

Running KardiaChain node

KardiaChain Official User Guide for Setting Up Mainnet Node

hashtag
System requirement:

Recommending using Cloud compute service with the following requirements.

hashtag
Hardware requirement:

CPU: Intel or AMD with 4+ Cores, Recommended 8+ Cores

RAM: 8GB, Recommended 16GB

Hard Drive: require 2.5 TB of SSD, Recommended 3 TB of SSD

Notes: For the first year, the Validator node will run as a full node (written full data to blockchain) and take up to 320GB of storage. It will ensure maintaining all the data between all validators. Starting from year two and forward, it will run as a light node which removes all the stealth data/blocks and maintains recent 100 blocks. The estimated storage will be 36GB.

hashtag
OS Requirements:

Operating system: CentOS or Ubuntu (manual compiling and build) or with Docker Compose installed.

Linux OS: https://docs.docker.com/engine/installation/arrow-up-right

hashtag
Internet Requirement:

Bandwidth: 1GBps

hashtag
Firewall:

Port open: TCP/UDP 3000 (internet exposure), TCP 8545 (for JSON RPC).

hashtag
Preparing Environment:

When the system or cloud instance is ready, proceeding with the following steps for preparing the environment.

hashtag
Installing go-kardia

hashtag
From Source

You'll need go installedarrow-up-right and the required environment variables set, which can be done with the following commands:

hashtag
Get Source Code

hashtag
Direct Installation

hashtag
Prerequisites

Install libzmqarrow-up-right

hashtag
Compiling and Installing

Notes: the latest cmd command is now installed.

hashtag
Docker Installation

hashtag
Prerequisites

Installing Docker from the following Linux OS installation guide: CentOSarrow-up-right, Ubuntuarrow-up-right

Installing Docker composearrow-up-right

hashtag
Validator Registration:

If you don't know what is a validator, refer to this section. If you don't want to become a validator, please skip this section and jump to Join Mainnet

hashtag
Creating Wallet:

Go to https://explorer.kardiachain.io/access-walletarrow-up-right and create a new Wallet with Private Key (carefully backup or store it to somewhere safe)

hashtag
Requirement:

For Registration: 25000 KAI

For becoming Validator: node with at least 5M KAI

Notes: the top most 30 Validators voting power will get each block rewards for securing the network.

hashtag
Registration:

Go to https://staking.kardiachain.io/my-validatorarrow-up-right and click Register to become Validator

Fill out validator information, eg Name, commission..then click Register.

Type

Description

Commission Rate

initial commission

Max Rate

max commission that Validator set

Max Change Rate

% commission that can be changed

Notes: Commission changes every three months, and Max Change Rate does not exceed current + next change. For example: Current Commission is 2%, Max Change Rate is 3%; for the next change cycle (3months) will be between 1% -5%.

hashtag
Join Mainnet:

hashtag
Installation Files:

Download these files from the following link to your system: docker-compose.yamlarrow-up-right, kai-mainnet.ziparrow-up-right, kai_config.yamlarrow-up-right

https://github.com/kardiachain/go-kardia/tree/master/deployment/mainnetarrow-up-right

hashtag
Config File:

Use a text-editor application to edit kai_config.yaml (vim or nano…)

Name: Node Name will display on KardiaChain network. This will be different from Validator Name

PrivateKey: Your validator private key (ignore this field if not a Validator)

hashtag
Compose File to Join Mainnet:

hashtag
Check Container for Running:

hashtag
Logging:

Notes: for the first time when joining KardiChain network, Node will be anonymous and can NOT be trusted by peer. It can ONLY syn up the database from peers until manually added into trust-list by peers. When that happens, the database can sync both ways.

hashtag
Verification:

Wait for the node to sync-up with the highest block and check the status at:

https://explorer.kardiachain.io/arrow-up-right

Go to explorer and login to your Validator Wallet: https://explorer.kardiachain.io/arrow-up-right

Click “Start to become Validator” under Wallet Tab > Your Delegator

Or go here: https://explorer.kardiachain.io/wallet/staking/your-delegatorsarrow-up-right

Notes: Sync up time will depend on the network bandwidth and the blocks height. It usually takes half day or more

Tips: To speed up to syncing data from blockchain. You can download blockchain splitted files from:

And then combine all files

Notes: Validator Node is always on-line, and if it missed validating the last half of 10000 blocks, the Validator will be slashed 0.1% of the total stake amount and jailed (suspended) for 1 hour. The Validator has to manually un-jail after time expires.

DO NOT attempt to modify the source code or run more than one Validator node with the same private key. Any malicious activities will result in slashing 25% of the total staked amount.

PreviousPlatformNextPrivate KardiaChain Network

Last updated