bugs.rst

.. index:: Bugs

已知bug列表

在下面，你可以找到一个 JSON 格式的列表，上面列出了 Solidity 编译器上一些已知的安全相关的 bug。 该文件被放置于 Github 仓库 。 该列表可以追溯到 0.3.0 版本，只在此版本之前存在的 bug 没有被列入。

这里，还有另外一个 bugs_by_version.json 文件。 该文件可用于查询特定的某个编译器版本会受哪些 bug 影响。

合约的源文件检查工具以及其他与合约交互的工具，需基于以下规则查阅上述 bug 列表文件：

• 如果合约是用每日构建版本的编译器编译，而不是发布版本的编译器，那就有点可疑了。上述bug列表不跟踪未发布或每日构建版本的编译器。
• 如果一个合约并不是由它被创建时点的最新版本编译器所编译的，那么这也是值得怀疑的。对于由其他合约创建的合约，您必须沿着创建链追溯最初交易，并使用该交易的日期作为创建日期。
• 高度可疑的情况是，如果一份合约由一个包含已知 bug 的编译器编译，但在合约创建时，已修复了相应 bug 的新版编译器已经发布了。

下面这份包含已知 bug 的 JSON 文件实际上是一个对象数组，每个对象对应一个 bug，并包含以下的 keys :

uid

在表格中 SOL-<year>-<number> 唯一的编号。 有可能存在多个具有相同UID的条目。这意味着多个版本范围受到同一错误的影响。

name

赋予该 bug 的唯一的名字

summary

对该 bug 的简要描述

description

对该 bug 的详细描述

link

包含更多详尽信息的链接，可选

introduced

第一个包含该 bug 的编译器的发布版本，可选

fixed

第一个不再包含该 bug 的编译器的发布版本

publish

该 bug 被公开的日期，可选

severity

bug 的严重性： very low， low， medium， high。综合考虑了在合约测试中的可发现性、发生的可能性和被利用后的潜在损害。

conditions

触发该 bug 所需满足的条件。当前，这是一个包含了 optimizer 布尔值的对象，这意味着只有打开优化器选项时，才会触发该 bug。 如果没有给出任何条件，则意味着此 bug 始终存在。

.. literalinclude:: bugs.json
   :language: js