forge snapshot

名称

forge-snapshot - 创建每个测试的 Gas 使用快照。

简介

forge snapshot [options]

描述

创建每个测试的 Gas 使用快照。

结果被写入一个名为 .gas-snapshot 的文件中。你可以通过传递 --snap <PATH> 来改变该文件的名称。

在快照中默认包括模糊测试。它们使用一个静态种子来实现确定性的结果。

快照可以用 --diff--check 来比较。第一个标志将输出一个差异,第二个标志将输出一个差异 同时 如果快照不匹配,则以代码 1 退出。

选项

快照选项

--asc
按所用 Gas 对结果进行排序(升序)。

--desc
    按所用 Gas 对结果进行排序(降序)。

--min min_gas
    只包括使用了超过给定数量的 Gas 的测试。

--max max_gas
    只包括使用了小于给定数量的 Gas 的测试。

--tolerance threshold
    容忍指定百分比范围内的 gas 偏差 (0-100)。

--diff path
    输出一个与预先存在的快照的差异。

    默认情况下,比较是通过 .gas-snapshot 完成的。

--check path
    与预先存在的快照进行比较,如果它们不匹配,则以代码 1 退出。

    如果快照不匹配,则输出一个差异。

    默认情况下,比较是通过 .gas-snapshot 完成的。

--snap path
    快照的输出文件。默认:.gas-snapshot

Test Options

-m regex
--match regex
    只运行与指定正则匹配的测试函数。     已废弃: 请见 --match-test.

--match-test regex
    只运行与指定正则匹配的测试函数。

--no-match-test regex
    只运行与指定正则不匹配的测试函数。

--match-contract regex
    只运行与指定正则匹配的测试合约。

--no-match-contract regex
    只运行与指定正则不匹配的测试合约。

--match-path glob
    只运行与指定 glob 匹配的测试源文件。

--no-match-path glob
    只运行与指定 glob 不匹配的测试源文件。

--debug regex
    在调试器中运行一个测试。

    传递给这个标志的参数是你想要运行的测试函数的名称,它的作用与 --match-test 相同。     如果符合你指定标准的测试超过一个,你必须添加额外的过滤器,直到只找到一个测试(见 --match-contract-match-path)。

    无论测试的结果如何,匹配的测试将在调试器中打开。

    如果匹配的测试是一个模糊测试,那么它将在第一个失败用例上打开调试器。如果模糊测试没有失败,它将在最后一个模糊用例下打开调试器。

    为了更精细地控制运行哪种模糊用例,请参阅 forge debug

--gas-report
    打印一个 Gas 报告。

--allow-failure
    即使测试失败,也以代码 0 退出。

--fail-fast
    在第一次测试失败时终止测试。

--etherscan-api-key key
    Etherscan 的 API 密钥。如果被设置了,同时 --fork-url 也被设置了,就会使用 Etherscan 解码追踪。     环境变量:ETHERSCAN_API_KEY

EVM 选项

-f url
--rpc-url url
--fork-url url
    通过远程端点获取状态,而不是从一个空的状态开始。

    如果你想从一个特定的区块号码中获取状态,请参阅 --fork-block-number.

--fork-block-number block
    通过一个远程端点从一个特定的区块号中获取状态。请见 --fork-url.

--fork-retry-backoff <BACKOFF>
     初始化遇到错误时的重试退避。

--no-storage-caching
    明确禁止使用 RPC 缓存。

    所有存储槽完全从端点读取。请见 --fork-url

-v
--verbosity
    EVM 的日志级别。

    多次传递,以提高日志级别 (例如 -v, -vv, -vvv)。

    日志级别:     - 2: 打印所有测试的日志     - 3: 打印失败测试的执行追踪     - 4: 对所有测试进行跟踪,并对失败的测试进行设置跟踪     - 5: 打印所有测试的执行和设置跟踪

--sender address
    用作执行测试的地址

--initial-balance balance
    已部署合约的初始余额

--ffi
    开启 FFI 作弊码

Executor 选项

--base-fee <FEE>
--block-base-fee-per-gas <FEE>
    一个区块的基本费用(单位:Wei)。

--block-coinbase address
    区块的 coinbase。

--block-difficulty difficulty
    区块的难度。

--block-gas-limit gas_limit
    区块的 Gas 限制。

--block-number block
    区块号。

--block-timestamp timestamp
    区块的时间戳(以秒为单位)。

--chain-id chain_id
    链 ID。

--gas-limit gas_limit
    区块的 Gas 限制。

--gas-price gas_price
    Gas 价格(单位:Wei)。

--tx-origin address
    交易的 origin。

缓存选项

--force
    清除缓存和 artifacts 文件夹并重新编译。

链接器选项

--libraries libraries
    设置预链接库。

    参数的格式必须是 <remapped path to lib>:<library name>:<address>,例如 src/Contract.sol:Library:0x...

    也可以在你的配置文件中设置为 libraries = ["<path>:<lib name>:<address>"].

编译器选项

--optimize
    激活 Solidity 优化器。

--optimizer-runs runs
    优化器 runs 的选项。

--via-ir
    使用 Yul 作为编译管道的中间语言。

--revert-strings
    如何处理 revert 和 require 的结果字符串。

--use solc_version
    指定 solc 的版本,或一个本地 solc 的路径,以进行编译。

    有效值的格式为 x.y.zsolc:x.y.zpath/to/solc

--offline
    不使用网络,缺失的 solc 版本将不会被安装。

--no-auto-detect
    不使用 solc 的自动检测。

--ignored-error-codes error_codes
    从错误代码中忽略 solc 警告。该参数是一个以逗号分隔的错误代码列表。

--extra-output selector
    额外的产出要包括在合约的 artifact 中。

    示例键: abi, storageLayout, evm.assembly, ewasm, ir, ir-optimized, metadata

    关于完整的描述, 请参阅 [Solidity docs][output-desc]。

--extra-output-files selector
    额外的输出写到单独的文件。

    示例键: abi, storageLayout, evm.assembly, ewasm, ir, ir-optimized, metadata.

    关于完整的描述, 请参阅 [Solidity docs][output-desc].

--evm-version version
    目标 EVM 版本

Project Options

--build-info
    生成构建信息文件。

--build-info-path path
    输出目录的路径,构建信息文件将被写入。

--root path
    项目的根路径。默认情况下,这是当前 git 仓库的根目录,或当前工作目录。

-C path
--contracts path
    合约源代码目录。     环境变量:DAPP_SRC

--lib-paths path
    库的文件夹路径。

-R remappings
--remappings remappings
    项目的重映射。

    该参数是一个逗号分隔的重映射列表,格式为 <source>=<dest>

--cache-path path
    编译器缓存的路径。

--config-path file
    配置文件的路径。

--hh
--hardhat
    这是一个方便的标志,与传递 --contracts contracts --lib-paths node-modules 相同。

-o path
--out path
    项目的 artifacts 目录。

--silent
    抑制所有输出。

Display Options

-j
--json
     将部署信息打印成 JSON 格式。

普通选项

-h
--help
    打印帮助信息。

例子

  1. 创建一个快照:

    forge snapshot
    
  2. 生成一个差异:

    forge snapshot --diff
    
  3. 检查快照是否匹配:

    forge snapshot --check
    

另请参阅

forge, forge test