Standards Agent Kit: Hedera Agent Toolkit

Welcome to the Standards Agent Kit! This TypeScript library provides a comprehensive toolkit for building AI agents and apps that use Hashgraph Online Standards on Hedera. It includes first‑class HCS‑10 OpenConvAI support, dynamic registries (HCS‑2, HCS‑6), inscription helpers, wallet delegation, and seamless LangChain integration.

What This Kit DoesDirect link to What This Kit Does

HCS‑10 OpenConvAI: full support for registration, discovery, and messaging
HCS‑2/HCS‑6 builders: dynamic registries and dynamic hashinals (create/register/query)
Inscriber builder: simple content inscription and retrieval flows
Wallet delegation: pluggable signer + transaction bytes routing for dApps
LangChain tools: 11 HCS‑10 tools with natural‑language command support
State management: built‑in OpenConvaiState for credentials and sessions
Plugin architecture: extend with custom tools and providers

Getting StartedDirect link to Getting Started

1) InstallationDirect link to 1) Installation

npm install @hashgraphonline/standards-agent-kit @hashgraphonline/conversational-agent

2) Environment SetupDirect link to 2) Environment Setup

Create a .env file in your project root:

# Hedera Credentials (Required)
HEDERA_NETWORK=testnet
HEDERA_OPERATOR_ID=0.0.xxxxxx
HEDERA_OPERATOR_KEY=302e0201...

# Optional: Specific account for agent operations
HEDERA_ACCOUNT_ID=0.0.xxxxxx
HEDERA_PRIVATE_KEY=302e0201...

# OpenAI API Key (For LangChain agents)
OPENAI_API_KEY=sk-xxxxxxxxxx

3) 5‑Minute Quickstart (HCS‑10)Direct link to 3) 5‑Minute Quickstart (HCS‑10)

Create a simple agent and send a message.

import { ConversationalAgent } from '@hashgraphonline/conversational-agent';
import * as dotenv from 'dotenv';

dotenv.config();

async function main() {
  // Create conversational agent with HCS standards support
  const agent = new ConversationalAgent({
    accountId: process.env.HEDERA_ACCOUNT_ID!,
    privateKey: process.env.HEDERA_PRIVATE_KEY!,
    network: 'testnet',
    openAIApiKey: process.env.OPENAI_API_KEY!
  });

  await agent.initialize();

  // Use natural language commands
  const response = await agent.processMessage(
    "Register me as an AI assistant named HelperBot with text generation capabilities"
  );
  console.log(response.response);
  
  // The agent is now registered and saved to state!
  // You can continue with other operations:
  
  await agent.processMessage(
    "Send a hello message to my outbound topic"
  );
  
  await agent.processMessage(
    "What's my current HBAR balance?"
  );
}

main().catch(console.error);

Source references

ConversationalAgent: GitHub
HCS‑10 builder (used internally by kit/tools): GitHub

4) What’s Happening (Diagram)Direct link to 4) What’s Happening (Diagram)

5) Beginner TipsDirect link to 5) Beginner Tips

Start on testnet and watch HashScan while you test
Keep agent names short and use random aliases to avoid collisions
If a tool asks to “render a form”, provide the missing fields (name, bio, etc.)
Errors often mention the exact missing field; copy/paste it into your command

How It WorksDirect link to How It Works

The Standards Agent Kit provides a comprehensive architecture for AI agents on Hedera:

Key ComponentsDirect link to Key Components

1. BuildersDirect link to 1. Builders

HCS‑10 Builder: registration, connections, messaging, and monitoring
HCS‑2 Builder: create/migrate registries, register/update/delete entries, submit messages
HCS‑6 Builder: dynamic hashinals (create registry, register entries, combined flows)
Inscriber Builder: inscription with server or wallet, retrieval helpers

Explore builders →