Passar al contingut principal

Ajudeu a traduir aquesta pàgina


Esteu veient aquest pàgina en anglès perquè encara no l'hem traduïda. Ajudeu-nos a traduir aquest contingut.

Traduïu la pàgina

No conté errors!🐛

Aquesta pàgina no està essent traduïda. De moment hem deixat aquesta pàgina intencionadament en anglès.

How to Set Up Tellor as your Oracle

smart contracts
price feeds
📚Tellor Docs
📆29 de juny de 2021
⏱️2 minut llegit

Pop Quiz: Your protocol is just about finished, but it needs an oracle to get access to off chain data...What do you do?

(Soft) Prerequisites

This post aims to make accessing an oracle feed as simple and straightforward as possible. That said, we're assuming the following about your coding skill-level to focus on the oracle aspect.


  • you can navigate a terminal
  • you have npm installed
  • you know how to use npm to manage dependencies

Tellor is a live and open-sourced oracle ready for implementation. This beginner's guide is here to showcase the ease with which one can get up and running with Tellor, providing your project with a fully decentralized and censorship-resistent oracle.


Tellor is an oracle system where parties can request the value of an off-chain data point (e.g. BTC/USD) and reporters compete to add this value to an on-chain data-bank, accessible by all Ethereum smart contracts. The inputs to this data-bank are secured by a network of staked reporters. Tellor utilizes crypto-economic incentive mechanisms, rewarding honest data submissions by reporters and punishing bad actors through the issuance of Tellor’s token, Tributes (TRB) and a dispute mechanism.

In this tutorial we'll go over:

  • Setting up the initial toolkit you'll need to get up and running.
  • Walk through a simple example.
  • List out testnet addresses of networks you currently can test Tellor on.


The first thing you'll want to do is install the basic tools necessary for using Tellor as your oracle. Use this package to install the Tellor User Contracts:

npm install usingtellor

Once installed this will allow your contracts to inherit the functions from the contract 'UsingTellor'.

Great! Now that you've got the tools ready, let's go through a simple exercise where we retrieve the bitcoin price:

BTC/USD Example

Inherit the UsingTellor contract, passing the Tellor address as a constructor argument:

Here's an example:

1import "usingtellor/contracts/UsingTellor.sol";
3contract BtcPriceContract is UsingTellor {
5 //This Contract now has access to all functions in UsingTellor
7 bytes btcPrice;
8 bytes32 btcQueryId = 0x0000000000000000000000000000000000000000000000000000000000000002;
10 constructor(address payable _tellorAddress) UsingTellor(_tellorAddress) public {}
12 function setBtcPrice() public {
13 bool _didGet;
14 uint256 _timestamp;
16 (_didGet, btcPrice, _timestamp) = getCurrentValue(btcQueryId);
17 }
Mostrar-ho tot
📋 Copiar

Want to try a different data feed? Check out the list of supported data feeds here: Current Data Feeds


Mainnet: 0x88df592f8eb5d7bd38bfef7deb0fbc02cf3778a0

Looking to do some testing first? See the list below for our active testnet addresses:

Rinkeby: 0x88df592f8eb5d7bd38bfef7deb0fbc02cf3778a0

Kovan: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

Ropsten: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

Goerli: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

BSC Testnet: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

Polygon Mumbai Testnet: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

Arbitrum Testnet: 0x3477EB82263dabb59AC0CAcE47a61292f28A2eA7

For a more robust implementation of the Tellor oracle, check out the full list of available functions here.

Darrera edició: , Invalid DateTime
Edita la pàgina

Ha estat útil aquesta pàgina?