# Components

> **NOTE — unofficial library.** `@p4n/erc8004-ui` is an independent, community-built project. It is not affiliated with, maintained by, or endorsed by the authors of ERC-8004. It reads the standard's on-chain data through public subgraphs; it does not speak for the standard.

All components in the library, grouped by registry. Each component fetches its own data — pass two identifiers and it works.

Every data component handles loading, error, empty, and not-found states internally. You pass `agentRegistry` and `agentId` (or rely on an enclosing `AgentProvider`) and the component does the rest.

### Providers

- [ERC8004Provider](https://erc8004-ui.vercel.app/docs/components/erc8004-provider.md): Root context provider that holds infrastructure config — your Graph API key and optional subgraph URL overrides.
- [AgentProvider](https://erc8004-ui.vercel.app/docs/components/agent-provider.md): Optional convenience wrapper that sets a default agentRegistry and agentId for all child components.

### Identity

- [FingerprintBadge](https://erc8004-ui.vercel.app/docs/components/fingerprint-badge.md): Deterministic SVG identity generated from the agent's registry and id — an ordered-dithered wave-interference pattern that is the same on every page and every reload, and different for every agent.
- [AgentName](https://erc8004-ui.vercel.app/docs/components/agent-name.md): Fetches and renders the agent's registered name from the identity registry.
- [AgentImage](https://erc8004-ui.vercel.app/docs/components/agent-image.md): Renders the agent's registered image.
- [AgentDescription](https://erc8004-ui.vercel.app/docs/components/agent-description.md): Renders the agent's registered description text from the identity registry.
- [AgentCard](https://erc8004-ui.vercel.app/docs/components/agent-card.md): Composed identity card combining avatar, name, description, owner address, and active protocol badges in a single component.
- [EndpointStatus](https://erc8004-ui.vercel.app/docs/components/endpoint-status.md): Lists all registered service endpoints (MCP, A2A, OASF, web, email) with protocol labels and optional live health check indicators.

### Reputation

- [ReputationScore](https://erc8004-ui.vercel.app/docs/components/reputation-score.md): Compact inline badge showing the agent's average feedback score and total review count.
- [ReputationTimeline](https://erc8004-ui.vercel.app/docs/components/reputation-timeline.md): Sparkline chart showing how the agent's feedback scores have trended over time.
- [ReputationDistribution](https://erc8004-ui.vercel.app/docs/components/reputation-distribution.md): Score distribution histogram showing the spread of feedback values across configurable score ranges.
- [FeedbackList](https://erc8004-ui.vercel.app/docs/components/feedback-list.md): Paginated list of individual feedback entries with score, tag pills, reviewer address, timestamp, and optional written review text.
- [TagCloud](https://erc8004-ui.vercel.app/docs/components/tag-cloud.md): Weighted tag pills showing the agent's most frequent feedback tags.

### Validation

- [VerificationBadge](https://erc8004-ui.vercel.app/docs/components/verification-badge.md): Compact inline badge showing the agent's verification tier derived from completed validations and average validation score.
- [ValidationScore](https://erc8004-ui.vercel.app/docs/components/validation-score.md): Average validation score (0-100) with a fill bar and completed/pending counts.
- [ValidationList](https://erc8004-ui.vercel.app/docs/components/validation-list.md): Paginated list of individual validation entries with score, status, tag, validator address, and timestamp.
- [ValidationDisplay](https://erc8004-ui.vercel.app/docs/components/validation-display.md): Composed view combining VerificationBadge, ValidationScore, and ValidationList into a single unified validation panel.

### Activity

- [LastActivity](https://erc8004-ui.vercel.app/docs/components/last-activity.md): Cross-registry relative timestamp showing when the agent was last active (e.g.
- [ActivityLog](https://erc8004-ui.vercel.app/docs/components/activity-log.md): Chronological feed of all on-chain events across all registries — feedback and validations merged and sorted by time.


## Reference

- Live page: https://erc8004-ui.vercel.app/docs/components
- Markdown source: https://erc8004-ui.vercel.app/docs/components.md