Enum Protocol

#[non_exhaustive]
pub enum Protocol<'a> {
    Dccp(u16),
    Dns(Cow<'a, str>),
    Dns4(Cow<'a, str>),
    Dns6(Cow<'a, str>),
    Dnsaddr(Cow<'a, str>),
    Http,
    Https,
    Ip4(Ipv4Addr),
    Ip6(Ipv6Addr),
    P2pWebRtcDirect,
    P2pWebRtcStar,
    WebRTCDirect,
    Certhash(Multihash<64>),
    P2pWebSocketStar,
    Memory(u64),
    Onion(Cow<'a, [u8; 10]>, u16),
    Onion3(Onion3Addr<'a>),
    P2p(PeerId),
    P2pCircuit,
    Quic,
    QuicV1,
    Sctp(u16),
    Tcp(u16),
    Tls,
    Noise,
    Udp(u16),
    Udt,
    Unix(Cow<'a, str>),
    Utp,
    WebTransport,
    Ws(Cow<'a, str>),
    Wss(Cow<'a, str>),
    Ip6zone(Cow<'a, str>),
    Ipcidr(u8),
    Garlic64(Cow<'a, [u8]>),
    Garlic32(Cow<'a, [u8]>),
    Sni(Cow<'a, str>),
    P2pStardust,
    WebRTC,
}

Protocol describes all possible multiaddress protocols.

For Unix, Ws and Wss we use &str instead of Path to allow cross-platform usage of Protocol since encoding Paths to bytes is platform-specific. This means that the actual validation of paths needs to happen separately.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Dccp(u16)

Dns(Cow<'a, str>)

Dns4(Cow<'a, str>)

Dns6(Cow<'a, str>)

Dnsaddr(Cow<'a, str>)

Http

Https

Ip4(Ipv4Addr)

Ip6(Ipv6Addr)

P2pWebRtcDirect

P2pWebRtcStar

WebRTCDirect

Certhash(Multihash<64>)

P2pWebSocketStar

Memory(u64)

Contains the “port” to contact. Similar to TCP or UDP, 0 means “assign me a port”.

Onion(Cow<'a, [u8; 10]>, u16)

Onion3(Onion3Addr<'a>)

P2p(PeerId)

P2pCircuit

Quic

QuicV1

Sctp(u16)

Tcp(u16)

Tls

Noise

Udp(u16)

Udt

Unix(Cow<'a, str>)

Utp

WebTransport

Ws(Cow<'a, str>)

Wss(Cow<'a, str>)

Ip6zone(Cow<'a, str>)

Ipcidr(u8)

Garlic64(Cow<'a, [u8]>)

Garlic32(Cow<'a, [u8]>)

Sni(Cow<'a, str>)

P2pStardust

WebRTC

Implementations

impl<'a> Protocol<'a>

pub fn from_str_parts<I>(iter: I) -> Result<Protocol<'a>, Error>

where I: Iterator<Item = &'a str>,

Parse a protocol value from the given iterator of string slices.

The parsing only consumes the minimum amount of string slices necessary to produce a well-formed protocol. The same iterator can thus be used to parse a sequence of protocols in succession. It is up to client code to check that iteration has finished whenever appropriate.

pub fn from_bytes(input: &'a [u8]) -> Result<(Protocol<'a>, &'a [u8]), Error>

Parse a single Protocol value from its byte slice representation, returning the protocol as well as the remaining byte slice.

pub fn write_bytes<W>(&self, w: &mut W) -> Result<(), Error>

where W: Write,

Encode this protocol by writing its binary representation into the given Write impl.

pub fn acquire<'b>(self) -> Protocol<'b>

Turn this Protocol into one that owns its data, thus being valid for any lifetime.

pub fn tag(&self) -> &'static str

Trait Implementations

impl<'a> Clone for Protocol<'a>

fn clone(&self) -> Protocol<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Protocol<'a>

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

Formats the value using the given formatter.

impl<'a> Display for Protocol<'a>

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

Formats the value using the given formatter.

impl<'a> From<IpAddr> for Protocol<'a>

fn from(addr: IpAddr) -> Protocol<'a>

Converts to this type from the input type.

impl<'a> From<Ipv4Addr> for Protocol<'a>

fn from(addr: Ipv4Addr) -> Protocol<'a>

Converts to this type from the input type.

impl<'a> From<Ipv6Addr> for Protocol<'a>

fn from(addr: Ipv6Addr) -> Protocol<'a>

Converts to this type from the input type.

impl<'a> From<Protocol<'a>> for Multiaddr

fn from(p: Protocol<'a>) -> Multiaddr

Converts to this type from the input type.

impl<'a> FromIterator<Protocol<'a>> for Multiaddr

fn from_iter<T>(iter: T) -> Multiaddr

where T: IntoIterator<Item = Protocol<'a>>,

Creates a value from an iterator.

impl<'a> PartialEq for Protocol<'a>

fn eq(&self, other: &Protocol<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Protocol<'a>

impl<'a> StructuralPartialEq for Protocol<'a>