768307d91d
It is common for many accounts to share the same code - at the database level, code is stored by hash meaning only one copy exists per unique program but when loaded in memory, a copy is made for each account. Further, every time we execute the code, it must be scanned for invalid jump destinations which slows down EVM exeuction. Finally, the extcodesize call causes code to be loaded even if only the size is needed. This PR improves on all these points by introducing a shared CodeBytesRef type whose code section is immutable and that can be shared between accounts. Further, a dedicated `len` API call is added so that the EXTCODESIZE opcode can operate without polluting the GC and code cache, for cases where only the size is requested - rocksdb will in this case cache the code itself in the row cache meaning that lookup of the code itself remains fast when length is asked for first. With 16k code entries, there's a 90% hit rate which goes up to 99% during the 2.3M attack - the cache significantly lowers memory consumption and execution time not only during this event but across the board. |
||
---|---|---|
.. | ||
testdata | ||
config.nim | ||
config.nims | ||
helpers.nim | ||
readme.md | ||
t8n.nim | ||
t8n_debug.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 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.