March 20, 2021

How to connect to Ethereum using .NET (Nethereum)


Dotnet or .NET is very popular for the development of desktop applications, most Windows desktop applications are built using .NET, and it also contributes largely to web application’s tech stack. In this guide, let’s see how we can connect to Ethereum using .NET and Nethereum.

  • .NET Core SDK 3.1 installed on your system.
  • Text editor.
  • An Ethereum node.

What is .NET?

.NET is Microsoft’s alternative to Java. .NET is an umbrella framework for developing applications using Visual Basic, C#, and F#. It is open-source and has excellent cross-platform support; it was created by Microsoft mainly for making windows applications, but now with the support for a variety of programming languages, both web-based and form-based applications can be developed using .NET and using ASP.NET, a tool within the .NET framework, one can build backends for web applications.

Following are some features of the .NET framework:

  • Common Language Runtime engine (CLR)
  • Interoperability
  • Portability
  • Base Class Library
  • Simplified deployment
  • Language independence
  • Security

For our purpose today, we’ll use C# and Nethereum.

What is C# (C-Sharp)?

C# is a modern Object-Oriented programming language; it is open source under the .NET foundation managed by Microsoft, where community members actively contribute towards it. C# is heavily used in desktop and game development, whereas it can also be used for mobile development, VR, Blockchain development, etc. C# has its roots in C and is closely related to Java and C++. It’s easy to learn and one of the most popular programming languages in the world with tremendous community support.

Here are some notable features of C#:
  • C# code, when executed, generates portable executable files like .exe and .dll
  • Methods in C# are not virtual by default.
  • Classes are grouped into namespaces.
  • C# namespaces are not related to directories.
  • Primitive data type variables are powerful in C#.
  • Has features like Properties and Indexers.
  • Supports Structures, Pre-processor directives, and Operator Overloading.
  • Being .NET language supports language interoperability.

What is Nethereum?

Nethereum is the .Net integration library for Ethereum; it simplifies the access and smart contract interaction with Ethereum nodes. It is compatible with all the major operating systems and is tested on mobile, desktop, cloud, Xbox, hololens, and Windows IoT. Nethereum is great for Web3 development.

Following are some of the prominent features of Nethereum:
  • Support for core Ethereum JSON RPC / IPC methods.
  • Simplified smart contract interaction.
  • Unity 3d integration.
  • Support for HD wallet
  • Has libraries for standard contracts Token, ENS, and Uport.
  • Simple account lifecycle.
  • Has ABI to .NET type encoding and decoding.

We’ll use Nethereum web3 package to get the latest block number from the Ethereum blockchain.

Installing Nethereum

Nethereum requires .NET Core or .NET Framework(4.5.1+) installed. We’ll install .NET Core SDK to make Nethereum work. Download and install the .NET Core SDK ver 3.1 based on your operating system. Then go to your terminal/command line and type the following.

$ dotnet new console -o nethereumapp

This will create a new .NET application in the current directory. You can give your application any name (nethereumapp in this example).

Now cd into your application.

$ cd nethereumapp

Add package reference to Nethereum.Web3

$ dotnet add package Nethereum.Web3

This might take a while. After the package reference is added, download/update the package by typing the following.

$ dotnet restore

If everything goes right, Nethereum will be added to your system with nethereum web3 package.

Booting our Ethereum node

We could use pretty much any Ethereum client, such as Geth or OpenEthereum (fka Parity), for our purposes today. Since that is a bit too involved for just querying for block height, we'll just grab a free endpoint from QuikNode to make this easy. It can be a testnet (like Ropstepn, Rinkeby or Kovan) or Mainnet. After you've created your free ethereum endpoint, copy your HTTP Provider endpoint:


You'll need this later, so copy it and save it.

Connecting with Ethereum

Now go to your .NET app folder and open the Program.cs C# file in a text editor and edit the code according to the following code.

using System;
using System.Threading.Tasks;
using Nethereum.Web3;

namespace nethereumapp
    class Program
        static void Main(string[] args)

        static async Task GetBlockNumber()
        	var web3 = new Web3("ADD_YOUR_ETHEREUM_NODE_URL");
        	var latestBlockNumber = await web3.Eth.Blocks.GetBlockNumber.SendRequestAsync();
        	Console.WriteLine($"Latest Block Number is: {latestBlockNumber}");

Make sure to replace `ADD_YOUR_ETHEREUM_NODE_URL` with the http provider from the section above.

Explanation of the code above

Line 1-3: Adding the required namespaces.

Line 5: Declaring our app’s namespace (Which will have a class collection). 

Line 7: Declaring a class named Program.

Line 9-12: Declaring the Main class, which is the C# program’s entry point, and states what class does when executed. Declaring that the main class must wait for the execution of GetBlockNumber class.

Line 14: Declaring a Task class GetBlockNumber, task classes in C# are executed asynchronously.

Line 16: Creating an instance of Web3 and setting our node URL.

Line 17: Using the Eth API, we can execute the GetBlockNumber request asynchronously and storing the result in latestBlockNumber variable.

Line 18: Printing the latest block number stored in latestBlockNumber with a string “Latest Block Number is:”

Now to run your app, open your terminal/cmd, go to your .NET app’s folder and type the following.

$ dotnet run

If everything goes well and the code gets executed successfully, you must see an output like this:


Here we saw how we can connect to the Ethereum network by making a .NET app in C# using Nethereum. So go ahead and build your decentralized games and applications. You can refer to Nethereum’s official documentation to learn more about different functions and use cases.

Subscribe to our newsletter for more articles and guides on Ethereum. If you have any feedback, feel free to reach out to us via Twitter. You can always chat with us on our Discord community server, featuring some of the coolest developers you’ll ever meet :)
Ready to try QuikNode? Start your 7-day free trial

Related articles 16

Mar 20, 2021 How to fetch Ethereum event logs in Ruby

Ethereum log records are very useful to understand and keep track of smart contract events. In this guide, we are going to learn how to fetch ethereum event logs in Ruby using ethereum.rb ruby...

Continue reading
Mar 20, 2021 How to generate a new Ethereum address in Go

Golang is very popular among backend developers for building infrastructures and microservices. Go is a procedural programming language. Developed in 2007 by Robert Griesemer, Rob Pike, and Ken Thompson at Google, then launched in 2009 as...

Continue reading
Mar 20, 2021 How to generate a new Ethereum address in Python

Python is one of the most versatile programming languages out there with an abundance of use cases; We can build many applications with Python from client-side to back end. In this guide, we will cover creating an Ethereum address in Python using the

Continue reading
Mar 20, 2021 How to generate a new Ethereum address in JavaScript

When it comes to programming, there’s hardly anyone who has not used or heard about JavaScript. JavaScript was initially created for client-side scripting but has become a full-featured Object-Oriented...

Continue reading
Mar 20, 2021 How to connect to the Ethereum network using Ruby

Ruby has a huge fanbase. Ruby was developed by its creator with an intention to create a language people can have fun using. Ruby has been largely accepted by the developers all around the world since it’s launch, in fact, the biggest tech communities in many cities are...

Continue reading
Mar 20, 2021 How to connect to the Ethereum network using Python using

You can build Ethereum applications in different programming languages. In this article, we will connect to the Ethereum network using Python.PrerequisiteEthereum Node (We will use QuikNode’s free...

Continue reading
Mar 20, 2021 How to connect to Ethereum network with ethers.js

When someone thinks of developing a dApp the first tool that comes to their mind is web3.js which is pretty common because of its popularity in the community and wide use cases, dApp development has been consistently growing and there are a lot of developers who want to...

Continue reading
Mar 20, 2021 How to re-send a transaction with higher gas price using ethers.js

Sometimes, you submit a transaction on Ethereum without enough gas due to network congestion or too many pending transactions offering a higher gas price than you have offered on your transaction. If you have a high priority transaction but low gas, you could end up...

Continue reading
Mar 20, 2021 How to connect to Ethereum network with Web3.js

Libraries and frameworks make the development process a lot easier and faster. When it comes to Ethereum development, Web3.js is the go to library. That's because Web3.js is the official library, from the

Continue reading
Mar 20, 2021 How to use Subspace with QuikNode

In this guide, we'll understand a bit about reactive development and how to use Subspace with QuikNode.JavaScript is the programming language behind most of the internet apps and websites. JavaScript today has become one of the most used programming languages, and...

Continue reading
Mar 20, 2021 How to generate a new Ethereum address in Ruby

With high usage in web applications and straightforward syntax, Ruby is used by a vast number of people. This guide will cover creating an Ethereum address in Ruby using ruby-eth...

Continue reading
Mar 20, 2021 How to connect to Ethereum network using Java / Web3j

We can say that Java is one of the most versatile languages out there, and it continues to be relevant in today's time. Java is so popular because of its massive user base and use cases. In this guide/tutorial, we'll learn how to connect to the Ethereum Blockchain network...

Continue reading
Mar 31, 2021 How to generate a new Ethereum address in PHP

PHP is very popular in developing the backend of websites or web applications. PHP has a huge crowd of developers trusting it as their go-to language. In this guide, we will see how we can generate a new Ethereum address in...

Continue reading
Apr 13, 2021 How to Fork Ethereum Blockchain with Ganache.

Forking and running a local simulated Ethereum environment is essential if you want to work with DeFi or do Ethereum development in general. In this guide, we’ll cover how to fork Ethereum Blockchain with

Continue reading
Mar 20, 2021 Estimating gas price using pending transactions in Python

To send a transaction on the Ethereum network, you need to pay fees for including the transaction in a block as well as the computation necessary in the transaction; this fee is called gas. The transactions are accepted into the block based on the amount of gas they are...

Continue reading
Mar 20, 2021 How to connect to Ethereum network using Go

Go helps you make faster scalable backends and this guide will show you how to connect your backend to Ethereum (and make it even faster, more reliable, and globally accessible, all thanks to QuikNode’s global infrastructure). What is...

Continue reading