lightcone 0.7.1

Rust SDK for the Lightcone Protocol — unified native + WASM client
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
76

//! Wire types for trade responses (REST + WS).

use crate::shared::{OrderBookId, Side};
use chrono::{DateTime, Utc};
use rust_decimal::Decimal;
use serde::{Deserialize, Serialize};
// ─── REST wire types ─────────────────────────────────────────────────────────

/// A single trade from the REST API.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct TradeResponse {
    pub id: i64,
    pub trade_id: String,
    pub orderbook_id: OrderBookId,
    pub taker_pubkey: String,
    pub maker_pubkey: String,
    pub side: Side,
    pub size: String,
    pub price: String,
    #[serde(default)]
    pub taker_fee: Option<String>,
    #[serde(default)]
    pub maker_fee: Option<String>,
    pub executed_at: i64,
}

/// REST decimals metadata for trades.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct TradesDecimals {
    #[serde(default)]
    pub price: Option<u8>,
    #[serde(default)]
    pub size: Option<u8>,
    #[serde(default)]
    pub fee: Option<u8>,
}

/// REST response for trades list.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TradesResponse {
    pub orderbook_id: OrderBookId,
    pub trades: Vec<TradeResponse>,
    #[serde(default)]
    pub next_cursor: Option<i64>,
    #[serde(default)]
    pub has_more: bool,
    #[serde(default)]
    pub decimals: Option<TradesDecimals>,
}

/// REST response for market-level trades (all orderbooks in a market).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MarketTradesResponse {
    pub market_pubkey: crate::shared::PubkeyStr,
    pub trades: Vec<TradeResponse>,
    #[serde(default)]
    pub next_cursor: Option<i64>,
    #[serde(default)]
    pub has_more: bool,
}

// ─── WS wire types ───────────────────────────────────────────────────────────

/// WS trade event.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct WsTrade {
    pub orderbook_id: OrderBookId,
    pub trade_id: String,
    pub timestamp: DateTime<Utc>,
    pub price: Decimal,
    pub size: Decimal,
    pub side: Side,
    /// Monotonic sequence number per orderbook for ordering guarantees.
    #[serde(default)]
    pub sequence: u64,
}