Docs

Reference material for protocol implementers and integrators.

Protocol

• SPEC v0.1 — the canonical normative specification
• JSON Schema — strict structural contract

Reference implementations

• Python library — sign / verify / canonicalize / CLI
• Node.js library — cross-language interoperable
• FastAPI ledger service — REST surface
• MCP server — for Claude / GPT / Gemini agents

Quick start

# Python
pip install attestproto
attestproto keygen ./keys
attestproto sign --in-place att.json ./keys/signing_key.hex
attestproto verify att.json ./keys/verify_key.hex

# Node.js
npm install @attestproto/core
node node_modules/@attestproto/core/src/cli.js verify att.json ./keys/verify_key.hex

Architecture overview

Producer agents emit signed JSON attestations after completing tasks. Verifiers (downstream agents, regulators, insurers) check the signature against the producer's public key (resolved via DNS, DID, HTTPS, or fingerprint) and the canonical round-trip. A reference ledger optionally stores attestations into per-epoch Merkle trees for time-stamped auditability and computes reputation scores.