Records & resolution

Every ethername is also a resolver: it stores the data other apps look up when they encounter your name. All records are set by the name’s owner, live directly in the contract, and are wiped automatically if the name expires and is re-registered by someone else.

Address record

The most important record: which address the name points at.

• Set it from the Records tab of your name’s manage page.
• If you never set it, resolution falls back to the owner of the name, so a freshly registered name resolves to your wallet with zero setup.
• Multi-chain addresses are supported through standard coin types; the address record for Ethereum is coin type 60.

Text records

Free-form key/value pairs following the convention most wallets and apps already understand:

You can set any custom key you like; the table above is just what most apps read.

Avatars

An avatar and a card are two different things, and it is worth keeping them apart.

The card is your name’s NFT artwork: a branded registry certificate derived deterministically from the name, drawn onchain by the NameCard contract and byte-identically by this site. It is what a marketplace renders, it cannot be changed, and every name has one.

The avatar is your profile image, which apps show beside your name. A name that has not set one has no avatar, and this site draws a small placeholder mark for it rather than substituting the card, so nothing ever claims a name has an avatar it never chose.

To use your own avatar, pick an NFT you hold from a supported collection on the manage page. The record stores which token it is, not a copy of the image:

eip155:1/erc721:0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb/5822

That is the same form ENS uses, and storing the token rather than an image URL is what makes the claim checkable. A URL would let anyone point at a CryptoPunk they do not own, permanently and undetectably. A reference can be verified by reading who holds the token.

Two things follow, and both are deliberate:

• It only shows while you hold it. This site checks the token’s current holder against the name’s owner on every render, and never caches the answer. Sell the NFT and your name goes back to its card. So does a token you moved to another wallet: the check cannot tell that apart from a sale, and does not guess.
• Only supported collections count. A token reference proves you hold a token, not that the contract is the real CryptoPunks: anyone can deploy their own and honestly own token 5822 of it. So the collection has to be one this site recognises.

Supported today: CryptoPunks, Milady, Bored Ape Yacht Club, Pudgy Penguins. More will follow.

Note: the NFT image shown by marketplaces is always the certificate. The avatar record never changes it. What the avatar record changes is the image this site and compatible apps show beside your name.

Primary name (reverse resolution)

Records map names to data. The primary name maps your address back to a name: it is what compatible apps display instead of 0xd8dA…6045.

• Set any name you own as your primary from its manage page.
• The contract only honors it while the name is active and still resolves to your address, so a stale or sold name can never impersonate you.
• You can clear or change it at any time.

Website (contenthash)

The contenthash record points your name at decentralized content, typically an IPFS CID. Once set, your site is reachable through the gateway we run at https://yourname.ipfs.cc. See IPFS websites.