A developer experience (DX) toolkit for building on the Hiero/Hedera network.
HieroKit sits on top of the official @hiero-ledger/sdk and provides a cleaner, opinionated, and production-ready API for interacting with the network. It simplifies complex interactions, handles transaction lifecycles, and encodes best practices.
HieroKit is NOT:
- A blockchain node.
- A CLI tool.
- A replacement for the Hiero SDK (it wraps it).
- Simplified Client Setup: Configure network and operator in one place.
- Explicit Lifecycle: Submit -> Wait -> Receipt flow is clear and manageable.
- Built-in Retries: Automatic handling of transient network errors.
- Type-Safe: Written in TypeScript with full type definitions.
You can use any major package manager:
# npm
npm install hierokit @hiero-ledger/sdk
# pnpm
pnpm add hierokit @hiero-ledger/sdk
# yarn
yarn add hierokit @hiero-ledger/sdk
# bun
bun add hierokit @hiero-ledger/sdkimport { Client } from "hierokit";
// Initialize the client
const client = new Client({
network: "testnet",
operator: {
accountId: process.env.HEDERA_ACCOUNT_ID,
privateKey: process.env.HEDERA_PRIVATE_KEY,
},
});
// Transfer HBAR
async function main() {
console.log("Transferring HBAR...");
const handle = await client.transferHbar("0.0.xxxx", 10, "Hello HieroKit");
console.log(`Transaction ID: ${handle.transactionId}`);
const receipt = await handle.wait();
console.log(`Status: ${receipt.status.toString()}`);
}
main().catch(console.error);HieroKit includes first‑class React support via hooks:
import {
HieroProvider,
useAccountId,
useAccountHbarBalance,
} from "hierokit";
const config = {
network: "testnet" as const,
operator: {
accountId: process.env.HEDERA_ACCOUNT_ID as string,
privateKey: process.env.HEDERA_PRIVATE_KEY as string,
},
mirrorNodeUrl: "https://testnet.mirrornode.hedera.com",
};
function AccountSummary() {
const accountId = useAccountId();
const { data: hbar, status } = useAccountHbarBalance();
return (
<div>
<div>Account: {accountId?.toString() ?? "n/a"}</div>
<div>
HBAR:{" "}
{status === "success" && hbar ? hbar.toString() : "loading..."}
</div>
</div>
);
}
export function AppRoot() {
return (
<HieroProvider config={config}>
<AccountSummary />
</HieroProvider>
);
}Visit our documentation site at https://youvandra.github.io/hierokit (or run locally with npm run docs:dev).
You can also explore:
We welcome contributions! Please see CONTRIBUTING.md for details.
If you are planning a larger change, consider opening an issue first to discuss the design and make sure it aligns with the project’s goals.
- Maintainer: @youvandra
Contributions from the community are very welcome. If you would like to get more involved, feel free to open issues, send pull requests, or suggest ideas in the issue tracker.
Apache 2.0