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_UNREACHABLE

What NAME_UNREACHABLE 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

ENSv2 resolution no longer reaches this ENSv1 name.

What to show users

TitleMessageAction
Name unreachableThis name no longer resolves: ENSv2 resolution does not reach its ENSv1 records.

How to fix

ENSv2 resolves it elsewhere: an ancestor moved to ENSv2 without it, or ENSv2 holds no reservation for it. Ask the parent's owner to recreate it there.

Retry safety

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

Actions that throw it

ActionWhen
approval.setTokenwhen ENSv2 resolution no longer reaches the name.
dns.setRecordswhen ENSv2 resolution no longer reaches the name.
name.reclaimwhen ENSv2 resolution no longer reaches the name.
name.setManagerwhen ENSv2 resolution no longer reaches the name.
name.setTtlwhen ENSv2 resolution no longer reaches the name.
name.transferwhen ENSv2 resolution no longer reaches the name.
record.setwhen ENSv2 resolution no longer reaches the name.
registry.attachwhen ENSv2 resolution no longer reaches the name.
resolver.createwhen ENSv2 resolution no longer reaches the name.
resolver.linkwhen ENSv2 resolution no longer reaches the name.
resolver.setwhen ENSv2 resolution no longer reaches the name.
subname.createwhen the parent is reserved or ENSv2 resolution no longer reaches it.
subname.removewhen the parent is reserved or ENSv2 resolution no longer reaches it.
subname.updatewhen the parent is reserved or ENSv2 resolution no longer reaches it.
wrapper.setChildFuseswhen ENSv2 resolution no longer reaches the name.
wrapper.setFuseswhen ENSv2 resolution no longer reaches the name.
wrapper.unwrapwhen ENSv2 resolution no longer reaches the name.
wrapper.wrapwhen ENSv2 resolution no longer reaches the name.

Catch it

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

Was this page helpful?