Go to file
Markus Maiwald 482b5488e6 fix: Correct FeedEvent size 96 bytes, fix PNG types
- feed.zig: Fix @sizeOf from 104 to 96 (actual struct size)
- png.zig: Fix type cast in wrapping arithmetic

Refs: RFC-0015
2026-02-03 18:01:15 +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 rfc(0015): Pluggable Transport Skins for DPI resistance 2026-02-03 17:17:52 +01:00
examples feat(sdk): initial libertaria-sdk implementation 2026-01-30 18:42:04 +01:00
features/transport rfc(0015): Pluggable Transport Skins for DPI resistance 2026-02-03 17:17:52 +01:00
l0-transport fix: Correct FeedEvent size 96 bytes, fix PNG types 2026-02-03 18:01:15 +01:00
l1-identity docs: Add L4 Feed architecture documentation 2026-02-03 15:03:03 +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
l4-feed fix: Correct FeedEvent size 96 bytes, fix PNG types 2026-02-03 18:01:15 +01:00
membrane-agent Phase 9 Complete: Autonomous Immune Response Operational 🛡️ (Artifacts Removed) 2026-01-31 04:32:09 +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 feat(capsule): implement discovery, federation, and persistence (Phase 10) 2026-01-31 08:35:22 +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 docs: Add professional GitHub README 2026-02-03 15:31:34 +01:00
build.zig fix: More Zig 0.15.2 syntax fixes 2026-02-03 17:29:07 +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
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
root feat(relay): Implement RelayPacket and onion wrapping logic 2026-01-31 18:11:09 +01:00

README.md

Libertaria SDK

Sovereign Infrastructure for Autonomous Agents

Tests Zig License

Sovereign; Kinetic; Anti-Fragile.


What is Libertaria?

Libertaria is a stack for building sovereign agent networks — systems where:

  • Exit is Voice: Cryptographic guarantees, not platform promises
  • Profit is Honesty: Economic incentives align with truth
  • Code is Law: Protocols, not platforms, govern behavior

This SDK implements the L1 Identity Layer with:

  • Ed25519 sovereign identities with rotation/burn
  • Trust Graph (QVL) with betrayal detection
  • GQL (ISO/IEC 39075:2024 compliant) query interface
  • Persistent storage with Kenya Rule compliance

Quick Start

# Clone
git clone https://github.com/MarkusMaiwald/libertaria-sdk.git
cd libertaria-sdk

# Build
zig build

# Test (166/166 passing)
zig build test

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Application Layer                         │
├─────────────────────────────────────────────────────────────┤
│                    Libertaria SDK                            │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │   Identity   │  │  Trust Graph │  │    GQL       │      │
│  │  (identity)  │  │    (qvl)     │  │  (gql/*.zig) │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
├─────────────────────────────────────────────────────────────┤
│                    Janus Standard Library                    │
├─────────────────────────────────────────────────────────────┤
│                    Janus Compiler (:service)                 │
└─────────────────────────────────────────────────────────────┘

Modules

Identity (l1-identity/)

  • crypto.zig — Ed25519 signatures, key rotation
  • did.zig — Decentralized identifiers
  • soulkey.zig — Deterministic key derivation
  • entropy.zig — Sovereign randomness

QVL — Quasar Vector Lattice (l1-identity/qvl/)

  • storage.zig — PersistentGraph with libmdbx
  • betrayal.zig — Bellman-Ford negative cycle detection
  • pathfinding.zig — A* trust path discovery
  • feed.zig — L4 temporal event store (DuckDB + LanceDB)
  • gql/ — ISO/IEC 39075:2024 Graph Query Language
    • lexer.zig — Tokenizer
    • parser.zig — Recursive descent parser
    • ast.zig — Abstract syntax tree
    • codegen.zig — GQL → Zig transpiler

GQL Example

const gql = @import("qvl").gql;

// Parse GQL query
const query_str = "MATCH (n:Identity)-[t:TRUST]->(m) WHERE n.did = 'alice' RETURN m";
var query = try gql.parse(allocator, query_str);
defer query.deinit();

// Transpile to Zig code
const zig_code = try gql.generateZig(allocator, query);
defer allocator.free(zig_code);

Kenya Compliance

Metric Target Status
Binary Size (L1) < 200KB 85KB
Memory Usage < 10MB ~5MB
Storage Single-file libmdbx
Cloud Calls None Offline-capable

Testing

# All tests
zig build test

# Specific module
zig test l1-identity/qvl/gql/lexer.zig
zig test l1-identity/qvl/storage.zig

Current Status: 166/166 tests passing



Philosophy

Collectivist Individualism

Radical market innovation fused with extreme communal loyalty.

The Kenya Rule

If it doesn't run on a $5 Raspberry Pi, it doesn't run at all.

Exit is Voice

The right to leave is the foundation of digital sovereignty.


License

MIT License + Libertaria Commons Clause

See LICENSE for details.


Forge burns bright. The Exit is being built.