Struct Tracker 

pub struct Tracker { /* private fields */ }

A host’s tracked transactions, with indexes for targeted chain events. Hints, ages and spend attempts name one transaction. A tip uses only the suspect set; reorgs, forks and splits use only the relevant mined height range.

Implementations

impl Tracker

pub fn new(params: Params) -> Self

An empty host registry with explicit age parameters.

pub fn track(&mut self, txid: impl Into<TxId>) -> &State

Begin tracking one transaction; repeating this does not erase its state.

pub fn restore(&mut self, state: State) -> Option<State>

Hold a state restored by State::from_compact and index it as a transition would; a restored mined word joins the suspect set, so the next tip rechecks it. The state it replaces, if the txid was tracked.

pub fn get(&self, txid: &str) -> Option<&State>

An immutable state, or none when the host does not track this txid.

pub fn len(&self) -> usize

Number of transactions this host tracks.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

pub fn apply<H: Headers + ?Sized>( &mut self, txid: &str, headers: &H, input: Input, ) -> Result<(), CheckError>

Apply an input to one transaction and maintain the event indexes, including after a failed proof or header lookup.

Errors

The CheckError of State::step for that transaction.

pub fn on_chain<H: Headers + ?Sized>( &mut self, headers: &H, event: ChainEvent, ) -> Vec<ChainUpdate>

Deliver an evidence event only to the set it names. The output contains every selected txid and each fault for the host to report.

The selection is the bound of the recheck, never the stale mark: a reorg names the mined words at or above its fork height and an invalidation the words checked against its block, and each is rechecked against headers by its stored root. Only a word whose root moved comes back with Reask::Reorg; a host fetches proofs for those alone, a few a pass, the pacing being the host’s.

Trait Implementations

impl Clone for Tracker

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tracker

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

Formats the value using the given formatter.