For the complete documentation index, see /llms.txt. A single-fetch full bundle is at /llms-full.txt. Every docs page is also available as Markdown by appending .md to its URL, or by requesting it with Accept: text/markdown.

ValidationList

Paginated list of individual validation entries with score, status, tag, validator address, and timestamp.

Warning

The Validation Registry contract is recorded at the zero address on every chain checked — testnets included — so this component renders its empty state everywhere. Verified 2026-09-04 across Ethereum, Base, Polygon, BNB Smart Chain, BNB Chapel and Base Sepolia. See Concepts › Validation Registry.

Preview

Usage

import { ValidationList } from "@p4n/erc8004-ui"

<ValidationList agentRegistry="eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432" agentId={888} />

Examples

Completed Only

Filter to show only completed validations.

<ValidationList agentRegistry="eip155:8453:0x8004...a432" agentId={888} statusFilter="completed" />

Smaller Page Size

Show 5 items per page for a compact view.

<ValidationList agentRegistry="eip155:8453:0x8004...a432" agentId={888} pageSize={5} />

In Context

ValidationList in a trust panel alongside the verification badge and validation score.

<AgentProvider agentRegistry="eip155:8453:0x8004...a432" agentId={888}>
  <div className="flex items-center gap-2">
    <AgentName />
    <VerificationBadge />
  </div>
  <ValidationScore />
  <ValidationList pageSize={3} />
</AgentProvider>

API Reference

agentRegistryoptional

type: string

Agent registry in the format "eip155:{chainId}:{contractAddress}". Required unless inside an <AgentProvider>.

agentIdoptional

type: number

ERC-721 token ID of the agent. Required unless inside an <AgentProvider>.

classNameoptional

type: string

Optional CSS classes merged onto the component root for layout, spacing, or custom styling (e.g. Tailwind).

pageSizeoptional

type: numberdefault: 10

Items per page.

showValidatorAddressoptional

type: booleandefault: true

Show the validator's wallet address.

showTimestampoptional

type: booleandefault: true

Show the validation timestamp.

statusFilteroptional

type: "all" | "completed" | "pending" | "expired"default: "all"

Filter validations by status.

emptyMessageoptional

type: stringdefault: "No validations yet."

Custom message when there are no validations.

headingLeveloptional

type: 1 | 2 | 3 | 4 | 5 | 6default: 3

Heading level for this component's title. The default is the level it was previously hardcoded to, so leaving it alone renders exactly as before. Set it to keep the component from breaking the surrounding page's heading order.

Prop	Type	Required	Default	Description
`agentRegistry`	`string`	No	—	Agent registry in the format "eip155:{chainId}:{contractAddress}". Required unless inside an <AgentProvider>.
`agentId`	`number`	No	—	ERC-721 token ID of the agent. Required unless inside an <AgentProvider>.
`className`	`string`	No	—	Optional CSS classes merged onto the component root for layout, spacing, or custom styling (e.g. Tailwind).
`pageSize`	`number`	No	10	Items per page.
`showValidatorAddress`	`boolean`	No	true	Show the validator's wallet address.
`showTimestamp`	`boolean`	No	true	Show the validation timestamp.
`statusFilter`	`"all" \| "completed" \| "pending" \| "expired"`	No	"all"	Filter validations by status.
`emptyMessage`	`string`	No	"No validations yet."	Custom message when there are no validations.
`headingLevel`	`1 \| 2 \| 3 \| 4 \| 5 \| 6`	No	3	Heading level for this component's title. The default is the level it was previously hardcoded to, so leaving it alone renders exactly as before. Set it to keep the component from breaking the surrounding page's heading order.

States

This component handles loading, error, empty, and not-found states internally. A skeleton placeholder is shown while fetching, an error message with details appears if the Subgraph is unreachable, and a short message is displayed when no data exists for this agent.

←ValidationScore ValidationDisplay→