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

OFFCHAIN_LOOKUP_INVALID

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

GatewayErrorNot retryable
@ensforge/sdk

What happened

The resolver requested an off-chain lookup from an unexpected sender.

What to show users

TitleMessageAction
Lookup failedThis name's resolver made an invalid off-chain request.

Retry safety

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

Actions that throw it

ActionWhen
primaryName.getwhen an off-chain gateway fails.
record.getwhen an off-chain gateway fails.
record.getAddresswhen an off-chain gateway fails.
record.getContentHashwhen an off-chain gateway fails.
record.getTextwhen an off-chain gateway fails.
resolver.resolvewhen an off-chain gateway fails.

Catch it

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

Was this page helpful?