Resilient Price Oracle

Overview

In its previous version, Venus was fully reliant on the Chainlink price oracle for fetching prices. This dependence, while generally reliable, created a single point of failure. An erroneous or stale price could, without a secondary mechanism for validation, pose threats such as unwarranted liquidations or inflated borrowing.

In light of these risks, Venus V4 introduces the Resilient Price Oracle, a more robust system capable of pulling data from multiple sources for cross-validation. The Resilient Oracle is equipped with an algorithm to verify prices between two or more sources, providing a safeguard in cases where the primary source proves unreliable or fails.

Furthermore, the improved oracle infrastructure supports the integration of new price oracles in real-time and permits the enabling and disabling of price oracles per token.

Key Features

Resilient Price Feeds

The Resilient Price Feeds replace the single source price provider used in the Comptroller contract with a more robust and reliable solution. This new component not only fetches asset prices from various on-chain sources but also includes a fallback mechanism to protect the protocol from oracle failures. Presently, this feature incorporates Chainlink, RedStone, Pyth Network and Binance oracles, with the possibility of adding more in the future.

Governance Configurations

The Resilient Price Feeds system can be configured by the Venus governance via Venus Improvement Proposals (VIPs). These configurations include pause and resume functionalities for the oracle, price feed configurations, and fixed price settings, among others.

Safety Measures

In implementing the Resilient Price Oracle, several safety measures have been adopted to ensure the security and continuity of the Venus Protocol:

  • Price Continuity: Asset prices pre and post upgrade were validated in a simulated environment to ensure consistency.

  • Testnet Deployment: The oracles have been deployed and tested in the Venus Protocol testnet environment.

  • Auditing: The code has been audited by OpenZeppelin, Peckshield, Certik, and Hacken.

Correlated Token Oracles

For correlated tokens, like Liquid Staked Tokens (LST), best practice suggests oracles quote first smart contracts to get the exchange rate between the correlated assets, and then multiply that by the USD market price of the second token to complete the calculation.

In Venus we use dedicated oracles for each LST asset in order to calculate the price as follows:

  • convert the LST to the underlying tokens (using the exchange rate provided by the LST contracts)

  • convert the underlying token calculated in the previous step to USD, using a “traditional” oracle based on market price

The current list of correlated token oracles in Venus is:

  • AnkrBNBOracle. It returns the USD price of the ankrBNB token, converting on-chain from ankrBNB to BNB using the exchange rate from the ankrBNB contract.

  • BNBxOracle. It returns the USD price of the BNBx token, converting on-chain from BNBx to BNB using the exchange rate from the stake manager contract.

  • PendleOracle. It returns the USD price of the PT Pendle token, converting on-chain from the PT token to the underlying token using a Pendle market contract.

  • SFraxOracle. It returns the USD price of the sFRAX token, converting on-chain from sFRAX to FRAX using the exchange rate from the sFRAX contract.

  • SlisBNBOracle. It returns the USD price of the slisBNB token, converting on-chain from slisBNB to BNB using the exchange rate from the stake manager contract.

  • StkBNBOracle. It returns the USD price of the stkBNB token, converting on-chain from stkBNB to BNB using the exchange rate from the stake pool contract.

  • WBETHOracle. It returns the USD price of the WBETH token, converting on-chain from WBETH to BNB using the exchange rate from the WBETH contract.

  • WeETHOracle. It returns the USD price of the weETH token, converting on-chain from weETH to eETH using the exchange rate from the liquidity pool contract, and assumming 1 eETH = 1 ETH.

  • WstETHOracle. It returns the USD price of the wstETH token, converting on-chain from wstETH to stETH using the exchange rate from the stETH contract, and assumming 1 stETH = 1 ETH.

Assumption on Liquid Staked Tokens

WeETHOracle and WstETHOracle assume a 1:1 price ratio between the LST and the underlying asset (e.g. 1 ETH = 1 stETH). The primary risks associated with this approach involve smart contract vulnerabilities and counterparty risks that could impact the redemption processes of the LSTs. In cases of substantial counterparty risk, particularly if the underlying tokens are not redeemable against the LSTs, the direct smart contract pricing might become unreliable. Here's our plan to mitigate such situations:

  • We will deploy two on-chain oracles for each LST token:

    • The first oracle will return the price based on the assumption of a 1:1 ratio between the LST token and the underlying asset.

    • The second oracle will return the price based on a secondary market feed (using Chainlink, for instance).

  • By default, the ResilientOracle will be configured to use only the oracle assuming a 1:1 ratio between the LST asset and the underlying, serving as the primary oracle.

  • The second oracle, which derives price from the market price feed without assuming a 1:1 ratio, will not be initially configured in our ResilientOracle.

  • We have implemented an off-chain monitoring system to track the prices returned by both oracles. In the event of a significant deviation over an extended period, the situation will be reviewed. It will be determined whether to switch the primary oracle from the one assuming a 1:1 ratio to the one that does not, or whether to temporarily include the latter as a pivot oracle in the ResilientOracle configuration.

Current configuration

BNB chain

PoolMarketMAIN oraclePIVOT oracleFALLBACK oracleNotes

Core

AAVE

-

-

Core

ADA

-

-

Core

BCH

-

-

Core

BETH

-

-

Core

BNB

Upper bound: 1.01. Lower bound: 0.99

Core

BTCB

Upper bound: 1.01. Lower bound: 0.99

Core

BUSD

-

-

Core

CAKE

-

-

Core

DAI

-

-

Core

DOGE

-

-

Core

DOT

-

-

Core

ETH

-

-

Core

FDUSD

-

-

Core

FIL

-

-

Core

LINK

-

-

Core

LTC

-

-

Core

LUNA

-

-

Core

MATIC

-

-

Core

SXP

-

-

Core

TRX

-

Upper bound: 1.01. Lower bound: 0.99

Core

TRXOLD

-

Upper bound: 1.01. Lower bound: 0.99

Core

TUSD

-

-

Core

TUSDOLD

-

-

Core

UNI

-

-

Core

USDC

-

-

Core

USDT

-

-

Core

UST

-

-

Core

VAI

-

-

Core

WBETH

-

-

Core

XRP

-

-

Core

XVS

-

-

Stablecoins

lisUSD

-

-

Stablecoins

USDD

-

-

Stablecoins

USDT

-

-

Stablecoins

EURA

-

-

DeFi

BSW

-

-

DeFi

ALPACA

-

-

DeFi

USDT

-

-

DeFi

USDD

-

-

DeFi

ANKR

-

-

DeFi

ankrBNB

-

-

DeFi

TWT

-

-

DeFi

PLANET

-

-

GameFi

RACA

-

-

GameFi

FLOKI

-

-

GameFi

USDD

-

-

GameFi

USDT

-

-

Liquid Staked BNB

ankrBNB

-

Liquid Staked BNB

BNBx

-

-

Liquid Staked BNB

stkBNB

-

Liquid Staked BNB

slisBNB

-

-

Liquid Staked BNB

WBNB

-

-

Meme

BabyDoge

-

-

Meme

USDT

-

-

Tron

BTT

-

-

Tron

TRX

-

-

Tron

WIN

-

-

Tron

USDD

-

-

Tron

USDT

-

-

Ethereum

PoolMarketMAIN oraclePIVOT oracleFALLBACK oracleNotes

Core

crvUSD

-

-

Core

DAI

-

-

Core

TUSD

-

-

Core

USDC

-

-

Core

USDT

-

-

Core

WBTC

-

-

Core

WETH

-

-

Core

FRAX

-

-

Core

sFRAX

-

-

Curve

crvUSD

-

-

Curve

CRV

-

-

Liquid Staked ETH

PTweETH-26DEC2024

-

-

Liquid Staked ETH

rsETH

Upper bound: 1.01. Lower bound: 0.99

Liquid Staked ETH

WETH

-

-

Liquid Staked ETH

wstETH

-

-

Assume 1:1 for ETH:stETH

Liquid Staked ETH

weETH

-

-

Assume 1:1 for ETH:eETH

opBNB mainnet

PoolMarketMAIN oraclePIVOT oracleFALLBACK oracleNotes

Core

BTCB

-

-

Core

ETH

-

-

Core

FDUSD

-

-

Core

USDT

-

-

Core

WBNB

-

-

Arbitrum One

PoolMarketMAIN oraclePIVOT oracleFALLBACK oracleNotes

Core

WBTC

-

-

Core

WETH

-

-

Core

USDC

-

-

Core

USDT

-

-

Core

ARB

-

-

Further Reading

For more detailed information, refer to the following resources:

Audit reports

References

Last updated