GAS_OVERPROVISIONED

The gas limit is far above what simulation says the transaction needs.

HTTP status	422
Group	Relay path
Retryable	No — sending it again changes nothing
Re-sign	NONE — do not ask the user to sign anything

What happened

Relay Units are charged on the worst case, so a wildly over-declared limit would reserve quota (and relayer exposure) that cannot be used.

What to do

Set gasLimit close to the simulated cost — the endpoint accepts up to 1.9× the simulated processing gas above movement gas.

Extra members

This code carries limit, actual 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-overprovisioned",
  "title": "The gas limit is far above what simulation says the transaction needs.",
  "status": 422,
  "detail": "A sentence about this specific occurrence.",
  "instance": "req_01JB…",
  "code": "GAS_OVERPROVISIONED",
  "retryable": false,
  "resign": "NONE",
  "hint": "Set `gasLimit` close to the simulated cost — the endpoint accepts up to 1.9× the simulated processing gas above movement gas."
}

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