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 duplicate 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

Formats the value using the given formatter.

impl Display for SocketAddress

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

Formats the value using the given formatter.

impl From<SocketAddr> for SocketAddress

Available on crate feature std only.

fn from(addr: SocketAddr) -> Self

Converts to this type from the input type.

impl From<SocketAddrV4> for SocketAddress

Available on crate feature std only.

fn from(addr: SocketAddrV4) -> Self

Converts to this type from the input type.

impl From<SocketAddrV6> for SocketAddress

Available on crate feature std only.

fn from(addr: SocketAddrV6) -> Self

Converts to this type from the input type.

impl FromStr for SocketAddress

Available on crate feature std only.

type Err = SocketAddressParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl Hash for SocketAddress

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

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: Read>(reader: &mut R) -> Result<SocketAddress, DecodeError>

Reads a Self in from the given Read.

impl ToSocketAddrs for SocketAddress

Available on crate feature std only.

type Iter = IntoIter<SocketAddr>

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

fn to_socket_addrs(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved SocketAddrs.

impl Writeable for SocketAddress

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

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