Running the Near integration

This guide will walk you through the basics of running the KYVE + Near integration.

Requirements

• Ethereum Wallet

• You need $DEV and $KYVE (You can get some for free here)

• Any device with a good internet connection

Docker

You can run the Near integration directly from Docker.

To pull the latest Docker image, run:

docker pull kyve/near:latest

And to start your node, run the following (don't forget to pass in options):

docker run --rm --name kyve-near-node kyve/near:latest --pool {POOL_ADDRESS} --private-key {PRIVATE_KEY} --stake 100

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

./kyve-near-linux --pool {POOL_ADDRESS} --private-key {PRIVATE_KEY} --stake 100

Run on MacOS

./kyve-near-macos --pool {POOL_ADDRESS} --private-key {PRIVATE_KEY} --stake 100

Run on Windows

.\kyve-near-win.exe --pool {POOL_ADDRESS} --private-key {PRIVATE_KEY} --stake 100

Options

-p, --pool <string>

The address of the pool you want to run on.

-s, --stake <string>

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:

2021-12-08 09:41:00.000  INFO 🚀 Starting node ...
    Name          = kyve-near-uploader
    Address       = 0x...
    Pool          = 0x...
    Desired Stake = 100 $KYVE
    Version       = v0.0.0
2021-12-08 09:41:00.000  DEBUG [Metadata] Attempting to fetch the metadata.
2021-12-08 09:41:00.000  DEBUG [Metadata] Successfully fetched the metadata.
2021-12-08 09:41:00.000  DEBUG [Settings] Attempting to fetch the settings.
2021-12-08 09:41:00.000  DEBUG [Settings] Successfully fetched the settings.
2021-12-08 09:41:00.000  DEBUG [Config] Attempting to fetch the config.
2021-12-08 09:41:00.000  DEBUG [Config] Successfully fetched the config.
2021-12-08 09:41:00.000  INFO 💻 Running node on runtime @kyve/near.
2021-12-08 09:41:00.000  DEBUG [Stake] Attempting to stake 100 $KYVE.
2021-12-08 09:41:00.000  DEBUG [Stake] Approving 100 $KYVE to be spent. Transaction = 0x...
2021-12-08 09:41:00.000  INFO [Stake] 👍 Successfully approved.
2021-12-08 09:41:00.000  DEBUG [Stake] Staking 100 $KYVE. Transaction = 0x...
2021-12-08 09:41:00.000  INFO [Stake] 📈 Successfully staked.
2021-12-08 09:41:00.000  INFO [Near] ✅ Connection created. Endpoint = https://archival-rpc.mainnet.near.org

Validator

When you run as a validator you should see something like:

2021-12-08 09:41:00.000  INFO 🚀 Starting node ...
    Name          = kyve-near-validator
    Address       = 0x...
    Pool          = 0x...
    Desired Stake = 100 $KYVE
    Version       = v0.0.0
2021-12-08 09:41:00.000  DEBUG [Metadata] Attempting to fetch the metadata.
2021-12-08 09:41:00.000  DEBUG [Metadata] Successfully fetched the metadata.
2021-12-08 09:41:00.000  DEBUG [Settings] Attempting to fetch the settings.
2021-12-08 09:41:00.000  DEBUG [Settings] Successfully fetched the settings.
2021-12-08 09:41:00.000  DEBUG [Config] Attempting to fetch the config.
2021-12-08 09:41:00.000  DEBUG [Config] Successfully fetched the config.
2021-12-08 09:41:00.000  INFO 💻 Running node on runtime @kyve/near.
2021-12-08 09:41:00.000  DEBUG [Stake] Attempting to stake 100 $KYVE.
2021-12-08 09:41:00.000  DEBUG [Stake] Approving 100 $KYVE to be spent. Transaction = 0x...
2021-12-08 09:41:00.000  INFO [Stake] 👍 Successfully approved.
2021-12-08 09:41:00.000  DEBUG [Stake] Staking 100 $KYVE. Transaction = 0x...
2021-12-08 09:41:00.000  INFO [Stake] 📈 Successfully staked.
2021-12-08 09:41:00.000  INFO [Near] ✅ Connection created. Endpoint = https://archival-rpc.mainnet.near.org