Struct OrderIdMap 

pub struct OrderIdMap { /* private fields */ }

Bidirectional mapping between rustrade ClientOrderId and IB order IDs.

IB uses i32 order IDs from a sequence. Barter uses ClientOrderId (SmolStr). This map maintains the bidirectional relationship and stores order context for reconstructing full Order structs from OrderStatus callbacks.

Implementations

impl OrderIdMap

pub fn new() -> Self

pub fn register( &self, client_id: ClientOrderId, ib_id: i32, context: OrderContext, )

Register a mapping between ClientOrderId and IB order ID with order context.

pub fn get_ib_id(&self, client_id: &ClientOrderId) -> Option<i32>

Look up IB order ID by ClientOrderId.

pub fn get_client_id(&self, ib_id: i32) -> Option<ClientOrderId>

Look up ClientOrderId by IB order ID.

pub fn get_client_id_and_context( &self, ib_id: i32, ) -> Option<(ClientOrderId, OrderContext)>

Look up ClientOrderId and OrderContext together by IB order ID (single lookup).

pub fn remove_and_get_context( &self, ib_id: i32, ) -> Option<(ClientOrderId, OrderContext)>

Remove mapping and return context in a single write lock acquisition.

Use this for terminal status events (Cancelled/Inactive) to avoid the read-then-write pattern of get_client_id_and_context + remove_by_ib_id.

pub fn remove_by_ib_id(&self, ib_id: i32) -> Option<ClientOrderId>

Remove a mapping by IB order ID (used when order is fully filled/cancelled).

pub fn clear_stale(&self, max_age: Duration) -> usize

Clear order ID mappings older than the given duration.

Returns the number of cleared entries.

Why This Is Needed

IB does not guarantee event ordering between OrderStatus("Filled") and ExecutionData/CommissionReport. For fast-filling orders (especially market orders), execution data may arrive AFTER the filled status — or the filled status may not arrive at all. Removing mappings on terminal status would cause data loss.

Instead, call this method periodically to clean up old mappings. A reasonable interval is 5-10 minutes with a max_age of 1 hour.

pub fn len(&self) -> usize

Number of active mappings.

pub fn is_empty(&self) -> bool

Check if map is empty.

Trait Implementations

impl Clone for OrderIdMap

fn clone(&self) -> OrderIdMap

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OrderIdMap

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

Formats the value using the given formatter.

impl Default for OrderIdMap

fn default() -> Self

Returns the “default value” for a type.