// Copyright 2019-2021 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 . //! Everything required to serve Millau <-> Rialto messages. use crate::{Call, OriginCaller, Runtime}; use bp_messages::{ source_chain::{SenderOrigin, TargetHeaderChain}, target_chain::{ProvedMessages, SourceHeaderChain}, InboundLaneData, LaneId, Message, MessageNonce, Parameter as MessagesParameter, }; use bp_runtime::{Chain, ChainId, MILLAU_CHAIN_ID, RIALTO_CHAIN_ID}; use bridge_runtime_common::messages::{ self, BasicConfirmationTransactionEstimation, MessageBridge, MessageTransaction, }; use codec::{Decode, Encode}; use frame_support::{ parameter_types, weights::{DispatchClass, Weight}, RuntimeDebug, }; use scale_info::TypeInfo; use sp_runtime::{traits::Saturating, FixedPointNumber, FixedU128}; use sp_std::convert::TryFrom; /// Initial value of `RialtoToMillauConversionRate` parameter. pub const INITIAL_RIALTO_TO_MILLAU_CONVERSION_RATE: FixedU128 = FixedU128::from_inner(FixedU128::DIV); /// Initial value of `RialtoFeeMultiplier` parameter. pub const INITIAL_RIALTO_FEE_MULTIPLIER: FixedU128 = FixedU128::from_inner(FixedU128::DIV); /// Weight of 2 XCM instructions is for simple `Trap(42)` program, coming through bridge /// (it is prepended with `UniversalOrigin` instruction). It is used just for simplest manual /// tests, confirming that we don't break encoding somewhere between. pub const BASE_XCM_WEIGHT_TWICE: Weight = 2 * crate::xcm_config::BASE_XCM_WEIGHT; parameter_types! { /// Rialto to Millau conversion rate. Initially we treat both tokens as equal. pub storage RialtoToMillauConversionRate: FixedU128 = INITIAL_RIALTO_TO_MILLAU_CONVERSION_RATE; /// Fee multiplier value at Rialto chain. pub storage RialtoFeeMultiplier: FixedU128 = INITIAL_RIALTO_FEE_MULTIPLIER; } /// Message payload for Millau -> Rialto messages. pub type ToRialtoMessagePayload = messages::source::FromThisChainMessagePayload; /// Message verifier for Millau -> Rialto messages. pub type ToRialtoMessageVerifier = messages::source::FromThisChainMessageVerifier; /// Message payload for Rialto -> Millau messages. pub type FromRialtoMessagePayload = messages::target::FromBridgedChainMessagePayload; /// Messages proof for Rialto -> Millau messages. pub type FromRialtoMessagesProof = messages::target::FromBridgedChainMessagesProof; /// Messages delivery proof for Millau -> Rialto messages. pub type ToRialtoMessagesDeliveryProof = messages::source::FromBridgedChainMessagesDeliveryProof; /// Call-dispatch based message dispatch for Rialto -> Millau messages. pub type FromRialtoMessageDispatch = messages::target::FromBridgedChainMessageDispatch< WithRialtoMessageBridge, xcm_executor::XcmExecutor, crate::xcm_config::XcmWeigher, // 2 XCM instructions is for simple `Trap(42)` program, coming through bridge // (it is prepended with `UniversalOrigin` instruction) frame_support::traits::ConstU64, >; /// Maximal outbound payload size of Millau -> Rialto messages. pub type ToRialtoMaximalOutboundPayloadSize = messages::source::FromThisChainMaximalOutboundPayloadSize; /// Millau <-> Rialto message bridge. #[derive(RuntimeDebug, Clone, Copy)] pub struct WithRialtoMessageBridge; impl MessageBridge for WithRialtoMessageBridge { const RELAYER_FEE_PERCENT: u32 = 10; const THIS_CHAIN_ID: ChainId = MILLAU_CHAIN_ID; const BRIDGED_CHAIN_ID: ChainId = RIALTO_CHAIN_ID; const BRIDGED_MESSAGES_PALLET_NAME: &'static str = bp_millau::WITH_MILLAU_MESSAGES_PALLET_NAME; type ThisChain = Millau; type BridgedChain = Rialto; fn bridged_balance_to_this_balance( bridged_balance: bp_rialto::Balance, bridged_to_this_conversion_rate_override: Option, ) -> bp_millau::Balance { let conversion_rate = bridged_to_this_conversion_rate_override .unwrap_or_else(RialtoToMillauConversionRate::get); bp_millau::Balance::try_from(conversion_rate.saturating_mul_int(bridged_balance)) .unwrap_or(bp_millau::Balance::MAX) } } /// Millau chain from message lane point of view. #[derive(RuntimeDebug, Clone, Copy)] pub struct Millau; impl messages::ChainWithMessages for Millau { type Hash = bp_millau::Hash; type AccountId = bp_millau::AccountId; type Signer = bp_millau::AccountSigner; type Signature = bp_millau::Signature; type Weight = Weight; type Balance = bp_millau::Balance; } impl messages::ThisChainWithMessages for Millau { type Origin = crate::Origin; type Call = crate::Call; type ConfirmationTransactionEstimation = BasicConfirmationTransactionEstimation< Self::AccountId, { bp_millau::MAX_SINGLE_MESSAGE_DELIVERY_CONFIRMATION_TX_WEIGHT }, { bp_rialto::EXTRA_STORAGE_PROOF_SIZE }, { bp_millau::TX_EXTRA_BYTES }, >; fn is_message_accepted(send_origin: &Self::Origin, lane: &LaneId) -> bool { let here_location = xcm::v3::MultiLocation::from(crate::xcm_config::UniversalLocation::get()); match send_origin.caller { OriginCaller::XcmPallet(pallet_xcm::Origin::Xcm(ref location)) if *location == here_location => { log::trace!(target: "runtime::bridge", "Verifying message sent using XCM pallet to Rialto"); }, _ => { // keep in mind that in this case all messages are free (in term of fees) // => it's just to keep testing bridge on our test deployments until we'll have a // better option log::trace!(target: "runtime::bridge", "Verifying message sent using messages pallet to Rialto"); }, } *lane == [0, 0, 0, 0] || *lane == [0, 0, 0, 1] } fn maximal_pending_messages_at_outbound_lane() -> MessageNonce { MessageNonce::MAX } fn transaction_payment(transaction: MessageTransaction) -> bp_millau::Balance { // `transaction` may represent transaction from the future, when multiplier value will // be larger, so let's use slightly increased value let multiplier = FixedU128::saturating_from_rational(110, 100) .saturating_mul(pallet_transaction_payment::Pallet::::next_fee_multiplier()); // in our testnets, both per-byte fee and weight-to-fee are 1:1 messages::transaction_payment( bp_millau::BlockWeights::get().get(DispatchClass::Normal).base_extrinsic, 1, multiplier, |weight| weight as _, transaction, ) } } /// Rialto chain from message lane point of view. #[derive(RuntimeDebug, Clone, Copy)] pub struct Rialto; impl messages::ChainWithMessages for Rialto { type Hash = bp_rialto::Hash; type AccountId = bp_rialto::AccountId; type Signer = bp_rialto::AccountSigner; type Signature = bp_rialto::Signature; type Weight = Weight; type Balance = bp_rialto::Balance; } impl messages::BridgedChainWithMessages for Rialto { fn maximal_extrinsic_size() -> u32 { bp_rialto::Rialto::max_extrinsic_size() } fn verify_dispatch_weight(_message_payload: &[u8]) -> bool { true } fn estimate_delivery_transaction( message_payload: &[u8], include_pay_dispatch_fee_cost: bool, message_dispatch_weight: Weight, ) -> MessageTransaction { let message_payload_len = u32::try_from(message_payload.len()).unwrap_or(u32::MAX); let extra_bytes_in_payload = Weight::from(message_payload_len) .saturating_sub(pallet_bridge_messages::EXPECTED_DEFAULT_MESSAGE_LENGTH.into()); MessageTransaction { dispatch_weight: extra_bytes_in_payload .saturating_mul(bp_rialto::ADDITIONAL_MESSAGE_BYTE_DELIVERY_WEIGHT) .saturating_add(bp_rialto::DEFAULT_MESSAGE_DELIVERY_TX_WEIGHT) .saturating_sub(if include_pay_dispatch_fee_cost { 0 } else { bp_rialto::PAY_INBOUND_DISPATCH_FEE_WEIGHT }) .saturating_add(message_dispatch_weight), size: message_payload_len .saturating_add(bp_millau::EXTRA_STORAGE_PROOF_SIZE) .saturating_add(bp_rialto::TX_EXTRA_BYTES), } } fn transaction_payment(transaction: MessageTransaction) -> bp_rialto::Balance { // we don't have a direct access to the value of multiplier at Rialto chain // => it is a messages module parameter let multiplier = RialtoFeeMultiplier::get(); // in our testnets, both per-byte fee and weight-to-fee are 1:1 messages::transaction_payment( bp_rialto::BlockWeights::get().get(DispatchClass::Normal).base_extrinsic, 1, multiplier, |weight| weight as _, transaction, ) } } impl TargetHeaderChain for Rialto { type Error = &'static str; // The proof is: // - hash of the header this proof has been created with; // - the storage proof or one or several keys; // - id of the lane we prove state of. type MessagesDeliveryProof = ToRialtoMessagesDeliveryProof; fn verify_message(payload: &ToRialtoMessagePayload) -> Result<(), Self::Error> { messages::source::verify_chain_message::(payload) } fn verify_messages_delivery_proof( proof: Self::MessagesDeliveryProof, ) -> Result<(LaneId, InboundLaneData), Self::Error> { messages::source::verify_messages_delivery_proof::< WithRialtoMessageBridge, Runtime, crate::RialtoGrandpaInstance, >(proof) } } impl SourceHeaderChain for Rialto { type Error = &'static str; // The proof is: // - hash of the header this proof has been created with; // - the storage proof or one or several keys; // - id of the lane we prove messages for; // - inclusive range of messages nonces that are proved. type MessagesProof = FromRialtoMessagesProof; fn verify_messages_proof( proof: Self::MessagesProof, messages_count: u32, ) -> Result>, Self::Error> { messages::target::verify_messages_proof::< WithRialtoMessageBridge, Runtime, crate::RialtoGrandpaInstance, >(proof, messages_count) } } impl SenderOrigin for crate::Origin { fn linked_account(&self) -> Option { // XCM deals wit fees in our deployments None } } /// Millau -> Rialto message lane pallet parameters. #[derive(RuntimeDebug, Clone, Encode, Decode, PartialEq, Eq, TypeInfo)] pub enum MillauToRialtoMessagesParameter { /// The conversion formula we use is: `MillauTokens = RialtoTokens * conversion_rate`. RialtoToMillauConversionRate(FixedU128), } impl MessagesParameter for MillauToRialtoMessagesParameter { fn save(&self) { match *self { MillauToRialtoMessagesParameter::RialtoToMillauConversionRate(ref conversion_rate) => RialtoToMillauConversionRate::set(conversion_rate), } } } #[cfg(test)] mod tests { use super::*; use crate::{DbWeight, RialtoGrandpaInstance, Runtime, WithRialtoMessagesInstance}; use bp_runtime::Chain; use bridge_runtime_common::{ assert_complete_bridge_types, integrity::{ assert_complete_bridge_constants, AssertBridgeMessagesPalletConstants, AssertBridgePalletNames, AssertChainConstants, AssertCompleteBridgeConstants, }, messages, }; #[test] fn ensure_millau_message_lane_weights_are_correct() { type Weights = pallet_bridge_messages::weights::MillauWeight; pallet_bridge_messages::ensure_weights_are_correct::( bp_millau::DEFAULT_MESSAGE_DELIVERY_TX_WEIGHT, bp_millau::ADDITIONAL_MESSAGE_BYTE_DELIVERY_WEIGHT, bp_millau::MAX_SINGLE_MESSAGE_DELIVERY_CONFIRMATION_TX_WEIGHT, bp_millau::PAY_INBOUND_DISPATCH_FEE_WEIGHT, DbWeight::get(), ); let max_incoming_message_proof_size = bp_rialto::EXTRA_STORAGE_PROOF_SIZE.saturating_add( messages::target::maximal_incoming_message_size(bp_millau::Millau::max_extrinsic_size()), ); pallet_bridge_messages::ensure_able_to_receive_message::( bp_millau::Millau::max_extrinsic_size(), bp_millau::Millau::max_extrinsic_weight(), max_incoming_message_proof_size, messages::target::maximal_incoming_message_dispatch_weight( bp_millau::Millau::max_extrinsic_weight(), ), ); let max_incoming_inbound_lane_data_proof_size = bp_messages::InboundLaneData::<()>::encoded_size_hint_u32( bp_millau::MAX_UNREWARDED_RELAYERS_IN_CONFIRMATION_TX as _, bp_millau::MAX_UNCONFIRMED_MESSAGES_IN_CONFIRMATION_TX as _, ); pallet_bridge_messages::ensure_able_to_receive_confirmation::( bp_millau::Millau::max_extrinsic_size(), bp_millau::Millau::max_extrinsic_weight(), max_incoming_inbound_lane_data_proof_size, bp_millau::MAX_UNREWARDED_RELAYERS_IN_CONFIRMATION_TX, bp_millau::MAX_UNCONFIRMED_MESSAGES_IN_CONFIRMATION_TX, DbWeight::get(), ); } #[test] fn ensure_bridge_integrity() { assert_complete_bridge_types!( runtime: Runtime, with_bridged_chain_grandpa_instance: RialtoGrandpaInstance, with_bridged_chain_messages_instance: WithRialtoMessagesInstance, bridge: WithRialtoMessageBridge, this_chain: bp_millau::Millau, bridged_chain: bp_rialto::Rialto, ); assert_complete_bridge_constants::< Runtime, RialtoGrandpaInstance, WithRialtoMessagesInstance, WithRialtoMessageBridge, bp_millau::Millau, >(AssertCompleteBridgeConstants { this_chain_constants: AssertChainConstants { block_length: bp_millau::BlockLength::get(), block_weights: bp_millau::BlockWeights::get(), }, messages_pallet_constants: AssertBridgeMessagesPalletConstants { max_unrewarded_relayers_in_bridged_confirmation_tx: bp_rialto::MAX_UNREWARDED_RELAYERS_IN_CONFIRMATION_TX, max_unconfirmed_messages_in_bridged_confirmation_tx: bp_rialto::MAX_UNCONFIRMED_MESSAGES_IN_CONFIRMATION_TX, bridged_chain_id: bp_runtime::RIALTO_CHAIN_ID, }, pallet_names: AssertBridgePalletNames { with_this_chain_messages_pallet_name: bp_millau::WITH_MILLAU_MESSAGES_PALLET_NAME, with_bridged_chain_grandpa_pallet_name: bp_rialto::WITH_RIALTO_GRANDPA_PALLET_NAME, with_bridged_chain_messages_pallet_name: bp_rialto::WITH_RIALTO_MESSAGES_PALLET_NAME, }, }); assert_eq!( RialtoToMillauConversionRate::key().to_vec(), bp_runtime::storage_parameter_key( bp_millau::RIALTO_TO_MILLAU_CONVERSION_RATE_PARAMETER_NAME ) .0, ); } }