用途
DeFi Protocol Templates 提供面向去中心化金融（DeFi）协议开发的生产级模板，覆盖质押、自动做市商（AMM）、治理、借贷与闪电贷等常见协议类型。适用于以下场景：构建带奖励分配的质押平台；实现 AMM（自动做市商）协议；创建治理代币系统；开发借贷/借款协议；集成闪电贷功能；启动流动性挖矿（收益农场）平台。
主要能力与模板内容
资料以 Solidity 智能合约形式给出多个模板示例。
质押合约（StakingRewards）
使用 Solidity ^0.8.0，引入 @openzeppelin/contracts 的 IERC20、ReentrancyGuard、Ownable。合约包含质押代币与奖励代币、每秒奖励速率（rewardRate）、奖励累计（rewardPerTokenStored）、用户奖励与余额映射等。功能包括：stake（质押）、withdraw（提取）、getReward（领取奖励）、exit（退出，含提取与领取）。通过 updateReward 修饰器与 rewardPerToken、earned 视图函数计算奖励。
AMM（自动做市商，SimpleAMM）
使用 Solidity ^0.8.0，引入 IERC20。合约维护 token0、token1 两个代币及 reserve0、reserve1 储备量，并包含 LP 份额的 totalSupply 与 balanceOf。功能包括：addLiquidity（添加流动性，首次按 sqrt 计算份额，后续按比例取最小值铸造份额）、removeLiquidity（移除流动性并按份额比例返回两种代币）、swap（兑换，收取 0.3% 手续费，用 997/1000 计算）。合约内部包含 _mint、_burn、_update、sqrt、min 等私有辅助函数。
治理代币与治理（GovernanceToken、Governor）
使用 Solidity ^0.8.0，引入 ERC20Votes、Ownable。GovernanceToken 继承 ERC20Votes 与 Ownable，构造时铸造 1,000,000 枚代币，并重写 _afterTokenTransfer、_mint、_burn。Governor 合约包含 Proposal 结构体（id、proposer、description、forVotes、againstVotes、startBlock、endBlock、executed、hasVoted），包含投票期 votingPeriod（17280 个区块，约 3 天）与提案门槛 proposalThreshold。功能包括：propose（发起提案，要求提案人历史投票数达到门槛）、vote（投票，按 startBlock 历史投票权计票）、execute（执行，要求投票结束、未执行且赞成票多于反对票）。
闪电贷（FlashLoanProvider、FlashLoanReceiver）
使用 Solidity ^0.8.0，引入 IERC20，并定义 IFlashLoanReceiver 接口（executeOperation）。FlashLoanProvider 包含代币、feePercentage（9，即 0.09% 手续费）。flashLoan 流程：记录放贷前余额并校验流动性、计算手续费、向接收方转账、调用 executeOperation 回调、校验还款后余额不低于放贷前余额加手续费。示例 FlashLoanReceiver 实现 executeOperation，批准偿还本金加手续费。
使用方式
资料提供了 references 与 assets 两类资源：
- references/staking.md：质押机制与奖励分配
- references/liquidity-pools.md：AMM 数学与定价
- references/governance-tokens.md：治理与投票系统
- references/lending-protocols.md：借贷实现
- references/flash-loans.md：闪电贷安全与用例
- assets/staking-contract.sol：生产级质押模板
- assets/amm-contract.sol：完整 AMM 实现
- assets/governance-token.sol：治理系统
- assets/lending-protocol.sol：借贷平台模板
关于具体安装命令、调用方式、收费与平台支持等信息，资料暂未提供。
适用场景
适合需要快速搭建 DeFi 基础协议原型的开发者，包括质押与奖励、AMM 兑换与流动性、治理代币与投票、借贷以及闪电贷集成等方向。
最佳实践
- 使用成熟库：OpenZeppelin、Solmate
- 充分测试：单元测试、集成测试、模糊测试
- 上线前审计：专业安全审计
- 从简开始：先做 MVP，再逐步增加功能
- 监控：跟踪合约健康与用户活动
- 可升级性：考虑代理模式实现升级
- 应急控制：为关键问题提供暂停机制
常见 DeFi 模式
- 时间加权平均价格（TWAP）：价格预言机抗操纵
- 流动性挖矿：激励流动性提供
- 代币锁定释放（Vesting）：锁定代币并逐步释放
- 多重签名（Multisig）：关键操作需多签名
- 时间锁（Timelocks）：延迟执行治理决策
限制
具体收费、价格、平台支持、实际部署步骤与安全审计结论等信息，资料暂未提供。合约代码用于模板参考，实际使用需自行完成测试与审计。