=== EXECUTION PROTOCOL (EP) — AgentIAM ===

EP is the pre-execution validation layer for AI agents. Every agent action is validated
against policy sets before execution. Cryptographic proof hashes provide tamper-evident
audit trails.

Base URL: https://achillesalpha.onrender.com/ep
Auth: X-Agent-Key header

=== ENDPOINTS ===
POST /ep/validate — Single agent pre-execution validation
POST /ep/swarm/validate — Multi-agent swarm coordination with policy enforcement
GET /ep/status — Service health and contract addresses
GET /ep/proof/:hash — Public proof verification (no auth)
GET /ep/manifest.json — Agent-native service discovery
GET /ep/swarm/:swarm_id/history — Swarm audit trail

=== AgentIAM FOUR PILLARS ===
1. Identity — ERC-8004 on-chain agent registration
2. Access — Policy sets enforced before execution
3. Management — Tamper-evident cryptographic proof hashes
4. Reputation — Talent Protocol operator verification before swarm participation

=== TALENT PROTOCOL INTEGRATION ===

EP integrates Talent Protocol for operator reputation verification in swarm validations.

When require_talent_verification: true in a swarm policy set, EP calls Talent Protocol's
/human_checkmark endpoint for the agent operator wallet before approving swarm consensus.

Binary check — verified builder history = proceed, unverified = OPERATOR_NOT_VERIFIED violation.

Fail-open by design — if Talent API is down, times out, or errors, EP proceeds normally.
Never blocks execution due to third-party API failure.

This completes AgentIAM's Reputation pillar:
- Verified operators participate in swarms
- Unverified operators blocked before capital moves
- Verification result logged to session transcript with proof hash

Violation code: OPERATOR_NOT_VERIFIED (BLOCKING)
Talent Protocol API: https://api.talentprotocol.com
SKILL.md: https://github.com/talentprotocol/builder-data/blob/main/SKILL.md

=== CONTRACTS (Base Sepolia) ===
AttestRegistry: 0xC36E784E1dff616bDae4EAc7B310F0934FaF04a4
FeeCollector: 0xFF196F1e3a895404d073b8611252cF97388773A7
EPCommitment: 0xf1e16d3e5B74582fC326Bc6E2B82839d31f1ccE8

=== MPP + x402 PAYMENT ADAPTER ===

EP supports both MPP (Machine Payments Protocol by Stripe/Tempo) and x402 as agnostic payment protocols.

Architecture: Protocol Detector -> Normalize -> EP Validate -> Protocol Responder
x402 path: byte-for-byte identical, zero changes
MPP path: new, behind MPP_ENABLED flag

KEY INNOVATION: EP proof_hash is embedded INSIDE the MPP receipt.
Result: One receipt = payment verified (Stripe/MPP) + authorization verified (EP).

Endpoints:
- POST /ep/payment/verify — verify receipt matches proof_hash
- GET /ep/payment/status — check protocol support
- POST /ep/validate — now accepts optional payment_context field

Protocols: MPP (Tempo network), x402 (Base network)
Feature flag: MPP_ENABLED=true

=== AgentIAM FIVE PILLARS ===
1. Identity — ERC-8004 on-chain agent registration
2. Access — Policy sets enforced before execution
3. Management — Tamper-evident cryptographic proof hashes
4. Reputation — Talent Protocol operator verification
5. Payments — MPP + x402 agnostic adapter with EP proof in receipt

=== STANDARDS ===
ERC-8004: On-chain agent identity
ERC-7710: Scoped wallet delegation (fail-open)
Talent Protocol: Operator reputation verification (fail-open)
MPP: Machine Payments Protocol (Stripe/Tempo)
x402: HTTP 402 Payment Required (Base/USDC)