Struct LiquiditySnapshot 

pub struct LiquiditySnapshot {
    pub asset: Address,
    pub volume_30m_usd: i128,
    pub unique_trades_1h: u32,
    pub timestamp: u64,
    pub attester: Address,
}

Mirror of liquidity-registry::LiquiditySnapshot.

Defined independently here to avoid making safe-oracle depend on the liquidity-registry crate. Soroban’s contracttype serialization is structural, so a snapshot written by the contract round-trips into this type as long as the field order, names, and types stay aligned. Any change to the registry’s snapshot shape must be mirrored here in lockstep — Phase 4 tests will catch a drift via integration round-trip.

Precision: All USD-denominated fields use 7-decimal precision (Stellar stroop convention). 1 USD = 10_000_000 (10^7). This matches SafeOracleConfig::min_liquidity_usd for direct comparison without scaling. Reflector uses 14-decimal precision for prices, but liquidity volumes are dollar-denominated and follow the project-wide 7-decimal convention.

Fields

asset: Address

Asset this snapshot describes.

volume_30m_usd: i128

SDEX trading volume during the last 30 minutes, denominated in USD with 7-decimal precision. Example: $50,000 = 500_000_000_000.

unique_trades_1h: u32

Count of unique trades on SDEX during the last 1 hour. Used by safe_oracle::check_thin_sampling (Layer 2 Guardrail #5) to reject markets where price discovery is too thin to trust.

timestamp: u64

Snapshot creation time, in Unix seconds (matching ledger timestamp). Consumers compare against env.ledger().timestamp() and their own max_snapshot_age_seconds threshold to enforce freshness.

attester: Address

Address that wrote this snapshot. Must be in the attester whitelist; equality with the caller is enforced in write_snapshot.

Implementations

impl LiquiditySnapshot

pub const fn spec_xdr() -> [u8; 1664]

Trait Implementations

impl Clone for LiquiditySnapshot

fn clone(&self) -> LiquiditySnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LiquiditySnapshot

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

Formats the value using the given formatter.

impl PartialEq for LiquiditySnapshot

fn eq(&self, other: &LiquiditySnapshot) -> 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 TryFromVal<Env, &LiquiditySnapshot> for Val

type Error = ConversionError

fn try_from_val( env: &Env, val: &&LiquiditySnapshot, ) -> Result<Self, ConversionError>

impl TryFromVal<Env, LiquiditySnapshot> for Val

type Error = ConversionError

fn try_from_val( env: &Env, val: &LiquiditySnapshot, ) -> Result<Self, ConversionError>

impl TryFromVal<Env, Val> for LiquiditySnapshot

type Error = ConversionError

fn try_from_val(env: &Env, val: &Val) -> Result<Self, ConversionError>

impl Eq for LiquiditySnapshot

impl StructuralPartialEq for LiquiditySnapshot