lightcone 0.6.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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

#![doc = include_str!("README.md")]

pub mod builders;
pub mod client;
pub mod wire;

pub use builders::{
    DepositBuilder, DepositToGlobalBuilder, ExtendPositionTokensBuilder,
    GlobalToMarketDepositBuilder, InitPositionTokensBuilder, MergeBuilder, RedeemWinningsBuilder,
    WithdrawBuilder, WithdrawFromGlobalBuilder, WithdrawFromPositionBuilder,
};

use crate::shared::{OrderBookId, PubkeyStr};
use chrono::{DateTime, Utc};
use rust_decimal::Decimal;
use serde::{Deserialize, Serialize};

// ─── Portfolio ───────────────────────────────────────────────────────────────

/// Full portfolio for a user.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Portfolio {
    pub user_address: PubkeyStr,
    pub wallet_holdings: Vec<WalletHolding>,
    pub positions: Vec<Position>,
    pub total_wallet_value: Decimal,
    pub total_positions_value: Decimal,
}

/// A user's position in a market.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Position {
    pub event_pubkey: PubkeyStr,
    pub event_name: String,
    pub event_img_src: String,
    pub outcomes: Vec<PositionOutcome>,
    pub total_value: Decimal,
    pub created_at: DateTime<Utc>,
}

/// One outcome within a position.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PositionOutcome {
    pub condition_id: u8,
    pub condition_name: String,
    pub token_mint: PubkeyStr,
    pub amount: Decimal,
    pub usd_value: Decimal,
}

/// A wallet holding (non-conditional token balance).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct WalletHolding {
    pub token_mint: PubkeyStr,
    pub symbol: String,
    pub amount: Decimal,
    pub decimals: u64,
    pub usd_value: Decimal,
    pub img_src: String,
}

// ─── TokenBalance ────────────────────────────────────────────────────────────

/// Classification of a token balance's source.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub enum TokenBalanceTokenType {
    DepositAsset,
    ConditionalToken {
        orderbook_id: OrderBookId,
        market_pubkey: PubkeyStr,
        outcome_index: i16,
    },
}

/// A user's balance for a specific token.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TokenBalance {
    pub mint: PubkeyStr,
    pub idle: Decimal,
    pub on_book: Decimal,
    pub token_type: TokenBalanceTokenType,
}

impl From<DepositTokenBalance> for TokenBalance {
    fn from(value: DepositTokenBalance) -> Self {
        Self {
            mint: value.mint,
            idle: value.idle,
            on_book: Decimal::ZERO,
            token_type: TokenBalanceTokenType::DepositAsset,
        }
    }
}

impl Default for TokenBalance {
    fn default() -> Self {
        Self {
            mint: PubkeyStr::default(),
            idle: Decimal::ZERO,
            on_book: Decimal::ZERO,
            token_type: TokenBalanceTokenType::DepositAsset,
        }
    }
}

impl TokenBalance {
    pub fn computed_base(&self, conditional_price: Decimal) -> TokenBalanceComputedBase {
        use crate::shared::fmt::decimal;
        let size = self.idle + self.on_book;
        let value = size * conditional_price;

        TokenBalanceComputedBase {
            value: decimal::display(&value),
            size: decimal::display(&size),
            price: decimal::display(&conditional_price),
        }
    }

    pub fn computed_quote(&self) -> String {
        use crate::shared::fmt::decimal;
        let size = self.idle + self.on_book;
        decimal::display(&size)
    }
}

pub struct TokenBalanceComputedBase {
    pub value: String,
    pub size: String,
    pub price: String,
}

/// Metadata for a deposit asset fetched from on-chain or DAS.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct DepositAssetMetadata {
    pub symbol: String,
    pub name: String,
    pub icon_url: String,
}

/// Combined balance + metadata for a deposit token.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct DepositTokenBalance {
    pub mint: PubkeyStr,
    pub idle: Decimal,
    pub symbol: String,
    pub name: String,
    pub icon_url_low: Option<String>,
    pub icon_url_medium: Option<String>,
    pub icon_url_high: Option<String>,
}