Installation
Install the packages you need based on your integration. All packages are published on npm under the @peac scope.
- Node.js >= 22.13.0 -- check with
node --version - npm, yarn, or pnpm package manager
Core protocol
The main package for receipt issuance and verification. This is the starting point for most integrations.
npm install @peac/protocol
This gives you the high-level API: issue(), verifyLocal(), schema validation, and all kernel types. The Interaction Record format supports structured kinds, typed extensions, and policy binding.
Express middleware
Add automatic receipt issuance to any Express.js application.
npm install @peac/protocol @peac/middleware-express
One middleware call attaches a signed PEAC-Receipt header to every response.
MCP server
Expose PEAC receipt operations to AI agents via Model Context Protocol. Five tools: verify, inspect, decode, issue, and bundle.
npm install @peac/mcp-server
Payment rails
Attach payment evidence from your payment processor to PEAC receipts.
x402 (Coinbase)
npm install @peac/protocol @peac/rails-x402
Stripe
npm install @peac/protocol @peac/rails-stripe
Card networks
npm install @peac/protocol @peac/rails-card
HTTP 402 (generic multi-rail)
npm install @peac/protocol @peac/adapter-x402
x402 ecosystem adapters
Normalize events from x402 ecosystem platforms into PEAC receipts.
# Daydreams AI inference events
npm install @peac/adapter-x402-daydreams
# Fluora MCP marketplace events
npm install @peac/adapter-x402-fluora
# Pinata private IPFS object events
npm install @peac/adapter-x402-pinata
Agent protocol mappings
Map metadata from agent communication protocols into PEAC receipt evidence.
MCP (Model Context Protocol)
npm install @peac/protocol @peac/mappings-mcp
ACP (Agentic Commerce Protocol)
npm install @peac/protocol @peac/mappings-acp
TAP (Visa Trusted Agent Protocol)
npm install @peac/protocol @peac/mappings-tap
UCP (Google Universal Commerce Protocol)
npm install @peac/protocol @peac/mappings-ucp
RSL (Robots Specification Layer)
npm install @peac/protocol @peac/mappings-rsl
AIPREF (IETF AI Preferences)
npm install @peac/protocol @peac/mappings-aipref
A2A (Agent-to-Agent Protocol)
npm install @peac/protocol @peac/mappings-a2a
Content signals
Observe content use policy signals from robots.txt, AIPREF headers, and tdmrep.json. Observation-only: records signals, never enforces them.
npm install @peac/mappings-content-signals
Inference evidence
Hash-first interaction evidence for OpenAI-compatible chat completion APIs. Records SHA-256 digests of prompts and outputs; no raw text stored.
npm install @peac/adapter-openai-compatible
OpenClaw capture
Capture interaction evidence using the OpenClaw adapter with spool store and deduplication.
npm install @peac/adapter-openclaw @peac/capture-core
For file-system-backed durable stores (spool + deduplication index):
npm install @peac/adapter-openclaw @peac/capture-core @peac/capture-node
Full package reference
36 packages published on npm, plus additional workspace-private packages. Dependencies flow down only -- higher layers depend on lower layers, never the reverse.
Layer 0 -- Kernel
| Package | Purpose |
|---|---|
@peac/kernel | Normative constants, error codes, and registry types |
Layer 1 -- Schema
| Package | Purpose |
|---|---|
@peac/schema | Zod schemas, JSON schemas, OpenAPI specs, and TypeScript types |
Layer 2 -- Crypto
| Package | Purpose |
|---|---|
@peac/crypto | Ed25519 JWS signing and verification |
Layer 3 -- Protocol
| Package | Purpose |
|---|---|
@peac/protocol | High-level issuance and verification API |
@peac/control | Policy evaluation and access control engine |
@peac/contracts | Canonical error codes and verification mode contracts |
@peac/receipts | Receipt builders, parsers, and validators with CBOR support |
@peac/capture-core | Spool store and deduplication primitives |
@peac/capture-node | File-system-backed durable stores (Node.js) |
@peac/attribution | Content derivation and usage proof attestation |
@peac/audit | Audit logging and case bundle generation for disputes |
@peac/policy-kit | Deterministic policy evaluation and peac.txt parsing |
@peac/net-node | SSRF-safe network utilities with DNS pinning (Node.js) |
@peac/jwks-cache | Edge-safe JWKS fetch and cache with SSRF protection |
@peac/http-signatures | RFC 9421 HTTP Message Signatures parsing and verification |
Layer 3.5 -- Middleware
| Package | Purpose |
|---|---|
@peac/middleware-core | Framework-agnostic middleware primitives |
@peac/middleware-express | Express.js middleware for automatic receipt issuance |
Layer 4 -- Adapters and mappings
| Package | Purpose |
|---|---|
@peac/rails-x402 | x402 payment evidence adapter (Coinbase) |
@peac/rails-stripe | Stripe payment evidence adapter |
@peac/rails-card | Card network evidence adapter (Flowglad, Stripe Billing, Lago) |
@peac/adapter-x402 | x402 evidence adapter with four-layer architecture |
@peac/adapter-core | Shared utilities for payment rail adapters |
@peac/adapter-runtime-governance | Generic runtime governance evidence adapter (AGT as first mapper) |
@peac/adapter-managed-agents | Claude Managed Agents session evidence adapter |
@peac/adapter-did | did:key and did:web resolution with caching |
@peac/adapter-x402-daydreams | Daydreams AI inference event normalizer |
@peac/adapter-x402-fluora | Fluora MCP marketplace event normalizer |
@peac/adapter-x402-pinata | Pinata private IPFS object event normalizer |
@peac/adapter-openclaw | OpenClaw capture adapter |
@peac/adapter-openai-compatible | Hash-first inference evidence for OpenAI-compatible APIs |
@peac/transport-grpc | gRPC carrier adapter (8 KiB metadata default) |
@peac/mappings-mcp | MCP tool call evidence mapping |
@peac/mappings-acp | ACP interaction evidence mapping |
@peac/mappings-tap | Visa Trusted Agent Protocol mapping |
@peac/mappings-ucp | Google Universal Commerce Protocol mapping |
@peac/mappings-rsl | Robots Specification Layer mapping |
@peac/mappings-a2a | A2A interaction evidence mapping (v1.0.0 required) |
@peac/mappings-aipref | IETF AIPREF vocabulary mapping |
@peac/mappings-paymentauth | HTTP Payment authentication challenge and receipt mapping |
@peac/mappings-content-signals | Content use policy signal observation |
@peac/mappings-intoto | in-toto v1.0 provenance mapping |
@peac/mappings-slsa | SLSA v1.2 provenance mapping |
Layer 5 -- Applications
| Package | Purpose |
|---|---|
@peac/mcp-server | MCP server with 5 verification and issuance tools |
@peac/server | Verification server with DoS protection and rate limiting |
@peac/cli | Command-line tools (peac keygen, peac verify, peac doctor, etc.) |
Telemetry
| Package | Purpose |
|---|---|
@peac/telemetry | Telemetry interfaces and no-op implementation |
@peac/telemetry-otel | OpenTelemetry adapter for PEAC telemetry |
Edge workers
| Package | Purpose |
|---|---|
@peac/worker-core | Runtime-neutral TAP verification handler for edge platforms |
If you're not sure which packages you need, start with @peac/protocol. It re-exports the kernel, schema, and crypto layers -- everything you need to issue and verify receipts.