Struct 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

fn clone(&self) -> OnionReturn

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OnionReturn

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

Formats the value using the given formatter.

impl FromBytes for OnionReturn

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

Deserialize struct using nom from raw bytes

impl PartialEq for OnionReturn

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ToBytes for OnionReturn

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

Serialize struct into raw bytes using cookie_factory

impl Eq for OnionReturn

impl StructuralPartialEq for OnionReturn