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
| Title | Message | Action |
|---|---|---|
| Name unreachable | This 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
| Action | When |
|---|---|
approval.setToken | when ENSv2 resolution no longer reaches the name. |
dns.setRecords | when ENSv2 resolution no longer reaches the name. |
name.reclaim | when ENSv2 resolution no longer reaches the name. |
name.setManager | when ENSv2 resolution no longer reaches the name. |
name.setTtl | when ENSv2 resolution no longer reaches the name. |
name.transfer | when ENSv2 resolution no longer reaches the name. |
record.set | when ENSv2 resolution no longer reaches the name. |
registry.attach | when ENSv2 resolution no longer reaches the name. |
resolver.create | when ENSv2 resolution no longer reaches the name. |
resolver.link | when ENSv2 resolution no longer reaches the name. |
resolver.set | when ENSv2 resolution no longer reaches the name. |
subname.create | when the parent is reserved or ENSv2 resolution no longer reaches it. |
subname.remove | when the parent is reserved or ENSv2 resolution no longer reaches it. |
subname.update | when the parent is reserved or ENSv2 resolution no longer reaches it. |
wrapper.setChildFuses | when ENSv2 resolution no longer reaches the name. |
wrapper.setFuses | when ENSv2 resolution no longer reaches the name. |
wrapper.unwrap | when ENSv2 resolution no longer reaches the name. |
wrapper.wrap | when ENSv2 resolution no longer reaches the name. |
Catch it
Errors.hasCode("NAME_UNREACHABLE") narrows to this error. See Handle errors.
Was this page helpful?