Chainlink Relayer instantly relays Chainlink price feeds on Ethereum to IoTeX network, for enabling dApps where price feeds are needed
  • The prices are relayed to a contract (called shadow aggregator) on IoTeX which has exactly the same interface as Chainlink’s aggregator, and it makes dApps to migrate to use Chainlink effortlessly once their integration with IoTeX is done.
  • The client waits for 20 blocks (around 5 minutes) to confirm a transaction.
  • Anyone can run a relayer to relay the information. So it is permissionless!

​
Shadow Aggregators

For each aggregator on Ethereum, IoTeX provides a shadow aggregator on IoTeX.

​
IoTeX Testnet

The table below lists the shadow aggregators deployed on IoTeX testnet:
PairDecAggregatorShadow Aggregator
BTC/USD80xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c0xc4A29a94f12be03033daa4e6Ce9b9678c26275a2
ETH/USD80x5f4eC3Df9cbd43714FE2740f5E3616155c5b84190x107DF34D3B2F471eEff880956957e5068A987b81
BUSD/USD80x833D8Eb16D306ed1FbB5D7A2E019e106B960965A0x8A6A4407c77F1e04C39bAd8C089D639cbda40Df5
USDC/USD80x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f60xB1aa8c29d96720A80AFe9e3F6CD48822D27C8d54
USDT/USD80x3E7d1eAB13ad0104d2750B8863b489D65364e32D0x63Bd61A642d1f3dbf1f47006AC03CD7e7eb72f63
DAI/USD80xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee90x9673b1b3fbB96E24f1C1AB40421Db9465f0f1151
IOTX/USD80x96c45535d235148Dc3ABA1E48A6E3cFB3510f4E20xf55dA02f8266eC89A58C6De361cf92ce9cee21fe

​
IoTeX Mainnet

PairDecAggregatorShadow Aggregator
BTC/USD80xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c0x631f185E832DfBC3aDfeFa37c83aA23f75d0c8c7
ETH/USD80x5f4eC3Df9cbd43714FE2740f5E3616155c5b84190x0a1886890c0633e32746bc5021E3c1EfAD2bd662
BUSD/USD80x833D8Eb16D306ed1FbB5D7A2E019e106B960965A0x071F9106A9957e530a4B48269e38640ebAfc0f34
USDC/USD80x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f60xC296E7e92B3Ce84e9bF5780a47eF231E14A4506d
USDT/USD80x3E7d1eAB13ad0104d2750B8863b489D65364e32D0xa900b5eB48F5A1122F9bfA660dd0B61Ddc56C872
DAI/USD80xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee90x95eBC95FF2b81866D7Bc1c3c1257533795CF96B7
IOTX/USD80x96c45535d235148Dc3ABA1E48A6E3cFB3510f4E20x0F7AbD6b99d5D6876C812dAc22A2c8A8A6297D90
PairDecAggregator
IOTX/USD80x267Ef702F3422cC55C617218a4fB84446F5Ec646

​
Exchange Aggregators

Exchange aggregators have the same interface as Chainlink aggregators. Prices are read from exchanges, and the average value of these prices will be fed to the exchange aggregator by permitted relayers if:
  • The value deviates by 0.5% or more from the last price, or
  • The time interval is more than 1 hour.
Exchanges used for fetching IOTX prices include Binance, Huobi, CoinGecko, KuCoin, and Coinbase.

​
Run a Relayer

​
Prepare the Config File

  1. Database URL: Fill the "databaseURL" field with the link to your database.
  2. Ethereum RPC URL: Input the Ethereum RPC URL in the "sourceClientURL" field.
  3. Relayer Private Key: Input your relayer private key. Ensure the account associated with this private key has a sufficient balance to cover transaction fees.
Your config.yaml file should look something like this: 
yamlCopia codicedatabaseURL: "your_database_link_here"
sourceClientURL: "your_ethereum_rpc_url_here"
privateKey: "your_relayer_private_key_here"

​
Start the Relayer Service

Make sure you have Go installed and properly set up on your machine. If you encounter any issues, ensure that all dependencies are installed and your configuration file paths are correct.
Run the following command to start the relayer service: 
shCopia codicego run main.go -config config.yaml