Nethermind Ethereum client
Nethermind is a high-performance, highly configurable full Ethereum protocol execution client built on .NET that runs on Linux, Windows, and macOS, and supports Clique, Aura, and Ethash. Nethermind offers very fast sync speeds and support for external plugins. Enjoy reliable access to rich on-chain data thanks to high-performance JSON-RPC based on the Kestrel web server. Healthy node monitoring is secured with Grafana analytics and Seq logging.
Documentation
Nethermind documentation is available at docs.nethermind.io.
Supported networks
Mainnet
Goerli
Sepolia
Gnosis (xDai)
Energy Web
Volta
Download and run
Release builds are available on the Releases page and at downloads.nethermind.io.
On Linux
Prerequisites
-
Ubuntu / Debian
sudo apt-get install libsnappy-dev
-
CentOS / Fedora
sudo dnf install -y snappy sudo ln -s `find /usr/lib64/ -type f -name "libbz2.so.1*"` /usr/lib64/libbz2.so.1.0
Install using PPA
sudo add-apt-repository ppa:nethermindeth/nethermind
If command not found:sudo apt-get install software-properties-common
sudo apt-get install nethermind
- To run directly:
nethermind -c mainnet
or with the assistant:nethermind
On Windows
Prerequisites
Install Visual C++ Redistributable:
winget install Microsoft.VCRedist.2015+.x64
Install using Windows Package Manager
winget install nethermind
- To run directly:
nethermind.runner.exe -c mainnet
or with the assistant:nethermind.launcher.exe
On macOS
Prerequisites
brew install lz4 snappy zstd
Install using Homebrew
brew tap nethermindeth/nethermind
brew install nethermind
- To run directly:
nethermind -c mainnet
or with the assistant:nethermind-launcher
Docker image
The official Docker images of Nethermind are available on Docker Hub.
Get the digest of the Docker image
In case of any Docker image need to be updated in the repository, you can update the digest of these images as follows:
docker inspect --format='{{index .RepoDigests 0}}' <image_name>
The output should show the image digest, and then you can copy that to the FROM
tag in the Dockerfile.
Building from source
Prerequisites
Install .NET SDK
Clone the repository
git clone https://github.com/nethermindeth/nethermind --recursive
Build and run
cd nethermind/src/Nethermind/Nethermind.Runner
dotnet run -c release -- -c mainnet
Test
cd nethermind/src/Nethermind
# Run Nethermind tests:
dotnet test Nethermind.sln -c release
# Run Ethereum Foundation tests:
dotnet test EthereumTests.sln -c release
Contributing
BEFORE you start work on a feature or fix, please read and follow our contribution guide to help avoid any wasted or duplicate effort.
Security
If you believe you have found a security vulnerability in our code, please report it to us as described in our security policy.
License
Nethermind is an open-source software licensed under the LGPL-3.0.