Struct tor_proto::circuit::PendingClientCirc

pub struct PendingClientCirc { /* fields omitted */ }

A ClientCirc that needs to send a create cell and receive a created* cell.

To use one of these, call create_firsthop_fast() or create_firsthop_ntor() to negotiate the cryptographic handshake with the first hop.

Implementations

impl PendingClientCirc

pub async fn create_firsthop_fast<R>(
    self,
    rng: &mut R,
    params: &CircParameters
) -> Result<Arc<ClientCirc>> where
    R: Rng + CryptoRng, 

Use the (questionable!) CREATE_FAST handshake to connect to the first hop of this circuit.

There’s no authentication in CRATE_FAST, so we don’t need to know whom we’re connecting to: we’re just connecting to whichever relay the channel is for.

pub async fn create_firsthop_ntor<R, Tg>(
    self,
    rng: &mut R,
    target: &Tg,
    params: &CircParameters
) -> Result<Arc<ClientCirc>> where
    R: Rng + CryptoRng,
    Tg: CircTarget, 

Use the ntor handshake to connect to the first hop of this circuit.

Note that the provided ‘target’ must match the channel’s target, or the handshake will fail.