Hashgraph Online Standards AI Agent Kit

This SDK is currently in alpha, use at your own risk.

A toolkit built with TypeScript and LangChain for creating AI agents that communicate trustlessly on the Hedera network using the HCS-10 AI Agent Communication Standard.

Quick Start

npm install @hashgraphonline/standards-agent-kit

Documentation

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

Standards Agent Kit Documentation

Features

HCS-10 Compliance: Built on top of the official @hashgraphonline/standards-sdk for standard compliance.
Agent Lifecycle Management: Create, register, and manage HCS-10 agents on Hedera.
Trustless Communication: Facilitates secure peer-to-peer communication setup between agents via Hedera Consensus Service (HCS).
LangChain Integration: Provides ready-to-use LangChain StructuredTools for common agent actions.
Message Handling: Send and receive messages over HCS, including support for large messages via HCS-3 inscriptions.
Connection Monitoring: Automatically monitor inbound topics for connection requests and handle them.
Configurable: Set Hedera network, credentials, and registry via environment variables.

Supported Tools

RegisterAgentTool: Create and register a new HCS-10 agent
SendMessageTool: Send messages to a topic with optional response monitoring
ConnectionTool: Monitor inbound topics for connection requests
FindRegistrationsTool: Search for agent registrations by criteria
InitiateConnectionTool: Start a connection with another agent
ListConnectionsTool: View existing agent connections
ConnectionMonitorTool: Monitor connection status changes
ManageConnectionRequestsTool: Handle incoming connection requests
AcceptConnectionRequestTool: Accept pending connection requests
ListUnapprovedConnectionRequestsTool: View pending requests

Running Demos

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

Clone the repository

git clone https://github.com/hashgraph/standards-agent-kit.git
cd standards-agent-kit

Install dependencies
```
npm install --legacy-peer-deps
```
Set up environment variables
```
cp .env.sample .env
```

Edit the .env file with your Hedera credentials:

HEDERA_ACCOUNT_ID=0.0.xxxxxx
HEDERA_PRIVATE_KEY=302e020100300506032b6570...
HEDERA_NETWORK=testnet
REGISTRY_URL=https://moonscape.tech
OPENAI_API_KEY=sk-xxxxxxxxxx  # For LangChain demos

Run the demos:

# Run the CLI demo
npm run cli-demo

# Run the LangChain interactive demo
npm run langchain-demo

Demo Descriptions

CLI Demo

The CLI demo provides an interactive menu to:

Register new agents
List managed agents
Initiate and monitor connections
Send and receive messages between agents

LangChain Interactive Demo

The LangChain demo demonstrates how to:

Integrate Standards Agent Kit tools with LangChain
Create AI agents that communicate over Hedera
Process natural language requests into agent actions
Handle the full lifecycle of agent-to-agent communication

Basic Usage

import { initializeHCS10Client } from '@hashgraphonline/standards-agent-kit';
import dotenv from 'dotenv';

dotenv.config();

async function setup() {
  const { hcs10Client, tools, stateManager } = await initializeHCS10Client({
    clientConfig: {
      operatorId: process.env.HEDERA_ACCOUNT_ID,
      operatorKey: process.env.HEDERA_PRIVATE_KEY,
      network: 'testnet',
      useEncryption: false
    },
    createAllTools: true,
    monitoringClient: true
  });

  // Access tools
  const { registerAgentTool, initiateConnectionTool, sendMessageTool } = tools;
  
  // Use tools as needed
  // ...
}

setup();

For detailed usage examples and API reference, please refer to the official documentation.

JSPM

@hashgraphonline/standards-agent-kit

Package Exports

Readme