History

Jacek Sieka 42832cefa8 Small fixes (#1165 ) * random fixes * create dump dir on startup * don't crash on failure to write dump * fix a few `uint64` instances being used when indexing arrays - this should be a compile error but isn't due to compiler bugs * fix standalone test_block_pool compilation * add signed block processing in ncli * reuse cache entry instead of allocating a new one * allow for small clock disparities when validating blocks		2020-06-12 18:43:20 +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_db.nim	ncli_db: allow saving states by root (#1136 )	2020-06-06 13:26:19 +02:00
ncli_hash_tree_root.nim	Small fixes (#1165 )	2020-06-12 18:43:20 +02:00
ncli_pretty.nim	Small fixes (#1165 )	2020-06-12 18:43:20 +02:00
ncli_query.nim	12x speedup on state sim with 100k validators sans BLS by caching get_beacon_proposer_index(...)	2020-06-04 17:07:51 +00:00
ncli_transition.nim	reorder ssz (#1099 )	2020-06-03 15:52:02 +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