Enum Error 

pub enum Error {
    TlsBuild(ErrorStack),
    TlsHandshake(HandshakeError<TcpStream>),
    Http2(Error),
    Connect(Error),
    Verify(String),
    InvalidUrl(String),
}

Errors that can occur during high-fidelity transport operations.

This enum categorizes failures across the entire protocol stack, from low-level TCP dialing to high-level HTTP/2 frame signaling.

Variants

TlsBuild(ErrorStack)

Failure during the construction of the BoringSSL context.

This usually indicates an invalid cipher list, unsupported curve configuration, or a missing FFI symbol in the linked BoringSSL binary.

TlsHandshake(HandshakeError<TcpStream>)

Failure during the TLS handshake with the remote peer.

These errors often stem from peer-side fingerprint validation, protocol version mismatches, or failures in the ALPN/ALPS negotiation phase.

Http2(Error)

Failure during the HTTP/2 handshake or frame signaling.

This error is returned when the remote peer violates the H2 protocol or when the internal state machine fails to replicate the required Chrome behavior (e.g., SETTINGS frame ordering).

Connect(Error)

Standard I/O failure during connection establishment or data transfer.

This covers TCP timeout, connection reset, and other OS-level network errors.

Verify(String)

Fingerprint verification failed against a reference validator.

This is an orchestration error that occurs when the actual wire behavior (JA3/JA4/Akamai) deviates from the constants defined in the identity profile.

InvalidUrl(String)

The provided URL is malformed or uses an unsupported scheme.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ErrorStack> for Error

fn from(source: ErrorStack) -> Self

Converts to this type from the input type.

impl From<HandshakeError<TcpStream>> for Error

fn from(source: HandshakeError<TcpStream>) -> Self

Converts to this type from the input type.