Enum libp2p_kad::handler::KademliaHandlerIn

pub enum KademliaHandlerIn<TUserData> {
    FindNodeReq {
        key: PeerId,
        user_data: TUserData,
    },
    FindNodeRes {
        closer_peers: Vec<KadPeer>,
        request_id: KademliaRequestId,
    },
    GetProvidersReq {
        key: Multihash,
        user_data: TUserData,
    },
    GetProvidersRes {
        closer_peers: Vec<KadPeer>,
        provider_peers: Vec<KadPeer>,
        request_id: KademliaRequestId,
    },
    AddProvider {
        key: Multihash,
        provider_peer: KadPeer,
    },
}

Event to send to the handler.

Variants

FindNodeReq

Request for the list of nodes whose IDs are the closest to key. The number of nodes returned is not specified, but should be around 20.

Fields of FindNodeReq

key: PeerId

Identifier of the node.

user_data: TUserData

Custom user data. Passed back in the out event when the results arrive.

FindNodeRes

Response to a FindNodeReq.

Fields of FindNodeRes

closer_peers: Vec<KadPeer>

Results of the request.

request_id: KademliaRequestId

Identifier of the request that was made by the remote.

It is a logic error to use an id of the handler of a different node.

GetProvidersReq

Same as FindNodeReq, but should also return the entries of the local providers list for this key.

Fields of GetProvidersReq

key: Multihash

Identifier being searched.

user_data: TUserData

Custom user data. Passed back in the out event when the results arrive.

GetProvidersRes

Response to a GetProvidersReq.

Fields of GetProvidersRes

closer_peers: Vec<KadPeer>

Nodes closest to the key.

provider_peers: Vec<KadPeer>

Known providers for this key.

request_id: KademliaRequestId

Identifier of the request that was made by the remote.

It is a logic error to use an id of the handler of a different node.

AddProvider

Indicates that this provider is known for this key.

The API of the handler doesn't expose any event that allows you to know whether this succeeded.

Fields of AddProvider

key: Multihash

Key for which we should add providers.

provider_peer: KadPeer

Known provider for this key.