// Copyright 2019-2022 Parity Technologies (UK) Ltd. // This file is part of Parity Bridges Common. // Parity Bridges Common 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. // Parity Bridges Common 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 Parity Bridges Common. If not, see . //! Relay chain to parachain relayer CLI primitives. use async_trait::async_trait; use std::sync::Arc; use crate::{ cli::{ bridge::{ CliBridgeBase, MessagesCliBridge, ParachainToRelayHeadersCliBridge, RelayToRelayHeadersCliBridge, }, relay_headers_and_messages::{Full2WayBridgeBase, Full2WayBridgeCommonParams}, }, finality::SubstrateFinalitySyncPipeline, on_demand::{ headers::OnDemandHeadersRelay, parachains::OnDemandParachainsRelay, OnDemandRelay, }, }; use bp_polkadot_core::parachains::ParaHash; use pallet_bridge_parachains::{RelayBlockHash, RelayBlockHasher, RelayBlockNumber}; use relay_substrate_client::{ AccountIdOf, AccountKeyPairOf, Chain, ChainWithRuntimeVersion, ChainWithTransactions, Client, Parachain, }; use sp_core::Pair; /// A base relay between standalone (relay) chain and a parachain from another consensus system. /// /// Such relay starts 2 messages relay. It also starts 2 on-demand header relays and 1 on-demand /// parachain heads relay. pub struct RelayToParachainBridge< L2R: MessagesCliBridge + RelayToRelayHeadersCliBridge, R2L: MessagesCliBridge + ParachainToRelayHeadersCliBridge, > where ::Source: Parachain, { /// Parameters that are shared by all bridge types. pub common: Full2WayBridgeCommonParams<::Target, ::Target>, /// Client of the right relay chain. pub right_relay: Client<::SourceRelay>, } /// Create set of configuration objects specific to relay-to-parachain relayer. #[macro_export] macro_rules! declare_relay_to_parachain_bridge_schema { // chain, parachain, relay-chain-of-parachain ($left_chain:ident, $right_parachain:ident, $right_chain:ident) => { bp_runtime::paste::item! { #[doc = $left_chain ", " $right_parachain " and " $right_chain " headers+parachains+messages relay params."] #[derive(Debug, PartialEq, StructOpt)] pub struct [<$left_chain $right_parachain HeadersAndMessages>] { // shared parameters #[structopt(flatten)] shared: HeadersAndMessagesSharedParams, #[structopt(flatten)] left: [<$left_chain ConnectionParams>], // default signer, which is always used to sign messages relay transactions on the left chain #[structopt(flatten)] left_sign: [<$left_chain SigningParams>], #[structopt(flatten)] right: [<$right_parachain ConnectionParams>], // default signer, which is always used to sign messages relay transactions on the right chain #[structopt(flatten)] right_sign: [<$right_parachain SigningParams>], #[structopt(flatten)] right_relay: [<$right_chain ConnectionParams>], } impl [<$left_chain $right_parachain HeadersAndMessages>] { async fn into_bridge< Left: ChainWithTransactions + ChainWithRuntimeVersion, Right: ChainWithTransactions + ChainWithRuntimeVersion + Parachain, RightRelay: ChainWithRuntimeVersion, L2R: CliBridgeBase + MessagesCliBridge + RelayToRelayHeadersCliBridge, R2L: CliBridgeBase + MessagesCliBridge + ParachainToRelayHeadersCliBridge, >( self, ) -> anyhow::Result> { Ok(RelayToParachainBridge { common: Full2WayBridgeCommonParams::new::( self.shared, BridgeEndCommonParams { client: self.left.into_client::().await?, tx_params: self.left_sign.transaction_params::()?, accounts: vec![], }, BridgeEndCommonParams { client: self.right.into_client::().await?, tx_params: self.right_sign.transaction_params::()?, accounts: vec![], }, )?, right_relay: self.right_relay.into_client::().await?, }) } } } }; } #[async_trait] impl< Left: ChainWithTransactions + ChainWithRuntimeVersion, Right: Chain + ChainWithTransactions + ChainWithRuntimeVersion + Parachain, RightRelay: Chain + ChainWithRuntimeVersion, L2R: CliBridgeBase + MessagesCliBridge + RelayToRelayHeadersCliBridge, R2L: CliBridgeBase + MessagesCliBridge + ParachainToRelayHeadersCliBridge, > Full2WayBridgeBase for RelayToParachainBridge where AccountIdOf: From< as Pair>::Public>, AccountIdOf: From< as Pair>::Public>, { type Params = RelayToParachainBridge; type Left = Left; type Right = Right; fn common(&self) -> &Full2WayBridgeCommonParams { &self.common } fn mut_common(&mut self) -> &mut Full2WayBridgeCommonParams { &mut self.common } async fn start_on_demand_headers_relayers( &mut self, ) -> anyhow::Result<( Arc>, Arc>, )> { ::Finality::start_relay_guards( &self.common.right.client, self.common.right.client.can_start_version_guard(), ) .await?; ::RelayFinality::start_relay_guards( &self.common.left.client, self.common.left.client.can_start_version_guard(), ) .await?; let left_to_right_on_demand_headers = OnDemandHeadersRelay::<::Finality>::new( self.common.left.client.clone(), self.common.right.client.clone(), self.common.right.tx_params.clone(), self.common.shared.headers_to_relay(), None, ); let right_relay_to_left_on_demand_headers = OnDemandHeadersRelay::<::RelayFinality>::new( self.right_relay.clone(), self.common.left.client.clone(), self.common.left.tx_params.clone(), self.common.shared.headers_to_relay(), Some(self.common.metrics_params.clone()), ); let right_to_left_on_demand_parachains = OnDemandParachainsRelay::< ::ParachainFinality, >::new( self.right_relay.clone(), self.common.left.client.clone(), self.common.left.tx_params.clone(), Arc::new(right_relay_to_left_on_demand_headers), ); Ok(( Arc::new(left_to_right_on_demand_headers), Arc::new(right_to_left_on_demand_parachains), )) } }