kitetorrent/io.github.yuroyami.kitetorrent.dht/NodeEntry

NodeEntry

One node in the DHT routing table: the pure-Kotlin port of libtorrent's node_entry (include/libtorrent/kademlia/node_entry.hpp, src/kademlia/node_entry.cpp).

libtorrent stores the endpoint as a union_endpoint (a Boost.Asio address+port). KiteTorrent's commonMain has no socket types, so per the DHT module's contract the endpoint is carried as a host String plus an Int. The host is additionally parsed once into a PeerAddress (addr) so the routing table can do the things that genuinely need the numeric address: the BEP 42 verified check and per-IP de-duplication.

Counters & flags (ported verbatim):

rtt: the smoothed round-trip time in milliseconds; 0xffff means "unknown". updateRtt applies libtorrent's rtt*2/3 + new/3 EWMA.
timeoutCount: consecutive failed requests. The sentinel 0xff means "never pinged" (see pinged); 0 means "confirmed up" (see confirmed).
verified: the node id matches its IP per BEP 42 (verifyId). The "which node is better" ordering (isBetterThan) uses it as the primary key.

This is a mutable value object (libtorrent mutates entries in place inside the buckets), so it is a plain class with var fields rather than a data class.

Constructors

NodeEntry

constructor(id: Sha1Hash, host: String, port: Int, rtt: Int = RTT_UNKNOWN, pinged: Boolean = false)

Full constructor: port of node_entry(node_id const&, udp::endpoint const&, int rtt, bool pinged).

constructor(host: String, port: Int)

Endpoint-only constructor with an unknown (all-zero) id: port of explicit node_entry(udp::endpoint const& ep). Such an entry is "not pinged" and "not verified".

Types

Companion

object Companion

Properties

addr

val addr: PeerAddress?

The numeric form of host, or null if host was not a parseable IP literal. The routing table treats un-parseable hosts as having no IP identity (they can't be verified and don't participate in IP de-dup).

host

val host: String

The endpoint host literal (IPv4 dotted-quad or IPv6 colon-hex), as given.