Documentation
Technical reference for the PEAC Protocol. Guides, specifications, integrations, tooling, and security.
Evaluating PEAC?
If you are assessing PEAC for your organization, start with these pages:
Getting Started
Reference Quickstart
Issue, verify, and attach receipts in minimal code. Covers @peac/protocol, @peac/crypto, and middleware.
Add to an HTTP API
Express middleware setup for auto-issuing receipts on API responses.
Add to MCP
Attach evidence to MCP tool responses via _meta fields.
Add to A2A
Carry receipts through Agent-to-Agent Protocol metadata.
Verify a Record
Offline verification with a public key: signature, claims, expiry, and kernel constraints.
Create an Evidence Bundle
Combine multiple receipts into a single portable evidence bundle.
Specification
Protocol Specification
Full specification: record structure, claims, kinds, types, extensions, and conformance requirements.
Wire Format
JWS structure, JOSE header, claims layout, and encoding for interaction-record+jwt.
Evidence Carrier Contract
PeacEvidenceCarrier type, CarrierAdapter pattern, and transport size limits.
Evidence Bundles
Multi-receipt bundle format for audit, dispute review, and archival.
Protocol Behavior
Normative protocol behavior: issuance, verification, error handling, and kernel constraints.
Integrations
All Integrations
Index of all agent protocol, payment rail, framework, and AI integrations.
MCP Integration
Model Context Protocol evidence mapping via @peac/mappings-mcp.
A2A Integration
Agent-to-Agent Protocol evidence in TaskStatus, Message, and Artifact metadata.
Express Middleware
Auto-issue receipts on Express.js API responses with @peac/middleware-express.
x402 Payment Evidence
HTTP 402 payment evidence with dual-header read and upstream artifact separation.
Adapters and Mappings
All Layer 4 adapters: payment rails, agent protocols, content signals, inference.
Tools
CLI
Verify receipts, run conformance tests, author policies, and bundle evidence from the terminal.
MCP Server
5-tool MCP server for verify, inspect, decode, issue, and bundle operations in Claude Desktop or Cursor.
Conformance Testing
Three-level conformance suite: basic (structure + signature), standard (+ claims), full (+ constraints + policy).
Online Verifier
Paste a compact JWS and verify it in the browser. No server round-trip.
Reference
Error Codes
13 error categories with machine-readable codes, HTTP status mappings, and recovery hints.
Examples
Runnable examples: hello-world, x402 payment, MCP tool call, A2A gateway, content signals, and more.
Packages
Package reference for the 6-layer architecture: kernel, schema, crypto, protocol, adapters, and applications.
Releases
Release history, changelogs, and npm publication status.
API Reference
Public API surface for @peac/protocol, @peac/crypto, and @peac/schema.
Security and Governance
Security
Security model: SSRF prevention, JOSE hardening, no ambient key discovery, fail-closed defaults.
Security Policy
Vulnerability reporting process and responsible disclosure.
Governance
Protocol governance model, decision process, and contributor roles.
Research
Protocol research: trust models, agent economy analysis, and standards landscape.