Function cuprate_blockchain::ops::alt_block::update_alt_chain_info

source · 
pub fn update_alt_chain_info(
    alt_block_height: &AltBlockHeight,
    prev_hash: &BlockHash,
    tables: &mut impl TablesMut,
) -> Result<(), RuntimeError>
Expand description

Updates the AltChainInfo with information on a new alt-block.

§⚠️ Invariant ⚠️

This function mainly exists to be used internally by the parent function crate::ops::alt_block::add_alt_block.

add_alt_block() makes sure all data related to the input is mutated, while this function does not, it specifically mutates particular tables.

This is usually undesired - although this function is still available to call directly.

When calling this function, ensure that either:

  1. This effect (incomplete database mutation) is what is desired, or that…
  2. …the other tables will also be mutated to a correct state

§Errors

This function returns RuntimeError::KeyNotFound if the input (if applicable) doesn’t exist or other RuntimeError’s on database errors.

§Panics

This will panic if AltBlockHeight::height == 0.