Installation

Versions

Depending on the network one may need to run different versions. The following table shows the upgrade block height for a given version:

Tag	Kaon	Mainnet
v1.0.0-rc0	0	-
v1.0.0-rc1	443300	-
v1.0.0	-	0
v1.1.0	1115111	826000
v1.2.0	1502502	1135000
v1.3.0	2341100	2061100
v1.4.0	4185500	3908000
v1.5.0	7571371	7254527

For the Korellia devnet there is no version map. Only the latest version via statesync is supported.

Obtain binaries

Depending on which network you want to join you have to obtain the binaries differently.

Mainnet

For mainnet the binaries have to be build manually.

Install Go

KYVE is built using Go version 1.20+. Follow the instructions from the official website to install go.

go version # e.g. go version go1.20.1 linux/amd64

In addition to Go, make sure you have git and make installed.

GitHub

Clone and build KYVE using git:

git clone https://github.com/KYVENetwork/chain.git
cd chain
git fetch
git checkout tags/<tag>
make build ENV=mainnet

Here the <tag> is the latest version which you can get here.

tip

Note: You can find the compiled binary under chain/build/kyved

After the download was done, verify that it was successful:

./kyved version

Kaon

For Kaon the binaries have to be build manually.

Install Go

KYVE is built using Go version 1.20+. Follow the instructions from the official website to install go.

go version # e.g. go version go1.20.1 linux/amd64

In addition to Go, make sure you have git and make installed.

GitHub

Clone and build KYVE using git:

git clone https://github.com/KYVENetwork/chain.git
cd chain
git fetch
git checkout tags/<tag> -b <tag>
make build ENV=kaon

Here the <tag> is the latest version which you can get here.

tip

Note: You can find the compiled binary under chain/build/kyved

After the download was done, verify that it was successful:

./kyved version

Korellia

Korellia does not follow any release schedule. Usually it's in sync with the latest stable release branch and it uses the kaon build environment. Here is a list for every supported OS with the current version v1.4.0

linux/amd64

wget https://github.com/KYVENetwork/chain/releases/download/v1.5.0/kyved_kaon_linux_amd64
chmod +x kyved_kaon_linux_amd64

linux/arm64

wget https://github.com/KYVENetwork/chain/releases/download/v1.5.0/kyved_kaon_linux_arm64
chmod +x kyved_kaon_linux_arm64

darwin/amd64

wget https://github.com/KYVENetwork/chain/releases/download/v1.5.0/kyved_kaon_darwin_amd64
chmod +x kyved_kaon_darwin_amd64

darwin/arm64

wget https://github.com/KYVENetwork/chain/releases/download/v1.5.0/kyved_kaon_darwin_arm64
chmod +x kyved_kaon_darwin_arm64

After the installation is done, verify that it was successful:

./kyved version

Initialize Node

We need to initialize the node to create all the necessary validator and node configuration files

Mainnet

Save Chain ID

We recommend saving the chain-id into your kyved's client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.

./kyved config chain-id kyve-1

Initialize

Initialize node by providing your moniker and the chain id

./kyved init <your_custom_moniker> --chain-id kyve-1

caution

IMPORTANT: Monikers can contain only ASCII characters. Using Unicode characters will render your node unreachable.

Kaon

Save Chain ID

We recommend saving the chain-id into your kyved's client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.

./kyved config chain-id kaon-1

Initialize

Initialize node by providing your moniker and the chain id

./kyved init <your_custom_moniker> --chain-id kaon-1

caution

IMPORTANT: Monikers can contain only ASCII characters. Using Unicode characters will render your node unreachable.

Korellia

Save Chain ID

We recommend saving the chain-id into your kyved's client.toml. This will make it so you do not have to manually pass in the chain-id flag for every CLI command.

./kyved config chain-id korellia

Initialize

Initialize node by providing your moniker and the chain id

./kyved init <your_custom_moniker> --chain-id korellia

caution

IMPORTANT: Monikers can contain only ASCII characters. Using Unicode characters will render your node unreachable.

Once the installation and initialization was successful you can proceed to the node configuration.