ERC-8004: Data Profiles and Best Practices
Official best practices from 8004scan for ERC-8004 offchain data formats and implementation patterns. These specifications are fully maintained and supported by the 8004scan team.
Documentation
Live Site: https://best-practices.8004scan.io/
Current Version
v2.0 (January 2026) - Latest specification with flexible feedback value system (replaces fixed 0-100 score).
What's New in v2.0
- Feedback value system:
score(uint8, 0-100) replaced byvalue(int256) +valueDecimals(uint8, 0-18) - Negative feedback: Support for negative values (disputes, fraud reports)
- Decimal precision: Up to 18 decimal places for granular ratings
- Flexible scales: 5-star, 10-point, percentage, or custom rating systems
Upgrading? See the migration guides:
Core Standards (v2.0)
- Conventions - Naming conventions and field types
- Agent Metadata - AgentURI format specification
- Feedback Data - Reputation and feedback records (v2.0 updates)
- Validation Data - Proofs and attestations
- Attachment Pattern - Evidence file schema
Additional Resources
- Glossary - Terms and definitions
- Data URI Compression - Gas optimization extension
- Implementation Guide - Practical guidance
- Version History - View all documentation versions
Previous Versions
- v1.x (January 2026) - v1.x documentation
- pre-v1 (legacy) (December 2025) - Archived documentation
Getting Started
See QUICKSTART.md for local development setup.
Contributing
See CONTRIBUTING.md for guidelines.