Skip to main content

SIMULATION_FAILED

Pre-flight simulation says the transaction would fail on chain.

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

What happened​

The node returned an error for the simulated execution; relaying it would burn quota and gas for nothing.

What to do​

Read details.returnMessage, fix the call, and sign a corrected transaction.

Extra members​

This code carries returnMessage 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/simulation-failed",
"title": "Pre-flight simulation says the transaction would fail on chain.",
"status": 422,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "SIMULATION_FAILED",
"retryable": false,
"resign": "NONE",
"hint": "Read `details.returnMessage`, fix the call, and sign a corrected transaction."
}

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