Tricksfor.BlockChainTools 10.1.2

BlockChainTools

A .NET 9 library built on Nethereum that provides ready-to-use services for common blockchain operations including HD wallet management, balance queries, gas estimation, and token transfers.

Features

• HD Wallet Management - Generate and restore hierarchical deterministic wallets
• Balance Services - Query native, ERC20, and ERC721 token balances
• Gas Estimation - Estimate gas costs for various transaction types
• Transfer Services - Simplified transfers for native tokens, ERC20, and ERC721 (NFTs)
• Transaction & Block Services - Query blockchain data
• Transaction Status - Detect lifecycle state of transactions (pending, confirmed, reverted, replaced, dropped)
• Network Health - Check blockchain network and RPC endpoint health
• Web3 Provider - Easy Web3 instance creation with distributed nonce support

Installation

dotnet add package Tricksfor.BlockChainTools

Quick Start

1. Register Services

using BlockChainTools;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddHttpClient(); // Required for GasService
services.AddBlockChainTools();

var provider = services.BuildServiceProvider();

2. Create Web3 Instance

using BlockChainTools.Interfaces;

var web3Provider = provider.GetRequiredService<IWeb3ProviderService>();

// Read-only Web3
var web3 = web3Provider.CreateWeb3("https://polygon-rpc.com");

// Web3 with account (for transactions)
var web3Tx = web3Provider.CreateWeb3(
 privateKey: "0x...",
 chain: Nethereum.Signer.Chain.Polygon,
 rpcUrl: "https://polygon-rpc.com"
);

3. Common Operations

var balanceService = provider.GetRequiredService<IBalanceService>();
var gasService = provider.GetRequiredService<IGasService>();
var transferService = provider.GetRequiredService<ITransferService>();

// Get native balance
var balance = await balanceService.GetBalanceOfAsync(web3, "0xAddress...");

// Get ERC20 balance
var usdcBalance = await balanceService.GetErc20BalanceAsync(
 web3, "0xUSDCContract...", "0xAddress...");

// Estimate gas
var gasPrice = await gasService.GetGasPriceAsync("https://polygon-rpc.com");
var gasLimit = await gasService.EstimateTransferGasAsync(web3, "0xTo...", 1.5m);

// Transfer native tokens
var txInput = new Nethereum.RPC.Eth.DTOs.TransactionInput
{
 From = "0xFrom...",
 To = "0xTo...",
 Value = new Nethereum.Hex.HexTypes.HexBigInteger(
 Nethereum.Web3.Web3.Convert.ToWei(1.5m))
};
var txHash = await transferService.TransferAsync(web3Tx, txInput);

Available Services

• IWeb3ProviderService - Create Web3 instances (read-only or with account)
• IBalanceService - Query native, ERC20, and ERC721 balances
• IGasService - Gas price queries and estimation (requires HttpClient)
• ITransferService - Transfer native tokens, ERC20, and ERC721 (NFTs)
• IHdWalletService - Generate/restore HD wallets and derive accounts
• ITransactionService - Query transaction details
• ITransactionStatusService - Detect transaction lifecycle state (pending, confirmed, reverted, replaced, dropped)
• IBlockService - Query blockchain block information
• INetworkHealthService - Check network health (block freshness, gas price, chain ID)

Distributed Nonce Management

For transaction-enabled Web3 instances, the library integrates with Tricksfor.DistributedNonce to prevent nonce conflicts across multiple instances. To use this feature:

using DistributedLockManager;
using DistributedNonce;

services.AddHttpClient();
services.AddDistributedLockManager();
services.AddSingleton<IConnectionMultiplexer>(
 await ConnectionMultiplexer.ConnectAsync("localhost:6379"));
services.AddDistributedNonce();
services.AddBlockChainTools();

Documentation

For detailed documentation, examples, and API reference, visit the GitHub repository.

License

MIT License - see LICENSE for details.