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

UNKNOWN_CHAIN

What UNKNOWN_CHAIN means, why ConfigError throws it, what to show users and how to fix it in ensforge. Also covers retry safety and the actions that throw it.

ConfigErrorNot retryable
@ensforge/sdk

What happened

ensforge has no ENS deployment for this chain.

What to show users

TitleMessageAction
Network not supportedENS is not available on this network.Switch to Ethereum mainnet or Sepolia.

How to fix

Pass deployment to Ensforge.create, e.g. Deployments.define({ name, chainId, v2 }).

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.

Any action can fail with ConfigError: it is part of Errors.CommonError.

Catch it

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

Was this page helpful?