Struct grin_chain::store::Batch

pub struct Batch<'a> { /* fields omitted */ }

An atomic batch in which all changes can be committed all at once or discarded on error.

Methods

impl<'a> Batch<'a>

pub fn head(&self) -> Result<Tip, Error>

The head.

pub fn tail(&self) -> Result<Tip, Error>

The tail.

pub fn head_header(&self) -> Result<BlockHeader, Error>

Header of the block at the head of the block chain (not the same thing as header_head).

pub fn header_head(&self) -> Result<Tip, Error>

Head of the header chain (not the same thing as head_header).

pub fn get_sync_head(&self) -> Result<Tip, Error>

Get "sync" head.

pub fn save_body_head(&self, t: &Tip) -> Result<(), Error>

Save body head to db.

pub fn save_body_tail(&self, t: &Tip) -> Result<(), Error>

Save body "tail" to db.

pub fn save_header_head(&self, t: &Tip) -> Result<(), Error>

Save header_head to db.

pub fn save_sync_head(&self, t: &Tip) -> Result<(), Error>

Save "sync" head to db.

pub fn reset_sync_head(&self) -> Result<(), Error>

Reset sync_head to the current head of the header chain.

pub fn reset_header_head(&self) -> Result<(), Error>

Reset header_head to the current head of the body chain.

pub fn get_block(&self, h: &Hash) -> Result<Block, Error>

get block

pub fn block_exists(&self, h: &Hash) -> Result<bool, Error>

Does the block exist?

pub fn save_block(&self, b: &Block) -> Result<(), Error>

Save the block and the associated input bitmap. Note: the block header is not saved to the db here, assumes this has already been done.

pub fn migrate_block(
    &self,
    b: &Block,
    version: ProtocolVersion
) -> Result<(), Error>

Migrate a block stored in the db by serializing it using the provided protocol version. Block may have been read using a previous protocol version but we do not actually care.

pub fn delete_block(&self, bh: &Hash) -> Result<(), Error>

Delete a full block. Does not delete any record associated with a block header.

pub fn save_block_header(&self, header: &BlockHeader) -> Result<(), Error>

Save block header to db.

pub fn save_output_pos_height(
    &self,
    commit: &Commitment,
    pos: u64,
    height: u64
) -> Result<(), Error>

Save output_pos and block height to index.

pub fn get_output_pos(&self, commit: &Commitment) -> Result<u64, Error>

Get output_pos from index. Note: - Original prefix 'COMMIT_POS_PREFIX' is not used for normal case anymore, refer to #2889 for detail. - To be compatible with the old callers, let's keep this function name but replace with new prefix 'COMMIT_POS_HGT_PREFIX'

pub fn get_output_pos_height(
    &self,
    commit: &Commitment
) -> Result<(u64, u64), Error>

Get output_pos and block height from index.

pub fn clear_output_pos(&self) -> Result<(), Error>

Clear all entries from the output_pos index. (only for migration purpose)

pub fn clear_output_pos_height(&self) -> Result<(), Error>

Clear all entries from the (output_pos,height) index (must be rebuilt after).

pub fn get_previous_header(
    &self,
    header: &BlockHeader
) -> Result<BlockHeader, Error>

Get the previous header.

pub fn get_block_header(&self, h: &Hash) -> Result<BlockHeader, Error>

Get block header.

pub fn save_block_sums(&self, h: &Hash, sums: &BlockSums) -> Result<(), Error>

Save block_sums for the block.

pub fn get_block_sums(&self, h: &Hash) -> Result<BlockSums, Error>

Get block_sums for the block.

pub fn get_block_input_bitmap(&self, bh: &Hash) -> Result<Bitmap, Error>

Get the block input bitmap from the db or build the bitmap from the full block from the db (if the block is found).

pub fn commit(self) -> Result<(), Error>

Commits this batch. If it's a child batch, it will be merged with the parent, otherwise the batch is written to db.

pub fn child(&mut self) -> Result<Batch, Error>

Creates a child of this batch. It will be merged with its parent on commit, abandoned otherwise.

pub fn blocks_iter(&self) -> Result<SerIterator<Block>, Error>

An iterator to all block in db