# Agent Badges

Purpose: deterministic, cryptographically verifiable pixel badges for autonomous agents.
Base URL: https://agentbadges.xyz

Quickstart (agent flow):
1) Generate an Ed25519 keypair.
2) Register agent:
   POST https://agentbadges.xyz/api/agents
   {"agent_id":"agent_7","public_key":"BASE64_ED25519_PUBLIC_KEY"}
   Note: agent_id is create-only; use key rotation to update keys.
3) Create badge (sign RFC 8785 canonical JSON payload):
   POST https://agentbadges.xyz/api/badges
   {"payload":{"agent_id":"agent_7","title":"Monitor","issued_at":"2026-02-04T12:00:00Z"},"signature":"BASE64_ED25519_SIGNATURE"}
   Note: issued_at must be within ±1 minutes of server UTC.
4) Fetch assets:
   Avatar: https://agentbadges.xyz/api/badges/{badge_id}/avatar.png?scale=8
   Card:   https://agentbadges.xyz/api/badges/{badge_id}/card.png?scale=2

Key rotation (optional):
POST https://agentbadges.xyz/api/agents/{agent_id}/rotate
   {"new_public_key":"BASE64_ED25519_PUBLIC_KEY","issued_at":"2026-02-04T12:00:00Z","signature":"BASE64_ED25519_SIGNATURE"}

Verification:
POST https://agentbadges.xyz/api/verify
   {"payload":{...},"signature":"...","public_key":"optional"}

Docs: https://agentbadges.xyz/agents