Valence AAVE Position Manager library

The Valence AAVE Position Manager library allows management of lending positions using an input account and an output account using the AAVE v3 Protocol. It is typically used as part of a Valence Program. In that context, a Processor contract will be the main contract interacting with the AAVE Position Manager library.

High-level flows

---
title: AAVE Position Manager Supply Flow
---
flowchart LR
    P[Processor]
    A[AAVE Position
    Manager Library]
    IA((Input Account))
    AP((AAVE Pool))

    P -- 1/Supply(amount) --> A
    A -- 2/Query balance --> IA
    A -- 3/Approve ERC20(amount) and call supply --> IA
    IA -- 4/Supply --> AP
    AP -- 5/Mint aTokens --> IA

---
title: AAVE Position Manager Borrow Flow
---
flowchart LR
 P[Processor]
 A[AAVE Position
 Manager Library]
 IA((Input Account))
 AP((AAVE Pool))
 P -- 1/Borrow(amount) --> A
 A -- 2/Call borrow --> IA
 IA -- 4/Borrow --> AP
 AP -- 5/Send borrowed tokens --> IA

---
title: AAVE Position Manager Withdraw Flow
---
flowchart LR
 P[Processor]
 A[AAVE Position
 Manager Library]
 IA((Input Account))
 AP((AAVE Pool))
 OA((Output Account))
 P -- 1/Withdraw(amount) --> A
 A -- 2/Call withdraw --> IA
 IA -- 3/Withdraw --> AP
 AP -- 4/Send withdrawn tokens --> OA

---
title: AAVE Position Manager Repay Flow
---
flowchart LR
    P[Processor]
    A[AAVE Position
    Manager Library]
    IA((Input Account))
    AP((AAVE Pool))

    P -- 1/Repay(amount) --> A
    A -- 2/Query balance --> IA
    A -- 3/Approve ERC20(amount) and call repay --> IA
    IA -- 4/Repay --> AP
    AP -- 5/Burn debt tokens  --> IA

---
title: AAVE Position Manager RepayWithShares Flow
---
flowchart LR
    P[Processor]
    A[AAVE Position
    Manager Library]
    IA((Input Account))
    AP((AAVE Pool))

    P -- 1/RepayWithShares(amount) --> A
    A -- 2/Call repayWithATokens --> IA
    IA -- 3/Repay --> AP
    AP -- 4/Burn aTokens --> IA
    AP -- 5/Burn debt tokens --> IA

Functions

FunctionParametersDescription
supplyamountSupplies tokens from the input account to the AAVE protocol. The input account will receive these corresponding aTokens. If amount is 0 the entire balance will be used.
borrowamountBorrows tokens from the AAVE protocol using the collateral previously supplied. The input account will receive the borrowed tokens and the debt tokens.
withdrawamountWithdraws previously supplied tokens from AAVE and sends them to the output account. Passing 0 will withdraw the entire balance.
repayamountRepays borrowed tokens to the AAVE protocol from the input account. Passing 0 repays the entire balance.
repayWithSharesamountRepays borrowed tokens using aTokens directly, which can be more gas-efficient. Passing 0 will repay as much as possible.

More details on how the interaction with the AAVE v3 protocol works can be found in the AAVE V3 Pool documentation.

Configuration

The library is configured on deployment using the AavePositionManagerConfig type.

    /**
     * @title AavePositionManagerConfig
     * @notice Configuration struct for Aave lending operations
     * @dev Used to define parameters for interacting with Aave V3 protocol
     * @param poolAddress The address of the Aave V3 Pool contract
     * @param inputAccount The Base Account from which transactions will be initiated
     * @param outputAccount The Base Account that will receive withdrawals. Can be the same as inputAccount.
     * @param supplyAsset Address of the token to supply to Aave
     * @param borrowAsset Address of the token to borrow from Aave
     * @param referralCode Referral code for Aave protocol (if applicable - 0 if the action is executed directly by the user, without any middle-men)
     */
    struct AavePositionManagerConfig {
        IPool poolAddress;
        BaseAccount inputAccount;
        BaseAccount outputAccount;
        address supplyAsset;
        address borrowAsset;
        uint16 referralCode;
    }