Struct AssetState 

pub struct AssetState {
    pub asset: Asset,
    pub statistics: TearSheetAssetGenerator,
    pub balance: Option<Timed<Balance>>,
}

Represents the current state of an asset, including its Balance and last update time_exchange.

When used in the context of AssetStates, this state is for an exchange asset, but it could be used for a “global” asset that aggregates data for similar named assets on multiple exchanges.

Fields

asset: Asset

Asset name data that details the internal and exchange names.

statistics: TearSheetAssetGenerator

TearSheet generator for summarising trading session changes the asset.

balance: Option<Timed<Balance>>

Current balance of the asset and associated exchange timestamp.

Implementations

impl AssetState

pub const fn new( asset: Asset, statistics: TearSheetAssetGenerator, balance: Option<Timed<Balance>>, ) -> AssetState

impl AssetState

pub fn update_from_balance<AssetKey>( &mut self, snapshot: Snapshot<&AssetBalance<AssetKey>>, )

Updates the AssetState from an AssetBalance snapshot, if the snapshot is more recent.

This method ensures temporal consistency by only applying updates from snapshots that are at least as recent as the current state.

pub fn apply_balance_update<AssetKey>( &mut self, snapshot: Snapshot<&AssetBalanceUpdate<AssetKey>>, )

Applies a WS partial AssetBalanceUpdate (free/locked only), if more recent.

Updates free and recomputes total = free + locked, while preserving any existing MarginDetails — a stream update carries no debt, so this path structurally cannot clobber known borrowed/interest. On a cold start (no prior balance) the merged balance has margin: None, consistent with the debt-freshness contract (debt becomes known only via a BalanceSnapshot).

Like Self::update_from_balance, stale updates (older than the current state) are ignored.

Trait Implementations

impl Clone for AssetState

fn clone(&self) -> AssetState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AssetState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AssetState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&AssetState> for AssetBalance<AssetNameExchange>

fn from(value: &AssetState) -> Self

Converts to this type from the input type.

impl PartialEq for AssetState

fn eq(&self, other: &AssetState) -> 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 PartialOrd for AssetState

fn partial_cmp(&self, other: &AssetState) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for AssetState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AssetState