// 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 .
//! Primitives of messages module.
#![warn(missing_docs)]
#![cfg_attr(not(feature = "std"), no_std)]
use bp_messages::LaneId;
use bp_runtime::StorageDoubleMapKeyProvider;
use frame_support::{Blake2_128Concat, Identity};
use sp_runtime::{
codec::{Codec, Decode, Encode, EncodeLike},
traits::AccountIdConversion,
};
use sp_std::{fmt::Debug, marker::PhantomData};
/// Reward payment procedure.
pub trait PaymentProcedure {
/// Error that may be returned by the procedure.
type Error: Debug;
/// Pay reward to the relayer for serving given message lane.
fn pay_reward(relayer: &Relayer, lane_id: LaneId, reward: Reward) -> Result<(), Self::Error>;
}
impl PaymentProcedure for () {
type Error = &'static str;
fn pay_reward(_: &Relayer, _: LaneId, _: Reward) -> Result<(), Self::Error> {
Ok(())
}
}
/// Reward payment procedure that does `balances::transfer` call from the account, derived from
/// given lane.
pub struct PayLaneRewardFromAccount(PhantomData<(T, Relayer)>);
impl PayLaneRewardFromAccount
where
Relayer: Decode + Encode,
{
/// Return account that pay rewards for serving given lane.
pub fn lane_rewards_account(lane_id: LaneId) -> Relayer {
lane_id.into_sub_account_truncating(b"bridge-lane")
}
}
impl PaymentProcedure for PayLaneRewardFromAccount
where
T: frame_support::traits::fungible::Transfer,
Relayer: Decode + Encode,
{
type Error = sp_runtime::DispatchError;
fn pay_reward(
relayer: &Relayer,
lane_id: LaneId,
reward: T::Balance,
) -> Result<(), Self::Error> {
T::transfer(&Self::lane_rewards_account(lane_id), relayer, reward, false).map(drop)
}
}
/// Can be use to access the runtime storage key within the `RelayerRewards` map of the relayers
/// pallet.
pub struct RelayerRewardsKeyProvider(PhantomData<(AccountId, Reward)>);
impl StorageDoubleMapKeyProvider for RelayerRewardsKeyProvider
where
AccountId: Codec + EncodeLike,
Reward: Codec + EncodeLike,
{
const MAP_NAME: &'static str = "RelayerRewards";
type Hasher1 = Blake2_128Concat;
type Key1 = AccountId;
type Hasher2 = Identity;
type Key2 = LaneId;
type Value = Reward;
}
#[cfg(test)]
mod tests {
use super::*;
use sp_runtime::testing::H256;
#[test]
fn lanes_are_using_different_accounts() {
assert_eq!(
PayLaneRewardFromAccount::<(), H256>::lane_rewards_account(LaneId([0, 0, 0, 0])),
hex_literal::hex!("626c616e000000006272696467652d6c616e6500000000000000000000000000")
.into(),
);
assert_eq!(
PayLaneRewardFromAccount::<(), H256>::lane_rewards_account(LaneId([0, 0, 0, 1])),
hex_literal::hex!("626c616e000000016272696467652d6c616e6500000000000000000000000000")
.into(),
);
}
}