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

NAME_REQUIRES_MIGRATION

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

NameStateErrorNot retryable
@ensforge/sdk

What happened

The name must be migrated to ENSv2 first.

What to show users

TitleMessageAction
Upgrade requiredThis name needs to be upgraded to the new ENS first.Upgrade the name.

How to fix

Use migration.migrate.

Retry safety

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

Actions that throw it

No action names this code in its documented errors.

Catch it

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

Was this page helpful?