About @p4n/erc8004-ui
@p4n/erc8004-ui is an open-source React component library for displaying ERC-8004 AI agent identity, reputation and validation data. It is a presentation layer over on-chain data: you pass an agent's on-chain identifier, and the components fetch and render verified data themselves.
What this project is
ERC-8004 is an Ethereum standard for AI agent identity. It defines three registries — Identity, Reputation and Validation — that record who an agent is, what feedback it has received, and what independent validators have said about it. The data is public and on-chain, but getting it onto a screen means writing subgraph queries, parsing chain-prefixed identifiers, resolving three different URI formats and filtering revoked feedback. Every team building on the standard writes that same plumbing.
This library is that plumbing, packaged. Each component takes an agentRegistry string and an agentId, queries the relevant subgraph itself, and renders the result along with its loading, error, empty and not-found states. There is no global agent store to wire up and no data to pass in.
What it deliberately does not do
Components never accept display data as props. The only inputs a developer supplies are identifiers; everything rendered is fetched from the chain's indexed data at runtime. That constraint is the point — a reputation badge whose number can be passed in as a prop is a marketing asset, not a trust signal.
The library is read-only. It holds no keys, signs no transactions, and writes nothing on-chain. It never asks a visitor to connect a wallet.
Where the data comes from
All data is read from The Graph's ERC-8004 subgraphs, one per supported chain, queried directly over GraphQL with a read-only Graph API key that the consuming application supplies. The library is not affiliated with The Graph, with the ERC-8004 authors, or with any agent it displays. Indexed data can lag the chain, and an agent's self-reported registration file (its name, description and image) is exactly that — self-reported. The registries record what was published, not whether it is true.
- Supported mainnets: Ethereum, Base, Polygon, BNB Smart Chain, Monad
- Supported testnets: Base Sepolia, BNB Chapel, Monad Testnet
- The Validation Registry is not yet deployed on any of these chains, so validation components render their empty state until it is
Status and maintenance
The library is published to npm as @p4n/erc8004-ui and maintained in the open by its author, p4nthera115. There is no company behind it, no paid tier, and no telemetry inside the components themselves.
Development happens entirely in public. Issues, pull requests and design discussion are on GitHub, and the documentation site is generated from the same registries that generate the machine-readable docs, so the two cannot drift apart.
- Source repository — Code, issues, and release history
- ERC-8004 specification — The Ethereum standard this library implements