useEnsAvatar – wagmi

Docs

Hooks

useEnsAvatar

Hook for fetching the address for ENS name.

import { useEnsAvatar } from 'wagmi'

Usage

import { useEnsAvatar } from 'wagmi'

function App() {
  const { data, isError, isLoading } = useEnsAvatar({
    addressOrName: 'awkweb.eth',
  })

  if (isLoading) return <div>Fetching avatar…</div>
  if (isError) return <div>Error fetching avatar</div>
  return <div>Avatar: {data}</div>
}

Return Values

{
  data?: string
  error?: Error
  isError: boolean
  isFetched: boolean
  isFetching: boolean
  isIdle: boolean
  isLoading: boolean
  isRefetching: boolean
  isStale: boolean
  isSuccess: boolean
  refetch: (options: {
    throwOnError: boolean
    cancelRefetch: boolean
  }) => Promise<string>
  status: 'idle' | 'error' | 'loading' | 'success'
}

Configuration

addressOrName (optional)

Address or ENS name to fetch avatar for. If addressOrName is not defined, hook will not run.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'moxey.eth',
  })
}

cacheTime (optional)

Time (in ms) which the data should remain in the cache. Defaults to 0.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    cacheTime: 2_000,
  })
}

enabled (optional)

Set this to false to disable this query from automatically running. Defaults to true.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    enabled: false,
  })
}

staleTime (optional)

Time (in ms) after data is considered stale. If set to Infinity the data will never be considered stale. Defaults to 60 * 60 * 24 (24 hours).

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    staleTime: 2_000,
  })
}

suspense (optional)

Set this to true to enable suspense mode.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    suspense: true,
  })
}

onSuccess (optional)

Function to invoke when fetching new data is successful.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    onSuccess(data) {
      console.log('Success', data)
    },
  })
}

onError (optional)

Function to invoke when an error is thrown while fetching new data.

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    onError(error) {
      console.log('Error', error)
    },
  })
}

onSettled (optional)

Function to invoke when fetching is settled (either successfully fetched, or an error has thrown).

import { useEnsAvatar } from 'wagmi'

function App() {
  const ensAvatar = useEnsAvatar({
    addressOrName: 'awkweb.eth',
    onSettled(data, error) {
      console.log('Settled', { data, error })
    },
  })
}

useEnsAddress

useEnsName