Commit Graph

4 Commits

Author SHA1 Message Date
Markus Maiwald 2276954ba3 Phase 4: Established L0 Transport Pipeline with UTCP and Segmented WAL OPQ 2026-01-31 00:51:20 +01:00
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
Markus Maiwald 76b05c7f49 feat(l0): LWF v1.1 - 72-byte header with 24-byte DID hints
BREAKING CHANGE: Header size increased from 64 to 72 bytes

- Expand DID hints from 20 to 24 bytes (192-bit, 2^96 collision resistance)
- Clarify timestamp as u64 nanoseconds (Bytes 60-67, big-endian)
- Update frame payload capacities (-8 bytes per frame class)
- All tests passing (14/14 L0 tests)

Rationale:
- 24-byte DID hints provide future-proof routing scalability
- 8-byte overhead per frame is negligible (0.6% loss on Standard frames)
- Aligns with Sovereign Time Protocol (RFC-0105) L0/L1 split

Files modified:
- l0-transport/lwf.zig: Header structure, serialization, tests
- l0-transport/time.zig: New file for L0 time primitives
- build.zig: Time module dependencies

RFC Impact: RFC-0000 (LWF Wire Protocol), RFC-0105 (Sovereign Time)
2026-01-30 22:28:22 +01:00
Markus Maiwald be4e50d446 feat(sdk): initial libertaria-sdk implementation
L0 Transport Layer:
- LWF frame codec (64-byte headers, variable payload, 36-byte trailers)
- CRC32 checksum verification
- Manual byte-level serialization for deterministic wire format
- Full encode/decode with big-endian support

L1 Identity & Crypto:
- X25519-XChaCha20-Poly1305 AEAD encryption
- Point-to-point encryption with ephemeral keys
- WORLD tier encryption (symmetric shared secret)
- Ed25519 signature support (trailer structure)

Build System:
- Zig 0.15.2 compatible module architecture
- Automated test suite (8/8 tests passing)
- Example programs (lwf_example, crypto_example)

Documentation:
- README.md with SDK overview
- INTEGRATION.md with developer guide
- Inline documentation for all public APIs

Status: Production-ready, zero memory leaks, all tests passing
2026-01-30 18:42:04 +01:00