How-to guide
Step-by-step guide on using the DIA Oracle Builder. Learn how to select price feeds, choose calculation methodologies, deploy on your desired network, and more.
This section provides a detailed guide on the deployment process of the product. The process includes selecting price feeds, determining the methodology for price calculation, choosing a network, determining update triggers, and finally deploying the oracle.
1. Selecting Price Feeds
Asset Selection:
Search and add cryptocurrency price feeds to the oracle.
These feeds return values in USD.
Maximum limit: 10 price feeds per oracle.
Search using token symbol (e.g., ETH, BTC) or asset’s address.
Tokens appearing in multiple chains show the network in parenthesis next to the symbol.
Methodology Selection
Choose your desired methodology for price calculation:
Moving Average Price with Interquartile Filter (MAIR): Read more about the filter here.
Volume Weighted Average Price with Interquartile Filter (VWAPIR): Read more about the filter here.
Note: Both methodologies come with outlier filtering by default. Outlier filtering is most effective with a large number of trades. Read more about the filtering methodology here.
Sources Selection
Choose the data sources to compose your feed.
Opt for entire exchanges or, for more precision, select specific asset pairs within exchanges using their dropdown menus.
Recommendation: Favor assets with a broader source range and significant trade volumes.
2. Selecting Network
Choose the desired network for oracle deployment. It's possible to deploy any price feed on any available network, irrespective of where the asset is traded. Available networks:
Ethereum Goerli
Arbitrum Goerli
Polygon Mumbai
Upcoming: New networks will be added based on demand and integration availability.
3. Selecting Update Triggers
Define how the oracle will push updated price information on-chain. Options:
Time-based: Updates pushed at a set time interval (seconds, minutes, hours). Max: 24 hours; minimum 120 seconds.
Time + deviation-based: As above, but also oracle updates if an asset’s price varies by a set percentage from the last reported value.
4. Deployment Process
Deployment is a 3-step process:
Oracle Deployment:
The oracle smart contract is created individually, each having unique public and private keys.
Oracle's address is shown in the same window.
This step requires gas tokens.
Address Verification:
Confirms the deploying user’s identity and their rights to manage the oracle.
Ongoing verification for maximum security.
Does not require gas tokens.
Ownership Assignment:
Grants the verified user permission to update the oracle.
Done only once, when the oracle is first created.
Requires gas tokens.
Last updated