Struct tox_packet::dht::Cookie

pub struct Cookie {
    pub time: u64,
    pub real_pk: PublicKey,
    pub dht_pk: PublicKey,
}

Cookie is a struct that holds two public keys of a node: long term key and short term DHT key.

When Alice establishes net_crypto connection with Bob she sends CookieRequest packet to Bob with her public keys and receives encrypted Cookie with these keys from CookieResponse packet. When Alice obtains a Cookie she uses it to send CryptoHandshake packet. This packet will contain received from Bob cookie and new Cookie generated by Alice. Then Bob checks his Coocke and uses Cookie from Alice to send CryptoHandshake packet to her.

Only node that encrypted a Cookie can decrypt it so when node gets CryptoHandshake packet with Cookie it can check that the sender of this packet received a cookie response.

Cookie also contains the time when it was generated. It's considered invalid after 15 seconds have elapsed since the moment of generation.

Serialized form:

Length	Content
8	Cookie timestamp
32	Long term PublicKey
32	DHT PublicKey

Fields

time: u64

Time when this cookie was generated

real_pk: PublicKey

Long term PublicKey

dht_pk: PublicKey

DHT PublicKey

Implementations

impl Cookie

pub fn new(real_pk: PublicKey, dht_pk: PublicKey) -> Cookie

Create new Cookie

pub fn is_timed_out(&self) -> bool

Check if this cookie is timed out.

Cookie considered timed out after 15 seconds since it was created.

Trait Implementations

impl Clone for Cookie

pub fn clone(&self) -> Cookie

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cookie

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

Formats the value using the given formatter.

impl Eq for Cookie

impl FromBytes for Cookie

pub fn from_bytes(i: &[u8]) -> IResult<&[u8], Cookie, (&[u8], ErrorKind)>

Deserialize struct using nom from raw bytes

impl PartialEq<Cookie> for Cookie

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for Cookie

impl StructuralPartialEq for Cookie

impl ToBytes for Cookie

pub fn to_bytes<'a>(
    &self,
    buf: (&'a mut [u8], usize)
) -> Result<(&'a mut [u8], usize), GenError>

Serialize struct into raw bytes using cookie_factory