Skip to main content

FREE_FLOW_BARRED

This sender is temporarily barred from the free flow.

HTTP status403
GroupRelay path
RetryableNo — sending it again changes nothing
Re-signNONE — do not ask the user to sign anything

What happened​

Repeated failing free transactions trip the strike rule.

What to do​

Wait until details.untilMs, or pay the gas yourself for this transaction.

Extra members​

This code carries untilMs 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/free-flow-barred",
"title": "This sender is temporarily barred from the free flow.",
"status": 403,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "FREE_FLOW_BARRED",
"retryable": false,
"resign": "NONE",
"hint": "Wait until `details.untilMs`, or pay the gas yourself for this transaction."
}

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