Enum SoftwareVersionDetail 

pub enum SoftwareVersionDetail {
    Full,
    Minor,
    Off,
}

How much of its own build a node reveals when it advertises (dig_ecosystem#2215).

Advertising an exact build is a fingerprinting aid — it tells an observer precisely which peers run a version with a publicly disclosed defect. This is the operator’s dial between that cost and the diagnostic value of knowing what the network is running.

It lives here, beside PeerSoftware, because rendering and parsing are two halves of one format: a node that hand-rolled its own product/version string would be re-implementing half the contract, and the two halves would drift. A node picks a mode; this type renders it.

Variants

Full

Advertise the exact build, e.g. dig-node/0.99.1. The default: the diagnostic value is why the field exists, and an operator who disagrees opts down explicitly.

Minor

Advertise only the major and minor level, e.g. dig-node/0.99.0. Hides the patch level, and any pre-release or build metadata, while remaining READABLE at the far end.

Off

Advertise nothing. Indistinguishable from a peer built before this field existed, and reads as PeerSoftware::Unknown.

Implementations

impl SoftwareVersionDetail

pub fn render(self, product: &str, version: &Version) -> String

Render the advertisement a node with this setting puts on its handshake.

The result is ALWAYS either the empty string or a value PeerSoftware::parse reads back as Reported. Coarsening reduces PRECISION; it never produces a value that reads as Unknown while pretending to be a report. Two consequences follow, and both are tested:

• Minor renders MAJOR.MINOR.0, never a bare MAJOR.MINOR — two-part versions are not valid semver, so that spelling would read as Unknown and become a second, confusing spelling of Off.
• Minor of a 0.0.x build renders the EMPTY STRING, because its coarsening is version zero and version zero is the “unknown” sentinel. There is no coarser representable value, so it advertises nothing rather than advertising the sentinel as if it were a report.

A coarsened 1.4.0 is indistinguishable from a genuine 1.4.0. That is the point of coarsening, not a defect in it.

Trait Implementations

impl Clone for SoftwareVersionDetail

fn clone(&self) -> SoftwareVersionDetail

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SoftwareVersionDetail

impl Debug for SoftwareVersionDetail

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

Formats the value using the given formatter.

impl Default for SoftwareVersionDetail

fn default() -> SoftwareVersionDetail

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SoftwareVersionDetail

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SoftwareVersionDetail

impl PartialEq for SoftwareVersionDetail

fn eq(&self, other: &SoftwareVersionDetail) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SoftwareVersionDetail

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SoftwareVersionDetail