useUsernameQuery

​

Overview

• React Query hook that fetches the Initia (.init) username for a provided address, or for the connected address when no argument is passed.
• Automatically re-runs when the target address changes.
• Exposes standard React Query state (isLoading, error, etc.).

​

Prerequisites

• Must be rendered within InterwovenKitProvider.
• Must be used within a React Query QueryClientProvider.
• Must be used within a wagmi WagmiProvider.
• Client-only (no SSR): Put this in a use client provider tree, or use a dynamic import in Next.js.

​

Quickstart

​

Connected Wallet

'use client'

import { useUsernameQuery } from '@initia/interwovenkit-react'

function Username() {
  const { data, isLoading } = useUsernameQuery()
  if (isLoading) return <span>Loading…</span>
  return <span>{data ?? 'No username'}</span>
}

​

Specific Address

'use client'

import { useUsernameQuery } from '@initia/interwovenkit-react'

function SenderUsername({ address }: { address: string }) {
  const { data } = useUsernameQuery(address)
  return <span>{data ?? address}</span>
}

​

Return Value

function useUsernameQuery(address?: string): UseQueryResult<string | null>

• string when a username exists (ends with .init)
• null when no username exists or the address is invalid
• undefined before the query has produced a value or when the query is disabled (for example, when neither an explicit address nor a connected wallet address is available)

​

Notes

• If address is omitted, the hook falls back to the connected address from useAddress().