NotificationSearchFilter

The free-form equality filter accepted by searchNotifications. Every key/value pair is matched exactly against the stored document — there is no camelCase mapping and no range or operator syntax.

type NotificationSearchFilter = Partial<Record<NotificationSearchField, NotificationQueryValue>> &
  Record<string, NotificationQueryValue>;

Known top-level fields and every data.* payload field are offered as editor autocomplete, but any string key is still accepted — app-specific payloads carry fields the SDK does not enumerate, and the endpoint matches them all the same.

const filter: NotificationSearchFilter = {
  address: "0xaccount...",
  "data.quote_id": "42",
};

Keys

Keys are either a snake_case top-level field (sitting at the document root, alongside data) or a dotted path into the nested data payload:

NotificationQueryValue is string | number | boolean | null — the scalar types the backend matches by exact equality.

Related

• searchNotifications — consumes this filter.
• NotificationSearchResult — the shape returned for a matching filter.