Skip to main content

GAS_BUDGET_EXCEEDED

The gas-per-second budget of your rate class in this shard is spent.

HTTP status429
GroupRelay path
RetryableYes — the same request may be sent again
Re-signSAME_BYTES — resend the transaction you already have, byte for byte

What happened​

A burst of heavy transactions can exhaust the shard budget before the Relay-Unit budget.

What to do​

Honour Retry-After and resend, or spread heavy transactions out.

Extra members​

This code carries retryAfterMs in the problem document, on top of the common members.

The problem document​

Every error is application/problem+json (RFC 9457) with the same shape:

{
"type": "https://docs.co-relayer.com/errors/gas-budget-exceeded",
"title": "The gas-per-second budget of your rate class in this shard is spent.",
"status": 429,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "GAS_BUDGET_EXCEEDED",
"retryable": true,
"resign": "SAME_BYTES",
"hint": "Honour `Retry-After` and resend, or spread heavy transactions out."
}

See the error model for what each member means and how to handle unknown codes.