Enum libp2p_kad::handler::KademliaHandlerIn

pub enum KademliaHandlerIn<TUserData> {
    FindNodeReq {
        key: Multihash,
        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,
    },
    GetValue {
        key: Multihash,
        user_data: TUserData,
    },
    GetValueRes {
        result: Option<Record>,
        closer_peers: Vec<KadPeer>,
        request_id: KademliaRequestId,
    },
    PutValue {
        key: Multihash,
        value: Vec<u8>,
        user_data: TUserData,
    },
    PutValueRes {
        key: Multihash,
        value: Vec<u8>,
        request_id: KademliaRequestId,
    },
}

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: Multihash

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.

GetValue

Request to get a node from the dht

Fields of GetValue

key: Multihash

The key of the value we are looking for

user_data: TUserData

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

GetValueRes

Response to a GetValue.

Fields of GetValueRes

result: Option<Record>

The value that might have been found in our storage.

closer_peers: Vec<KadPeer>

Nodes that are closer to the key we were searching for.

request_id: KademliaRequestId

Identifier of the request that was made by the remote.

PutValue

Put a value into the dht records.

Fields of PutValue

key: Multihash

The key of the record.

value: Vec<u8>

The value of the record.

user_data: TUserData

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

PutValueRes

Response to a PutValue.

Fields of PutValueRes

key: Multihash

Key of the value that was put.

value: Vec<u8>

Value that was put.

request_id: KademliaRequestId

Identifier of the request that was made by the remote.

Trait Implementations

impl<TUserData: Debug> Debug for KademliaHandlerIn<TUserData>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.