classifyQuoteNotificationAction

Classify a notification’s lastSeenAction into the quote flow it belongs to. Consumers use the result to scope cache invalidation to the reads a notification can actually affect — an open-anchor event never changes the pending-instant-close feed, and vice versa.

Open-side actions (anchoring an open, or the InstantRFQ price fill) classify as "open"; close-request/fill actions classify as "close"; anything else (including failures and unknown actions) is "other".

import { classifyQuoteNotificationAction } from "@symmio/trading-core";
 
if (classifyQuoteNotificationAction(n.lastSeenAction) === "close") invalidateCloses();

Parameters

Returns

isOpenAnchorAction

Boolean helper that narrows the same lastSeenAction to just the on-chain anchor actions (SendQuoteTransaction / SendQuote / FillLimitOrderOpen) — the second notification of a send flow, where the temp id gains a real on-chain quote id. Excludes the earlier off-chain InstantRFQ price fill (which classifyQuoteNotificationAction still calls "open"). Use it to refetch reads that only change once the quote exists on-chain — e.g. the pending / limit-order list.

import { isOpenAnchorAction, NotificationType } from "@symmio/trading-core";
 
if (n.type === NotificationType.SUCCESS && isOpenAnchorAction(n.lastSeenAction)) refetchPending();

isCancelAction

Boolean helper that matches the cancel actions — cancelling a resting order rather than closing a position. classifyQuoteNotificationAction deliberately reports every one of them as "other": a cancel frame must not mutate a row, because the chain is the only authority on whether the cancel landed.

Cancel is the one flow whose confirming transaction is sent by someone else. requestToCancelQuote on a LOCKED quote only moves it to CANCEL_PENDING and leaves it in partyAPendingQuotes; the solver’s later acceptCancelRequest is what sets CANCELED and removes it — and that transaction is not announced on the notifications stream. A consumer that reacts to frames alone therefore renders a cancelled order forever. Use this predicate to start re-reading the chain until the quote is gone.

import { isCancelAction } from "@symmio/trading-core";
 
if (isCancelAction(n.lastSeenAction)) startCancelConfirmChase(n.quoteId);

Matches RequestToCancelQuote — the only cancel action observed on a live stream — plus AcceptCancelRequest, ForceCancelQuote, and ExpireQuote, the contract’s remaining cancel paths. Whether a vendor publishes frames for those three is unconfirmed; matching them costs nothing when it does not.

Related

• QuoteNotificationActionKind — the union this returns.
• applyNotificationToQuotes — advances a row’s lifecycle from the same notifications.
• Notifications stream — the frames whose lastSeenAction is classified.
• React useLimitOrders — refetches its on-chain read on an isOpenAnchorAction or isCancelAction frame.