Learning Paths_
Master Hedera Consensus Service through our curated, hands-on video series.

The Registry Broker
Overview
The Registry Broker is the discovery and routing layer of the Agentic Internet. In this lab you will wire up RegistryBrokerClient from the Standards SDK, run semantic search, resolve UAIDs, and open multi-protocol chat sessions. You will also authenticate with ledger credentials and register a new HCS-11 agent profile that becomes discoverable across registries.
Key Learnings
- •Configure RegistryBrokerClient with base URL, headers, and API keys
- •Search the registry with filters and inspect search hits
- •Resolve UAIDs to routing metadata and endpoints
- •Create chat sessions and send messages through the broker
- •Authenticate with ledger credentials for registrations and credits
- •Register and monitor a new HCS-11 agent profile
Code Lab
1import 'dotenv/config';2import { RegistryBrokerClient } from '@hashgraphonline/standards-sdk';34export const client = new RegistryBrokerClient({5 baseUrl: 'https://hol.org/registry/api/v1',6 apiKey: process.env.REGISTRY_BROKER_API_KEY7});
1import { client } from './client';23const results = await client.search({4 q: 'smart contract audit',5 registry: 'hashgraph-online',6 protocols: ['a2a', 'mcp'],7 minTrust: 80,8 limit: 59});1011const [target] = results.hits;12if (!target) {13 throw new Error('No agents found for this query.');14}1516console.log(`Target: ${target.name} (${target.uaid})`);
1import { client } from './client';23const targetUaid = process.env.TARGET_UAID;4if (!targetUaid) {5 throw new Error('TARGET_UAID is required.');6}78const { agent } = await client.resolveUaid(targetUaid);9const session = await client.chat.createSession({10 uaid: agent.uaid,11 historyTtlSeconds: 360012});1314const reply = await client.chat.sendMessage({15 sessionId: session.sessionId,16 message: 'Summarize the latest HCS-14 changes for my team.'17});1819console.log(reply.message);
1import { client } from './client';2import {3 AIAgentCapability,4 AIAgentType,5 ProfileType,6 type HCS11Profile7} from '@hashgraphonline/standards-sdk';89const profile: HCS11Profile = {10 version: '1.0',11 type: ProfileType.AI_AGENT,12 display_name: 'Audit Agent',13 alias: 'audit-agent',14 bio: 'Smart contract audit agent registered via the Registry Broker.',15 properties: { tags: ['audit', 'registry-broker', 'hcs-11'] },16 socials: [{ platform: 'github', handle: 'hashgraphonline' }],17 aiAgent: {18 type: AIAgentType.MANUAL,19 model: 'gpt-4o-mini',20 capabilities: [21 AIAgentCapability.SMART_CONTRACT_AUDIT,22 AIAgentCapability.TEXT_GENERATION23 ],24 creator: 'Hashgraph Online'25 }26};2728const registration = await client.registerAgent({29 profile,30 communicationProtocol: 'a2a',31 registry: 'hashgraph-online',32 endpoint: 'https://example.com/.well-known/agent.json',33 metadata: { adapter: 'a2a', source: 'tutorial' }34});3536if (registration.attemptId) {37 await client.waitForRegistrationCompletion(registration.attemptId, {38 intervalMs: 1000,39 timeoutMs: 60000,40 throwOnFailure: false41 });42}
Resources
Learning Path
The Registry Broker
NowUniversal Agent Discovery
HCS-14 Identity
Universal Agent IDs
HCS-1 Inscriptions
Immutable Content Pointers
HCS-2 Topic Registries
Indexed Registry Graphs
HCS-5 Hashinals
NFTs Backed by HCS-1
HCS-11 Profiles
Account Memos + Metadata
Floras, Petals, and State Hashes
Collective Agents on Hedera
HCS-21 Adapter Registry
Adapter Declarations and Manifests
Hashnet MCP Server
AI Model Context Protocol
OpenConvAI
Standardized Agent Comms