nimbus-eth1/tools/evmstate/readme.md

54 lines
1.7 KiB
Markdown
Raw Normal View History

2022-10-26 15:46:13 +00:00
## EVM state test tool
The `evmstate` tool to execute state test.
### Build instructions
There are few options to build `evmstate` tool like any other nimbus tools.
2023-08-01 02:25:18 +00:00
1. Use your system Nim compiler(v1.6.12) and git to install dependencies.
2022-10-26 15:46:13 +00:00
```
2023-08-01 02:25:18 +00:00
$> git submodule update --init --recursive
$> ./env.sh (run once to generate nimbus-build-system.paths)
$> nim c -d:release tools/evmstate/evmstate
2022-10-26 15:46:13 +00:00
$> nim c -r -d:release tools/evmstate/evmstate_test
```
2. Use nimbus shipped Nim compiler and dependencies.
```
$> make update deps
$> ./env.sh nim c -d:release tools/evmstate/evmstate
2022-10-26 15:46:13 +00:00
$> ./env.sh nim c -r -d:release tools/evmstate/evmstate_test
```
3. Use nimbus makefile.
```
$> make update
$> make evmstate
$> make evmstate_test
```
### Command line params
Available command line params
```
Usage:
evmstate [OPTIONS]... <inputFile>
<inputFile> json file contains state test data.
The following options are available:
--dump dumps the state after the run [=false].
--json output trace logs in machine readable format (json) [=false].
--debug output full trace logs [=false].
--nomemory disable memory output [=true].
--nostack disable stack output [=false].
--nostorage disable storage output [=false].
--noreturndata enable return data output [=true].
--fork choose which fork to be tested.
--index if index is unset, all subtest in the fork will be tested [=none(int)].
--pretty pretty print the trace result [=false].
2022-10-26 15:46:13 +00:00
--verbosity sets the verbosity level [=0].
0 = silent, 1 = error, 2 = warn, 3 = info, 4 = debug, 5 = detail.
2022-10-26 15:46:13 +00:00
```