// 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 to interact with Substrate node using RPC methods. #![warn(missing_docs)] mod chain; mod client; mod error; mod rpc; mod sync_header; pub mod finality_source; pub mod guard; pub mod headers_source; pub mod metrics; use std::time::Duration; pub use crate::chain::{ BlockWithJustification, Chain, ChainWithBalances, TransactionSignScheme, UnsignedTransaction, WeightToFeeOf, }; pub use crate::client::{Client, JustificationsSubscription, OpaqueGrandpaAuthoritiesSet}; pub use crate::error::{Error, Result}; pub use crate::sync_header::SyncHeader; pub use bp_runtime::{ BalanceOf, BlockNumberOf, Chain as ChainBase, HashOf, HeaderOf, IndexOf, TransactionEra, TransactionEraOf, }; /// Header id used by the chain. pub type HeaderIdOf = relay_utils::HeaderId, BlockNumberOf>; /// Substrate-over-websocket connection params. #[derive(Debug, Clone)] pub struct ConnectionParams { /// Websocket server host name. pub host: String, /// Websocket server TCP port. pub port: u16, /// Use secure websocket connection. pub secure: bool, } impl Default for ConnectionParams { fn default() -> Self { ConnectionParams { host: "localhost".into(), port: 9944, secure: false, } } } /// Returns stall timeout for relay loop. /// /// Relay considers himself stalled if he has submitted transaction to the node, but it has not /// been mined for this period. /// /// Returns `None` if mortality period is `None` pub fn transaction_stall_timeout(mortality_period: Option, average_block_interval: Duration) -> Option { // 1 extra block for transaction to reach the pool && 1 for relayer to awake after it is mined mortality_period.map(|mortality_period| average_block_interval.saturating_mul(mortality_period + 1 + 1)) }