RPC error -32602: invalid conditional options: <field>: <reason>

Last updated: September 16, 2026

At a glance

Cause

The proxy validates the shape of the conditional options before forwarding anything. Only blockNumberMin, blockNumberMax, timestampMin, timestampMax and knownAccounts are accepted; an unknown field or a malformed value is rejected locally with this message. Triport validates the option names and shapes only — it never evaluates the conditions themselves.

Solution

1. Read the <field> and <reason> in the message: it names the exact option that failed validation.
2. Keep only the five supported options and use hex quantities for the block-number and timestamp bounds.
3. Remember that a JSON-RPC batch containing this method is dispatched per item, so one bad element does not invalidate the others.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid conditional options: blockNumberMax: expected hex quantity"
  }
}