The "source of truth" for collateral and system coin prices
Relevant smart contracts:
The Oracle Module is in charge with ingesting and pushing price feed updates into the system. It has three core components: a medianizer that pulls a price feed for an asset, an
FSM(Feed Security Module) that introduces a delay to prices coming from the medianizer and an
OracleRelayerthat divides the price data by the
redemptionPriceand then divides the result again by the collateralization ratio (of the asset whose price is submitted) before pushing the final output in the
SAFEEngine. The module may also be used to provide price feed data for the system's feedback mechanism or other contracts meant to autonomously set system parameters.
DSValueis a simplified version of a medianizer. It is used for testing the oracle infrastructure. The contract creator can specify which addresses are allowed to update the price feed inside the contract.
OSM(named via acronym from Oracle Security Module) ensures that new price values propagated from the medianizers are not taken up by the system until a specified delay has passed.
DSM(named via acronym from Dampened Security Module) is an
OSM-like contract that limits the maximum price change between two consecutive price feed updates.
FsmGovernanceInterfaceis an abstraction meant to help governance
OracleRelayeris the glue between the
OSMand the core system (
SAFEEngine). It divides every price feed by the latest
redemptionPriceand then divides the output again by the collateralization ratio before saving the final result. The relayer will, in fact, store two different prices for each collateral type: a
safetyPriceused only when SAFE users want to generate debt and a
liquidationPriceused when someone calls
LiquidationEngine.liquidateSAFE. The relayer is also in charge with storing the
redemptionPriceand updating it using the
ChainlinkPriceFeedMedianizerprovide fresh price feeds for every token used in the system. The major difference between the two is that the governance led version maintains a whitelist of price feed contracts which are authorized (and incentivized) by token holders to push prices into the system whereas the Chainlink version does not depend on GEB's governance to function properly (apart from instances where token holders need to point to an upgraded version of the Chainlink aggregator).
UniswapConsecutiveSlotsPriceFeedMedianizeris a TWAP leveraging the Uniswap v2 infrastructure in order to provide a price feed. It needs to be connected to a separate oracle that can help translate the TWAP result into another currency (e.g USD, EUR etc).
OracleRelayer- A bug would most likely result in the collateral prices not being updated anymore or in the
redemptionPricebeing set to an unusually high or low value.
GovernanceLedPriceFeedMedianizer- there is no way to prevent a majority of the oracles to come together and sign a price of zero. This would result in the price being invalid and would return false on
ChainlinkPriceFeedMedianizer- governance may need to change the aggregator address in case there is an upgrade on the Chainlink infrastructure. Failure to do so will result in the price feed not being updated anymore and the need for settlement in case a solution is not found in a short period of time.
OSM- governance can change the
priceSourceaddress to a malicious contract or to a source that does not adhere to the correct interface (that should otherwise contain
getResultWithValidity). Governance may also call
DSM- can suffer from the same attacks as the
FsmGovernanceInterface- governance can maliciously stop one or more
UniswapConsecutiveSlotsPriceFeedMedianizer- governance can set a converterFeed (oracle that translates the TWAP result in another currency) to a malicious contract. Governance can also set
maxWindowSizeto an extremely large value and thus allow the TWAP to be excessively laggy.
In the long run, governance can completely remove control over the
OracleRelayer, provided that three conditions are met:
- 1.Governance does not plan to add any more collateral types in the future.
- 2.The team that deployed the system thoroughly tested its feedback mechanism, both in simulated and in live environments.
OracleRelayeris in the Level 1 Gov Minimization category.