Struct OnionService

pub struct OnionService { /* private fields */ }

Definition of a Tor Onion service (AKA “hidden service”).

An onion service can be thought of as an encrypted load balancer, which presents itself as a virtual host in the Tor network, and which maps virtual ports on that virtual host to service ports running on your local machine. While, in practice, most onion services map a single virtual port to a service port, say, 443 to 443, you can map multiple virtual ports to a single service port, or a single virtual port to multiple service ports (in which case Tor will load balance the traffic coming in on the virtual port across the corresponding service ports).

Each onion service has the following:

• The service ID contains all the information for the public key (see TorServiceId for details).
• The signing, i.e, private, key for the onion service
• The mapping from the virtual port(s) to the service port(s)

Implementations

impl OnionService

pub fn new<S, K>(id: S, key: K, ports: &[OnionServiceMapping]) -> Self

where TorServiceId: From<S>, TorEd25519SigningKey: From<K>,

Create a new OnionService object

pub fn listen_addresses_for_onion_address( &self, onion_address: &str, ) -> Vec<TorSocketAddr>

Return all the listen addresses for a given onion address (including virtual port) onion_address should be formatted as <onion-address>:<port>, e.g. joikeok6el5h5sbrojo2h3afw63lmfm7huvwtziacl34wjrx7n62gsad.onion:443

pub fn listen_addresses_for_port(&self, service_port: u16) -> Vec<TorSocketAddr>

Return all the listen addresses for the given local service port

pub fn onion_address(&self, service_port: u16) -> Result<OnionAddress, TorError>

Return the onion address (i.e., the onion hostname and virtual port) which maps to the given local service port

pub fn onion_addresses(&self) -> Vec<OnionAddress>

Return a list of all the onion addresses for this onion service

pub fn service_id(&self) -> &TorServiceId

Return the TorServiceId for this onion service

pub fn signing_key(&self) -> &TorEd25519SigningKey

Return the Tor signing key for this onion service

pub fn ports(&self) -> &Vec<OnionServiceMapping>

Return the list of virtual to service port mappings for this onion service

Trait Implementations

impl Clone for OnionService

fn clone(&self) -> OnionService

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for OnionService

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OnionService

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Ord for OnionService

fn cmp(&self, other: &OnionService) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for OnionService

fn eq(&self, other: &OnionService) -> 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 PartialOrd for OnionService

fn partial_cmp(&self, other: &OnionService) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for OnionService

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for OnionService

impl StructuralPartialEq for OnionService