Morpho Blue Oracles are contracts that can be used as oracles for markets on Morpho Blue. The oracles implement the IOracle interface defined in IOracle.sol: they return the price of 1 asset of collateral token quoted in 1 asset of loan token.

The MorphoChainlinkOracleV2 is an oracle that uses Chainlink-interface-compliant feeds to provide price data.

This oracle handles the following cases among others (let's say that our pair is A/B):

• A/B is a feed (typically, stETH/ETH).
• B/A is a feed (typically, ETH/USDC).
• A/C and B/C are feeds (typically, stETH/ETH and USDC/ETH).
• A/C, C/D and B/D are feeds (typically, WBTC/BTC, BTC/USD, USDC/USD).
• A/D, and B/C, C/D are feeds (typically, USDC/USD, WBTC/BTC, BTC/USD).
• A/C, C/D and B/E, E/D are feeds.
• A/C and C/B are feeds (typically, WBTC/BTC and BTC/ETH).
• A'/C and B/C are feeds, and there is an exchange rate between A and A'. (typically A=sDAI and A'=DAI).

A specific implementation, the WstEthStEthExchangeRateChainlinkAdapter, provides the exchange rate between wstETH and stETH as a Chainlink-interface-compliant feed.

This adapter is deployed on Ethereum Mainnet at the address 0x905b7dAbCD3Ce6B792D874e303D336424Cdb1421.

The MorphoChainlinkOracleV2Factory is a factory that deploys MorphoChainlinkOracleV2 instances.

The factory facilitates the creation and indexing of MorphoChainlinkOracleV2 oracles. This factory contract streamlines the process of deploying new oracles, catering to various market pairs without the need to deploy individual contracts manually for each pair.

The Ethereum Mainnet address of this factory is 0x3A7bB36Ee3f3eE32A60e9f2b33c1e5f2E83ad766.

To create a new MorphoChainlinkOracleV2 oracle using the factory, call the createMorphoChainlinkOracleV2 function with the following parameters:

• baseVault: The ERC4626 token vault for the base asset.
• baseVaultConversionSample: A sample amount for converting base vault units.
• baseFeed1, baseFeed2: Chainlink-interface-compliant data feeds for the base asset.
• baseTokenDecimals: Decimal precision of the base asset.
• quoteVault: The ERC4626 token vault for the quote asset.
• quoteVaultConversionSample: A sample amount for converting quote vault units.
• quoteFeed1, quoteFeed2: Chainlink-interface-compliant data feeds for the quote asset.
• quoteTokenDecimals: Decimal precision of the quote asset.
• salt: A unique identifier to create deterministic addresses for deployed oracles.

To deploy a MorphoChainlinkOracleV2 on the Ethereum mainnet, use the MorphoChainlinkOracleV2Factory to create a new oracle.

Below are the arguments to fill for the creation of the WETH/USDT oracle:

"baseVault": "0x0000000000000000000000000000000000000000",
"baseVaultConversionSample": 1,
"baseFeed1": "0x0000000000000000000000000000000000000000",
"baseFeed2": "0x0000000000000000000000000000000000000000",
"baseTokenDecimals": 18,
"quoteVault":"0x0000000000000000000000000000000000000000",
"quoteVaultConversionSample": 1,
"quoteFeed1": "0xEe9F2375b4bdF6387aa8265dD4FB8F16512A1d46",
"quoteFeed2": "0x0000000000000000000000000000000000000000",
"quoteTokenDecimals": 6,
"salt": "<user-defined value used to make the address unique>",

and for the sDAI/USDC oracle:

"baseVault": "0x83F20F44975D03b1b09e64809B757c47f942BEeA",
"baseVaultConversionSample": 1000000000000000000,
"baseFeed1": "0xAed0c38402a5d19df6E4c03F4E2DceD6e29c1ee9",
"baseFeed2": "0x0000000000000000000000000000000000000000",
"baseTokenDecimals": 18,
"quoteVault": "0x0000000000000000000000000000000000000000",
"quoteVaultConversionSample": 1,
"quoteFeed1": "0x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f6",
"quoteFeed2": "0x0000000000000000000000000000000000000000",
"quoteTokenDecimals": 6,
"salt": "<user-defined value used to make the address unique>",

and for the wstETH/ETH oracle:

"baseVault": "0x0000000000000000000000000000000000000000",
"baseVaultConversionSample": 1,
"baseFeed1": "0x905b7dAbCD3Ce6B792D874e303D336424Cdb1421",
"baseFeed2": "0x86392dC19c0b719886221c78AB11eb8Cf5c52812",
"baseTokenDecimals": 18,
"quoteVault": "0x0000000000000000000000000000000000000000",
"quoteVaultConversionSample": 1,
"quoteFeed1": "0x0000000000000000000000000000000000000000",
"quoteFeed2": "0x0000000000000000000000000000000000000000",
"quoteTokenDecimals": 18,
"salt": "<user-defined value used to make the address unique>",

Install dependencies: forge install

In a .env file, set ETH_RPC_URL to the URL of an Ethereum provider.

Run test: forge test

All audits are stored in the audits' folder.

Morpho Blue Oracles are licensed under GPL-2.0-or-later, see LICENSE.