nimbus-eth2/ncli
Jacek Sieka 03a147ab8d
avoid state copy in state transition (#930)
In BlockPool, we keep the head state around, so it's trivial to restore
the temporary state there and keep going as if nothing happened.

This solves 3 problems:
* stack space - the state copy on mainnet is huge
* GC scanning - using stack space for state slows down the GC
significantly
* reckless copying - the copy itself takes a long time

In state_sim, we'll do the same and allocate on heap - this helps a
little with GC - without it, the collection of the temporary strings
created with `toHex` while printing the json dominates the trace.
2020-04-26 21:13:33 +02:00
..
.gitignore rm ncli_signing_root 2019-12-17 00:06:03 +02:00
README.md rm ncli_signing_root 2019-12-17 00:06:03 +02:00
ncli_hash_tree_root.nim Introduce BeaconNodeRef and use it in all the right places 2020-04-26 13:04:53 +03:00
ncli_pretty.nim Introduce BeaconNodeRef and use it in all the right places 2020-04-26 13:04:53 +03:00
ncli_transition.nim avoid state copy in state transition (#930) 2020-04-26 21:13:33 +02:00
nim.cfg minimize imports, specially for spec - cuts 2/3 of ncli build time (#500) 2019-10-25 12:59:56 +02:00

README.md

Introduction

ncli is a set of low level / debugging tools to interact with the nimbus beacon chain specification implementation, simliar to zcli. With it, you explore SSZ, make state transitions and compute hash tree roots.

Tools

  • transition: Perform state transition given a pre-state and a block to apply (both in SSZ format)
  • hash_tree_root: Print tree root of an SSZ object
  • pretty: Pretty-print SSZ object as JSON

Building

Follow the instructions from nim-beacon-chain

git clone https://github.com/status-im/nim-beacon-chain.git
cd nim-beacon-chain
make

Usage

# Build with minimal config
../env.sh nim c -d:const_preset=minimal ncli_transition
# Build with mainnet config
../env.sh nim c -d:const_preset=mainnet ncli_transition

# Run..
./ncli_transition --help