Tellor Layer

Overview

Tellor Layer is a stand alone L1 built using the cosmos sdk for the purpose of coming to consensus on any subjective data. It works by using a network of staked parties who are crypto-economically incentivized to honestly report requested data.

For more in-depth information, checkout the Tellor Layer tech paper and our ADRs.

For docs on how to join our public testnet go here: https://docs.tellor.io/layer-docs

Starting a New Chain

1. Select the start script that works for you

• start_one_node.sh is for those who want to run a chain with a single validator in a mac environment
• start_one_node_aws.sh is for those who want a chain with a single validator and the option to import a faucet account from a seed phrase to be used in a linux environment
• start_two_chains.sh (mac environment) sets up two nodes/validators and starts one of them from this script. Then to start the other validator you would run the start_bill.sh script

2. Run the selected script from the base layer folder:

./start_scripts/{selected_script}

Joining a Running Chain

To find more information please go to the layer_scripts folder.

Here you will find a detailed breakdown for how to join a chain as a node and how to create a new validator for the chain

Start a local devnet

Run the chain locally in a docker container, powered by local-ic

Install heighliner:

make get-heighliner

Create image:

make local-image

Install local interchain:

make get-localic

Start the local-devnet:

make local-devnet

To configure the chain (ie add more validators plus more) edit the json in local_devnet/chains/layer.json

Tests

To run integration tests:

make test

To run e2e tests:

make e2e

Linting

To lint per folder:

make lint-folder-fix FOLDER="x/mint"

To lint all files:

make lint

Maintainers

This repository is maintained by the Tellor team

How to Contribute

Check out our issues log here on Github or feel free to reach out anytime [email protected]

Community

• Official Website
• Discord
• Twitter

Copyright

Tellor Inc. 2024