闪电贷官方文档导读：主流 DeFi 协议接口速查与对照

在动手写闪电贷合约之前，认真翻一翻协议方的官方文档是节省时间的最快路径。然而每个协议的文档结构、命名习惯都不一样，新手很容易在术语之间迷路。本文把目前最常用的几家协议的官方文档做一次系统梳理，让你在写代码前就能找到所有需要的关键字。

一、AAVE V3 官方文档结构

AAVE 把文档放在 docs.aave.com，闪电贷条目位于「Developers > Periphery Contracts > Flash Loans」。它把闪电贷分成两类：单资产 flashLoanSimple 与多资产 flashLoan，分别对应 IFlashLoanSimpleReceiver 与 IFlashLoanReceiver 两个接口。

文档里最有价值的部分是「Errors」一节，列出了如 INVALID_FLASHLOAN_EXECUTOR_RETURN、COLLATERAL_BALANCE_IS_ZERO 等错误码及触发条件。把这些错误码对照 闪电贷常见错误 阅读，能够大幅缩短调试时间。

二、PancakeSwap V3 官方文档结构

PancakeSwap 的文档位于 docs.pancakeswap.finance，V3 闪电贷条目藏在「Developers > Contracts > V3 > Pool」。核心接口是 IPancakeV3Pool.flash，回调写在使用方合约里实现 IPancakeV3FlashCallback。

相比 AAVE，PancakeSwap 的费率更低（按池子 fee tier 决定），但单池资金量受限于该池流动性。如果你需要更大额度，可以考虑组合多个池子的闪电贷。具体的工程化方案可以参考 闪电贷代码示例 中的 Multi-Pool Router 模板。

三、Balancer V2 与 Radiant 的官方文档

Balancer V2 的闪电贷资源在 docs.balancer.fi/reference/contracts/flash-loans，最大的特点是「零手续费」——你只要在交易内归还本金即可。这让 Balancer 成为很多套利机器人的首选 funding source，但同时也意味着 Balancer 池子的流动性会被频繁占用。

Radiant 是建立在 LayerZero 之上的全链借贷协议，官方文档位于 docs.radiant.capital。它的闪电贷接口对标 AAVE V3，但支持跨链调用，特别适合需要在 BSC 与 Arbitrum 之间套利的策略。结合 Etherscan API怎么用 的事件订阅，可以同时监控两条链的资金流。

四、文档阅读的通用方法

面对一份新协议的官方文档，建议按以下顺序通读：第一，先看「Overview」理解业务模型；第二，再看「Interfaces」拿到函数签名；第三，深入「Errors / Reverts」掌握失败路径；第四，最后翻「Examples」检查官方提供的样例。这个套路同样适用于阅读 BIP39官方文档 等加密原语规范。

另一个小技巧是关注协议的 GitHub。多数协议在 examples/ 或 flash-loan-recipe/ 仓库下放有可直接编译运行的样例工程，比文档中的代码片段更完整。

五、踩坑速查清单

根据社区反馈，使用官方文档时最容易踩到三个坑：第一，把不同版本的接口混用——例如把 AAVE V2 的 flashLoan(address[],…) 函数签名套到 V3 上；第二，忽略「premium」与「fee」的差异，导致归还金额计算错误；第三，把回调里的 msg.sender 校验写成 tx.origin，被钓鱼合约劫持。这些细节在 闪电贷安全审计 中有更系统的清单。

如果你已经把上述官方文档过了一遍，再去看 闪电贷进阶教程 与 闪电贷最佳实践 会更加得心应手。把文档读厚再读薄，才是 DeFi 工程师真正的基本功。