use crate::chunked_iter::ChunkedVectorIter; use crate::chunked_vector::BlockRoots; use crate::errors::{Error, Result}; use crate::iter::BlockRootsIterator; use crate::{HotColdDB, Store}; use itertools::process_results; use std::sync::Arc; use types::{BeaconState, ChainSpec, EthSpec, Hash256, Slot}; /// Forwards block roots iterator that makes use of the `block_roots` table in the freezer DB. pub struct FrozenForwardsBlockRootsIterator { inner: ChunkedVectorIter, } /// Forwards block roots iterator that reverses a backwards iterator (only good for short ranges). pub struct SimpleForwardsBlockRootsIterator { // Values from the backwards iterator (in slot descending order) values: Vec<(Hash256, Slot)>, } /// Fusion of the above two approaches to forwards iteration. Fast and efficient. pub enum HybridForwardsBlockRootsIterator { PreFinalization { iter: Box>, /// Data required by the `PostFinalization` iterator when we get to it. continuation_data: Box, Hash256)>>, }, PostFinalization { iter: SimpleForwardsBlockRootsIterator, }, } impl FrozenForwardsBlockRootsIterator { pub fn new( store: Arc>, start_slot: Slot, last_restore_point_slot: Slot, spec: &ChainSpec, ) -> Self { Self { inner: ChunkedVectorIter::new( store, start_slot.as_usize(), last_restore_point_slot, spec, ), } } } impl Iterator for FrozenForwardsBlockRootsIterator { type Item = (Hash256, Slot); fn next(&mut self) -> Option { self.inner .next() .map(|(slot, block_hash)| (block_hash, Slot::from(slot))) } } impl SimpleForwardsBlockRootsIterator { pub fn new, E: EthSpec>( store: Arc, start_slot: Slot, end_state: BeaconState, end_block_root: Hash256, ) -> Result { // Iterate backwards from the end state, stopping at the start slot. let values = process_results( std::iter::once(Ok((end_block_root, end_state.slot))) .chain(BlockRootsIterator::owned(store, end_state)), |iter| { iter.take_while(|(_, slot)| *slot >= start_slot) .collect::>() }, )?; Ok(Self { values: values }) } } impl Iterator for SimpleForwardsBlockRootsIterator { type Item = Result<(Hash256, Slot)>; fn next(&mut self) -> Option { // Pop from the end of the vector to get the block roots in slot-ascending order. Ok(self.values.pop()).transpose() } } impl HybridForwardsBlockRootsIterator { pub fn new( store: Arc>, start_slot: Slot, end_state: BeaconState, end_block_root: Hash256, spec: &ChainSpec, ) -> Result { use HybridForwardsBlockRootsIterator::*; let latest_restore_point_slot = store.get_latest_restore_point_slot(); let result = if start_slot < latest_restore_point_slot { PreFinalization { iter: Box::new(FrozenForwardsBlockRootsIterator::new( store, start_slot, latest_restore_point_slot, spec, )), continuation_data: Box::new(Some((end_state, end_block_root))), } } else { PostFinalization { iter: SimpleForwardsBlockRootsIterator::new( store, start_slot, end_state, end_block_root, )?, } }; Ok(result) } fn do_next(&mut self) -> Result> { use HybridForwardsBlockRootsIterator::*; match self { PreFinalization { iter, continuation_data, } => { match iter.next() { Some(x) => Ok(Some(x)), // Once the pre-finalization iterator is consumed, transition // to a post-finalization iterator beginning from the last slot // of the pre iterator. None => { let (end_state, end_block_root) = continuation_data.take().ok_or(Error::NoContinuationData)?; *self = PostFinalization { iter: SimpleForwardsBlockRootsIterator::new( iter.inner.store.clone(), Slot::from(iter.inner.end_vindex), end_state, end_block_root, )?, }; self.do_next() } } } PostFinalization { iter } => iter.next().transpose(), } } } impl Iterator for HybridForwardsBlockRootsIterator { type Item = Result<(Hash256, Slot)>; fn next(&mut self) -> Option { self.do_next().transpose() } }