Crate eth_state_diff 

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

balances

Compact balance-state delta encoding.

eth1_data_votes

Delta encoding for the Eth1 data vote list.

fifo_queue

Delta encoding for fixed-size SSZ FIFO queues.

inactivity_scores

Delta encoding for validator inactivity scores.

participation

Delta encoding for validator participation flags.

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.

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.