Struct CompleteBlock 

pub struct CompleteBlock<T: BlockMetadata> { /* private fields */ }

RAII guard for a block in the Staged state.

Wraps an internal Block<T, Staged> – a block that carries a SequenceHash and is ready for registration.

Obtaining a CompleteBlock

• MutableBlock::stage – from a pre-computed SequenceHash.
• MutableBlock::complete – by extracting the hash from a TokenBlock.

State transitions

• Pass to BlockManager::register_block to move the block into the Registered state and receive an ImmutableBlock.
• Call reset to undo the staging and get a MutableBlock back (metrics are None on this path).

Drop behaviour

If the CompleteBlock is dropped without being consumed, the underlying block is reset to the Reset state and returned to the reset pool.

Implementations

impl<T: BlockMetadata> CompleteBlock<T>

pub fn block_id(&self) -> BlockId

Returns the BlockId assigned to this block.

pub fn sequence_hash(&self) -> SequenceHash

Returns the SequenceHash that was assigned during staging.

pub fn reset(self) -> MutableBlock<T>

Undoes the staging transition, returning a MutableBlock in the Reset state.

The returned MutableBlock does not carry metrics (they are set to None) because this is an undo/rollback path rather than a fresh allocation.

Trait Implementations

impl<T: BlockMetadata> Drop for CompleteBlock<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.