TAI
  • How does TAI work?
    • Overview
    • Supported Collaterals
    • Liquidations and Auctions
    • Tokenomics
    • Governance
      • Goverance Process
      • Governance Parameters
    • Rewards
    • Audits
  • TAI Protocol: In-depth
    • Contracts
      • System Contracts
        • Core Module
          • SAFE Engine
          • Liquidation Engine
          • Accounting Engine
        • Auction Module
          • Increasing Discount Collateral Auction House
          • Debt Auction House
          • Surplus Auction House
        • Oracle Module
          • Oracle Relayer
          • Medianizer
            • DSValue
            • Governance Led Median
            • Chainlink Median
          • FSM
            • Oracle Security Module
        • Token Module
          • Token Adapters
          • System Coin: TAI
          • Protocol Token: RATE
          • Protocol Token Authority
        • Money Market Module
          • Tax Collector
        • Sustainability Module
          • Stability Fee Treasury
          • FSM Wrapper
          • Increasing Treasury Reimbursement
          • Mandatory Fixed Treasury Reimbursement
        • Automation Module
          • Collateral Auction Throttler
          • Single Spot Debt Ceiling Setter
          • ESM Threshold Setter
        • Governance Module
          • DSPause
        • Shutdown Module
          • Global Settlement
          • ESM
      • Proxy Infrastructure
        • DSProxy
        • Proxy Registry
      • Helper Contracts
        • SAFE Manager
      • Contract Addresses
    • Data APIs
      • API Endpoints
Powered by GitBook
On this page
  • 1. Summary
  • 2. Contract Variables & Functions
  • 3. Walkthrough
  • 4. Gotchas
  • 5. Failure Modes (Bounds on Operating Conditions & External Risk Factors)
  1. TAI Protocol: In-depth
  2. Contracts
  3. System Contracts
  4. Oracle Module
  5. Medianizer

Chainlink Median

Chainlink integrated medianizer

PreviousGovernance Led MedianNextFSM

Last updated 1 year ago

1. Summary

The ChainlinkPriceFeedMedianizer has a similar interface to the although, instead of relying on governance whitelisted oracles, it simply keeps a reference to a (price aggregator).

2. Contract Variables & Functions

Variables

  • authorizedAccounts [usr: address] - addAuthorization/removeAuthorization/isAuthorized - auth mechanisms

  • staleThreshold - time since linkAggregatorTimestamp after which the median value is considered stale

  • chainlinkAggregator - address of the Chainlink price reference contract

  • rewardRelayer - address of the contract that rewards addresses that call updateResult

  • medianPrice - latest fetched price

  • lastUpdateTime - latest timestamp when the contract pulled a price update from Chainlink

  • multiplier - scaling factor for the Chainlink result (e.g if the price has 8 decimals and we want it to be scaled to 18 decimals, multiplier = 10 and medianPrice = fetchedPrice * 10 ^ multiplier)

  • symbol - the price oracle type (ex: ETHUSD)

  • periodSize - the minimum delay between two consecutive updates after which the reward for updating again starts to increase

  • linkAggregatorTimestamp - the timestamp of the Chainlink aggregator's latest price update

Modifiers

  • isAuthorized **** - checks whether an address is part of authorizedAddresses (and thus can call authed functions).

Functions

  • modifyParameters - allows governance to change contract parameters

  • read() public view returns (uint256) - gets a non-zero price or fails

  • getResultWithValidity() public view returns (uint256,bool) - gets the price and its validity

  • updateResult(feeReceiver: address) - updates the price stored in the contract by calling the Chainlink aggregator

Events

  • AddAuthorization - emitted when a new address becomes authorized. Contains:

    • account - the new authorized account

  • RemoveAuthorization - emitted when an address is de-authorized. Contains:

    • account - the address that was de-authorized

  • ModifyParameters **** - emitted when a parameter is updated

  • UpdateResult - emitted when updateResult is called. Contains:

    • medianPrice - the latest median price

    • lastUpdateTime - timestamp of the call

3. Walkthrough

When reading the latest price feed, the contract also stores the timestamp when the price coming from Chainlink was posted on-chain. The system can incentivize anyone to call updateResult and update the median price regularly using a rewardRelayer.

4. Gotchas

This oracle is entirely dependent on Chainlink. If the Chainlink relayer contract is deprecated the Oracle needs to be updated accordingly.

5. Failure Modes (Bounds on Operating Conditions & External Risk Factors)

If the Chainlink contract is not updated the price will become stale, other contracts reading from it will revert on state changing transactions, effectively freezing the system.

If the price reported by Chainlink is wrong the system will take it as it is, possibily causing unfair liquidations, or preventing liquidations in case of higher prices reported.

Governance Led Median
Chainlink price reference contract