Struct tox_packet::onion::OnionReturn

pub struct OnionReturn {
    pub nonce: Nonce,
    pub payload: Vec<u8>,
}

Encrypted onion return addresses. Payload contains encrypted with symmetric key IpPort and possibly inner OnionReturn.

When DHT node receives OnionRequest packet it appends OnionReturn to the end of the next request packet it will send. So when DHT node receives OnionResponse packet it will know where to send the next response packet by decrypting OnionReturn from received packet. If node can't decrypt OnionReturn that means that onion path is expired and packet should be dropped.

Serialized form:

Length	Content
24	Nonce
35 or 94 or 153	Payload

where payload is encrypted inner OnionReturn

Fields

nonce: Nonce

Nonce for the current encrypted payload

payload: Vec<u8>

Encrypted payload

Implementations

impl OnionReturn

pub fn new(
    symmetric_key: &Key,
    ip_port: &IpPort,
    inner: Option<&OnionReturn>
) -> OnionReturn

Create new OnionReturn object using symmetric key for encryption.

pub fn get_payload(
    &self,
    symmetric_key: &Key
) -> Result<(IpPort, Option<OnionReturn>), Error>

Decrypt payload with symmetric key and try to parse it as IpPort with possibly inner OnionReturn.

Returns Error in case of failure:

• fails to decrypt
• fails to parse as IpPort with possibly inner OnionReturn

Trait Implementations

impl Clone for OnionReturn

pub fn clone(&self) -> OnionReturn

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OnionReturn

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

Formats the value using the given formatter.

impl Eq for OnionReturn

impl FromBytes for OnionReturn

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

Deserialize struct using nom from raw bytes

impl PartialEq<OnionReturn> for OnionReturn

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

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

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

This method tests for !=.

impl StructuralEq for OnionReturn

impl StructuralPartialEq for OnionReturn

impl ToBytes for OnionReturn

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