Struct libp2p::PeerId

pub struct PeerId { /* fields omitted */ }

Identifier of a peer of the network.

The data is a multihash of the public key of the peer.

Implementations

impl PeerId

pub fn from_public_key(key: PublicKey) -> PeerId

Builds a PeerId from a public key.

pub fn from_bytes(data: &[u8]) -> Result<PeerId, Error>

Parses a PeerId from bytes.

pub fn from_multihash(
    multihash: Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>
) -> Result<PeerId, Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>>

Tries to turn a Multihash into a PeerId.

If the multihash does not use a valid hashing algorithm for peer IDs, or the hash value does not satisfy the constraints for a hashed peer ID, it is returned as an Err.

pub fn random_with_pk() -> PeerId

Generates a peerId with a public key in it

pub fn random() -> PeerId

Generates a random peer ID from a cryptographically secure PRNG.

This is useful for randomly walking on a DHT, or for testing purposes.

pub fn to_bytes(&self) -> Vec<u8, Global>

Returns a raw bytes representation of this PeerId.

pub fn to_base58(&self) -> String

Returns a base-58 encoded string of this PeerId.

pub fn is_public_key(&self, public_key: &PublicKey) -> Option<bool>

Checks whether the public key passed as parameter matches the public key of this PeerId.

Returns None if this PeerIds hash algorithm is not supported when encoding the given public key, otherwise Some boolean as the result of an equality check.

pub fn as_public_key(&self) -> Option<PublicKey>

Returns public key if it was inlined in this PeerId.

pub fn is_inlining(&self) -> bool

Returns true if this peer id is inlining (usually means it stores public key)

Trait Implementations

impl AsRef<Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>> for PeerId

pub fn as_ref(
    &self
) -> &Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>

Performs the conversion.

impl Clone for PeerId

pub fn clone(&self) -> PeerId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PeerId

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for PeerId

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<PeerId> for Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>

pub fn from(
    peer_id: PeerId
) -> Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>

Performs the conversion.

impl From<PeerId> for Key<PeerId>

pub fn from(p: PeerId) -> Key<PeerId>

Performs the conversion.

impl From<PublicKey> for PeerId

pub fn from(key: PublicKey) -> PeerId

Performs the conversion.

impl FromStr for PeerId

type Err = ParseError

The associated error which can be returned from parsing.

pub fn from_str(s: &str) -> Result<PeerId, <PeerId as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for PeerId

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for PeerId

pub fn cmp(&self, other: &PeerId) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<PeerId> for PeerId

pub fn eq(&self, other: &PeerId) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &PeerId) -> bool

This method tests for !=.

impl PartialOrd<PeerId> for PeerId

pub fn partial_cmp(&self, other: &PeerId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl TryFrom<Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>> for PeerId

type Error = Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>

The type returned in the event of a conversion error.

pub fn try_from(
    value: Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>
) -> Result<PeerId, <PeerId as TryFrom<Multihash<UInt<UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, B0>>>>::Error>

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for PeerId

type Error = Vec<u8, Global>

The type returned in the event of a conversion error.

pub fn try_from(
    value: Vec<u8, Global>
) -> Result<PeerId, <PeerId as TryFrom<Vec<u8, Global>>>::Error>

Performs the conversion.

impl Copy for PeerId

impl Eq for PeerId

impl StructuralEq for PeerId

impl StructuralPartialEq for PeerId