Skip to main content

BeaconStateDelta

Struct BeaconStateDelta 

Source
pub struct BeaconStateDelta {
Show 22 fields pub fork: ForkName, pub base_slot: u64, pub scalar_header: Vec<u8>, pub balances: BalancesDiff, pub validators: ValidatorsDiff, pub block_roots: RootsDiff, pub state_roots: RootsDiff, pub randao_mixes: RandaoDiff, pub slashings: SlashingsDiff, pub eth1_data_votes: Eth1DataVotesDiff, pub historical_roots: Option<HistoricalLogDiff>, pub previous_epoch_attestations: Option<AttestationsDiff>, pub current_epoch_attestations: Option<AttestationsDiff>, pub previous_participation: Option<ParticipationDiff>, pub current_participation: Option<ParticipationDiff>, pub inactivity_scores: Option<InactivityDiff>, pub current_sync_committee: Option<SyncCommitteeDiff>, pub next_sync_committee: Option<SyncCommitteeDiff>, pub historical_summaries: Option<HistoricalLogDiff>, pub pending_deposits: Option<QueueDiff>, pub pending_partial_withdrawals: Option<QueueDiff>, pub pending_consolidations: Option<QueueDiff>,
}
Expand description

Complete compact representation of the transition between two beacon states.

A BeaconStateDelta contains one specialized delta for each state component handled by this crate. Applying the delta to the corresponding base state reconstructs the target state.

The delta records the fork and base slot required to interpret fork-specific fields and circular-buffer updates.

§Fork-specific fields

Fields introduced by later consensus forks are represented as Option<T>:

  • Phase 0 fields are present only on Phase 0.
  • Altair fields are present on Altair and later forks.
  • Capella fields are present on Capella and later forks.
  • Electra fields are present on Electra and later forks.

apply validates these invariants before modifying the destination state.

§Serialization

This type derives rkyv::Archive, rkyv::Serialize, and rkyv::Deserialize and can therefore be archived for storage or transmission.

The delta algorithms themselves do not require the delta to be serialized.

§Lifecycle

A typical workflow is:

DiffSource
    │
    ▼
 create()
    │
    ▼
BeaconStateDelta
    │
    ├── serialize / store / transmit
    │
    ▼
ArchivedBeaconStateDelta
    │
    ▼
  apply()
    │
    ▼
DiffTarget

§Correctness

The delta is intended to reconstruct the target state represented by the DiffSource used during creation. The caller is responsible for ensuring that the destination state corresponds to the base state from which the delta was created.

Fields§

§fork: ForkName§base_slot: u64§scalar_header: Vec<u8>§balances: BalancesDiff§validators: ValidatorsDiff§block_roots: RootsDiff§state_roots: RootsDiff§randao_mixes: RandaoDiff§slashings: SlashingsDiff§eth1_data_votes: Eth1DataVotesDiff§historical_roots: Option<HistoricalLogDiff>§previous_epoch_attestations: Option<AttestationsDiff>

Some for Phase0. None for Altair+.

§current_epoch_attestations: Option<AttestationsDiff>§previous_participation: Option<ParticipationDiff>

None for Phase0. Some for Altair+.

§current_participation: Option<ParticipationDiff>§inactivity_scores: Option<InactivityDiff>§current_sync_committee: Option<SyncCommitteeDiff>§next_sync_committee: Option<SyncCommitteeDiff>§historical_summaries: Option<HistoricalLogDiff>

None for pre-Capella. Some for Capella+.

§pending_deposits: Option<QueueDiff>

None for pre-Electra. Some for Electra+.

§pending_partial_withdrawals: Option<QueueDiff>§pending_consolidations: Option<QueueDiff>

Trait Implementations§

Source§

impl Archive for BeaconStateDelta

Source§

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. Read more
Source§

type Archived = ArchivedBeaconStateDelta

The archived representation of this type. Read more
Source§

type Resolver = BeaconStateDeltaResolver

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

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. Read more
Source§

impl Clone for BeaconStateDelta

Source§

fn clone(&self) -> BeaconStateDelta

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for BeaconStateDelta

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<__D: Fallible + ?Sized> Deserialize<BeaconStateDelta, __D> for Archived<BeaconStateDelta>
where ForkName: Archive, <ForkName as Archive>::Archived: Deserialize<ForkName, __D>, u64: Archive, <u64 as Archive>::Archived: Deserialize<u64, __D>, Vec<u8>: Archive, <Vec<u8> as Archive>::Archived: Deserialize<Vec<u8>, __D>, BalancesDiff: Archive, <BalancesDiff as Archive>::Archived: Deserialize<BalancesDiff, __D>, ValidatorsDiff: Archive, <ValidatorsDiff as Archive>::Archived: Deserialize<ValidatorsDiff, __D>, RootsDiff: Archive, <RootsDiff as Archive>::Archived: Deserialize<RootsDiff, __D>, RandaoDiff: Archive, <RandaoDiff as Archive>::Archived: Deserialize<RandaoDiff, __D>, SlashingsDiff: Archive, <SlashingsDiff as Archive>::Archived: Deserialize<SlashingsDiff, __D>, Eth1DataVotesDiff: Archive, <Eth1DataVotesDiff as Archive>::Archived: Deserialize<Eth1DataVotesDiff, __D>, Option<HistoricalLogDiff>: Archive, <Option<HistoricalLogDiff> as Archive>::Archived: Deserialize<Option<HistoricalLogDiff>, __D>, Option<AttestationsDiff>: Archive, <Option<AttestationsDiff> as Archive>::Archived: Deserialize<Option<AttestationsDiff>, __D>, Option<ParticipationDiff>: Archive, <Option<ParticipationDiff> as Archive>::Archived: Deserialize<Option<ParticipationDiff>, __D>, Option<InactivityDiff>: Archive, <Option<InactivityDiff> as Archive>::Archived: Deserialize<Option<InactivityDiff>, __D>, Option<SyncCommitteeDiff>: Archive, <Option<SyncCommitteeDiff> as Archive>::Archived: Deserialize<Option<SyncCommitteeDiff>, __D>, Option<QueueDiff>: Archive, <Option<QueueDiff> as Archive>::Archived: Deserialize<Option<QueueDiff>, __D>,

Source§

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

Deserializes using the given deserializer
Source§

impl Eq for BeaconStateDelta

Source§

impl PartialEq for BeaconStateDelta

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

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

Source§

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.
Source§

impl StructuralPartialEq for BeaconStateDelta

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> ArchivePointee for T

Source§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
Source§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
Source§

impl<T> ArchiveUnsized for T
where T: Archive,

Source§

type Archived = <T as Archive>::Archived

The archived counterpart of this type. Unlike Archive, it may be unsized. Read more
Source§

fn archived_metadata( &self, ) -> <<T as ArchiveUnsized>::Archived as ArchivePointee>::ArchivedMetadata

Creates the archived version of the metadata for this value.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> LayoutRaw for T

Source§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Returns the layout of the type.
Source§

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

Source§

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more
Source§

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.
Source§

impl<T> Pointee for T

Source§

type Metadata = ()

The metadata type for pointers and references to this type.
Source§

impl<T, S> SerializeUnsized<S> for T
where T: Serialize<S>, S: Fallible + Writer + ?Sized,

Source§

fn serialize_unsized( &self, serializer: &mut S, ) -> Result<usize, <S as Fallible>::Error>

Writes the object and returns the position of the archived type.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.