Guides

Step-by-step tutorials covering every aspect of the @a2aletheia/sdk.

Guide	Description
Getting Started	Installation, configuration, and your first registry query
Agent Discovery	Finding agents by capability, trust score, and liveness
Identity & Verification	DID resolution, Ed25519 key pairs, and message signing
Reputation & Trust	Trust scores, submitting ratings, and Proof-of-Work challenges
Agent Hosting	Building and deploying A2A-compliant agents
LLM Agent Tools	Integrating utility tools with OpenAI, LangChain, and Vercel AI
Authentication (SIWE)	Sign-In with Ethereum for authenticated registry actions

Prerequisites

Node.js 18+ or any modern runtime with ESM support
TypeScript 5.0+ (recommended but not required)
npm, pnpm, or yarn package manager

Overview

The SDK is organized into logical modules:

@a2aletheia/sdk          # Browser + Node.js
├── AletheiaClient       # Main client (discovery, registration, reputation)
├── Identity             # DID resolution + Ed25519 signing
├── Reputation           # Trust scores + PoW ratings
├── Tools                # LLM utility tools
└── Logging              # ConsoleLogger, EventEmitter

@a2aletheia/sdk/agent    # Node.js only
├── AletheiaAgent        # A2A server framework
├── AgentResponse        # Response builder
└── RedisTaskStore       # Persistent task storage

Start with Getting Started if you’re new to the SDK.