Enum ChainControl 

#[non_exhaustive]
pub enum ChainControl {
    Reorg {
        common_ancestor: BlockRef,
        old_tip: BlockRef,
        new_tip: BlockRef,
    },
    Safe(BlockRef),
    Finalized(BlockRef),
    CanonicalProgress(BlockRef),
    Barrier {
        id: Vec<u8>,
        block: Option<BlockRef>,
    },
}

Ordered chain-lifecycle control delivered by an event subscriber.

Controls live inside ReactiveInputBatch so they share the same delivery token, durable checkpoint, and ordering guarantees as ordinary event data. Reorg controls are applied in declaration order before replacement records; progress, barrier, safe, and finalized controls are committed in declaration order after the records. A reorg declared after a post-record control is rejected because its ordering would otherwise be ambiguous.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Reorg

Replace the old canonical branch after common_ancestor with new_tip.

Fields

common_ancestor: BlockRef

Last block common to the old and new canonical branches.

old_tip: BlockRef

Tip of the branch that ceased to be canonical.

new_tip: BlockRef

Tip of the newly canonical branch known by the source.

Safe(BlockRef)

Update the source’s safe head.

Finalized(BlockRef)

Update the source’s finalized head.

CanonicalProgress(BlockRef)

Advance authoritative canonical coverage without fabricating a full header.

Indexers that only know compact block identity should emit this control. It never runs block handlers. The runtime exact-hash pins provider reads and installs known NUMBER/timestamp values, but clears unproven header-only environment fields such as base fee and beneficiary.

Barrier

Ordered cutover or synchronization fence.

Fields

id: Vec<u8>

Subscriber-defined opaque barrier identity.

block: Option<BlockRef>

Highest canonical event block included before the fence, if known.

Trait Implementations

impl Clone for ChainControl

fn clone(&self) -> ChainControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChainControl

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ChainControl

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ChainControl

impl PartialEq for ChainControl

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ChainControl

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ChainControl