Struct jormungandr::blockchain::tip::TipUpdater

pub struct TipUpdater {
    tip: Tip,
    blockchain: Blockchain,
    watch_mbox: Option<MessageBox<WatchMsg>>,
    fragment_mbox: Option<MessageBox<TransactionMsg>>,
    stats_counter: Metrics,
}

Handles updates to the tip. Only one of this structs should be active at any given time.

Fields

tip: Tip

blockchain: Blockchain

watch_mbox: Option<MessageBox<WatchMsg>>

fragment_mbox: Option<MessageBox<TransactionMsg>>

stats_counter: Metrics

Implementations

impl TipUpdater

pub fn new( tip: Tip, blockchain: Blockchain, fragment_mbox: Option<MessageBox<TransactionMsg>>, watch_mbox: Option<MessageBox<WatchMsg>>, stats_counter: Metrics ) -> Self

pub async fn run(&mut self, input: MessageQueue<Arc<Ref>>)

async fn switch_tip_branch( &mut self, candidate: Arc<Ref>, tip_hash: HeaderHash ) -> Result<(), Error>

async fn update_current_branch_tip( &mut self, candidate: Arc<Ref>, block: &Block ) -> Result<(), Error>

pub async fn process_new_ref( &mut self, candidate: Arc<Ref> ) -> Result<(), Error>

process a new candidate block on top of the blockchain, this function may:

• update the current tip if the candidate’s parent is the current tip;

If the current tip is not the one being updated we will then trigger chain selection after updating that other branch as it may be possible that this branch just became more interesting for the current consensus algorithm.

fn try_request_fragment_removal( &mut self, fragment_ids: Vec<FragmentId>, header: &Header ) -> Result<(), TrySendError<TransactionMsg>>

async fn reprocess_tip( blockchain: Blockchain, tip: Arc<Ref>, mbox: MessageBox<Arc<Ref>> ) -> Result<(), Error>

this function will re-process the tip against the different branches. this is because a branch may have become more interesting with time moving forward and branches may have been dismissed

Trait Implementations

impl Clone for TipUpdater

fn clone(&self) -> TipUpdater

Returns a copy of the value.

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

Performs copy-assignment from source.