Struct VersionMessage 

pub struct VersionMessage {
    pub version: Version,
    pub services: PeerServices,
    pub timestamp: DateTime<Utc>,
    pub address_recv: AddrInVersion,
    pub address_from: AddrInVersion,
    pub nonce: Nonce,
    pub user_agent: String,
    pub start_height: Height,
    pub relay: bool,
}

A version message.

Note that although this is called version in Bitcoin, its role is really analogous to a ClientHello message in TLS, used to begin a handshake, and is distinct from a simple version number.

This struct provides a type that is guaranteed to be a version message, and allows Message::Version fields to be accessed directly.

Bitcoin reference

Fields

version: Version

The network version number supported by the sender.

services: PeerServices

The network services advertised by the sender.

timestamp: DateTime<Utc>

The time when the version message was sent.

This is a 64-bit field. Zebra rejects out-of-range times as invalid.

TODO: replace with a custom DateTime64 type (#2171)

address_recv: AddrInVersion

The network address of the node receiving this message, and its advertised network services.

Q: how does the handshake know the remote peer’s services already?

address_from: AddrInVersion

The network address of the node sending this message, and its advertised network services.

nonce: Nonce

Node random nonce, randomly generated every time a version packet is sent. This nonce is used to detect connections to self.

user_agent: String

The Zcash user agent advertised by the sender.

start_height: Height

The last block received by the emitting node.

relay: bool

Whether the remote peer should announce relayed transactions or not, see BIP 0037.

Zebra does not implement the bloom filters in BIP 0037. Instead, it only relays:

• newly verified best chain block hashes and mempool transaction IDs,
• after it reaches the chain tip.

Trait Implementations

impl Arbitrary for VersionMessage

type Parameters = (<Version as Arbitrary>::Parameters, <PeerServices as Arbitrary>::Parameters, <AddrInVersion as Arbitrary>::Parameters, <AddrInVersion as Arbitrary>::Parameters, <Nonce as Arbitrary>::Parameters, <String as Arbitrary>::Parameters, <Height as Arbitrary>::Parameters, <bool as Arbitrary>::Parameters)

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

type Strategy = Map<(<Version as Arbitrary>::Strategy, <PeerServices as Arbitrary>::Strategy, BoxedStrategy<DateTime<Utc>>, <AddrInVersion as Arbitrary>::Strategy, <AddrInVersion as Arbitrary>::Strategy, <Nonce as Arbitrary>::Strategy, <String as Arbitrary>::Strategy, <Height as Arbitrary>::Strategy, <bool as Arbitrary>::Strategy), fn((Version, PeerServices, DateTime<Utc>, AddrInVersion, AddrInVersion, Nonce, String, Height, bool)) -> VersionMessage>

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 VersionMessage

fn clone(&self) -> VersionMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VersionMessage

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

Formats the value using the given formatter.

impl From<VersionMessage> for Message

fn from(version_message: VersionMessage) -> Self

Converts to this type from the input type.

impl PartialEq for VersionMessage

fn eq(&self, other: &VersionMessage) -> 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 TryFrom<Message> for VersionMessage

type Error = Box<dyn Error + Sync + Send>

The type returned in the event of a conversion error.

fn try_from(message: Message) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for VersionMessage

impl StructuralPartialEq for VersionMessage

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: 144 bytes