Module redwire 

RedWire — RedDB’s binary TCP / TLS wire protocol with auth handshake, multiplex, compression, and version negotiation.

See .red/adr/0001-redwire-tcp-protocol.md. The protocol is gated on a 0xFE startup magic byte so the listener can share a port with HTTP and gRPC behind the service router.

Layered API:

• frame — frame struct + MessageKind + flags
• codec — encode/decode (16-byte header + payload)
• auth — handshake state machine
• session — per-connection dispatch loop
• listener — TCP / TLS / Unix accept

Modules

auth

Handshake state machine + auth method dispatch.

input_stream

RedWire input-stream dispatch (issue #764, PRD #759 S5).

listener

TCP / TLS / Unix listeners for the RedWire protocol.

output_stream

RedWire output-stream dispatch (issue #762, PRD #759 S3).

queue_wait

RedWire live queue-wait dispatch (issue #917, PRD #915).

session

Per-connection RedWire session: handshake → frame loop → bye.

Structs

Flags

Frame

FrameBuilder

Builder for RedWire Frames.

RedWireConfig

Enums

BuildError

Errors surfaced at build() time so they fail at construction rather than at encode time, where the call site has already lost the context to recover.

FrameError

MessageKind

Single-byte message-kind discriminator. Numeric values are part of the wire spec — never repurpose a value once shipped.

Constants

DEFAULT_REDWIRE_PORT

Default port for the RedWire listener.

FRAME_HEADER_SIZE

MAX_FRAME_SIZE

MAX_KNOWN_MINOR_VERSION

Highest minor version the server supports. Wire-bumped as we add features that change the handshake; data-plane additions flow through Hello.features instead.

REDWIRE_MAGIC

Discriminator byte every RedWire client sends as the very first byte off the wire. The service-router detector keys off this (and so does the standalone listener path).

Functions

decode_frame

encode_frame

start_redwire_listener

Start a plain-TCP RedWire listener on the configured bind addr.

start_redwire_listener_on

Start a RedWire listener on an already-bound TCP listener (used by the server bootstrap when binding the user-facing wire port directly; the shared-port demux instead dispatches per connection through handle_router_connection).

start_redwire_tls_listener

Start a RedWire listener wrapped in TLS.

start_redwire_tls_listener_on

Start a TLS RedWire listener on an already-bound TCP listener. Mirror of start_redwire_listener_on for the TLS edge — lets a caller pick the bound address (e.g. an ephemeral 127.0.0.1:0 port) before serving.

start_redwire_unix_listener

Start a RedWire listener on a Unix domain socket.

validate_minor_version

validate_startup_magic