Use Oracle Builder

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.

Oracle builder is currently in development phase and not accessible for use.

Deployment Process

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.

• Important Notices:

  • Be cautious of tokens with limited sources or low trade volumes.

  • Tokens not trading via DIA’s integrated sources are ineligible for selection. Get in touch us with via Telegram or Discord to request a new source integration.

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 Sepolia

• Arbitrum Sepolia

• Polygon Amoy

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.

Manage Dashboard

The Manage dashboard allows for oracle monitoring, maintaining, editing and gas topping up. From last update times to gas levels, all crucial information is in this dashboard.

Using the tree-dot menu for each oracle, users can:

• Updates history: View the oracle’s historical transactions, including the updated price feed, transaction cost, transaction hash and more.

• Pause or Restart the oracle.

• See all assets: view a list of all asset price feeds that the oracle includes.

• Edit Oracle Settings: Update configurations, except the target network.

• Delete Oracle: Remove an oracle permanently. Gas tokens are returned to the connected wallet before deletion if sufficient funds are available.

• Telegram notifications: By adding user oracles to the Telegram bot, users can receive real-time notifications such as low gas balance. (available soon)

Gas Funding

General information

To push updates on-chain, the oracle uses gas tokens of the network it’s deployed on. Each oracle has its own separate gas wallet. Important distinctions:

• Oracle address ≠ Oracle's gas wallet address.

• You can add funds during deployment or later via the management dashboard.

• Funds can be withdrawn upon deleting the oracle.

Wallet Selection

Top up the oracle gas wallet in two ways:

• Connected Wallet: Using the Oracle Builder interface, transfer tokens from the wallet connected to the Oracle Builder to the oracle’s gas wallet.

• Different Wallet: Transfer funds manually to the oracle’s gas wallet. This is ideal for team-based scenarios.

Important: Ensure correct gas wallet address and gas tokens to avoid losing funds.

Request Flow

While we offer an extensive library of assets and support for multiple networks, we understand the need for continuous expansion. Here's how you can request the integration of new assets or blockchain networks into the DIA Oracle Builder.

Requesting New Assets

If there's a specific asset you'd like to see added to the DIA library for use in the DIA Oracle Builder, please follow these steps:

1. Asset Details: Prepare a brief document detailing the asset's name, its significance, its current market presence, and any other relevant information.

2. Exchange where is traded: Add a list of the CEXs and DEXs where the asset is traded, including the asset pairs, if possible.

3. Use case: Explain for which type of use case you would build using the price oracle.

4. Contact Us: Reach out to the DIA team via our Telegram channel. Share the prepared details and await our response.

Requesting Support for New Networks

For those seeking integration of new layer-1 or layer-2 networks into the DIA Oracle Builder, here's how to proceed:

1. Network Details: Compile information about the network, including its name, its unique features, its user base, and any other pertinent data.

2. Integration Benefits: Describe the advantages and potential use cases that would arise from the DIA Oracle Builder supporting this network.

3. Contact Us: Connect with the DIA team on our Telegram channel. Provide the gathered information and wait for our feedback.

Supported Networks

The DIA Oracle Builder currently supports the following testnet networks:

• Ethereum Sepolia

• Arbitrum Sepolia

• Polygon Amoy

If you're seeking support for a network not listed above, please follow the request flow to get in touch with us.