Skip to main content

Discv5State

Struct Discv5State 

Source
pub struct Discv5State {
    pub counter: u32,
    pub pending_by_nonce: FxHashMap<[u8; 12], (Node, Message, Instant)>,
    pub pending_challenges: FxHashMap<H256, (Vec<u8>, Instant, Vec<u8>)>,
    pub whoareyou_rate_limit: LruCache<(IpAddr, H256), Instant>,
    pub whoareyou_global_count: u32,
    pub whoareyou_global_window_start: Instant,
    pub session_ips: FxHashMap<H256, IpAddr>,
    pub ip_votes: FxHashMap<IpAddr, FxHashSet<H256>>,
    pub ip_vote_period_start: Option<Instant>,
    pub first_ip_vote_round_completed: bool,
    pub active_lookups: Vec<IterativeLookup>,
}
Expand description

Discv5-specific state held within the unified DiscoveryServer.

Fields§

§counter: u32

Outgoing message count, used for nonce generation as per the spec.

§pending_by_nonce: FxHashMap<[u8; 12], (Node, Message, Instant)>

Pending outgoing messages awaiting WhoAreYou response, keyed by nonce.

§pending_challenges: FxHashMap<H256, (Vec<u8>, Instant, Vec<u8>)>

Pending WhoAreYou challenges awaiting Handshake response, keyed by src_id. Tuple: (challenge_data, timestamp, encoded_packet_bytes).

§whoareyou_rate_limit: LruCache<(IpAddr, H256), Instant>

Tracks last WHOAREYOU send time per (source IP, node ID) to prevent amplification attacks.

§whoareyou_global_count: u32

Global WHOAREYOU rate limit: count of packets sent in the current second.

§whoareyou_global_window_start: Instant

Start of the current global rate limit window.

§session_ips: FxHashMap<H256, IpAddr>

Tracks the source IP that each session was established from.

§ip_votes: FxHashMap<IpAddr, FxHashSet<H256>>

Collects recipient_addr IPs from PONGs for external IP detection via majority voting.

§ip_vote_period_start: Option<Instant>

When the current IP voting period started. None if no votes received yet.

§first_ip_vote_round_completed: bool

Whether the first (fast) voting round has completed.

§active_lookups: Vec<IterativeLookup>

Currently active iterative lookups.

Implementations§

Source§

impl Discv5State

Source

pub fn next_nonce<R: RngCore>(&mut self, rng: &mut R) -> [u8; 12]

Generates a 96-bit AES-GCM nonce. Encodes the current outgoing message count into the first 32 bits and fills the remaining 64 bits with random data.

Source

pub fn cleanup_stale_entries(&mut self) -> Option<IpAddr>

Remove stale entries from caches. Returns Some(ip) if a timed-out IP voting round produced a winning IP to apply.

Source

pub fn record_ip_vote( &mut self, reported_ip: IpAddr, voter_id: H256, ) -> Option<IpAddr>

Records an IP vote from a PONG recipient_addr. Returns Some(ip) if the voting round ended with a winning IP to apply.

Source

pub fn is_private_ip(ip: IpAddr) -> bool

Returns true if the IP is private/local (not useful for external connectivity).

Trait Implementations§

Source§

impl Debug for Discv5State

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Discv5State

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> ArchivePointee for T

Source§

type ArchivedMetadata = ()

The archived version of the pointer metadata for this type.
Source§

fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata, ) -> <T as Pointee>::Metadata

Converts some archived metadata to the pointer metadata for itself.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T, U> ExactFrom<T> for U
where U: TryFrom<T>,

Source§

fn exact_from(value: T) -> U

Source§

impl<T, U> ExactInto<U> for T
where U: ExactFrom<T>,

Source§

fn exact_into(self) -> U

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> LayoutRaw for T

Source§

fn layout_raw(_: <T as Pointee>::Metadata) -> Result<Layout, LayoutError>

Returns the layout of the type.
Source§

impl<T, N1, N2> Niching<NichedOption<T, N1>> for N2
where T: SharedNiching<N1, N2>, N1: Niching<T>, N2: Niching<T>,

Source§

unsafe fn is_niched(niched: *const NichedOption<T, N1>) -> bool

Returns whether the given value has been niched. Read more
Source§

fn resolve_niched(out: Place<NichedOption<T, N1>>)

Writes data to out indicating that a T is niched.
Source§

impl<T, U> OverflowingInto<U> for T
where U: OverflowingFrom<T>,

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Pointee for T

Source§

type Metadata = ()

The metadata type for pointers and references to this type.
Source§

impl<T, U> RoundingInto<U> for T
where U: RoundingFrom<T>,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> SaturatingInto<U> for T
where U: SaturatingFrom<T>,

Source§

impl<T> ToDebugString for T
where T: Debug,

Source§

fn to_debug_string(&self) -> String

Returns the String produced by Ts Debug implementation.

§Examples
use malachite_base::strings::ToDebugString;

assert_eq!([1, 2, 3].to_debug_string(), "[1, 2, 3]");
assert_eq!(
    [vec![2, 3], vec![], vec![4]].to_debug_string(),
    "[[2, 3], [], [4]]"
);
assert_eq!(Some(5).to_debug_string(), "Some(5)");
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T, U> WrappingInto<U> for T
where U: WrappingFrom<T>,

Source§

fn wrapping_into(self) -> U