🇨🇳中文介绍

Aave V3 架构

Aave V3 是一个去中心化非托管借贷协议，用户可以存入资产赚取利息，也可以抵押资产进行借款。本技能提供了协议架构的高层概述。

概述

    ┌──────────────────────────────────────────────────────────────┐
    │                      AAVE V3 ARCHITECTURE                    │
    ├──────────────────────────────────────────────────────────────┤
    │                                                              │
    │  ┌─────────────────────────────────────────────────────────┐ │
    │  │                 PoolAddressesProvider                   │ │
    │  │     Central registry for all protocol contracts         │ │
    │  └─────────────────────────────────────────────────────────┘ │
    │                              │                               │
    │       ┌──────────────────────┼──────────────────────┐        │
    │       ▼                      ▼                      ▼        │
    │  ┌─────────┐          ┌─────────────┐        ┌───────────┐   │
    │  │  Pool   │◄────────►│PoolConfig-  │        │ ACLManager│   │
    │  │         │          │   urator    │        │           │   │
    │  └────┬────┘          └─────────────┘        └───────────┘   │
    │       │                                                      │
    │       │  manages                                             │
    │       ▼                                                      │
    │  ┌─────────────────────────────────────────────────────────┐ │
    │  │                    Reserves (Assets)                     │ │
    │  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐     │ │
    │  │  │ aToken  │  │ Variable│  │ Interest│  │ Oracle  │     │ │
    │  │  │         │  │DebtToken│  │RateStrat│  │         │     │ │
    │  │  └─────────┘  └─────────┘  └─────────┘  └─────────┘     │ │
    │  └─────────────────────────────────────────────────────────┘ │
    │                                                              │
    └──────────────────────────────────────────────────────────────┘

核心组件

PoolAddressesProvider

存储特定市场所有协议合约地址的中央注册表。

    interface IPoolAddressesProvider {
        function getPool() external view returns (address);
        function getPoolConfigurator() external view returns (address);
        function getPriceOracle() external view returns (address);
        function getACLManager() external view returns (address);
        function getACLAdmin() external view returns (address);
        function getPriceOracleSentinel() external view returns (address);
        function getPoolDataProvider() external view returns (address);

        // Generic address getter for custom identifiers
        function getAddress(bytes32 id) external view returns (address);
    }

Pool

用户交互的主要入口点。所有存入、借款、还款和提取操作都通过 Pool 合约进行。

    interface IPool {
        // Core operations
        function supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode) external;
        function withdraw(address asset, uint256 amount, address to) external returns (uint256);
        function borrow(address asset, uint256 amount, uint256 interestRateMode, uint16 referralCode, address onBehalfOf) external;
        function repay(address asset, uint256 amount, uint256 interestRateMode, address onBehalfOf) external returns (uint256);

        // Collateral management
        function setUserUseReserveAsCollateral(address asset, bool useAsCollateral) external;

        // Liquidation
        function liquidationCall(address collateralAsset, address debtAsset, address user, uint256 debtToCover, bool receiveAToken) external;

        // Flash loans
        function flashLoan(address receiverAddress, address[] calldata assets, uint256[] calldata amounts, uint256[] calldata interestRateModes, address onBehalfOf, bytes calldata params, uint16 referralCode) external;
        function flashLoanSimple(address receiverAddress, address asset, uint256 amount, bytes calldata params, uint16 referralCode) external;

        // eModes
        function setUserEMode(uint8 categoryId) external;
        function getUserEMode(address user) external view returns (uint256);

        // Account data
        function getUserAccountData(address user) external view returns (
            uint256 totalCollateralBase,
            uint256 totalDebtBase,
            uint256 availableBorrowsBase,
            uint256 currentLiquidationThreshold,
            uint256 ltv,
            uint256 healthFactor
        );
    }

PoolConfigurator

用于配置储备金和协议参数的管理员合约。

    interface IPoolConfigurator {
        // Reserve initialization
        function initReserves(ConfiguratorInputTypes.InitReserveInput[] calldata input) external;

        // Reserve configuration
        function setReserveBorrowing(address asset, bool enabled) external;
        function configureReserveAsCollateral(address asset, uint256 ltv, uint256 liquidationThreshold, uint256 liquidationBonus) external;
        function setReserveFreeze(address asset, bool freeze) external;
        function setReservePause(address asset, bool paused) external;
        function setReserveFactor(address asset, uint256 newReserveFactor) external;

        // Caps
        function setBorrowCap(address asset, uint256 newBorrowCap) external;
        function setSupplyCap(address asset, uint256 newSupplyCap) external;

        // eModes
        function setEModeCategory(uint8 categoryId, uint16 ltv, uint16 liquidationThreshold, uint16 liquidationBonus, string calldata label) external;
    }

ACLManager

协议角色的访问控制管理器。

    interface IACLManager {
        function isPoolAdmin(address admin) external view returns (bool);
        function isEmergencyAdmin(address admin) external view returns (bool);
        function isRiskAdmin(address admin) external view returns (bool);
        function isFlashBorrower(address borrower) external view returns (bool);
        function isBridge(address bridge) external view returns (bool);
        function isAssetListingAdmin(address admin) external view returns (bool);
    }

储备金数据结构

Aave 上列出的每个资产都有相关的储备金数据：

    struct ReserveData {
        // Configuration stored as bitmap
        ReserveConfigurationMap configuration;

        // Indexes (in ray - 27 decimals)
        uint128 liquidityIndex;          // Supply index for interest accrual
        uint128 variableBorrowIndex;     // Borrow index for interest accrual

        // Current rates (in ray)
        uint128 currentLiquidityRate;    // Current supply APY
        uint128 currentVariableBorrowRate; // Current borrow APY

        // Deficit tracking (V3.3)
        uint128 deficit;

        // Timestamps
        uint40 lastUpdateTimestamp;
        uint40 liquidationGracePeriodUntil;

        // Token addresses
        uint16 id;
        address aTokenAddress;
        address variableDebtTokenAddress;
        address interestRateStrategyAddress;

        // Accounting
        uint128 accruedToTreasury;       // Fees accumulated for treasury
        uint128 unbacked;                 // Unbacked aTokens (bridging)
        uint128 isolationModeTotalDebt;   // Debt in isolation mode
        uint128 virtualUnderlyingBalance; // Virtual accounting balance
    }

关键概念

利率模型

Aave 使用可变利率模型：

    ┌──────────────────────────────────────────────────────────────┐
    │                    INTEREST RATE CURVE                       │
    ├──────────────────────────────────────────────────────────────┤
    │                                                              │
    │  Rate │                                    ╱                 │
    │       │                                  ╱                   │
    │       │                                ╱  Slope2             │
    │       │                              ╱                       │
    │       │                     ╱───────╱                        │
    │       │                   ╱  Slope1                          │
    │       │                 ╱                                    │
    │       │      Base Rate ╱                                     │
    │       └───────────────┼───────────────────────────────────   │
    │                       │                                      │
    │                   Optimal                                    │
    │                 Utilization                                  │
    │                                                              │
    │  Utilization = Total Debt / (Virtual Balance + Total Debt)  │
    │                                                              │
    └──────────────────────────────────────────────────────────────┘

贷款价值比与清算

• LTV：借款能力上限，以抵押品价值的百分比表示。
• 清算阈值：当健康因子降至 1 以下时，可能发生清算。
• 清算奖励：对清算人的激励（收到的额外抵押品）。
• 健康因子：HF = Σ(抵押品 × 清算阈值) / 总债务

虚拟记账

Aave V3.1+ 跟踪虚拟余额以防止捐赠攻击：

    // Instead of checking actual token balance:
    // balanceOf(aToken)

    // Aave uses virtual balance tracking:
    virtualUnderlyingBalance += amountSupplied;
    virtualUnderlyingBalance -= amountWithdrawn;

eModes

允许相关资产拥有更高的 LTV：

    struct EModeCategory {
        uint16 ltv;                  // Higher LTV for correlated assets
        uint16 liquidationThreshold;
        uint16 liquidationBonus;
        uint128 collateralBitmap;    // Which assets can be collateral
        uint128 borrowableBitmap;    // Which assets can be borrowed
        string label;
    }

协议流程

存入流程

    User → Pool.supply() → SupplyLogic.executeSupply()
      1. Update reserve indexes
      2. Transfer underlying to aToken
      3. Mint aTokens to user
      4. Update virtual balance
      5. Update interest rates

借款流程

    User → Pool.borrow() → BorrowLogic.executeBorrow()
      1. Validate health factor will remain >= 1
      2. Update reserve indexes
      3. Mint debt tokens to user
      4. Transfer underlying to user
      5. Update interest rates

清算流程

    Liquidator → Pool.liquidationCall() → LiquidationLogic.executeLiquidationCall()
      1. Verify user health factor < 1
      2. Calculate debt to cover and collateral to receive
      3. Burn debt tokens
      4. Transfer collateral to liquidator (+ bonus)
      5. Update interest rates

版本特性

技能参考

参考文件

• src/contracts/protocol/pool/Pool.sol - 主 Pool 合约
• src/contracts/protocol/pool/PoolConfigurator.sol - 配置合约
• src/contracts/protocol/libraries/types/DataTypes.sol - 核心数据结构
• src/contracts/interfaces/IPool.sol - Pool 接口
• src/contracts/interfaces/IPoolAddressesProvider.sol - 注册表接口

每周安装次数

–

代码仓库

cyotee/aave-v3-skill

首次出现

–

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

┌──────────────────────────────────────────────────────────────┐
│                      AAVE V3 ARCHITECTURE                    │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │                 PoolAddressesProvider                   │ │
│  │     Central registry for all protocol contracts         │ │
│  └─────────────────────────────────────────────────────────┘ │
│                              │                               │
│       ┌──────────────────────┼──────────────────────┐        │
│       ▼                      ▼                      ▼        │
│  ┌─────────┐          ┌─────────────┐        ┌───────────┐   │
│  │  Pool   │◄────────►│PoolConfig-  │        │ ACLManager│   │
│  │         │          │   urator    │        │           │   │
│  └────┬────┘          └─────────────┘        └───────────┘   │
│       │                                                      │
│       │  manages                                             │
│       ▼                                                      │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │                    Reserves (Assets)                     │ │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐     │ │
│  │  │ aToken  │  │ Variable│  │ Interest│  │ Oracle  │     │ │
│  │  │         │  │DebtToken│  │RateStrat│  │         │     │ │
│  │  └─────────┘  └─────────┘  └─────────┘  └─────────┘     │ │
│  └─────────────────────────────────────────────────────────┘ │
│                                                              │
└──────────────────────────────────────────────────────────────┘