cursorrules

Hashgraph Online (HOL) Development Rules

You are an expert TypeScript developer building applications with Hashgraph Online (HOL) - the open-source SDK for AI agents and decentralized applications on Hedera.

Technology Stack

Core:

• Language: TypeScript (strict mode)
• Runtime: Node.js 20+
• Package Manager: pnpm
• Testing: Jest with @swc/jest

HOL SDK:

• @hashgraphonline/standards-sdk - Core SDK for HCS standards and Registry Broker
• @hol-org/hashnet-mcp - MCP server for AI agent integration

Frontend (when applicable):

• Framework: Next.js 14+ (App Router)
• UI: shadcn/ui + Tailwind CSS
• Icons: react-icons (Lucide preferred)

Coding Standards

TypeScript Requirements

• NEVER use any - define proper interfaces
• NEVER use as any casting - use type guards
• ALWAYS define explicit return types
• ALWAYS use generics for flexible code
• Validate external data with type guards or zod

File Naming

• Use kebab-case: registry-client.ts, topic-manager.ts
• Test files: __tests__/registry-client.test.ts
• Components: registry-browser.tsx

Code Style

• Max 500 lines per file - split larger files
• No nested ternaries
• No inline comments - use JSDoc only
• No console.log - use Logger from standards-sdk
• Prettier formatting required

React Patterns (when applicable)

• NO render functions like renderContent()
• NO inline callbacks in JSX
• NO hooks in loops/conditionals
• ALWAYS use separate child components
• ALWAYS define Props interfaces

HOL SDK Usage

RegistryBrokerClient - Initialization

import { RegistryBrokerClient } from '@hashgraphonline/standards-sdk';

const client = new RegistryBrokerClient({
  baseUrl: 'https://api.hol.org',
  apiKey: process.env.HOL_API_KEY,
});

RegistryBrokerClient - Search Agents

import { RegistryBrokerClient, SearchParams, Logger } from '@hashgraphonline/standards-sdk';

const logger = new Logger({ module: 'AgentSearch', level: 'info' });
const client = new RegistryBrokerClient();

const searchParams: SearchParams = {
  q: 'weather',
  registry: 'hcs-10',
  limit: 10,
  page: 1,
};

const results = await client.search(searchParams);
logger.info('Search completed', { total: results.total });
results.hits.forEach(agent => {
  logger.debug('Agent found', { name: agent.name, description: agent.description });
});