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 behind the OpenAgent SDK facade.

22.7KLOC
10crates
2languages

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 for parse, signature, and Sigil-backed authority checks

06

Local base identity checks with fail-closed privileged authority

8 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

Rust facade re-exporting the OAS crates used by the OpenAgent SDK for DID and lineage operations.

07

@openagent/sdk

LOC

TypeScript OpenAgent facade that uses OAS identity together with AEGIS verification and Arsenal credentials.

08

Cryptography

Ed25519
HKDF-SHA256
BLAKE3
JCS (RFC 8785)

Available in

Rust
TypeScript

Install

$ cargo add openagent-sdk --git https://github.com/OpenAgentID/openagent-sdk
$ npm i github:OpenAgentID/openagent-sdk

Start building with OAS

Read the documentation or explore the source.