AaveOracle#
Contract to get asset prices and manage price sources.
The source code is available on GitHub.
Write Methods#
setAssetSources#
function setAssetSources(address[] calldata assets, address[] calldata sources) external override onlyAssetListingOrPoolAdminsSets the price sources for given list of assets.
POOL_ADMIN or ASSET_LISTING_ADMIN.
Please look at the ACLManager contract for further details
on system roles.Input Parameters:#
| Name | Type | Description |
|---|---|---|
| assets | address[] | The addresses of the assets for which source is being set |
| sources | address[] | The address of the source of each asset. Length of assets and sources array should be same |
setFallbackOracle#
function setFallbackOracle(address fallbackOracle) external override onlyAssetListingOrPoolAdminsSets/updates the fallbackOracle.
POOL_ADMIN or ASSET_LISTING_ADMIN.
Please look at the ACLManager contract for further details
on system roles.Input Parameters:#
| Name | Type | Description |
|---|---|---|
| fallbackOracle | address | The address of the fallback oracle |
View Methods#
getAssetPrice#
function getAssetPrice(address asset) public view override returns (uint256)Returns the price of the supported asset in BASE_CURRENCY of the Aave Market in wei.
Input Parameters:#
| Name | Type | Description |
|---|---|---|
| asset | address | The address of the asset |
Return Values:#
| Type | Description |
|---|---|
uint256 | The price of the asset in BASE_CURRENCY of the Aave market in wei |
getAssetsPrices#
function getAssetsPrices(address[] calldata assets) external view override returns (uint256[] memory)Returns a list of prices from a list of the supported assets addresses in BASE_CURRENCY of the Aave Market. All prices are in wei.
Input Parameters:#
| Name | Type | Description |
|---|---|---|
| assets | address[] | The list of assets addresses for which price is being queried |
Return Values:#
| Type | Description |
|---|---|
uint256[] | The prices of the given assets in BASE_CURRENCY of the Aave market in wei |
getSourceOfAsset#
function getSourceOfAsset(address asset) external view override returns (address)Returns the address of the price source for an asset address.
Input Parameters:#
| Name | Type | Description |
|---|---|---|
| asset | address | The address of the asset |
Return Values:#
| Type | Description |
|---|---|
address | The address of the source |
getFallbackOracle#
function getFallbackOracle() external view returns (address)Returns the address of the fallback oracle.
Return Values:#
| Type | Description |
|---|---|
address | The address of the fallback oracle |
PriceOracleSentinel#
The PriceOracleSentinel contract validates if the operations are allowed depending on the PriceOracle health.
This feature introduces a grace period for liquidations and disables borrowing under specific circumstances.
This feature has been specifically designed for L2s to handle eventual downtime of the sequencer (but can be extended to handle other cases, even on L1s, in the future).
Once the PriceOracle gets up after an outage or downtime, users can make their positions healthy during a grace period. The PriceOracle is considered healthy once its completely up and the grace period has passed.
The source code is available on GitHub.
Write Methods#
setSequencerOracle#
function setSequencerOracle(address newSequencerOracle) external onlyPoolAdminUpdates the address of the sequencer oracle.
This method can only be called by the Role Admin, specified by Aave Governance, responsible for managing the POOL_ADMIN role.
Input Parameters:#
| Name | Type | Description |
|---|---|---|
| newSequencerOracle | address | The address of the new Sequencer Oracle to be set |
setGracePeriod#
function setGracePeriod(uint256 newGracePeriod) public onlyRiskOrPoolAdminsUpdates the duration of the grace period.
Input Parameters:#
| Name | Type | Description |
|---|---|---|
| newGracePeriod | uint256 | The duration of new grace period in seconds |
View Methods#
isBorrowAllowed#
function isBorrowAllowed() external view override returns (bool)Returns true if the borrow operation is allowed. The operation is not allowed when PriceOracle is down or the grace period has not passed.
Return Values:#
| Type | Description |
|---|---|
bool | Returns true if the borrow operation is allowed (the PriceOracle is up and grace period has passed), false otherwise |
isLiquidationAllowed#
function isLiquidationAllowed() external view override returns (bool)Returns true if the liquidation operation is allowed. The operation is not allowed when PriceOracle is down or the grace period has not passed.
Return Values:#
| Type | Description |
|---|---|
bool | Returns true if the liquidation operation is allowed (the PriceOracle is up and grace period has passed), false otherwise |
getSequencerOracle#
function getSequencerOracle() external view returns (address)Returns the SequencerOracle.
Return Values:#
| Type | Description |
|---|---|
address | The address of the sequencer oracle contract |
getGracePeriod#
function getGracePeriod() external view returns (uint256)Returns the grace period.
Return Values:#
| Type | Description |
|---|---|
uint256 | The duration of the grace period in seconds |