Home/Modules/http-3.0

http-3.0

system module http-3.0

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

SLeeLa HTTP 3.0

Status: Internet-capable SLeeLa application-protocol server with integrity gate (keyed-MAC DIGEST, INTACTX tamper detection, NONCE replay guard, BASKET).

Platforms: Linux · macOS · Windows 10+

HTTP 3.0 extends the SLeeLa HTTP 2.1 application model with a per-packet integrity substrate: keyed-MAC DIGEST (SipHash-2-4), INTACTX host-integrity fingerprinting, NONCE replay detection, and the fixed BASKET of goods & services. These additions sit between the parse and dispatch stages of the pipeline, forming an integrity gate that HTTP 2.1 deliberately omits.

This is not a claim of IETF HTTP/3 semantics beyond the selected transport carrier (HTTP/3 + QUIC may provide the transport).

Build and test

make            # build everything: selftest, kds, proto, station, server
make server     # build just the portable HTTP 3.0 server
make server-test# run the server's built-in self-test
make proto      # build protocol-core objects only
make demo       # run the pipeline demo
make test       # run demo + station-test + Python flow tests
make station    # build station signaling
make clean

Platform notes

PlatformSocket layerCompilerLink flags
LinuxPOSIX sockets via sleela_netcc / gcc(none)
macOSPOSIX sockets via sleela_netcc / clang(none)
Windows 10+Winsock2 via sleela_netMSVC / MinGW-lws2_32

The crypto substrate (selftest, kds) requires OpenSSL (detected via pkg-config). The protocol core, server, station, and pipeline demo do not require OpenSSL — they are pure C with libc only.

Running the server

./http3_server --port 8082

Options:

Architecture

Native transport endpoint (TCP, any platform)
        |
HTTP/1.x request / connection       ← sleela_net portable sockets
        |
SLeeLa envelope / route             ← X-SLeeLa-* headers or H3 envelope
        |
HTTP/3 stream (logical)
        |
SLeeLa logical PORT (160-bit)
        |
SERVICE-ID / OP-ID / REQUEST-ID
        |
┌─────────────────── integrity gate ───────────────────┐
│  DIGEST verify (SipHash-2-4 keyed MAC)               │
│  NONCE replay check (monotonic high-water mark)       │
│  INTACTX tamper check (host-integrity threshold)      │
│  BASKET canonical block verification                  │
└──────────────────────────────────────────────────────┘
        |
Pipeline dispatch → handler → response

Core capabilities

CapabilityStatusNotes
Compact application envelopeImplementedTextual + binary wire forms
Fast service/operation namingImplementedConnection-local name→id dictionary
Response modelImplementedTransport ≠ application status
Retry classificationImplementedREAD / IDEMPOTENT / MUTATING / STREAM
Processing pipelineImplementedWith integrity gate
Request correlationImplementedREQUEST-ID echo
Keyed-MAC DIGESTImplementedSipHash-2-4, 16-byte per-connection key
INTACTX host integrityImplemented64-bit fingerprint, tamper threshold + RESET
NONCE replay guardImplementedMonotonic high-water mark
BASKETImplementedFixed goods & services block per packet
160-bit logical portImplemented0 .. 10^48-1 namespace
Carrier-certainty timingImplementedMax-speed, on-time, balance estimation
Capability handshakeImplementedL1–L4 negotiation levels
Station signalingImplementedTCP-flag negotiation (userland + kernel)

Built-in endpoints

PathMethodDescription
/__sleela/healthGETReturns SLeeLa HTTP/3.0 OK
/__sleela/statusGETJSON: full pipeline status, integrity counters, carrier certainty
/__sleela/negotiateGETVersion negotiation result (JSON)
/__sleela/h3POSTH3 envelope endpoint — textual or binary, dispatched through the integrity gate + pipeline

SLeeLa application headers

Every response includes:

X-SLeeLa-Version: 3.0
X-SLeeLa-Accept: 3.0, 2.1, 2.0, 1.1, 1.0

Wire forms

Envelope (textual):  H3 <ver> <flags> <svc_id> <op_id> <req_id> <port>
                        <nonce> <digest> <intactx> <basket-hex> <len>:<payload>\n
Response (textual):  H3R <status> <request_id> <len>:<result>\n
Envelope (binary) :  [ver:1][flags:1][svc_id:4][op_id:4][req_id:8][port:20]
                     [nonce:8][digest:8][intactx:8][basket:N][payload_len:4][payload:N]

Integrity gate (3.0-era additions over 2.1)

FeatureDescription
DIGEST64-bit SipHash-2-4 keyed MAC over header + basket + payload. Detects tampering.
NONCEPer-connection monotonic counter. Receiver rejects stale/replayed packets.
INTACTX64-bit host-integrity fingerprint. Variance beyond threshold triggers RESET.
BASKETFixed canonical block of goods & services, MAC-covered.

A packet whose DIGEST fails is rejected (BAD_DIGEST). A packet whose INTACTX variance exceeds the threshold is RESET (TAMPERED, never dispatched). A packet whose NONCE is not strictly greater than the high-water mark is rejected (REPLAYED). All three counters are exposed in the /__sleela/status endpoint.

Security boundary

Carrier security (TLS, QUIC) and SLeeLa application integrity are separate layers. Application integrity does not replace transport encryption or deployment authorization. Fallback must not silently weaken a required security property (HTTP.NEGOTIATION.md).

Large-file download mode

Files larger than 50 MB use the shared SLeeLa DOWNLOAD resume contract:

SESSION-ID | DATETIME | FILE-ID | FILE-NAME | INDEX | OFFSET | TOTAL-SIZE

Dependencies

ModulePathRole
sleela_netimpl/core/sleela_net.{c,h}Portable TCP sockets
preferred_routerpreferred-routers/Routing-tier policy
resolverresolver/DNS / path / event policy
OpenSSL (optional)systemCrypto substrate only

File inventory (server additions)

FileDescription
http3_server.hServer API, HTTP types, download state
http3_server.cFull server: parse, route, H3 envelope endpoint, self-test
http3_main.cCLI entry point with demo echo service + MAC key
http_negotiation.hC negotiation API (reformatted)
http_negotiation.cVersion negotiation (reformatted)
http_negotiation.hppC++ negotiation wrapper (reformatted)
http_negotiation.cppC++ wrapper implementation (reformatted)

The existing protocol core (http3_envelope, http3_naming, http3_pipeline, http3_mac, http3_intactx, http3_basket, http3_timing, http3_handshake, http3_profile, http3_port), crypto substrate (crypto_*, key_distribution_server), station signaling, Python parity layer, and pipeline demo are unchanged.

Unified route data

This server consumes the SLeeLa unified route-data contract in route/ROUTE.DATA.json and route/ROUTE.DATA.md. VM identity: /impl Core, /1 Foundation, /2 Operator, /3 Specialist, /4 Supervisor, /5 Manager, /6 Director, /7 Administrator, /8 Executive, /9 Authority, /10 Principal, /11 Sovereign.


SLeeLa

<p align="center"><img src="images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>

Files 94