Revalidation queue for transaction pool (#4781)

* Revalidation queeue.

* add docs and license

* move test

* refactor worker to async/await

* address review

* fix warnings

* update Cargo.lock

* move background task to service

* use tomusdrw loop

* naming

* return From::from

* add doc comment

* add more doc comments

* fix merge bug

* add doc comment for test function

* Update client/transaction-pool/src/testing/pool.rs

Co-Authored-By: Tomasz Drwięga <tomusdrw@users.noreply.github.com>

* more review fixes

* refactor to allow service keep background tasks from isntantiated subsystems

* use const delay

* fix fallout

* remove fallout

* remove already moved test

* fix doc test

* add valid_at helper

Co-authored-by: Tomasz Drwięga <tomusdrw@users.noreply.github.com>

substrate/client/transaction-pool/src/lib.rs

@@ -21,6 +21,7 @@
 
 mod api;
 pub mod error;
+mod revalidation;
 
 #[cfg(any(feature = "test-helpers", test))]
 pub mod testing;
@@ -51,6 +52,7 @@ pub struct BasicPool<PoolApi, Block>
 	pool: Arc<sc_transaction_graph::Pool<PoolApi>>,
 	api: Arc<PoolApi>,
 	revalidation_strategy: Arc<Mutex<RevalidationStrategy<NumberFor<Block>>>>,
+	revalidation_queue: Arc<revalidation::RevalidationQueue<PoolApi>>,
 }
 
 #[cfg(not(target_os = "unknown"))]
@@ -86,13 +88,16 @@ pub enum RevalidationType {
 impl<PoolApi, Block> BasicPool<PoolApi, Block>
 	where
 		Block: BlockT,
-		PoolApi: sc_transaction_graph::ChainApi<Block=Block, Hash=Block::Hash>,
+		PoolApi: sc_transaction_graph::ChainApi<Block=Block, Hash=Block::Hash> + 'static,
 {
 	/// Create new basic transaction pool with provided api.
+	///
+	/// It will also optionally return background task that might be started by the
+	/// caller.
 	pub fn new(
 		options: sc_transaction_graph::Options,
 		pool_api: Arc<PoolApi>,
-	) -> Self {
+	) -> (Self, Option<Pin<Box<dyn Future<Output=()> + Send>>>) {
 		Self::with_revalidation_type(options, pool_api, RevalidationType::Full)
 	}
 
@@ -102,18 +107,29 @@ impl<PoolApi, Block> BasicPool<PoolApi, Block>
 		options: sc_transaction_graph::Options,
 		pool_api: Arc<PoolApi>,
 		revalidation_type: RevalidationType,
-	) -> Self {
-		let cloned_api = pool_api.clone();
-		BasicPool {
-			api: cloned_api,
-			pool: Arc::new(sc_transaction_graph::Pool::new(options, pool_api)),
-			revalidation_strategy: Arc::new(Mutex::new(
-				match revalidation_type {
-					RevalidationType::Light => RevalidationStrategy::Light(RevalidationStatus::NotScheduled),
-					RevalidationType::Full => RevalidationStrategy::Always,
-				}
-			)),
-		}
+	) -> (Self, Option<Pin<Box<dyn Future<Output=()> + Send>>>) {
+		let pool = Arc::new(sc_transaction_graph::Pool::new(options, pool_api.clone()));
+		let (revalidation_queue, background_task) = match revalidation_type {
+			RevalidationType::Light => (revalidation::RevalidationQueue::new(pool_api.clone(), pool.clone()), None),
+			RevalidationType::Full => {
+				let (queue, background) = revalidation::RevalidationQueue::new_background(pool_api.clone(), pool.clone());
+				(queue, Some(background))
+			},
+		};
+		(
+			BasicPool {
+				api: pool_api,
+				pool,
+				revalidation_queue: Arc::new(revalidation_queue),
+				revalidation_strategy: Arc::new(Mutex::new(
+					match revalidation_type {
+						RevalidationType::Light => RevalidationStrategy::Light(RevalidationStatus::NotScheduled),
+						RevalidationType::Full => RevalidationStrategy::Always,
+					}
+				)),
+			},
+			background_task,
+		)
 	}
 
 	/// Gets shared reference to the underlying pool.
@@ -218,7 +234,6 @@ enum RevalidationStrategy<N> {
 struct RevalidationAction {
 	revalidate: bool,
 	resubmit: bool,
-	revalidate_amount: Option<usize>,
 }
 
 impl<N: Clone + Copy + AtLeast32Bit> RevalidationStrategy<N> {
@@ -242,12 +257,10 @@ impl<N: Clone + Copy + AtLeast32Bit> RevalidationStrategy<N> {
 					revalidate_block_period,
 				),
 				resubmit: false,
-				revalidate_amount: None,
 			},
 			Self::Always => RevalidationAction {
 				revalidate: true,
 				resubmit: true,
-				revalidate_amount: Some(16),
 			}
 		}
 	}
@@ -314,6 +327,7 @@ impl<PoolApi, Block> MaintainedTransactionPool for BasicPool<PoolApi, Block>
 				);
 				let revalidation_strategy = self.revalidation_strategy.clone();
 				let retracted = retracted.clone();
+				let revalidation_queue = self.revalidation_queue.clone();
 
 				async move {
 					// We don't query block if we won't prune anything
@@ -360,9 +374,8 @@ impl<PoolApi, Block> MaintainedTransactionPool for BasicPool<PoolApi, Block>
 					}
 
 					if next_action.revalidate {
-						if let Err(e) = pool.revalidate_ready(&id, next_action.revalidate_amount).await {
-							log::warn!("Revalidate ready failed {:?}", e);
-						}
+						let hashes = pool.validated_pool().ready().map(|tx| tx.hash.clone()).collect();
+						revalidation_queue.revalidate_later(block_number, hashes).await;
 					}
 
 					revalidation_strategy.lock().clear();

substrate/client/transaction-pool/src/revalidation.rs

@@ -0,0 +1,313 @@
+// Copyright 2018-2020 Parity Technologies (UK) Ltd.
+// This file is part of Substrate.
+
+// Substrate is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// Substrate is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+
+// You should have received a copy of the GNU General Public License
+// along with Substrate.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Pool periodic revalidation.
+
+use std::{sync::Arc, pin::Pin, collections::{HashMap, HashSet, BTreeMap}};
+
+use sc_transaction_graph::{ChainApi, Pool, ExHash, NumberFor, ValidatedTransaction};
+use sp_runtime::traits::{Zero, SaturatedConversion};
+use sp_runtime::generic::BlockId;
+use sp_runtime::transaction_validity::TransactionValidityError;
+
+use futures::{prelude::*, channel::mpsc, stream::unfold};
+use std::time::Duration;
+use futures_timer::Delay;
+
+#[cfg(not(test))]
+const BACKGROUND_REVALIDATION_INTERVAL: Duration = Duration::from_millis(200);
+#[cfg(test)]
+pub const BACKGROUND_REVALIDATION_INTERVAL: Duration = Duration::from_millis(5);
+
+const BACKGROUND_REVALIDATION_BATCH_SIZE: usize = 20;
+
+/// Payload from queue to worker.
+struct WorkerPayload<Api: ChainApi> {
+	at: NumberFor<Api>,
+	transactions: Vec<ExHash<Api>>,
+}
+
+/// Async revalidation worker.
+///
+/// Implements future and can be spawned in place or in background.
+struct RevalidationWorker<Api: ChainApi> {
+	api: Arc<Api>,
+	pool: Arc<Pool<Api>>,
+	best_block: NumberFor<Api>,
+	block_ordered: BTreeMap<NumberFor<Api>, HashSet<ExHash<Api>>>,
+	members: HashMap<ExHash<Api>, NumberFor<Api>>,
+}
+
+impl<Api: ChainApi> Unpin for RevalidationWorker<Api> {}
+
+fn interval(duration: Duration) -> impl Stream<Item=()> + Unpin {
+	unfold((), move |_| {
+		Delay::new(duration).map(|_| Some(((), ())))
+	}).map(drop)
+}
+
+/// Revalidate batch of transaction.
+///
+/// Each transaction is validated  against chain, and invalid are
+/// removed from the `pool`, while valid are resubmitted.
+async fn batch_revalidate<Api: ChainApi>(
+	pool: Arc<Pool<Api>>,
+	api: Arc<Api>,
+	at: NumberFor<Api>,
+	batch: impl IntoIterator<Item=ExHash<Api>>,
+) {
+	let mut invalid_hashes = Vec::new();
+	let mut revalidated = HashMap::new();
+
+	for ext_hash in batch {
+		let ext = match pool.validated_pool().ready_by_hash(&ext_hash) {
+			Some(ext) => ext,
+			None => continue,
+		};
+
+		match api.validate_transaction(&BlockId::Number(at), ext.data.clone()).await {
+			Ok(Err(TransactionValidityError::Invalid(err))) => {
+				log::debug!(target: "txpool", "[{:?}]: Revalidation: invalid {:?}", ext_hash, err);
+				invalid_hashes.push(ext_hash);
+			},
+			Ok(Err(TransactionValidityError::Unknown(err))) => {
+				// skipping unknown, they might be pushed by valid or invalid transaction
+				// when latter resubmitted.
+				log::trace!(target: "txpool", "[{:?}]: Unknown during revalidation: {:?}", ext_hash, err);
+			},
+			Ok(Ok(validity)) => {
+				revalidated.insert(
+					ext_hash.clone(),
+					ValidatedTransaction::valid_at(
+						at.saturated_into::<u64>(),
+						ext_hash,
+						ext.data.clone(),
+						api.hash_and_length(&ext.data).1,
+						validity,
+					)
+				);
+			},
+			Err(validation_err) => {
+				log::debug!(
+					target: "txpool",
+					"[{:?}]: Error during revalidation: {:?}. Removing.",
+					ext_hash,
+					validation_err
+				);
+				invalid_hashes.push(ext_hash);
+			}
+		}
+	}
+
+	pool.validated_pool().remove_invalid(&invalid_hashes);
+	pool.resubmit(revalidated);
+}
+
+impl<Api: ChainApi> RevalidationWorker<Api> {
+	fn new(
+		api: Arc<Api>,
+		pool: Arc<Pool<Api>>,
+	) -> Self {
+		Self {
+			api,
+			pool,
+			block_ordered: Default::default(),
+			members: Default::default(),
+			best_block: Zero::zero(),
+		}
+	}
+
+	fn prepare_batch(&mut self) -> Vec<ExHash<Api>> {
+		let mut queued_exts = Vec::new();
+		let mut left = BACKGROUND_REVALIDATION_BATCH_SIZE;
+
+		// Take maximum of count transaction by order
+		// which they got into the pool
+		while left > 0 {
+			let first_block = match self.block_ordered.keys().next().cloned() {
+			  Some(bn) => bn,
+			  None => break,
+			};
+			let mut block_drained = false;
+			if let Some(extrinsics) = self.block_ordered.get_mut(&first_block) {
+				let to_queue = extrinsics.iter().take(left).cloned().collect::<Vec<_>>();
+				if to_queue.len() == extrinsics.len() {
+				   block_drained = true;
+				} else {
+					for xt in &to_queue {
+						extrinsics.remove(xt);
+					}
+				}
+				left -= to_queue.len();
+				queued_exts.extend(to_queue);
+			}
+
+			if block_drained {
+			  self.block_ordered.remove(&first_block);
+			}
+		}
+
+		queued_exts
+	}
+
+	fn push(&mut self, worker_payload: WorkerPayload<Api>) {
+		// we don't add something that already scheduled for revalidation
+		let transactions = worker_payload.transactions;
+		let block_number = worker_payload.at;
+
+		for ext_hash in transactions {
+			// we don't add something that already scheduled for revalidation
+			if self.members.contains_key(&ext_hash) { continue; }
+
+			self.block_ordered.entry(block_number)
+				.and_modify(|value| { value.insert(ext_hash.clone()); })
+				.or_insert_with(|| {
+					let mut bt = HashSet::new();
+					bt.insert(ext_hash.clone());
+					bt
+				});
+			self.members.insert(ext_hash.clone(), block_number);
+		}
+	}
+
+	/// Background worker main loop.
+	///
+	/// It does two things: periodically tries to process some transactions
+	/// from the queue and also accepts messages to enqueue some more
+	/// transactions from the pool.
+	pub async fn run(mut self, from_queue: mpsc::UnboundedReceiver<WorkerPayload<Api>>) {
+		let interval = interval(BACKGROUND_REVALIDATION_INTERVAL).fuse();
+		let from_queue = from_queue.fuse();
+		futures::pin_mut!(interval, from_queue);
+		let this = &mut self;
+
+		loop {
+			futures::select! {
+				_ = interval.next() => {
+					let next_batch = this.prepare_batch();
+					batch_revalidate(this.pool.clone(), this.api.clone(), this.best_block, next_batch).await;
+				},
+				workload = from_queue.next() => {
+					match workload {
+						Some(worker_payload) => {
+							this.best_block = worker_payload.at;
+							this.push(worker_payload);
+							continue;
+						},
+						// R.I.P. worker!
+						None => break,
+					}
+				}
+			}
+		}
+	}
+}
+
+
+/// Revalidation queue.
+///
+/// Can be configured background (`new_background`)
+/// or immediate (just `new`).
+pub struct RevalidationQueue<Api: ChainApi> {
+	pool: Arc<Pool<Api>>,
+	api: Arc<Api>,
+	background: Option<mpsc::UnboundedSender<WorkerPayload<Api>>>,
+}
+
+impl<Api: ChainApi> RevalidationQueue<Api>
+where
+	Api: 'static,
+{
+	/// New revalidation queue without background worker.
+	pub fn new(api: Arc<Api>, pool: Arc<Pool<Api>>) -> Self {
+		Self {
+			api,
+			pool,
+			background: None,
+		}
+	}
+
+	/// New revalidation queue with background worker.
+	pub fn new_background(api: Arc<Api>, pool: Arc<Pool<Api>>) ->
+		(Self, Pin<Box<dyn Future<Output=()> + Send>>)
+	{
+		let (to_worker, from_queue) = mpsc::unbounded();
+
+		let worker = RevalidationWorker::new(api.clone(), pool.clone());
+
+		let queue =
+			Self {
+				api,
+				pool,
+				background: Some(to_worker),
+			};
+
+		(queue, worker.run(from_queue).boxed())
+	}
+
+	/// Queue some transaction for later revalidation.
+	///
+	/// If queue configured with background worker, this will return immediately.
+	/// If queue configured without background worker, this will resolve after
+	/// revalidation is actually done.
+	pub async fn revalidate_later(&self, at: NumberFor<Api>, transactions: Vec<ExHash<Api>>) {
+		if let Some(ref to_worker) = self.background {
+			if let Err(e) = to_worker.unbounded_send(WorkerPayload { at, transactions }) {
+				log::warn!(target: "txpool", "Failed to update background worker: {:?}", e);
+			}
+			return;
+		} else {
+			let pool = self.pool.clone();
+			let api = self.api.clone();
+			batch_revalidate(pool, api, at, transactions).await
+		}
+	}
+}
+
+#[cfg(test)]
+mod tests {
+
+	use super::*;
+	use sc_transaction_graph::Pool;
+	use substrate_test_runtime_transaction_pool::{TestApi, uxt};
+	use futures::executor::block_on;
+	use substrate_test_runtime_client::{
+		AccountKeyring::*,
+	};
+
+	fn setup() -> (Arc<TestApi>, Pool<TestApi>) {
+		let test_api = Arc::new(TestApi::empty());
+		let pool = Pool::new(Default::default(), test_api.clone());
+		(test_api, pool)
+	}
+
+	#[test]
+	fn smoky() {
+		let (api, pool) = setup();
+		let pool = Arc::new(pool);
+		let queue = Arc::new(RevalidationQueue::new(api.clone(), pool.clone()));
+
+		let uxt = uxt(Alice, 0);
+		let uxt_hash = block_on(pool.submit_one(&BlockId::number(0), uxt.clone())).expect("Should be valid");
+
+		block_on(queue.revalidate_later(0, vec![uxt_hash]));
+
+		// revalidated in sync offload 2nd time
+		assert_eq!(api.validation_requests().len(), 2);
+		// number of ready
+		assert_eq!(pool.validated_pool().status().ready, 1);
+	}
+}

substrate/client/transaction-pool/src/testing/pool.rs

@@ -15,6 +15,7 @@
 // along with Substrate.  If not, see <http://www.gnu.org/licenses/>.
 
 use crate::*;
+use sp_transaction_pool::TransactionStatus;
 use futures::executor::block_on;
 use txpool::{self, Pool};
 use sp_runtime::{
@@ -22,18 +23,22 @@ use sp_runtime::{
 	transaction_validity::ValidTransaction,
 };
 use substrate_test_runtime_client::{
-	runtime::{Block, Hash, Index, Header},
+	runtime::{Block, Hash, Index, Header, Extrinsic},
 	AccountKeyring::*,
 };
 use substrate_test_runtime_transaction_pool::{TestApi, uxt};
-use sp_transaction_pool::TransactionStatus;
+use crate::revalidation::BACKGROUND_REVALIDATION_INTERVAL;
 
 fn pool() -> Pool<TestApi> {
 	Pool::new(Default::default(), TestApi::with_alice_nonce(209).into())
 }
 
-fn maintained_pool() -> BasicPool<TestApi, Block> {
-	BasicPool::new(Default::default(), std::sync::Arc::new(TestApi::with_alice_nonce(209)))
+fn maintained_pool() -> (BasicPool<TestApi, Block>, futures::executor::ThreadPool) {
+	let (pool, background_task) = BasicPool::new(Default::default(), std::sync::Arc::new(TestApi::with_alice_nonce(209)));
+
+	let thread_pool = futures::executor::ThreadPool::new().unwrap();
+	thread_pool.spawn_ok(background_task.expect("basic pool have background task"));
+	(pool, thread_pool)
 }
 
 fn header(number: u64) -> Header {
@@ -158,25 +163,37 @@ fn should_correctly_prune_transactions_providing_more_than_one_tag() {
 	assert_eq!(pool.validated_pool().status().future, 2);
 }
 
+fn block_event(id: u64) -> ChainEvent<Block> {
+	ChainEvent::NewBlock {
+		id: BlockId::number(id),
+		is_new_best: true,
+		retracted: vec![],
+		header: header(id),
+	}
+}
+
+fn block_event_with_retracted(id: u64, retracted: Vec<Hash>) -> ChainEvent<Block> {
+	ChainEvent::NewBlock {
+		id: BlockId::number(id),
+		is_new_best: true,
+		retracted: retracted,
+		header: header(id),
+	}
+}
+
+
 #[test]
 fn should_prune_old_during_maintenance() {
 	let xt = uxt(Alice, 209);
 
-	let pool = maintained_pool();
+	let (pool, _guard) = maintained_pool();
 
 	block_on(pool.submit_one(&BlockId::number(0), xt.clone())).expect("1. Imported");
 	assert_eq!(pool.status().ready, 1);
 
 	pool.api.push_block(1, vec![xt.clone()]);
 
-	let event = ChainEvent::NewBlock {
-		id: BlockId::number(1),
-		is_new_best: true,
-		retracted: vec![],
-		header: header(1),
-	};
-
-	block_on(pool.maintain(event));
+	block_on(pool.maintain(block_event(1)));
 	assert_eq!(pool.status().ready, 0);
 }
 
@@ -185,21 +202,20 @@ fn should_revalidate_during_maintenance() {
 	let xt1 = uxt(Alice, 209);
 	let xt2 = uxt(Alice, 210);
 
-	let pool = maintained_pool();
+	let (pool, _guard) = maintained_pool();
 	block_on(pool.submit_one(&BlockId::number(0), xt1.clone())).expect("1. Imported");
 	block_on(pool.submit_one(&BlockId::number(0), xt2.clone())).expect("2. Imported");
 	assert_eq!(pool.status().ready, 2);
 	assert_eq!(pool.api.validation_requests().len(), 2);
 
 	pool.api.push_block(1, vec![xt1.clone()]);
-	let event = ChainEvent::NewBlock {
-		id: BlockId::number(1),
-		is_new_best: true,
-		retracted: vec![],
-		header: header(1),
-	};
 
-	block_on(pool.maintain(event));
+	block_on(pool.maintain(block_event(1)));
+
+	// maintaince is in background
+	block_on(futures_timer::Delay::new(BACKGROUND_REVALIDATION_INTERVAL*2));
+
+	block_on(pool.maintain(block_event(1)));
 	assert_eq!(pool.status().ready, 1);
 	// test that pool revalidated transaction that left ready and not included in the block
 	assert_eq!(pool.api.validation_requests().len(), 3);
@@ -210,19 +226,15 @@ fn should_resubmit_from_retracted_during_maintaince() {
 	let xt = uxt(Alice, 209);
 	let retracted_hash = Hash::random();
 
-	let pool = maintained_pool();
+	let (pool, _guard) = maintained_pool();
 
 	block_on(pool.submit_one(&BlockId::number(0), xt.clone())).expect("1. Imported");
 	assert_eq!(pool.status().ready, 1);
 
 	pool.api.push_block(1, vec![]);
 	pool.api.push_fork_block(retracted_hash, vec![xt.clone()]);
-	let event = ChainEvent::NewBlock {
-		id: BlockId::Number(1),
-		is_new_best: true,
-		header: header(1),
-		retracted: vec![retracted_hash]
-	};
+
+	let event = block_event_with_retracted(1, vec![retracted_hash]);
 
 	block_on(pool.maintain(event));
 	assert_eq!(pool.status().ready, 1);
@@ -233,7 +245,7 @@ fn should_not_retain_invalid_hashes_from_retracted() {
 	let xt = uxt(Alice, 209);
 	let retracted_hash = Hash::random();
 
-	let pool = maintained_pool();
+	let (pool, _guard) = maintained_pool();
 
 	block_on(pool.submit_one(&BlockId::number(0), xt.clone())).expect("1. Imported");
 	assert_eq!(pool.status().ready, 1);
@@ -242,20 +254,90 @@ fn should_not_retain_invalid_hashes_from_retracted() {
 	pool.api.push_fork_block(retracted_hash, vec![xt.clone()]);
 	pool.api.add_invalid(&xt);
 
-	let event = ChainEvent::NewBlock {
-		id: BlockId::Number(1),
-		is_new_best: true,
-		header: header(1),
-		retracted: vec![retracted_hash]
-	};
+	let event = block_event_with_retracted(1, vec![retracted_hash]);
+
+	block_on(pool.maintain(event));
+
+	// maintenance is in background
+	block_on(futures_timer::Delay::new(BACKGROUND_REVALIDATION_INTERVAL*2));
+
+	let event = block_event_with_retracted(1, vec![retracted_hash]);
 
 	block_on(pool.maintain(event));
 	assert_eq!(pool.status().ready, 0);
 }
 
+#[test]
+fn should_push_watchers_during_maintaince() {
+	fn alice_uxt(nonce: u64) -> Extrinsic {
+		uxt(Alice, 209 + nonce)
+	}
+
+	// given
+	let (pool, _guard) = maintained_pool();
+
+	let tx0 = alice_uxt(0);
+	let watcher0 = block_on(pool.submit_and_watch(&BlockId::Number(0), tx0.clone())).unwrap();
+	let tx1 = alice_uxt(1);
+	let watcher1 = block_on(pool.submit_and_watch(&BlockId::Number(0), tx1.clone())).unwrap();
+	let tx2 = alice_uxt(2);
+	let watcher2 = block_on(pool.submit_and_watch(&BlockId::Number(0), tx2.clone())).unwrap();
+	let tx3 = alice_uxt(3);
+	let watcher3 = block_on(pool.submit_and_watch(&BlockId::Number(0), tx3.clone())).unwrap();
+	let tx4 = alice_uxt(4);
+	let watcher4 = block_on(pool.submit_and_watch(&BlockId::Number(0), tx4.clone())).unwrap();
+	assert_eq!(pool.status().ready, 5);
+
+	// when
+	pool.api.add_invalid(&tx3);
+	pool.api.add_invalid(&tx4);
+	block_on(pool.maintain(block_event(0)));
+
+	// revalidation is in background
+	block_on(futures_timer::Delay::new(BACKGROUND_REVALIDATION_INTERVAL*2));
+
+	// then
+	// hash3 is now invalid
+	// hash4 is now invalid
+
+	assert_eq!(pool.status().ready, 3);
+	assert_eq!(
+		futures::executor::block_on_stream(watcher3).collect::<Vec<_>>(),
+		vec![TransactionStatus::Ready, TransactionStatus::Invalid],
+	);
+	assert_eq!(
+		futures::executor::block_on_stream(watcher4).collect::<Vec<_>>(),
+		vec![TransactionStatus::Ready, TransactionStatus::Invalid],
+	);
+
+	// when
+	let header_hash = pool.api.push_block(1, vec![tx0, tx1, tx2]).hash();
+	block_on(pool.maintain(block_event(1)));
+
+	let event = ChainEvent::Finalized { hash: header_hash.clone() };
+	block_on(pool.maintain(event));
+
+	// then
+	// events for hash0 are: Ready, InBlock
+	// events for hash1 are: Ready, InBlock
+	// events for hash2 are: Ready, InBlock
+	assert_eq!(
+		futures::executor::block_on_stream(watcher0).collect::<Vec<_>>(),
+		vec![TransactionStatus::Ready, TransactionStatus::InBlock(header_hash.clone()), TransactionStatus::Finalized(header_hash.clone())],
+	);
+	assert_eq!(
+		futures::executor::block_on_stream(watcher1).collect::<Vec<_>>(),
+		vec![TransactionStatus::Ready, TransactionStatus::InBlock(header_hash.clone()), TransactionStatus::Finalized(header_hash.clone())],
+	);
+	assert_eq!(
+		futures::executor::block_on_stream(watcher2).collect::<Vec<_>>(),
+		vec![TransactionStatus::Ready, TransactionStatus::InBlock(header_hash.clone()), TransactionStatus::Finalized(header_hash.clone())],
+	);
+}
+
 #[test]
 fn can_track_heap_size() {
-	let pool = maintained_pool();
+	let (pool, _guard) = maintained_pool();
 	block_on(pool.submit_one(&BlockId::number(0), uxt(Alice, 209))).expect("1. Imported");
 	block_on(pool.submit_one(&BlockId::number(0), uxt(Alice, 210))).expect("1. Imported");
 	block_on(pool.submit_one(&BlockId::number(0), uxt(Alice, 211))).expect("1. Imported");
@@ -269,7 +351,7 @@ fn finalization() {
 	let xt = uxt(Alice, 209);
 	let api = TestApi::with_alice_nonce(209);
 	api.push_block(1, vec![]);
-	let pool = BasicPool::new(Default::default(), api.into());
+	let (pool, _background) = BasicPool::new(Default::default(), api.into());
 	let watcher = block_on(pool.submit_and_watch(&BlockId::number(1), xt.clone())).expect("1. Imported");
 	pool.api.push_block(2, vec![xt.clone()]);
 
@@ -298,7 +380,7 @@ fn fork_aware_finalization() {
 	// starting block A1 (last finalized.)
 	api.push_block(1, vec![]);
 
-	let pool = BasicPool::new(Default::default(), api.into());
+	let (pool, _background) = BasicPool::new(Default::default(), api.into());
 	let mut canon_watchers = vec![];
 
 	let from_alice = uxt(Alice, 1);