Struct WsDispatchState 

pub struct WsDispatchState {
    pub order_identities: DashMap<ClientOrderId, OrderIdentity>,
    pub emitted_accepted: DashSet<ClientOrderId>,
    pub filled_orders: DashSet<ClientOrderId>,
    pub delta_snapshots: DashMap<ClientOrderId, DeltaSnapshot>,
    pub order_filled_qty: DashMap<ClientOrderId, Quantity>,
    pub emitted_trades: Mutex<IndexSet<TradeId>>,
    /* private fields */
}

Per-client dispatch state shared between order submission and the WebSocket consumer task.

Tracks which orders were submitted through this client (so we can route venue events to typed [OrderEventAny] emissions for tracked orders, and fall back to reports for external orders), and provides cross-stream dedup for OrderAccepted and OrderFilled emissions.

Fields

order_identities: DashMap<ClientOrderId, OrderIdentity>

Tracked orders keyed by full Nautilus [ClientOrderId].

emitted_accepted: DashSet<ClientOrderId>

Client order IDs for which an OrderAccepted event has been emitted.

filled_orders: DashSet<ClientOrderId>

Client order IDs that have reached the filled terminal state.

delta_snapshots: DashMap<ClientOrderId, DeltaSnapshot>

Last snapshot of qty / filled / price / trigger_price seen on a tracked OpenOrdersDelta.

The futures delta path uses this map to discriminate partial-fill notifications (the new delta carries filled greater than the previously seen value), modify acknowledgements (a non-fill field changed), and pure no-op deltas (nothing changed). It is updated only by the delta path so that the fill path’s own cumulative is not double-counted.

order_filled_qty: DashMap<ClientOrderId, Quantity>

Cumulative filled quantity per tracked client order id, populated by the fill side of dispatch.

Compared against OrderIdentity::quantity to decide when to clean up tracked state on a terminal fill.

emitted_trades: Mutex<IndexSet<TradeId>>

Trade IDs for which an OrderFilled event has been emitted.

Bounded FIFO dedup: when capacity is reached, the oldest entry is evicted on the next insert. A simple clear() at the threshold would drop all recent trade IDs at once, opening a window where a reconnect or replay immediately after the rollover could re-emit duplicate OrderFilled events.

Implementations

impl WsDispatchState

pub fn new() -> Self

Creates a new empty dispatch state.

pub fn register_identity( &self, client_order_id: ClientOrderId, identity: OrderIdentity, )

Registers an order identity. Called by the execution client at order submission time, before any WebSocket events for the order can arrive.

pub fn lookup_identity( &self, client_order_id: &ClientOrderId, ) -> Option<OrderIdentity>

Returns a clone of the identity for the given client order id, if any.

pub fn insert_accepted(&self, cid: ClientOrderId)

Marks an OrderAccepted event as emitted for this order.

pub fn insert_filled(&self, cid: ClientOrderId)

Marks an order as having reached the filled terminal state.

pub fn check_and_insert_trade(&self, trade_id: TradeId) -> bool

Atomically inserts a trade id into the dedup set.

Returns true when the trade was already present (i.e. it is a duplicate), false otherwise. When the dedup set is at capacity the oldest entry is evicted to make room, preserving the DEDUP_CAPACITY most recently seen trade IDs.

pub fn cleanup_terminal(&self, client_order_id: &ClientOrderId)

Removes all dispatch state for an order that has reached a terminal state.

pub fn record_filled_qty(&self, client_order_id: ClientOrderId, qty: Quantity)

Records cumulative filled quantity for a tracked order. Used by the fill side of dispatch only.

pub fn previous_filled_qty( &self, client_order_id: &ClientOrderId, ) -> Option<Quantity>

Returns the previously recorded cumulative filled quantity, if any.

pub fn record_delta_snapshot( &self, client_order_id: ClientOrderId, snapshot: DeltaSnapshot, )

Records the latest delta snapshot for a tracked order. Used by the delta side of dispatch only.

pub fn previous_delta_snapshot( &self, client_order_id: &ClientOrderId, ) -> Option<DeltaSnapshot>

Returns the previously recorded delta snapshot, if any.

pub fn update_identity_quantity( &self, client_order_id: &ClientOrderId, quantity: Quantity, )

Updates the tracked quantity for an order following a successful modify acknowledgement, leaving all other identity fields untouched.

Trait Implementations

impl Debug for WsDispatchState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WsDispatchState

fn default() -> Self

Returns the “default value” for a type.