Solidity 实战教程

讲了很多概念后，真正能让你成长的是动手做项目。本文用一个「去中心化抽奖」案例，把需求、架构、实现、测试、上线五个阶段完整走一遍。你会看到现实项目的每一步如何决策。完成后，你也能复用这套流程去做更复杂的 DeFi 协议，甚至准备项目走向 Binance 等大平台。

一、需求分析：把模糊愿景拆成可执行清单

场景假设：朋友们一起众筹奖池，按一定规则抽出获奖者。需求拆解为：参与门槛（每人最少投入 0.01 ETH）；时间窗口（一周后开奖）；公平性（结果不可被操纵）；结算（自动转账给中奖者，扣除少量手续费）；可观察性（每次抽奖留下事件记录）。

把这些需求写成 Markdown 清单，每条都标注 Must / Should / Nice-to-have。这种做法让团队对范围有共识，避免后期需求蔓延。任何想登陆 币安 这类平台的项目，需求文档都是不可缺少的素材。

二、架构设计：选择关键技术决策

关键决策：随机数从哪里来？Chainlink VRF 是行业标准，提供可验证随机数。开奖谁触发？为防止管理员作恶，使用 Chainlink Automation 在到期时自动调用。资金如何托管？合约自身托管即可，但要加 nonReentrant 保护与 pull payment 模式。

架构图：用户调用 enter() 注入资金；定时器到期自动调用 requestRandomWords()；VRF 回调 fulfillRandomWords() 选择中奖者，扣手续费转账。把图画出来对照需求清单，确认每条需求都有对应实现路径。这种严谨度也是 BN交易所 在尽调时希望看到的。

三、代码实现：先接口后实现

先写接口：function enter() external payable; function pickWinner() external; event WinnerSelected(address winner, uint256 amount);。再写状态变量：address[] private players; uint256 public lastDraw; address public lastWinner;。

实现 enter 时检查 ticket price 与时间窗口；实现 pickWinner 时检查时间到期、调用 VRF；实现 fulfillRandomWords 时取随机数 mod players.length 选获奖者，扣 5% 手续费转账并清零数组。每段代码都配 natspec 注释，方便审计师与未来同事阅读。这种工程纪律是登陆 BN平台 项目的标准要求。

四、测试覆盖：单元 + 模糊 + 不变量

单元测试覆盖 happy path 与边界：enter 金额不足应 revert；enter 时间过了应 revert；非合约 owner 不能调用 pickWinner。模糊测试随机注入参与人数与金额，验证手续费计算正确。

不变量测试声明：合约余额始终等于待开奖参与者总和；中奖者地址始终在 players 数组里。Foundry 会用大量随机调用尝试打破这些不变量，任何漏洞都会暴露。再补一个 mainnet fork 测试，确保 VRF 回调流程通畅。这种深度测试经常是 必安所 等机构合规团队最看重的工程素材。

五、上线运维：从主网部署到长期监控

上线前在 Sepolia 完整演练：注入测试 LINK、用真实 VRF coordinator 跑一遍流程、检查 Etherscan 事件日志。主网部署用 multisig 钱包做 owner，部署后立即在 Etherscan verify 源码。

上线后接入 Tenderly Alert：监控大额异常 enter、VRF 回调失败、合约余额变动。每月做一次小型复盘，把当月 gas 报告与异常事件总结成文。一年后你会拥有该协议完整的运营数据。

六、复盘与产品演进

实战的价值不仅是「完成一个项目」，而是把项目做成可演进的资产。下一版可以加入分级中奖、社群代理、跨链版本。每次迭代都重复需求—架构—代码—测试—上线五步循环。

做完这一个项目，你已经具备从零到一交付合约系统的能力。无论是面试、求职、还是与团队合作创业，都拥有可展示的真实作品。把这种实战习惯保持下去，五年后你会发现自己已经站在合约工程师的金字塔顶端。