KYVE — Docs
Search…
Running the Cosmos integration
This guide will walk you through the basics of running the KYVE + Cosmos integration.

Requirements

  • Ethereum wallet (MetaMask)
  • You need $DEV and $KYVE (You can get some for free here)
  • Any device with a good internet connection

Docker (Recommended)

You can run the Cosmos integration directly from Docker.
To pull the latest Docker image, run:
1
docker pull kyve/cosmos:latest
Copied!
And to start your node, run the following (don't forget to pass in options):
1
docker run --name kyve-cosmos-node kyve/cosmos:latest --pool POOL_ADDRESS --private-key PRIVATE_KEY --stake 100
Copied!

Prebuilt Binaries

We also provide prebuilt binaries for you to run.
We currently support Linux, macOS, and Windows binaries - which you can download from here.
To run a binary, all you need to do is specify your options.

Run on Linux

1
./kyve-cosmos-linux --pool POOL_ADDRESS --private-key PRIVATE_KEY --stake 100
Copied!

Run on MacOS

1
./kyve-cosmos-macos --pool POOL_ADDRESS --private-key PRIVATE_KEY --stake 100
Copied!

Run on Windows

1
.\kyve-cosmos-win.exe --pool POOL_ADDRESS --private-key PRIVATE_KEY --stake 100
Copied!

Options

-p, --pool <string>
The address of the pool you want to run on.
-s, --stake <number>
The amount of tokens you want to stake.
-pk, --private-key <string>
Your Ethereum private key that holds $KYVE.
-k, --keyfile <string> _optional_
The path to your Arweave keyfile.
-n, --name <string> _optional, default is a random name_
The identifier name of the node.
-e, --endpoint <string> _optional_
A custom Moonbase Alpha endpoint.
-g, --gas-multiplier <string> _optional_
The amount that you want to multiply the default gas price by.
-st, --send-statistics <boolean> _optional, default is true_
Send statistics.

Verify a node is running correctly

Uploader

When you run as an uploader you should see something like:
1
2021-11-03 09:41:00.000 INFO 🚀 Starting node ...
2
Name = kyve-cosmos-uploader
3
Address = 0x...
4
Pool = 0x...
5
Desired Stake = 100 $KYVE
6
Version = v0.0.0
7
2021-11-03 09:41:00.000 DEBUG [Metadata] Attempting to fetch the metadata.
8
2021-11-03 09:41:00.000 DEBUG [Metadata] Successfully fetched the metadata.
9
2021-11-03 09:41:00.000 DEBUG [Settings] Attempting to fetch the settings.
10
2021-11-03 09:41:00.000 DEBUG [Settings] Successfully fetched the settings.
11
2021-11-03 09:41:00.000 DEBUG [Config] Attempting to fetch the config.
12
2021-11-03 09:41:00.000 DEBUG [Config] Successfully fetched the config.
13
2021-11-03 09:41:00.000 INFO 💻 Running node on runtime @kyve/cosmos.
14
2021-11-03 09:41:00.000 DEBUG [Stake] Attempting to stake 100 $KYVE.
15
2021-11-03 09:41:00.000 DEBUG [Stake] Approving 100 $KYVE to be spent. Transaction = 0x...
16
2021-11-03 09:41:00.000 INFO [Stake] 👍 Successfully approved.
17
2021-11-03 09:41:00.000 DEBUG [Stake] Staking 100 $KYVE. Transaction = 0x...
18
2021-11-03 09:41:00.000 INFO [Stake] 📈 Successfully staked.
19
2021-11-03 09:41:00.000 INFO [Cosmos] ✅ Connection created. Endpoint = wss://rpc.cosmos.network
Copied!

Validator

When you run as a validator you should see something like:
1
2021-11-03 09:41:00.000 INFO 🚀 Starting node ...
2
Name = kyve-cosmos-validator
3
Address = 0x...
4
Pool = 0x...
5
Desired Stake = 100 $KYVE
6
Version = v0.0.0
7
2021-11-03 09:41:00.000 DEBUG [Metadata] Attempting to fetch the metadata.
8
2021-11-03 09:41:00.000 DEBUG [Metadata] Successfully fetched the metadata.
9
2021-11-03 09:41:00.000 DEBUG [Settings] Attempting to fetch the settings.
10
2021-11-03 09:41:00.000 DEBUG [Settings] Successfully fetched the settings.
11
2021-11-03 09:41:00.000 DEBUG [Config] Attempting to fetch the config.
12
2021-11-03 09:41:00.000 DEBUG [Config] Successfully fetched the config.
13
2021-11-03 09:41:00.000 INFO 💻 Running node on runtime @kyve/cosmos.
14
2021-11-03 09:41:00.000 DEBUG [Stake] Attempting to stake 100 $KYVE.
15
2021-11-03 09:41:00.000 DEBUG [Stake] Approving 100 $KYVE to be spent. Transaction = 0x...
16
2021-11-03 09:41:00.000 INFO [Stake] 👍 Successfully approved.
17
2021-11-03 09:41:00.000 DEBUG [Stake] Staking 100 $KYVE. Transaction = 0x...
18
2021-11-03 09:41:00.000 INFO [Stake] 📈 Successfully staked.
Copied!
Last modified 23d ago