Enum AddrV2 

pub(in protocol::external) enum AddrV2 {
    IpAddr {
        untrusted_last_seen: DateTime32,
        untrusted_services: PeerServices,
        addr: PeerSocketAddr,
    },
    Unsupported,
}

The second format used for Bitcoin node addresses. Contains a node address, its advertised services, and last-seen time. This struct is serialized and deserialized into addrv2 messages.

ZIP 155

Variants

IpAddr

An IPv4 or IPv6 node address, in addrv2 format.

Fields

untrusted_last_seen: DateTime32

The unverified “last seen time” gossiped by the remote peer that sent us this address.

See the MetaAddr::last_seen method for details.

untrusted_services: PeerServices

The unverified services for the peer at ip_addr:port.

These services were advertised by the peer at that address, then gossiped via another peer.

Security

untrusted_services on gossiped peers may be invalid due to outdated records, older peer versions, or buggy or malicious peers.

addr: PeerSocketAddr

The peer’s canonical IP address and port.

Unlike AddrV1, this can be an IPv4 or IPv6 address.

Unsupported

A node address with an unsupported networkID, in addrv2 format.

Implementations

impl AddrV2

fn ip_addr_from_bytes<const IP_ADDR_SIZE: usize>( addr_bytes: Vec<u8>, ) -> Result<IpAddr, SerializationError>

where IpAddr: From<[u8; IP_ADDR_SIZE]>,

Deserialize addr_bytes as an IPv4 or IPv6 address, using the addrv2 format. Returns the corresponding IpAddr.

The returned IP version is chosen based on IP_ADDR_SIZE, which should be ADDR_V2_IPV4_ADDR_SIZE or ADDR_V2_IPV6_ADDR_SIZE.

Trait Implementations

impl Arbitrary for AddrV2

type Parameters = (<DateTime32 as Arbitrary>::Parameters, <PeerServices as Arbitrary>::Parameters, <PeerSocketAddr as Arbitrary>::Parameters)

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = TupleUnion<((u32, Arc<Map<(<DateTime32 as Arbitrary>::Strategy, <PeerServices as Arbitrary>::Strategy, <PeerSocketAddr as Arbitrary>::Strategy), fn((DateTime32, PeerServices, PeerSocketAddr)) -> AddrV2>>), (u32, Arc<fn() -> AddrV2>))>

The type of Strategy used to generate values of type Self.

fn arbitrary_with(_top: Self::Parameters) -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl Clone for AddrV2

fn clone(&self) -> AddrV2

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddrV2

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

Formats the value using the given formatter.

impl Hash for AddrV2

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 AddrV2

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

fn max_allocation() -> u64

Provides a loose upper bound on the size of the Vec<T: TrustedPreallocate> which can possibly be received from an honest peer.

impl TryFrom<AddrV2> for MetaAddr

type Error = UnsupportedAddrV2NetworkIdError

The type returned in the event of a conversion error.

fn try_from(addr: AddrV2) -> Result<MetaAddr, UnsupportedAddrV2NetworkIdError>

Performs the conversion.

impl ZcashDeserialize for AddrV2

Deserialize an addrv2 entry according to: https://zips.z.cash/zip-0155#specification

Unimplemented and unrecognised addresses are deserialized as AddrV2::Unsupported. (Deserialization consumes the correct number of bytes for unsupported addresses.)

fn zcash_deserialize<R: Read>(reader: R) -> Result<Self, SerializationError>

Try to read self from the given reader.

impl Copy for AddrV2

impl Eq for AddrV2

impl StructuralPartialEq for AddrV2

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 48 bytes

Size for each variant:

• IpAddr: 44 bytes
• Unsupported: 0 bytes