Struct Trader

pub struct Trader {
    pub trader_id: TraderId,
    pub instance_id: UUID4,
    pub environment: Environment,
    /* private fields */
}

Central orchestrator for managing trading components.

The Trader manages the lifecycle and coordination of actors, strategies, and execution algorithms within the trading system. It provides component registration, state management, and integration with system engines.

Fields

trader_id: TraderId

The unique trader identifier.

instance_id: UUID4

The unique instance identifier.

environment: Environment

The trading environment context.

Implementations

impl Trader

pub fn new( trader_id: TraderId, instance_id: UUID4, environment: Environment, clock: Rc<RefCell<dyn Clock>>, ) -> Self

Creates a new Trader instance.

pub const fn trader_id(&self) -> TraderId

Returns the trader ID.

pub const fn instance_id(&self) -> UUID4

Returns the instance ID.

pub const fn environment(&self) -> Environment

Returns the trading environment.

pub const fn state(&self) -> ComponentState

Returns the current component state.

pub const fn ts_created(&self) -> UnixNanos

Returns the timestamp when the trader was created (UNIX nanoseconds).

pub const fn ts_started(&self) -> Option<UnixNanos>

Returns the timestamp when the trader was last started (UNIX nanoseconds).

pub const fn ts_stopped(&self) -> Option<UnixNanos>

Returns the timestamp when the trader was last stopped (UNIX nanoseconds).

pub const fn is_running(&self) -> bool

Returns whether the trader is running.

pub const fn is_stopped(&self) -> bool

Returns whether the trader is stopped.

pub const fn is_disposed(&self) -> bool

Returns whether the trader is disposed.

pub fn actor_count(&self) -> usize

Returns the number of registered actors.

pub fn strategy_count(&self) -> usize

Returns the number of registered strategies.

pub fn exec_algorithm_count(&self) -> usize

Returns the number of registered execution algorithms.

pub fn component_count(&self) -> usize

Returns the total number of registered components.

pub fn actor_ids(&self) -> Vec<ComponentId>

Returns a list of all registered actor IDs.

pub fn strategy_ids(&self) -> Vec<StrategyId>

Returns a list of all registered strategy IDs.

pub fn exec_algorithm_ids(&self) -> Vec<ExecAlgorithmId>

Returns a list of all registered execution algorithm IDs.

pub fn add_actor(&mut self, actor: Box<dyn Component>) -> Result<()>

Adds an actor to the trader.

Errors

Returns an error if:

• The trader is not in a valid state for adding components
• An actor with the same ID is already registered

pub fn add_strategy(&mut self, strategy: Box<dyn Component>) -> Result<()>

Adds a strategy to the trader.

Errors

Returns an error if:

• The trader is not in a valid state for adding components
• A strategy with the same ID is already registered

pub fn add_exec_algorithm( &mut self, exec_algorithm: Box<dyn Component>, ) -> Result<()>

Adds an execution algorithm to the trader.

Errors

Returns an error if:

• The trader is not in a valid state for adding components
• An execution algorithm with the same ID is already registered

pub fn start_components(&mut self) -> Result<()>

Starts all registered components.

Errors

Returns an error if any component fails to start.

pub fn stop_components(&mut self) -> Result<()>

Stops all registered components.

Errors

Returns an error if any component fails to stop.

pub fn reset_components(&mut self) -> Result<()>

Resets all registered components.

Errors

Returns an error if any component fails to reset.

pub fn dispose_components(&mut self) -> Result<()>

Disposes of all registered components.

Errors

Returns an error if any component fails to dispose.

pub fn initialize(&mut self) -> Result<()>

Initializes the trader, transitioning from PreInitialized to Ready state.

This method must be called before starting the trader.

Errors

Returns an error if the trader cannot be initialized from its current state.

Trait Implementations

impl Component for Trader

fn id(&self) -> ComponentId

Returns the unique identifier for this component.

fn state(&self) -> ComponentState

Returns the current state of the component.

fn trigger(&self) -> ComponentTrigger

Returns the component trigger.

fn is_running(&self) -> bool

Returns whether the component is currently running.

fn is_stopped(&self) -> bool

Returns whether the component is stopped.

fn is_disposed(&self) -> bool

Returns whether the component has been disposed.

fn start(&mut self) -> Result<()>

Starts the component.

fn stop(&mut self) -> Result<()>

Stops the component.

fn reset(&mut self) -> Result<()>

Resets the component to its initial state.

fn dispose(&mut self) -> Result<()>

Disposes of the component, releasing any resources.

fn handle_event(&mut self, _event: TimeEvent)

Handles a timer event (TBD).

impl Debug for Trader

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

Formats the value using the given formatter.