Oracle
Abstract
This specification specifies the oracle module, which is primarily used by the exchange
modules to obtain external price data.
Workflow
New price feed providers must first obtain oracle privileges through a governance proposal which grants privileges to a list of relayers. The exception to this is for the Coinbase price oracle, as anyone can send Coinbase price updates since they are already exclusively signed by the Coinbase oracle private key. Example Grant Proposals:
GrantBandOraclePrivilegeProposal
,GrantPriceFeederPrivilegeProposal
Once the governance proposal is approved, the specified relayers can publish oracle data by sending relay messages specific to their oracle type. Example Relay Messages:
MsgRelayBandRates
,MsgRelayPriceFeedPrice
,MsgRelayCoinbaseMessages
etcUpon receiving the relay message, the oracle module checks if the relayer account has grant privileges and persists the latest price data in the state.
Other Cosmos-SDK modules can then fetch the latest price data for a specific provider by querying the oracle module.
Note: In case of any discrepancy, the price feed privileges can be revoked through governance
Example Revoke Proposals: RevokeBandOraclePrivilegeProposal
, RevokePriceFeederPrivilegeProposal
etc
Band IBC integration flow
Cosmos SDK blockchains are able to interact with each other using IBC and Injective support the feature to fetch price feed from bandchain via IBC.
To communicate with BandChain's oracle using IBC, Injective Chain must first initialize a communication channel with the oracle module on the BandChain using relayers.
Once the connection has been established, a pair of channel identifiers is generated -- one for the Injective Chain and one for Band. The channel identifier is used by Injective Chain to route outgoing oracle request packets to Band. Similarly, Band's oracle module uses the channel identifier when sending back the oracle response.
To enable band IBC integration after setting up communication channel, the governance proposal for
EnableBandIBCProposal
should pass.And then, the list of prices to be fetched via IBC should be determined by
AuthorizeBandOracleRequestProposal
andUpdateBandOracleRequestProposal
.Once BandIBC is enabled, chain periodically sends price request IBC packets (
OracleRequestPacketData
) to bandchain and bandchain responds with the price via IBC packet (OracleResponsePacketData
). Band chain is providing prices when there are threshold number of data providers confirm and it takes time to get the price after sending requests. To request price before the configured interval, any user can broadcastMsgRequestBandIBCRates
message which is instantly executed.
Contents
Last updated