https://github.com/NethermindEth/nethermind
A robust execution client for Ethereum node operators.
https://github.com/NethermindEth/nethermind
blockchain eth ethereum ethereum-client evm
Last synced: about 1 month ago
JSON representation
A robust execution client for Ethereum node operators.
- Host: GitHub
- URL: https://github.com/NethermindEth/nethermind
- Owner: NethermindEth
- License: gpl-3.0
- Created: 2017-08-23T15:10:51.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-05T09:31:13.000Z (about 1 month ago)
- Last Synced: 2025-03-05T09:45:47.936Z (about 1 month ago)
- Topics: blockchain, eth, ethereum, ethereum-client, evm
- Language: C#
- Homepage: https://nethermind.io/nethermind-client
- Size: 483 MB
- Stars: 1,350
- Watchers: 56
- Forks: 492
- Open Issues: 494
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-GPL
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-csharp - Nethermind - full Ethereum client in .NET Core (Blockchain)
- awesome-dotnet-cn - Nethermind - .NET Core中完整的Ethereum客户端。 (区块链)
- awesome-dotnet-core - Nethermind - .NET Core Ethereum client (Frameworks, Libraries and Tools / Blockchain)
- awesome-dotnet - Nethermind - full Ethereum client in .NET Core (Blockchain)
- awesome-dot-dev - Nethermind - full Ethereum client in .NET Core (Blockchain)
- awsome-dotnet - Nethermind - full Ethereum client in .NET Core (Blockchain)
- Library-of-Ethereum - Nethermind - C# , .NET (Misc / Validator Clients)
- fucking-awesome-dotnet-core - Nethermind - .NET Core Ethereum client (Frameworks, Libraries and Tools / Blockchain)
- DeFi-Developer-Road-Map - Nethermind - .NET Core client (Roadmap)
- awesome-dotnet - Nethermind - full Ethereum client in .NET Core (Blockchain)
- awesome-dotnet-core - Nethermind - .NET Core Ethereum client (Frameworks, Libraries and Tools / Blockchain)
- awesome-dotnet-core - Nethermind - .NET Core以太坊客户端 (框架, 库和工具 / 区块链)
README
# Nethermind Ethereum client
[](https://github.com/nethermindeth/nethermind/actions/workflows/nethermind-tests.yml)
[](https://x.com/nethermindeth)
[](https://discord.gg/GXJFaYk)
[](https://github.com/nethermindeth/nethermind/discussions)
[](https://www.gitpoap.io/gh/NethermindEth/nethermind)
The Nethermind Ethereum execution client, built on .NET, delivers industry-leading performance in syncing and tip-of-chain processing. 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](https://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](https://github.com/nethermindeth/nethermind/releases).
### Package managers
- **Linux**
On Debian-based distros, Nethermind can be installed via Launchpad PPA:
```bash
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:
```powershell
winget install nethermind
```
- **macOS**
On macOS, Nethermind can be installed via Homebrew:
```bash
brew tap nethermindeth/nethermind
brew install nethermind
```
Once installed, Nethermind can be launched as follows:
```bash
nethermind -c mainnet --data-dir path/to/data/dir
```
For further instructions, see [Running a node](https://docs.nethermind.io/get-started/running-node).
### Docker containers
The official Docker images of Nethermind are available on [Docker Hub](https://hub.docker.com/r/nethermind/nethermind) 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](https://docs.nethermind.io/get-started/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:
```bash
docker build https://github.com/nethermindeth/nethermind.git -t nethermind
```
For more info, see [Building Docker image](https://docs.nethermind.io/developers/building-from-source#building-docker-image).
### Standalone binaries
**Prerequisites**
Install the [.NET SDK](https://aka.ms/dotnet/download).
**Clone the repository**
```bash
git clone --recursive https://github.com/nethermindeth/nethermind.git
```
**Build and run**
```bash
cd nethermind/src/Nethermind/Nethermind.Runner
dotnet run -c release -- -c mainnet
```
**Test**
```bash
cd nethermind/src/Nethermind
# Run Nethermind tests
dotnet test Nethermind.slnx -c release
# Run Ethereum Foundation tests
dotnet test EthereumTests.slnx -c release
```
For more info, see [Building standalone binaries](https://docs.nethermind.io/developers/building-from-source#building-standalone-binaries).
## Contributing
Before you start working on a feature or fix, please read and follow our [contributing guidelines](./CONTRIBUTING.md) 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](SECURITY.md).
## License
Nethermind is an open-source software licensed under the [LGPL-3.0](./LICENSE-LGPL). By using this project, you agree to abide by the license and [additional terms](https://nethermindeth.github.io/NethermindEthereumClientTermsandConditions/).