Setting up Oracles

This page contains necessary information on how to make your oracle service fully operational on-chain

If use use local developments setup - use yarn setup:local for both staking in KV Store setup. For testnet - follow the steps below.

Staking

Each oracle has to stake some HMT in order to be part of reputation network. In order to do that for testnet - go to 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 Reputation Network, they first need to have their KV Store set up properly.

Make sure each oracle has some POL on their balance before making next steps

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

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

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

At the moment scripts work only with .env file, so make sure you have it filled with proper values before run.

In case you rely on Docker setup, make sure that you run this script from inside of Docker container because inside of the container you will 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 withing the container
yarn ts-node scripts/setup-kv-store.ts

Unfortunately, at the moment CVAT oracles don't have such script, so in case you need them - you will need to manually do that either with the sample script from FAQ or via Staking Dashboard

---

Register in Reputation Network

In order to make Exchange Oracle, Recording Oracle & Job Launcher fully operational, you will need to make some extra steps to complete registration in Reputation Network (i.e. activate them on Reputation Oracle):

1. go to HUMAN App UI and start Oracle sign up process (see Sign Up for hints)

2. skip "stake" and "KV Store" steps (you should have them completed earlier)

3. finish the registration process

4. sign in as oracle

5. activate oracle in Reputation Network (click "Activate") button