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.

AgentName

Fetches and renders the agent's registered name from the identity registry. Falls back to a truncated agent ID if no name is registered.

Preview

import { AgentName } from "@erc8004/ui"
<AgentName agentRegistry="eip155:8453:0x8004...a432" agentId={2290} />

Usage

import { AgentName } from "@erc8004/ui"
<AgentName agentRegistry="eip155:8453:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432" agentId={2290} />

Examples

Inside AgentProvider

Use AgentProvider to avoid repeating props when rendering multiple components for the same agent.

<AgentProvider agentRegistry="eip155:8453:0x8004...a432" agentId={2290}>
  <AgentName />
</AgentProvider>

With Custom Styling

Pass className to override typography. Useful for heading-level displays.

<AgentName
  agentRegistry="eip155:8453:0x8004...a432"
  agentId={2290}
  className="text-2xl font-semibold tracking-tight"
/>

In Context

AgentName used in a profile header alongside the agent's image, description, and verification status.

<AgentProvider agentRegistry="eip155:8453:0x8004...a432" agentId={2290}>
  <div className="flex items-center gap-4 p-4 bg-neutral-900 border border-white/20 rounded-lg">
    <AgentImage className="min-h-24 min-w-24" />
    <div className="flex flex-col gap-2">
      <div className="flex items-center gap-4">
        <AgentName />
        <VerificationBadge />
      </div>
      <AgentDescription />
    </div>
  </div>
</AgentProvider>

API Reference

PropTypeRequiredDefaultDescription
agentRegistrystringNoAgent registry in the format "eip155:{chainId}:{contractAddress}". Required unless inside an <AgentProvider>.
agentIdnumberNoERC-721 token ID of the agent. Required unless inside an <AgentProvider>.
classNamestringNoOptional CSS classes merged onto the component root for layout, spacing, or custom styling (e.g. Tailwind).

States

This component handles loading and error states internally with inline placeholders. No configuration needed.