Enum MicrodescriptorError 

pub enum MicrodescriptorError {
    Io(Error),
    InvalidOnionKey(String),
    InvalidNtorOnionKey(String),
    InvalidSocketAddress(AddrParseError),
    InvalidRelayFamily(String),
    InvalidPortPolicy(String),
    InvalidBase64(String),
    InvalidIdentityLength {
        algorithm: String,
        expected: usize,
        actual: usize,
    },
    UnknownIdentityAlgorithm(String),
    IncompleteCryptoBlock(String),
    MissingRequiredField(String),
}

Errors that can occur when parsing microdescriptors.

Microdescriptors are compact descriptors used by clients for building circuits with minimal bandwidth overhead.

Example

use stem_rs::descriptor::MicrodescriptorError;

fn handle_micro_error(err: MicrodescriptorError) {
    match err {
        MicrodescriptorError::InvalidOnionKey(msg) => {
            eprintln!("Invalid onion key: {}", msg);
        }
        MicrodescriptorError::MissingRequiredField(field) => {
            eprintln!("Missing required field: {}", field);
        }
        _ => eprintln!("Microdescriptor parse error: {}", err),
    }
}

Variants

Io(Error)

IO error occurred while reading descriptor data.

InvalidOnionKey(String)

Onion key format is invalid.

InvalidNtorOnionKey(String)

Ntor onion key format is invalid.

InvalidSocketAddress(AddrParseError)

Socket address format is invalid.

InvalidRelayFamily(String)

Relay family specification is invalid.

InvalidPortPolicy(String)

Port policy format is invalid.

InvalidBase64(String)

Base64 encoding is invalid.

InvalidIdentityLength

Identity key has wrong length for algorithm.

Fields

algorithm: String

Algorithm name (e.g., “ed25519”).

expected: usize

Expected length in bytes.

actual: usize

Actual length found.

UnknownIdentityAlgorithm(String)

Identity algorithm is not recognized.

IncompleteCryptoBlock(String)

Cryptographic block is incomplete.

MissingRequiredField(String)

Required field is missing from descriptor.

Trait Implementations

impl Debug for MicrodescriptorError

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

Formats the value using the given formatter.

impl Display for MicrodescriptorError

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

Formats the value using the given formatter.

impl Error for MicrodescriptorError

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 MicrodescriptorError

fn from(source: AddrParseError) -> Self

Converts to this type from the input type.

impl From<Error> for MicrodescriptorError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<MicrodescriptorError> for DescriptorError

fn from(source: MicrodescriptorError) -> Self

Converts to this type from the input type.