Merge pull request #126 from VenusProtocol/chore/ven-2225

[VEN-2225] RedStone oracle in the documentation

Author: 0xlucian

deployed-contracts/oracles.md

@@ -5,6 +5,7 @@
 * Binance Oracle: [`0x594810b741d136f1960141C0d8Fb4a91bE78A820`](https://bscscan.com/address/0x594810b741d136f1960141C0d8Fb4a91bE78A820)
 * Bound Validator:[`0x6E332fF0bB52475304494E4AE5063c1051c7d735`](https://bscscan.com/address/0x6E332fF0bB52475304494E4AE5063c1051c7d735)
 * Chainlink Oracle:[`0x1B2103441A0A108daD8848D8F5d790e4D402921F`](https://bscscan.com/address/0x1B2103441A0A108daD8848D8F5d790e4D402921F)
+* RedStone Oracle:[`0x8455EFA4D7Ff63b8BFD96AdD889483Ea7d39B70a`](https://bscscan.com/address/0x8455EFA4D7Ff63b8BFD96AdD889483Ea7d39B70a)
 * Pyth Oracle:[`0xb893E38162f55fb80B18Aa44da76FaDf8E9B2262`](https://bscscan.com/address/0xb893E38162f55fb80B18Aa44da76FaDf8E9B2262)
 * Resilient Oracle:[`0x6592b5DE802159F3E74B2486b091D11a8256ab8A`](https://bscscan.com/address/0x6592b5DE802159F3E74B2486b091D11a8256ab8A)
 * TWAP Oracle:[`0xea2f042e1A4f057EF8A5220e57733AD747ea8867`](https://bscscan.com/address/0xea2f042e1A4f057EF8A5220e57733AD747ea8867)
@@ -15,6 +16,7 @@
 * Binance Oracle:[`0xB58BFDCE610042311Dc0e034a80Cc7776c1D68f5`](https://testnet.bscscan.com/address/0xB58BFDCE610042311Dc0e034a80Cc7776c1D68f5)
 * Bound Validator:[`0x2842140e4Ad3a92e9af30e27e290300dd785076d`](https://testnet.bscscan.com/address/0x2842140e4Ad3a92e9af30e27e290300dd785076d)
 * Chainlink Oracle:[`0xCeA29f1266e880A1482c06eD656cD08C148BaA32`](https://testnet.bscscan.com/address/0xCeA29f1266e880A1482c06eD656cD08C148BaA32)
+* RedStone Oracle:[`0x0Af51d1504ac5B711A9EAFe2fAC11A51d32029Ad`](https://testnet.bscscan.com/address/0x0Af51d1504ac5B711A9EAFe2fAC11A51d32029Ad)
 * Pyth Oracle:[`0x94E1534c14e0736BB24decA625f2F5364B198E0C`](https://testnet.bscscan.com/address/0x94E1534c14e0736BB24decA625f2F5364B198E0C)
 * Resilient Oracle:[`0x3cD69251D04A28d887Ac14cbe2E14c52F3D57823`](https://testnet.bscscan.com/address/0x3cD69251D04A28d887Ac14cbe2E14c52F3D57823)
 * TWAP Oracle:[`0x3eeE05d929D1E9816185B1b6d8c470eC192b4432`](https://testnet.bscscan.com/address/0x3eeE05d929D1E9816185B1b6d8c470eC192b4432)

risk/resilient-price-oracle.md

@@ -12,7 +12,7 @@ Furthermore, the improved oracle infrastructure supports the integration of new
 
 #### 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, Pyth Network, Binance Oracle, and TWAP oracles, with the possibility of adding more in the future.
+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, Binance Oracle, and TWAP oracles, with the possibility of adding more in the future.
 
 #### Governance Configurations
 
@@ -38,14 +38,6 @@ For more detailed information, refer to the following resources:
 * [Certik audit report](https://github.com/VenusProtocol/oracle/blob/develop/audits/024\_oracles\_certik\_20230522.pdf)
 * [Hacken audit report](https://github.com/VenusProtocol/oracle/blob/develop/audits/016\_oracles\_hacken\_20230426.pdf)
 
-**Deployed contracts on main net:**
-
-* [ResilientOracle](https://bscscan.com/address/0x6592b5DE802159F3E74B2486b091D11a8256ab8A)
-* [ChainlinkOracle](https://bscscan.com/address/0x1B2103441A0A108daD8848D8F5d790e4D402921F)
-* [BinanceOracle](https://bscscan.com/address/0x594810b741d136f1960141C0d8Fb4a91bE78A820)
-* [PythOracle](https://bscscan.com/address/0xb893E38162f55fb80B18Aa44da76FaDf8E9B2262)
-* [TWAPOracle](https://bscscan.com/address/0xea2f042e1A4f057EF8A5220e57733AD747ea8867)
-
 **References**
 
 * [Repository](https://github.com/VenusProtocol/oracle)
@@ -54,3 +46,4 @@ For more detailed information, refer to the following resources:
 * [Community post about Venus V4, introducing Resilient Price Feeds](https://community.venus.io/t/proposing-venus-v4/3188#price-feed-redundancy-6)
 * [Venus Stars blog post about Binance Oracle](https://venusstars.io/community/index.php/2023/05/09/venus-enhances-resilience-binance-oracle-feeds/)
 * [Community discussion about Pyth Oracle](https://community.venus.io/t/vip-xx-integrate-with-pyth-as-an-oracle/2723/6)
+* [RedStone’s proposal to be added to the interface](https://community.venus.io/t/adding-redstone-oracles-to-the-venus-oracle-interface/3620)

technical-reference/contracts-overview.md

@@ -78,6 +78,10 @@ Venus Protocol implements secondary, primary and pivot oracles to create a valid
 
 [ChainLinkOracle](https://github.com/VenusProtocol/oracle/blob/main/contracts/oracles/ChainlinkOracle.sol) is the primary oracle. If a token isn't support by Chainlink then prices will be fetched from a secondary oracle.
 
+[**RedStoneOracle**](https://redstone.finance/)
+
+[RedstoneOracle](https://docs.redstone.finance/docs/smart-contract-devs/get-started/redstone-classic) is used in the Classic model (Chainlink-compatible interface) as a pivot oracle to validate prices returned by main and fallback oracles. 
+
 [**BinanceOracle**](./reference-oracle/oracles/binance-oracle.md)
 
 [BinanceOracle](https://github.com/VenusProtocol/oracle/blob/main/contracts/oracles/BinanceOracle.sol) contract is responsible for fetching token prices from the Binance oracle. It is used as a secondary oracle.

technical-reference/reference-oracle/resilient-oracle.md

@@ -6,7 +6,7 @@ reported prices. If only one oracle is used, this creates a single point of fail
 for attacking the protocol.
 
 The Resilient Oracle uses multiple sources and fallback mechanisms to provide accurate prices and protect
-the protocol from oracle attacks. Currently it includes integrations with Chainlink, Pyth, Binance Oracle
+the protocol from oracle attacks. Currently it includes integrations with Chainlink, RedStone, Pyth, Binance Oracle
 and TWAP (Time-Weighted Average Price) oracles. TWAP uses PancakeSwap as the on-chain price source.
 
 For every market (vToken) we configure the main, pivot and fallback oracles. The oracles are configured per 
@@ -25,9 +25,9 @@ anchorRatio = anchorPrice/reporterPrice
 isValid = anchorRatio <= upperBoundAnchorRatio && anchorRatio >= lowerBoundAnchorRatio
 ```
 
-In most cases, Chainlink is used as the main oracle, TWAP or Pyth oracles are used as the pivot oracle depending
+In most cases, Chainlink is used as the main oracle, RedStone, TWAP or Pyth oracles are used as the pivot oracle depending
 on which supports the given market and Binance oracle is used as the fallback oracle. For some markets we may
-use Pyth or TWAP as the main oracle if the token price is not supported by Chainlink or Binance oracles. 
+use RedStone, Pyth or TWAP as the main oracle if the token price is not supported by Chainlink or Binance oracles. 
 
 For a fetched price to be valid it must be positive and not stagnant. If the price is invalid then we consider the
 oracle to be stagnant and treat it like it's disabled.