Struct libp2p_kad::Kademlia

pub struct Kademlia<TSubstream> { /* private fields */ }

Network behaviour that handles Kademlia.

Implementations

impl<TSubstream> Kademlia<TSubstream>

pub fn new(local_peer_id: PeerId) -> Self

Creates a Kademlia.

pub fn without_init(local_peer_id: PeerId) -> Self

Creates a Kademlia.

Contrary to new, doesn’t perform the initialization queries that store our local ID into the DHT.

impl<TSubstream> Kademlia<TSubstream>

pub fn find_node(&mut self, peer_id: PeerId)

Starts an iterative FIND_NODE request.

This will eventually produce an event containing the nodes of the DHT closest to the requested PeerId.

pub fn get_providers(&mut self, key: Multihash)

Starts an iterative GET_PROVIDERS request.

pub fn add_providing(&mut self, key: PeerId)

Register the local node as the provider for the given key.

This will periodically send ADD_PROVIDER messages to the nodes closest to the key. When someone performs a GET_PROVIDERS iterative request on the DHT, our local node will be returned as part of the results.

The actual meaning of providing the value of a key is not defined, and is specific to the value whose key is the hash.

pub fn remove_providing(&mut self, key: &Multihash)

Cancels a registration done with add_providing.

There doesn’t exist any “remove provider” message to broadcast on the network, therefore we will still be registered as a provider in the DHT for as long as the timeout doesn’t expire.

Trait Implementations

impl<TSubstream, TTopology> NetworkBehaviour<TTopology> for Kademlia<TSubstream>where
    TSubstream: AsyncRead + AsyncWrite,
    TTopology: KademliaTopology,

type ProtocolsHandler = KademliaHandler<TSubstream, QueryId>

Handler for all the protocols the network supports.

type OutEvent = KademliaOut

Event generated by the swarm.

fn new_handler(&mut self) -> Self::ProtocolsHandler

Builds a new ProtocolsHandler.

fn inject_connected(&mut self, id: PeerId, _: ConnectedPoint)

Indicates the behaviour that we connected to the node with the given peer id through the given endpoint.

fn inject_disconnected(&mut self, id: &PeerId, _: ConnectedPoint)

Indicates the behaviour that we disconnected from the node with the given peer id. The endpoint is the one we used to be connected to.

fn inject_node_event(
    &mut self,
    source: PeerId,
    event: KademliaHandlerEvent<QueryId>
)

Indicates the behaviour that the node with the given peer id has generated an event for us.

fn poll(
    &mut self,
    parameters: &mut PollParameters<'_, TTopology>
) -> Async<NetworkBehaviourAction<<Self::ProtocolsHandler as ProtocolsHandler>::InEvent, Self::OutEvent>>

Polls for things that swarm should do.