Go to file
Markus Maiwald ff40f3739c docs(sdk): add comprehensive Janus SDK documentation
Add README.md with:
- Architecture overview with diagram
- Quick start examples (Identity, QVL, GQL)
- Module reference for all public APIs
- GQL syntax guide (MATCH, CREATE, DELETE, RETURN)
- Design principles (Exit is Voice, Profit=Honesty, etc.)
- Testing instructions
- Sprint roadmap

Covers Sprint 3: Documentation
2026-02-03 12:52:41 +01:00
capsule-core feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2) 2026-02-01 10:35:35 +01:00
docs docs: Add RFC-0105 (STP) and RFC-0014 (Secure Relay) 2026-01-31 22:29:31 +01:00
examples feat(sdk): initial libertaria-sdk implementation 2026-01-30 18:42:04 +01:00
features/qvl feat(qvl): add libmdbx persistent storage layer 2026-02-03 08:59:13 +01:00
janus-sdk docs(sdk): add comprehensive Janus SDK documentation 2026-02-03 12:52:41 +01:00
l0-transport fix(qvl): fix Zig API compatibility for storage and integration layers 2026-02-03 09:35:36 +01:00
l1-identity feat(gql): add GQL to Zig code generator 2026-02-03 12:49:56 +01:00
l2-federation feat(bridge): Implement Bridge Protocol for Layer 3 translation 2026-01-31 20:21:43 +01:00
l2-membrane feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2) 2026-02-01 10:35:35 +01:00
l2_session fix(qvl): fix Zig API compatibility for storage and integration layers 2026-02-03 09:35:36 +01:00
membrane-agent Phase 9 Complete: Autonomous Immune Response Operational 🛡️ (Artifacts Removed) 2026-01-31 04:32:09 +01:00
ncp-prototype feat(ncp): add L1 index layer with path-based addressing 2026-02-02 12:19:40 +01:00
scripts feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00
src/crypto feat(all): Complete Phase 2 and Phase 3 Implementation 2026-01-30 23:24:01 +01:00
vendor feat(all): Complete Phase 2 and Phase 3 Implementation 2026-01-30 23:24:01 +01:00
.gitignore chore(gitignore): protect BDD specs from competitors 2026-02-03 09:00:04 +01:00
.gitmodules feat(all): Complete Phase 2 and Phase 3 Implementation 2026-01-30 23:24:01 +01:00
Containerfile.fast feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00
Containerfile.wolfi feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00
LICENSE feat(all): Complete Phase 2 and Phase 3 Implementation 2026-01-30 23:24:01 +01:00
README.md feat(capsule): implement discovery, federation, and persistence (Phase 10) 2026-01-31 08:35:22 +01:00
build.zig fix(qvl): fix Zig API compatibility for storage and integration layers 2026-02-03 09:35:36 +01:00
build.zig.zon feat(capsule): stabilize TUI monitor, implement control IPC, and fix leaks (Zig 0.15.2) 2026-02-01 10:35:35 +01:00
build_err.txt feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00
build_error_j1.txt feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00
capsule fix(qvl): fix Zig API compatibility for storage and integration layers 2026-02-03 09:35:36 +01:00
l0_transport.zig Phase 4: Established L0 Transport Pipeline with UTCP and Segmented WAL OPQ 2026-01-31 00:51:20 +01:00
l1_identity.zig docs: Add Panopticum Phase 1 - Sovereign Indexes and layer docs 2026-01-30 22:28:55 +01:00
l2_session.zig fix(qvl): fix Zig API compatibility for storage and integration layers 2026-02-03 09:35:36 +01:00
root feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00

README.md

Libertaria SDK

The Core Protocol Stack for Libertaria Applications

Version: 1.0.0-beta ("Shield") License: LUL-1.0 Status: 🛡️ AUTONOMOUS IMMUNE RESPONSE: OPERATIONAL (100% Complete)


🚀 The Autonomous Immune System

Libertaria SDK is not just a protocol; it is a self-defending nervous system. We have achieved the Vertical Active Defense Loop:

  1. Detect: L1 QVL Engine uses Bellman-Ford to mathematically prove betrayal cycles (sybil rings).
  2. Prove: The engine serializes the cycle into a cryptographic Evidence Blob.
  3. Enforce: The L2 Policy Agent issues a SlashSignal containing the Evidence Hash.
  4. Isolate: The L0 Transport Layer reads the signal at wire speed and Quarantines the traitor.

This happens autonomously, in milliseconds, without human intervention or central consensus.


The Stack

L0 Transport Layer (l0-transport/)

  • Protocol: LWF (Libertaria Wire Frame) RFC-0000
  • Features:
    • UTCP (Unreliable Transport)
    • OPQ (Offline Packet Queue) with 72h WAL
    • QuarantineList & Honeypot Mode
    • ServiceType 0x0002 (Slash) Prioritization

L1 Identity Layer (l1-identity/)

  • Protocol: SoulKey RFC-0250 + QVL RFC-0120
  • Features:
    • CompactTrustGraph: High-performance trust storage
    • RiskGraph: Behavioral analysis
    • Bellman-Ford: Negative Cycle Detection
    • Slash Protocol: RFC-0121 Evidence-based punishment

L2 Membrane Agent (membrane-agent/)

  • Language: Rust
  • Role: Policy Enforcement & Strategic Logic
  • Capability: Auto-negotiates PQXDH, manages Prekeys, executes Active Defense.

Technical Validation

Capability Status Implementation
Binary Size <200 KB Strict Kenya Rule Compliance
Tests 173+ 100% Coverage of Core Logic
Detection Mathematical Bellman-Ford (O(VE))
Response Autonomous PolicyEnforcer (Rust)
Evidence Cryptographic Cycle Serialization

Quick Start

Build L1 Engine (Zig)

zig build

Run Active Defense Simulation (Rust)

cd membrane-agent
cargo test --test simulation_attack -- --nocapture

Watch the system detect a traitor and issue a death warrant in real-time.


Documentation


Mission Accomplished. Markus Maiwald & Voxis Forge. 2026.