History

Jacek Sieka a086cf01ac altair fork handling cleanups (#3050 ) * fix stack overflow crash in REST/debug/getStateV2 * introduce `ForkyXxx` for generic type matching of `Xxx` across branches (SomeHashedBeaconState -> ForkyHashedBeaconState et al) - `Some` is already used for other types of type classes * consolidate function naming in BeaconChainDB, use some generics * import `forks.nim` from other spec modules and move `Forked` helpers around to resolve circular imports remove `ForkedBeaconState`, use `ForkedHashedBeaconState` throughout (less data shuffling between the types) * fix several cases of states being stored on stack in tests, causing random failures on some platforms * remove reading json support from ncli - this should be ported to the rest json reading instead (doesn't currently work because stack sizes)		2021-11-05 08:34:34 +01:00
..
.gitignore	A simple script for fetching detailed deposit data	2021-05-28 19:34:20 +03:00
README.md	update spec references from eth2.0-specs to consensus-specs and to v1.1.0-beta.2 (#2822 )	2021-08-26 10:21:52 +02:00
deposit_downloader.nim	A simple script for fetching detailed deposit data	2021-05-28 19:34:20 +03:00
download_mainnet_deposits.sh	A simple script for fetching detailed deposit data	2021-05-28 19:34:20 +03:00
e2store.nim	proc -> func in ncli/, research/, and test/ (#2818 )	2021-08-25 14:51:52 +00:00
e2store.py	e2store: add era format (#2382 )	2021-03-15 11:31:39 +01:00
logtrace.nim	switch result = foo to expression return; unexport rest of logtrace symbols (#2788 )	2021-08-17 09:51:39 +00:00
ncli.nim	altair fork handling cleanups (#3050 )	2021-11-05 08:34:34 +01:00
ncli_db.nim	altair fork handling cleanups (#3050 )	2021-11-05 08:34:34 +01: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
nim.cfg	minimize imports, specially for spec - cuts 2/3 of ncli build time (#500 )	2019-10-25 12:59:56 +02:00
nimquery.nim	Move tools (#2370 )	2021-03-02 15:02:10 +01:00
resttest-rules.json	extend REST config with more spec constants (#2962 )	2021-11-02 19:23:31 +01:00
resttest.nim	REST API test framework and tests. (#2492 )	2021-04-27 23:46:24 +03: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 nimbus-eth2

git clone https://github.com/status-im/nimbus-eth2.git
cd nimbus-eth2
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