Nethermind Ethereum client

Nethermind is an Ethereum execution client built on .NET. Nethermind is the fastest client in terms of throughput, block processing, transactions per second (TPS), and syncing new nodes. With its modular design and plugin system, it offers extensibility and features for new chains. As one of the most adopted execution clients on Ethereum, Nethermind plays a crucial role in enhancing the diversity and resilience of the Ethereum ecosystem.

Documentation

Nethermind documentation is available at docs.nethermind.io.

Supported networks

Ethereum · Gnosis · Optimism · Base · Taiko · World Chain · Linea · Energy Web

Installing

The standalone release builds are available on GitHub Releases.

Package managers

• Linux

  On Debian-based distros, Nethermind can be installed via Launchpad PPA:

  sudo add-apt-repository ppa:nethermindeth/nethermind
  # If command not found, run
  # sudo apt-get install software-properties-common
  
  sudo apt-get install nethermind

• Windows

  On Windows, Nethermind can be installed via Windows Package Manager:

  winget install --id Nethermind.Nethermind

• macOS

  On macOS, Nethermind can be installed via Homebrew:

  brew tap nethermindeth/nethermind
  brew install nethermind

Once installed, Nethermind can be launched as follows:

nethermind -c mainnet --data-dir path/to/data/dir

For further instructions, see Running a node.

Docker containers

The official Docker images of Nethermind are available on Docker Hub and tagged as follows:

• latest: the latest version of Nethermind (the default tag)
• latest-chiseled: a rootless and chiseled image of the latest version of Nethermind
• x.x.x: a specific version of Nethermind
• x.x.x-chiseled: a rootless and chiseled image of the specific version of Nethermind

For more info, see Installing Nethermind.

Building from source

Docker image

This is the easiest and fastest way to build Nethermind if you don't want to clone the Nethermind repo, deal with .NET SDK installation, and other configurations. Running the following simple command builds the Docker image, which is ready to run right after:

docker build https://github.com/nethermindeth/nethermind.git -t nethermind

For more info, see Building Docker image.

Standalone binaries

Prerequisites

Install .NET SDK 10 or later.

Clone the repository

git clone --recursive https://github.com/nethermindeth/nethermind.git

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 --solution Nethermind.slnx -c release

# Run Ethereum Foundation tests
dotnet test --solution EthereumTests.slnx -c release

For more info, see Building standalone binaries.

Contributing

Before you start working on a feature or fix, please read and follow our contributing guidelines 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. By using this project, you agree to abide by the license and additional terms.