Skip to main content

EndpointType

Enum EndpointType 

Source
pub enum EndpointType {
    Inproc {
        endpoint: String,
    },
    Ipc {
        path: PathBuf,
    },
    SystemdFd {
        fd: RawFd,
        client_path: PathBuf,
    },
    Quic {
        addr: SocketAddr,
        server_name: String,
        auth: QuicServerAuth,
    },
    Iroh {
        node_id: [u8; 32],
        direct_addrs: Vec<SocketAddr>,
        relay_url: Option<String>,
    },
}
Expand description

Endpoint type (without encryption config)

Variants§

§

Inproc

In-process endpoint (zero-copy, same process).

Format: inproc://hyprstream/service

Fields

§endpoint: String
§

Ipc

Unix domain socket (IPC) endpoint.

Format: ipc:///path/to/socket

Fields

§path: PathBuf
§

SystemdFd

Systemd socket activation endpoint.

Used when systemd passes a pre-bound file descriptor to the service. The fd is used for server-side binding, while client_path provides the IPC path for clients to connect.

Fields

§fd: RawFd

Pre-bound file descriptor from systemd

§client_path: PathBuf

IPC path for client connections

§

Quic

QUIC transport endpoint (ZMTP 3.1 over QUIC).

Provides TLS 1.3 encryption built into the transport layer. ZMTP handshake uses NULL mechanism since QUIC already provides wire confidentiality.

Format: quic://hostname:port

Fields

§addr: SocketAddr

Socket address to bind (server) or connect (client)

§server_name: String

Server hostname — used as the WebPKI validation name (WebPki) and the TLS SNI. Ignored by Pinned (which dials by IP and matches the cert hash).

§auth: QuicServerAuth

How the client authenticates this server (WebPKI, cert-hash pin, or — later — RFC 7250 raw key). Public material only.

§

Iroh

iroh transport endpoint (RPC over ALPN_HYPRSTREAM_RPC).

The optional NAT-traversing dial. Unlike QUIC’s channel-only cert pin, iroh binds the connection to the peer’s EndpointId (its Ed25519 public key), authenticating only the carrier endpoint, not application identity. All fields are serializable primitives so TransportConfig stays Clone + Eq and wire-publishable (a DID-doc service entry).

Format: iroh://{hex node_id}

Fields

§node_id: [u8; 32]

Peer’s iroh EndpointId = its Ed25519 public key (32 bytes).

§direct_addrs: Vec<SocketAddr>

Known direct socket addresses for hole-punching / direct dial.

§relay_url: Option<String>

Optional relay URL for NAT traversal when no direct path exists.

Implementations§

Source§

impl EndpointType

Source

pub fn forbids_cleartext_envelope(&self) -> bool

Whether this endpoint class forbids cleartext request envelopes.

iroh and cross-host QUIC/WebTransport are untrusted carriers for RPC envelope confidentiality. Loopback QUIC is treated as local test/dev plumbing; same-process and same-host UDS remain cleartext-allowed.

Trait Implementations§

Source§

impl Clone for EndpointType

Source§

fn clone(&self) -> EndpointType

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for EndpointType

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for EndpointType

Source§

fn eq(&self, other: &EndpointType) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Eq for EndpointType

Source§

impl StructuralPartialEq for EndpointType

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,

Source§

impl<T> TerminalState for T
where T: Clone + Send + Sync,