Skip to main content

Crate eth_state_diff

Crate eth_state_diff 

Source
Expand description

High-performance delta encoding for Ethereum consensus state.

eth_state_diff computes compact deltas between two beacon states and efficiently reconstructs the target state by applying those deltas.

The crate is designed for consensus clients, archival storage, state synchronization, and historical state reconstruction.

Individual state components use specialized encodings chosen for their respective data structures, including sparse patches, circular buffer updates, packed bit vectors, and FIFO queue deltas.

Deltas are designed to serialize efficiently with rkyv, although the library itself remains serialization-agnostic.

Modules§

attestations
Delta encoding for Phase0 pending attestations.
balances
Compact balance-state delta encoding.
error
eth1_data_votes
Delta encoding for the Eth1 data vote list.
historical_log
Delta encoding for append-only historical logs.
inactivity_scores
Delta encoding for validator inactivity scores.
participation
Delta encoding for validator participation flags.
pending_queue
Universal delta encoding for SSZ lists that behave as FIFO queues.
randao_mixes
Delta encoding for Ethereum RANDAO mix buffers.
recent_roots
Delta encoding for fixed-size Ethereum consensus root buffers.
slashings
Delta encoding for Ethereum slashing vectors.
sync_committee
Delta encoding for Ethereum sync committees.
types
validators
Delta encoding for Ethereum validator records.

Structs§

ArchivedBeaconStateDelta
An archived BeaconStateDelta
BeaconStateDelta
Complete delta describing the transition between two beacon states.
BeaconStateDeltaResolver
The resolver for an archived BeaconStateDelta

Enums§

ArchivedForkName
An archived ForkName
ForkName
Ethereum consensus fork supported by this delta.
ForkNameResolver
The resolver for an archived ForkName

Traits§

DiffSource
Read-only view of two beacon states.
DiffTarget
Mutable view of a beacon state.

Functions§

apply
Applies a previously created beacon-state delta.
create
Creates a delta between two beacon states.