README.md

.NET Core Ethereum client

Documentation		https://nethermind.readthedocs.io
Gitter		https://gitter.im/nethermindeth/nethermind
Discord
Medium		https://medium.com/nethermind-eth
Twitter		https://twitter.com/nethermindeth
Releases		https://github.com/NethermindEth/nethermind/releases
Website		https://nethermind.io/
Docker		https://hub.docker.com/r/nethermind/nethermind
Codecov.io		https://codecov.io/gh/NethermindEth/nethermind
Fund	with Gitcoin	https://gitcoin.co/grants/142/nethermind
Github Actions		https://github.com/NethermindEth/nethermind/actions

Download and run:

Windows
Linux
MacOS

It syncs fully on Mainnet, Ropsten, Rinkeby, Goerli.

Build from Source

Prerequisites

.NET 3.0 SDK

Windows

• Install .NET https://www.microsoft.com/net/download
• You may need to install https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads

Linux

- Ubuntu

# Activate Microsoft repository
wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo apt install -y ./packages-microsoft-prod.deb apt-transport-https && sudo apt update

# Install dependencies
sudo apt install -y dotnet-sdk-3.1 libsnappy-dev libc6-dev libc6

Tested on Ubuntu 20.04 LTS and 18.04 LTS

- Debian

# Activate Microsoft repository
wget https://packages.microsoft.com/config/debian/$(lsb_release -rs | cut -d. -f1)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo apt install -y ./packages-microsoft-prod.deb apt-transport-https && sudo apt update

# Install dependencies
sudo apt install -y dotnet-sdk-3.1 libsnappy-dev libc6-dev libc6

Tested on Debian 10 (9 not working)

- CentOS

# Install dependencies
sudo yum install --enablerepo=PowerTools -y dotnet-sdk-3.1 gcc snappy-devel glibc-devel bzip2-devel libzstd

# Link libraries
sudo ln -s `find /usr/lib64/ -type f -name "libsnappy.so.1*"` /usr/lib64/libsnappy.so 
sudo ln -s `find /usr/lib64/ -type f -name "libbz2.so.1*"` /usr/lib64/libbz2.so.1.0

Tested on CentOS 8

- Fedora

# Install dependencies
sudo dnf install -y dotnet-sdk-3.1 gcc snappy-devel glibc-devel bzip2-devel libzstd

# Link libraries
sudo ln -s `find /usr/lib64/ -type f -name "libbz2.so.1*"` /usr/lib64/libbz2.so.1.0

Tested on Fedora 32

Mac

• Install .NET https://www.microsoft.com/net/download
• Install deps brew install gmp snappy lz4 zstd
• Additionally, if you have problems with startup brew install rocksdb

Build and Run

git clone https://github.com/NethermindEth/nethermind --recursive
cd nethermind/src/Nethermind
dotnet build Nethermind.sln -c Release
cd Nethermind.Runner
dotnet run -c Release --no-build -- --config mainnet

Docker Image

Official Nethermind docker images are available on Docker Hub.

Test

If you want to run the Nethermind or Ethereum Foundation tests, then:

dotnet build Nethermind.sln -c Debug
dotnet test Nethermind.sln

dotnet build EthereumTests.sln -c Debug
dotnet test EthereumTests.sln

IDE

• JetBrains Rider (Link)
• Visual Studio Code (Link)

Contributors welcome

At Nethermind we are building an open source multiplatform Ethereum client implementation in .NET Core (running seamlessly on Linux, Windows and MacOS). Simultaneously our team works on Nethermind Data Marketplace and on-chain data extraction tools and client customizations.

Nethermind client can be used in your projects, when setting up private Ethereum networks or dApps. The latest prod version of Nethermind can be found at downloads.nethermind.io.

Links

https://nethermind.io/

License