chore: Move HistoryWriter trait to storage-api and reexport it from old provider crate (#12480)

crates/storage/storage-api/src/history.rs

@@ -0,0 +1,57 @@
+use alloy_primitives::{Address, BlockNumber, B256};
+use auto_impl::auto_impl;
+use reth_db::models::{AccountBeforeTx, BlockNumberAddress};
+use reth_primitives::StorageEntry;
+use reth_storage_errors::provider::ProviderResult;
+use std::ops::{RangeBounds, RangeInclusive};
+
+/// History Writer
+#[auto_impl(&, Arc, Box)]
+pub trait HistoryWriter: Send + Sync {
+    /// Unwind and clear account history indices.
+    ///
+    /// Returns number of changesets walked.
+    fn unwind_account_history_indices<'a>(
+        &self,
+        changesets: impl Iterator<Item = &'a (BlockNumber, AccountBeforeTx)>,
+    ) -> ProviderResult<usize>;
+
+    /// Unwind and clear account history indices in a given block range.
+    ///
+    /// Returns number of changesets walked.
+    fn unwind_account_history_indices_range(
+        &self,
+        range: impl RangeBounds<BlockNumber>,
+    ) -> ProviderResult<usize>;
+
+    /// Insert account change index to database. Used inside AccountHistoryIndex stage
+    fn insert_account_history_index(
+        &self,
+        index_updates: impl IntoIterator<Item = (Address, impl IntoIterator<Item = u64>)>,
+    ) -> ProviderResult<()>;
+
+    /// Unwind and clear storage history indices.
+    ///
+    /// Returns number of changesets walked.
+    fn unwind_storage_history_indices(
+        &self,
+        changesets: impl Iterator<Item = (BlockNumberAddress, StorageEntry)>,
+    ) -> ProviderResult<usize>;
+
+    /// Unwind and clear storage history indices in a given block range.
+    ///
+    /// Returns number of changesets walked.
+    fn unwind_storage_history_indices_range(
+        &self,
+        range: impl RangeBounds<BlockNumberAddress>,
+    ) -> ProviderResult<usize>;
+
+    /// Insert storage change index to database. Used inside StorageHistoryIndex stage
+    fn insert_storage_history_index(
+        &self,
+        storage_transitions: impl IntoIterator<Item = ((Address, B256), impl IntoIterator<Item = u64>)>,
+    ) -> ProviderResult<()>;
+
+    /// Read account/storage changesets and update account/storage history indices.
+    fn update_history_indices(&self, range: RangeInclusive<BlockNumber>) -> ProviderResult<()>;
+}

crates/storage/storage-api/src/lib.rs

@@ -53,3 +53,6 @@ mod database_provider;
 pub use database_provider::*;
 
 pub mod noop;
+
+mod history;
+pub use history::*;