Struct MonitorState 

pub struct MonitorState {

    pub token_address: String,
    pub symbol: String,
    pub name: String,
    pub chain: String,
    pub price_history: VecDeque<DataPoint>,
    pub volume_history: VecDeque<DataPoint>,
    pub real_data_count: usize,
    pub current_price: f64,
    pub price_change_24h: f64,
    pub price_change_6h: f64,
    pub price_change_1h: f64,
    pub price_change_5m: f64,
    pub last_price_change_at: f64,
    pub previous_price: f64,
    pub buys_24h: u64,
    pub sells_24h: u64,
    pub liquidity_usd: f64,
    pub volume_24h: f64,
    pub market_cap: Option<f64>,
    pub fdv: Option<f64>,
    pub last_update: Instant,
    pub refresh_rate: Duration,
    pub paused: bool,
    pub log_messages: VecDeque<String>,
    pub log_list_state: ListState,
    pub error_message: Option<String>,
    pub time_period: TimePeriod,
    pub chart_mode: ChartMode,
    pub scale_mode: ScaleMode,
    pub color_scheme: ColorScheme,
    pub holder_count: Option<u64>,
    pub liquidity_pairs: Vec<(String, f64)>,
    pub holder_fetch_counter: u32,
    pub start_timestamp: i64,
    pub layout: LayoutPreset,
    pub widgets: WidgetVisibility,
    pub auto_layout: bool,
    pub widget_toggle_mode: bool,
    pub alerts: AlertConfig,
    pub active_alerts: Vec<ActiveAlert>,
    pub alert_flash_until: Option<Instant>,
    pub export_active: bool,
    pub export_path: Option<PathBuf>,
    pub volume_avg: f64,
    pub auto_pause_on_input: bool,
    pub last_input_at: Instant,
    pub auto_pause_timeout: Duration,
}

State for the live token monitor.

Fields

token_address: String

Token contract address.

symbol: String

Token symbol.

name: String

Token name.

chain: String

Blockchain network.

price_history: VecDeque<DataPoint>

Historical price data points with real/synthetic indicator.

volume_history: VecDeque<DataPoint>

Historical volume data points with real/synthetic indicator.

real_data_count: usize

Count of real (non-synthetic) data points.

current_price: f64

Current price in USD.

price_change_24h: f64

24-hour price change percentage.

price_change_6h: f64

6-hour price change percentage.

price_change_1h: f64

1-hour price change percentage.

price_change_5m: f64

5-minute price change percentage.

last_price_change_at: f64

Timestamp when the price last changed (Unix timestamp).

previous_price: f64

Previous price for change detection.

buys_24h: u64

Total buy transactions in 24 hours.

sells_24h: u64

Total sell transactions in 24 hours.

liquidity_usd: f64

Total liquidity in USD.

volume_24h: f64

24-hour volume in USD.

market_cap: Option<f64>

Market capitalization.

fdv: Option<f64>

Fully diluted valuation.

last_update: Instant

Last update timestamp.

refresh_rate: Duration

Refresh rate.

paused: bool

Whether monitoring is paused.

log_messages: VecDeque<String>

Recent log messages.

log_list_state: ListState

Scroll state for the activity log list widget.

error_message: Option<String>

Error message to display (if any).

time_period: TimePeriod

Selected time period for chart display.

chart_mode: ChartMode

Chart display mode (line or candlestick).

scale_mode: ScaleMode

Y-axis scale mode for price charts (Linear or Log).

color_scheme: ColorScheme

Active color scheme.

holder_count: Option<u64>

Holder count (fetched from chain client, if available).

liquidity_pairs: Vec<(String, f64)>

Per-pair liquidity data: (pair_name, liquidity_usd).

holder_fetch_counter: u32

Counter to throttle holder count fetches.

start_timestamp: i64

Unix timestamp when monitoring started.

layout: LayoutPreset

Current layout preset.

widgets: WidgetVisibility

Widget visibility toggles.

auto_layout: bool

Whether responsive auto-layout is active (disabled by manual layout switch).

widget_toggle_mode: bool

Whether the widget-toggle input mode is active (waiting for digit 1-5).

alerts: AlertConfig

Alert configuration thresholds.

active_alerts: Vec<ActiveAlert>

Currently firing alerts.

alert_flash_until: Option<Instant>

Visual flash timer for alert overlay.

export_active: bool

Whether CSV export is currently active.

export_path: Option<PathBuf>

Path to the current export file.

volume_avg: f64

Rolling volume average for spike detection (simple moving average).

auto_pause_on_input: bool

Whether auto-pause on user input is enabled.

last_input_at: Instant

Timestamp of the last user key input.

auto_pause_timeout: Duration

Duration after last input before auto-pause lifts (default 3s).

Implementations

impl MonitorState

pub fn new(token_data: &DexTokenData, chain: &str) -> Self

Creates a new monitor state from initial token data. Attempts to load cached data from disk first.

pub fn apply_config(&mut self, config: &MonitorConfig)

Applies monitor config settings to this state.

pub fn palette(&self) -> ColorPalette

Toggles between line and candlestick chart modes. Returns the current color palette based on the active color scheme.

pub fn toggle_chart_mode(&mut self)

pub fn save_cache(&self)

Saves monitor data to cache file.

pub fn update(&mut self, token_data: &DexTokenData)

Updates the state with new token data. New data points are marked as real (is_real = true).

pub fn start_export(&mut self)

Starts CSV export: creates the file and writes the header.

pub fn stop_export(&mut self)

Stops CSV export and closes the file.

pub fn toggle_export(&mut self)

Toggles CSV export on/off.

pub fn get_price_data_for_period(&self) -> (Vec<(f64, f64)>, Vec<bool>)

Returns data points filtered by the current time period. Returns tuples for chart compatibility, plus a separate vector of is_real flags.

pub fn get_volume_data_for_period(&self) -> (Vec<(f64, f64)>, Vec<bool>)

Returns volume data filtered by the current time period. Returns tuples for chart compatibility, plus a separate vector of is_real flags.

pub fn data_stats(&self) -> (usize, usize)

Returns count of synthetic vs real data points in the current view.

pub fn memory_usage(&self) -> usize

Estimates memory usage of stored data in bytes.

pub fn get_ohlc_candles(&self) -> Vec<OhlcCandle>

Generates OHLC candles from price history for the current time period.

The candle duration is automatically determined based on the selected time period:

• 1m view: 5-second candles
• 5m view: 15-second candles
• 15m view: 1-minute candles
• 1h view: 5-minute candles
• 4h view: 15-minute candles
• 1d view: 1-hour candles

pub fn cycle_time_period(&mut self)

Cycles to the next time period.

pub fn set_time_period(&mut self, period: TimePeriod)

Sets a specific time period.

pub fn should_refresh(&self) -> bool

Returns whether a refresh is needed. Respects manual pause, auto-pause on input, and the refresh interval.

pub fn is_auto_paused(&self) -> bool

Returns true if auto-pause is currently suppressing refreshes.

pub fn toggle_pause(&mut self)

Toggles pause state.

pub fn force_refresh(&mut self)

Forces an immediate refresh.

pub fn slower_refresh(&mut self)

Increases refresh interval (slower updates).

pub fn faster_refresh(&mut self)

Decreases refresh interval (faster updates).

pub fn scroll_log_down(&mut self)

Scrolls the activity log down (newer messages).

pub fn scroll_log_up(&mut self)

Scrolls the activity log up (older messages).

pub fn refresh_rate_secs(&self) -> u64

Returns the current refresh rate in seconds.

pub fn buy_ratio(&self) -> f64

Returns the buy/sell ratio as a percentage (0.0 to 1.0).