// Copyright 2019-2020 Parity Technologies (UK) Ltd. // This file is part of Substrate. // Substrate 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. // Substrate 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 Substrate. If not, see . #![warn(missing_docs)] //! Substrate authority discovery. //! //! This crate enables Substrate authorities to discover and directly connect to //! other authorities. It is split into two components the [`Worker`] and the //! [`Service`]. //! //! See [`Worker`] and [`Service`] for more documentation. pub use crate::{service::Service, worker::{NetworkProvider, Worker, Role}}; use std::pin::Pin; use std::sync::Arc; use futures::channel::{mpsc, oneshot}; use futures::Stream; use sc_client_api::blockchain::HeaderBackend; use sc_network::{config::MultiaddrWithPeerId, DhtEvent, Multiaddr, PeerId}; use sp_authority_discovery::{AuthorityDiscoveryApi, AuthorityId}; use sp_runtime::traits::Block as BlockT; use sp_api::ProvideRuntimeApi; mod error; mod service; #[cfg(test)] mod tests; mod worker; /// Create a new authority discovery [`Worker`] and [`Service`]. pub fn new_worker_and_service( client: Arc, network: Arc, sentry_nodes: Vec, dht_event_rx: Pin + Send>>, role: Role, prometheus_registry: Option, ) -> (Worker, Service) where Block: BlockT + Unpin + 'static, Network: NetworkProvider, Client: ProvideRuntimeApi + Send + Sync + 'static + HeaderBackend, >::Api: AuthorityDiscoveryApi, { let (to_worker, from_service) = mpsc::channel(0); let worker = Worker::new( from_service, client, network, sentry_nodes, dht_event_rx, role, prometheus_registry, ); let service = Service::new(to_worker); (worker, service) } /// Message send from the [`Service`] to the [`Worker`]. pub(crate) enum ServicetoWorkerMsg { /// See [`Service::get_addresses_by_authority_id`]. GetAddressesByAuthorityId(AuthorityId, oneshot::Sender>>), /// See [`Service::get_authority_id_by_peer_id`]. GetAuthorityIdByPeerId(PeerId, oneshot::Sender>) }