Struct NodeAnnouncement

pub struct NodeAnnouncement {
    pub version: u8,
    pub features: Features,
    pub timestamp: Timestamp,
    pub alias: Alias,
    pub addresses: BoundedVec<Address, ADDRESS_LIMIT>,
    pub nonce: u64,
    pub agent: UserAgent,
}

Node announcing itself to the network.

Fields

version: u8

Supported protocol version.

features: Features

Advertized features.

timestamp: Timestamp

Monotonic timestamp.

alias: Alias

Non-unique alias.

addresses: BoundedVec<Address, ADDRESS_LIMIT>

Announced addresses.

nonce: u64

Nonce used for announcement proof-of-work.

agent: UserAgent

User-agent string.

Implementations

impl NodeAnnouncement

pub fn work(&self) -> u32

Calculate the amount of work that went into creating this announcement.

Proof-of-work uses the scrypt algorithm with the parameters in Announcement::POW_PARAMS. The “work” is calculated by counting the number of leading zero bits after running scrypt on a serialized NodeAnnouncement using wire::serialize.

In other words, work = leading-zeros(scrypt(serialize(announcement))).

Higher numbers mean higher difficulty. For each increase in work, difficulty is doubled. For instance, an output of 7 is four times more work than an output of 5.

pub fn solve(self, target: u32) -> Option<Self>

Solve the proof-of-work of a node announcement for the given target, by iterating through different nonces.

If the given difficulty target is too high, there may not be a result. In that case, None is returned.

Trait Implementations

impl BindableWithIndex for &NodeAnnouncement

fn bind<I: ParameterIndex>(self, stmt: &mut Statement<'_>, i: I) -> Result<()>

Bind to a parameter.

impl Clone for NodeAnnouncement

fn clone(&self) -> NodeAnnouncement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeAnnouncement

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

Formats the value using the given formatter.

impl Decode for NodeAnnouncement

fn decode(buf: &mut impl Buf) -> Result<Self, Error>

impl Encode for NodeAnnouncement

fn encode(&self, buf: &mut impl BufMut)

impl From<NodeAnnouncement> for AnnouncementMessage

fn from(ann: NodeAnnouncement) -> Self

Converts to this type from the input type.

impl PartialEq for NodeAnnouncement

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

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &Value) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for NodeAnnouncement

impl StructuralPartialEq for NodeAnnouncement