PEACProtocol

Interactive Demos

Experience PEAC Protocol in action with live examples and interactive demonstrations

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.9.14
version: 0.9.14
usage: conditional
attribution: required
purposes: [research, analysis]
free_quota: 1000/day
paid_tiers:
  - tier: basic
    price_usd: 0.01/request
    quota: 10000/day

2. Request Access with Payment

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

# 2) Request with minimal headers (negotiation handled by adapter)
curl -X POST https://example.com/api/content \
  -H "User-Agent: demo-agent/1.0"
  # Note: peac-version header removed in v0.9.14
402 Payment Required Response:
HTTP/1.1 402 Payment Required
Location: https://x402.example.com/pay/01HZY3Z3V7C7

{
  "type": "https://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 negotiation/settlement via adapter)
curl -X POST https://example.com/api/content \
  -H "PEAC-Receipt: <detached-jws-receipt>"
  # Single PEAC-Receipt header is normative in v0.9.14
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": "2024-11-30T00: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.9.14
usage: conditional
attribution: required
purposes: [research, testing]
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
Core Librarynpm
VS Code ExtensionMarketplace

Learning Resources

DocumentationRead
SpecificationGitHub
Working GroupJoin

Ready to integrate PEAC?

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

Get StartedContact Us