Skip to main content

Module transport

Module transport 

Source
Expand description

QUIC transport: dialing a macula-station, ported from native/macula_quic/src/config.rs (macula-io/macula).

Raw QUIC (RFC 9000), not real HTTP/3 despite the “HTTP/3 mesh” branding elsewhere — ALPN is the plain string "macula", and macula’s own application framing rides directly on QUIC streams. quinn is the exact QUIC engine macula-station’s own native/macula_quic NIF already runs, so this is wire-compatible by construction, not by coincidence.

Enums§

ConnectError
Trust
How to trust whatever certificate the station presents. Mirrors the three modes macula_quic’s own build_client_config supports — see plans/PLAN_WIRE_PROTOCOL.md §2.

Constants§

ALPN
The ALPN macula-station listens for. Not "h3" — see the module doc.
DEFAULT_IDLE_TIMEOUT
Matches macula’s own defaults (macula_quic.erl’s idle_timeout_ms / keep_alive_interval_ms): long enough to tolerate a real gap between frames without closing the connection, with keepalive pings sent often enough (~10x within the idle window) that a healthy connection is never mistaken for a dead one.
DEFAULT_KEEP_ALIVE_INTERVAL

Functions§

connect
Dial a macula-station at host:port over QUIC with the given trust mode, completing the QUIC/TLS handshake (ALPN negotiation included). This is transport-only — it does not send or expect any macula application frame (CONNECT/HELLO); see plans/PLAN_WIRE_PROTOCOL.md §3 for what happens on top of this connection.