Expand description
Local TLS echo service for inspecting our own wire fingerprints.
guise-echo terminates TLS 1.3 locally, parses the client’s raw ClientHello
with tls-parser, computes JA3/JA4 via guise::fingerprint::ja3, and
returns the result as JSON over HTTP/1.1. It exists so the stealth stack can
inspect its own Layer-2 bytes without relying on third-party reflectors.
Layers:
- TLS ClientHello capture (JA3/JA4, ALPN, SNI, extensions)
- HTTP/2 preface + SETTINGS/WINDOW_UPDATE/PRIORITY frame capture
- TCP TTL/options read (
tcp::read_host_tcp_info)
The service intentionally does not implement a full HTTP/2 server; it only reads the connection preface and the first control frames so the stealth stack can verify that its emitted H2 fingerprint matches a real browser.
Re-exports§
pub use tcp::read_host_tcp_info;pub use tcp::TcpConnectionInfo;
Modules§
- tcp
- TCP-layer diagnostics for the local echo service.
Structs§
- Client
Hello Info - Parsed TLS ClientHello metadata + computed fingerprints.
- Connection
Info - Combined fingerprint info returned by the echo endpoint.
- H2Connection
Info - Captured HTTP/2 connection-level information from the client preface and first control frames.
- H2Priority
- A single HTTP/2 PRIORITY frame.
- H2Setting
- A single HTTP/2 SETTINGS parameter.
Enums§
- Json
Value - Represents any valid JSON value.
Functions§
- accept_
one_ for_ test - Accept a single TCP connection, parse its TLS ClientHello, complete the handshake, and echo the parsed fingerprint as JSON. Exposed for tests that want to drive the server side without binding a listening socket.
- serve
- Run the echo server on
binduntil the process is killed.