feat: add BestTransactions::filter_transactions (#12041)

crates/transaction-pool/src/traits.rs

@@ -761,6 +761,19 @@ pub trait BestTransactions: Iterator + Send {
     ///
     /// If set to true, no blob transactions will be returned.
     fn set_skip_blobs(&mut self, skip_blobs: bool);
+
+    /// Creates an iterator which uses a closure to determine whether a transaction should be
+    /// returned by the iterator.
+    ///
+    /// All items the closure returns false for are marked as invalid via [`Self::mark_invalid`] and
+    /// descendant transactions will be skipped.
+    fn filter_transactions<P>(self, predicate: P) -> BestTransactionFilter<Self, P>
+    where
+        P: FnMut(&Self::Item) -> bool,
+        Self: Sized,
+    {
+        BestTransactionFilter::new(self, predicate)
+    }
 }
 
 impl<T> BestTransactions for Box<T>

crates/transaction-pool/tests/it/best.rs

@@ -0,0 +1,10 @@
+//! Best transaction and filter testing
+
+use reth_transaction_pool::{noop::NoopTransactionPool, BestTransactions, TransactionPool};
+
+#[test]
+fn test_best_transactions() {
+    let noop = NoopTransactionPool::default();
+    let mut best = noop.best_transactions().filter_transactions(|_| true);
+    assert!(best.next().is_none());
+}

crates/transaction-pool/tests/it/main.rs

@@ -9,4 +9,6 @@ mod listeners;
 #[cfg(feature = "test-utils")]
 mod pending;
 
+mod best;
+
 const fn main() {}