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_RESERVED

What NAME_RESERVED 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 is reserved.

What to show users

TitleMessageAction
Name reservedThis name is reserved.

Retry safety

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

Actions that throw it

ActionWhen
dns.setRecordswhen the name is not registered.
name.reclaimwhen the name is not registered.
name.setManagerwhen the name is not registered.
name.setTtlwhen the name is not registered.
name.transferwhen the name cannot be sent.
record.setwhen the name is not registered.
resolver.createwhen the name is not registered.
resolver.linkwhen the name is not registered.
resolver.setwhen the name is not registered.
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.

Catch it

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

Was this page helpful?