NDVI outcome reporting guide for Tellor Reporters
How to report the outcome for the third DIVA Donate campaign
Introduction
The third parametric conditional donation campaign on DIVA Donate, which uses Tellor Protocol for outcome reporting, will expire and open for reporting on Monday, June 10, 2024, at 6:00 PM UTC (unix timestamp: 1718042400). This article provides a guide for Tellor reporters on how to participate in the outcome reporting and verify the accuracy of reported values.
Pool details
This campaign is linked to the following poolId
on DIVA Protocol: 0x8c85108a28a163d1722c2140eea57f9d1cb7f83f69dfc04eb0d9e51298dea2b6.
To access the pool parameters, visit louper.dev (Etherscan for EIP-2535 based contracts) and input the poolId
into the getPoolParameters
function. The detailed description of the reference asset can be found via the IPFS link in the referenceAsset
field:
Accessing the IPFS link in your browser will display the following:
Reporting
The reporting process consists of the following four steps which are described in detail in the subsequent sections:
Sourcing the NDVI value
Sourcing the USD rate of the collateral token (USDT)
Preparing the values for submission
Submitting to Tellor contract
Submitting to DIVA Protocol
1 - Sourcing the NDVI value
To manually source the NDVI value:
Visit USGS Early Warning Site.
Double-click on “NDVI eVIIRs” in the Dataset panel on the left.
Locate and select "Kenya Kajiado" on the map.
Ensure the year 2024 curve is selected.
Read the value on 31th May 2024.
2 - Sourcing the USD rate of the collateral token (USDT)
In addition to the NDVI value, the reporter must also submit the USD rate of the collateral token, USDT, which is utilized to calculate the reporter's reward. You can confirm that USDT (at address 0xc2132D05D31c914a87C6611C10748AEb04B58e8F) is the pool's collateral token by checking the getPoolParameters
output.
The USD rate can be obtained from price aggregators like Coingecko or Coinmarketcap, or exchanges.
The reference asset description does not specify whether the observation date for the USD rate should be May 31, 2024, or June 10, 2024, at 6:00 PM UTC. For consistency, use the same time as the observation timepoint for the reference asset, which is May 31, 2024. Use the end-of-day price at 11:59:59 PM UTC, round to two decimal places. It is anticipated that the USD value of USDT will be 1.00, thereby minimizing any potential for ambiguity or dispute.
3 - Preparing the values for submission
Prepare the two values as per below and encode them as bytes
:
NDVI value
Shift the observed NDVI value by +1 and round it to two decimal places, which is the default precision in the NDVI chart. For instance, an NDVI value of 0.75 becomes 1.75.
Convert the adjusted NDVI value into an unsigned integer with 18 decimals. Thus, 1.75 becomes 1750000000000000000.
USD value of the collateral token (USDT)
Convert the value into an unsigned integer with 18 decimals. Thus, 1.00 becomes 1000000000000000000.
Encode the values
Use the following function to encode your values. Check out this example for reference.
Example: With finalReferenceValue = 1750000000000000000
and collateralToUSDRate = 1000000000000000000
, the encoded oracle value will be:
0x00000000000000000000000000000000000000000000000018493fba64ef00000000000000000000000000000000000000000000000000000de0b6b3a7640000
4 - Submitting to Tellor contract
To submit the encoded value to the Tellor contract, use the submitValue
function on the (old) Tellor contract at the address 0xD9157453E2668B2fc45b7A803D3FEF3642430cC0. Enter the encoded value into the _value
field and include the following parameters that are independent of the NDVI value / collateral USD value:
_queryId
:0xf5b0d276ce38d3776861fb978b066a0ade32227dd84c282dbdda40d31fbda068
_nonce
:0
_queryData
:0x00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000c4449564150726f746f636f6c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000608c85108a28a163d1722c2140eea57f9d1cb7f83f69dfc04eb0d9e51298dea2b60000000000000000000000002c9c47e7d254e493f02acfb410864b9a86c28e1d0000000000000000000000000000000000000000000000000000000000000089
Additional comments
To verify that the provided
queryId
andqueryData
are indeed correct, refer to this script.Ensure that you have staked TRB tokens to be eligible for reporting. For detailed instructions on how to become a reporter, refer to the official Tellor docs (note that these documents may reference the newer, gas-optimized Tellor contracts, whereas the DIVA Tellor adapter used in this campaign is still linked to the older version).
Please note that values submitted to the Tellor contract before campaign expiration (Monday, June 10, 2024, at 6:00 PM UTC) will be ignored.
If you prefer to submit the value via a script, refer to this example. Make sure to update the script setting
const tellorVersion = TELLOR_VERSION.PLAYGROUND
toconst tellorVersion = TELLOR_VERSION.
ACTUAL
to reflect the mainnet environment.
5 - Submitting to DIVA Protocol
If the reported NDVI value remains undisputed for at least 12 hours, anyone can execute the setFinalReferenceValue
function on the DIVA Tellor adapter contract on the Polygon chain at address 0x7950db13cc37774614b0aa406e42a4c4f0bf26a6. This action pulls the value from the Tellor contract into DIVA Protocol and determines the payouts for each leg of the market.
When executing the function setFinalReferenceFunction
, set _tippingTokens
to an empty array and _claimDIVAReward
to true
. This will transfer the data provider reward from DIVA Protocol to the original Tellor reporter, amounting to 0.05% of the deposited funds, approximately $4.30.
Additional Notes
The NDVI value is updated every five days and historical values are subject to slight variations due to a smoothing algorithm applied to the data. It is recommended that reporters read the NDVI value for May 31th shortly after the campaign expiration on June 10th, as this timing makes the May 31th value less likely to change. Additionally, it is advisable to record a video of your value reading from the chart as proof should your reported value be disputed later.
Reporting information summary
Below table summarizes the key information required for reporting. The mentioned contract addresses can be found in the official DIVA Tellor oracle adapter docs on Github.
Network | Polygon |
| |
Tellor contract address (old version) | |
DIVA Tellor adapter contract | |
|
|
|
|
Questions?
Reach out to us on:
Last updated