---
# System prepended metadata

title: nethtest quick guide

---

# nethtest quick guide

## Prerequisites

- Latest .NET SDK 10.0.201 or later: https://dotnet.microsoft.com/en-us/download
- Nethermind cloned and branch `dump-state` used

## Fast path

Build the runner to out directory(expect many dll files there next to executable):

```powershell
dotnet build src/Nethermind/Nethermind.Test.Runner/Nethermind.Test.Runner.csproj -c Release -o out
```

The framework-dependent executable is then available at:

```text
./out/nethtest.exe
or
./out/nethtest
```

Run a blockchain fixture(`-ds` flag means state dump):

```powershell
./out/nethtest.exe -b -i -ds ".../fixture.json"
or
./out/nethtest -b -i -ds ".../fixture.json"
```

## Common flags

- `-b`: treat the input as a blockchain test
- `-i <path>`: input fixture file or directory
- `-g`: use Gnosis chain ID and spec selection
- `-t`: always emit trace output
- `-n`: never emit trace output for state tests
- `-ds`: emit pre and post state dumps to `stderr`
- `-f <regex>`: run only tests matching the regex

State tests do not need `-b`