nimbus-eth1/tools/t8n
andri lim b3a5c67532
Remove exceptions from EVM (#2314)
* Remove exception from evm memory

* Remove exception from gas meter

* Remove exception from stack

* Remove exception from precompiles

* Remove exception from gas_costs

* Remove exception from op handlers

* Remove exception from op dispatcher

* Remove exception from call_evm

* Remove exception from EVM

* Fix tools and tests

* Remove exception from EVMC

* fix evmc

* Fix evmc

* Remove remnants of async evm stuff

* Remove superflous error handling

* Proc to func

* Fix errors detected by CI

* Fix EVM op call stack usage

* REmove exception handling from getVmState

* Better error message instead of just doAssert

* Remove unused validation

* Remove superflous catchRaise

* Use results.expect instead of unsafeValue
2024-06-07 15:24:32 +07:00
..
testdata Remove exceptions from EVM (#2314) 2024-06-07 15:24:32 +07:00
config.nim Fix EVM tracer crash bug when serializing nil stack (#1697) 2023-08-20 11:15:11 +07:00
config.nims Disable t8n log output (#2216) 2024-05-24 22:48:57 +07:00
helpers.nim results: use canonical import (#2248) 2024-05-30 14:54:03 +02:00
readme.md Fix EVM tracer crash bug when serializing nil stack (#1697) 2023-08-20 11:15:11 +07:00
t8n.nim Add EVM tracer test case for EIP-2929 opcodes 2023-08-31 09:49:51 +07:00
t8n_test.nim Add EVM tracer test case for EIP-2929 opcodes 2023-08-31 09:49:51 +07:00
transition.nim Remove exceptions from EVM (#2314) 2024-06-07 15:24:32 +07:00
txpriv.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
types.nim Fix t8n response cancun fields: rename currentBlobGasUsed to blobGasUsed 2023-10-24 21:22:49 +07:00

readme.md

EVM state transition tool

The t8n tool is a stateless state transition utility.

Build instructions

There are few options to build t8n 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 -d:chronicles_default_output_device=stderr tools/t8n/t8n
    $> nim c -r -d:release tools/t8n/t8n_test
    
  2. Use nimbus shipped Nim compiler and dependencies.
    $> make update deps
    $> ./env.sh nim c -d:release -d:chronicles_default_output_device=stderr tools/t8n/t8n
    $> ./env.sh nim c -r -d:release tools/t8n/t8n_test
    
  3. Use nimbus makefile.
    $> make update
    $> make t8n
    $> make t8n_test
    

Command line params

Available command line params

Usage:

t8n [OPTIONS]...

The following options are available:

 --trace                 Enable and set where to put full EVM trace logs [=disabled].
                             `stdout` - into the stdout output.
                             `stderr` - into the stderr output.
                             <file>   - into the file <file>-<txIndex>.jsonl.
                             none     - output.basedir/trace-<txIndex>-<txhash>.jsonl.
 --trace.memory          Enable full memory dump in traces [=false].
 --trace.nostack         Disable stack output in traces [=false].
 --trace.returndata      Enable return data output in traces [=false].
 --output.basedir        Specifies where output files are placed. Will be created if it does not exist.
 --output.body           If set, the RLP of the transactions (block body) will be written to this file.
 --output.alloc          Determines where to put the `alloc` of the post-state. [=alloc.json].
                             `stdout` - into the stdout output.
                             `stderr` - into the stderr output.
                             <file>   - into the file <file>.
 --output.result         Determines where to put the `result` (stateroot, txroot etc) of the post-state.
                             [=result.json].
                             `stdout` - into the stdout output.
                             `stderr` - into the stderr output.
                             <file>   - into the file <file>.
 --input.alloc           `stdin` or file name of where to find the prestate alloc to use. [=alloc.json].
 --input.env             `stdin` or file name of where to find the prestate env to use. [=env.json].
 --input.txs             `stdin` or file name of where to find the transactions to apply. If the file
                             extension is '.rlp', then the data is interpreted as an RLP list of signed
                             transactions. The '.rlp' format is identical to the output.body format.
                             [=txs.json].
 --state.reward          Mining reward. Set to -1 to disable [=0].
 --state.chainid         ChainID to use [=1].
 --state.fork            Name of ruleset to use. [=GrayGlacier].
                             - Frontier.
                             - Homestead.
                             - EIP150.
                             - EIP158.
                             - Byzantium.
                             - Constantinople.
                             - ConstantinopleFix.
                             - Istanbul.
                             - FrontierToHomesteadAt5.
                             - HomesteadToEIP150At5.
                             - HomesteadToDaoAt5.
                             - EIP158ToByzantiumAt5.
                             - ByzantiumToConstantinopleAt5.
                             - ByzantiumToConstantinopleFixAt5.
                             - ConstantinopleFixToIstanbulAt5.
                             - Berlin.
                             - BerlinToLondonAt5.
                             - London.
                             - ArrowGlacier.
                             - GrayGlacier.
                             - Merged.
                             - Shanghai.
                             - Cancun.
 --verbosity             sets the verbosity level [=3].
                             0 = silent, 1 = error, 2 = warn, 3 = info, 4 = debug, 5 = detail.