forked from NethermindEth/nethermind
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update Nethermind documentation and Fuse integration
- Loading branch information
Showing
1 changed file
with
7 additions
and
127 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,133 +1,13 @@ | ||
| <p align="center"> | ||
| <picture> | ||
| <source media="(prefers-color-scheme: dark)" srcset="https://github.com/nethermindeth/nethermind/assets/337518/3e3b3c06-9cf3-4364-a774-158e649588cc"> | ||
| <source media="(prefers-color-scheme: light)" srcset="https://github.com/nethermindeth/nethermind/assets/337518/d1cc365c-6045-409f-a961-18d22ddb2535"> | ||
| <img alt="Nethermind" src="https://github.com/nethermindeth/nethermind/assets/337518/d1cc365c-6045-409f-a961-18d22ddb2535" height="64"> | ||
| </picture> | ||
| </p> | ||
| # Fuse Nethermind Client Docs | ||
|
|
||
| # Nethermind Ethereum client | ||
| This projects builds a customized version of the nethermind client with Fuse Network modifications. Those include the integrations with the Fuse SparkNet | ||
|
|
||
| [](https://github.com/nethermindeth/nethermind/actions/workflows/nethermind-tests.yml) | ||
| [](https://discord.gg/GXJFaYk) | ||
| [](https://twitter.com/nethermindeth) | ||
| [](https://community.nethermind.io/c/nethermind-client) | ||
| [](https://www.gitpoap.io/gh/NethermindEth/nethermind) | ||
| Since 08.2022 Fuse moved from OE client to Nethermind. To bootstrap your own Fuse (Spark) node on Nethermind client you could use `quickstart.sh` script. | ||
|
|
||
| Nethermind is a high-performance, highly configurable Ethereum execution client built on .NET that runs on Linux, Windows, and macOS and supports Clique, Aura, and Ethash. With breakneck sync speeds and support for external plugins, it provides reliable access to rich on-chain data thanks to a high-performance JSON-RPC interface and node health monitoring with Grafana and Seq. | ||
| ## Nethermind Documentation | ||
|
|
||
| ## Documentation | ||
| Nethermind documentation is available at [docs.nethermind.io](https://docs.nethermind.io). CLI documentation is available at [docs.nethermind.io/.../ethereum-client](https://docs.nethermind.io/nethermind/ethereum-client/configuration). | ||
|
|
||
| Nethermind documentation is available at [docs.nethermind.io](https://docs.nethermind.io). | ||
| ## Starting nethermind node for Fuse mainnet or Spartk testmet | ||
|
|
||
| ### Supported networks | ||
|
|
||
| **`Mainnet`** **`Goerli`** **`Sepolia`** **`Holesky`** **`Gnosis (xDai)`** **`Chiado`** **`Energy Web`** **`Volta`** | ||
|
|
||
| ## Download and run | ||
|
|
||
| Release builds are available on the [Releases page](https://github.com/nethermindeth/nethermind/releases) and at [downloads.nethermind.io](https://downloads.nethermind.io). | ||
|
|
||
| ### On Linux | ||
|
|
||
| #### Prerequisites | ||
|
|
||
| - #### Ubuntu / Debian | ||
|
|
||
| ```sh | ||
| sudo apt-get install libsnappy-dev | ||
| ``` | ||
|
|
||
| - #### CentOS / Fedora | ||
|
|
||
| ```sh | ||
| 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 | ||
|
|
||
| 1. `sudo add-apt-repository ppa:nethermindeth/nethermind` \ | ||
| If command not found: `sudo apt-get install software-properties-common` | ||
| 2. `sudo apt-get install nethermind` | ||
| 3. `nethermind -c mainnet` | ||
|
|
||
| ### On Windows | ||
|
|
||
| #### Prerequisites | ||
|
|
||
| In some cases, [Visual C++ Redistributable](https://aka.ms/vcredist) may need an update: | ||
|
|
||
| ``` | ||
| winget install Microsoft.VCRedist.2015+.x64 | ||
| ``` | ||
|
|
||
| #### Install using Windows Package Manager | ||
|
|
||
| 1. `winget install nethermind` | ||
| 2. `nethermind -c mainnet` | ||
|
|
||
| ### On macOS | ||
|
|
||
| #### Install using Homebrew | ||
|
|
||
| 1. `brew tap nethermindeth/nethermind` | ||
| 2. `brew install nethermind` | ||
| 3. `nethermind -c mainnet` | ||
|
|
||
| ## Docker image | ||
|
|
||
| The official Docker images of Nethermind are available on [Docker Hub](https://hub.docker.com/r/nethermind/nethermind). | ||
|
|
||
| ### 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: | ||
|
|
||
| ```sh | ||
| 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](https://dotnet.microsoft.com/en-us/download) | ||
|
|
||
| ### Clone the repository | ||
|
|
||
| ```sh | ||
| git clone --recursive https://github.com/nethermindeth/nethermind.git | ||
| ``` | ||
|
|
||
| ### Build and run | ||
|
|
||
| ```sh | ||
| cd nethermind/src/Nethermind/Nethermind.Runner | ||
| dotnet run -c release -- -c mainnet | ||
| ``` | ||
|
|
||
| ### Test | ||
|
|
||
| ```sh | ||
| 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](https://github.com/nethermindeth/nethermind/blob/master/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](https://github.com/nethermindeth/nethermind/blob/master/LICENSE-LGPL). | ||
| Please refere to [quickstart.sh guide](https://github.com/fuseio/fuse-network/tree/master/nethermind) |