History

Markus Maiwald 59e1f10f7a fix(qvl): fix Zig API compatibility for storage and integration layers - Update ArrayList API (allocator parameter changes) - Fix const qualifier for BellmanFordResult.deinit - Fix u8 overflow (level = -7 not valid) - Fix toOwnedSlice API changes - All QVL tests now compile and pass 152/154 tests green (2 pre-existing PoP failures)		2026-02-03 09:35:36 +01:00
..
ipc	Phase 6C COMPLETE: L0-L2 IPC Bridge	2026-01-31 03:43:29 +01:00
opq	Phase 4: Advanced L0 Validation (Deterministic Ordering, Replay Filtering, and Trust Distance Integration)	2026-01-31 01:09:05 +01:00
utcp	feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2)	2026-02-01 10:35:35 +01:00
README.md	Phase 4: Established L0 Transport Pipeline with UTCP and Segmented WAL OPQ	2026-01-31 00:51:20 +01:00
dht.zig	feat(relay): Wire up CircuitBuilder with DHT Keys	2026-01-31 22:15:46 +01:00
gateway.zig	feat(relay): Implement RelayPacket and onion wrapping logic	2026-01-31 18:11:09 +01:00
lwf.zig	fix(qvl): fix Zig API compatibility for storage and integration layers	2026-02-03 09:35:36 +01:00
opq.zig	Phase 4: Advanced L0 Validation (Deterministic Ordering, Replay Filtering, and Trust Distance Integration)	2026-01-31 01:09:05 +01:00
quarantine.zig	feat(capsule): Admin CLI & Emergency Lockdown	2026-01-31 10:41:38 +01:00
relay.zig	feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2)	2026-02-01 10:35:35 +01:00
service.zig	Phase 7 Complete: Slash Protocol Integration	2026-01-31 03:50:49 +01:00
time.zig	feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2)	2026-02-01 10:35:35 +01:00
utcp.zig	Phase 4: Established L0 Transport Pipeline with UTCP and Segmented WAL OPQ	2026-01-31 00:51:20 +01:00

README.md

L0 Transport Layer

Layer: L0 (Transport)
Purpose: Wire protocols, frame encoding, time primitives
RFCs: RFC-0000 (LWF), RFC-0105 (Time L0 component)

Overview

The L0 Transport layer provides low-level wire protocol implementations for the Libertaria network. It handles packet framing, serialization, and transport-layer timestamps.

Components

LWF (Libertaria Wire Frame) - `lwf.zig`

RFC: RFC-0000
Wire protocol implementation for fixed-size headers and variable payloads. Supports CRC32-C and Ed25519.

Time - `time.zig`

RFC: RFC-0105
Nanosecond precision transport-layer time primitives.

UTCP (Unreliable Transport Protocol) - `utcp/socket.zig`

RFC: RFC-0010
Fast-path UDP wrapper for LWF frames. Features rapid entropy validation (DoS defense) before deep parsing.

OPQ (Offline Packet Queue) - `opq/`

RFC: RFC-0020
High-resilience store-and-forward mechanism using a Segmented WAL (Write-Ahead Log) for 72-96 hour packet retention.

L0 Service - `service.zig`

The integrated engine that orchestrates Network -> UTCP -> OPQ -> Ingestion. Handles automated maintenance and persona-based policies.

Usage

const l0 = @import("l0_transport.zig");

// Create LWF frame
var frame = try l0.lwf.LWFFrame.init(allocator, 1024);
defer frame.deinit(allocator);

// Set header fields
frame.header.service_type = 0x0700; // Vector message
frame.header.timestamp = l0.time.nowNanoseconds();

// Encode for transport
const encoded = try frame.encode(allocator);
defer allocator.free(encoded);

Testing

Run L0 tests:

zig test l0-transport/lwf.zig
zig test l0-transport/time.zig

Dependencies

std.mem - Memory management
std.crypto - CRC32, hashing
std.time - System time access