理解跟踪(Traces)

Forge 可以为失败的测试(-vvv)或所有测试(-vvvv)生成跟踪(Traces)。

跟踪遵循相同的通用格式:

  [<Gas Usage>] <Contract>::<Function>(<Parameters>)
    ├─ [<Gas Usage>] <Contract>::<Function>(<Parameters>)
    │   └─ ← <Return Value>
    └─ ← <Return Value>

每个跟踪可以有更多的子跟踪(subtraces),每个 subtraces 表示对合约的调用和返回值。

如果您的终端支持颜色,跟踪也会有多种颜色:

  • 绿色:对于不会 revert 的调用
  • 红色:用于有 revert 的调用
  • 蓝色:用于调用作弊码
  • 青色:用于触发日志
  • 黄色:用于合约部署

Gas 使用量(标在方括号中)显示整个函数调用 Gas。 但是,您可能会注意到,有时一条 trace 的 Gas 使用量与其所有 subtraces 的 Gas 使用量和并不完全匹配:

  [24661] OwnerUpOnlyTest::testIncrementAsOwner()
    ├─ [2262] OwnerUpOnly::count()
    │   └─ ← 0
    ├─ [20398] OwnerUpOnly::increment()
    │   └─ ← ()
    ├─ [262] OwnerUpOnly::count()
    │   └─ ← 1
    └─ ← ()

下落不明的 Gas 是由于调用之间发生的一些额外操作,例如算术和存储读/写。

Forge 将尝试解码尽可能多的签名和值,但有时这是不可能的。 在这些情况下,Traces 将出现如下显示:

  [<Gas Usage>] <Address>::<Calldata>
    └─ ← <Return Data>