Enum SocketAddress

pub enum SocketAddress {
    TcpIpV4 {
        addr: [u8; 4],
        port: u16,
    },
    TcpIpV6 {
        addr: [u8; 16],
        port: u16,
    },
    OnionV2([u8; 12]),
    OnionV3 {
        ed25519_pubkey: [u8; 32],
        checksum: u16,
        version: u8,
        port: u16,
    },
    Hostname {
        hostname: Hostname,
        port: u16,
    },
}

An address which can be used to connect to a remote peer.

Variants

TcpIpV4

An IPv4 address and port on which the peer is listening.

Fields

addr: [u8; 4]

The 4-byte IPv4 address

port: u16

The port on which the node is listening

TcpIpV6

An IPv6 address and port on which the peer is listening.

Fields

addr: [u8; 16]

The 16-byte IPv6 address

port: u16

The port on which the node is listening

OnionV2([u8; 12])

An old-style Tor onion address/port on which the peer is listening.

This field is deprecated and the Tor network generally no longer supports V2 Onion addresses. Thus, the details are not parsed here.

OnionV3

A new-style Tor onion address/port on which the peer is listening.

To create the human-readable “hostname”, concatenate the ED25519 pubkey, checksum, and version, wrap as base32 and append “.onion”.

Fields

ed25519_pubkey: [u8; 32]

The ed25519 long-term public key of the peer

checksum: u16

The checksum of the pubkey and version, as included in the onion address

version: u8

The version byte, as defined by the Tor Onion v3 spec.

port: u16

The port on which the node is listening

Hostname

A hostname/port on which the peer is listening.

Fields

hostname: Hostname

The hostname on which the node is listening.

port: u16

The port on which the node is listening.

Trait Implementations

impl Clone for SocketAddress

fn clone(&self) -> SocketAddress

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SocketAddress

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

Formats the value using the given formatter.

impl Display for SocketAddress

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

Formats the value using the given formatter.

impl From<SocketAddr> for SocketAddress

fn from(addr: SocketAddr) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddrV4> for SocketAddress

fn from(addr: SocketAddrV4) -> SocketAddress

Converts to this type from the input type.

impl From<SocketAddrV6> for SocketAddress

fn from(addr: SocketAddrV6) -> SocketAddress

Converts to this type from the input type.

impl FromStr for SocketAddress

type Err = SocketAddressParseError

The associated error which can be returned from parsing.

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

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

impl PartialEq for SocketAddress

fn eq(&self, other: &SocketAddress) -> 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 Readable for SocketAddress

fn read<R>(reader: &mut R) -> Result<SocketAddress, DecodeError>

where R: Read,

Reads a Self in from the given Read.

impl ToSocketAddrs for SocketAddress

type Iter = IntoIter<SocketAddr>

Returned iterator over socket addresses which this type may correspond to.

fn to_socket_addrs( &self, ) -> Result<<SocketAddress as ToSocketAddrs>::Iter, Error>

Converts this object to an iterator of resolved SocketAddrs.

impl Writeable for SocketAddress

fn write<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Writer,

Writes self out to the given Writer.

fn encode(&self) -> Vec<u8>

Writes self out to a Vec<u8>.

fn serialized_length(&self) -> usize

Gets the length of this object after it has been serialized. This can be overridden to optimize cases where we prepend an object with its length.

impl Eq for SocketAddress

impl StructuralPartialEq for SocketAddress