PEAC
v0.10.03 rails + 5 agent protocols

Adapters & Integrations

PEAC provides unified verifiable interaction records across systems and organizational boundaries. One receipt format designed to compose with MCP, ACP, A2A, TAP, UCP, x402, payment gateways, and more via adapters and mappings.

Agent Protocol Mappings

Integrate with AI agent and commerce protocols

7 protocols

MCP

@peac/mappings-mcp
Live

Model Context Protocol integration with budget utilities.

  • Per-call and daily budget limits
  • Bigint minor units for precision
  • Tool call authorization

ACP

@peac/mappings-acp
Live

Agentic Commerce Protocol for agent-to-agent transactions.

  • Budget enforcement utilities
  • Agent identity binding
  • Multi-hop transaction support

TAP

@peac/mappings-tap
29 testsLive

Visa Trusted Agent Protocol mapping with signature verification.

  • RFC 9421 HTTP Message Signatures
  • Time window validation (8 min max)
  • Fail-closed security defaults

RSL

@peac/mappings-rsl
47 testsLive

Robots Specification Language alignment for crawl permissions.

  • RSL 1.0 token mapping
  • Extended ControlPurpose (ai_input, ai_index, search)
  • Collective licensing support

UCP

@peac/mappings-ucp
70 testsLive

Google Universal Commerce Protocol webhook verification and mapping.

  • Detached JWS verification (RFC 7797)
  • UCP order to PEAC receipt mapping
  • Dispute evidence generation for audit bundles
  • ES256/ES384/ES512 signature support

AIPREF

@peac/mappings-aipref
32 testsLive

IETF AIPREF vocabulary mapping for purpose declarations.

  • Purpose token normalization
  • Canonical purpose mapping
  • Robots.txt bridge

A2A

spec: a2a-protocol.org
Live

Agent-to-Agent Protocol integration for agent identity and proof of control.

  • Agent Card extension (extensions.org.peacprotocol)
  • Key directory discovery patterns
  • Proof-of-control binding

Payment Rails

3 adapters

x402

@peac/rails-x402
Live

HTTP 402 extension with v2 protocol support and v1 backwards compatibility.

  • v2 dialect with automatic v1 fallback
  • CAIP-2 network identifiers (Base, Avalanche, Solana)
  • Standard HTTP 402 semantics
  • Payment header negotiation

Payment gateways

@peac/rails-stripe
Live

Traditional payment gateway integration with webhook verification and receipt issuance.

  • Checkout Sessions and Payment Intents
  • Webhook signature verification
  • Subscription billing support
  • Receipt issuance on payment success

Card Billing

@peac/rails-card
Live

Generic card billing bridge with billing_snapshot support.

  • billing_snapshot in payment.evidence
  • Works with any card processor
  • Statement descriptor support

x402 Vendor Adapters

Normalize vendor-specific events to PaymentEvidence

3 adapters

Daydreams

@peac/adapter-x402-daydreams
28 testsLive

AI inference router adapter for Daydreams events.

  • Event normalization to PaymentEvidence
  • Model and token tracking
  • Inference cost attribution

Fluora

@peac/adapter-x402-fluora
27 testsLive

MCP marketplace adapter for Fluora hosting events.

  • Tool call metering
  • Hosting cost tracking
  • MCP integration

Pinata

@peac/adapter-x402-pinata
27 testsLive

IPFS gateway adapter for Pinata private objects.

  • Private IPFS object access
  • Bandwidth tracking
  • CID-based authorization

Infrastructure

Low-level utilities and transports

5 packages

Contracts

@peac/contracts
28 testsLive

Single source of truth for error codes and MODE_BEHAVIOR contract.

  • Canonical E_* error codes
  • WWW-Authenticate builder
  • Contract-driven design

Worker Core

@peac/worker-core
112 testsLive

Runtime-neutral TAP verification handler with security hardening.

  • Default mode: tap_only
  • Error message sanitization
  • LRU replay protection

HTTP Signatures

@peac/http-signatures
22 testsLive

RFC 9421 HTTP Message Signatures parsing and verification.

  • Full RFC 9421 compliance
  • Signature-Input parsing
  • Component extraction

JWKS Cache

@peac/jwks-cache
19 testsLive

Edge-safe JWKS fetch with SSRF protection.

  • Literal IP blocking
  • No redirect following
  • Cache TTL management

gRPC Transport

@peac/transport-grpc
60 testsLive

gRPC transport with HTTP StatusCode parity.

  • StatusCode mapping to HTTP
  • Streaming support
  • Metadata propagation

Observability & Telemetry

Trace correlation and metrics for PEAC operations

1 packages

OpenTelemetry

@peac/telemetry-otel
90 testsLive

OpenTelemetry adapter for PEAC telemetry with privacy modes.

  • Privacy modes: strict, balanced, custom
  • W3C Trace Context support
  • Metrics and spans for issue()/verify()

Provenance & Attribution

Content derivation proofs and C2PA bridging

1 packages

Attribution

@peac/attribution
Live

Content derivation and usage proofs for AI training, RAG, and content reuse.

  • Content hash verification (SHA-256)
  • Attribution chain resolution
  • C2PA provenance bridging

Example: Rail-Agnostic Verification

middleware.tsTypeScript
import { verify } from '@peac/protocol'

// Works with any payment rail - same verification logic
app.use('/api/premium', async (req, res, next) => {
  const receipt = req.header('PEAC-Receipt')

  if (!receipt) {
    return res.status(402).json({
      type: 'https://www.peacprotocol.org/problems/payment-required',
      title: 'Payment Required',
      rails: ['x402', 'card', 'payment-gateway']
    })
  }

  const result = await verify(receipt, {
    issuerAllowlist: ['https://api.example.com']
  })

  if (!result.ok) {
    return res.status(401).json({ error: result.error.code })
  }

  // Receipt is valid - rail-agnostic verification
  console.log('Rail:', result.claims.payment.rail)        // 'x402' | 'card' | ...
  console.log('Amount:', result.claims.amt, result.claims.cur)
  console.log('Facilitator:', result.claims.payment.facilitator) // 'daydreams' | 'fluora' | ...

  next()
})

Get Started

Install a payment rail adapter and start issuing verifiable receipts.

# Install core + your preferred rail
pnpm add @peac/protocol @peac/rails-x402

# Or for payment gateways
pnpm add @peac/protocol @peac/rails-stripe
Quickstart GuideView ExamplesGitHub