Struct pea2pea::Node

pub struct Node(_);

The central object responsible for handling all the connections.

Implementations

impl Node

pub async fn new(config: Option<NodeConfig>) -> Result<Self>

Creates a new Node optionally using a given NodeConfig.

pub fn name(&self) -> &str

Returns the name assigned to the node.

pub fn config(&self) -> &NodeConfig

Returns a reference to the node's config.

pub fn stats(&self) -> &NodeStats

Returns a reference to the node's stats.

pub fn span(&self) -> &Span

Returns the tracing Span associated with the node.

pub fn listening_addr(&self) -> SocketAddr

Returns the node's listening address.

pub async fn connect(&self, addr: SocketAddr) -> Result<()>

Connects to the provided SocketAddr.

pub fn disconnect(&self, addr: SocketAddr) -> bool

Disconnects from the provided SocketAddr.

pub async fn send_direct_message(
    &self,
    addr: SocketAddr,
    message: Bytes
) -> Result<()>

Sends the provided message to the specified SocketAddr, as long as the Writing protocol is enabled.

pub async fn send_broadcast(&self, message: Bytes) -> Result<()>

Broadcasts the provided message to all peers, as long as the Writing protocol is enabled.

pub fn connected_addrs(&self) -> Vec<SocketAddr>

Returns a list containing addresses of active connections.

pub fn known_peers(&self) -> &KnownPeers

Returns a reference to the collection of statistics of node's known peers.

pub fn is_connected(&self, addr: SocketAddr) -> bool

Checks whether the provided address is connected.

pub fn num_connected(&self) -> usize

Returns the number of active connections.

pub fn set_handshake_handler(&self, handler: ProtocolHandler)

Sets up the handshake handler, as part of the Handshaking protocol.

pub fn set_reading_handler(&self, handler: ProtocolHandler)

Sets up the reading handler, as part of enabling the Reading protocol.

pub fn set_writing_handler(&self, handler: ProtocolHandler)

Sets up the writing handler, as part of enabling the Writing protocol.

pub fn shut_down(&self)

Gracefully shuts the node down.

Methods from Deref<Target = Arc<InnerNode>>

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Deref for Node

type Target = Arc<InnerNode>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.