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