Struct StakeCacheData 

pub struct StakeCacheData {
    pub stake_accounts: HashMap<Pubkey, Option<StakeAccount>>,
    pub validator_accounts: HashMap<Pubkey, Option<ValidatorAccount>>,
    pub epoch: Epoch,
    pub timestamp: u64,
    pub modified_stake_pubkeys: HashSet<Pubkey>,
    pub modified_validator_pubkeys: HashSet<Pubkey>,
}

Data structure holding the cached stake and validator accounts.

Uses HashMap<Pubkey, Option<T>> to support the delta-based persistence model:

• Some(account) = account was added or updated
• None = account was deleted (tombstone)

In baseline, values are always Some(...) since it represents complete state. In pending and frozen deltas, None indicates deletion.

Fields

stake_accounts: HashMap<Pubkey, Option<StakeAccount>>

Map of stake accounts by public key. None value indicates a tombstone (account was deleted during this epoch).

validator_accounts: HashMap<Pubkey, Option<ValidatorAccount>>

Map of validator accounts by public key. None value indicates a tombstone (account was deleted during this epoch).

epoch: Epoch

The epoch counter when this snapshot was taken.

timestamp: u64

The block’s Unix timestamp (in milliseconds) when this snapshot was taken. This is set when FreezeStakes is called and represents the epoch boundary.

modified_stake_pubkeys: HashSet<Pubkey>

Set of stake account pubkeys modified during the current block. Used to track which accounts need to be persisted to the deltas CF. This is cleared after each finalize() call.

modified_validator_pubkeys: HashSet<Pubkey>

Set of validator account pubkeys modified during the current block. Used to track which accounts need to be persisted to the deltas CF. This is cleared after each finalize() call.

Implementations

impl StakeCacheData

pub fn drain_modified(&mut self) -> (HashSet<Pubkey>, HashSet<Pubkey>)

Drain the modified pubkey sets, returning the pubkeys and clearing the sets.

This is called by StateStore::finalize() to get the list of accounts that need to be persisted to the deltas CF. After this call, both modified_stake_pubkeys and modified_validator_pubkeys will be empty.

Returns a tuple of (stake_pubkeys, validator_pubkeys).

pub fn has_modified(&self) -> bool

Check if there are any modified accounts pending persistence.

Trait Implementations

impl Clone for StakeCacheData

fn clone(&self) -> StakeCacheData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StakeCacheData

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

Formats the value using the given formatter.

impl Default for StakeCacheData

fn default() -> StakeCacheData

Returns the “default value” for a type.