Documentation
Everything you need to integrate, deploy, and extend the Agentity Protocol.
Getting Started
getting-started.mdInstall the SDK, create an agent identity, sign and verify HTTP requests, or use the middleware for automatic verification.
# Python
pip install agentity-sdk-python agentity-registry agentity-auth
# TypeScript
pnpm add @agentity/sdkArchitecture
architecture.mdFour-layer design: Core (Rust) → SDKs (Python/TS) → Middleware → Service Layer (Registry).
Each agent carries a self-signed did:agentity identity document with Ed25519 keys and scope declarations.
Security
security.mdSix defense layers: Ed25519 signatures, anti-replay (nonce + timestamp), key rotation (version+1), delegation chains (max 10), OIDC owner verification, rate limiting.
Registry API
registry-api.mdFull reference for the FastAPI registry — register, lookup, revoke, audit log, WebSocket events, OIDC endpoints, rate limiting headers.
CLI
cli.mdThe agentity CLI supports five commands: create, inspect, verify, sign, manifest.
agentity create --owner "did:agentity:human:alice" --scope "api:read" --output agent.json
agentity inspect agent.json
agentity sign --key agent.json --url https://api.example.com/dataDeployment
deployment.mdDocker Compose setup for production: Registry + PostgreSQL + Redis. Environment variable reference for OIDC, EVM, and store configuration.
Development
development.mdSet up the monorepo for all three languages. Build, test, and lint commands for Rust (17 tests), Python (43 tests), and TypeScript (19 tests).
Protocol Specification
../packages/agentity-spec/SPEC.mdFormal RFC for the did:agentity method — AID schema, delegation rules, provider manifest format, HTTP headers, verification rules.
Package READMEs
agentity-core
Rust
Core crypto library
agentity-sdk-python
Python
SDK with LangChain integration
agentity-sdk-ts
TypeScript
SDK for Node.js/Next.js
agentity-registry
Python
FastAPI REST registry
agentity-auth
Python
OIDC authentication plugin
agentity-cli
Python
Command-line interface
agentity-middleware-python
Python
FastAPI middleware
agentity-middleware-express
TypeScript
Express middleware
agentity-mcp
Python
MCP protocol plugin
agentity-a2a
Python
A2A protocol plugin
agentity-inspector
TypeScript
Next.js dashboard
agentity-manifest-gen
TypeScript
Manifest generator CLI
agentity-evm
Python+Sol
EVM cross-registry bridge