Struct tor_hsclient::HsClientConnector

pub struct HsClientConnector<R: Runtime, D: MockableConnectorData = Data> { /* private fields */ }

An object that negotiates connections with onion services

This can be used by multiple requests on behalf of different clients, with potentially different HS client authentication (KS_hsc_*) and potentially different circuit isolation.

The principal entrypoint is get_or_launch_connection().

This object is handle-like: it is fairly cheap to clone, and contains Arcs internally.

Implementations

impl<R: Runtime> HsClientConnector<R, Data>

pub fn new( runtime: R, circpool: Arc<HsCircPool<R>>, config: &impl HsClientConnectorConfig, housekeeping_prompt: BoxStream<'static, ()> ) -> Result<Self, StartupError>

Create a new HsClientConnector

housekeeping_prompt should yield “occasionally”, perhaps every few hours or maybe daily.

In Arti we arrange for this to happen when we have a new consensus.

Housekeeping events shouldn’t arrive while we’re dormant, since the housekeeping might involve processing that ought to be deferred.

pub fn get_or_launch_connection<'r>( &'r self, netdir: &'r Arc<NetDir>, hs_id: HsId, secret_keys: HsClientSecretKeys, isolation: StreamIsolation ) -> impl Future<Output = Result<Arc<ClientCirc>, ConnError>> + Send + Sync + 'r

Connect to a hidden service

Each HS connection request must provide the appropriate client authentication keys to use - or default if client auth is not required.

Trait Implementations

impl<R: Runtime, D: MockableConnectorData> Clone for HsClientConnector<R, D>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.