Dapp-Learning 研读笔记:AAVE V1 白皮书核心机制深度解读——借贷池、健康度、利率模型与清算体系

原创2026-10-12 10:15:501,819 阅读
文章标签:示例工程区块链Web3教程

Dapp-Learning 研读笔记:AAVE V1 白皮书核心机制深度解读——借贷池、健康度、利率模型与清算体系

本文以 Dapp-Learning 仓库中的 AAVE whitepaper V1 学习笔记 为主体脉络,结合仓库内 AAVE 合约源码分析(LendingPool、ReserveLogic、GenericLogic、DefaultReserveInterestRateStrategy 等 9 篇)与 AAVE-interest 利率笔记 展开。读完本文,你将掌握 AAVE V1 白皮书中金库/借贷池、LTV、清算阈值与账户健康度、两段式浮动利率模型、累计流动性指数等核心概念的形式化定义,理解这些公式在链上合约中的落地方式,并能对比 Compound 的借贷机制差异,为阅读 V2/V3 技术文档打下基础。

一、为什么从 V1 白皮书入手

AAVE 的前身是 2017 年推出的 ETHLend,其最初采用点对点(P2P)撮合借贷模式;随后协议演变为 P2Protocol(点对协议池)模式,即用户不再与单个对手方撮合,而是与一个统一的资金池交互,这就是 AAVE V1 的核心设计。正如原笔记所述,AAVE 与 Compound 的借贷机制存在诸多相似之处,但又在利率、计价单位、头寸粒度等细节上做出了不同取舍。

原笔记的作者(Dapp-Learning 社区成员)在整理该文档时明确建议:不必苛求一次性完全理解 AAVE 的全部设计取舍,而是按照白皮书目录逐项阅读、逐项理解,把浅薄的理解先写下来,再通过源码印证。本文延续这一思路,用"白皮书定义 + 源码落地"双线并进的方式组织内容。

需要说明的是,本文的契约分析素材主要来自仓库中针对 AAVE 协议(含 V2 合约)的源码解读文档,用于印证白皮书中的公式与流程;对于 V1 与 V2 之间的差异,文中会明确标注。

二、基础概念:金库、LTV 与账户健康度

2.1 金库(Vault / Reserve)

AAVE 中的借贷池核心是金库概念:每一个资金池(reserve)持有数种不同 Token 的余额,将所有 Token 以 ETH 计价后求和,即得到该资金池的总流动性(Total Liquidity)。

  • 流动性提供者(Liquidity Provider)向金库存入 Token;
  • 借款人需要先在金库中有一定存款,以这笔存款作为抵押,借出另一种(或同种)Token。

与 Compound 对比:Compound 中每个 cToken 对应一个池子,用户向某个 cToken 池子提供 Token 获得 cToken;借贷时,Compound 会根据预言机价格计算用户持有的所有 cToken 总价值,判断用户流动性是否允许借贷。而从 AAVE 白皮书看,它的一个 reserve 内含多种 Token——即一个借贷池由多种 Token 组成。这一对比在原笔记中留有"是否理解正确"的疑问,后文结合源码(ReserveData 结构)会进一步澄清:实际上 V2 中每个 reserve 对应一种资产,但白皮书 V1 中描述了多 Token 混合池的形态。

2.2 LTV(loanToValue)

每个金库都有一个特定的 LTV(总贷款与总价值的比率),它由该金库中每一个 Token 的 LTV 经过加权平均得到。LTV 决定了借款人最多能以抵押品价值的多大比例借出资产。

在合约层面,LTV 存储在 DataTypes.sol 的 ReserveConfigurationMap 中,以 bitmap 形式压缩存储:bit 0-15 为 LTV,bit 16-31 为清算阈值(Liq. threshold),bit 32-47 为清算奖励(Liq. bonus),bit 48-55 为精度,bit 56-59 为资产激活/冻结/借贷开关,bit 64-79 为 reserve factor(准备金比例)。这种用单个 uint256 承载多个配置项的位图设计,是为节省存储(SSTORE)成本所做的典型 gas 优化。

2.3 清算(Liquidation)

清算是借贷协议保护资金池免受系统性风险的最后防线:当被抵押 Token 价格向下波动,导致用户抵押品价值低于债务价值时(如下图 E 点),超过部分就会被清算,同时给清算者提供奖励。

清算触发示意图(价格下跌导致抵押品价值低于债务)

在 V2 合约实现中,清算由 LendingPool.liquidationCall() 发起,实际逻辑通过 delegatecall 委托给 LendingPoolCollateralManager 执行。核心清算参数包括:

  • LIQUIDATION_CLOSE_FACTOR_PERCENT:单次最多可清算总债务的比例(V2 中为 50%),即 maxLiquidatableDebt = (userStableDebt + userVariableDebt) * close_factor;
  • liquidationBonus:清算奖励比例(合约中为 1+奖励百分比,如 DAI 清算奖励 5% 则 liquidationBonus = 105%),清算人可获得的抵押品数量为: maxAmountCollateralToLiquidate = (debtAssetPrice * debtToCover * liquidationBonus) / collateralPrice;
  • 清算时优先清算浮动利率债务,不足部分再以固定利率债务补足;清算人可选择接收 aToken 或原始资产。

2.4 清算阈值 Lq 与账户健康度

原笔记指出"清算阈值 Lq 需要进一步看代码明确含义"。结合源码可以给出更精确的定义:清算阈值(Liquidation Threshold)是触发清算的抵押率边界。在 GenericLogic.calculateHealthFactorFromBalances() 中:

function calculateHealthFactorFromBalances(
    uint256 totalCollateralInETH,
    uint256 totalDebtInETH,
    uint256 liquidationThreshold
  ) internal pure returns (uint256) {
    if (totalDebtInETH == 0) return uint256(-1);   // 无债务时健康度视为无穷大
    return (totalCollateralInETH.percentMul(liquidationThreshold)).wadDiv(totalDebtInETH);
}

AAVE 提出的**账户健康度(Health Factor)**定义为:账户的总抵押品价值与清算阈值之积,比上总债务与债务费用之和,即白皮书中的公式:

Hf=TotalCollateralETH×LQaTotalBorrowsETH+TotalFeesETHH_f=\frac{TotalCollateralETH\times L_Q^a}{TotalBorrowsETH+TotalFeesETH}

通俗地说,健康度 = 账户总抵押品的"可清算价值"总和 ÷ 总债务(含利息)总和。当健康度小于 1 时,说明资不抵债,进入可清算状态;健康度越高,头寸越安全。

值得注意的是,AAVE 全协议以 ETH 作为计价单位(totalCollateralInETH、totalDebtInETH),而 Compound 以 USD 计价。在 calculateUserAccountData() 中,遍历用户所有资产,将每种资产的 aToken 余额与 StableDebtToken/VariableDebtToken 余额经预言机价格换算成 ETH 后累加,同时按"抵押品价值占比"加权求出平均 LTV 与平均清算阈值,最终算出健康因子。若用户无抵押也无借贷,健康因子直接返回 uint256(-1)。

另外,GenericLogic.balanceDecreaseAllowed() 会在用户取款/减少抵押时"预演"计算取款后的健康因子,若低于清算阈值(HEALTH_FACTOR_LIQUIDATION_THRESHOLD)则禁止操作——这是源码对"健康度"概念最直接的应用。

三、形式化定义:从公式到链上实现

白皮书用一套形式化符号描述借贷状态与利率,原笔记逐一做了注释,并多处与 Compound 对照。以下按原笔记顺序展开。

3.1 时间计量:区块时间戳

T, 当前时间戳=block.timestampT,\ 当前时间戳 = block.timestamp

对比:Compound 以 block.number(区块高度)作为时间计量单位;AAVE 以区块时间戳计量;Uniswap V2 同样以区块时间戳作为预言机计算时间加权平均价格的计量单位。

在合约中,ReserveData.lastUpdateTimestamp(类型 uint40)即记录上次利率指数更新的时间戳,MathUtils 中的 calculateLinearInterest / calculateCompoundedInterest 都以 block.timestamp - lastUpdateTimestamp 作为时间间隔 ΔT。见 ReserveLogic 笔记 与 MathUtils 笔记(SECONDS_PER_YEAR = 365 days,忽略闰年)。

3.2 借贷总额与资金利用率

  • BsB_s:固定利率借贷总额(Stable Borrows)
  • BvB_v:浮动利率借贷总额(Variable Borrows)
  • Bt=Bs+BvB_t = B_s + B_v:总借贷

对比:Compound 中不存在"固定利率借贷总额"这一概念,所有借贷利率均为浮动,按每个区块的资金利用率实时确定。

资金利用率(Utilization Rate)定义为:

U={0,if Lt=0,Bt/Lt,if Lt>0.U=\left\{ \begin{aligned} 0 & , & if\ L_t=0, \\ B_t/L_t & , & if\ L_t >0. \end{aligned} \right.

即总借贷除以资金池总流动性 LtL_t。而 Compound 的资金利用率是:

Ua=Borrowsa(Casha+Borrowsa−Reservesa)U_a = \frac{Borrows_a}{(Cash_a + Borrows_a - Reserves_a)}

即总借贷与(现金 + 借贷 − 保证金)之比。二者的分母口径不同,这也是原笔记提出"AAVE 的 LtL_t 到底指什么、什么叫做总流动性"的疑问来源。在 DefaultReserveInterestRateStrategy.calculateInterestRates() 的源码中可看到 AAVE 的实际实现:

// 总债务 = 固定债务 + 浮动债务
vars.totalDebt = totalStableDebt.add(totalVariableDebt);
// 流动性利用率 U = totalDebt / totalLiquidity
// totalLiquidity = 可用流动性 + 总债务(已借出的流动性)
vars.utilizationRate = vars.totalDebt == 0
  ? 0
  : vars.totalDebt.rayDiv(availableLiquidity.add(vars.totalDebt));

也就是说,链上实现中 LtL_t(总流动性)= 池中可用现金(availableLiquidity)+ 已借出的总债务,资金利用率即"借出的钱占池子总资产(含借出部分)的比例"。

3.3 浮动利率:拐点型(两段式)利率模型

白皮书定义浮动利率参数:

  • Rv0R_{v0}:基础浮动利率
  • Rslope1R_{slope1}:拐点前浮动利率(斜率 1)
  • Rslope2R_{slope2}:拐点后浮动利率(斜率 2)

浮动利率为分段线性函数:

Rv={Rv0+U/Uoptimal×Rslope1,if U<Uoptimal,Rv0+Rslope1+U−Uoptimal1−Uoptimal×Rslope2,if U≥Uoptimal.R_v=\left\{ \begin{aligned} R_{v0}+U/U_{optimal}\times R_{slope1} & , & if\ U<U_{optimal}, \\ R_{v0}+R_{slope1}+\frac{U-U_{optimal}}{1-U_{optimal}}\times R_{slope2} & , & if\ U\ge U_{optimal}. \end{aligned} \right.

原笔记指出:AAVE 的浮动利率实质与 Compound 的拐点型借贷利率模型相同——当利用率超过最优值 UoptimalU_{optimal} 后利率陡增,急剧抬高借款成本并提高存款利率,从而鼓励存款、抑制借款,降低资金池利用率,缓解流动性枯竭风险。

AAVE-interest 笔记 给出了直观的利率曲线图(两段式利率),并强调当利用率超过最佳使用率时利率上涨非常快,促使借款人尽快还款,否则很可能被清算:

两段式利率曲线:利用率超过最优值后利率陡增

对应到源码,DefaultReserveInterestRateStrategy 中的公式变量均为 immutable(初始化后不可更改),且以 ray(1e27 精度)存储:

变量名 公式对应 变量类型
OPTIMAL_UTILIZATION_RATE U_optimal ray
EXCESS_UTILIZATION_RATE 1 - U_optimal ray
_baseVariableBorrowRate R_base(浮动) ray
_variableRateSlope1 R_slope1(浮动) ray
_variableRateSlope2 R_slope2(浮动) ray
_stableRateSlope1 R_slope1(固定) ray
_stableRateSlope2 R_slope2(固定) ray

源码中当 U > OPTIMAL_UTILIZATION_RATE 时:

uint256 excessUtilizationRateRatio =
  vars.utilizationRate.sub(OPTIMAL_UTILIZATION_RATE).rayDiv(EXCESS_UTILIZATION_RATE);
// R_base (variable) + R_slope1 + excessUtilizationRateRatio * R_slope2
vars.currentVariableBorrowRate = _baseVariableBorrowRate.add(_variableRateSlope1).add(
  _variableRateSlope2.rayMul(excessUtilizationRateRatio)
);

当 U <= OPTIMAL_UTILIZATION_RATE 时:

// R_base (variable) + U / U_optimal * R_slope1
vars.currentVariableBorrowRate = _baseVariableBorrowRate.add(
  vars.utilizationRate.rayMul(_variableRateSlope1).rayDiv(OPTIMAL_UTILIZATION_RATE)
);

固定利率的基准利率 RbaseR_{base} 则由 LendingRateOracle(利率预言机)按"多个市场的利率加权平均"提供,源码中通过 ILendingRateOracle(addressesProvider.getLendingRateOracle()).getMarketBorrowRate(reserve) 获取。

3.4 累计流动性指数与复利

Cit (累计流动性指数)=Cit−1×(1+Rl×ΔTyear)C_i^t\ (累计流动性指数)=C_i^{t-1}\times (1+R_l\times \Delta T_{year})

Ci0=1×1027=1 rayC_i^0=1\times10^{27}=1\ ray

这一定义与 Compound 利率指数高度相似。Compound 的复利关键公式为 IndexB/IndexA=(1+borrowRate[A]⋅ΔBlocks)Index_B/Index_A = (1+borrowRate[A]\cdot\Delta Blocks),即一段时间 [A, B] 内利率指数之比 = 1 + A 点借贷利率 × 间隔区块数,本质上是把这段时间的利息积累反映到指数比中。

在 AAVE 合约中,流动性指数的累计由 ReserveLogic._updateIndexes() 完成:

  • 流动性指数(liquidityIndex):采用线性累计,newLiquidityIndex = calculateLinearInterest(currentLiquidityRate, timestamp).rayMul(liquidityIndex),其中线性累计公式为 1 + rate * timeDifference / SECONDS_PER_YEAR;
  • 浮动借贷指数(variableBorrowIndex):采用复利累计,newVariableBorrowIndex = calculateCompoundedInterest(currentVariableBorrowRate, timestamp).rayMul(variableBorrowIndex)。

MathUtils 中的复利计算值得单独说明:Solidity 不支持浮点指数运算,若用循环遍历实现 (1+ratePerSecond)^seconds 将消耗巨额 gas,因此合约采用二项式近似(Binomial approximation),只取展开式前三项:

(1+x)n=1+nx+12n(n−1)x2+16n(n−1)(n−2)x3+…(1+x)^{n}=1+nx+\frac{1}{2}n(n-1)x^2+\frac{1}{6}n(n-1)(n-2)x^3+\dots

代码中 secondTerm = exp*(exp-1)*x^2/2、thirdTerm = exp*(exp-1)*(exp-2)*x^3/6,后续项因数值极小被舍弃。该近似会让结果略小于理论值(轻微少付存款人、少收借款人),但大幅节省 gas,白皮书附录中给出了不同时间区间的误差表。同时指数均以 uint128 存储,并有 RL_LIQUIDITY_INDEX_OVERFLOW / RL_VARIABLE_BORROW_INDEX_OVERFLOW 溢出检查。

3.5 累积浮动借贷利率指数

Bvct (累积浮动借贷利率指数)=(1+RvTyear)ΔTx×Bvct−1B_{vc}^t\ (累积浮动借贷利率指数)=(1+\frac{R_v}{T_{year}})^{\Delta T_x}\times B_{vc}^{t-1}

它描述浮动利率借贷总额 BvB_v 在利率 RvR_v 下随时间累积产生的利息。原笔记在此处留下两个待澄清点:一是"累计的是利率还是利息",二是"乘方如何理解"。结合 ReserveLogic 笔记 与 VariableDebtToken 的实现可以澄清:

  • variableBorrowIndex(对应 BvcB_{vc})记录的是"每单位浮动债务截至当前时刻的本息累计乘数",即公式中的乘方项 (1+R_v/T_year)^ΔT 是复利因子;
  • 用户的实际债务 = 缩放后的债务本金 scaledBalance × variableBorrowIndex(balanceOf 中执行 scaledBalance.rayMul(_pool.getReserveNormalizedVariableDebt(...)));
  • 与 Compound 用 Borrows_B = Borrows_A * Index_B / Index_A 的思路一致,但 AAVE 通过"每次操作前先更新 index"的方式把复利摊入全局指数。

另外需要注意:没有 StableBorrowIndex(稳定利率全局指数)。因为每个用户的固定利率各不相同、不随池子全局变量实时变化,所以每个稳定利率借款人都会单独维护一个平均固定利率变量——在 StableDebtToken 合约中体现为 mapping(address => uint256) _usersStableRate(参见 DebtToken 笔记 与 ReserveLogic 笔记 中的说明)。

3.6 其他待理解符号

原笔记列出还需进一步理解的符号:Rl,Cit,Int,Bvct,Bvcxt,Bx,Bxc,Rsat,MR_l, C_i^t, I_n^t, B_{vc}^t, B_{vcx}^t, B_x, B_{xc}, R_{sa}^t, M。结合仓库文档可作如下对应:

  • RlR_l(流动性利率 / 存款利率)→ currentLiquidityRate,是固定与浮动借贷利率的加权平均,再乘以资金利用率与 (1 - reserveFactor);
  • CitC_i^t → liquidityIndex;
  • BvctB_{vc}^t → variableBorrowIndex;
  • RsatR_{sa}^t → 池子平均稳定利率 _avgStableRate(StableDebtToken 中维护,池子总利息 ÷ 池子总本金);
  • IntI_n^t → 归一化收入 getReserveNormalizedIncome,aToken 计算余额时使用 amountScaled * NormalizedIncome(见 AToken.balanceOf)。

四、合约架构:四方角色与模块划分

AAVE 合约架构图

从架构图看,AAVE 协议存在四方角色:

  1. 普通用户:提供流动性(Deposit)、移除流动性(Withdraw),获得 aToken;
  2. 清算者(Liquidator):对健康度低于 1 的头寸发起清算并获取奖励;
  3. 资金池(LendingPool):协议的核心入口合约;
  4. 预言机(Oracle):提供资产价格,供借贷额度与健康度计算使用。

仓库中的 AAVE 合约架构指南 给出了更完整的模块清单(以 V2 为主,可对照理解 V1 的骨架):

主合约(Main contracts)

  • LendingPool:协议最主要的入口合约,用户大部分情况下与此合约交互,提供 deposit() / borrow() / repay() / swapBorrowRateMode() / setUserUseReserveAsCollateral() / withdraw() / flashloan() / liquidationCall() 等接口;
  • LendingPoolAddressesProvider:主要地址存储合约,针对不同市场(不同公链的 AAVE)各有不同,外部合约通过它获取其他模块的最新合约地址;
  • LendingPoolAddressesProviderRegistry:维护不同市场 provider 合约地址的注册表;
  • AToken:计息代币,用户存入抵押资产时 1:1 获得(如存 100 DAI 得 100 aDAI),基于 ERC20 增加 scaledBalanceOf() / getScaledUserBalanceAndSupply() / scaledTotalSupply() 接口,并通过 permit() 支持 EIP-2612;
  • Stable / Variable Debt Tokens:用户借出资产时获得 1:1 的债务代币,大部分 ERC20 方法(transfer / allowance)被禁用,因为债务不可转让。

辅助合约(Supporting contracts)

  • LendingPoolCollateralManager:执行具体清算逻辑,LendingPool 通过 delegatecall 调用(注意其存储布局与 LendingPool 兼容,见 LendingPoolCollateralManager 笔记 开头的说明);
  • LendingPoolConfigurator:为 LendingPool 提供配置功能,每项配置变更都会发事件上链;
  • ReserveInterestRateStrategy:利率更新策略合约(DefaultReserveInterestRateStrategy);
  • Price Oracle Provider:价格预言机提供合约;
  • WETHGateway:用户以 ETH 操作时需要先包装为 WETH 再与 LendingPool 交互;
  • Treasury:协议金库,AToken 中每笔存入抵押品都会分出一定比例(reserveFactor)作为准备金。

部署流程(aave-protocol-v2/tasks/full)大致为:先部署 LendingPoolAddressesProviderRegistry(同一网络可注册多个市场)→ 部署当前市场的 LendingPoolAddressesProvider 并注册 → 部署 LendingPool / LendingPoolConfigurator 及 Helper 合约 → 部署 AaveOracle 与 LendingRateOracle → 部署 AaveProtocolDataProvider → 部署 WETHGateway → 批量部署每种资产对应的 AToken / StableDebtToken / VariableDebtToken 并初始化利率策略。详见 合约部署流程。

五、借贷池核心数据结构与利率联动

原笔记在"合约架构"下留出了"借贷池核心 / 借贷池数据提供者 / 借贷池 / 借贷池配置 / 利率模型 / 治理"等空小节,这里用源码补齐最关键的一块:ReserveData 数据结构。

DataTypes.sol 定义了链上借贷状态的核心载体:

struct ReserveData {
  ReserveConfigurationMap configuration;      // 位图配置(LTV/清算阈值/清算奖励/精度/开关/reserve factor)
  uint128 liquidityIndex;                     // 每单位流动性累计本息(ray)
  uint128 variableBorrowIndex;                // 每单位浮动债务累计本息(ray)
  uint128 currentLiquidityRate;               // 当前存款(流动性)利率
  uint128 currentVariableBorrowRate;          // 当前浮动借贷利率
  uint128 currentStableBorrowRate;            // 当前固定借贷利率
  uint40 lastUpdateTimestamp;                 // 上次指数更新时间戳
  address aTokenAddress;                      // 计息存款代币
  address stableDebtTokenAddress;             // 固定利率债务代币
  address variableDebtTokenAddress;           // 浮动利率债务代币
  address interestRateStrategyAddress;        // 利率策略合约地址
  uint8 id;                                   // 资产在活跃资产列表中的序号
}

用户级配置 UserConfigurationMap 同样是一个 uint256 位图:每个资产占两位,第一位表示是否抵押、第二位表示是否借贷(00/01/10/11 四种状态),最多可表达 128 个资产的配置,由 Configuration 笔记 中的 setBorrowing / setUsingAsCollateral / isBorrowingAny 等位操作维护。

利率的联动更新是理解 AAVE 的关键。每一次 deposit / withdraw / borrow / repay / swapBorrowRateMode 都会触发 ReserveLogic 的两个步骤:

  1. updateState():先更新 liquidityIndex 与 variableBorrowIndex(线性/复利累计),若有新增资产收益则按 reserveFactor 划一部分进金库(_mintToTreasury);
  2. updateInterestRates():读取 StableDebtToken 的总债务与平均稳定利率、VariableDebtToken 的缩放总供应量,调用 ReserveInterestRateStrategy.calculateInterestRates() 得到新的流动性利率、稳定利率与浮动利率,并校验 uint128 上限后写回,最后广播 ReserveDataUpdated 事件。

其中 currentLiquidityRate(存款利率)的计算式为:

currentLiquidityRate = overallBorrowRate * U * (100% - reserveFactor)

overallBorrowRate 是浮动与固定利率按债务量加权的平均借贷利率((variableDebt*variableRate + stableDebt*stableRate) / totalDebt)。这也是 AToken.balanceOf 注释中给出的完整推导链。

六、借贷池合约的八类操作

原笔记列出了借贷池合约的八类操作:存款、取款、借款、还款、兑换利率、清算、闪电贷、代币化。结合 LendingPool 笔记 逐一展开(接口签名以仓库记录为准)。

6.1 存款(deposit)

用户向池子存入 amount 数量资产,获得相同数量的 aToken(含息)。参数为 asset / amount / onBehalfOf(aToken 接收者)/ referralCode(推介码,直接调用填 0)。

  • 前置要求:先 approve 授权 LendingPool 足够的额度;
  • 流程:validateDeposit 校验 → reserve.updateState() 更新指数 → updateInterestRates(asset, aToken, amount, 0) 更新利率 → 从用户转入资产 → IAToken.mint(onBehalfOf, amount, reserve.liquidityIndex);
  • 若是该资产第一次存入(之前抵押余额为 0),自动将用户的该资产标记为可抵押类型(setUsingAsCollateral)。

aToken 的数量缩放是理解存款利息的关键(见 AToken.mint / amount and amountScaled):实际 mint 的数量是 amountScaled = amount / liquidityIndex,即把当前时刻存入的金额缩放到 t₀(池子创建时刻)的数量。由于 liquidityIndex 随时间增长,用户查询 balanceOf 时通过 amountScaled * NormalizedIncome 还原出"本金 + 利息",从而抹平不同存入时刻的利率差异,实现统一复利记账。

6.2 取款(withdraw)

销毁相应数量 aToken,赎回 amount 数量抵押资产;amount 传 type(uint256).max 表示赎回全部余额。

  • 流程:validateWithdraw 校验(会调用 balanceDecreaseAllowed 检查取款后健康度)→ updateState() → updateInterestRates(asset, aToken, 0, amountToWithdraw) → aToken.burn() 销毁缩放数量并把原资产转给 to;
  • 若赎回全部余额,则将该资产的抵押标记置为 false。

6.3 借款(borrow)

参数为 asset / amount / interestRateMode(1 = 固定,2 = 浮动)/ onBehalfOf(债务承担者)/ referralCode。借款人必须有足够抵押,或被授予足够的信用额度(credit delegation)。

  • 流程:预言机将借款额换算成 ETH(amountInETH = assetPrice * amount / 10^decimals)→ validateBorrow 校验(含可借额度上限 _maxStableRateBorrowSizePercent)→ updateState() → 按利率模式调用 StableDebtToken 或 VariableDebtToken 的 mint;
  • 固定利率借款以当前固定利率(reserve.currentStableBorrowRate)计息,该利率在借款时刻锁定,不随市场波动(但不同时间借款的固定利率不同,见 ReserveLogic 笔记 的说明);
  • 浮动利率借款记录缩放数量 amount / variableBorrowIndex;
  • 若为该用户的第一笔借款,自动把该资产标记为借贷状态;最后 updateInterestRates 并释放资产给受益人。

6.4 还款(repay)

参数为 asset / amount(传 uint(-1) 表示偿还全部债务)/ rateMode / onBehalfOf。流程:读取用户固定与浮动债务 → validateRepay → 按模式调用对应 debtToken 的 burn → updateInterestRates(asset, aToken, paybackAmount, 0) → 从还款人账户拉取资产;还清后清除用户的借贷标记。

6.5 兑换利率(swapBorrowRateMode)

用户可在固定/浮动利率之间切换:先读取债务 → validateSwapRateMode → 销毁原类型 debtToken、按目标模式重新 mint(金额不变),并更新利率。固定转浮动时使用 variableBorrowIndex 重新缩放,浮动转固定时锁定当前 currentStableBorrowRate。

6.6 清算(liquidationCall)

liquidationCall(collateralAsset, debtAsset, user, debtToCover, receiveAToken) 清算健康度低于 1 的头寸。LendingPool 通过 delegatecall 委托 LendingPoolCollateralManager 执行:

  1. 计算用户健康因子并校验(健康因子 < 1、用户有抵押且有清算阈值、债务不为 0);
  2. 计算单次最大可清算债务 (stableDebt + variableDebt) * LIQUIDATION_CLOSE_FACTOR_PERCENT(V2 为 50%);
  3. 按 _calculateAvailableCollateralToLiquidate 计算清算人可获得的抵押品数量(含 liquidationBonus);
  4. 优先烧毁浮动债务,不足补固定债务;
  5. 清算人转入债务资产,获得等值抵押品 + 清算奖励(可选择收 aToken 或原始资产);
  6. 若抵押品被全部清算,则清除该用户的抵押标记。

清算机器人(liquidator bot)的操作要点在 LendingPool 笔记的 Liquidation process 一节 中有完整说明:监听事件或调用 getUserAccountData() 发现可清算头寸,用 AaveProtocolDataProvider.getUserReserveData() 获取头寸明细,计算 debtToCover = (stableDebt + variableDebt) * CloseFactor,并按"清算奖励价值 − 交易成本"评估利润。仓库中还给出了一个最小清算合约示例(Liquidator),核心就是 approve 后调用 lendingPool.liquidationCall(...)。

6.7 闪电贷(flashloan)

flashLoan(receiverAddress, assets[], amounts[], modes[], onBehalfOf, params, referralCode) 允许在一笔交易内借出池中流动性,交易结束前须归还本金 + 手续费(V2 中 premium = amount * _flashLoanPremiumTotal / 10000,默认 9bps 左右)。

  • mode = 0:未归还则整个交易 revert;
  • mode = 1 / 2:未归还则自动为 onBehalfOf 开立固定/浮动利率债务;
  • 关键机制:LendingPool 先转账给接收合约,回调 receiver.executeOperation(...),要求返回 true 且合约已授权足够额度(pull 方式),否则失败——这也是 LendingPool 笔记 中回答"为什么 flashLoan 不需要 nonReentrant"的原因:回调返回值校验 + 拉取模式天然阻断递归调用;
  • 对比 V1/V2 差异(见 V2 白皮书笔记):V1 在转账前对余额做快照、结束后检查余额 ≥ 快照 + 利息;V2 改为直接转账 + 结束时从用户账户拉取本金与手续费,省去两次快照与重入锁。

闪电贷接收合约示例(V2,源自仓库笔记):继承 FlashLoanReceiverBase,实现 executeOperation 回调(在回调内编写资金用途逻辑,最后对每笔资产 approve 还款额并 return true),再由 myFlashLoanCall() 组装资产/数量/模式数组调用 LENDING_POOL.flashLoan(...)。

6.8 代币化(Tokenization)

即存款/债务的代币化表达:

  • aToken:存款凭证,余额随 liquidityIndex 增长自动生息,可自由转让;
  • StableDebtToken / VariableDebtToken:债务凭证,不可转让(transfer/allowance 直接 revert),balanceOf 返回含息债务,totalSupply 返回全协议该资产总债务;
  • 固定利率债务按"用户平均固定利率 + 时间"线性复利计息(StableDebtToken.balanceOf 中 cumulatedInterest = (1+rate)^time,用二项式近似计算);
  • 浮动利率债务按全局 variableBorrowIndex 还原(scaledBalance * variableBorrowIndex);
  • 此外 debt token 支持 approveDelegation / borrowAllowance,即"信用委托"——抵押资产持有者可授权他人使用其信用额度借款(冷钱包抵押、热钱包操作场景),详见 DebtToken 笔记。

七、稳定利率模型与再平衡

原笔记"稳定利率模型"一节留有多个空小节(借贷利率预言机、当前稳定借贷利率 Rs3、对稳定利率头寸的限制、稳定汇率再平衡、再平衡过程)。结合仓库材料补充如下。

7.1 稳定利率的基准来自利率预言机

固定利率(稳定利率)的基准利率 RbaseR_{base} 并不像浮动利率那样由合约公式直接推出,而是由 LendingRateOracle(借贷利率预言机) 提供——源码中 getMarketBorrowRate(reserve) 返回多个市场利率的加权平均,作为固定利率的起点,再叠加两段式斜率(_stableRateSlope1 / _stableRateSlope2)得到当前稳定借贷利率。

7.2 稳定利率债务的记账方式

由于每个用户的固定利率不同,StableDebtToken 对每个用户单独维护平均稳定利率 _usersStableRate[user],并在每次新借款时做加权平均(公式见 V2 白皮书笔记):

SRt=SDt×SRt−1+SBnew×SRtSDt+SBnewSR_t=\frac{SD_t\times SR_{t-1}+SBnew\times SR_t}{SD_t+SBnew}

池子全局也维护一个平均稳定利率 _avgStableRate(同样按总债务加权),用于在 updateInterestRates 中计算整体加权借贷利率。用户的稳定债务余额为:

SD(x)=SB(x)⋅(1+SRtTyear)ΔTSD(x) = SB(x)\cdot(1+\frac{SR_t}{T_{year}})^{\Delta T}

对应 StableDebtToken.balanceOf:accountBalance * calculateCompoundedInterest(stableRate, timestamp)。还款时按"池子总利息 − 该笔还款抵消的利息"重新计算平均利率,若出现数值异常(如 user rate × user balance > avg rate × total supply)则直接清零重来,见 burn-stable。

7.3 稳定利率再平衡(rebalanceStableBorrowRate)

当稳定利率头寸偏离合理区间时,协议允许调用 rebalanceStableBorrowRate(asset, user) 将用户的稳定债务重新定价为当前池子稳定利率(内部实现为:烧毁全部固定债务 → 按新利率重新 mint)。触发条件(见 LendingPool 笔记):

  1. 资金利用率高于 95%(Utilization > 0.95);
  2. 当前存款 APY 低于 REBALANCE_UP_THRESHOLD * maxVariableBorrowRate,意味着过多人以稳定利率借款、存款人收益不足。

八、与 Compound 的机制对照小结

维度 AAVE(V1 白皮书) Compound
计价单位 ETH(totalCollateralInETH / totalDebtInETH) USD
时间计量 区块时间戳 block.timestamp 区块高度 block.number
利率模式 浮动 + 固定(稳定)双轨,固定利率可再平衡 全部浮动
资金利用率 总借贷 / 总流动性(现金 + 已借出) Borrows / (Cash + Borrows − Reserves)
利率模型 两段式拐点模型,超过 U_optimal 后斜率陡增 拐点型模型(本质一致)
健康度 抵押品价值 × 清算阈值 / 总债务(ETH 计价) 抵押品价值 / 借款价值(USD 计价)
单次清算上限 V2 中 LIQUIDATION_CLOSE_FACTOR_PERCENT(50%) 按 cToken 池规则执行
复利实现 线性/复利指数 + 二项式近似 利率指数 Index

九、结语与延伸阅读

AAVE V1 白皮书确立的三大支柱——抵押池化借贷(P2Protocol)、两段式利率模型与健康度驱动的清算体系——构成了后续 V2/V3 演进的基础。本仓库中配套的合约源码分析(contract/ 目录)把白皮书的每个公式都对应到了具体函数与状态变量,是深入理解"白皮书 → 代码"映射的最佳路径。

感兴趣的读者可继续阅读:

  • AAVE V2 白皮书笔记:稳定利率债务公式、V1/V2 闪电贷差异、多利率加权等;
  • AAVE 利率模型笔记:两段式利率曲线与 ReserveData 各利率字段的关系;
  • 合约源码逐篇解读:LendingPool、ReserveLogic、GenericLogic、DefaultReserveInterestRateStrategy、AToken、DebtToken、LendingPoolCollateralManager、Configuration、MathUtils 共 9 篇;
  • AAVE DAO 笔记:AAVE 代币分配与 ARC/AIP 治理提案流程;
  • AAVE 官方 V1 白皮书 PDF(仓库内留存)。

提示:本文涉及的合约接口与参数(如 LIQUIDATION_CLOSE_FACTOR_PERCENT、_flashLoanPremiumTotal、REBALANCE_UP_THRESHOLD)以仓库内源码解读文档记录为准;不同版本(V1/V2/V3)的具体数值以官方各版本参数为准。

登录后查看全文
Dapp-Learning