mirror of
https://github.com/Instadapp/aave-protocol-v2.git
synced 2024-07-29 21:47:30 +00:00
293 lines
11 KiB
Solidity
293 lines
11 KiB
Solidity
// SPDX-License-Identifier: agpl-3.0
|
|
pragma solidity ^0.6.8;
|
|
|
|
import {SafeMath} from '@openzeppelin/contracts/math/SafeMath.sol';
|
|
import {IERC20} from '@openzeppelin/contracts/token/ERC20/IERC20.sol';
|
|
import {MathUtils} from '../math/MathUtils.sol';
|
|
import {IPriceOracleGetter} from '../../interfaces/IPriceOracleGetter.sol';
|
|
import {SafeERC20} from '@openzeppelin/contracts/token/ERC20/SafeERC20.sol';
|
|
import {IStableDebtToken} from '../../tokenization/interfaces/IStableDebtToken.sol';
|
|
import {ReserveConfiguration} from '../configuration/ReserveConfiguration.sol';
|
|
import {IReserveInterestRateStrategy} from '../../interfaces/IReserveInterestRateStrategy.sol';
|
|
import {WadRayMath} from '../math/WadRayMath.sol';
|
|
import {Errors} from '../helpers/Errors.sol';
|
|
|
|
/**
|
|
* @title ReserveLogic library
|
|
* @author Aave
|
|
* @notice Implements the logic to update the state of the reserves
|
|
*/
|
|
library ReserveLogic {
|
|
using SafeMath for uint256;
|
|
using WadRayMath for uint256;
|
|
using SafeERC20 for IERC20;
|
|
|
|
/**
|
|
* @dev Emitted when the state of a reserve is updated
|
|
* @param reserve the address of the reserve
|
|
* @param liquidityRate the new liquidity rate
|
|
* @param stableBorrowRate the new stable borrow rate
|
|
* @param averageStableBorrowRate the new average stable borrow rate
|
|
* @param variableBorrowRate the new variable borrow rate
|
|
* @param liquidityIndex the new liquidity index
|
|
* @param variableBorrowIndex the new variable borrow index
|
|
**/
|
|
event ReserveDataUpdated(
|
|
address indexed reserve,
|
|
uint256 liquidityRate,
|
|
uint256 stableBorrowRate,
|
|
uint256 averageStableBorrowRate,
|
|
uint256 variableBorrowRate,
|
|
uint256 liquidityIndex,
|
|
uint256 variableBorrowIndex
|
|
);
|
|
|
|
using ReserveLogic for ReserveLogic.ReserveData;
|
|
using ReserveConfiguration for ReserveConfiguration.Map;
|
|
|
|
enum InterestRateMode {NONE, STABLE, VARIABLE}
|
|
|
|
// refer to the whitepaper, section 1.1 basic concepts for a formal description of these properties.
|
|
struct ReserveData {
|
|
//stores the reserve configuration
|
|
ReserveConfiguration.Map configuration;
|
|
//the liquidity index. Expressed in ray
|
|
uint128 liquidityIndex;
|
|
//variable borrow index. Expressed in ray
|
|
uint128 variableBorrowIndex;
|
|
//the current supply rate. Expressed in ray
|
|
uint128 currentLiquidityRate;
|
|
//the current variable borrow rate. Expressed in ray
|
|
uint128 currentVariableBorrowRate;
|
|
//the current stable borrow rate. Expressed in ray
|
|
uint128 currentStableBorrowRate;
|
|
uint40 lastUpdateTimestamp;
|
|
|
|
//tokens addresses
|
|
address aTokenAddress;
|
|
address stableDebtTokenAddress;
|
|
address variableDebtTokenAddress;
|
|
|
|
address interestRateStrategyAddress;
|
|
|
|
//the id of the reserve. Represents the position in the list of the active reserves
|
|
uint8 id;
|
|
}
|
|
|
|
/**
|
|
* @dev returns the ongoing normalized income for the reserve.
|
|
* a value of 1e27 means there is no income. As time passes, the income is accrued.
|
|
* A value of 2*1e27 means for each unit of assset two units of income have been accrued.
|
|
* @param reserve the reserve object
|
|
* @return the normalized income. expressed in ray
|
|
**/
|
|
function getNormalizedIncome(ReserveData storage reserve) internal view returns (uint256) {
|
|
uint40 timestamp = reserve.lastUpdateTimestamp;
|
|
|
|
//solium-disable-next-line
|
|
if (timestamp == uint40(block.timestamp)) {
|
|
//if the index was updated in the same block, no need to perform any calculation
|
|
return reserve.liquidityIndex;
|
|
}
|
|
|
|
uint256 cumulated = MathUtils
|
|
.calculateLinearInterest(reserve.currentLiquidityRate, timestamp)
|
|
.rayMul(reserve.liquidityIndex);
|
|
|
|
return cumulated;
|
|
}
|
|
|
|
/**
|
|
* @dev returns the ongoing normalized variable debt for the reserve.
|
|
* a value of 1e27 means there is no debt. As time passes, the income is accrued.
|
|
* A value of 2*1e27 means that the debt of the reserve is double the initial amount.
|
|
* @param reserve the reserve object
|
|
* @return the normalized variable debt. expressed in ray
|
|
**/
|
|
function getNormalizedDebt(ReserveData storage reserve) internal view returns (uint256) {
|
|
uint40 timestamp = reserve.lastUpdateTimestamp;
|
|
|
|
//solium-disable-next-line
|
|
if (timestamp == uint40(block.timestamp)) {
|
|
//if the index was updated in the same block, no need to perform any calculation
|
|
return reserve.variableBorrowIndex;
|
|
}
|
|
|
|
uint256 cumulated = MathUtils
|
|
.calculateCompoundedInterest(reserve.currentVariableBorrowRate, timestamp)
|
|
.rayMul(reserve.variableBorrowIndex);
|
|
|
|
return cumulated;
|
|
}
|
|
|
|
/**
|
|
* @dev returns an address of the debt token used for particular interest rate mode on asset.
|
|
* @param reserve the reserve object
|
|
* @param interestRateMode - STABLE or VARIABLE from ReserveLogic.InterestRateMode enum
|
|
* @return an address of the corresponding debt token from reserve configuration
|
|
**/
|
|
function getDebtTokenAddress(ReserveLogic.ReserveData storage reserve, uint256 interestRateMode)
|
|
internal
|
|
view
|
|
returns (address)
|
|
{
|
|
require(
|
|
ReserveLogic.InterestRateMode.STABLE == ReserveLogic.InterestRateMode(interestRateMode) ||
|
|
ReserveLogic.InterestRateMode.VARIABLE == ReserveLogic.InterestRateMode(interestRateMode),
|
|
Errors.INVALID_INTEREST_RATE_MODE_SELECTED
|
|
);
|
|
return
|
|
ReserveLogic.InterestRateMode.STABLE == ReserveLogic.InterestRateMode(interestRateMode)
|
|
? reserve.stableDebtTokenAddress
|
|
: reserve.variableDebtTokenAddress;
|
|
}
|
|
|
|
/**
|
|
* @dev Updates the liquidity cumulative index Ci and variable borrow cumulative index Bvc. Refer to the whitepaper for
|
|
* a formal specification.
|
|
* @param reserve the reserve object
|
|
**/
|
|
function updateCumulativeIndexesAndTimestamp(ReserveData storage reserve) internal {
|
|
uint256 currentLiquidityRate = reserve.currentLiquidityRate;
|
|
|
|
//only cumulating if there is any income being produced
|
|
if (currentLiquidityRate > 0) {
|
|
uint40 lastUpdateTimestamp = reserve.lastUpdateTimestamp;
|
|
uint256 cumulatedLiquidityInterest = MathUtils.calculateLinearInterest(
|
|
currentLiquidityRate,
|
|
lastUpdateTimestamp
|
|
);
|
|
uint256 index = cumulatedLiquidityInterest.rayMul(reserve.liquidityIndex);
|
|
require(index < (1 << 128), Errors.LIQUIDITY_INDEX_OVERFLOW);
|
|
|
|
reserve.liquidityIndex = uint128(index);
|
|
|
|
//as the liquidity rate might come only from stable rate loans, we need to ensure
|
|
//that there is actual variable debt before accumulating
|
|
if (IERC20(reserve.variableDebtTokenAddress).totalSupply() > 0) {
|
|
uint256 cumulatedVariableBorrowInterest = MathUtils.calculateCompoundedInterest(
|
|
reserve.currentVariableBorrowRate,
|
|
lastUpdateTimestamp
|
|
);
|
|
index = cumulatedVariableBorrowInterest.rayMul(reserve.variableBorrowIndex);
|
|
require(index < (1 << 128), Errors.VARIABLE_BORROW_INDEX_OVERFLOW);
|
|
reserve.variableBorrowIndex = uint128(index);
|
|
}
|
|
}
|
|
|
|
//solium-disable-next-line
|
|
reserve.lastUpdateTimestamp = uint40(block.timestamp);
|
|
}
|
|
|
|
/**
|
|
* @dev accumulates a predefined amount of asset to the reserve as a fixed, one time income. Used for example to accumulate
|
|
* the flashloan fee to the reserve, and spread it through the depositors.
|
|
* @param reserve the reserve object
|
|
* @param totalLiquidity the total liquidity available in the reserve
|
|
* @param amount the amount to accomulate
|
|
**/
|
|
function cumulateToLiquidityIndex(
|
|
ReserveData storage reserve,
|
|
uint256 totalLiquidity,
|
|
uint256 amount
|
|
) internal {
|
|
uint256 amountToLiquidityRatio = amount.wadToRay().rayDiv(totalLiquidity.wadToRay());
|
|
|
|
uint256 result = amountToLiquidityRatio.add(WadRayMath.ray());
|
|
|
|
result = result.rayMul(reserve.liquidityIndex);
|
|
require(result < (1 << 128), Errors.LIQUIDITY_INDEX_OVERFLOW);
|
|
|
|
reserve.liquidityIndex = uint128(result);
|
|
}
|
|
|
|
/**
|
|
* @dev initializes a reserve
|
|
* @param reserve the reserve object
|
|
* @param aTokenAddress the address of the overlying atoken contract
|
|
* @param interestRateStrategyAddress the address of the interest rate strategy contract
|
|
**/
|
|
function init(
|
|
ReserveData storage reserve,
|
|
address aTokenAddress,
|
|
address stableDebtTokenAddress,
|
|
address variableDebtTokenAddress,
|
|
address interestRateStrategyAddress
|
|
) external {
|
|
require(reserve.aTokenAddress == address(0), Errors.RESERVE_ALREADY_INITIALIZED);
|
|
if (reserve.liquidityIndex == 0) {
|
|
//if the reserve has not been initialized yet
|
|
reserve.liquidityIndex = uint128(WadRayMath.ray());
|
|
}
|
|
|
|
if (reserve.variableBorrowIndex == 0) {
|
|
reserve.variableBorrowIndex = uint128(WadRayMath.ray());
|
|
}
|
|
|
|
reserve.aTokenAddress = aTokenAddress;
|
|
reserve.stableDebtTokenAddress = stableDebtTokenAddress;
|
|
reserve.variableDebtTokenAddress = variableDebtTokenAddress;
|
|
reserve.interestRateStrategyAddress = interestRateStrategyAddress;
|
|
}
|
|
|
|
struct UpdateInterestRatesLocalVars {
|
|
uint256 currentAvgStableRate;
|
|
uint256 availableLiquidity;
|
|
address stableDebtTokenAddress;
|
|
uint256 newLiquidityRate;
|
|
uint256 newStableRate;
|
|
uint256 newVariableRate;
|
|
}
|
|
|
|
/**
|
|
* @dev Updates the reserve current stable borrow rate Rf, the current variable borrow rate Rv and the current liquidity rate Rl.
|
|
* Also updates the lastUpdateTimestamp value. Please refer to the whitepaper for further information.
|
|
* @param reserve the address of the reserve to be updated
|
|
* @param liquidityAdded the amount of liquidity added to the protocol (deposit or repay) in the previous action
|
|
* @param liquidityTaken the amount of liquidity taken from the protocol (redeem or borrow)
|
|
**/
|
|
function updateInterestRates(
|
|
ReserveData storage reserve,
|
|
address reserveAddress,
|
|
address aTokenAddress,
|
|
uint256 liquidityAdded,
|
|
uint256 liquidityTaken
|
|
) internal {
|
|
UpdateInterestRatesLocalVars memory vars;
|
|
|
|
vars.stableDebtTokenAddress = reserve.stableDebtTokenAddress;
|
|
vars.currentAvgStableRate = IStableDebtToken(vars.stableDebtTokenAddress)
|
|
.getAverageStableRate();
|
|
vars.availableLiquidity = IERC20(reserveAddress).balanceOf(aTokenAddress);
|
|
|
|
(
|
|
vars.newLiquidityRate,
|
|
vars.newStableRate,
|
|
vars.newVariableRate
|
|
) = IReserveInterestRateStrategy(reserve.interestRateStrategyAddress).calculateInterestRates(
|
|
reserveAddress,
|
|
vars.availableLiquidity.add(liquidityAdded).sub(liquidityTaken),
|
|
IERC20(vars.stableDebtTokenAddress).totalSupply(),
|
|
IERC20(reserve.variableDebtTokenAddress).totalSupply(),
|
|
vars.currentAvgStableRate
|
|
);
|
|
require(vars.newLiquidityRate < (1 << 128), 'ReserveLogic: Liquidity rate overflow');
|
|
require(vars.newStableRate < (1 << 128), 'ReserveLogic: Stable borrow rate overflow');
|
|
require(vars.newVariableRate < (1 << 128), 'ReserveLogic: Variable borrow rate overflow');
|
|
|
|
reserve.currentLiquidityRate = uint128(vars.newLiquidityRate);
|
|
reserve.currentStableBorrowRate = uint128(vars.newStableRate);
|
|
reserve.currentVariableBorrowRate = uint128(vars.newVariableRate);
|
|
|
|
emit ReserveDataUpdated(
|
|
reserveAddress,
|
|
vars.newLiquidityRate,
|
|
vars.newStableRate,
|
|
vars.currentAvgStableRate,
|
|
vars.newVariableRate,
|
|
reserve.liquidityIndex,
|
|
reserve.variableBorrowIndex
|
|
);
|
|
}
|
|
}
|