Installation
Install the packages you need based on your integration. All packages are published on npm under the @peac scope.
- Node.js >= 22.0.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: issueReceipt(), verifyReceipt(), schema validation, and all kernel types.
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/pay402
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 (Agent Communication 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
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
22 packages published on npm, plus additional workspace 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 for CAL semantics |
@peac/disc | Lightweight discovery with 20-line enforcement |
@peac/pref | AIPREF resolver with robots.txt bridge |
@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 |
@peac/core | Deprecated -- use @peac/kernel, @peac/schema, @peac/crypto |
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/pay402 | Generic HTTP 402 adapter with multi-rail negotiation |
@peac/adapter-core | Shared utilities for payment rail adapters |
@peac/adapter-x402 | x402 evidence adapter |
@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/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-aipref | IETF AIPREF vocabulary 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, etc.) |
Layer 6 -- Consumer SDK
| Package | Purpose |
|---|---|
@peac/sdk | Client SDK with discover and verify functions |
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.