PEAC

Interactive Demos

Experience PEAC Protocol in action with live examples and interactive demonstrations

v0.10.0•Purpose on wire + UCP mapping

Run an Agreement Demo

This demo shows how an agent discovers a policy, negotiates terms, and receives a payment receipt using PEAC Protocol.

1. Discover Policy

curl -H "User-Agent: demo-agent/1.0" \
     https://example.com/.well-known/peac.txt
Response:
# PEAC Policy v0.10.0
version: 0.10.0
usage: conditional
attribution: required
purposes: [train, search, inference, index]
free_quota: 1000/day
paid_tiers:
  - tier: basic
    price_usd: 0.01/request
    quota: 10000/day

2. Request Access with Purpose Declaration

# 1) Discover policy
curl -I https://example.com/.well-known/peac.txt

# 2) Request with purpose declaration (v0.9.24+)
curl -X POST https://example.com/api/content \
  -H "User-Agent: demo-agent/1.0" \
  -H "PEAC-Purpose: index"
  # Purpose header is first-class in v0.9.24+
402 Payment Required Response:
HTTP/1.1 402 Payment Required
Location: https://x402.example.com/pay/01HZY3Z3V7C7

{
  "type": "https://www.peacprotocol.org/problems/payment-required",
  "title": "Payment Required",
  "status": 402,
  "detail": "Basic tier requires $0.01 payment (x402 stable)",
  "payment_url": "https://x402.example.com/pay/01HZY3Z3V7C7",
  "adapters": ["x402"]
}

3. Access with Valid Receipt

# 3) Request with receipt (after payment via adapter)
curl -X POST https://example.com/api/content \
  -H "PEAC-Purpose: index" \
  -H "PEAC-Receipt: <detached-jws-receipt>"
  # Receipt includes purpose_declared and purpose_enforced claims
Success Response:
HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": "Your requested content here...",
  "attribution": "Content provided under PEAC Protocol terms",
  "quota_remaining": "9999/10000",
  "quota_reset": "2026-01-01T00:00:00Z"
}
Full Integration GuideView Examples

Try PEAC Simulator

Interactive playground to test PEAC policies and see generated receipts in real-time

Your Policy

# Your /.well-known/peac.txt
version: 0.10.0
usage: conditional
attribution: required
purposes: [train, search, inference, index]
free_quota: 100/hour
paid_tiers:
  - tier: premium
    price_usd: 0.05/request
    quota: unlimited

Generated Receipt

✅ Policy validated
✅ Receipt verified
✅ Payment processed
✅ Receipt signed
Receipt ID: rcpt_sim_789012345

This is a simulation. Real integration requires implementing PEAC adapters.

Integration Examples

Additional Resources

Tools and resources for deeper PEAC Protocol exploration

Development Tools

PEAC CLInpm
Protocol Librarynpm
VS Code ExtensionMarketplace

Learning Resources

DocumentationRead
SpecificationRead
ExamplesView

Ready to integrate PEAC?

Start with our quickstart guide or join the working group to discuss your use case

Get StartedContact Us