How-to Guides
Fund the Oracle
Oracles require a constant stream of updates, thus gas costs reimbursement for updates is needed. To achieve this, all oracles deployed by DIA have a dedicated wallet which calls oracle contracts for updates. This is referred to as the “gas wallet”.
How it works
Each oracle deployed by DIA has a gas wallet, which is the only entity capable of calling for an oracle update. The wallet initiates the transaction to import a new value into the oracle smart contract, based on the data feed’s update parameters (that have been previously configured). For the gas wallet to perform new oracle contract updates, it must have a sufficient balance of the blockchain’s native token to cover the transaction’s gas costs. The gas wallet can be funded with a one-time lump sum, allowing it to keep updating for a while. However, monitoring the gas wallet’s balance is necessary to ensure continuity in the oracle’s operations. DIA has set up internal gas wallet balance trackers. We recommend protocols to actively monitor them to ensure that the wallet balance remains sufficient for pushing new oracle updates.Estimate Updates Count for Oracles
DIA has a dedicated endpoint for asset historical updates count to help you estimate the number of oracle updates. This allows to foresee potential gas costs that would be required for running the oracle.Get historical Oracle updates count
GET https://api.diadata.org/v1/assetUpdates/:blockchain/:address/:deviation/:updateFreq
The endpoint returns information on the asset deviation and updates count if it was used in the oracle. It takes price change (deviation) and oracle’s ticker frequency as the main parameters to determine estimated updates count based on historical data.
Example: https://api.diadata.org/v1/assetUpdates/Ethereum/0x0000000000000000000000000000000000000000/20/120
By default it will return data for the last 24h but you can configure the timeframe with starttime and endtime parameters. See example below: https://api.diadata.org/v1/assetUpdates/Ethereum/0x0000000000000000000000000000000000000000/20/120?starttime=1661736336&endtime=1661761536
Path Parameters
| Name | Type | Description |
|---|---|---|
| blockchain* | String | A valid blockchain from GET /v1/blockchains, e.g., Bitcoin. |
| address* | String | A valid asset address from GET /v1/token/:symbol, e.g., 0x000000000000000000000000000000000000000 for BTC. |
| deviation* | Integer | Deviation measure in per mille, e.g. 20 will result in 2% deviation |
| updateFreq* | Integer | Oracle’s price feed ticker frequency in seconds, e.g. 120 will calculate asset price in 2 minute trade blocks |
| starttime | Integer | Unix timestamp setting the start of the return array |
| endtime | Integer | Unix timestamp setting the end of the return array |