Solidity 评审原则
0 项精确优先于召回:只报告可能在可达路径上导致资金损失、记账错误、永久锁定或安全漏洞的问题。提出任何算术类发现之前先读取pragma—— Solidity>=0.8默认在溢出和下溢时回退(revert),因此在unchecked块之外报告未检查的回绕属于误报。.sol扩展名也用于 Gerber PCB 阻焊层文件;若该文件不是 Solidity 源码,则不作任何报告。
不要重复 solc、Slither 或 solhint 已经标记的问题,除非该 diff 造成了具体的正确性影响。报告非局部行为之前,先核实调用方、modifier 链、继承的实现和存储布局,而不是凭名称推断。
明显的拼写错误
2 项外部调用与重入
6 项- 状态在外部调用之后才写入而非之前,而被调用方可以重入并观察到过期状态(违反 Checks-Effects-Interactions 模式)内置
来源与改动说明
- 跨函数重入:入口函数带有
nonReentrant,但共享同一存储的兄弟函数却没有内置来源与改动说明
- 跨合约重入:两个合约共享记账状态,却只有一方对该路径设防内置
来源与改动说明
- 只读重入:回调执行期间第三方查询的
viewgetter 返回了由半更新状态推导出的值内置来源与改动说明
- 把 ERC777/ERC1155/ERC721 的 transfer 钩子以及
receive/fallback当作无害;任何向任意地址的代币转移都是一次外部调用内置来源与改动说明
- 只在包装函数上加了防护,而它委托调用的
internal函数仍可从不设防的路径到达内置来源与改动说明
未检查的调用结果
4 项.call、.send或.delegatecall的返回值被丢弃,失败的调用被当作成功继续执行内置来源与改动说明
- 对未部署任何代码的地址进行底层调用会返回
true;在信任该结果前缺少extcodesize或等价的存在性检查内置来源与改动说明
- 对不返回任何值或返回
false而非回退(revert)的代币直接使用 ERC20 的transfer、transferFrom或approve,此时需要SafeERC20内置来源与改动说明
- 成功标志被存入变量后从未对其进行断言内置
来源与改动说明
delegatecall 与代理可升级性
7 项delegatecall的目标可被调用方影响,或目标地址来自可变存储却没有白名单限制内置来源与改动说明
- 代理与实现之间、或旧实现与新实现之间的存储槽冲突:变量被重排、插入或删除,而已消耗的
__gap槽位没有相应减少同样数量内置来源与改动说明
- 升级前后某变量变为
constant或immutable,或不再如此 —— 之后所有槽位都会偏移内置来源与改动说明
- 实现合约仍可被初始化:缺少
initializermodifier、构造函数中未调用_disableInitializers()、继承的__X_init从未被调用,或重复使用同一reinitializer版本内置来源与改动说明
- 实现合约中可达的
selfdestruct或delegatecall,可能使所有指向它的代理全部瘫痪内置来源与改动说明
- 代理与实现之间的函数选择器冲突或遮蔽,使调用被静默路由到错误的函数体内置
来源与改动说明
- 升级授权(
_authorizeUpgrade、onlyProxy)缺失,或由非预期的角色把守内置来源与改动说明
访问控制
6 项- 特权函数缺少
onlyOwner/onlyRolemodifier,或所带 modifier 并未约束它本应约束的值内置来源与改动说明
- 使用
tx.origin鉴别调用方身份内置来源与改动说明
- 未设防的初始化函数、setter 或铸造入口内置
来源与改动说明
- 单步所有权转移到一个从未验证过的地址,而此处需要两步握手确认内置
来源与改动说明
- 角色的管理员仍是该角色自身,使成员可以把角色授予任何人内置
来源与改动说明
- 把原本
internal的函数改为public/external可见性内置来源与改动说明
算术与类型转换
5 项unchecked块的边界无法在局部证明 —— 循环计数器与.length比较没有问题,但对调用方提供的输入做减法则不行内置来源与改动说明
- 向下转换(
uint256转更窄类型,或有符号/无符号转换)在可达取值上发生截断或符号翻转内置来源与改动说明
- 先除后乘,在手续费、份额或利息计算中叠积精度损失内置
来源与改动说明
- 假定代币 decimals 为 18,或假定两个代币的 decimals 相同内置
来源与改动说明
- 在存入与取出两条路径上,取整方向都偏向调用方而非协议内置
来源与改动说明
存储与初始化
4 项- 未初始化的局部
storage指针,其写入会落在槽 0内置来源与改动说明
- 本意是
storage却改动了 struct 或数组的memory副本,导致写入被丢弃内置来源与改动说明
- 对包含 mapping 的 struct 或数组执行
delete,mapping 中的数据仍然保留内置来源与改动说明
- 期望
immutable或constant,值却在可能多次运行的函数中设置内置来源与改动说明
Ether 与代币处理
5 项transfer或send依赖 2300 gas 补贴,而接收方可能是合约内置来源与改动说明
- 在循环中推式付款,某一个回退或耗 gas 的接收方会阻塞所有其他接收方;此处需要拉取(pull)模式内置
来源与改动说明
- 对 fee-on-transfer 或 rebasing 代币,按金额参数而非实测余额增量入账内置
来源与改动说明
- 在循环或
payablemulticall 中读取msg.value,使一笔存款被重复计入内置来源与改动说明
- 合约可以接收 Ether 却没有取出路径;或
receive/fallback在协议依赖的路径上回退内置来源与改动说明
随机性、时间与预言机
4 项block.timestamp、block.number、blockhash或block.prevrandao被用作任何有价值之物的随机来源内置来源与改动说明
- 把现货池储备量、
getReserves或单区块 TWAP 当作价格读取,可被闪电贷操纵内置来源与改动说明
- 消费 Chainlink 的
latestRoundData时未检查数据陈旧度(updatedAt)、返回是否为正数或轮次完整性内置来源与改动说明
- 假定区块间隔固定的时间戳比较内置
来源与改动说明
抢跑与 MEV
4 项- 交换、铸造或赎回时既没有 deadline 也没有最小输出(或最大输入)限制内置
来源与改动说明
- ERC20 的 approve 竞态,非零授权额度被另一个非零值覆盖内置
来源与改动说明
- 取值派生自攻击者可在同一区块或同一交易捆绑内推动的状态内置
来源与改动说明
- commit-reveal 或拍卖逻辑因遗漏发送者或盐值(salt)而可被抢跑内置
来源与改动说明
Gas 与拒绝服务
3 项事件与签名
5 项- 状态变更未发出事件;或事件的
indexed字段无法标识受影响方内置来源与改动说明
abi.encodePacked对两个及以上动态参数打包后送入哈希,可能造成碰撞;应使用abi.encode内置来源与改动说明
- 签名在缺少 nonce、chain id 或 EIP-712 域分隔符的情况下被接受,允许跨账户、跨链或跨合约重放内置
来源与改动说明
- 使用
ecrecover时既未拒绝零地址,也未拒绝可塑(malleable)的高s形式内置来源与改动说明
- 签名校验未将签名载荷与调用方或具体操作绑定内置
来源与改动说明
内联汇编
4 项- 汇编写入越过空闲内存指针,或分配后未更新该指针内置
来源与改动说明
mload/mstore/calldatacopy的偏移或长度来自 calldata 却缺少边界检查内置来源与改动说明
- 标注了
memory-safe的代码块并不满足内存安全规则内置来源与改动说明
- 手工计算的存储槽与编译器分配的槽位重叠内置
来源与改动说明
测试正确性
4 项- 模糊测试的
vm.assume或取值范围恰好过滤掉了性质本身所关注的值域内置来源与改动说明
- 测试对名称所指的行为没有任何断言,或仅断言调用没有回退内置
来源与改动说明
- 分叉测试未固定区块编号,导致不可复现内置
来源与改动说明
- Mock 永远返回成功,掩盖了本次变更引入的失败路径内置
来源与改动说明