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.

ValidationScore

Average validation score (0-100) with a fill bar and completed/pending counts.

Note

This component reads from the AgentStats entity, which isn't present on every chain's subgraph. On chains where it's missing, the component renders its empty state rather than an error. See Concepts › Supported Chains.

Warning

The Validation Registry contracts aren't deployed on mainnet yet. On mainnet chains this component always renders its empty state. See Concepts › Validation Registry.

Preview

Usage

import { ValidationScore } from "@erc8004/ui"

<ValidationScore agentRegistry="eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432" agentId={2290} />

Examples

Without Fill Bar

Hide the score fill bar for a text-only display.

<ValidationScore agentRegistry="eip155:8453:0x8004...a432" agentId={2290} showFillBar={false} />

Without Pending Count

Hide the pending validation count.

<ValidationScore agentRegistry="eip155:8453:0x8004...a432" agentId={2290} showPendingCount={false} />

In Context

ValidationScore in a trust panel alongside the verification badge and recent validations.

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

API Reference

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).
`showFillBar`	`boolean`	No	true	Show the score fill bar.
`showPendingCount`	`boolean`	No	true	Show the pending validation count.

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.

←VerificationBadge ValidationList→