Docs Navigationexpand_more

Public Relayer

Public Relayer: Error Handling

Handle JSON-RPC and relayer-level execution errors safely.

Purpose

Map JSON-RPC errors and execution outcomes to retry, abort, or user-action flows.

Common error handling

  • 4200 Insufficient Payment: increase fee scope/value and re-sign.
  • 4202 Unsupported Payment Token: choose token from relayer_getCapabilities.
  • 4204 Quote Expired: refresh relayer_getFeeData and resubmit with fresh context.
  • 4210 Invalid Authorization List: provide at most one authorization entry and verify nonce.
  • 4211 Simulation Failed: inspect returned data/revert details and adjust call payload or scope.