Ask AI
Skip to main content

Run a Protocol node

With the node in place and the KYVE node also installed you can finally start the node.

Start Node

Finally the protocol validator can be started. In order to start it, execute the following command. Since we named our valaccount osmosis we select this valaccount to start the KYSOR.

./kysor start --valaccount 'osmosis'

You can also start the process in debug mode by adding the --debug flag like this:

./kysor start --valaccount 'osmosis' --debug
tip

If you're running the node on a separate machine you have to tell the protocol validator with an env variable the new rpc endpoint.

Create .env file:

KYVEJS_TENDERMINT_RPC=https://my-custom-rpc-endpoint:26657

pass it to KYSOR:

./kysor start --valaccount 'osmosis' --env-file="path/to/.env"

After the node successfully started you should see the following logs:

2023-02-13 08:46:00.618 INFO Starting node ...

2023-02-13 08:46:00.624 INFO Starting metric server on: http://localhost:8080/metrics 2023-02-13 08:46:00.828 INFO Checking account balance on StorageProvider:Irys 2023-02-13 08:46:00.872 INFO Account has available funds on StorageProvider:Irys

2023-02-13 08:46:00.873 INFO Chain ID = kyve-kaon 2023-02-13 08:46:00.873 INFO Pool ID = 1 2023-02-13 08:46:00.873 INFO Runtime = @kyvejs/tendermint 2023-02-13 08:46:00.873 INFO Valaddress = kyve1887l27uwn5r6u9gxw7dg9wt0kqh7uk23suumzc

2023-02-13 08:46:00.873 INFO @kyvejs/tendermint = v1.0.11 2023-02-13 08:46:00.873 INFO @kyvejs/protocol = v1.0.11

2023-02-13 08:46:00.876 INFO Valaccount has not joined the pool with id 1 yet 2023-02-13 08:46:00.876 INFO Visit https://app.kyve.network and join the pool from your validator account:

2023-02-13 08:46:00.876 INFO Valaddress: kyve1887l27uwn5r6u9gxw7dg9wt0kqh7uk23suumzc 2023-02-13 08:46:00.876 INFO Valname: causal-chocolate-sparrow

2023-02-13 08:46:00.876 INFO The node will not continue until the account is authorized

With this information (Valaddress and Valname) you can head over the KYVE app and join the pool.

Now that the node is already running it just needs the authorization from it's main validator account in order to run for this validator and generate rewards. For that visit your validator page and click on Join existing pool.

A dialog should open where you should select the pool you want to join (here Osmosis). After that enter the valaddress that needs to be authorized and the valname, which just serves as a security that the node has actually been started. (If you join a pool without having the node running you are in danger of receiving a timeout slash because once you join a pool you are expected to validate and upload data).

For the last option you can do a one time transfer so that the valaccount has some $KYVE to pay for transaction fees. We would recommend sending 100 $KYVE for the start which typically lasts for about 1 month.

caution

IMPORTANT: Make sure that the valaccount always has enough $KYVE to pay for transaction fees, otherwise you are again in danger of receiving a timeout slash.

Once you have joined the pool the node should continue in about ~10 seconds. After that you are successfully participating in a pool.

Start node with systemd

If you want to start the nodes as a background process you can use systemd.

For the daemon service root-privileges are required during the setup. Create a service file. $USER is the Linux user which runs the process. Replace it before you copy the command.

Since the KYSOR can run on multiple pools on one machine we would recommend naming the daemon service after the valaccount name and with a d appending to it. With that you can create multiple service files and control each of them. This example shows the service file for our valaccount

osmosis
info

You might have to execute this command with sudo

tee <<EOF > /dev/null /etc/systemd/system/osmosisd.service 
[Unit]
Description=KYVE Protocol-Node osmosis daemon
After=network-online.target

[Service]
User=$USER
ExecStart=/home/$USER/kysor start --valaccount osmosis
Restart=on-failure
RestartSec=3
LimitNOFILE=infinity
EOF
info

Don't forget to change the filename and the valaccount in the service file if you join a different pool

Start the daemon

sudo systemctl enable osmosis
sudo systemctl start osmosis

It can be stopped using

sudo systemctl stop osmosis

You can see its logs with

sudo journalctl -u osmosis -f -o cat

Start node on multiple pools

This step is optional, but the more pools you participate in the higher the rewards. If you want to join another pool just repeat the previous steps (Install pool binaries). For that you have to create a new valaccount, because a valaccount can only run on one data pool. Once you have setup the second valaccount you can start it. You can see all the pools you are participating in your validator page.

caution

WARNING: Joining for example a second pool might double your rewards, but it also doubles the danger of getting slashed.