Struct ServerDescriptorBuilder 

pub struct ServerDescriptorBuilder { /* private fields */ }

Builder for ServerDescriptor.

Implementations

impl ServerDescriptorBuilder

pub fn nickname<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

The relay’s nickname (1-19 alphanumeric characters).

pub fn fingerprint<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

The relay’s fingerprint (40 hex characters), derived from identity key.

pub fn address<VALUE: Into<IpAddr>>(&mut self, value: VALUE) -> &mut Self

The relay’s primary IPv4 address.

pub fn or_port<VALUE: Into<u16>>(&mut self, value: VALUE) -> &mut Self

The relay’s onion routing port (always non-zero).

pub fn socks_port<VALUE: Into<u16>>(&mut self, value: VALUE) -> &mut Self

The relay’s SOCKS port (deprecated, usually None).

pub fn dir_port<VALUE: Into<u16>>(&mut self, value: VALUE) -> &mut Self

The relay’s directory port for serving cached descriptors.

pub fn or_addresses<VALUE: Into<Vec<(IpAddr, u16, bool)>>>( &mut self, value: VALUE, ) -> &mut Self

Additional addresses (IPv4 or IPv6) the relay listens on. Each tuple is (address, port, is_ipv6).

pub fn platform<VALUE: Into<Vec<u8>>>(&mut self, value: VALUE) -> &mut Self

Raw platform string (e.g., “Tor 0.4.7.10 on Linux”).

pub fn tor_version<VALUE: Into<Version>>(&mut self, value: VALUE) -> &mut Self

Parsed Tor version from the platform string.

pub fn operating_system<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Operating system from the platform string.

pub fn published<VALUE: Into<DateTime<Utc>>>( &mut self, value: VALUE, ) -> &mut Self

When this descriptor was published (UTC).

pub fn uptime<VALUE: Into<u64>>(&mut self, value: VALUE) -> &mut Self

Seconds the relay has been running.

pub fn contact<VALUE: Into<Vec<u8>>>(&mut self, value: VALUE) -> &mut Self

Contact information for the relay operator.

pub fn link_protocols<VALUE: Into<Vec<String>>>( &mut self, value: VALUE, ) -> &mut Self

Supported link protocol versions (legacy).

pub fn circuit_protocols<VALUE: Into<Vec<String>>>( &mut self, value: VALUE, ) -> &mut Self

Supported circuit protocol versions (legacy).

pub fn bandwidth_avg<VALUE: Into<u64>>(&mut self, value: VALUE) -> &mut Self

Average bandwidth in bytes per second the relay is willing to sustain.

pub fn bandwidth_burst<VALUE: Into<u64>>(&mut self, value: VALUE) -> &mut Self

Maximum bandwidth in bytes per second for short bursts.

pub fn bandwidth_observed<VALUE: Into<u64>>( &mut self, value: VALUE, ) -> &mut Self

Bandwidth in bytes per second the relay has actually observed.

pub fn exit_policy<VALUE: Into<ExitPolicy>>( &mut self, value: VALUE, ) -> &mut Self

The relay’s exit policy (rules for what traffic it will exit).

pub fn exit_policy_v6<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

IPv6 exit policy summary (e.g., “accept 80,443” or “reject 1-65535”).

pub fn bridge_distribution<VALUE: Into<BridgeDistribution>>( &mut self, value: VALUE, ) -> &mut Self

How this bridge wants to be distributed (bridges only).

pub fn family<VALUE: Into<HashSet<String>>>( &mut self, value: VALUE, ) -> &mut Self

Fingerprints of related relays (same operator).

pub fn hibernating<VALUE: Into<bool>>(&mut self, value: VALUE) -> &mut Self

Whether the relay is currently hibernating (reduced service).

pub fn allow_single_hop_exits<VALUE: Into<bool>>( &mut self, value: VALUE, ) -> &mut Self

Whether the relay allows single-hop exits (security risk).

pub fn allow_tunneled_dir_requests<VALUE: Into<bool>>( &mut self, value: VALUE, ) -> &mut Self

Whether the relay accepts tunneled directory requests.

pub fn extra_info_cache<VALUE: Into<bool>>(&mut self, value: VALUE) -> &mut Self

Whether the relay caches extra-info descriptors.

pub fn extra_info_digest<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

SHA-1 digest of the relay’s extra-info descriptor.

pub fn extra_info_sha256_digest<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

SHA-256 digest of the relay’s extra-info descriptor.

pub fn is_hidden_service_dir<VALUE: Into<bool>>( &mut self, value: VALUE, ) -> &mut Self

Whether the relay serves as a hidden service directory.

pub fn protocols<VALUE: Into<HashMap<String, Vec<u32>>>>( &mut self, value: VALUE, ) -> &mut Self

Supported protocol versions (modern format). Maps protocol name to list of supported versions.

pub fn onion_key<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

RSA onion key for circuit creation (PEM format).

pub fn onion_key_crosscert<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Cross-certification of onion key by identity key.

pub fn ntor_onion_key<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

Curve25519 onion key for ntor handshake (base64).

pub fn ntor_onion_key_crosscert<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Cross-certification of ntor key.

pub fn ntor_onion_key_crosscert_sign<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Sign bit for ntor key cross-certification.

pub fn signing_key<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

RSA signing key (PEM format).

pub fn ed25519_certificate<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Ed25519 identity certificate (PEM format).

pub fn ed25519_master_key<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Ed25519 master key (base64).

pub fn ed25519_signature<VALUE: Into<String>>( &mut self, value: VALUE, ) -> &mut Self

Ed25519 signature over the descriptor.

pub fn signature<VALUE: Into<String>>(&mut self, value: VALUE) -> &mut Self

RSA signature over the descriptor (PEM format).

pub fn raw_content<VALUE: Into<Vec<u8>>>(&mut self, value: VALUE) -> &mut Self

Raw bytes of the original descriptor content.

pub fn unrecognized_lines<VALUE: Into<Vec<String>>>( &mut self, value: VALUE, ) -> &mut Self

Lines that were not recognized during parsing.

pub fn build(&self) -> Result<ServerDescriptor, ServerDescriptorBuilderError>

Builds a new ServerDescriptor.

Errors

If a required field has not been initialized.

Trait Implementations

impl Clone for ServerDescriptorBuilder

fn clone(&self) -> ServerDescriptorBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ServerDescriptorBuilder

fn default() -> Self

Returns the “default value” for a type.