Skip to content

developerfred/TellorMiner

 
 

Repository files navigation

tellor.io

Twitter WeAreTellor

Tellor Miner

This is the workhorse of the Miner system as it takes on solving the PoW challenge. 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.

A list of all PSR's(pre specified requests) and the expected data can be found here.

MinerSpecs

Instructions for deployment

Contributing and building from source

Contributions are very welcome!
See our contributing.md for more information.

Run with Docker

Available tags: https://hub.docker.com/u/tellor docker run -v $(pwd)/.local:/configs tellor/miner:master mine

Maintainers

This repository is maintained by the Tellor team

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 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

About

Miner for Tellor Decentralized Oracle System

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Solidity 54.1%
  • Go 39.2%
  • C 5.0%
  • Makefile 1.1%
  • Other 0.6%