findscripter 何时使用
适用：
- 搭建带奖励分发的质押平台（StakingRewards 模式）。
- 实现 AMM 自动做市商（恒定乘积、流动性 LP、swap）。
- 创建治理代币与提案投票系统（ERC20Votes + Governor）。
- 开发借贷/借出协议、集成闪电贷、上线流动性挖矿。
不该用（负边界）：
- 任务与 DeFi 合约无关，或纯前端 DApp、链下脚本、数据分析。
- 目标链非 EVM（如 Solana/Move 系），本模板基于 Solidity + OpenZeppelin。
- 把这些模板当作可直接主网部署的成品——它们是骨架，缺少审计、测试与场景化校验。
步骤
- 明确目标、约束与必需输入：协议类型、代币标准、费率、奖励曲线、权限模型。
- 选定对应模板（质押 / AMM / 治理 / 闪电贷）作为起点，按需裁剪。
- 复用成熟库：OpenZeppelin（ReentrancyGuard、Ownable、ERC20Votes）或 Solmate，避免手写底层。
- 编写测试：单元测试 + 集成测试 + 模糊测试（fuzzing），覆盖边界与攻击面。
- 上线前做专业安全审计；先发 MVP，再逐步增量加功能。
- 部署后持续监控合约健康度与用户活动，并准备应急暂停（pause）机制。
指令
- 先澄清目标、约束与所需输入，再动手。
- 套用对应最佳实践并验证产出，给出可执行步骤与验证方法。
- 需要更完整示例时打开
resources/implementation-playbook.md。 - 不得把输出当作环境化验证、测试或专家评审的替代品；缺少必需输入、权限、安全边界或成功标准时，停下来询问。
示例
质押合约核心（StakingRewards，含奖励累计与重入防护）：
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/security/ReentrancyGuard.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
contract StakingRewards is ReentrancyGuard, Ownable {
IERC20 public stakingToken;
IERC20 public rewardsToken;
uint256 public rewardRate = 100; // 每秒奖励
uint256 public lastUpdateTime;
uint256 public rewardPerTokenStored;
mapping(address => uint256) public userRewardPerTokenPaid;
mapping(address => uint256) public rewards;
mapping(address => uint256) public balances;
uint256 private _totalSupply;
modifier updateReward(address account) {
rewardPerTokenStored = rewardPerToken();
lastUpdateTime = block.timestamp;
if (account != address(0)) {
rewards[account] = earned(account);
userRewardPerTokenPaid[account] = rewardPerTokenStored;
}
_;
}
function rewardPerToken() public view returns (uint256) {
if (_totalSupply == 0) return rewardPerTokenStored;
return rewardPerTokenStored +
((block.timestamp - lastUpdateTime) * rewardRate * 1e18) / _totalSupply;
}
function earned(address account) public view returns (uint256) {
return (balances[account] *
(rewardPerToken() - userRewardPerTokenPaid[account])) / 1e18 + rewards[account];
}
function stake(uint256 amount) external nonReentrant updateReward(msg.sender) {
require(amount > 0, "Cannot stake 0");
_totalSupply += amount;
balances[msg.sender] += amount;
stakingToken.transferFrom(msg.sender, address(this), amount);
}
// withdraw / getReward / exit 同理，均带 nonReentrant + updateReward
}
AMM 核心：恒定乘积定价 + 0.3% 手续费的 swap：
// 0.3% fee；amountOut = resOut * amountInWithFee / (resIn + amountInWithFee)
uint256 amountInWithFee = (amountIn * 997) / 1000;
amountOut = (resOut * amountInWithFee) / (resIn + amountInWithFee);
治理：用 ERC20Votes 做投票快照，提案校验 getPastVotes(msg.sender, block.number - 1) >= proposalThreshold，投票按 getPastVotes 在 startBlock 的权重计票，forVotes > againstVotes 且过 endBlock 后方可 execute。
闪电贷：先 transfer 借出，回调 executeOperation，再校验 balanceAfter >= balanceBefore + fee 验证还款，否则 revert（费率示例 feePercentage = 9 即 0.09%，fee = amount * feePercentage / 10000）。
注意事项
最佳实践：
- 复用成熟库：OpenZeppelin、Solmate。
- 充分测试：单元 / 集成 / 模糊测试。
- 上线前做专业安全审计。
- 从简起步，MVP 优先，增量加功能。
- 监控合约健康度与用户活动。
- 可升级性：评估代理（proxy）模式。
- 紧急控制：为关键问题预留暂停机制。
常见 DeFi 模式：TWAP（抗预言机操纵的时间加权均价）、流动性挖矿、Vesting 线性释放、多签（Multisig）、时间锁（Timelock）。
约束与局限：仅在任务明确落在上述范围内时使用；不要将输出当作环境化校验、测试或专家评审的替代；缺少必需输入、权限、安全边界或成功标准时应停止并询问。
互见
源仓库附带的深入参考（如需可对照查阅）：
references/staking.md：质押机制与奖励分发references/liquidity-pools.md：AMM 数学与定价references/governance-tokens.md：治理与投票系统references/lending-protocols.md：借贷实现references/flash-loans.md：闪电贷安全与用例assets/*.sol：质押 / AMM / 治理 / 借贷的完整合约模板
采编自 sickn33/antigravity-awesome-skills（MIT）。