ERC-8004 pre-v1 Legacy Documentation

This is the archived documentation for the pre-v1 legacy release, maintained for historical reference.

Status

• Version: pre-v1 (legacy)
• Released: December 2025
• Status: Legacy / Archived
• Recommended: Use v1.1 documentation instead

Key Characteristics

Contract Changes (pre-v1 legacy → v1.1)

Field	pre-v1 (legacy)	v1.1
tag1	bytes32	string
tag2	bytes32	string
feedbackUri	✓	Renamed to feedbackURI
endpoint	✗	✓ NEW
feedbackAuth	✓ Required	Removed
feedbackIndex	Calculated	From event

Breaking Changes

1. Tag Types: bytes32 → string (direct string, no encoding)
2. URI Naming: feedbackUri → feedbackURI (case change)
3. FeedbackAuth Removed: No longer required for feedback submission
4. New Endpoint Field: Specifies the service endpoint used
5. Simplified Contract: Fewer parameters, cleaner signatures

Migration Path

If you're implementing against pre-v1 (legacy), see the pre-v1 to v1.x migration guide for detailed migration instructions.

Documentation Contents

• Conventions
• Agent Metadata Standard
• Feedback Data Standard
• Validation Data Standard
• Attachment Pattern Standard
• Glossary

Why Archive pre-v1 (legacy)?

The ERC-8004 specification underwent significant updates in January 2026:

• Simplified API: Removed complex feedbackAuth flow
• String Tags: More intuitive than bytes32 hashing
• Better Naming: Consistent URI naming convention
• Cleaner Contracts: Fewer parameters, easier to implement

Links

• Current v1.1 Docs: https://best-practices.8004scan.io/
• Contract PR #11: https://github.com/erc-8004/erc-8004-contracts/pull/11
• Spec Update: https://github.com/erc-8004/erc-8004-contracts/blob/main/SpecsJan26Update.md

---

Last Updated: January 9, 2026
Archive Created: January 9, 2026