Struct ImmutableBlock 

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

RAII guard for a block in the Registered state.

An ImmutableBlock is the primary handle through which callers interact with registered blocks. It is reference-counted (Clone-able) and each clone independently tracks the inflight_immutable metric gauge, so the gauge reflects the total number of outstanding references across the system.

Obtaining an ImmutableBlock

• BlockManager::register_block – registers a CompleteBlock and returns an ImmutableBlock.
• BlockManager::match_blocks / BlockManager::scan_matches – look up already-registered blocks by SequenceHash.
• WeakBlock::upgrade – resurrects a weak reference if the block is still alive.

State transitions

• downgrade – creates a WeakBlock that does not keep the block alive.

Clone behaviour

Cloning an ImmutableBlock increments inflight_immutable; dropping a clone decrements it. The underlying registered block is shared via Arc, so clones are cheap.

Drop behaviour

Dropping the last strong reference (including internal pool references) triggers the block’s return to the inactive or reset pool. Every drop decrements the inflight_immutable gauge.

Implementations

impl<T: BlockMetadata> ImmutableBlock<T>

pub fn downgrade(&self) -> WeakBlock<T>

Creates a WeakBlock that references the same registered block without preventing it from being evicted.

pub fn block_id(&self) -> BlockId

Returns the BlockId assigned to this block.

pub fn sequence_hash(&self) -> SequenceHash

Returns the SequenceHash that identifies this block’s content.

pub fn registration_handle(&self) -> BlockRegistrationHandle

Returns a clone of the BlockRegistrationHandle for this block.

pub fn use_count(&self) -> usize

Returns the number of strong (Arc) references to the underlying registered block, including internal pool references.

Trait Implementations

impl<T: BlockMetadata> Clone for ImmutableBlock<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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