peac

# PEAC Protocol

> Open standard for verifiable interaction records across agent, tool, API, MCP, and cross-runtime systems.
> Portable signed records anyone can verify offline.
> Current release: v0.16.4
> Last reviewed: 2026-06-24

## What is PEAC

PEAC Protocol provides cryptographically signed, offline-verifiable interaction records for automated interactions.

The current signed wire artifact is a compact JWS using Ed25519 signatures. Records can be verified offline with the issuer's public key or a pinned JWKS.

PEAC does not orchestrate protocols, control systems, or enforce behavior. It records neutral evidence of what terms applied and what happened so another party can verify it outside the system that produced it.

## Quick Start

- Install the MCP server: `npx -y @peac/mcp-server`
- Verify offline from the CLI: `pnpm dlx @peac/cli samples generate -o ./s` then `pnpm dlx @peac/cli verify ./s/valid/basic-record.jws --public-key ./s/bundles/sandbox-jwks.json` (prints `Signature valid (offline).`)
- Verify a record over MCP: start the MCP server, then call `peac_verify` with a JWS and public key
- Issue a record: use `@peac/protocol` with `issue()` and an Ed25519 signing key
- GitHub: https://github.com/peacprotocol/peac
- Website: https://www.peacprotocol.org
- MCP Registry: `io.github.peacprotocol/peac`

## Key Packages

- `@peac/kernel`: normative constants, error codes, and type definitions
- `@peac/schema`: validation schemas for interaction records and evidence extensions
- `@peac/crypto`: Ed25519 signing and verification
- `@peac/protocol`: high-level issue and verify API
- `@peac/mcp-server`: MCP server for record verification, inspection, issuance, and bundles
- `@peac/cli`: command-line tools for issuing, verifying, and recording interactions

## Integration Surfaces

- MCP: `@peac/mcp-server`
- HTTP: `PEAC-Receipt` response header carries a compact JWS
- A2A: `@peac/mappings-a2a`
- ACP: `@peac/mappings-acp` for Agentic Commerce Protocol evidence
- UCP: `@peac/mappings-ucp`
- x402: `@peac/adapter-x402`
- Content signals: `@peac/mappings-content-signals`
- OpenAI-compatible inference: `@peac/adapter-openai-compatible`
- Evidence Carrier Contract: common carry interface across supported protocol surfaces

## Documentation

- Start Here: https://www.peacprotocol.org/start-here
- Integration patterns: https://github.com/peacprotocol/peac/blob/main/docs/guides/integration-patterns.md
- Verification options: https://github.com/peacprotocol/peac/blob/main/docs/guides/verification-options.md
- Offline sample index: https://github.com/peacprotocol/peac/blob/main/docs/guides/offline-sample-index.md
- Wire Format: https://www.peacprotocol.org/docs/architecture/wire-format
- Package Layering: https://www.peacprotocol.org/docs/architecture/package-layering
- Error Codes: https://www.peacprotocol.org/docs/reference/error-codes
- Evidence Carrier Contract: https://github.com/peacprotocol/peac/blob/main/docs/specs/EVIDENCE-CARRIER-CONTRACT.md
- Kernel Constraints: https://github.com/peacprotocol/peac/blob/main/docs/specs/KERNEL-CONSTRAINTS.md
- MCP Server: https://www.peacprotocol.org/tools/mcp-server
- Security: https://www.peacprotocol.org/security

## Technical Notes

- Current record format: `interaction-record+jwt`
- Frozen legacy format: `peac-receipt/0.1`
- Signing algorithm: Ed25519 (RFC 8032)
- Error format: RFC 9457 Problem Details
- Discovery: `/.well-known/peac-issuer.json` with `jwks_uri`
- License: Apache-2.0
- Steward: Originary, https://www.originary.xyz