本阶段课程
  1. EVM、合约、ABI 与状态
  2. Solidity 与本地合约测试
  3. ethers v6 与合约调用
  4. JSON-RPC、回执、事件与重组
  5. 链上索引与 GraphQL
  6. 预言机、价格来源与时效
  7. 合约权限、升级与安全验收
  8. DApp 发布、监控与重试
  9. 交易前端状态机 · 从点击到业务完成
  10. 合约发版验收 · 部署证据与角色交接
  11. 链上数据分析 · 事件、口径与数据延迟
  12. Solidity 事件实训 · 业务状态与索引字段
  13. Webhook 回调 · 签名核验、重复和乱序
  14. 事件索引表 · 原始记录、业务读模型与重建
本篇目录

阶段 03 · 第 2 / 14 课

Solidity 与本地合约测试

学完能做到:为简单合约设计角色、输入、状态和测试。

先看一个场景

票务合约需要限制管理员铸造,被核销票券不应再次入场。先在本地验证边界,再考虑上线。

核心原理

合约开发从状态模型和不变量开始。本地节点和测试框架用于重放成功、拒绝与边界输入。部署会固定链、地址与代码版本。

需要区分的概念

单元测试验证具体分支;模糊测试覆盖输入范围;不变量测试验证多步交互后仍成立的性质;集成测试覆盖钱包与数据层。

从伪代码写到验收条件

redeem(ticketId):
    holder = caller()
    require currentOwner(ticketId) == holder
    require redeemed[ticketId] == false
    redeemed[ticketId] = true
    emit Redeemed(ticketId, holder)

这段伪代码只描述状态规则。合约实现还要定义谁有权调用、如何证明实际持有人、合约可暂停的条件,以及转让后能否继续使用。测试环境可给两个模拟账户分别铸票,覆盖无权限、重复核销、转让后由新持有人核销。

部署产物至少保存源码提交、编译器配置、网络和合约地址。前端根据 ABI 生成调用,集成测试以部署后的合约为准跑一次完整流程。发现库或地址变化时先更新配置再重试。

把「不能重复入场」写成可核对的测试

初始状态是票 17 属于小周且未使用。调用一次核销后,读状态得到「已使用」,回执有一条核销事件。再用相同操作提交,预期被拒绝,票仍是「已使用」,第二笔不会产生一次有效核销。

测试类型 本地怎么做 验收证据
单元测试 让小周核销票 17 两次 第一次成功,第二次回退,只有一次有效事件
输入范围测试 在自动测试里试不存在、边界、正常的编号 不同编号得到各自合理结果
不变量测试 多次交错发行、转让和核销 无论顺序怎样,同一票都只有一次有效核销
集成测试 前端收到回执,等索引更新,再用同一账号查详情 页面与链上状态相符,明确处理等待

伪代码中的 caller() 指已由执行环境识别的调用者。这里采用持有人亲自调用的规则。如果产品允许验票员代为核销,需要另行检查验票员角色和持有人发出的授权。可以先写一份人工测试记录,再转换成脚本。

动手练习

列出空地址、重复核销、权限不足、正常转让、部署配置五组测试。记录预期回退原因与最终状态。

自测

哪条检查适合做不变量?

查看参考答案

例如,所有被核销票的再次核销都得失败。测试可在随机转让、铸造和核销后检查这一约束。

延伸阅读

记录本课进度

完成练习后标记。进度保存在当前浏览器。

搜索课程