ERC-8004 Documentation Versions

We maintain documentation for multiple ERC-8004 specification versions to support both current and legacy implementations.

Current Versions

v1.1 (Latest)

Released: January 2026
Status: ✅ Current / Recommended

The latest ERC-8004 specification with simplified feedback flow, string-based tags, and removed authorization requirements.

Key Features:

• ✅ Simplified tag system (strings instead of bytes32)
• ✅ Removed feedbackAuth requirement
• ✅ New endpoint field support
• ✅ Improved URI naming conventions
• ✅ Cleaner contract interfaces

Start Here: v1.1 Documentation

---

pre-v1 (Legacy Archive)

Released: December 2025
Status: ⚠️ Archived / Legacy

The previous ERC-8004 specification. Maintained for historical reference and backwards compatibility.

Key Characteristics:

• bytes32 encoded tags (requires UTF-8 encoding/decoding)
• Feedback authorization flow (feedbackAuth)
• feedbackUri naming (lowercase i)
• Calculated feedbackIndex in subgraph

Migrate From pre-v1 (legacy)?: Read the migration guide

View pre-v1 (legacy) Docs: Archive

---

What Changed?

Feature	pre-v1 (legacy)	v1.1
Tags	bytes32 (hex)	string (direct)
Feedback Auth	Required	Removed
URI Naming	feedbackUri	feedbackURI
Endpoint	N/A	✓ NEW
Complexity	Higher	Lower

Full details: Migration Guide: pre-v1 (legacy) → v1.1

---

Quick Navigation

New to ERC-8004?

→ Start with v1.1 Documentation

Using pre-v1 (legacy) and want to upgrade?

→ Read the Migration Guide

Need pre-v1 (legacy) docs?

→ Visit legacy archive

Questions about spec changes?

→ See the Update Guide

---

Version Timeline

December 2025
    │
    ▼
┌─────────┐
│ pre-v1  │  (Initial release)
│ Release │
└─────────┘
    │
    │
January 2026
    │
    ▼
┌─────────────────────────────┐
│ pre-v1 Frozen               │  (Legacy archive)
│    (No more updates)        │
│   v1.1 Released             │  (New standard)
└─────────────────────────────┘
    │
    │  (You are here)
    ▼
 Today

---

Support

• Documentation Questions: Check the specific version docs
• Migration Help: See Migration Guide
• Contract Issues: GitHub Issues
• General ERC-8004: EIP-8004

---

Last Updated: January 9, 2026