Hiero 0.1.0-alpha04

Hiero

.NET Client Library for the Hiero Network and Hedera Hashgraph

Hiero provides idiomatic .NET access to the full Hedera public network — cryptocurrency, consensus messaging, tokens, NFTs, smart contracts, file storage, scheduled transactions, airdrops, and more.

Alpha Software — This library is under active development. The API surface is subject to change in later versions without notice. Use at your own risk.

Quick Start

Install

dotnet add package Hiero

Requirements: .NET 10 SDK

Hello World — Query an Account Balance

await using var client = new ConsensusClient(ctx =>
{
    ctx.Endpoint = new ConsensusNodeEndpoint(
        new EntityId(0, 0, 3),
        new Uri("https://2.testnet.hedera.com:50211"));
});

var balance = await client.GetAccountBalanceAsync(new EntityId(0, 0, 98));
Console.WriteLine($"Balance: {balance:#,#} tinybars");

Transfer Crypto

await using var client = new ConsensusClient(ctx =>
{
    ctx.Endpoint = new ConsensusNodeEndpoint(
        new EntityId(0, 0, 3),
        new Uri("https://2.testnet.hedera.com:50211"));
    ctx.Payer = new EntityId(0, 0, payerAccountId);
    ctx.Signatory = new Signatory(payerPrivateKey);
});

var receipt = await client.TransferAsync(
    new EntityId(0, 0, senderAccountId),
    new EntityId(0, 0, receiverAccountId),
    amount);

Create a Token

var receipt = await client.CreateTokenAsync(new CreateTokenParams
{
    Name = "My Token",
    Symbol = "MTK",
    Decimals = 8,
    InitialSupply = 1_000_000,
    Treasury = treasuryAccount,
    Administrator = new Endorsement(adminPublicKey),
    Signatory = new Signatory(adminPrivateKey)
});
Console.WriteLine($"Token ID: {receipt.Token}");

Architecture

Hiero provides three client types, each targeting a different part of the Hedera network:

Transaction Pattern

All state-changing operations follow the same pattern:

Create *Params → Configure Client → ExecuteAsync → Receive *Receipt

Every transaction type has a dedicated *Params class, a typed *Receipt, and an optional detailed *Record available from the Mirror Node.

Context Stack

Client configuration uses a hierarchical context stack. Child contexts (created via Clone or per-call configure callbacks) inherit from the parent but can override individual settings without affecting it:

var child = client.Clone(ctx => ctx.FeeLimit = 500_000_000);
// child inherits parent's Endpoint, Payer, Signatory — but has its own FeeLimit

Supported Network Services

• Cryptocurrency — Create, transfer, update, and delete accounts; multi-party transfers; allowances
• Consensus Service (HCS) — Create topics, submit messages (including segmented large messages), subscribe to streams
• Tokens — Fungible token lifecycle: create, mint, burn, transfer, freeze, pause, KYC, royalties
• NFTs — Non-fungible token lifecycle: create, mint, burn, transfer, confiscate, update metadata
• Smart Contracts — Deploy, call, query contracts; native EVM transaction support (type 0/1/2)
• File Service — Create, append, update, and delete files on the network
• Scheduled Transactions — Wrap any transaction for deferred execution with multi-sig collection
• Airdrops — Distribute tokens to multiple recipients; pending airdrop claim/cancel workflow
• Network Utilities — Address book, fee schedules, exchange rates, version info, pseudo-random numbers

Key Types

Building from Source

dotnet restore Hiero.slnx
dotnet build Hiero.slnx

Build Documentation

dotnet tool restore
dotnet docfx docfx/docfx.json --serve

Project Structure

Hiero/                     Source library
├── Consensus/             HCS topic operations
├── Contract/              Smart contract operations
├── Crypto/                Account and transfer operations
├── Token/                 Fungible token operations
├── Nft/                   Non-fungible token operations
├── File/                  File service operations
├── Schedule/              Scheduled transaction operations
├── AddressBook/           Consensus node management
├── Root/                  System/network admin operations
├── Mirror/                Mirror Node REST query types
├── Utilities/             Network queries and helpers
├── Converters/            JSON serialization
└── Implementation/        Internal machinery
Reference/                 Upstream protobuf definitions (do not modify)
docfx/                     DocFX documentation site

Dependencies

• Google.Protobuf + Grpc.Net.Client — Protocol Buffers and gRPC
• Portable.BouncyCastle — Ed25519 and ECDSA Secp256K1 cryptography

Documentation

• API Reference — Generated from XML doc comments
• Tutorials — Getting started guides with code examples

License

This project is licensed under the GPL-3.0-or-later.

Copyright 2025 BugBytes, Inc. All Rights Reserved.