Skip to main content

​
How It Works

​
Request Creation

A request is made from the source chain for an asset symbol whose price is required (e.g. ETH/USD) which then passes through the chain’s mailbox to be then delivered to the destination chain. You can check the available contract address on testnet based on the destination chain you’re reading from here. The request body is formatted as follows in JavaScript: 
const key = "ETH/USD"; // Assuming key is an address or a bytes32 value

const requestBody = abiCoder.encode(
  ["string"], // Types of the parameters
  [key] // Values to encode
);
And this is how it is formatted in Solidity: 
bytes memory requestBody = abi.encode("WBTC/USD");

​
Message Delivery Process

Once a request is created, it is transmitted to the Hyperlane mailbox. The message is then relayed to the OracleRequestRecipient contract , where the price data is fetched from the Oracle Metadata Contract.

​
Response and Callback

Upon receiving the request, the DIA chain initiates a transaction to deliver the message back to the end contract on the source chain. The recipient contract on the source chain must implement the IMessageRecipient interface, which includes a handle function that will receive the price quotation.

​
Making a Price Request

​
Solidity

// SPDX-License-Identifier: MIT
pragma solidity 0.8.29;

import { RequestOracle } from "@dia-data/contracts-spectra/RequestOracle.sol";

contract PullOracleSample {
    address public constant DIA_RECIPIENT = 0x9bb71344Ed950F9cFD85EE1C7258553B01d95FA0; // DIA testnet
    uint32 public constant DESTINATION_DOMAIN = 100640; // DIA testnet chain id

    RequestOracle public diaOracle;
    string public key = "BTC/USD";

    constructor(address _requestOracle) {
        diaOracle = RequestOracle(payable(_requestOracle));
    }

    /*
    * To calculate the request fee on each chain, you can check the script below:
    * https://github.com/diadata-org/Spectra-interoperability/blob/main/contracts/scripts/sendTestMessage.mjs#L111
    */
    function requestPrice(string memory key) external payable {
        diaOracle.request{value: msg.value}(
            DIA_RECIPIENT,
            DESTINATION_DOMAIN,
            abi.encode(key)
        );
    }

    function getPrice()
    external
    view
    returns (
        uint128 timestampOflatestPrice,
        uint128 latestPrice
    ) {
        (timestampOflatestPrice, latestPrice) =
                 diaOracle.updates(key);
    }
}

​
JavaScript

In this example, we’ll be sending an ETH/USD price request from Base Sepolia to DIA Lasernet. Start by cloning the Spectra Interoperability repository to your local machine and switching to the deploybranch:

GitHub - diadata-org/Spectra-interoperability

 
git clone https://github.com/diadata-org/Spectra-interoperability.git
git checkout deploy
Then install the node packages and compile the contracts using hardhat: 
npm install
npx hardhat compile
Next, cd contracts folder, and export your wallet’s private key in your terminal as follows: 
export PRIVATE_KEY=[paste_here]
Now, the sendMessage.mjs script will trigger a request transaction to fetch the latest price of ETH/USD from DIA lasernet. To run the script: 
npx hardhat run scripts/sendMessage.mjs --network base_sepolia
You can also run the script on other networks by changing the value passed to the --network flag (e.g. --network sepolia). Once the price update takes place on the destination chain, which you can track from the hyperlane explorer, you can check the txn logs for the ReceivedMessageevent on the pull oracle contract or call the updatesfunction.
The price returned is around 2,718$!
⌘I