cosmic-cinder 0.1.21

Rust terminal UI for Phoenix perpetuals on Solana
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! Chart markers and transaction status messages.

#[derive(Clone)]
pub struct TradeMarker {
    pub x: f64,
    pub y: f64,
    pub is_buy: bool,
}

/// Per-open-order chart marker. `x` is captured when we first see the order in
/// a WS snapshot and then advances leftward on each `push_price`, so the square
/// tracks the rolling chart. The map is keyed by `(symbol,
/// order_sequence_number)` so fills/cancels prune cleanly.
#[derive(Clone)]
pub struct OrderChartMarker {
    pub x: f64,
    pub price: f64,
}

#[derive(Clone, Debug)]
pub enum TxStatusMsg {
    TradeMarker {
        symbol: String,
        is_buy: bool,
    },
    SetStatus {
        title: String,
        detail: String,
    },
    /// Record a confirmed tx in the user's Ledger ring without touching
    /// the visible status line. Used by TWAP slices so each slice's
    /// signature still appears in the [L]edger modal for audit, but the
    /// per-slice broadcast/awaiting chatter doesn't clobber the global
    /// status frame that manual orders own.
    LedgerOnly {
        title: String,
        signature: String,
    },
    /// Open the first-run referral choice modal. Sent by the connect flow
    /// when a wallet with no Phoenix account connects. The modal lets the
    /// user pick between COSMIC, a custom code, or continuing without one;
    /// the custom-code text input is reached by direct state transition
    /// from the choice handler.
    PromptReferralChoice,
}

impl TxStatusMsg {
    /// True if this message represents per-slice status chatter that the
    /// TWAP scheduler suppresses with `silent_status=true` (each slice's
    /// "broadcasting..." / "awaiting confirm..." / "order confirmed: <sig>"
    /// would otherwise clobber the user's manual-order status line). Exhaustive
    /// match: every new variant MUST classify itself here so the filter
    /// doesn't silently leak new chatter through.
    pub fn is_per_slice_chatter(&self) -> bool {
        match self {
            TxStatusMsg::SetStatus { .. } => true,
            // Chart pin: every fill belongs on its own market's chart.
            TxStatusMsg::TradeMarker { .. } => false,
            // Ledger entry: TWAP slices want these recorded.
            TxStatusMsg::LedgerOnly { .. } => false,
            // Modal prompts must always reach the user.
            TxStatusMsg::PromptReferralChoice => false,
        }
    }
}

/// One row in the ledger modal: a user-initiated action that produced a
/// confirmed Solana signature (orders, cancels, close position, deposits,
/// withdrawals, stop-market orders).
#[derive(Clone, Debug)]
pub struct LedgerEntry {
    pub timestamp: String,
    pub title: String,
    pub txid: String,
}