GENKEYDIDDOC
OPEN AGENT SPECIFICATION

OAS

The reference implementation of the Open Agent Specification. Defines the did:oas method, entity kinds, lineage model, DID document creation, resolution, and verification across 7 SDK languages.

22.7KLOC
10crates
7languages

Capabilities

01

did:oas DID method with 11 entity kinds

02

HKDF-SHA256 deterministic child key derivation

03

Cryptographic lineage proofs (AgentLineageProof2025)

04

W3C Verifiable Credentials attestation

05

Conformance levels: L0, L1, L2

06

Zero network calls in verification paths

10 Crates

Inside OAS

Every crate in the OAS workspace, what it does, and how it fits together.

oas-did

3.2K LOC

DID parsing, validation, and URI construction. Handles the did:oas:<namespace>:<kind>:<id> format with all 11 entity kinds.

01

oas-crypto

4.1K LOC

Ed25519 key generation, HKDF-SHA256 derivation, BLAKE3 hashing, and JCS canonicalization. All keys implement ZeroizeOnDrop.

02

oas-document

3.8K LOC

DID Document builder with verification methods, service endpoints, and authentication relationships. W3C DID Core compliant.

03

oas-lineage

2.9K LOC

AgentLineageProof2025 creation and verification. Validates HKDF derivation chains from agent to human root.

04

oas-resolve

2.4K LOC

DID resolution with pluggable resolvers. Supports local, HTTP, and DHT resolution backends.

05

oas-attestation

2.1K LOC

W3C Verifiable Credentials and trust attestation creation. Ed25519Signature2020 proof suite.

06

oas-sdk

1.2K LOC

Unified SDK re-exporting all OAS crates with a prelude module. The single dependency for most consumers.

07

@openagent/oas-sdk

216K LOC

TypeScript SDK — full OAS implementation with WASM crypto bindings for cross-language parity.

08

openagent-oas (Python)

554K LOC

Python SDK — sync and async APIs, Pydantic models, comprehensive type hints.

09

oas-go

7.4K LOC

Go SDK — idiomatic Go with error values, context propagation, and concurrent-safe key operations.

10

Cryptography

Ed25519
HKDF-SHA256
BLAKE3
JCS (RFC 8785)

Available in

Rust
TypeScript
Python
Go
Swift
Kotlin
JS

Install

$ cargo add oas-sdk
$ npm i @openagent/oas-sdk
$ pip install openagent-oas
$ go get github.com/openagentid/oas-go

Start building with OAS

Read the documentation or explore the source.