Repository files navigation

Technical support, chat and collaboration at Discord:https://discord.gg/u3Ej2BReNn

Nethereum is the .Net integration library for Ethereum, simplifying the access and smart contract interaction with Ethereum nodes both public like Geth (or your preferred client) L2 chains like Optimism, Arbitrum (or your preferred L2), any compatible EVM chain (Gnosis, etc) and permissioned chains likeQuorum.

Nethereum is developed targeting netstandard 1.1, netstandard 2.0, netcore 3.1, net451, .net 6, .net 8 and also as a portable library, hence it is compatible with all the operating systems (Windows, Linux, MacOS, Android and OSX) and has been tested on cloud, mobile, desktop, consoles and IoT.

Go tohttp://playground.nethereum.com to browse and execute all the different samples on how to use Nethereum directly in your browser.

Please join the Discord server using this link:https://discord.gg/u3Ej2BReNnWe should be able to answer there any simple queries, general comments or requests, everyone is welcome.If you want to help or have any ideas for a pull request just come and chat.

The documentation and guides can be found atRead the docs.

• JSON RPC / IPC Ethereum core methods.
• Geth management API (admin, personal, debugging, miner).
• Parity management API.
• Quorum integration.
• Simplified smart contract interaction for deployment, function calling, transaction and event filtering and decoding of topics.
• Unity 3d Unity integration.
• ABI to .Net type encoding and decoding, including attribute based for complex object deserialization.
• Hd Wallet
• External signers integration (Azure, AWS)
• Wallet integration (Metamask, WalletConnect)
• EVM Simulator
• Transaction, RLP and message signing, verification and recovery of accounts.
• Libraries for standard contracts Tokens,ENS, MUD (https://mud.dev/), Gnosis Safe
• Integrated TestRPC testing to simplify TDD and BDD (Specflow) development.
• Key storage using Web3 storage standard.
• Simplified account life cycle for both managed by third party client (personal) or stand alone (signed transactions).
• Low level Interception of RPC calls.
• Code generation of smart contracts services.

Nethereum provides two types of packages. Standalone packages targeting Netstandard 1.1, net451 and where possible net351 to support Unity3d. There is also a Nethereum.Portable library which combines all the packages into a single portable library. As netstandard evolves and is more widely supported, the portable library might be eventually deprecated.

To install the latest version:

dotnet add package Nethereum.Web3

If you are working with smart contracts, you can quickly code generate contract definitions using the vscode solidity extension (please check the documentation for other options)

Project Source	Nuget_Package	Description
Nethereum.Web3		Ethereum Web3 Class Library simplifying the interaction via RPC. Includes contract interaction, deployment, transaction, encoding / decoding and event filters
Nethereum.Unity		Unity3d integration, libraries can be found in the Nethereumreleases

Project Source	Nuget_Package	Description
Nethereum.ABI		Encoding and decoding of ABI Types, functions, events of Ethereum contracts
Nethereum.EVM		Ethereum Virtual Machine API
Nethereum.Hex		HexTypes for encoding and decoding String, BigInteger and different Hex helper functions
Nethereum.RPC		Core RPC Class Library to interact via RCP with an Ethereum client
Nethereum.JsonRpc.Client		Nethereum JsonRpc.Client core library to use in conjunction with either the JsonRpc.RpcClient, the JsonRpc.IpcClient or other custom Rpc provider
Nethereum.JsonRpc.RpcClient		JsonRpc Rpc Client using Http
Nethereum JsonRpc IpcClient		JsonRpc IpcClient provider for Windows, Linux and Unix
Nethereum.RLP		RLP encoding and decoding
Nethereum.KeyStore		Keystore generation, encryption and decryption for Ethereum key files using the Web3 Secret Storage definition,https://github.com/ethereum/wiki/wiki/Web3-Secret-Storage-Definition
Nethereum.Signer		Nethereum signer library to sign and verify messages, RLP and transactions using an Ethereum account private key
Nethereum.Contracts		Core library to interact via RPC with Smart contracts in Ethereum
Nethereum.IntegrationTesting		Integration testing module
Nethereum.HDWallet		Generates an HD tree of Ethereum compatible addresses from a randomly generated seed phrase (using BIP32 and BIP39)

Note: IPC is supported for Windows, Unix and Linux but is only available using Nethereum.Web3 not Nethereum.Portable

Project Source	Nuget_Package	Description
Nethereum.ENS		Ethereum Name service library (original ENS) WIP to upgrade to latest ENS

There are a few video guides, which might be helpful to get started.NOTE: These videos are for version 1.0, so some areas have changed.

Please use the Nethereum playground for the latest samples.

These are two videos that can take you through all the initial steps from creating a contract to deployment, one in the classic windows, visual studio environment and another in a cross platform mac and visual studio code.

This video takes you through the steps of creating a smart contract, compiling it, starting a private chain and deploying it using Nethereum.

This hands on demo provides an introduction to calls, transactions, events filters and topics

This video provides an introduction on how to store and retrieve data from structs, mappings and arrays decoding multiple output parameters to Data Transfer Objects

• Many thanks to Cass for the fantastic logo (https://github.com/c055) and recreating one of the @ethereumjs logo ideas for Nethereumethereumjs/organization#1
• Many thanks to everyone in Maker for providing very early feedback.
• Many thanks to everyone who has submitted a request for extra features, help or bugs either here in github, gitter/discord or other channels, you are continuously shaping this project.A big shout out specially to @slothbag, @matt.tan, @knocte, @TrekDev, @raymens, @rickzanux, @naddison36, @bobsummerwill, @brendan87, @dylanmckendry that were using Nethereum and providing great feedback from the beginning.@djsowa Marcin Sowa for his help on IPC in Linux.
• Everyone in the Ethereum, Consensys and the blockchain community.
• Huge shout out to everyone developing all the different Ethereum implementations Geth, Parity, EthereumJ, EthCpp, ethereum-js (and every other utility around it), python (in the different shapes), ruby (digix guys), solidity, vyper, serpent, web3 implementations (web3js the first) and ethjs, web3j, etc, etc and last but not least the .Net Bitcoin implementation.
• And many thanks to all you that keep helping and encouraging directly or indirectily.