Nethereum.Besu 6.1.0

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.5.1 This package targets .NET Framework 4.5.1. The package is compatible with this framework or higher. 
dotnet add package Nethereum.Besu --version 6.1.0
                    


                    

                
NuGet\Install-Package Nethereum.Besu -Version 6.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Nethereum.Besu" Version="6.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Nethereum.Besu" Version="6.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Nethereum.Besu" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Nethereum.Besu --version 6.1.0
                    


                    

                
#r "nuget: Nethereum.Besu, 6.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Nethereum.Besu@6.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Nethereum.Besu&version=6.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Nethereum.Besu&version=6.1.0
                    


                            Install as a Cake Tool

Nethereum.Besu

Extended Web3 library for Hyperledger Besu client. Provides RPC client methods for Admin, Debug, Miner, Clique, IBFT, EEA (private transactions), and Permissioning APIs.

Overview

Nethereum.Besu extends Nethereum.Web3 with Besu-specific JSON-RPC methods. Use Web3Besu instead of Web3 to access additional APIs for node administration, consensus mechanisms (Clique/IBFT), permissioning, and private transactions.

API Services:

  • Admin - Peer management (add/remove peers)
  • Debug - Transaction tracing, storage inspection, metrics
  • Miner - Mining control (start/stop)
  • Clique - Clique PoA consensus (propose/discard signers)
  • IBFT - IBFT PoA consensus (validator voting)
  • Permissioning - Node and account whitelisting
  • EEA - Enterprise Ethereum Alliance private transactions
  • TxPool - Transaction pool statistics and inspection

Installation

dotnet add package Nethereum.Besu

Or via Package Manager Console:

Install-Package Nethereum.Besu

Dependencies

Package References:

  • Nethereum.RPC
  • Nethereum.Web3

Usage

Web3Besu Initialization

Replace Web3 with Web3Besu:

using Nethereum.Besu;

var web3 = new Web3Besu("http://localhost:8545");

With account:

using Nethereum.Besu;
using Nethereum.Web3.Accounts;

var account = new Account("PRIVATE_KEY");
var web3 = new Web3Besu(account, "http://localhost:8545");

From: src/Nethereum.Besu/Web3Besu.cs:10

Admin API

Manage node peers.

Get Peers

var peers = await web3.Admin.Peers.SendRequestAsync();

From: src/Nethereum.Besu/IAdminApiService.cs

Add/Remove Peer

var enode = "enode://pubkey@ip:port";
var added = await web3.Admin.AddPeer.SendRequestAsync(enode);

var removed = await web3.Admin.RemovePeer.SendRequestAsync(enode);

From: src/Nethereum.Besu/IAdminApiService.cs

Get Node Info

var nodeInfo = await web3.Admin.NodeInfo.SendRequestAsync();

From: src/Nethereum.Besu/IAdminApiService.cs

Debug API

Transaction tracing, storage inspection, and metrics.

Trace Transaction

var txHash = "0x...";
var trace = await web3.DebugBesu.TraceTransaction.SendRequestAsync(txHash);

From: src/Nethereum.Besu/IDebugApiService.cs

Get Storage Range

Inspect contract storage at specific block/transaction/address:

using Nethereum.Hex.HexTypes;

var blockHash = "0x...";
var txIndex = 0;
var address = "0xContractAddress";
var startKey = "0x0000000000000000000000000000000000000000000000000000000000000000";
var limit = 100;

var storageRange = await web3.DebugBesu.StorageRangeAt.SendRequestAsync(
    blockHash,
    txIndex,
    address,
    startKey,
    limit);

From: src/Nethereum.Besu/RPC/BesuDebug/DebugStorageRangeAt.cs

Get Metrics

var metrics = await web3.DebugBesu.Metrics.SendRequestAsync();

From: src/Nethereum.Besu/RPC/BesuDebug/DebugMetrics.cs

Miner API

Control mining operations.

Start/Stop Mining

// Start mining
var started = await web3.Miner.Start.SendRequestAsync();

// Stop mining
var stopped = await web3.Miner.Stop.SendRequestAsync();

From: src/Nethereum.Besu/RPC/Miner/MinerStart.cs

Clique API

Clique Proof-of-Authority consensus control.

Get Signers

// Get current signers
var signers = await web3.Clique.GetSigners.SendRequestAsync();

// Get signers at specific block hash
var signersAtHash = await web3.Clique.GetSignersAtHash.SendRequestAsync("0xBlockHash");

From: src/Nethereum.Besu/ICliqueApiService.cs:8-9

Propose Signer

// Propose adding a signer (auth = true)
var proposed = await web3.Clique.Propose.SendRequestAsync("0xNewSignerAddress", true);

// Propose removing a signer (auth = false)
var proposedRemoval = await web3.Clique.Propose.SendRequestAsync("0xSignerAddress", false);

From: src/Nethereum.Besu/RPC/Clique/CliquePropose.cs

Discard Proposal

var discarded = await web3.Clique.Discard.SendRequestAsync("0xSignerAddress");

From: src/Nethereum.Besu/RPC/Clique/CliqueDiscard.cs

Get Proposals

var proposals = await web3.Clique.Proposals.SendRequestAsync();

From: src/Nethereum.Besu/RPC/Clique/CliqueProposals.cs

IBFT API

Istanbul Byzantine Fault Tolerance consensus control.

Get Validators

using Nethereum.RPC.Eth.DTOs;

// Get validators by block number
var validators = await web3.Ibft.GetValidatorsByBlockNumber.SendRequestAsync(
    BlockParameter.CreateLatest());

// Get validators by block hash
var validatorsByHash = await web3.Ibft.GetValidatorsByBlockHash.SendRequestAsync("0xBlockHash");

From: src/Nethereum.Besu/IbftApiService.cs:12-10

Propose Validator Vote

// Propose adding validator (add = true)
var proposed = await web3.Ibft.ProposeValidatorVote.SendRequestAsync("0xValidatorAddress", true);

// Propose removing validator (add = false)
var proposedRemoval = await web3.Ibft.ProposeValidatorVote.SendRequestAsync("0xValidatorAddress", false);

From: src/Nethereum.Besu/RPC/IBFT/IbftProposeValidatorVote.cs

Discard Validator Vote

var discarded = await web3.Ibft.DiscardValidatorVote.SendRequestAsync("0xValidatorAddress");

From: src/Nethereum.Besu/RPC/IBFT/IbftDiscardValidatorVote.cs

Get Pending Votes

var pendingVotes = await web3.Ibft.GetPendingVotes.SendRequestAsync();

From: src/Nethereum.Besu/RPC/IBFT/IbftGetPendingVotes.cs

Permissioning API

Node and account whitelisting for permissioned networks.

Node Whitelisting

// Get node whitelist
var nodeWhitelist = await web3.Permissioning.GetNodesWhitelist.SendRequestAsync();

// Add nodes to whitelist
var nodesToAdd = new[] { "enode://pubkey1@ip1:port1", "enode://pubkey2@ip2:port2" };
var nodesAdded = await web3.Permissioning.AddNodesToWhitelist.SendRequestAsync(nodesToAdd);

// Remove nodes from whitelist
var nodesToRemove = new[] { "enode://pubkey1@ip1:port1" };
var nodesRemoved = await web3.Permissioning.RemoveNodesFromWhitelist.SendRequestAsync(nodesToRemove);

From: src/Nethereum.Besu/IPermissioningApiService.cs:11-12

Account Whitelisting

// Get account whitelist
var accountWhitelist = await web3.Permissioning.GetAccountsWhitelist.SendRequestAsync();

// Add accounts to whitelist
var accountsToAdd = new[] { "0xAddress1", "0xAddress2" };
var accountsAdded = await web3.Permissioning.AddAccountsToWhitelist.SendRequestAsync(accountsToAdd);

// Remove accounts from whitelist
var accountsToRemove = new[] { "0xAddress1" };
var accountsRemoved = await web3.Permissioning.RemoveAccountsFromWhitelist.SendRequestAsync(accountsToRemove);

From: src/Nethereum.Besu/IPermissioningApiService.cs:7-9

Reload Permissions

Reload permissions from configuration file:

var reloaded = await web3.Permissioning.ReloadPermissionsFromFile.SendRequestAsync();

From: src/Nethereum.Besu/RPC/Permissioning/PermReloadPermissionsFromFile.cs

EEA API

Enterprise Ethereum Alliance private transaction support.

Send Private Transaction

// Send signed private transaction
var signedPrivateTx = "0x...";
var txHash = await web3.Eea.SendRawTransaction.SendRequestAsync(signedPrivateTx);

From: src/Nethereum.Besu/RPC/EEA/EeaSendRawTransaction.cs

Get Private Transaction Receipt

var privateTxHash = "0x...";
var receipt = await web3.Eea.GetTransactionReceipt.SendRequestAsync(privateTxHash);

From: src/Nethereum.Besu/RPC/EEA/EeaGetTransactionReceipt.cs

TxPool API

Transaction pool statistics and inspection.

Get Pool Statistics

var stats = await web3.TxPool.PantheonStatistics.SendRequestAsync();

From: src/Nethereum.Besu/ITxPoolApiService.cs

Get Pool Transactions

var transactions = await web3.TxPool.PantheonTransactions.SendRequestAsync();

From: src/Nethereum.Besu/ITxPoolApiService.cs

API Reference

Admin API Service

Interface: IAdminApiService (src/Nethereum.Besu/IAdminApiService.cs)

Method RPC Method Description
Peers admin_peers List connected peers
NodeInfo admin_nodeInfo Get node information
AddPeer admin_addPeer Add peer by enode URL
RemovePeer admin_removePeer Remove peer by enode URL

Debug API Service

Interface: IDebugApiService (src/Nethereum.Besu/IDebugApiService.cs)

Method RPC Method Description
TraceTransaction debug_traceTransaction Trace transaction execution
StorageRangeAt debug_storageRangeAt Get contract storage range
Metrics debug_metrics Get node metrics

Miner API Service

Interface: IMinerApiService (src/Nethereum.Besu/MinerApiService.cs)

Method RPC Method Description
Start miner_start Start mining
Stop miner_stop Stop mining

Clique API Service

Interface: ICliqueApiService (src/Nethereum.Besu/ICliqueApiService.cs:5)

Method RPC Method Description
GetSigners clique_getSigners Get current signers
GetSignersAtHash clique_getSignersAtHash Get signers at block hash
Propose clique_propose Propose adding/removing signer
Discard clique_discard Discard signer proposal
Proposals clique_proposals Get current proposals

IBFT API Service

Interface: IIbftApiService (src/Nethereum.Besu/IbftApiService.cs:7)

Method RPC Method Description
GetValidatorsByBlockNumber ibft_getValidatorsByBlockNumber Get validators by block number
GetValidatorsByBlockHash ibft_getValidatorsByBlockHash Get validators by block hash
ProposeValidatorVote ibft_proposeValidatorVote Propose adding/removing validator
DiscardValidatorVote ibft_discardValidatorVote Discard validator vote
GetPendingVotes ibft_getPendingVotes Get pending validator votes

Permissioning API Service

Interface: IPermissioningApiService (src/Nethereum.Besu/IPermissioningApiService.cs:5)

Method RPC Method Description
GetNodesWhitelist perm_getNodesWhitelist Get node whitelist
AddNodesToWhitelist perm_addNodesToWhitelist Add nodes to whitelist
RemoveNodesFromWhitelist perm_removeNodesFromWhitelist Remove nodes from whitelist
GetAccountsWhitelist perm_getAccountsWhitelist Get account whitelist
AddAccountsToWhitelist perm_addAccountsToWhitelist Add accounts to whitelist
RemoveAccountsFromWhitelist perm_removeAccountsFromWhitelist Remove accounts from whitelist
ReloadPermissionsFromFile perm_reloadPermissionsFromFile Reload permissions from file

EEA API Service

Interface: IEeaApiService (src/Nethereum.Besu/IEeaApiService.cs:5)

Method RPC Method Description
SendRawTransaction eea_sendRawTransaction Send signed private transaction
GetTransactionReceipt eea_getTransactionReceipt Get private transaction receipt

TxPool API Service

Interface: ITxPoolApiService (src/Nethereum.Besu/ITxPoolApiService.cs)

Method RPC Method Description
PantheonStatistics txpool_besuStatistics Get transaction pool statistics
PantheonTransactions txpool_besuTransactions Get transaction pool transactions
  • Nethereum.Web3 - Base Web3 implementation
  • Nethereum.RPC - JSON-RPC client infrastructure
  • Nethereum.Geth - Geth-specific APIs
  • Nethereum.Parity - OpenEthereum/Parity-specific APIs

Additional Resources

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net451 is compatible.  net452 was computed.  net46 was computed.  net461 is compatible.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
6.1.0 710 3/25/2026
6.0.4 173 3/18/2026
6.0.3 111 3/18/2026
6.0.1 124 3/17/2026
6.0.0 121 3/16/2026
5.8.0 205 1/6/2026
5.0.0 15,960 5/28/2025
4.29.0 1,373 2/10/2025
4.28.0 299 1/7/2025
4.27.1 278 12/24/2024
4.27.0 305 12/24/2024
4.26.0 596 10/1/2024
4.25.0 302 9/19/2024
4.21.4 14,736 8/9/2024
4.21.3 318 7/22/2024
4.21.2 318 6/26/2024
4.21.1 313 6/26/2024
4.21.0 296 6/18/2024
4.20.0 1,671 3/28/2024
Loading failed