pub struct QuicConfig {
pub enabled: bool,
pub bind_addr: String,
pub server_name: String,
pub cert_path: String,
pub key_path: String,
pub iroh: bool,
pub native_network_profile: NativeNetworkProfile,
pub event_publishers: BTreeSet<String>,
pub stream_publishers: BTreeSet<String>,
pub relay: String,
}Fields§
§enabled: boolWhether QUIC/WebTransport is enabled (defaults to true)
bind_addr: StringAddress to bind the WebTransport server
server_name: StringServer name for TLS certificate (used in self-signed cert generation)
cert_path: StringPath to TLS certificate (PEM). Empty = generate self-signed.
key_path: StringPath to TLS private key (PEM). Empty = generate self-signed.
iroh: bool#410/#282: bind an iroh substrate (ALPNs hyprstream-rpc/1 + moql)
as the PRIMARY production transport, in parallel with the quinn/WebTransport
endpoint (kept for back-compat). Iroh is ON by default — it provides
node_id-addressed (pkarr/N0-DNS-discoverable) federation reach, NAT
traversal, self-certifying Ed25519 identity, and PQ-hybrid key exchange.
Opt out with [quic] iroh = false to run quinn-only (legacy). Native-only.
native_network_profile: NativeNetworkProfileExplicit native deployment profile. network-iroh-required forbids a
native QUIC/local fallback but does not disable the browser edge.
event_publishers: BTreeSet<String>Separate Event producer grants, keyed by service NAME (not DID) so the allowlist survives service-identity churn. Admission resolves the peer DID → service name through the accepted-state authority, then checks name membership. Tenant membership alone grants no ingress; an empty set leaves every peer read-only. Names must be registered factory services — validation fails at startup otherwise.
#1652: this replaces the DID-valued grant list, and native admission
tenants are no longer configured at all — the former DID-keyed
moql_subject_tenants map embedded deployment DIDs in this write-once
file and went stale at every service-identity re-initialization. The
tenant is now DERIVED at admission time from the checkpointed
accepted-state store (accepted state ∩ the factory roster ⇒ local,
foreign records denied); see hyprstream_discovery::admission_roster.
A leftover [quic.moql_subject_tenants] table in an old file is
ignored.
stream_publishers: BTreeSet<String>Explicit remote Streams ingress, separate from Event permissions.
Deliberately empty by design (#1652): no production writer emits it, an
empty set cannot go stale, and admitted native peers stay read-only on
Streams. Unlike event_publishers this stays DID-keyed — it is unused
policy, so re-keying it by service name is deferred to its first real
use. Non-empty entries name peer DIDs.
relay: String#358: the producer-chosen moq RELAY this node rendezvouses through, as a
dialable URI (https://host:port for the relay’s WebTransport /moq
endpoint, or an iroh node URI). Empty = direct-only (the baseline). When
set, every QUIC-enabled service advertises a Role::Relay reach and links
its streaming origin UP to the relay, so neither publisher nor subscriber
need be directly reachable by the other. Default deployments point this at
the node’s PDS / federation anchor (the #atproto_pds DID service entry).
Implementations§
Source§impl QuicConfig
impl QuicConfig
pub fn iroh_required(&self) -> bool
pub fn validate_native_network_profile(&self) -> Result<()>
Sourcepub fn validate_admission_policy(&self) -> Result<()>
pub fn validate_admission_policy(&self) -> Result<()>
#1652: event_publishers is keyed by service NAME. A name that is not
a registered factory service can never match an admitted peer, so it is
rejected loudly here — at startup, not as a silent read-only surprise
(this is also what catches a stale DID-valued list from a pre-#1652
config file: DIDs are not factory names).
Sourcepub fn socket_addr(&self) -> Result<SocketAddr>
pub fn socket_addr(&self) -> Result<SocketAddr>
Parse bind_addr into a SocketAddr.
Sourcepub fn use_self_signed(&self) -> bool
pub fn use_self_signed(&self) -> bool
Check if self-signed certificate should be generated.
Warns when only one of cert_path/key_path is set (misconfiguration).
Sourcepub fn load_tls_materials(&self) -> Result<(Vec<Vec<u8>>, Zeroizing<Vec<u8>>)>
pub fn load_tls_materials(&self) -> Result<(Vec<Vec<u8>>, Zeroizing<Vec<u8>>)>
Generate or load TLS materials, returning (cert_der, key_der).
key_der is wrapped in Zeroizing to ensure it is zeroed on drop.
For self-signed certs, loads persisted ECDSA P-256 materials from the secrets
directory (generating on first run) with ≤14 day validity, as required by
WebTransport serverCertificateHashes (W3C spec).
QUIC uses a separate cert (quic-cert) from the HTTP cert (tls-cert) because
WebTransport requires ≤14-day validity while HTTP allows 365 days.
Load TLS materials for QUIC/WebTransport.
Returns a certificate chain (leaf first, then intermediates/CA) and the private key. When loading from PEM files, all certificates in the file are included — this allows CA-signed certs (e.g. mkcert) to work by bundling the leaf + CA cert in a single PEM file.
Sourcepub fn to_loop_config(
&self,
service_name: &str,
oauth_issuer_url: Option<&str>,
) -> Result<QuicLoopConfig>
pub fn to_loop_config( &self, service_name: &str, oauth_issuer_url: Option<&str>, ) -> Result<QuicLoopConfig>
Build a QuicLoopConfig for use with RequestLoop.
Optionally embeds RFC 9728 Protected Resource Metadata so HTTP/3 clients can discover the OAuth authorization server for this QUIC endpoint.
Trait Implementations§
Source§impl Clone for QuicConfig
impl Clone for QuicConfig
Source§fn clone(&self) -> QuicConfig
fn clone(&self) -> QuicConfig
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for QuicConfig
impl Debug for QuicConfig
Source§impl Default for QuicConfig
impl Default for QuicConfig
Source§impl<'de> Deserialize<'de> for QuicConfig
impl<'de> Deserialize<'de> for QuicConfig
Source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Auto Trait Implementations§
impl Freeze for QuicConfig
impl RefUnwindSafe for QuicConfig
impl Send for QuicConfig
impl Sync for QuicConfig
impl Unpin for QuicConfig
impl UnsafeUnpin for QuicConfig
impl UnwindSafe for QuicConfig
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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 moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request