AaveV3AdapterLib

Git Source

Title: AaveV3AdapterLib

Authors: David Dada <daveproxy80@gmail.com> (https://github.com/dadadave80), Modified from Aave V3 (https://github.com/aave-dao/aave-v3-origin)

All logic for the Aave v3 adapter facet. Supply leg values 1:1 via aToken.balanceOf; leverage leg values net equity via Aave's OWN price oracle (single self-consistent source with getUserAccountData, no cross-oracle drift). Reentrancy-gated, pause/emergency-aware, shortfall-honest.

Functions

aaveV3AdapterStorage

function aaveV3AdapterStorage() internal pure returns (AaveV3AdapterStorage storage $);

Returns

__AaveV3Adapter_init

Initializes the Aave adapter. Must run inside a pre/postInitializer block, after AccessControl is initialized.

function __AaveV3Adapter_init(
        address provider,
        address asset_,
        address vault_,
        address rewardRecipient_,
        bytes32 assetUsdFeedKey,
        uint256 minHealthFactorWad
    ) internal;

Parameters

registerInterface

Registers IProtocolAdapter + IAaveV3Adapter for ERC-165 discovery.

function registerInterface() internal;

_pool

Re-resolves the live Pool from the provider on every call (picks up proxy upgrades).

function _pool() internal view returns (IAaveV3Pool);

Returns

aToken

Resolves the live aToken for the configured asset.

function aToken() internal view returns (address);

Returns

asset

function asset() internal view returns (address);

Returns

vault

function vault() internal view returns (address);

Returns

addressesProvider

function addressesProvider() internal view returns (address);

Returns

rewardRecipient

function rewardRecipient() internal view returns (address);

Returns

operator

function operator() internal view returns (address);

Returns

_checkOperator

function _checkOperator() private view;

eModeCategory

function eModeCategory() internal view returns (uint8);

Returns

minHealthFactor

function minHealthFactor() internal view returns (uint256);

Returns

isPaused

True when the adapter is paused or emergency-stopped. deploy() checks this so a paused adapter cannot brick the manager's rebalance() (it reverts, the manager catches it and emits StrategyDeployFailed, and the pass-2 allocation's bare transfer stays idle here, counted in NAV — safe).

function isPaused() internal view returns (bool);

Returns

healthFactor

Current health factor (WAD). Aave returns type(uint256).max when there is no debt.

function healthFactor() internal view returns (uint256);

Returns

setEMode

function setEMode(uint8 categoryId) internal;

Parameters

setMinHealthFactor

function setMinHealthFactor(uint256 minHealthFactorWad) internal;

Parameters

setRewardRecipient

function setRewardRecipient(address recipient) internal;

Parameters

setOperator

Sets the authorized operator for deploy/withdraw/harvest (admin-only). Rejects address(0) so the trio cannot be opened to an unauthenticated default.

function setOperator(address operator_) internal;

Parameters

rewardsController

function rewardsController() internal view returns (address);

Returns

setRewardsController

function setRewardsController(address controller) internal;

Parameters

deploy

Sweeps the adapter's idle asset balance into Aave via Pool.supply.

function deploy() internal returns (uint256 deployed);

Returns

withdraw

Withdraws up to amount of the asset to to, returning the REAL amount.

function withdraw(uint256 amount, address to) internal returns (uint256 withdrawn);

Parameters

Returns

_availableCash

The reserve's cash available to withdraw: the underlying held by the aToken, which is where Aave keeps a reserve's liquidity (Pool.withdraw pays out through IAToken.transferUnderlyingTo).

function _availableCash(IAaveV3Pool pool, address asset_, address aToken_) private view returns (uint256 cash);

Parameters

Returns

totalAssetsManaged

Total assets managed (vault accounting / share price input).

Idle leg (NAV-gap fix): in BOTH branches we add the adapter's idle underlying balance. IVaultCore.allocateToStrategy pushes vault funds here with a bare ERC-20 transfer that does NOT call deploy(). Inside rebalance() the StrategyManager calls deploy() in the same transaction (#221), so the funds sit idle in the adapter only when that deploy fails (paused adapter or pool, supply cap) or when the vault allocates outside a rebalance, until the next rebalance or operator deploy(). Counting that idle keeps the vault's share price flat across the allocate→deploy window (otherwise NAV would understate by the idle amount, letting a depositor mint cheap shares and redeem after deploy() re-materializes it). No double-count: the idle is in NEITHER the vault's idle (it was transferred out) NOR the aToken/net-equity position, and after deploy() idle→~0 while the position grows by the same amount — so the sum is invariant across deploy. Unencumbered idle underlying is equity either way, so it is added to the levered net-equity return too.

function totalAssetsManaged() internal view returns (uint256);

Returns

lever

Borrows borrowAmount of the asset (variable rate) then re-supplies it, looping leverage. Reverts if the resulting health factor would fall below the floor.

function lever(uint256 borrowAmount) internal;

Parameters

delever

Withdraws collateralToPull of the asset from supply and repays that much debt, decreasing leverage. Returns the amount of debt actually repaid.

function delever(uint256 collateralToPull) internal returns (uint256 repaid);

Parameters

Returns

_assertHealthFactorAboveFloor

function _assertHealthFactorAboveFloor() internal view;

_netEquityAssets

Oracle-priced net equity (collateral − debt) expressed in asset units.

Note: the legacy _assetUsdFeedKey (Lattice ChainlinkAdapter) is NO LONGER read here and is now unused for net-equity. The storage field is retained (append-only/upgrade-safety); a future migration may drop it if nothing else consumes it.

function _netEquityAssets() internal view returns (uint256);

Returns

harvest

Claims all Aave incentive rewards for the adapter's aToken and forwards each reward token RAW to the configured recipient. Zero-claim / fee-on-transfer safe; never reverts the rebalance/withdraw path. Rewards are not part of totalAssetsManaged().

function harvest() internal;

emergencyWithdraw

Fully exits the Aave position and returns all recovered assets to the vault.

function emergencyWithdraw() internal returns (uint256 recovered);

Returns