Dapp-Learning 研读笔记:AAVE V1 白皮书核心机制深度解读——借贷池、健康度、利率模型与清算体系
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)**定义为:账户的总抵押品价值与清算阈值之积,比上总债务与债务费用之和,即白皮书中的公式:
通俗地说,健康度 = 账户总抵押品的"可清算价值"总和 ÷ 总债务(含利息)总和。当健康度小于 1 时,说明资不抵债,进入可清算状态;健康度越高,头寸越安全。
值得注意的是,AAVE 全协议以 ETH 作为计价单位(totalCollateralInETH、totalDebtInETH),而 Compound 以 USD 计价。在 calculateUserAccountData() 中,遍历用户所有资产,将每种资产的 aToken 余额与 StableDebtToken/VariableDebtToken 余额经预言机价格换算成 ETH 后累加,同时按"抵押品价值占比"加权求出平均 LTV 与平均清算阈值,最终算出健康因子。若用户无抵押也无借贷,健康因子直接返回 uint256(-1)。
另外,GenericLogic.balanceDecreaseAllowed() 会在用户取款/减少抵押时"预演"计算取款后的健康因子,若低于清算阈值(HEALTH_FACTOR_LIQUIDATION_THRESHOLD)则禁止操作——这是源码对"健康度"概念最直接的应用。
三、形式化定义:从公式到链上实现
白皮书用一套形式化符号描述借贷状态与利率,原笔记逐一做了注释,并多处与 Compound 对照。以下按原笔记顺序展开。
3.1 时间计量:区块时间戳
对比: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 借贷总额与资金利用率
- :固定利率借贷总额(Stable Borrows)
- :浮动利率借贷总额(Variable Borrows)
- :总借贷
对比:Compound 中不存在"固定利率借贷总额"这一概念,所有借贷利率均为浮动,按每个区块的资金利用率实时确定。
资金利用率(Utilization Rate)定义为:
即总借贷除以资金池总流动性 。而 Compound 的资金利用率是:
即总借贷与(现金 + 借贷 − 保证金)之比。二者的分母口径不同,这也是原笔记提出"AAVE 的 到底指什么、什么叫做总流动性"的疑问来源。在 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));
也就是说,链上实现中 (总流动性)= 池中可用现金(availableLiquidity)+ 已借出的总债务,资金利用率即"借出的钱占池子总资产(含借出部分)的比例"。
3.3 浮动利率:拐点型(两段式)利率模型
白皮书定义浮动利率参数:
- :基础浮动利率
- :拐点前浮动利率(斜率 1)
- :拐点后浮动利率(斜率 2)
浮动利率为分段线性函数:
原笔记指出:AAVE 的浮动利率实质与 Compound 的拐点型借贷利率模型相同——当利用率超过最优值 后利率陡增,急剧抬高借款成本并提高存款利率,从而鼓励存款、抑制借款,降低资金池利用率,缓解流动性枯竭风险。
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)
);
固定利率的基准利率 则由 LendingRateOracle(利率预言机)按"多个市场的利率加权平均"提供,源码中通过 ILendingRateOracle(addressesProvider.getLendingRateOracle()).getMarketBorrowRate(reserve) 获取。
3.4 累计流动性指数与复利
这一定义与 Compound 利率指数高度相似。Compound 的复利关键公式为 ,即一段时间 [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),只取展开式前三项:
代码中 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 累积浮动借贷利率指数
它描述浮动利率借贷总额 在利率 下随时间累积产生的利息。原笔记在此处留下两个待澄清点:一是"累计的是利率还是利息",二是"乘方如何理解"。结合 ReserveLogic 笔记 与 VariableDebtToken 的实现可以澄清:
variableBorrowIndex(对应 )记录的是"每单位浮动债务截至当前时刻的本息累计乘数",即公式中的乘方项(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 其他待理解符号
原笔记列出还需进一步理解的符号:。结合仓库文档可作如下对应:
- (流动性利率 / 存款利率)→
currentLiquidityRate,是固定与浮动借贷利率的加权平均,再乘以资金利用率与(1 - reserveFactor); - →
liquidityIndex; - →
variableBorrowIndex; - → 池子平均稳定利率
_avgStableRate(StableDebtToken 中维护,池子总利息 ÷ 池子总本金); - → 归一化收入
getReserveNormalizedIncome,aToken 计算余额时使用amountScaled * NormalizedIncome(见 AToken.balanceOf)。
四、合约架构:四方角色与模块划分
从架构图看,AAVE 协议存在四方角色:
- 普通用户:提供流动性(Deposit)、移除流动性(Withdraw),获得 aToken;
- 清算者(Liquidator):对健康度低于 1 的头寸发起清算并获取奖励;
- 资金池(LendingPool):协议的核心入口合约;
- 预言机(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 的两个步骤:
- updateState():先更新
liquidityIndex与variableBorrowIndex(线性/复利累计),若有新增资产收益则按 reserveFactor 划一部分进金库(_mintToTreasury); - 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、用户有抵押且有清算阈值、债务不为 0);
- 计算单次最大可清算债务
(stableDebt + variableDebt) * LIQUIDATION_CLOSE_FACTOR_PERCENT(V2 为 50%); - 按
_calculateAvailableCollateralToLiquidate计算清算人可获得的抵押品数量(含liquidationBonus); - 优先烧毁浮动债务,不足补固定债务;
- 清算人转入债务资产,获得等值抵押品 + 清算奖励(可选择收 aToken 或原始资产);
- 若抵押品被全部清算,则清除该用户的抵押标记。
清算机器人(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 稳定利率的基准来自利率预言机
固定利率(稳定利率)的基准利率 并不像浮动利率那样由合约公式直接推出,而是由 LendingRateOracle(借贷利率预言机) 提供——源码中 getMarketBorrowRate(reserve) 返回多个市场利率的加权平均,作为固定利率的起点,再叠加两段式斜率(_stableRateSlope1 / _stableRateSlope2)得到当前稳定借贷利率。
7.2 稳定利率债务的记账方式
由于每个用户的固定利率不同,StableDebtToken 对每个用户单独维护平均稳定利率 _usersStableRate[user],并在每次新借款时做加权平均(公式见 V2 白皮书笔记):
池子全局也维护一个平均稳定利率 _avgStableRate(同样按总债务加权),用于在 updateInterestRates 中计算整体加权借贷利率。用户的稳定债务余额为:
对应 StableDebtToken.balanceOf:accountBalance * calculateCompoundedInterest(stableRate, timestamp)。还款时按"池子总利息 − 该笔还款抵消的利息"重新计算平均利率,若出现数值异常(如 user rate × user balance > avg rate × total supply)则直接清零重来,见 burn-stable。
7.3 稳定利率再平衡(rebalanceStableBorrowRate)
当稳定利率头寸偏离合理区间时,协议允许调用 rebalanceStableBorrowRate(asset, user) 将用户的稳定债务重新定价为当前池子稳定利率(内部实现为:烧毁全部固定债务 → 按新利率重新 mint)。触发条件(见 LendingPool 笔记):
- 资金利用率高于 95%(Utilization > 0.95);
- 当前存款 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)的具体数值以官方各版本参数为准。


