Documentation
Everything you need to implement verifiable interaction records: portable receipts, policy surfaces, and offline verification.
Installation
# TypeScript/Node.js
pnpm add @peac/protocol
# Go SDK
go get github.com/peacprotocol/peac/sdks/go
# CLI tools
pnpm add -g @peac/cli
# Initialize policy file
npx peac policy init
# Validate configuration
npx peac policy validate peac-policy.yamlRequires Node.js 20+ (TypeScript) or Go 1.21+ (Go SDK). Current version: v0.10.0
Getting Started
Core Packages
@peac/protocolL3Issue and verify receipts
@peac/cryptoL2Ed25519 key generation and signing
@peac/schemaL1Zod schemas for validation
@peac/kernelL0Core types, constants, errors
@peac/policy-kitL4YAML/JSON policy evaluation
@peac/auditL4Dispute bundles and verification reports
@peac/cliL5Command-line tools
sdks/go/SDKGo SDK for issue, verify, and policy evaluation
Common Use Cases
Cross-Org Accountability
Verifiable evidence of what policy was applied and what was accessed.
Agent Commerce
Autonomous agents discover pricing, negotiate terms, and retain payment proof.
Incident Response
Trace agent actions back to specific decisions with audit bundles.
Regulated Provenance
Machine-verifiable audit trails for compliance evidence programs.
API Metering
Cryptographic proof of usage for billing and rate limiting.
Content Licensing
Track attribution and licensing with verifiable attribution chains.
Latest: v0.10.0 (Jan 14, 2026)
Wire Format Normalization
Wire FormatHyphenated typ identifier (peac-receipt/0.1) - repo version now decoupled from wire version
Schema Namespace Update
Schemaspeacprotocol.org/schemas/wire/0.1/ - consistent artifact naming across packages
Go SDK Alignment
sdks/gojws.DefaultReceiptTyp constant updated for cross-language conformance
34 Packages
npmAll packages updated to 0.10.0 with npm publish (dist-tag: next)
v0.9.30: Dispute Bundles
Dispute Bundle Format
@peac/auditZIP-based archive format for offline verification with deterministic reports
Verification Reports
@peac/auditJCS canonicalization with SHA-256 report hashes for cross-language parity
CLI Bundle Commands
@peac/clipeac bundle create|verify|info with JSON output for automation
Error Codegen
ToolingAuto-generate error codes from specs/kernel/errors.json with CI drift check
v0.9.29: Go SDK Parity
peac.Issue()
sdks/go/Create signed PEAC receipts with Ed25519 in Go
peac.Verify()
sdks/go/Receipt verification with Ed25519 + JWS + JWKS discovery
peac.Policy()
sdks/go/policy/Policy rule evaluation with first-match-wins semantics
Go Middleware
sdks/go/middleware/Chi and Gin framework middleware with context-based claims access
v0.9.28: Edge + Scale
Contracts Package
@peac/contractsCanonical error codes with E_* prefix and MODE_BEHAVIOR contract
Worker Core
@peac/worker-coreRuntime-neutral TAP verification handler with security hardening
Edge Deployment Guides
docs/guides/edge/Cloudflare Workers, Fastly Compute, Akamai EdgeWorkers with RFC 9421
RFC 6648 Compliance
HeadersAll headers now use PEAC-* prefix (removed X-PEAC-*)
v0.9.24-27: Purpose, Identity, Attribution, Dispute
Purpose on Wire
@peac/mappings-aiprefPEAC-Purpose headers and enforcement profiles (v0.9.24)
Agent Identity
@peac/schemaCryptographic proof-of-control binding with key lifecycle (v0.9.25)
Attribution Chains
@peac/attributionContent provenance with hash verification and cycle detection (v0.9.26)
Dispute Attestations
@peac/auditFormal contestation with lifecycle states and audit logs (v0.9.27)