Skip to content
This repository has been archived by the owner on Sep 21, 2022. It is now read-only.

Commit

Permalink
GitBook: [master] 15 pages and 2 assets modified
Browse files Browse the repository at this point in the history
  • Loading branch information
krasi-georgiev authored and gitbook-bot committed Dec 4, 2020
1 parent f6791d8 commit 1660f33
Show file tree
Hide file tree
Showing 12 changed files with 326 additions and 336 deletions.
Binary file added docs/.gitbook/assets/Tellor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/.gitbook/assets/minerspecs.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 0 additions & 24 deletions docs/CHANGELOG.md

This file was deleted.

66 changes: 25 additions & 41 deletions docs/README.md
100755 → 100644
Original file line number Diff line number Diff line change
@@ -1,70 +1,54 @@
# Introduction

<p align="center">
<a href='https://www.tellor.io/'>
<img src= '../assets/Tellor.png' width="250" height="200" alt='tellor.io' />
</a>
</p>
[![tellor.io](.gitbook/assets/Tellor.png)](https://www.tellor.io/)

<p align="center">
<a href='https://twitter.com/WeAreTellor'>
<img src= 'https://img.shields.io/twitter/url/http/shields.io.svg?style=social' alt='Twitter WeAreTellor' />
</a>
</p>
[![Twitter WeAreTellor](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/WeAreTellor)

> ### ⚠️ Note!
>
> Telliot docs are synced from the project repository. To edit please visit:
> [Telliot gitbook space](https://docs.tellor.io/telliot)
> or
> [Telliot github repo](https://github.com/tellor-io/telliot/tree/master/docs)
> ## ⚠️ Note!
> Telliot docs are synced from the project repository.
To edit please visit:<br/>
[Telliot gitbook space](https://docs.tellor.io/telliot)<br/>
or<br/>
[Telliot github repo](https://github.com/tellor-io/telliot/tree/master/docs)
## Telloit

This is the main cli of the project. One if its commands is to run in mining mode\(solve a POW challenge\) and submit values to the tellor oracle contract. It's built on Go and utilizes a split structure. The database piece is a LevelDB that keeps track of all variables \(challenges, difficulty, values to submit, etc.\) and the miner simply solves the PoW challenge. This enables parties to split the pieces for optimization.

The Tellor system is a way to push data on-chain. What pieces of data are pushed are specificied in the `configs/indexes.json`. Note that the data corresponds to a specific API. The tellor mining system is set up to pull api data to generate these values to submit on-chain once a correct nonce is mined. These specific apis are just suggestions. The system is not guarunteed to work for everyone. It is up to the consnesus of the Tellor token holders to determine what a correct value is. As an example, request ID 4 is BTC/USD. If the api's all go down, it is the responsibility of the miner to still submit a valid BTC/USD price. If they do not, they risk being disputed and slashed. For these reasons, please contribute openly to the official Tellor miner \(or an open source variant\), as consensus here is key. If you're miner gets a different value than the majority of the of the other miners, you risk being punished.

# Telloit
A list of all PSR's\(pre specified requests\) and the expected data can be found [here](https://github.com/tellor-io/telliot/tree/f6791d8fb61f7d49051624a70a96b7d6a3f77345/pkg/tracker/psrs.go).

This is the main cli of the project. One if its commands is to run in mining mode(solve a POW challenge) and submit values to the tellor oracle contract.
It's built on Go and utilizes a split structure. The database piece is a LevelDB that keeps track of all variables (challenges, difficulty, values to submit, etc.) and the miner simply solves the PoW challenge. This enables parties to split the pieces for optimization.
![MinerSpecs](.gitbook/assets/minerspecs.png)

The Tellor system is a way to push data on-chain. What pieces of data are pushed are specificied in the `configs/indexes.json`. Note that the data corresponds to a specific API. The tellor mining system is set up to pull api data to generate these values to submit on-chain once a correct nonce is mined. These specific apis are just suggestions. The system is not guarunteed to work for everyone. It is up to the consnesus of the Tellor token holders to determine what a correct value is. As an example, request ID 4 is BTC/USD. If the api's all go down, it is the responsibility of the miner to still submit a valid BTC/USD price. If they do not, they risk being disputed and slashed. For these reasons, please contribute openly to the official Tellor miner (or an open source variant), as consensus here is key. If you're miner gets a different value than the majority of the of the other miners, you risk being punished.
### Instructions for deployment

A list of all PSR's(pre specified requests) and the expected data can be found [here](../pkg/tracker/psrs.go).
* [Telliot Instructions](https://github.com/tellor-io/telliot/tree/f6791d8fb61f7d49051624a70a96b7d6a3f77345/docs/docs/setup-and-usage.md)

<p align="center">
<img src= '../assets/minerspecs.png' width="450" alt='MinerSpecs' />
</p>
### Contributing and building from source

Contributions are very welcome!
See our [04\_contributing.md](telliot-documentation/contributing.md) for more information.

## Instructions for deployment
- [Telliot Instructions](docs/setup-and-usage.md)
### Run with Docker

## Contributing and building from source
Contributions are very welcome!<br/>
See our [04_contributing.md](contributing.md) for more information.
Available tags: [https://hub.docker.com/u/tellor](https://hub.docker.com/u/tellor) docker run -v $\(pwd\)/.local:/configs tellor/telliot:master mine

## Run with Docker
Available tags: https://hub.docker.com/u/tellor
docker run -v $(pwd)/.local:/configs tellor/telliot:master mine
### Maintainers

## Maintainers <a name="maintainers"> </a>
This repository is maintained by the [Tellor team](https://github.com/orgs/tellor-io/people)

### DISCLAIMER

-------
#### DISCLAIMER

Mine at your own risk.

Mining requires you deposit 1000 Tellor Tributes. These are a security deposity. If you are a malicious actor (aka submit a bad value), the community can vote to slash your 1000 tokens.
Mining requires you deposit 1000 Tellor Tributes. These are a security deposity. If you are a malicious actor \(aka submit a bad value\), the community can vote to slash your 1000 tokens.

Mining also requires submitting on-chain transactions on Ethereum. These transactions cost gas (ETH) and can sometimes be signifiant if the cost of gas on EThereum is high (i.e. the network is clogged). Please reach out to the community to find the best tips for keeping gas costs under control or at least being aware of the costs.
Mining also requires submitting on-chain transactions on Ethereum. These transactions cost gas \(ETH\) and can sometimes be signifiant if the cost of gas on EThereum is high \(i.e. the network is clogged\). Please reach out to the community to find the best tips for keeping gas costs under control or at least being aware of the costs.

If you are building a competing client, please contact us. The miner specifications are off-chain and the validity of the mining process hinges on the consensus of the Tellor community to determine what proper values are. Competing clients that change different pieces run the risk of being disputed by the commmunity.

There is no guaruntee of profit from mining.

There is no promise that Tellor Tributes currently hold or will ever hold any value.

----------
### Copyright
Tellor Inc. 2019
20 changes: 13 additions & 7 deletions docs/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
## Telliot Documentation
# Table of contents

* [Introduction](README.md)
* [Setup and usage](setup-and-usage.md)
* [Configuation](configuation.md)
* [Contributing](contributing.md)
* [Coding style guide](coding-style-guide.md)
* [Release process](release-process.md)
* [Changelog](CHANGELOG.md)

## Telliot Documentation

* [Introduction](telliot-documentation/readme.md)
* [Setup and usage](telliot-documentation/setup-and-usage.md)
* [Configuation](telliot-documentation/configuation.md)
* [Contributing](telliot-documentation/contributing.md)
* [Coding style guide](telliot-documentation/coding-style-guide.md)
* [Release process](telliot-documentation/release-process.md)
* [Changelog](telliot-documentation/changelog.md)

27 changes: 27 additions & 0 deletions docs/telliot-documentation/changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).

NOTE: As semantic versioning states all 0.y.z releases can contain breaking changes in API \(flags, grpc API, any backward compatibility\)

We use _breaking :warning:_ to mark changes that are not backward compatible \(relates only to v0.y.z releases.\)

## Unreleased

* [\#272](https://github.com/tellor-io/telliot/pull/272) Automated Docker images on every push to master and with every tagged release.

## [v5.2.0](https://github.com/tellor-io/telliot/releases/tag/v5.2.0) - 2020.11.12

* [\#254](https://github.com/tellor-io/telliot/pull/254)
* Added support for expanding variables in the indexer api url.
* Added config to specify the `.env` file location. The default is now `configs/.env` so users should either specify a custom location in the `config.json` or move it inside the default config folder.

## [v5.0.0](https://github.com/tellor-io/telliot/releases/tag/v5.0.0) - 2020.11.02

### Added

* Profitability calculations which is set through the `ProfitThreshold`\(in percents\) settings in the config,
* Docs how to contribute.

Loading

0 comments on commit 1660f33

Please sign in to comment.