Skip to main content

Errors and Troubleshooting

Common HTTP Categories​

  • 400: validation or request content errors
  • 401: auth/signature/session failures
  • 404: entity not found
  • 500: infrastructure or upstream failures

Frequent Integration Flow Errors​

  • 401 Signature is required
  • 401 Invalid signature
  • 401 Request timestamp is expired
  • 401 Timestamp already used
  • 400 Invalid nonce
  • 400 Signature deadline is expired
  • 401 Invalid setPayout signature
  • 500 RPC_UNAVAILABLE
  1. For 401: clear auth state and re-authenticate.
  2. For 400: show validation feedback from server response.
  3. For 404: present not-found or empty state UX.
  4. For 500: retry with backoff and show fallback error.

Debug Checklist​

  1. Confirm chain is supported.
  2. Validate timestamp freshness and uniqueness.
  3. Ensure signed payload exactly matches sent payload.
  4. Re-check nonce source before signing EIP-712 data.