Enum ServerDescriptorError 

pub enum ServerDescriptorError {
    Io(Error),
    InvalidRouterFormat {
        actual: usize,
    },
    InvalidNickname(String),
    InvalidIpAddress(AddrParseError),
    InvalidPort(ParseIntError),
    InvalidBandwidthFormat {
        actual: usize,
    },
    InvalidBandwidth(String),
    InvalidPublishedDate(String),
    InvalidFingerprint(String),
    InvalidRsaKey(String),
    InvalidEd25519Identity(String),
    InvalidExitPolicy(String),
    InvalidProtocolVersion(String),
    MissingRequiredField(String),
    InvalidLineFormat {
        line: usize,
        reason: String,
    },
}

Errors that can occur when parsing server descriptors.

Server descriptors contain full relay metadata including identity keys, exit policies, bandwidth information, and platform details.

Example

use stem_rs::descriptor::ServerDescriptorError;

fn handle_server_error(err: ServerDescriptorError) {
    match err {
        ServerDescriptorError::InvalidNickname(nick) => {
            eprintln!("Invalid relay nickname: {}", nick);
        }
        ServerDescriptorError::MissingRequiredField(field) => {
            eprintln!("Missing required field: {}", field);
        }
        _ => eprintln!("Server descriptor parse error: {}", err),
    }
}

Variants

Io(Error)

IO error occurred while reading descriptor data.

InvalidRouterFormat

Router line has wrong number of components.

Fields

actual: usize

Actual number of parts found.

InvalidNickname(String)

Relay nickname is invalid (must be 1-19 alphanumeric characters).

InvalidIpAddress(AddrParseError)

IP address format is invalid.

InvalidPort(ParseIntError)

Port number is invalid or out of range.

InvalidBandwidthFormat

Bandwidth line has wrong number of values.

Fields

actual: usize

Actual number of parts found.

InvalidBandwidth(String)

Bandwidth value is invalid or unparseable.

InvalidPublishedDate(String)

Published date format is invalid.

InvalidFingerprint(String)

Fingerprint format is invalid (must be 40 hex characters).

InvalidRsaKey(String)

RSA public key is malformed or invalid.

InvalidEd25519Identity(String)

Ed25519 identity key is invalid.

InvalidExitPolicy(String)

Exit policy format is invalid.

InvalidProtocolVersion(String)

Protocol version string is malformed.

MissingRequiredField(String)

Required field is missing from descriptor.

InvalidLineFormat

Line format is invalid at specific location.

Fields

line: usize

Line number where error occurred.

reason: String

Description of the format error.

Trait Implementations

impl Debug for ServerDescriptorError

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

Formats the value using the given formatter.

impl Display for ServerDescriptorError

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

Formats the value using the given formatter.

impl Error for ServerDescriptorError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AddrParseError> for ServerDescriptorError

fn from(source: AddrParseError) -> Self

Converts to this type from the input type.

impl From<Error> for ServerDescriptorError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for ServerDescriptorError

fn from(source: ParseIntError) -> Self

Converts to this type from the input type.

impl From<ServerDescriptorError> for DescriptorError

fn from(source: ServerDescriptorError) -> Self

Converts to this type from the input type.