GAS_BUDGET_EXCEEDED
The gas-per-second budget of your rate class in this shard is spent.
| HTTP status | 429 |
| Group | Relay path |
| Retryable | Yes — the same request may be sent again |
| Re-sign | SAME_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.