Primary Names - Namoshi Documentation

Reverse resolution allows applications to display human-readable Namoshi names instead of hexadecimal addresses.

Primary Names

A “Primary Name” (or reverse record) is the name that an address identifies as its main identity.

Retrieving Primary Names

Using Wagmi

The useEnsName hook is the simplest way to find the primary name for an address.

import { useEnsName } from 'wagmi'

export const DisplayName = ({ address }) => {
  const { data: name } = useEnsName({
    address,
    chainId: 4114,
  })

  return <div>{name || address}</div>
}

Using Viem

const name = await client.getEnsName({
  address: '0x123...abc',
})

Why call it “Primary Name”?

While an address can own many names, it can only have one primary name at a time. This ensures that when someone sees your address in a leaderboard or wallet, they always see the same consistent identity.