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

GATEWAY_REQUEST_FAILED

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

GatewayErrorRetryable
@ensforge/sdk

What happened

The off-chain gateway request failed.

What to show users

TitleMessageAction
Lookup failedThe service that stores this name's data did not respond.Try again.

Retry safety

Retrying the same call can succeed (retryable: true).

Actions that throw it

ActionWhen
dns.claimwhen the proof cannot be fetched.
dns.getOffchainResolverwhen the DNSSEC gateway fails.
dns.getProofwhen the DNSSEC gateway fails.
dns.getStatuswhen the DNSSEC gateway fails.
primaryName.getwhen an off-chain gateway fails.
record.getwhen an off-chain gateway fails.
record.getAddresswhen an off-chain gateway fails.
record.getAvatarwith strict when NFT metadata cannot be loaded.
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("GATEWAY_REQUEST_FAILED") narrows to this error. See Handle errors.

Was this page helpful?