Da diverso tempo sto verificando Nethereum,soprattutto per il numero significativo di applicazioni , utlizzo principale è l’integrazione Ethereum in ambito .net, che semplifica la gestione dei smart contracts e l'interazione con i nodi Ethereum, siano essi pubblici, come Geth , Parity o privati, come Quorum e Besu .

Nethereum è stato sviluppato per target netstandard 1.1, net451 e anche come libreria portatile, quindi è compatibile con tutti i principali sistemi operativi (Windows, Linux, MacOS, Android e OSX) ed è stato testato su cloud, mobile, desktop, Xbox, hololens e Windows IoT.

Le prossime versioni saranno conformi a Ethereum 2.0 (quando verrà rilasciato Ethereum 2.0) e includeranno funzionalità come DevP2P , Plasma e Micro-Payments.

Caratteristiche di Nethereum

·       Metodi di base JSON RPC / IPC Ethereum.

·       Geth management API (admin, personal, debugging, miner).

·       Parity management API.

·       Quorum integration.

·       Besu.

·       Iterazione semplificata smart contract per lo sviluppo,transazioni,filtraggio eventi e decodifica dei argomenti.

·       Unity 3d Unity integration.

·       Blockchain processing.

·       Codifica e decodifica da ABI a .Net, inclusa la deserializzazione di oggetti complessi basata su attributi (nethereum-abi-encoding.md).

·       Hd Wallet creazione e gestione-

·       Rules engine.

·       HD Wallet integration.

·       Transazioni, RLP e gestione messaggi, verifica e ripristino degli.

·       Librarie per la gestione dei Token, ENS e Uport

·       TestRPC integrato per semplificare lo sviluppo di TDD e BDD (Specflow) development.

·       Archiviazione chiavi utilizzando lo standard di archiviazione Web3 compataibile Geth e Parity.

·       Ciclo di vita dell'account semplificato per entrambi gestiti da cliente di terze parti (personal) o  stand alone (signed transactions).

·       Intercettazione di basso livello delle chiamate RPC.

·       Generazione di codice smart contracts services

Iniziare con Nethereum

Questo è un esempio di avvio rapido con dipendenze minime. Ha lo scopo di aiutare gli sviluppatori .Net nuovi e esperti.

Questo ti guiderà attraverso i passaggi per connetterti a Infura e recuperare il saldo di un account dalla mainnet (la catena pubblica di Ethereum).

Infura fornisce una serie di nodi pubblici eliminando la necessità di avere un client locale o mantenuto completamente sincronizzato con la rete Ethereum principale.

Nota

Puoi trovare un esempio di codice eseguibile sullo stesso argomento nel Nethereum Playground: Query Ether account balance utilizzando Infura

1. Installa .Net

Nethereum funziona con .Net Core o .Net Framework (dalla 4.5.1 in poi). Dovrai avere installato .Net SDK. Per i nuovi principianti consigliamo .Net core. Gli utenti Mac o Linux avranno bisogno anche di .Net Core.

Non sei sicuro di quale .Net SDK scaricare? - scegli .Net Core 3.1.

Scarica .Net SDK

2. Crea la tua app

Crea un progetto utilizzando la .Net CLI (sotto) OPPURE crea un progetto in Visual Studio.

dotnet new console -o NethereumSample
cd NethereumSample

3. Aggiungere il riferimento al pacchetto a Nethereum.Web3 e ripristinare (aggiornare / scaricare) i pacchetti del progetto.

dotnet add package Nethereum.Web3
dotnet restore
 

4. Apri il tuo IDE (VS Code, Visual Studio ecc.)

Visual Studio Code o Visual Studio sono entrambe buone scelte per lo sviluppo .Net. Sono disponibili anche altri buoni IDE (Jet Brains Rider per esempio). Il playground di Nethereum può aiutarti a iniziare immediatamente senza alcuna configurazione, ma tieni presente che non è un IDE a tutti gli effetti http://playground.nethereum.com/

Ora apri il file Program.cs nell'editor.

5. Codice per recuperare il saldo del conto

Codice di esempio completo per Program.cs. Vedi sotto per una spiegazione più completa di ogni passaggio.

using System;
using System.Threading.Tasks;
using Nethereum.Web3;
 
namespace NethereumSample
{
    class Program
    {
        static void Main(string[] args)
        {
            GetAccountBalance().Wait();
            Console.ReadLine();
        }
 
        static async Task GetAccountBalance()
        {
var web3 = new Web3("https://mainnet.infura.io/v3/7238211010344719ad14a89db874158c");
            var balance = await web3.Eth.GetBalance.SendRequestAsync("0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae");
            Console.WriteLine($"Balance in Wei: {balance.Value}");
 
            var etherAmount = Web3.Convert.FromWei(balance.Value);
            Console.WriteLine($"Balance in Ether: {etherAmount}");
        }
    }
}

Innanzitutto, dobbiamo aggiungere i nostri spazi dei nomi richiesti per Nethereum:

using Nethereum.Web3;
 

Il passo successivo è quello di creare un'istanza di Web3, con l'url infura per mainnet e la tua chiave API INFURA con il formato: https://<network>.infura.io/v3/YOUR-PROJECT-ID.

Per questo esempio, utilizzeremo una chiave API speciale 7238211010344719ad14a89db874158c, ma per il tuo progetto dovrai registrarti su INFURA e generare la tua chiave.

var web3 = new Web3("https://mainnet.infura.io/v3/7238211010344719ad14a89db874158c");

Utilizzando l'API Eth possiamo eseguire la richiesta GetBalance in modo asincrono, per il nostro account selezionato. In questo scenario ho scelto l'account Ethereum Foundation. "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae"

var balance = await web3.Eth.GetBalance.SendRequestAsync("0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae");

L'importo restituito è in Wei, l'unità di valore più bassa. Possiamo convertire questa unità in Ether usando l'utility Convertion:

var etherAmount = Web3.Convert.FromWei(balance.Value);

Pacchetti Nuget

Nethereum fornisce due tipi di pacchetti. Pacchetti autonomi di targeting Netstandard 1.1, net451, Netstandard 2.0, Netcoreapp 2.1e, ove possibile net351 per la compatibilità con  Unity3d. C'è anche una Nethereum.Portable libreria che combina tutti i pacchetti in un'unica libreria portatile per la retrocompatibilità. 

Tutte le versioni possono essere trovate in Nuget.

Utenti Windows

Per installare i pacchetti principali puoi:

PM > Install-Package Nethereum.Web3

o

PM > Install-Package Nethereum.Portable

Utenti Windows / Mac / Linux

dotnet add package Nethereum.Web3 

o

dotnet add package Nethereum.Portable