Struct RendRequest

pub struct RendRequest {
    ipt_lid: IptLocalId,
    raw: Introduce2,
    context: Arc<RendRequestContext>,
    expanded: OnceCell<IntroRequest>,
}

Request to complete an introduction/rendezvous handshake.

A request of this kind indicates that a client has asked permission to connect to an onion service through an introduction point. The caller needs to decide whether or not to complete the handshake.

Protocol details: More specifically, we create one of these whenever we get a well-formed INTRODUCE2 message. Based on this, the caller decides whether to send a RENDEZVOUS1 message.

Fields

ipt_lid: IptLocalId

The introduction point that sent this request.

raw: Introduce2

The message as received from the remote introduction point.

context: Arc<RendRequestContext>

Reference to the keys we’ll need to decrypt and handshake with this request.

expanded: OnceCell<IntroRequest>

The introduce2 message that we’ve decrypted and processed.

We do not compute this immediately upon receiving the Introduce2 cell, since there is a bit of cryptography involved and we don’t want to add any extra latency to the message handler.

TODO: This also contains raw, which is maybe not so great; it would be neat to implement more efficiently.

Implementations

impl RendRequest

pub(crate) fn new( ipt_lid: IptLocalId, msg: Introduce2, context: Arc<RendRequestContext>, ) -> Self

Construct a new RendRequest from its parts.

fn intro_request(&self) -> Result<&IntroRequest, IntroRequestError>

Try to return a reference to the intro_request, creating it if it did not previously exist.

pub async fn accept( self, ) -> Result<impl Stream<Item = StreamRequest> + Unpin, ClientError>

Mark this request as accepted, and try to connect to the client’s provided rendezvous point.

pub async fn reject(self) -> Result<(), Bug>

Reject this request. (The client will receive no notification.)

Trait Implementations

impl Debug for RendRequest

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

Formats the value using the given formatter.