History

Markus Maiwald 722c5fafba docs: Add Panopticum Phase 1 - Sovereign Indexes and layer docs Non-breaking changes to align with Panopticum repository architecture: - Add Sovereign Indexes (l0_transport.zig, l1_identity.zig) - Single import point for each layer - Re-export all layer modules - Add layer README files - l0-transport/README.md: LWF and Time documentation - l1-identity/README.md: All L1 components documented - AI-friendly, colocated documentation - Update root README.md - Add Sovereign Index usage examples - Update L0 component list Benefits: - Simplified imports: `const l0 = @import("l0_transport.zig");` - Self-contained layer documentation for AI agents - Zero breaking changes (existing imports still work) Phase 1 complete. Deferred: Feature folders, colocated tests (Phase 2-3)		2026-01-30 22:28:55 +01:00
..
README.md	docs: Add Panopticum Phase 1 - Sovereign Indexes and layer docs	2026-01-30 22:28:55 +01:00
lwf.zig	feat(l0): LWF v1.1 - 72-byte header with 24-byte DID hints	2026-01-30 22:28:22 +01:00
time.zig	feat(l0): LWF v1.1 - 72-byte header with 24-byte DID hints	2026-01-30 22:28:22 +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
Size: 72-byte header + payload + 36-byte trailer

Wire protocol implementation with:

Fixed 72-byte header (24-byte DID hints, u64 nanosecond timestamp)
Variable payload (1092-8892 bytes depending on frame class)
36-byte trailer (Ed25519 signature + CRC32 checksum)
Frame classes (Constrained, Standard, Ethernet, Bulk, Jumbo)

Key Types:

LWFHeader - 72-byte fixed header
LWFTrailer - 36-byte signature + checksum
LWFFrame - Complete frame wrapper
FrameClass - Size negotiation enum

Time - `time.zig`

RFC: RFC-0105 (L0 component)
Precision: u64 nanoseconds (584-year range)

Transport-layer time primitives:

u64 nanosecond timestamps for drift detection
Monotonic clock access
Replay protection timestamps

Note: L1 uses full SovereignTimestamp (u128 attoseconds) for causal ordering.

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