跳到正文
Code Review
← 规则库/语言与脚本

评审检查清单

Solidity

语言与脚本63 个检查项15 个章节
**/*.sol
01

Solidity 评审原则

0 项
精确优先于召回:只报告可能在可达路径上导致资金损失、记账错误、永久锁定或安全漏洞的问题。提出任何算术类发现之前先读取 pragma —— Solidity >=0.8 默认在溢出和下溢时回退(revert),因此在 unchecked 块之外报告未检查的回绕属于误报。.sol 扩展名也用于 Gerber PCB 阻焊层文件;若该文件不是 Solidity 源码,则不作任何报告。

不要重复 solc、Slither 或 solhint 已经标记的问题,除非该 diff 造成了具体的正确性影响。报告非局部行为之前,先核实调用方、modifier 链、继承的实现和存储布局,而不是凭名称推断。

02

明显的拼写错误

2 项
  • 声明处的拼写错误,且会成为合约对外接口的一部分:函数、事件、error、状态变量、参数、struct 字段或 constant 的名称
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 不要报告注释、NatSpec 文本或 revert 字符串中的拼写错误,除非该字符串在其他地方被匹配使用
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

03

外部调用与重入

6 项
  • 状态在外部调用之后才写入而非之前,而被调用方可以重入并观察到过期状态(违反 Checks-Effects-Interactions 模式)
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 跨函数重入:入口函数带有 nonReentrant,但共享同一存储的兄弟函数却没有
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 跨合约重入:两个合约共享记账状态,却只有一方对该路径设防
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 只读重入:回调执行期间第三方查询的 view getter 返回了由半更新状态推导出的值
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 把 ERC777/ERC1155/ERC721 的 transfer 钩子以及 receive/fallback 当作无害;任何向任意地址的代币转移都是一次外部调用
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 只在包装函数上加了防护,而它委托调用的 internal 函数仍可从不设防的路径到达
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

04

未检查的调用结果

4 项
  • SOLIDITY-UNCHECKED-CALL-RESULTS-001状态加载中
    .call、.send 或 .delegatecall 的返回值被丢弃,失败的调用被当作成功继续执行
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-UNCHECKED-CALL-RESULTS-002状态加载中
    对未部署任何代码的地址进行底层调用会返回 true;在信任该结果前缺少 extcodesize 或等价的存在性检查
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-UNCHECKED-CALL-RESULTS-003状态加载中
    对不返回任何值或返回 false 而非回退(revert)的代币直接使用 ERC20 的 transfer、transferFrom 或 approve,此时需要 SafeERC20
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-UNCHECKED-CALL-RESULTS-004状态加载中
    成功标志被存入变量后从未对其进行断言
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

05

delegatecall 与代理可升级性

7 项
  • delegatecall 的目标可被调用方影响,或目标地址来自可变存储却没有白名单限制
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 代理与实现之间、或旧实现与新实现之间的存储槽冲突:变量被重排、插入或删除,而已消耗的 __gap 槽位没有相应减少同样数量
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 升级前后某变量变为 constant 或 immutable,或不再如此 —— 之后所有槽位都会偏移
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 实现合约仍可被初始化:缺少 initializer modifier、构造函数中未调用 _disableInitializers()、继承的 __X_init 从未被调用,或重复使用同一 reinitializer 版本
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 实现合约中可达的 selfdestruct 或 delegatecall,可能使所有指向它的代理全部瘫痪
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 代理与实现之间的函数选择器冲突或遮蔽,使调用被静默路由到错误的函数体
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 升级授权(_authorizeUpgrade、onlyProxy)缺失,或由非预期的角色把守
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

06

访问控制

6 项
  • SOLIDITY-ACCESS-CONTROL-001状态加载中
    特权函数缺少 onlyOwner/onlyRole modifier,或所带 modifier 并未约束它本应约束的值
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-ACCESS-CONTROL-002状态加载中
    使用 tx.origin 鉴别调用方身份
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-ACCESS-CONTROL-003状态加载中
    未设防的初始化函数、setter 或铸造入口
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-ACCESS-CONTROL-004状态加载中
    单步所有权转移到一个从未验证过的地址,而此处需要两步握手确认
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-ACCESS-CONTROL-005状态加载中
    角色的管理员仍是该角色自身,使成员可以把角色授予任何人
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-ACCESS-CONTROL-006状态加载中
    把原本 internal 的函数改为 public/external 可见性
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

07

算术与类型转换

5 项
  • unchecked 块的边界无法在局部证明 —— 循环计数器与 .length 比较没有问题,但对调用方提供的输入做减法则不行
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 向下转换(uint256 转更窄类型,或有符号/无符号转换)在可达取值上发生截断或符号翻转
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 先除后乘,在手续费、份额或利息计算中叠积精度损失
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 假定代币 decimals 为 18,或假定两个代币的 decimals 相同
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在存入与取出两条路径上,取整方向都偏向调用方而非协议
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

08

存储与初始化

4 项
  • 未初始化的局部 storage 指针,其写入会落在槽 0
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 本意是 storage 却改动了 struct 或数组的 memory 副本,导致写入被丢弃
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 对包含 mapping 的 struct 或数组执行 delete,mapping 中的数据仍然保留
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 期望 immutable 或 constant,值却在可能多次运行的函数中设置
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

09

Ether 与代币处理

5 项
  • transfer 或 send 依赖 2300 gas 补贴,而接收方可能是合约
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在循环中推式付款,某一个回退或耗 gas 的接收方会阻塞所有其他接收方;此处需要拉取(pull)模式
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 对 fee-on-transfer 或 rebasing 代币,按金额参数而非实测余额增量入账
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在循环或 payable multicall 中读取 msg.value,使一笔存款被重复计入
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 合约可以接收 Ether 却没有取出路径;或 receive/fallback 在协议依赖的路径上回退
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

10

随机性、时间与预言机

4 项
  • block.timestamp、block.number、blockhash 或 block.prevrandao 被用作任何有价值之物的随机来源
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 把现货池储备量、getReserves 或单区块 TWAP 当作价格读取,可被闪电贷操纵
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 消费 Chainlink 的 latestRoundData 时未检查数据陈旧度(updatedAt)、返回是否为正数或轮次完整性
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 假定区块间隔固定的时间戳比较
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

11

抢跑与 MEV

4 项
  • SOLIDITY-FRONT-RUNNING-AND-MEV-001状态加载中
    交换、铸造或赎回时既没有 deadline 也没有最小输出(或最大输入)限制
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-FRONT-RUNNING-AND-MEV-002状态加载中
    ERC20 的 approve 竞态,非零授权额度被另一个非零值覆盖
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-FRONT-RUNNING-AND-MEV-003状态加载中
    取值派生自攻击者可在同一区块或同一交易捆绑内推动的状态
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-FRONT-RUNNING-AND-MEV-004状态加载中
    commit-reveal 或拍卖逻辑因遗漏发送者或盐值(salt)而可被抢跑
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

12

Gas 与拒绝服务

3 项
  • 遍历数组或以 mapping 为底的列表,而任何调用方都能使其无界增长
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 外部调用、重 SLOAD 的读取或代币转移在循环内执行
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 存储中的数组无界增长,且没有删除或分页路径
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

13

事件与签名

5 项
  • SOLIDITY-EVENTS-AND-SIGNATURES-001状态加载中
    状态变更未发出事件;或事件的 indexed 字段无法标识受影响方
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-EVENTS-AND-SIGNATURES-002状态加载中
    abi.encodePacked 对两个及以上动态参数打包后送入哈希,可能造成碰撞;应使用 abi.encode
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-EVENTS-AND-SIGNATURES-003状态加载中
    签名在缺少 nonce、chain id 或 EIP-712 域分隔符的情况下被接受,允许跨账户、跨链或跨合约重放
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-EVENTS-AND-SIGNATURES-004状态加载中
    使用 ecrecover 时既未拒绝零地址,也未拒绝可塑(malleable)的高 s 形式
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-EVENTS-AND-SIGNATURES-005状态加载中
    签名校验未将签名载荷与调用方或具体操作绑定
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

14

内联汇编

4 项
  • SOLIDITY-INLINE-ASSEMBLY-001状态加载中
    汇编写入越过空闲内存指针,或分配后未更新该指针
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-INLINE-ASSEMBLY-002状态加载中
    mload/mstore/calldatacopy 的偏移或长度来自 calldata 却缺少边界检查
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-INLINE-ASSEMBLY-003状态加载中
    标注了 memory-safe 的代码块并不满足内存安全规则
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-INLINE-ASSEMBLY-004状态加载中
    手工计算的存储槽与编译器分配的槽位重叠
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

15

测试正确性

4 项
  • SOLIDITY-TESTING-CORRECTNESS-001状态加载中
    模糊测试的 vm.assume 或取值范围恰好过滤掉了性质本身所关注的值域
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-TESTING-CORRECTNESS-002状态加载中
    测试对名称所指的行为没有任何断言,或仅断言调用没有回退
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-TESTING-CORRECTNESS-003状态加载中
    分叉测试未固定区块编号,导致不可复现
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • SOLIDITY-TESTING-CORRECTNESS-004状态加载中
    Mock 永远返回成功,掩盖了本次变更引入的失败路径
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

返回本页顶部 ↑继续浏览规则库

手动复制规则链接

浏览器未允许自动复制,请选中下方链接复制。