Skip to content
Nimbus: an Ethereum 1.0 & 2.0 Client for Resource-Restricted Devices
Nim JavaScript Nix HTML Go C Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode vscode: add default build task Aug 23, 2018
doc Update Nimbus - An Ethereum 2.0 Sharding May 28, 2018
docker Move the beacon_node docker files to their own repo Sep 10, 2019
examples Nimbus-Grafana-dashboard.json: gauge panel fix Oct 2, 2019
nimbus move fork and gasCosts from Computation to vmState Jan 20, 2020
nix Remove -linkshared & update Nix file to be consistent Nov 27, 2019
premix fix bc/gst tester for istanbul [skip ci] Nov 14, 2019
tests move fork and gasCosts from Computation to vmState Jan 20, 2020
vendor bump nim-stint Jan 19, 2020
wrappers Add dynlib pragma to be useful as dynamic library on Windows Nov 29, 2019
.appveyor.yml Disable wrappers for Windows for now Nov 29, 2019
.gitignore refactor the C and Go wrapper build system Aug 2, 2019
.gitmodules unittest2 (parallelism disabled) Oct 31, 2019
.travis.yml Merge branch 'nim1.0.4' Dec 2, 2019 fixes coinbase suicide bugs Jan 20, 2020 fixes long standing bug create2nocash Jan 20, 2020
LICENSE-APACHEv2 Update README badges and add dual-license header Apr 6, 2018
LICENSE-MIT Update README badges and add dual-license header Apr 6, 2018
Makefile Remove -linkshared & update Nix file to be consistent Nov 27, 2019 Add PersistBlockTest for block 1352922, fixes #363 Aug 14, 2019 fixes #421, each tests have their own skip table Dec 6, 2019 Update (#434) Dec 9, 2019 update test logs Jan 6, 2019 update on 64-bit Sep 3, 2019
default.nix Add nix recipe to build Nimbus wrappers Nov 19, 2019 bump submodules Aug 24, 2019 fixes long standing bug create2nocash Jan 20, 2020 fixes long standing bug create2nocash Jan 20, 2020
nim.cfg nim.cfg: add "-d:nimOldCaseObjects" to work around confutils bug Nov 29, 2019
nimbus.nimble tests: reduce RAM usage Sep 5, 2019

Nimbus: an Ethereum 2.0 Sharding Client for Resource-Restricted Devices

Windows build status (Appveyor) Build Status (Travis) License: Apache License: MIT Stability: experimental

Discord: Nimbus Gitter: #status-im/nimbus Status: #nimbus-general


Nimbus: an Ethereum 2.0 Sharding Client. The code in this repository is currently focusing on Ethereum 1.0 feature parity, while all 2.0 research and development is happening in parallel in nim-beacon-chain.

Development Updates

To keep up to date with changes and development progress, follow the Nimbus blog.

Building & Testing

We currently do not guarantee that Nimbus will work on Windows.


  • RocksDB
  • PCRE
  • GNU Make, Bash and the usual POSIX utilities. Git 2.9.4 or newer.

On Windows, a precompiled DLL collection download is available through the fetch-dlls Makefile target: (Windows instructions).

# MacOS with Homebrew
brew install rocksdb pcre

# Fedora
dnf install rocksdb-devel pcre pcre-devel

# Debian and Ubuntu
sudo apt-get install librocksdb-dev libpcre3-dev

# Arch (AUR)
pakku -S rocksdb pcre-static

rocksdb can also be installed by following their instructions.

Obtaining the prerequisites through the Nix package manager


Users of the Nix package manager can install all prerequisites simply by running:

nix-shell default.nix

Build & Develop

POSIX-compatible OS

make # The first `make` invocation will update all Git submodules and prompt you to run `make` again.
     # It's only required once per Git clone. You'll run `make update` after each `git pull`, in the future,
     # to keep those submodules up to date.

# Run tests
make test

make nimbus # build the Nimbus binary

# See available command line options
build/nimbus -- help

# Start syncing with mainnet

# Update to latest version
git pull
make update

To run a command that might use binaries from the Status Nim fork:

./ bash # start a new interactive shell with the right env vars set
which nim
nim --version

# or without starting a new interactive shell:
./ which nim
./ nim --version

Our Wiki provides additional helpful information for debugging individual test cases and for pairing Nimbus with a locally running copy of Geth.


(Experimental support!)

Install Mingw-w64 for your architecture using the "MinGW-W64 Online Installer" (first link under the directory listing). Run it and select your architecture in the setup menu ("i686" on 32-bit, "x86_64" on 64-bit), set the threads to "win32" and the exceptions to "dwarf" on 32-bit and "seh" on 64-bit. Change the installation directory to "C:\mingw-w64" and add it to your system PATH in "My Computer"/"This PC" -> Properties -> Advanced system settings -> Environment Variables -> Path -> Edit -> New -> C:\mingw-w64\mingw64\bin (it's "C:\mingw-w64\mingw32\bin" on 32-bit)

Install Git for Windows and use a "Git Bash" shell to clone and build Nimbus.

If you don't want to compile RocksDB and SQLite separately, you can fetch pre-compiled DLLs with:

mingw32-make # this first invocation will update the Git submodules
mingw32-make fetch-dlls # this will place the right DLLs for your architecture in the "build/" directory

You can now follow those instructions in the previous section by replacing make with mingw32-make (regardless of your 32-bit or 64-bit architecture):

mingw32-make nimbus # build the Nimbus binary
mingw32-make test # run the test suite
# etc.

Raspberry PI

Experimental The code can be compiled on a Raspberry PI:

  • Raspberry PI 3b+
  • 64gb SD Card (less might work too, but the default recommended 4-8GB will probably be too small)
  • Rasbian Buster Lite - Lite version is enough to get going and will save some disk space!

Assuming you're working with a freshly written image:

# Start by increasing swap size to 2gb:
sudo vi /etc/dphys-swapfile
# :wq
sudo reboot

# Install prerequisites
sudo apt-get install git libgflags-dev libsnappy-dev

mkdir status
cd status

# Install rocksdb
git clone
cd rocksdb
make shared_lib
sudo make install

# Raspberry pi doesn't include /usr/local/lib in library search path - need to add
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

git clone

cd nimbus

# Follow instructions above!

Development tips

  • you can switch the DB backend with a Nim compiler define: -d:nimbus_db_backend=... where the (case-insensitive) value is one of "rocksdb" (the default), "sqlite", "lmdb"

  • the Premix debugging tools are documented separately

  • you can control the Makefile's verbosity with the V variable (defaults to 0):

make V=1 # verbose
make V=2 test # even more verbose
make LOG_LEVEL=DEBUG nimbus # this is the default
make LOG_LEVEL=TRACE nimbus # log everything
  • pass arbitrary parameters to the Nim compiler:
make NIMFLAGS="-d:release"
  • if you want to use SSH keys with GitHub (also handles submodules):
make github-ssh
  • force a Nim compiler rebuild:
rm vendor/Nim/bin/nim
make -j8 build-nim

Git submodule workflow

Working on a dependency:

cd vendor/nim-chronicles
git checkout -b mybranch
# make some changes
git status
git commit -a
git push origin mybranch
# create a GitHub PR and wait for it to be approved and merged
git checkout master
git pull
git branch -d mybranch
# realise that the merge was done without "--no-ff"
git branch -D mybranch
# update the submodule's commit in the superproject
cd ../..
git status
git add vendor/nim-chronicles
git commit

It's important that you only update the submodule commit after it's available upstream.

You might want to do this on a new branch of the superproject, so you can make a GitHub PR for it and see the CI test results.

Don't update all Git submodules at once, just because you found the relevant Git command or make target. You risk updating submodules to other people's latest commits when they are not ready to be used in the superproject.

Adding the submodule "" to "vendor/foo":

vendor/nimbus-build-system/scripts/ status-im/foo
# or
./ add_submodule status-im/foo
# want to place it in "vendor/bar" instead?
./ add_submodule status-im/foo vendor/bar

Removing the submodule "vendor/bar":

git submodule deinit -f -- vendor/bar
git rm -f vendor/bar

Checking out older commits, either to bisect something or to reproduce an older build:

git checkout <commit hash here>
make clean
make -j8 update

Running a dependency's test suite using nim instead of nimble (which cannot be convinced not to run a dependency check, thus clashing with our jury-rigged "vendor/.nimble/pkgs"):

cd vendor/nim-rocksdb
../nimbus-build-system/scripts/ test
# or
../../ nimble test

Metric visualisation

Install Prometheus and Grafana. On Gentoo, it's emerge prometheus grafana-bin.

# build Nimbus with support for the HTTP endpoint
make NIMFLAGS="-d:insecure" nimbus
# the Prometheus daemon will create its data dir in the current dir, so give it its own directory
mkdir ../my_metrics
# copy the basic config file over there
cp -a examples/prometheus.yml ../my_metrics/
# start Prometheus in a separate terminal
cd ../my_metrics
prometheus --config.file=prometheus.yml # loads ./prometheus.yml, writes metric data to ./data
# start a fresh Nimbus sync and export metrics
rm -rf ~/.cache/nimbus/db; ./build/nimbus --prune:archive --metricsServer

Start the Grafana server. On Gentoo it's /etc/init.d/grafana start. Go to http://localhost:3000, log in with admin:admin and change the password.

Add Prometheus as a data source. The default address of http://localhost:9090 is OK, but Grafana 6.3.5 will not apply that semitransparent default you see in the form field, unless you click on it.

Create a new dashboard. Click on its default title in the upper left corner ("New Dashboard"). In the new page, click "Import dashboard" in the right column and upload "examples/Nimbus-Grafana-dashboard.json".

In the main panel, there's a hidden button used to assign metrics to the left or right Y-axis - it's the coloured line on the left of the metric name, in the graph legend.

To see a single metric, click on its name in the legend. Click it again to go back to the combined view. To edit a panel, click on its title and select "Edit".

Obligatory screenshot.


Report any errors you encounter, please, if not already documented!

  • Turn it off and on again:
make clean
make update


Licensed and distributed under either of


at your option. These files may not be copied, modified, or distributed except according to those terms.

You can’t perform that action at this time.