nimbus-eth1/tools/evmstate/readme.md

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.

1. Use your system Nim compiler(v1.6.12) and git to install dependencies.

   $> git submodule update --init --recursive
   $> ./env.sh (run once to generate nimbus-build-system.paths)
   $> nim c -d:release tools/evmstate/evmstate
   $> 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
   $> ./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].
 --verbosity         sets the verbosity level [=0].
                        0 = silent, 1 = error, 2 = warn, 3 = info, 4 = debug, 5 = detail.