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

CHAIN_NOT_CONFIGURED

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

ConfigErrorNot retryable
@ensforge/sdk

What happened

The client has no clients for chain ?.

What to show users

TitleMessageAction
Network not set upThis app is not set up for that network.

How to fix

Add chain <chainId> to chains in Ensforge.create, e.g. chains: { <chainId>: { publicClient, walletClient } }.

Retry safety

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

Actions that throw it

ActionWhen
primaryName.setfor an L2 that is not in the client's chains.

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

Catch it

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

Was this page helpful?