Documentation

Everything you need to integrate, deploy, and extend the Agentity Protocol.

Getting Started

getting-started.md

Install the SDK, create an agent identity, sign and verify HTTP requests, or use the middleware for automatic verification.

bash
# Python
pip install agentity-sdk-python agentity-registry agentity-auth

# TypeScript
pnpm add @agentity/sdk

Read the full guide →

Architecture

architecture.md

Four-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.

Read the architecture docs →

Security

security.md

Six defense layers: Ed25519 signatures, anti-replay (nonce + timestamp), key rotation (version+1), delegation chains (max 10), OIDC owner verification, rate limiting.

Read the security docs →

Registry API

registry-api.md

Full reference for the FastAPI registry — register, lookup, revoke, audit log, WebSocket events, OIDC endpoints, rate limiting headers.

Read the API reference →

CLI

cli.md

The agentity CLI supports five commands: create, inspect, verify, sign, manifest.

bash
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/data

Read the CLI reference →

Deployment

deployment.md

Docker Compose setup for production: Registry + PostgreSQL + Redis. Environment variable reference for OIDC, EVM, and store configuration.

Read the deployment guide →

Development

development.md

Set up the monorepo for all three languages. Build, test, and lint commands for Rust (17 tests), Python (43 tests), and TypeScript (19 tests).

Read the dev guide →

Protocol Specification

../packages/agentity-spec/SPEC.md

Formal RFC for the did:agentity method — AID schema, delegation rules, provider manifest format, HTTP headers, verification rules.

Read the spec →

Package READMEs