Skip to main content

TransportConfig

Struct TransportConfig 

Source
pub struct TransportConfig {
    pub endpoint: EndpointType,
    pub bind_mode: BindMode,
}
Expand description

Transport endpoint configuration.

§Examples

use hyprstream_rpc::transport::TransportConfig;

// In-process endpoint
let inproc = TransportConfig::inproc("hyprstream/registry");

Fields§

§endpoint: EndpointType

Endpoint type (inproc, IPC, systemd FD)

§bind_mode: BindMode

Socket bind mode (Bind or Connect). Workers behind a ROUTER/DEALER load balancer use Connect.

Implementations§

Source§

impl TransportConfig

Source

pub fn inproc(endpoint: impl Into<String>) -> Self

Create an in-process endpoint configuration.

Source

pub fn ipc(path: impl Into<PathBuf>) -> Self

Create an IPC (Unix domain socket) endpoint configuration.

Source

pub fn systemd_fd(fd: RawFd, client_path: impl Into<PathBuf>) -> Self

Create a systemd socket activation endpoint.

§Arguments
  • fd - Pre-bound file descriptor from systemd
  • client_path - IPC path for client connections
Source

pub fn quic(addr: SocketAddr, server_name: impl Into<String>) -> Self

Create a QUIC transport endpoint.

§Arguments
  • addr - Socket address to bind (server) or connect (client)
  • server_name - Server hostname for TLS certificate validation
Source

pub fn quic_pinned( addr: SocketAddr, server_name: impl Into<String>, cert_hash: [u8; 32], ) -> Self

Create a client QUIC endpoint that pins the server’s self-signed cert by its SHA-256 fingerprint. This is the dial target the resolver/dial() produce for an internal-mesh RPC peer (dialed by IP).

Source

pub fn quic_with_auth( addr: SocketAddr, server_name: impl Into<String>, auth: QuicServerAuth, ) -> Self

Create a client QUIC endpoint with an explicit channel-auth policy (used by the DID-doc service-entry codec, which may produce any of WebPKI / Pinned / WebPKI+pin).

Source

pub fn iroh( node_id: [u8; 32], direct_addrs: Vec<SocketAddr>, relay_url: Option<String>, ) -> Self

Create a client iroh endpoint dialing the peer identified by node_id (its EndpointId / Ed25519 public key), with optional direct addresses and relay URL for NAT traversal.

Source

pub fn with_connect_mode(self) -> Self

Set bind mode to Connect (for workers behind a load balancer).

Source

pub fn bind_mode(&self) -> BindMode

Get the bind mode.

Source

pub fn from_endpoint(endpoint: &str) -> Self

Parse an endpoint string into a TransportConfig.

Supports:

  • inproc://name → TransportConfig::Inproc
  • ipc:///path/to/socket → TransportConfig::Ipc
§Example
use hyprstream_rpc::transport::TransportConfig;

let config = TransportConfig::from_endpoint("inproc://hyprstream/registry");
assert_eq!(config.endpoint_string(), "inproc://hyprstream/registry");
Source

pub fn endpoint_string(&self) -> String

Get the endpoint string for this configuration.

For SystemdFd, returns the client IPC path. For Quic, returns a descriptive string (not a connectable endpoint).

Source

pub fn quic_webtransport_url(&self) -> Option<String>

Get the WebTransport URL for QUIC endpoints.

Returns https://{server_name}:{port} for QUIC endpoints, None otherwise.

Source

pub fn is_systemd_activated(&self) -> bool

Check if this is a systemd-activated endpoint.

Source

pub fn is_quic(&self) -> bool

Check if this is a QUIC endpoint.

Source

pub fn quic_resource_url(&self, path: &str) -> Option<String>

Build an RFC 9728 resource URL from a QUIC endpoint.

Returns https://{server_name}/{path}, matching the format used by QuicSharedConfig::for_service(). The port is omitted because resource URLs are identity tokens (used as JWT audience), not connection endpoints — clients discover actual ports via the endpoint registry.

Returns None if this is not a QUIC endpoint.

Trait Implementations§

Source§

impl Clone for TransportConfig

Source§

fn clone(&self) -> TransportConfig

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 TransportConfig

Source§

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

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

impl PartialEq for TransportConfig

Source§

fn eq(&self, other: &TransportConfig) -> 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 TransportConfig

Source§

impl StructuralPartialEq for TransportConfig

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,