[WIP] - chore: add complete interfaces

interfaces/aave/Aave.sol

@@ -1,6 +1,100 @@
 pragma solidity ^0.5.17;
 
 interface Aave {
+    /**
+     * @dev deposits The underlying asset into the reserve. A corresponding amount of the overlying asset (aTokens)
+     * is minted.
+     * @param _reserve the address of the reserve
+     * @param _amount the amount to be deposited
+     * @param _referralCode integrators are assigned a referral code and can potentially receive rewards.
+     **/
+    function deposit(
+        address _reserve,
+        uint256 _amount,
+        uint16 _referralCode
+    ) external payable;
+
+    /**
+     * @dev Redeems the underlying amount of assets requested by _user.
+     * This function is executed by the overlying aToken contract in response to a redeem action.
+     * @param _reserve the address of the reserve
+     * @param _user the address of the user performing the action
+     * @param _amount the underlying amount to be redeemed
+     **/
+    function redeemUnderlying(
+        address _reserve,
+        address payable _user,
+        uint256 _amount,
+        uint256 _aTokenBalanceAfterRedeem
+    ) external;
+
+    /**
+     * @dev borrowers can user this function to swap between stable and variable borrow rate modes.
+     * @param _reserve the address of the reserve on which the user borrowed
+     **/
+    function swapBorrowRateMode(address _reserve) external;
+
+    /**
+     * @dev rebalances the stable interest rate of a user if current liquidity rate > user stable rate.
+     * this is regulated by Aave to ensure that the protocol is not abused, and the user is paying a fair
+     * rate. Anyone can call this function though.
+     * @param _reserve the address of the reserve
+     * @param _user the address of the user to be rebalanced
+     **/
+    function rebalanceStableBorrowRate(address _reserve, address _user) external;
+
+    /**
+     * @dev users can invoke this function to liquidate an undercollateralized position.
+     * @param _reserve the address of the collateral to liquidated
+     * @param _reserve the address of the principal reserve
+     * @param _user the address of the borrower
+     * @param _purchaseAmount the amount of principal that the liquidator wants to repay
+     * @param _receiveAToken true if the liquidators wants to receive the aTokens, false if
+     * he wants to receive the underlying asset directly
+     **/
+    function liquidationCall(
+        address _collateral,
+        address _reserve,
+        address _user,
+        uint256 _purchaseAmount,
+        bool _receiveAToken
+    ) external payable;
+
+    function getReserveConfigurationData(address _reserve)
+        external
+        view
+        returns (
+            uint256 ltv,
+            uint256 liquidationThreshold,
+            uint256 liquidationBonus,
+            address interestRateStrategyAddress,
+            bool usageAsCollateralEnabled,
+            bool borrowingEnabled,
+            bool stableBorrowRateEnabled,
+            bool isActive
+        );
+
+    function getReserveData(address _reserve)
+        external
+        view
+        returns (
+            uint256 totalLiquidity,
+            uint256 availableLiquidity,
+            uint256 totalBorrowsStable,
+            uint256 totalBorrowsVariable,
+            uint256 liquidityRate,
+            uint256 variableBorrowRate,
+            uint256 stableBorrowRate,
+            uint256 averageStableBorrowRate,
+            uint256 utilizationRate,
+            uint256 liquidityIndex,
+            uint256 variableBorrowIndex,
+            address aTokenAddress,
+            uint40 lastUpdateTimestamp
+        );
+
+    function getReserves() external view returns (address[] memory);
+
     function borrow(
         address _reserve,
         uint256 _amount,

interfaces/aave/AaveToken.sol

@@ -1,5 +1,121 @@
 pragma solidity ^0.5.17;
 
 interface AaveToken {
+    /**
+     * @dev redirects the interest generated to a target address.
+     * when the interest is redirected, the user balance is added to
+     * the recepient redirected balance.
+     * @param _to the address to which the interest will be redirected
+     **/
+    function redirectInterestStream(address _to) external;
+
+    /**
+     * @dev redirects the interest generated by _from to a target address.
+     * when the interest is redirected, the user balance is added to
+     * the recepient redirected balance. The caller needs to have allowance on
+     * the interest redirection to be able to execute the function.
+     * @param _from the address of the user whom interest is being redirected
+     * @param _to the address to which the interest will be redirected
+     **/
+    function redirectInterestStreamOf(address _from, address _to) external;
+
+    /**
+     * @dev gives allowance to an address to execute the interest redirection
+     * on behalf of the caller.
+     * @param _to the address to which the interest will be redirected. Pass address(0) to reset
+     * the allowance.
+     **/
+    function allowInterestRedirectionTo(address _to) external;
+
+    /**
+     * @dev redeems aToken for the underlying asset
+     * @param _amount the amount being redeemed
+     **/
+    function redeem(uint256 _amount) external;
+
+    /**
+     * @dev mints token in the event of users depositing the underlying asset into the lending pool
+     * only lending pools can call this function
+     * @param _account the address receiving the minted tokens
+     * @param _amount the amount of tokens to mint
+     */
+    function mintOnDeposit(address _account, uint256 _amount) external;
+
+    /**
+     * @dev burns token in the event of a borrow being liquidated, in case the liquidators reclaims the underlying asset
+     * Transfer of the liquidated asset is executed by the lending pool contract.
+     * only lending pools can call this function
+     * @param _account the address from which burn the aTokens
+     * @param _value the amount to burn
+     **/
+    function burnOnLiquidation(address _account, uint256 _value) external;
+
+    /**
+     * @dev transfers tokens in the event of a borrow being liquidated, in case the liquidators reclaims the aToken
+     *      only lending pools can call this function
+     * @param _from the address from which transfer the aTokens
+     * @param _to the destination address
+     * @param _value the amount to transfer
+     **/
+    function transferOnLiquidation(
+        address _from,
+        address _to,
+        uint256 _value
+    ) external;
+
+    /**
+     * @dev calculates the balance of the user, which is the
+     * principal balance + interest generated by the principal balance + interest generated by the redirected balance
+     * @param _user the user for which the balance is being calculated
+     * @return the total balance of the user
+     **/
+    function balanceOf(address _user) external view returns (uint256);
+
+    /**
+     * @dev returns the principal balance of the user. The principal balance is the last
+     * updated stored balance, which does not consider the perpetually accruing interest.
+     * @param _user the address of the user
+     * @return the principal balance of the user
+     **/
+    function principalBalanceOf(address _user) external view returns (uint256);
+
+    /**
+     * @dev calculates the total supply of the specific aToken
+     * since the balance of every single user increases over time, the total supply
+     * does that too.
+     * @return the current total supply
+     **/
+    function totalSupply() external view returns (uint256);
+
+    /**
+     * @dev Used to validate transfers before actually executing them.
+     * @param _user address of the user to check
+     * @param _amount the amount to check
+     * @return true if the _user can transfer _amount, false otherwise
+     **/
+    function isTransferAllowed(address _user, uint256 _amount) external view returns (bool);
+
+    /**
+     * @dev returns the last index of the user, used to calculate the balance of the user
+     * @param _user address of the user
+     * @return the last user index
+     **/
+    function getUserIndex(address _user) external view returns (uint256);
+
+    /**
+     * @dev returns the address to which the interest is redirected
+     * @param _user address of the user
+     * @return 0 if there is no redirection, an address otherwise
+     **/
+    function getInterestRedirectionAddress(address _user) external view returns (address);
+
+    /**
+     * @dev returns the redirected balance of the user. The redirected balance is the balance
+     * redirected by other accounts to the user, that is accrueing interest for him.
+     * @param _user address of the user
+     * @return the total redirected balance
+     **/
+    function getRedirectedBalance(address _user) external view returns (uint256);
+
     function underlyingAssetAddress() external view returns (address);
 }

interfaces/aave/LendingPoolAddressesProvider.sol

@@ -1,9 +1,110 @@
 pragma solidity ^0.5.17;
 
-interface LendingPoolAddressesProvider {
+/**
+@title ILendingPoolAddressesProvider interface
+@notice provides the interface to fetch the LendingPoolCore address
+ */
+
+contract LendingPoolAddressesProvider {
+    /**
+     * @dev returns the address of the LendingPool proxy
+     * @return the lending pool proxy address
+     **/
     function getLendingPool() external view returns (address);
 
-    function getLendingPoolCore() external view returns (address);
+    /**
+     * @dev updates the implementation of the lending pool
+     * @param _pool the new lending pool implementation
+     **/
+    function setLendingPoolImpl(address _pool) external;
+
+    /**
+     * @dev returns the address of the LendingPoolCore proxy
+     * @return the lending pool core proxy address
+     */
+    function getLendingPoolCore() external view returns (address payable);
+
+    /**
+     * @dev updates the implementation of the lending pool core
+     * @param _lendingPoolCore the new lending pool core implementation
+     **/
+    function setLendingPoolCoreImpl(address _lendingPoolCore) external;
+
+    /**
+     * @dev returns the address of the LendingPoolConfigurator proxy
+     * @return the lending pool configurator proxy address
+     **/
+    function getLendingPoolConfigurator() external view returns (address);
+
+    /**
+     * @dev updates the implementation of the lending pool configurator
+     * @param _configurator the new lending pool configurator implementation
+     **/
+    function setLendingPoolConfiguratorImpl(address _configurator) external;
+
+    /**
+     * @dev returns the address of the LendingPoolDataProvider proxy
+     * @return the lending pool data provider proxy address
+     */
+    function getLendingPoolDataProvider() external view returns (address);
+
+    /**
+     * @dev updates the implementation of the lending pool data provider
+     * @param _provider the new lending pool data provider implementation
+     **/
+    function setLendingPoolDataProviderImpl(address _provider) external;
+
+    /**
+     * @dev returns the address of the LendingPoolParametersProvider proxy
+     * @return the address of the Lending pool parameters provider proxy
+     **/
+    function getLendingPoolParametersProvider() external view returns (address);
+
+    /**
+     * @dev updates the implementation of the lending pool parameters provider
+     * @param _parametersProvider the new lending pool parameters provider implementation
+     **/
+    function setLendingPoolParametersProviderImpl(address _parametersProvider) external;
+
+    function getTokenDistributor() external view returns (address);
+
+    function setTokenDistributor(address _tokenDistributor) external;
+
+    /**
+     * @dev returns the address of the FeeProvider proxy
+     * @return the address of the Fee provider proxy
+     **/
+    function getFeeProvider() external view returns (address);
+
+    /**
+     * @dev updates the implementation of the FeeProvider proxy
+     * @param _feeProvider the new lending pool fee provider implementation
+     **/
+    function setFeeProviderImpl(address _feeProvider) external;
+
+    /**
+     * @dev returns the address of the LendingPoolLiquidationManager. Since the manager is used
+     * through delegateCall within the LendingPool contract, the proxy contract pattern does not work properly hence
+     * the addresses are changed directly.
+     * @return the address of the Lending pool liquidation manager
+     **/
+    function getLendingPoolLiquidationManager() external view returns (address);
+
+    /**
+     * @dev updates the address of the Lending pool liquidation manager
+     * @param _manager the new lending pool liquidation manager address
+     **/
+    function setLendingPoolLiquidationManager(address _manager) external;
+
+    function getLendingPoolManager() external view returns (address);
+
+    function setLendingPoolManager(address _lendingPoolManager) external;
 
     function getPriceOracle() external view returns (address);
+
+    function setPriceOracle(address _priceOracle) external;
+
+    function getLendingRateOracle() external view returns (address);
+
+    function setLendingRateOracle(address _lendingRateOracle) external;
 }