Skip to content

Setting Up Oracles

Info

If you use the local development setup, run yarn setup:local for both staking and KV Store setup. For testnet, follow the steps below.

Staking#

Each oracle has to stake some HMT in order to be part of the reputation network. To do that on testnet, go to the Staking App, connect your oracle wallets, and stake at least 1 HMT for each of them.

Setting up KV Store#

Before registering your oracles in the Reputation Network, they first need to have their KV Store set up properly.

Warning

Make sure each oracle has some POL in its balance before taking the next steps.

Each Node.js oracle has a scripts/setup-kv-store.ts script that helps you set up the KV Store. You can run it as:

yarn ts-node scripts/setup-kv-store.ts

and it will fill the KV Store with defaults. You can override some values via env vars if needed.

Warning

At the moment the script works only with an .env file, so make sure you have it filled with proper values before running it.

If you rely on the Docker setup, make sure that you run this script from inside the Docker container because inside the container you already have all necessary overrides. Using Reputation Oracle as an example:

# open bash session within the container
docker exec -it reputation-oracle bash
# run the script within the container
yarn ts-node scripts/setup-kv-store.ts

Info

Unfortunately, at the moment CVAT oracles don't have such a script, so if you need them, you will have to set them up manually using the sample script from the FAQ or via the Staking Dashboard.

Register in the Reputation Network#

To make the Exchange Oracle, Recording Oracle, and Job Launcher fully operational, you need to take a few extra steps to complete registration in the Reputation Network (i.e., activate them on Reputation Oracle):

  1. Go to the HUMAN App UI and start the oracle sign-up process (see sign-up for hints).
  2. Skip the "stake" and "KV Store" steps (you should have them completed earlier).
  3. Finish the registration process.
  4. Sign in as the oracle.
  5. Activate the oracle in the Reputation Network (click Activate).