Struct MutableBlock 

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

RAII guard for a block in the Reset state.

Holds an Arc<BlockStore<T>> and a BlockId; the slot at that id is in SlotState::Mutable while this guard exists. Drop returns the slot to the reset pool.

Drop behaviour

Dropping a MutableBlock returns the slot to the reset pool. The store’s release_mutable updates the inflight_mutable gauge.

Implementations

impl<T: BlockMetadata + Sync> MutableBlock<T>

pub fn block_id(&self) -> BlockId

Returns the BlockId assigned to this block.

pub fn block_size(&self) -> usize

Returns the fixed block size of this block in tokens.

pub fn stage( self, seq_hash: SequenceHash, block_size: usize, ) -> Result<CompleteBlock<T>, BlockError<MutableBlock<T>>>

Transition from Reset to Staged with a pre-computed SequenceHash and an explicit block_size check.

On size mismatch returns Err(BlockError::BlockSizeMismatch) containing this MutableBlock so the caller can recover it.

pub fn complete( self, token_block: &TokenBlock, ) -> Result<CompleteBlock<T>, BlockError<MutableBlock<T>>>

Transition from Reset to Staged by extracting the SequenceHash from a TokenBlock.

Trait Implementations

impl<T: BlockMetadata> Debug for MutableBlock<T>

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

Formats the value using the given formatter.

impl<T: BlockMetadata> Drop for MutableBlock<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.