Documentation for agents: an index at /llms.txt, every docs page in one file at /llms-full.txt, and Markdown for any docs page by adding .md to its URL.

Skip to Content
ensforge

PRIMARY_NAME_MISMATCH

What PRIMARY_NAME_MISMATCH means, why NotFoundError throws it, what to show users and how to fix it in ensforge. Also covers retry safety.

NotFoundErrorNot retryable
@ensforge/sdk

What happened

The primary name does not resolve back to this address.

What to show users

TitleMessageAction
Primary name not verifiedThe primary name of this address does not point back to it.

How to fix

Set the name's address record to this address, or set another primary name.

Retry safety

Retrying the same call fails the same way until the cause is fixed (retryable: false).

Actions that throw it

ActionWhen
primaryName.getwith strict when there is no valid primary name.
primaryName.setwhen the name does not resolve to the address.
primaryName.signClaimwhen the name does not resolve to the address on a chain.

Catch it

Errors.hasCode("PRIMARY_NAME_MISMATCH") narrows to this error. See Handle errors.

Was this page helpful?