Struct massa_storage::block_indexes::BlockIndexes

pub struct BlockIndexes {
    blocks: PreHashMap<BlockId, Box<SecureShareBlock>>,
    index_by_creator: PreHashMap<Address, PreHashSet<BlockId>>,
    index_by_slot: BTreeMap<Slot, PreHashSet<BlockId>>,
    index_by_op: PreHashMap<OperationId, PreHashSet<BlockId>>,
    index_by_endorsement: PreHashMap<EndorsementId, PreHashSet<BlockId>>,
}

Container for all blocks and different indexes. Note: The structure can evolve and store more indexes.

Fields

blocks: PreHashMap<BlockId, Box<SecureShareBlock>>

Blocks structure container

index_by_creator: PreHashMap<Address, PreHashSet<BlockId>>

Structure mapping creators with the created blocks

index_by_slot: BTreeMap<Slot, PreHashSet<BlockId>>

Structure mapping slot with their block id

index_by_op: PreHashMap<OperationId, PreHashSet<BlockId>>

Structure mapping operation id with ids of blocks they are contained in

index_by_endorsement: PreHashMap<EndorsementId, PreHashSet<BlockId>>

Structure mapping endorsement id with ids of blocks they are contained in

Implementations

impl BlockIndexes

pub(crate) fn insert(&mut self, block: SecureShareBlock)

Insert a block and populate the indexes. Arguments:

• block: the block to insert

pub(crate) fn remove( &mut self, block_id: &BlockId, ) -> Option<Box<SecureShareBlock>>

Remove a block, remove from the indexes and do some clean-up in indexes if necessary. Arguments:

• block_id: the block id to remove

pub fn get(&self, id: &BlockId) -> Option<&SecureShareBlock>

Get a block reference by its ID Arguments:

• id: ID of the block to retrieve

Returns:

• a reference to the block, or None if not found

pub fn contains(&self, id: &BlockId) -> bool

Checks whether a block exists in global storage.

pub fn get_blocks_created_by( &self, address: &Address, ) -> Option<&PreHashSet<BlockId>>

Get the block ids created by an address. Arguments:

• address: the address to get the blocks created by

Returns:

• a reference to the block ids created by the address

pub fn get_blocks_by_slot(&self, slot: &Slot) -> Option<&PreHashSet<BlockId>>

Get the block ids of the blocks at a given slot. Arguments:

• slot: the slot to get the block id of

Returns:

• the block ids of the blocks at the slot if any, None otherwise

pub fn aggregate_blocks_by_slot_range<R>( &self, slot_range: R, ) -> PreHashSet<BlockId>

where R: RangeBounds<Slot>,

Aggregate block IDs by slot range. Arguments:

• slot_range: the slot range of interest

Returns:

• a copy of the block ids of the blocks within the slot range

pub fn get_blocks_by_operation( &self, id: &OperationId, ) -> Option<&PreHashSet<BlockId>>

Get the block ids of the blocks containing a given operation. Arguments:

• id: the ID of the operation

Returns:

• the block ids containing the operation if any, None otherwise

pub fn get_blocks_by_endorsement( &self, id: &EndorsementId, ) -> Option<&PreHashSet<BlockId>>

Get the block ids of the blocks containing a given endorsement. Arguments:

• id: the ID of the endorsement

Returns:

• the block ids containing the endorsement if any, None otherwise

Trait Implementations

impl Default for BlockIndexes

fn default() -> BlockIndexes

Returns the “default value” for a type.