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

INVALID_NAME

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

InvalidInputErrorNot retryable
@ensforge/sdk

What happened

undefined is not a valid ENS name.

What to show users

TitleMessageAction
Invalid nameThis is not a valid ENS name.Check the spelling and remove unsupported characters.

How to fix

Names must normalize under ENSIP-15, e.g. nick.eth.

Retry safety

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

Actions that throw it

ActionWhen
approval.getDelegatefor invalid input.
approval.getTokenwhen the name cannot be normalized.
approval.setDelegatefor invalid input.
approval.setTokenfor invalid input.
dns.claimfor invalid input.
dns.getOffchainResolverfor names that are not DNS names.
dns.getProoffor names that are not DNS names.
dns.getRecordsfor invalid names.
dns.getStatusfor names that are not DNS names.
dns.setRecordsfor invalid input, such as records that are not DNS wire format.
event.getfor invalid input.
event.watchfor invalid names.
indexer.getEventsfor invalid input.
indexer.getHistoryfor invalid input.
indexer.getNamewhen the name does not normalize.
indexer.getNamesByExpirywhen parent does not normalize.
indexer.getNamesForAddressfor invalid input.
indexer.getPermissionsfor invalid input.
indexer.getRecordsfor invalid input.
indexer.getSubnameswhen the name does not normalize.
migration.getfor invalid input.
migration.migratefor invalid input.
name.getwhen the name is invalid or the root.
name.reclaimfor invalid input.
name.setManagerfor invalid input.
name.setTtlfor invalid input.
name.transferfor invalid input.
permission.checkfor invalid input.
permission.getfor invalid input.
permission.setRecordAccessfor invalid input or an unconfirmed widening.
primaryName.getfor invalid input, or with strict an unnormalized name.
primaryName.setfor invalid input.
primaryName.signClaimfor invalid input.
record.getfor invalid input.
record.getAddressfor invalid input.
record.getAvatarwhen the name cannot be normalized.
record.getContentHashwhen the name cannot be normalized.
record.getTextwhen the name cannot be normalized.
record.setfor invalid input.
registration.commitfor invalid input.
registration.getPricefor invalid input.
registration.getRenewalPricefor invalid input.
registration.isAvailablefor names that are not .eth second-level names.
registration.registerfor invalid input.
registration.renewfor invalid input.
registry.attachfor invalid input.
registry.deployfor invalid input.
registry.getfor invalid input.
registry.setUrifor invalid input.
registry.upgradefor invalid input or an up-to-date registry.
resolver.createfor invalid input, or a salt whose resolver already exists.
resolver.getwhen the name cannot be normalized.
resolver.getLinkwhen the name cannot be normalized.
resolver.linkfor invalid input or a target without records.
resolver.resolvefor an invalid name or calldata.
resolver.setfor invalid input.
resolver.upgradefor invalid input or an up-to-date resolver.
role.getfor invalid input or targets.
role.grantfor invalid input or targets.
role.revokefor invalid input or targets.
subname.createfor invalid input.
subname.removefor invalid input.
subname.updatefor invalid input.
wrapper.getFusesfor invalid names.
wrapper.setChildFusesfor invalid input or fuses.
wrapper.setFusesfor invalid input or fuses.
wrapper.unwrapfor invalid input.
wrapper.wrapfor invalid input or fuses.

Catch it

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

Was this page helpful?