History

Zahary Karadjov bd1047b715 0.6.0 release fixes * Updated README * No double v in nimbus_beacon_node --version * No md5 checksums		2020-11-09 17:09:49 +02:00
..
base_image	dist: build on Ubuntu 20.04 (LTS) (#1949 )	2020-11-04 00:46:23 +01:00
Dockerfile	dist: build on Ubuntu 20.04 (LTS) (#1949 )	2020-11-04 00:46:23 +01:00
Dockerfile.debian-bullseye	dist: build on Ubuntu 20.04 (LTS) (#1949 )	2020-11-04 00:46:23 +01:00
README.md	0.6.0 release fixes	2020-11-09 17:09:49 +02:00
entry_point.sh	0.6.0 release fixes	2020-11-09 17:09:49 +02:00
entry_point_test.sh	Rename binaries; Mimic the original repo layout in the distribution	2020-11-09 11:38:52 +02:00

README.md

Binary Nimbus beacon node distribution

This binary distribution of the Nimbus eth2 package is compiled in reproducible way from source files hosted at https://github.com/status-im/nimbus-eth2.

The tarball containing this README uses the following naming scheme:

nimbus-eth2_<TARGET OS>_<TARGET CPU>_<VERSION>_<GIT COMMIT>.tar.gz

For a more complete and up-to-date documentation, please refer to the Nimbus book.

Reproducing the build

Besides the generic build requirements, you also need Docker.

git clone https://github.com/status-im/nimbus-eth2.git
cd nimbus-eth2
git checkout GIT_COMMIT
make update
make dist

Significant differences from self-built binaries

No -march=native and no metrics support.

Running a Medalla node

With default options:

./run-medalla-beacon-node.sh

The script will forward all supplied options to the beacon node executable:

./run-medalla-beacon-node.sh --log-level=DEBUG --tcp-port=9050

To monitor the Eth1 validator deposit contract, you'll need to pair the Nimbus beacon node with a Web3 provider capable of serving Eth1 event logs. This could be a locally running Eth1 client such as Geth or a cloud service such as Infura. For more information please see our setup guides:

https://status-im.github.io/nimbus-eth2/eth1.html

By default, the script will ask you to enter a web3 provider URL interactively, but this can be supressed by specifying a WEB3_URL environment variable:

WEB3_URL="wss://goerli.infura.io/ws/v3/<YOUR PROJECT ID>" ./run-medalla-beacon-node.sh

Running a mainnet node

run-mainnet-beacon-node.sh is a similar script intended for connecting to mainnet. All the same conventions apply:

# using a local Geth instance
WEB3_URL="ws://localhost:8545" ./run-mainnet-node.sh --max-peers=150
# using Infura
WEB3_URL="wss://mainnet.infura.io/ws/v3/<YOUR PROJECT ID>" ./run-mainnet-beacon-node.sh