{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "address-avatar",
  "title": "Address Avatar",
  "description": "Round avatar for an address: the ENS avatar (useEnsName + useEnsAvatar on mainnet), or a deterministic gradient derived from the address as a fallback. Accepts a custom image src and a pixel size. Exports useAddressAvatar and addressGradient.",
  "dependencies": [
    "wagmi",
    "viem"
  ],
  "registryDependencies": [
    "avatar"
  ],
  "files": [
    {
      "path": "registry/default/components/address-avatar.tsx",
      "content": "// Docs: https://0xui.io/components/address-avatar.md\nimport type { Address } from \"viem\";\nimport { normalize } from \"viem/ens\";\nimport { useEnsAvatar, useEnsName } from \"wagmi\";\nimport { mainnet } from \"wagmi/chains\";\nimport { Avatar, AvatarFallback, AvatarImage } from \"@/components/ui/avatar\";\nimport { cn } from \"@/lib/utils\";\n\nexport type AddressAvatarProps = {\n  address: Address;\n  /** Look up the ENS avatar on mainnet. Requires mainnet in your wagmi config. */\n  ens?: boolean;\n  /** Image URL to use instead of the ENS avatar. */\n  src?: string;\n  /** Diameter in px. */\n  size?: number;\n  className?: string;\n};\n\n/**\n * Deterministic two-color gradient for an address, so the same address\n * always gets the same placeholder.\n */\nexport function addressGradient(address: string) {\n  const hex = address.toLowerCase().replace(/^0x/, \"\").padEnd(12, \"0\");\n  const from = parseInt(hex.slice(0, 6), 16) % 360;\n  const to = (from + 40 + (parseInt(hex.slice(6, 12), 16) % 120)) % 360;\n  return `linear-gradient(135deg, oklch(0.75 0.15 ${from}), oklch(0.55 0.2 ${to}))`;\n}\n\n/** Resolve the ENS avatar URL for an address. */\nexport function useAddressAvatar(address: Address, { enabled = true } = {}) {\n  const { data: name } = useEnsName({\n    address,\n    chainId: mainnet.id,\n    query: { enabled },\n  });\n  const { data: avatar } = useEnsAvatar({\n    name: name ? normalize(name) : undefined,\n    chainId: mainnet.id,\n    query: { enabled: enabled && Boolean(name) },\n  });\n  return { name: name ?? undefined, avatar: avatar ?? undefined };\n}\n\n/**\n * Round avatar for an address: the ENS avatar when one exists, otherwise a\n * gradient derived from the address.\n */\nexport function AddressAvatar({\n  address,\n  ens = true,\n  src,\n  size = 24,\n  className,\n}: AddressAvatarProps) {\n  const { avatar } = useAddressAvatar(address, { enabled: ens && !src });\n  const image = src ?? avatar;\n\n  return (\n    <Avatar\n      aria-hidden\n      className={cn(\"shrink-0\", className)}\n      style={{ width: size, height: size }}\n    >\n      {image && <AvatarImage src={image} alt=\"\" />}\n      <AvatarFallback style={{ background: addressGradient(address) }} />\n    </Avatar>\n  );\n}\n",
      "type": "registry:component"
    }
  ],
  "docs": "Docs: https://0xui.io/components/address-avatar.md",
  "categories": [
    "identity"
  ],
  "type": "registry:component"
}