// 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 . //! Tools for supporting message lanes between two Substrate-based chains. use crate::TaggedAccount; use bp_messages::LaneId; use bp_runtime::StorageDoubleMapKeyProvider; use codec::Decode; use frame_system::AccountInfo; use pallet_balances::AccountData; use relay_substrate_client::{ metrics::{FloatStorageValue, FloatStorageValueMetric}, AccountIdOf, BalanceOf, Chain, ChainWithBalances, ChainWithMessages, Client, Error as SubstrateError, IndexOf, }; use relay_utils::metrics::{MetricsParams, StandaloneMetric}; use sp_core::storage::StorageData; use sp_runtime::{FixedPointNumber, FixedU128}; use std::{convert::TryFrom, fmt::Debug, marker::PhantomData}; /// Add relay accounts balance metrics. pub async fn add_relay_balances_metrics( client: Client, metrics: &mut MetricsParams, relay_accounts: &Vec>>, lanes: &[LaneId], ) -> anyhow::Result<()> where BalanceOf: Into + std::fmt::Debug, { if relay_accounts.is_empty() { return Ok(()) } // if `tokenDecimals` is missing from system properties, we'll be using let token_decimals = client .token_decimals() .await? .map(|token_decimals| { log::info!(target: "bridge", "Read `tokenDecimals` for {}: {}", C::NAME, token_decimals); token_decimals }) .unwrap_or_else(|| { // turns out it is normal not to have this property - e.g. when polkadot binary is // started using `polkadot-local` chain. Let's use minimal nominal here log::info!(target: "bridge", "Using default (zero) `tokenDecimals` value for {}", C::NAME); 0 }); let token_decimals = u32::try_from(token_decimals).map_err(|e| { anyhow::format_err!( "Token decimals value ({}) of {} doesn't fit into u32: {:?}", token_decimals, C::NAME, e, ) })?; for account in relay_accounts { let relay_account_balance_metric = FloatStorageValueMetric::new( AccountBalanceFromAccountInfo:: { token_decimals, _phantom: Default::default() }, client.clone(), C::account_info_storage_key(account.id()), format!("at_{}_relay_{}_balance", C::NAME, account.tag()), format!("Balance of the {} relay account at the {}", account.tag(), C::NAME), )?; relay_account_balance_metric.register_and_spawn(&metrics.registry)?; if let Some(relayers_pallet_name) = BC::WITH_CHAIN_RELAYERS_PALLET_NAME { for lane in lanes { let relay_account_reward_metric = FloatStorageValueMetric::new( AccountBalance:: { token_decimals, _phantom: Default::default() }, client.clone(), bp_relayers::RelayerRewardsKeyProvider::, BalanceOf>::final_key( relayers_pallet_name, account.id(), lane, ), format!("at_{}_relay_{}_reward_for_lane_{}_with_{}", C::NAME, account.tag(), hex::encode(lane.as_ref()), BC::NAME), format!("Reward of the {} relay account for serving lane {:?} with {} at the {}", account.tag(), lane, BC::NAME, C::NAME), )?; relay_account_reward_metric.register_and_spawn(&metrics.registry)?; } } } Ok(()) } /// Adapter for `FloatStorageValueMetric` to decode account free balance. #[derive(Clone, Debug)] struct AccountBalanceFromAccountInfo { token_decimals: u32, _phantom: PhantomData, } impl FloatStorageValue for AccountBalanceFromAccountInfo where C: Chain, BalanceOf: Into, { type Value = FixedU128; fn decode( &self, maybe_raw_value: Option, ) -> Result, SubstrateError> { maybe_raw_value .map(|raw_value| { AccountInfo::, AccountData>>::decode(&mut &raw_value.0[..]) .map_err(SubstrateError::ResponseParseFailed) .map(|account_data| { convert_to_token_balance(account_data.data.free.into(), self.token_decimals) }) }) .transpose() } } /// Adapter for `FloatStorageValueMetric` to decode account free balance. #[derive(Clone, Debug)] struct AccountBalance { token_decimals: u32, _phantom: PhantomData, } impl FloatStorageValue for AccountBalance where C: Chain, BalanceOf: Into, { type Value = FixedU128; fn decode( &self, maybe_raw_value: Option, ) -> Result, SubstrateError> { maybe_raw_value .map(|raw_value| { BalanceOf::::decode(&mut &raw_value.0[..]) .map_err(SubstrateError::ResponseParseFailed) .map(|balance| convert_to_token_balance(balance.into(), self.token_decimals)) }) .transpose() } } /// Convert from raw `u128` balance (nominated in smallest chain token units) to the float regular /// tokens value. fn convert_to_token_balance(balance: u128, token_decimals: u32) -> FixedU128 { FixedU128::from_inner(balance.saturating_mul(FixedU128::DIV / 10u128.pow(token_decimals))) } #[cfg(test)] mod tests { use super::*; #[test] fn token_decimals_used_properly() { let plancks = 425_000_000_000; let token_decimals = 10; let dots = convert_to_token_balance(plancks, token_decimals); assert_eq!(dots, FixedU128::saturating_from_rational(425, 10)); } }