serai/processor/scanner/src/index.rs

use serai_db::{Db, DbTxn};

use primitives::{Id, Block};

// TODO: Localize to IndexDb?
use crate::{db::ScannerDb, ScannerFeed, ContinuallyRan};

/*
  This processor should build its own index of the blockchain, yet only for finalized blocks which
  are safe to process. For Proof of Work blockchains, which only have probabilistic finality, these
  are the set of sufficiently confirmed blocks. For blockchains with finality, these are the
  finalized blocks.

  This task finds the finalized blocks, verifies they're continguous, and saves their IDs.
*/
struct IndexFinalizedTask<D: Db, S: ScannerFeed> {
  db: D,
  feed: S,
}

#[async_trait::async_trait]
impl<D: Db, S: ScannerFeed> ContinuallyRan for IndexFinalizedTask<D, S> {
  async fn run_iteration(&mut self) -> Result<bool, String> {
    // Fetch the latest finalized block
    let our_latest_finalized = ScannerDb::<S>::latest_finalized_block(&self.db)
      .expect("IndexTask run before writing the start block");
    let latest_finalized = match self.feed.latest_finalized_block_number().await {
      Ok(latest_finalized) => latest_finalized,
      Err(e) => Err(format!("couldn't fetch the latest finalized block number: {e:?}"))?,
    };

    if latest_finalized < our_latest_finalized {
      // Explicitly log this as an error as returned ephemeral errors are logged with debug
      // This doesn't panic as the node should sync along our indexed chain, and if it doesn't,
      // we'll panic at that point in time
      log::error!(
        "node is out of sync, latest finalized {} is behind our indexed {}",
        latest_finalized,
        our_latest_finalized
      );
      Err("node is out of sync".to_string())?;
    }

    // Index the hashes of all blocks until the latest finalized block
    for b in (our_latest_finalized + 1) ..= latest_finalized {
      let block = match self.feed.block_by_number(b).await {
        Ok(block) => block,
        Err(e) => Err(format!("couldn't fetch block {b}: {e:?}"))?,
      };

      // Check this descends from our indexed chain
      {
        let expected_parent =
          ScannerDb::<S>::block_id(&self.db, b - 1).expect("didn't have the ID of the prior block");
        if block.parent() != expected_parent {
          panic!(
            "current finalized block (#{b}, {}) doesn't build off finalized block (#{}, {})",
            hex::encode(block.parent()),
            b - 1,
            hex::encode(expected_parent)
          );
        }
      }

      // Update the latest finalized block
      let mut txn = self.db.txn();
      ScannerDb::<S>::set_block(&mut txn, b, block.id());
      ScannerDb::<S>::set_latest_finalized_block(&mut txn, b);
      txn.commit();
    }

    // Have dependents run if we updated the latest finalized block
    Ok(our_latest_finalized != latest_finalized)
  }
}