221e6c9e2f
* Nimbus folder environment update details: * Integrated `CoreDbRef` for the sources in the `nimbus` sub-folder. * The `nimbus` program does not compile yet as it needs the updates in the parallel `stateless` sub-folder. * Stateless environment update details: * Integrated `CoreDbRef` for the sources in the `stateless` sub-folder. * The `nimbus` program compiles now. * Premix environment update details: * Integrated `CoreDbRef` for the sources in the `premix` sub-folder. * Fluffy environment update details: * Integrated `CoreDbRef` for the sources in the `fluffy` sub-folder. * Tools environment update details: * Integrated `CoreDbRef` for the sources in the `tools` sub-folder. * Nodocker environment update details: * Integrated `CoreDbRef` for the sources in the `hive_integration/nodocker` sub-folder. * Tests environment update details: * Integrated `CoreDbRef` for the sources in the `tests` sub-folder. * The unit tests compile and run cleanly now. * Generalise `CoreDbRef` to any `select_backend` supported database why: Generalisation was just missed due to overcoming some compiler oddity which was tied to rocksdb for testing. * Suppress compiler warning for `newChainDB()` why: Warning was added to this function which must be wrapped so that any `CatchableError` is re-raised as `Defect`. * Split off persistent `CoreDbRef` constructor into separate file why: This allows to compile a memory only database version without linking the backend library. * Use memory `CoreDbRef` database by default detail: Persistent DB constructor needs to import `db/core_db/persistent why: Most tests use memory DB anyway. This avoids linking `-lrocksdb` or any other backend by default. * fix `toLegacyBackend()` availability check why: got garbled after memory/persistent split. * Clarify raw access to MPT for snap sync handler why: Logically, `kvt` is not the raw access for the hexary trie (although this holds for the legacy database) |
||
---|---|---|
.. | ||
testdata | ||
config.nim | ||
config.nims | ||
helpers.nim | ||
readme.md | ||
t8n.nim | ||
t8n_test.nim | ||
transition.nim | ||
txpriv.nim | ||
types.nim |
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.
- 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
- 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
- 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.