Struct FsBlock

pub struct FsBlock {
    pub file: Arc<Mutex<File>>,
    pub start: usize,
    pub end: usize,
    pub hash: BlockHash,
    pub prev: BlockHash,
    pub next: Vec<BlockHash>,
    pub serialization_version: u8,
    /* private fields */
}

Before reorder we keep only the position of the block in the file system and data relative to the block hash, the previous hash and the following hash (populated during reorder phase) We will need to read the block from disk again, but by doing so we will avoid using too much memory in the OutOfOrderBlocks map.

Fields

file: Arc<Mutex<File>>

the file the block identified by hash is stored in. Multiple blocks are stored in the and we don’t want to open/close the file many times for performance reasons so it’s shared. It’s a Mutex to allow to be sent between threads but only one thread (reorder) mutably access to it so there is no contention. (Arc alone isn’t enough cause it can’t be mutated, RefCell can be mutated but not sent between threads)

start: usize

The start position in bytes in the file at which the block identified by hash

end: usize

The end position in bytes in the file at which the block identified by hash

hash: BlockHash

The hash identifying this block, output of block.header.block_hash()

prev: BlockHash

The hash of the block previous to this one, block.header.prev_blockhash

next: Vec<BlockHash>

The hash of the blocks following this one. It is populated during the reorder phase, it can be more than one because of reorgs.

serialization_version: u8

The serialization format to use when trasformed to BlockExtra (0 or 1)

Trait Implementations

impl Debug for FsBlock

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

Formats the value using the given formatter.

impl TryFrom<FsBlock> for BlockExtra

type Error = String

The type returned in the event of a conversion error.

fn try_from(fs_block: FsBlock) -> Result<Self, Self::Error>

Performs the conversion.