// Copyright 2019 Parity Technologies (UK) Ltd. // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. use crate::{ Transport, Multiaddr, PeerId, InboundUpgrade, OutboundUpgrade, UpgradeInfo, ProtocolName, muxing::StreamMuxer, nodes::{ collection::ConnectionInfo, handled_node::NodeHandler, node::Substream, raw_swarm::{self, RawSwarm, RawSwarmEvent} }, protocols_handler::{NodeHandlerWrapperBuilder, NodeHandlerWrapper, NodeHandlerWrapperError, IntoProtocolsHandler, ProtocolsHandler}, swarm::{NetworkBehaviour, NetworkBehaviourAction}, transport::TransportError, }; use futures::prelude::*; use smallvec::SmallVec; use std::{error, fmt, io, ops::{Deref, DerefMut}}; /// Contains the state of the network, plus the way it should behave. pub type Swarm = ExpandedSwarm< TTransport, TBehaviour, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InEvent, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutEvent, ::ProtocolsHandler, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::Error, >; /// Contains the state of the network, plus the way it should behave. pub struct ExpandedSwarm where TTransport: Transport, { raw_swarm: RawSwarm< TTransport, TInEvent, TOutEvent, NodeHandlerWrapperBuilder, NodeHandlerWrapperError, PeerId, PeerId, >, /// Handles which nodes to connect to and how to handle the events sent back by the protocol /// handlers. behaviour: TBehaviour, /// List of protocols that the behaviour says it supports. supported_protocols: SmallVec<[Vec; 16]>, /// List of multiaddresses we're listening on. listened_addrs: SmallVec<[Multiaddr; 8]>, /// List of multiaddresses we're listening on, after account for external IP addresses and /// similar mechanisms. external_addrs: SmallVec<[Multiaddr; 8]>, } impl Deref for ExpandedSwarm where TTransport: Transport, { type Target = TBehaviour; #[inline] fn deref(&self) -> &Self::Target { &self.behaviour } } impl DerefMut for ExpandedSwarm where TTransport: Transport, { #[inline] fn deref_mut(&mut self) -> &mut Self::Target { &mut self.behaviour } } impl ExpandedSwarm where TBehaviour: NetworkBehaviour, TMuxer: StreamMuxer + Send + Sync + 'static, ::OutboundSubstream: Send + 'static, ::Substream: Send + 'static, TTransport: Transport + Clone, TTransport::Error: Send + 'static, TTransport::Listener: Send + 'static, TTransport::ListenerUpgrade: Send + 'static, TTransport::Dial: Send + 'static, THandlerErr: error::Error, THandler: IntoProtocolsHandler + Send + 'static, ::Handler: ProtocolsHandler, Error = THandlerErr> + Send + 'static, <::Handler as ProtocolsHandler>::InEvent: Send + 'static, <::Handler as ProtocolsHandler>::OutEvent: Send + 'static, <::Handler as ProtocolsHandler>::Error: Send + 'static, <::Handler as ProtocolsHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary <::Handler as ProtocolsHandler>::InboundProtocol: InboundUpgrade> + Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::Info: Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Error: fmt::Debug + Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Future: Send + 'static, <::Handler as ProtocolsHandler>::OutboundProtocol: OutboundUpgrade> + Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::Info: Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Future: Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Error: fmt::Debug + Send + 'static, ::Handler> as NodeHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary { /// Builds a new `Swarm`. #[inline] pub fn new(transport: TTransport, behaviour: TBehaviour, local_peer_id: PeerId) -> Self { SwarmBuilder::new(transport, behaviour, local_peer_id) .build() } /// Returns the transport passed when building this object. #[inline] pub fn transport(me: &Self) -> &TTransport { me.raw_swarm.transport() } /// Starts listening on the given address. /// /// Returns an error if the address is not supported. #[inline] pub fn listen_on(me: &mut Self, addr: Multiaddr) -> Result<(), TransportError> { me.raw_swarm.listen_on(addr) } /// Tries to dial the given address. /// /// Returns an error if the address is not supported. #[inline] pub fn dial_addr(me: &mut Self, addr: Multiaddr) -> Result<(), TransportError> { let handler = me.behaviour.new_handler(); me.raw_swarm.dial(addr, handler.into_node_handler_builder()) } /// Tries to reach the given peer using the elements in the topology. /// /// Has no effect if we are already connected to that peer, or if no address is known for the /// peer. #[inline] pub fn dial(me: &mut Self, peer_id: PeerId) { let addrs = me.behaviour.addresses_of_peer(&peer_id); match me.raw_swarm.peer(peer_id.clone()) { raw_swarm::Peer::NotConnected(peer) => { let handler = me.behaviour.new_handler().into_node_handler_builder(); if peer.connect_iter(addrs, handler).is_err() { me.behaviour.inject_dial_failure(&peer_id); } }, raw_swarm::Peer::PendingConnect(mut peer) => { peer.append_multiaddr_attempts(addrs) }, raw_swarm::Peer::Connected(_) | raw_swarm::Peer::LocalNode => {} } } /// Returns an iterator that produces the list of addresses we're listening on. #[inline] pub fn listeners(me: &Self) -> impl Iterator { me.raw_swarm.listen_addrs() } /// Returns an iterator that produces the list of addresses that other nodes can use to reach /// us. #[inline] pub fn external_addresses(me: &Self) -> impl Iterator { me.external_addrs.iter() } /// Returns the peer ID of the swarm passed as parameter. #[inline] pub fn local_peer_id(me: &Self) -> &PeerId { &me.raw_swarm.local_peer_id() } /// Adds an external address. /// /// An external address is an address we are listening on but that accounts for things such as /// NAT traversal. pub fn add_external_address(me: &mut Self, addr: Multiaddr) { if me.external_addrs.iter().all(|a| *a != addr) { me.external_addrs.push(addr); } } } impl Stream for ExpandedSwarm where TBehaviour: NetworkBehaviour, TMuxer: StreamMuxer + Send + Sync + 'static, ::OutboundSubstream: Send + 'static, ::Substream: Send + 'static, TTransport: Transport + Clone, TTransport::Error: Send + 'static, TTransport::Listener: Send + 'static, TTransport::ListenerUpgrade: Send + 'static, TTransport::Dial: Send + 'static, THandlerErr: error::Error, THandler: IntoProtocolsHandler + Send + 'static, ::Handler: ProtocolsHandler, Error = THandlerErr> + Send + 'static, <::Handler as ProtocolsHandler>::InEvent: Send + 'static, <::Handler as ProtocolsHandler>::OutEvent: Send + 'static, <::Handler as ProtocolsHandler>::Error: Send + 'static, <::Handler as ProtocolsHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary <::Handler as ProtocolsHandler>::InboundProtocol: InboundUpgrade> + Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Future: Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Error: fmt::Debug + Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::Info: Send + 'static, <<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, <::Handler as ProtocolsHandler>::OutboundProtocol: OutboundUpgrade> + Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Future: Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Error: fmt::Debug + Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::Info: Send + 'static, <<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, ::Handler> as NodeHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary { type Item = TBehaviour::OutEvent; type Error = io::Error; #[inline] fn poll(&mut self) -> Poll, io::Error> { loop { let mut raw_swarm_not_ready = false; match self.raw_swarm.poll() { Async::NotReady => raw_swarm_not_ready = true, Async::Ready(RawSwarmEvent::NodeEvent { conn_info, event }) => { self.behaviour.inject_node_event(conn_info.peer_id().clone(), event); }, Async::Ready(RawSwarmEvent::Connected { conn_info, endpoint }) => { self.behaviour.inject_connected(conn_info.peer_id().clone(), endpoint); }, Async::Ready(RawSwarmEvent::NodeClosed { conn_info, endpoint, .. }) => { self.behaviour.inject_disconnected(conn_info.peer_id(), endpoint); }, Async::Ready(RawSwarmEvent::Replaced { new_info, closed_endpoint, endpoint, .. }) => { self.behaviour.inject_replaced(new_info.peer_id().clone(), closed_endpoint, endpoint); }, Async::Ready(RawSwarmEvent::IncomingConnection(incoming)) => { let handler = self.behaviour.new_handler(); incoming.accept(handler.into_node_handler_builder()); }, Async::Ready(RawSwarmEvent::NewListenerAddress { listen_addr }) => { if !self.listened_addrs.contains(&listen_addr) { self.listened_addrs.push(listen_addr.clone()) } self.behaviour.inject_new_listen_addr(&listen_addr); } Async::Ready(RawSwarmEvent::ExpiredListenerAddress { listen_addr }) => { self.listened_addrs.retain(|a| a != &listen_addr); self.behaviour.inject_expired_listen_addr(&listen_addr); } Async::Ready(RawSwarmEvent::ListenerClosed { .. }) => {}, Async::Ready(RawSwarmEvent::IncomingConnectionError { .. }) => {}, Async::Ready(RawSwarmEvent::DialError { peer_id, multiaddr, error, new_state }) => { self.behaviour.inject_addr_reach_failure(Some(&peer_id), &multiaddr, &error); if let raw_swarm::PeerState::NotConnected = new_state { self.behaviour.inject_dial_failure(&peer_id); } }, Async::Ready(RawSwarmEvent::UnknownPeerDialError { multiaddr, error, .. }) => { self.behaviour.inject_addr_reach_failure(None, &multiaddr, &error); }, } let behaviour_poll = { let transport = self.raw_swarm.transport(); let mut parameters = PollParameters { local_peer_id: &mut self.raw_swarm.local_peer_id(), supported_protocols: &self.supported_protocols, listened_addrs: &self.listened_addrs, external_addrs: &self.external_addrs, nat_traversal: &move |a, b| transport.nat_traversal(a, b), }; self.behaviour.poll(&mut parameters) }; match behaviour_poll { Async::NotReady if raw_swarm_not_ready => return Ok(Async::NotReady), Async::NotReady => (), Async::Ready(NetworkBehaviourAction::GenerateEvent(event)) => { return Ok(Async::Ready(Some(event))) }, Async::Ready(NetworkBehaviourAction::DialAddress { address }) => { let _ = Swarm::dial_addr(self, address); }, Async::Ready(NetworkBehaviourAction::DialPeer { peer_id }) => { Swarm::dial(self, peer_id) }, Async::Ready(NetworkBehaviourAction::SendEvent { peer_id, event }) => { if let Some(mut peer) = self.raw_swarm.peer(peer_id).into_connected() { peer.send_event(event); } }, Async::Ready(NetworkBehaviourAction::ReportObservedAddr { address }) => { for addr in self.raw_swarm.nat_traversal(&address) { if self.external_addrs.iter().all(|a| *a != addr) { self.external_addrs.push(addr); } } }, } } } } /// Parameters passed to `poll()`, that the `NetworkBehaviour` has access to. // TODO: #[derive(Debug)] pub struct PollParameters<'a: 'a> { local_peer_id: &'a PeerId, supported_protocols: &'a [Vec], listened_addrs: &'a [Multiaddr], external_addrs: &'a [Multiaddr], nat_traversal: &'a dyn Fn(&Multiaddr, &Multiaddr) -> Option, } impl<'a> PollParameters<'a> { /// Returns the list of protocol the behaviour supports when a remote negotiates a protocol on /// an inbound substream. /// /// The iterator's elements are the ASCII names as reported on the wire. /// /// Note that the list is computed once at initialization and never refreshed. #[inline] pub fn supported_protocols(&self) -> impl ExactSizeIterator { self.supported_protocols.iter().map(AsRef::as_ref) } /// Returns the list of the addresses we're listening on. #[inline] pub fn listened_addresses(&self) -> impl ExactSizeIterator { self.listened_addrs.iter() } /// Returns the list of the addresses nodes can use to reach us. #[inline] pub fn external_addresses(&self) -> impl ExactSizeIterator { self.external_addrs.iter() } /// Returns the peer id of the local node. #[inline] pub fn local_peer_id(&self) -> &PeerId { self.local_peer_id } /// Calls the `nat_traversal` method on the underlying transport of the `Swarm`. #[inline] pub fn nat_traversal(&self, server: &Multiaddr, observed: &Multiaddr) -> Option { (self.nat_traversal)(server, observed) } } pub struct SwarmBuilder { incoming_limit: Option, local_peer_id: PeerId, transport: TTransport, behaviour: TBehaviour, } impl SwarmBuilder where TBehaviour: NetworkBehaviour, TMuxer: StreamMuxer + Send + Sync + 'static, ::OutboundSubstream: Send + 'static, ::Substream: Send + 'static, TTransport: Transport + Clone, TTransport::Error: Send + 'static, TTransport::Listener: Send + 'static, TTransport::ListenerUpgrade: Send + 'static, TTransport::Dial: Send + 'static, ::ProtocolsHandler: Send + 'static, <::ProtocolsHandler as IntoProtocolsHandler>::Handler: ProtocolsHandler> + Send + 'static, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InEvent: Send + 'static, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutEvent: Send + 'static, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::Error: Send + 'static, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol: InboundUpgrade> + Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::Info: Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Error: fmt::Debug + Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::InboundProtocol as InboundUpgrade>>::Future: Send + 'static, <<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol: OutboundUpgrade> + Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::Info: Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter: Send + 'static, <<<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol as UpgradeInfo>::InfoIter as IntoIterator>::IntoIter: Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Future: Send + 'static, <<<::ProtocolsHandler as IntoProtocolsHandler>::Handler as ProtocolsHandler>::OutboundProtocol as OutboundUpgrade>>::Error: fmt::Debug + Send + 'static, ::ProtocolsHandler as IntoProtocolsHandler>::Handler> as NodeHandler>::OutboundOpenInfo: Send + 'static, // TODO: shouldn't be necessary { pub fn new(transport: TTransport, behaviour: TBehaviour, local_peer_id: PeerId) -> Self { SwarmBuilder { incoming_limit: None, local_peer_id, transport, behaviour, } } pub fn incoming_limit(mut self, incoming_limit: Option) -> Self { self.incoming_limit = incoming_limit; self } pub fn build(mut self) -> Swarm { let supported_protocols = self.behaviour .new_handler() .into_handler(&self.local_peer_id) .listen_protocol() .into_upgrade() .protocol_info() .into_iter() .map(|info| info.protocol_name().to_vec()) .collect(); let raw_swarm = RawSwarm::new_with_incoming_limit(self.transport, self.local_peer_id, self.incoming_limit); ExpandedSwarm { raw_swarm, behaviour: self.behaviour, supported_protocols, listened_addrs: SmallVec::new(), external_addrs: SmallVec::new(), } } } #[cfg(test)] mod tests { use crate::{identity, PeerId, PublicKey}; use crate::protocols_handler::{DummyProtocolsHandler, ProtocolsHandler}; use crate::swarm::{ConnectedPoint, NetworkBehaviour, NetworkBehaviourAction, PollParameters, SwarmBuilder}; use crate::tests::dummy_transport::DummyTransport; use futures::prelude::*; use multiaddr::Multiaddr; use std::marker::PhantomData; use tokio_io::{AsyncRead, AsyncWrite}; use void::Void; #[derive(Clone)] struct DummyBehaviour { marker: PhantomData, } trait TSubstream: AsyncRead + AsyncWrite {} impl NetworkBehaviour for DummyBehaviour where TSubstream: AsyncRead + AsyncWrite { type ProtocolsHandler = DummyProtocolsHandler; type OutEvent = Void; fn new_handler(&mut self) -> Self::ProtocolsHandler { DummyProtocolsHandler::default() } fn addresses_of_peer(&mut self, _: &PeerId) -> Vec { Vec::new() } fn inject_connected(&mut self, _: PeerId, _: ConnectedPoint) {} fn inject_disconnected(&mut self, _: &PeerId, _: ConnectedPoint) {} fn inject_node_event(&mut self, _: PeerId, _: ::OutEvent) {} fn poll(&mut self, _: &mut PollParameters<'_>) -> Async::InEvent, Self::OutEvent>> { Async::NotReady } } fn get_random_id() -> PublicKey { identity::Keypair::generate_ed25519().public() } #[test] fn test_build_swarm() { let id = get_random_id(); let transport = DummyTransport::new(); let behaviour = DummyBehaviour{marker: PhantomData}; let swarm = SwarmBuilder::new(transport, behaviour, id.into()) .incoming_limit(Some(4)).build(); assert_eq!(swarm.raw_swarm.incoming_limit(), Some(4)); } #[test] fn test_build_swarm_with_max_listeners_none() { let id = get_random_id(); let transport = DummyTransport::new(); let behaviour = DummyBehaviour{marker: PhantomData}; let swarm = SwarmBuilder::new(transport, behaviour, id.into()).build(); assert!(swarm.raw_swarm.incoming_limit().is_none()) } }