Struct BalancesDiff 

pub struct BalancesDiff {
    pub tags: BitTagVec,
    pub mode: i64,
    pub varint_payload: Vec<u8>,
    pub target_values: Vec<u64>,
    pub appended_balances: Vec<u64>,
}

Compact representation of the difference between two validator balance snapshots.

The representation combines four mechanisms:

• BitTagVec stores a two-bit operation for each balance;
• mode stores the most common representable balance difference;
• varint_payload stores mode-adjusted signed differences using zig-zag encoding; and
• target_values stores balances that are more efficiently represented as absolute values.

Validators that exist only in the target snapshot are stored in appended_balances.

This representation is designed to serialize efficiently with rkyv and compress well with general-purpose compressors such as zstd.

Reconstruction

Each tag determines how the corresponding target balance is reconstructed:

• unchanged balances require no payload;
• zero balances are set directly to zero;
• difference-encoded balances are reconstructed from mode and the corresponding varint; and
• absolute values are read from target_values.

Fields

tags: BitTagVec

Packed two-bit operation tags for the common balance range.

mode: i64

Most frequently occurring representable balance difference.

Difference-encoded balances store their difference relative to this value before zig-zag and varint encoding.

varint_payload: Vec<u8>

Zig-zag encoded, varint-serialized balance differences.

target_values: Vec<u64>

Absolute target balances for changes represented without a difference.

appended_balances: Vec<u64>

Balances belonging to validators appended to the target vector.

Trait Implementations

impl Archive for BalancesDiff

where BitTagVec: Archive, i64: Archive, Vec<u8>: Archive, Vec<u64>: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedBalancesDiff

The archived representation of this type.

type Resolver = BalancesDiffResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

impl Clone for BalancesDiff

fn clone(&self) -> BalancesDiff

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BalancesDiff

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

Formats the value using the given formatter.

impl<__D: Fallible + ?Sized> Deserialize<BalancesDiff, __D> for Archived<BalancesDiff>

where BitTagVec: Archive, <BitTagVec as Archive>::Archived: Deserialize<BitTagVec, __D>, i64: Archive, <i64 as Archive>::Archived: Deserialize<i64, __D>, Vec<u8>: Archive, <Vec<u8> as Archive>::Archived: Deserialize<Vec<u8>, __D>, Vec<u64>: Archive, <Vec<u64> as Archive>::Archived: Deserialize<Vec<u64>, __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<BalancesDiff, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl Eq for BalancesDiff

impl PartialEq for BalancesDiff

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

Equality operator ==.

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

Inequality operator !=.

impl<__S: Fallible + ?Sized> Serialize<__S> for BalancesDiff

where BitTagVec: Serialize<__S>, i64: Serialize<__S>, Vec<u8>: Serialize<__S>, Vec<u64>: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl StructuralPartialEq for BalancesDiff