nimbus-eth1/tools/t8n
andri lim 26a8759c34
implementation of EIP-4844: Shard Blob Transactions (#1440)
* EIP-4844: add pointEvaluation precompiled contract

* EIP-4844: validate transaction and block header

* EIP-4844: implement DataHash Op Code

* EIP-4844: txPool support excessDataGas calculation

* EIP-4844: make sure tx produce correct txHash

* EIP-4844: node should not automatically broadcast blob tx to it's peers

* EIP-4844: add test cases

* EIP-4844: add EIP-4844 support to t8n tool

* EIP-4844: update nim-eth to branch eip-4844

* fix t8n transaction decoding

* add t8n test data

* EIP-4844: fix blobHash opcode

* disable blobHash test when evmc_enable
2023-06-24 20:56:44 +07:00
..
testdata implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
config.nim Reduce Nim 1.6 compiler warnings & hints 2023-01-31 13:38:08 +01:00
config.nims fix t8n compiler switch when evmc_enabled 2022-12-08 13:20:23 +07:00
helpers.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
readme.md fix evmstate,t8n,txparse build instructions 2022-12-14 21:53:41 +07:00
t8n.nim tools: add missing copyright header 2022-12-10 19:53:24 +07:00
t8n_test.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
transition.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
txpriv.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +07:00
types.nim implementation of EIP-4844: Shard Blob Transactions (#1440) 2023-06-24 20:56:44 +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 nimble to install dependencies and your system Nim compiler(version <= 1.6.0).
    $> nimble install -y --depsOnly
    $> 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                 Output full trace logs to files trace-<txIndex>-<txhash>.jsonl [=false].
 --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.