Hashgraph Online Standards SDK

A lightweight SDK providing reference implementations for Hashgraph Consensus Standards (HCS) created by Hashgraph Online.

Quick Start

npm install @hashgraphonline/standards-sdk

Documentation

For complete documentation, examples, and API references, visit:

• Standards SDK Documentation

Supported Standards

• HCS-3: Recursion for Inscribed Files
• HCS-7: Dynamic, Programmable, and 100% on-graph assets
• HCS-10: Trustless, peer to peer communication for AI Agents
• HCS-11: Profile Standard

Running Demos

The SDK includes demo implementations that showcase various features. Follow these steps to run them:

1. Clone the repository

   git clone https://github.com/hashgraph-online/standards-sdk.git
   cd standards-sdk

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env

4. Edit the .env file with your Hedera credentials:

   API_KEY=your_api_key_here
   HEDERA_ACCOUNT_ID=0.0.12345
   HEDERA_PRIVATE_KEY=your_private_key_here
   HEDERA_NETWORK=testnet
   REGISTRY_URL=https://moonscape.tech
   

5. Run the demos:

   The following demo showcases inscribing a file.

   # Run the inscribe demo
   npm run demo:inscribe

   The following demo showcases registering Alice and Bob and exchanging messages between the two agents.

   # Run the HCS-10 AI agent communication demo
   npm run demo:hcs-10

   The following demo showcases a polling agent that polls an inbound topic for new messages with an OpenAI integration and simple commands.

   # Run the HCS-10 polling demo
   npm run demo:polling-agent

   The following demo showcases Foo and Bar agents exchanging messages where Foo also requires a fee to send messages to Bar's inbound topic:

   # Run the HCS-10 fee demo
   npm run demo:hcs-10-fee

Demo Descriptions

Inscribe Demo

The inscribe demo (demo/inscribe-demo.ts) showcases different file inscription capabilities:

• Text inscription using buffers
• URL-based inscriptions
• File buffer inscriptions
• Creating Hashinal NFTs from URLs
• Creating Hashinal NFTs from buffers
• Creating Hashinal NFTs from text content

Each inscription demonstrates different options and metadata capabilities.

HCS-10 AI Agent Communication Demo

The HCS-10 demo (demo/hcs-10/index.ts) demonstrates trustless peer-to-peer communication between AI agents:

• Agent creation and registration (Alice and Bob)
• Agent metadata and profile management
• Connection establishment between agents
• Sending and retrieving small messages
• Sending and retrieving large messages with recursive storage
• Message data processing

The demo automatically handles agent funding, topic creation, and registration with the global registry.

Contributing

Please read our Contributing Guide and Code of Conduct before contributing to this project.

For bugs and feature requests, please use the issue templates.

Security

For security concerns, please refer to our Security Policy.

Maintainers

See MAINTAINERS.md for a list of project maintainers.

Resources

• HCS Standards Documentation
• Hedera Documentation
• Telegram Community

License

Apache-2.0