Nethereum is the .NET integration platform for Ethereum and EVM-compatible blockchains. It provides a complete development stack — from smart contract interaction and transaction signing, through a full EVM simulator and in-process Ethereum node, to blockchain data indexing, an ERC-4337 account abstraction bundler, a Blazor blockchain explorer, MUD framework support, multi-platform wallet UIs, Unity game integration, and .NET Aspire orchestration. Nethereum targets netstandard 2.0 through .NET 10, .NET Framework 4.5.1+, and Unity, running on Windows, Linux, macOS, Android, iOS, WebAssembly, and game consoles.

Go to playground.nethereum.com to browse and execute samples directly in your browser — no setup required.

dotnet add package Nethereum.Web3

var web3 = new Web3("https://mainnet.infura.io/v3/YOUR_API_KEY");
var balance = await web3.Eth.GetBalance.SendRequestAsync("0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae");
Console.WriteLine($"Balance: {Web3.Convert.FromWei(balance.Value)} ETH");

var account = new Account("YOUR_PRIVATE_KEY");
var web3 = new Web3(account, "https://mainnet.infura.io/v3/YOUR_API_KEY");

var receipt = await web3.Eth.GetEtherTransferService()
    .TransferEtherAndWaitForReceiptAsync("0xRecipientAddress", 0.01m);

// Use code-generated typed services (see Code Generation below)
var transferHandler = web3.Eth.GetContractTransactionHandler<TransferFunction>();
var receipt = await transferHandler.SendRequestAndWaitForReceiptAsync(contractAddress,
    new TransferFunction { To = recipientAddress, Value = amount });

Nethereum includes 130+ packages organised into focused libraries. Every row below links to a how-to guide on the documentation site.

For the full list of 100+ use cases with packages, see What Do You Want to Do? on the documentation site.

Generate typed C# contract services directly from Solidity ABI using the VS Code Solidity extension or the CLI tool:

dotnet tool install -g Nethereum.Generator.Console

This generates typed service classes, function/event DTOs, deployment messages, and optionally Blazor UI components and MUD table services.

The templates pack provides ready-to-use project templates for smart contract development, Blazor integration, and authentication.

dotnet new install Nethereum.Templates.Pack

Source and details: Nethereum.Templates.SmartContractDefault, Nethereum.Templates.SmartContracts.OZ-Erc721-Erc1155, Nethereum.Templates.Metamask.Blazor, Nethereum.Templates.Siwe

Spin up a complete Ethereum development environment with a single command:

dotnet new install Nethereum.DevChain.Template
dotnet new nethereum-devchain -n MyChain
cd MyChain/AppHost && dotnet run

This creates an Aspire-orchestrated solution with a DevChain node, PostgreSQL database, blockchain indexer (blocks, transactions, tokens, MUD), and a Blazor blockchain explorer — all wired with service discovery, health checks, and OpenTelemetry.

Unity libraries: install via Nethereum.Unity (git URL) or from src/compiledlibraries/ in each GitHub release. Try samples in the Nethereum Playground.

Demos (src/demos/):

• Wallet Blazor Demo — Blazor Server wallet application
• X402 Simple Client — pay for x402-protected API endpoints
• X402 Simple Server — accept crypto payments in your API
• X402 Facilitator Server — payment verification service

Console Examples (consoletests/):

• DevChain Integration Demo — in-process Ethereum node usage
• Metamask Blazor Example — MetaMask Blazor Wasm integration
• Blazor Example Project — Blazor Wasm starter
• WalletConnect Blazor — WalletConnect v2 integration
• WalletConnect Avalonia — WalletConnect with Avalonia desktop
• Reown AppKit Blazor — Reown (WalletConnect) AppKit modal
• Godot + WalletConnect Avalonia — Godot game engine integration
• MUD Log Processing — MUD store event indexing
• MUD Store REST API — serve MUD records via REST
• HD Wallet Blazor Test — BIP32/BIP39 wallet in Blazor
• Trezor Console — Trezor hardware wallet signing
• Azure Key Vault Console — Azure KMS signing
• WebSocket Streaming — real-time blockchain data

Compatible with Windows, Linux, macOS, Android, iOS, WebAssembly, and game consoles.

For a complete guide covering all 130+ packages organised by use case — with package names, descriptions, and links to individual READMEs — see the Component Catalog or What Do You Want to Do?.

• Documentation: docs.nethereum.com
• Playground: playground.nethereum.com
• Discord: Join the community — technical support, chat, and collaboration

Building Nethereum has been a journey of over ten years, and it would not exist without the incredible people and community around it.

First and foremost, thank you to my family for their patience, support, and understanding through countless late nights, weekends, and "just one more commit" moments. You made this possible.

Thank you to Cass (@c055) for the fantastic Nethereum logo, recreating one of the @ethereumjs logo ideas for our project.

To all my friends across the Ethereum ecosystem — the people I've met at conferences, hackathons, online chats, and working groups over the years. The friendships built through this shared passion for decentralised technology have been one of the most rewarding parts of the journey.

A special thank you to Gael, Dave, Kevin, Caleb, Aaron, and Eva for their help and work on Nethereum — your contributions have been invaluable.

To every contributor who has ever submitted a pull request, reported a bug, suggested a feature, or simply asked a question on GitHub, Discord, or Gitter — you are continuously shaping this project. Every issue filed, every piece of feedback, every "it doesn't work when..." has made Nethereum better.

To the early adopters who believed in Nethereum when it was just getting started and provided invaluable feedback — your trust and patience in those early days meant everything.

To the teams and projects I've had the privilege of collaborating with and trying to help over the years — from enterprise pilots to startup MVPs, from gaming studios to DeFi protocols. Seeing Nethereum used in real-world applications is the ultimate motivation.

To everyone building the Ethereum ecosystem — the client teams (Geth, Besu, Nethermind, Erigon, Reth), the compiler teams (Solidity, Vyper), the tooling teams (Foundry, Hardhat, Remix), the library builders (web3.js, ethers.js, web3j, web3.py), the L2 teams, the researchers, the standard authors, and everyone else pushing this technology forward. We all build on each other's work.

To Consensys, the Ethereum Foundation, and the broader blockchain community for fostering an environment where open-source collaboration thrives.

And to everyone who continues to help, contribute, encourage, and inspire — directly or indirectly. The best is yet to come.