streak-api 0.1.7

API for interacting with the STREAK directional markets protocol 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

//! On-chain events (`sol_log_data` via Steel `event!` / `.log()`).
//!
//! The server and indexer subscribe to these events to maintain the off-chain state:
//! user balances, bet records, market outcomes, leaderboard history.
//!
//! ## Event contract
//!
//! | Event | Trigger | Observer action |
//! |---|---|---|
//! | `Deposited` | `Deposit` ix | Indexer credits user's off-chain USDC balance |
//! | `PeriodSettled` | `AdminInstantSettlement` | Bot computes + dispatches payouts; DB records outcome |
//! | `Paid` | `AdminPayout` | Bot confirms payout in DB |
//! | `Initialized` | `Initialize` | One-time setup confirmation |

use steel::*;

/// Emitted by `Initialize`.
#[repr(C)]
#[derive(Clone, Copy, Debug, PartialEq, Pod, Zeroable)]
pub struct Initialized {
    pub admin: Pubkey,
}

/// Emitted by `Deposit`. Server credits `user`'s off-chain balance by `amount` µUSDC.
#[repr(C)]
#[derive(Clone, Copy, Debug, PartialEq, Pod, Zeroable)]
pub struct Deposited {
    pub user: Pubkey,
    pub amount: u64,
}

/// Emitted by `AdminInstantSettlement`. Server reads this to compute and enqueue payouts.
///
/// `outcome` = `0` (UP) or `1` (DOWN).
/// `close_price` / `close_expo` / `close_publish_time` are the Pyth values read at settlement.
/// The open reference was `Treasury::last_close_*` immediately before this instruction ran.
#[repr(C)]
#[derive(Clone, Copy, Debug, PartialEq, Pod, Zeroable)]
pub struct PeriodSettled {
    pub series_id: u16,
    pub outcome: u8,
    pub _pad: [u8; 5],
    pub period: u64,
    pub close_price: i64,
    pub close_expo: i32,
    pub _pad2: [u8; 4],
    pub close_publish_time: i64,
    /// Open reference price that was in Treasury before this settlement.
    pub open_price: i64,
    pub open_expo: i32,
    pub _pad3: [u8; 4],
}

/// Emitted by `AdminPayout`. Bot confirms the payout was delivered.
#[repr(C)]
#[derive(Clone, Copy, Debug, PartialEq, Pod, Zeroable)]
pub struct Paid {
    pub recipient: Pubkey,
    pub amount: u64,
    pub series_id: u16,
    pub _pad: [u8; 6],
    pub period: u64,
}

event!(Initialized);
event!(Deposited);
event!(PeriodSettled);
event!(Paid);