Installing Telliot

How to install the Reporter (Telliot) and a Disputable Values Monitor (DVM) .

If you experience ANY issues during the installation and setup please do not hesitate to reach out via the Fetch Telegram Support group!

Prerequisites:

• Some tPLS for paying gas fees. If you need tPLS, you can obtain some via the PulseChain Faucet.

• A Linux distribution or macOS on your machine, as they are both Unix-based (Ubuntu 22.04 / 24.04 and MAC M1 Ubuntu VM were tested). Windows is not currently supported.

• To install in a mac we recommend using a virtual machine to make sure everything is aligned with this tutorial. Check here for quick steps on how to set up one.

• Running Telliot and a DVM is fairly lightweight and does not require significant computing power. A single core machine with 1 GB RAM should be enough to get started. It's also highly recommended to run this software on a Virtual Machine, fresh cloud server instance from AWS, Digital Ocean, or other providers.

Install Script

Helper to install telliot and get up and running in no time.

Script is supposed to run in linux bash, like, Ubuntu. Open your terminal, copy, paste and run the full command below:

curl -O https://raw.githubusercontent.com/fetchoracle/telliot-install-script/refs/heads/main/install.sh && chmod +x install.sh && ./install.sh && cd && cd telliot-feeds && source venv/bin/activate

You can check the script here

Running the install script

Simply copy and run the full line above in your terminal to clone the repos and install telliot-feeds, telliot-core and, optionally, disputable-values-monitor.

During installation you may be asked permission to install python and update the system.

That's it! Everything should be installed and ready to go!

Below is a detailed view of the installation process:

Choose Testnet/Main (Default) environment to install by pressing 1 and hitting enter

If you are updating/reinstalling you need to remove/rename the telliot-feeds folder that is created in Home, before running this script.

After choosing your env option you can decide to install DVM by typing 'yes' or 'no'.

If installation is successful and you chose to install DVM

If installation is successful and you only installed Telliot

Confirming installation was successful

After installing, the command you pasted will try to enter telliot-feeds folder and activate the venv environment with source venv/bin/activateautomatically. Confirm you are in it checking for (venv) in the cli:

(venv) displayed at the beginning of the line and inside telliot-feeds folder

Everytime you run Telliot or DVM you need to enter this virtual environment. To enter it, go to telliot-feeds folder and run source venv/bin/activate. To exit it, run deactivate.

Inside the folder, run telliot --help. If you see the help instructions for Telliot, its installation was successful.

Successful Telliot install

To check DVM, cd disputable-values-monitor from the telliot-feeds. Run cli --help. If you see the help page for the DVM, installation was successful.

Successful DVM install

Configure Endpoints

You can check your endpoints config running telliot config show.

The default configuration for the endpoints can be found in ~/telliot/endpoints.yaml:

Tip: DVM will monitor all chains in this folder. Comment out or remove the ones you don't want it to be listening for reports.

type: EndpointList
endpoints:
- type: RPCEndpoint
  chain_id: 943
  network: Pulsechain Testnet
  provider: Pulsechain
  url: https://rpc.v4.testnet.pulsechain.com
  explorer: https://scan.v4.testnet.pulsechain.com/
- type: RPCEndpoint
  chain_id: 369
  network: Pulsechain Mainnet
  provider: Pulsechain
  url: https://rpc.pulsechain.com
  explorer: https://scan.pulsechain.com/

You can add your RPC endpoints via the command line or by editing the endpoints.yaml file. It's easier to do via the command line, but here's an example command using the nano text editor to edit the YAML file directly:

nano ~/telliot/endpoints.yaml

Upgrade

Delete telliot-feeds and telliot folder inside your Home directory and just run the install script again to update Telliot. Your accounts will remain saved in the chained_accounts folder, so no need to add them after installation.

If you are a more advanced user and has made changes locally to Telliot, you can upgrade it with regular git pull to fetch the latest changes from the branches you're using and install the packages with pip install -e .. Repeat this process in telliot-feeds, telliot-core and dvm folders.