// Copyright 2017-2021 Parity Technologies (UK) Ltd.
// This file is part of Polkadot.
// Polkadot 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.
// Polkadot 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 Polkadot. If not, see .
//! A small set of wrapping types to cover most of our adversary test cases.
//!
//! This allows types with internal mutability to synchronize across
//! multiple subsystems and intercept or replace incoming and outgoing
//! messages on the overseer level.
use polkadot_node_subsystem::*;
pub use polkadot_node_subsystem::{messages::AllMessages, overseer, FromOverseer};
use std::{future::Future, pin::Pin};
/// Filter incoming and outgoing messages.
pub trait MessageInterceptor: Send + Sync + Clone + 'static
where
Sender: overseer::SubsystemSender + Clone + 'static,
{
/// The message type the original subsystem handles incoming.
type Message: Send + 'static;
/// Filter messages that are to be received by
/// the subsystem.
///
/// For non-trivial cases, the `sender` can be used to send
/// multiple messages after doing some additional processing.
fn intercept_incoming(
&self,
_sender: &mut Sender,
msg: FromOverseer,
) -> Option> {
Some(msg)
}
/// Modify outgoing messages.
fn intercept_outgoing(&self, msg: AllMessages) -> Option {
Some(msg)
}
}
/// A sender with the outgoing messages filtered.
#[derive(Clone)]
pub struct InterceptedSender {
inner: Sender,
message_filter: Fil,
}
#[async_trait::async_trait]
impl overseer::SubsystemSender for InterceptedSender
where
Sender: overseer::SubsystemSender
+ overseer::SubsystemSender<>::Message>,
Fil: MessageInterceptor,
{
async fn send_message(&mut self, msg: AllMessages) {
if let Some(msg) = self.message_filter.intercept_outgoing(msg) {
self.inner.send_message(msg).await;
}
}
async fn send_messages(&mut self, msgs: T)
where
T: IntoIterator + Send,
T::IntoIter: Send,
{
for msg in msgs {
self.send_message(msg).await;
}
}
fn send_unbounded_message(&mut self, msg: AllMessages) {
if let Some(msg) = self.message_filter.intercept_outgoing(msg) {
self.inner.send_unbounded_message(msg);
}
}
}
/// A subsystem context, that filters the outgoing messages.
pub struct InterceptedContext
where
Context: overseer::SubsystemContext + SubsystemContext,
Fil: MessageInterceptor<::Sender>,
::Sender: overseer::SubsystemSender<
::Sender>>::Message,
>,
{
inner: Context,
message_filter: Fil,
sender: InterceptedSender<::Sender, Fil>,
}
impl InterceptedContext
where
Context: overseer::SubsystemContext + SubsystemContext,
Fil: MessageInterceptor<
::Sender,
Message = ::Message,
>,
::Sender: overseer::SubsystemSender<
::Sender>>::Message,
>,
{
pub fn new(mut inner: Context, message_filter: Fil) -> Self {
let sender = InterceptedSender::<::Sender, Fil> {
inner: inner.sender().clone(),
message_filter: message_filter.clone(),
};
Self { inner, message_filter, sender }
}
}
#[async_trait::async_trait]
impl overseer::SubsystemContext for InterceptedContext
where
Context: overseer::SubsystemContext + SubsystemContext,
Fil: MessageInterceptor<
::Sender,
Message = ::Message,
>,
::AllMessages:
From<::Message>,
::Sender: overseer::SubsystemSender<
::Sender>>::Message,
>,
{
type Message = ::Message;
type Sender = InterceptedSender<::Sender, Fil>;
type Error = ::Error;
type AllMessages = ::AllMessages;
type Signal = ::Signal;
async fn try_recv(&mut self) -> Result