or
or
By clicking below, you agree to our terms of service.
New to HackMD? Sign up
Syntax | Example | Reference | |
---|---|---|---|
# Header | Header | 基本排版 | |
- Unordered List |
|
||
1. Ordered List |
|
||
- [ ] Todo List |
|
||
> Blockquote | Blockquote |
||
**Bold font** | Bold font | ||
*Italics font* | Italics font | ||
~~Strikethrough~~ | |||
19^th^ | 19th | ||
H~2~O | H2O | ||
++Inserted text++ | Inserted text | ||
==Marked text== | Marked text | ||
[link text](https:// "title") | Link | ||
 | Image | ||
`Code` | Code |
在筆記中貼入程式碼 | |
```javascript var i = 0; ``` |
|
||
:smile: | ![]() |
Emoji list | |
{%youtube youtube_id %} | Externals | ||
$L^aT_eX$ | LaTeX | ||
:::info This is a alert area. ::: |
This is a alert area. |
On a scale of 0-10, how likely is it that you would recommend HackMD to your friends, family or business associates?
Please give us some advice and help us improve HackMD.
Do you want to remove this version name and description?
Syncing
# Tellor One-Stop Doc™
Tellor One-Stop Doc™
The Ultimate Guide to hacking on Tellor
*FVM 2023 Edition
Hey Hackers! Welcome to your One-Stop Doc™ which includes everything you need to know about getting your hackathon project using Tellor’s oracle and ensuring you have an easy guided path to qualifying for a bounty.
Our bounties for FVM 2023:
Challenge:
Best use of Tellor oracle in your project built on FVM.
Prize Pool: $2500 (Up to 10 best teams, capped at $1000 per team)
To qualify:
Winners will need to meet these 2 requirements:
✅ Submit link to deployed and verified contract that integrates the “usingTellor” npm package
✅ Submit a transaction hash of a tip to incentivize a report. Use our guide
to configure incentives for tipping/paying testnet reporters to provide your data.
Now…we build.
One of the most basic use cases for oracles are spotPrice feeds ( see list of readily available prices ). So this guide will focus on that.
However if you'd like to use Tellor for something that isn't a spot price or it happens to be an asset price not currently supported please use: NumericApiResponse.
In this tutorial we'll go over:
UsingTellor
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 'UsingTellor'. contract.
Great! Now that you've got the tools ready, let's go through a simple exercise where we can retrieve the BTC/USD price :
BTC/USD Price Example
Inherit the UsingTellor contract, passing the Tellor address as a constructor argument,
Here's an example contract & github repo to follow along with:
To experience using Tellor w/ a demo contract, watch this video tutorial.
Tipping
Testnet Tokens
Once you've deployed your contract you'll need testnet tokens to tip reporters. You'll need Tellor Tributes (TRB) for this and of course the native token of your network. Here's how to get some:
How to get Test TRB
Use the faucet function on playground's token contract
Click here for more info
How to Tip Reporters:
Via block explorer:
call approve with the tip amount in the token contract
call 'tip' in autopay contract
*Don't forget to include a link to your tip tx in the read.me of your submitted project.
🎉🎉🎉 Congrats! you're now an official Tellor user!
Need Some Inspiration?
Let's start with giving you an idea of what the Tellor oracle can provide…Anything! It just needs to be spec'd out.
But here’s some highlights:
Extra Resources
List of readily available prices
Tellor Docs
List of addresses of all the networks Tellor currently supports
Still have questions? Reach out to us in the #sponsor-tellor channel on the #IPFS Discord or Join the Tellor Discord
Follow us on Twitter