Struct DhtStateSnapshot 

pub struct DhtStateSnapshot {
    pub nodes: Vec<DhtNodeInfo>,
    pub token_secret: [u8; 20],
    pub last_bootstrap_epoch_secs: Option<u64>,
    pub total_nodes: usize,
}

Snapshot of DHT (Distributed Hash Table) routing state for persistence.

Captures the current state of DHT nodes, token secret, and bootstrap timing to allow quick resumption without full bootstrap on restart.

Serialization

This struct implements Serialize/Deserialize for JSON persistence alongside session data. Use to_json_string() and from_json_string() for conversion.

Fields

nodes: Vec<DhtNodeInfo>

Known DHT nodes in the routing table

token_secret: [u8; 20]

Current token secret used for DHT get_peers requests (20 bytes)

last_bootstrap_epoch_secs: Option<u64>

Unix epoch timestamp of last successful bootstrap, if any

total_nodes: usize

Total number of nodes in the snapshot (convenience field)

Implementations

impl DhtStateSnapshot

pub fn empty() -> Self

Create an empty snapshot (for when DHT is unavailable or not initialized).

Returns a snapshot with no nodes and zeroed token secret, suitable as a default or placeholder value.

pub fn new( nodes: Vec<DhtNodeInfo>, token_secret: [u8; 20], last_bootstrap_epoch_secs: Option<u64>, ) -> Self

Create a snapshot from node data with automatic total_nodes calculation.

Arguments

• nodes - Vector of known DHT nodes
• token_secret - Current 20-byte token secret
• last_bootstrap - Optional timestamp of last bootstrap

pub fn to_json_string(&self) -> Result<String, String>

Serialize snapshot to JSON string for persistence.

Returns

• Ok(String) - JSON-formatted snapshot data
• Err(String) - Error message if serialization fails

pub fn from_json_string(json: &str) -> Result<Self, String>

Parse snapshot from JSON string.

Arguments

• json - JSON string containing serialized snapshot data

Returns

• Ok(DhtStateSnapshot) - Deserialized snapshot
• Err(String) - Error message if parsing fails

Trait Implementations

impl Clone for DhtStateSnapshot

fn clone(&self) -> DhtStateSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DhtStateSnapshot

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DhtStateSnapshot

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DhtStateSnapshot

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

where __S: Serializer,

Serialize this value into the given Serde serializer.