Struct Ledger 

#[repr(C)]
pub struct Ledger {

    pub authority: Pubkey,
    pub tickets: u64,
    pub unstaked_micros: u64,
    pub win_streak: u64,
    pub last_win_period: u64,
    pub last_win_series_id: u16,
    pub _pad0: [u8; 6],
    pub total_wins: u64,
    pub total_bets: u64,
    pub peak_win_streak: u64,
    pub week_wins: u64,
    pub week_bets: u64,
    pub week_peak_streak: u64,
    pub week_number: u64,
}

Fields

authority: Pubkey

tickets: u64

Whole tickets credited on BuyTickets; debited on PlaceBet.

unstaked_micros: u64

Post-team-cut USDC micros mirroring tickets (1 ticket = TICKET_MICROS µ).

win_streak: u64

Consecutive wins on [last_win_series_id] with period + 1 steps.

last_win_period: u64

Last Market::period confirmed as a win (via ExecutorTreasury distribute). 0 = none.

last_win_series_id: u16

series_id for [last_win_period] (streak concurrency key).

_pad0: [u8; 6]

total_wins: u64

Total rounds on the winning side (all-time correct calls).

total_bets: u64

Total ticket-debit events across all PlaceBet calls (each stake spend = +1).

peak_win_streak: u64

All-time highest win_streak ever recorded for this player.

week_wins: u64

Wins in the current executor week.

week_bets: u64

Bets placed in the current executor week.

week_peak_streak: u64

Longest streak achieved in the current executor week.

week_number: u64

Which executor week these week_* stats belong to. Compared against Treasury::current_week; if stale, zero weekly fields and update this.

Implementations

impl Ledger

pub fn pda(authority: Pubkey) -> (Pubkey, u8)

pub fn maybe_reset_weekly(&mut self, current_week: u64)

Reset weekly counters if the executor has advanced [Treasury::current_week].

Call at the top of any code path that reads or writes weekly stats, passing the value read from Treasury::current_week.

pub fn record_win( &mut self, market_period: u64, series_id: u16, current_week: u64, )

Record a confirmed win for this player. Called from ExecutorTreasury (distribute).

Updates streak, peak streak, total wins, and weekly equivalents. current_week must be read from Treasury::current_week before calling.

pub fn record_loss(&mut self, current_week: u64)

Record a loss (streak break). Called from PlaceBet when the previous period is settled as a loss for this player.

current_week must be read from Treasury::current_week before calling.

pub fn record_bet(&mut self, current_week: u64)

Record a bet (ticket debit). Called from PlaceBet whenever tickets are actually spent.

current_week must be read from Treasury::current_week before calling.

impl Ledger

pub fn to_bytes(&self) -> &[u8]

impl Ledger

pub const SIZE: usize

Trait Implementations

impl AccountValidation for Ledger

fn assert<F>(&self, condition: F) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_err<F>( &self, condition: F, err: ProgramError, ) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_msg<F>(&self, condition: F, msg: &str) -> Result<&Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut<F>(&mut self, condition: F) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut_err<F>( &mut self, condition: F, err: ProgramError, ) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

fn assert_mut_msg<F>( &mut self, condition: F, msg: &str, ) -> Result<&mut Self, ProgramError>

where F: Fn(&Self) -> bool,

impl Clone for Ledger

fn clone(&self) -> Ledger

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Ledger

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Discriminator for Ledger

fn discriminator() -> u8

impl PartialEq for Ledger

fn eq(&self, other: &Ledger) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Zeroable for Ledger

fn zeroed() -> Self

Calls zeroed.

impl Copy for Ledger

impl Pod for Ledger

impl StructuralPartialEq for Ledger