Description

This documentation provides official best practices and recommended data profiles for ERC-8004, maintained and fully supported by the 8004scan team. These specifications cover offchain JSON formats and implementation patterns based on real-world production usage.

NOTE

This is not the official EIP-8004 specification. These are supplementary best practices maintained by 8004scan to help implementers adopt consistent, interoperable patterns. See Official Specification for normative requirements.

Core Data Profiles

Profile	Description
Conventions	RFC 2119 keywords, field types, URI schemes
Agent Metadata	AgentURI format - identity, services, trust
Feedback Data	Reputation records - values, evidence, payment
Validation Data	Proofs and attestations - zkML, TEE, staking
Attachment Pattern	Reusable evidence schema for files
Value Decimals Patterns	Standard patterns for v2.0 value system

Quick Start

Registering an Agent

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "My Agent",
  "description": "What my agent does",
  "image": "https://example.com/logo.png"
}

See Agent Metadata Profile for full schema.

Submitting Feedback

{
  "agentRegistry": "eip155:84532:0x...",
  "agentId": 42,
  "value": "4.75",
  "valueDecimals": 2,
  "reasoning": "Excellent service"
}

See Feedback Data Profile for full schema.

Requesting Validation

{
  "agentRegistry": "eip155:84532:0x...",
  "agentId": 56,
  "validationType": "zkml-proof",
  "reasoning": "Verify model execution"
}

See Validation Data Profile for full schema.

Implementation Guides

• Agent Metadata Parsing - Parser architecture and validation
• Feedback Best Practices - Evidence collection and privacy
• Validation Best Practices - Proof integration patterns
• Migration Guide: v1.x → v2.0 - Upgrade path to the latest spec
• Migration Guide: pre-v1 → v1.x - Upgrade path from legacy to v1.x

Extensions

• Value Decimals Patterns - Best practices for v2.0 flexible metrics
• Data URI Compression - 60-70% gas savings for onchain metadata

Reference

• Glossary - Terms and abbreviations
• Sources - Data sources and methodology
• Official EIP-8004 - Normative specification

Relationship to EIP-8004

Aspect	EIP-8004 (Official)	8004scan Best Practices
Defines	Smart contract interfaces	Offchain data patterns
Scope	Onchain behavior	Best practices (recommended)
Authority	Ethereum EIP process	8004scan-maintained specs
Adoption	MUST for compliance	SHOULD for interoperability
Support	EIP governance	Full 8004scan support & updates

Contributing

• GitHub Issues
• See CONTRIBUTING.md for guidelines