GenosDB Documentation

Welcome to the official technical documentation for GenosDB.

API Reference & Advanced Documentation

📘 GDB API Reference (Detailed API documentation)
🤝 Distributed Trust Model (P2P trust via cryptographic identity, signed ops, and RBAC enforcement)
🔒 Zero Trust Security Model (Understanding GenosDB Zero-Trust Security Model: From Guest to SuperAdmin)
🧪 GenosDB Examples (Live demos and community projects)
✨ GenosDB Features (Comprehensive feature overview and architecture)
🎨 GenosDB Design Guide (Opinionated UI patterns, design tokens, and page architectures for GenosDB applications — for humans and AIs)
↔️ Cursor-Based-Pagination (Efficient paging with $after/$ before/$limit)
📚 Resources (Helpful links: whitepaper, docs, wiki, npm, discussions)

🛠️ CRUD Operation Guide (Overview of CRUD APIs with links to detailed guides)
📤 PUT Guide (Insert/update nodes; auto ID, persistence, and events)
📥 GET Guide (Retrieve nodes by ID; optional real-time subscription)
🗺️ MAP Guide (Query language, real-time subscriptions, and $edge traversal)
🗑️ REMOVE Guide (Delete nodes and clean up edges; persistence and notifications)
🔗 LINK Guide (Create directed relationships between nodes)

🔐 Security Manager (SM API Reference) (RBAC, identity (WebAuthn/mnemonic), signing/verification)
📡 GenosRTC API Reference (P2P WebRTC API: rooms, data channels, audio/video)
🛰️ Own signaling relay: built into the Fallback Server (--relay — one flag, zero extra infrastructure)
⚙️ GenosRTC Architecture (A technical breakdown of GenosDB’s GenosRTC Module architecture, explaining its key components, including the decentralized signaling layer with Nostr, the P2P transport layer with WebRTC, and the communication abstractions for data and media.)
🔷 GenosRTC Cells (Cellular mesh overlay: architecture, bridges, TTL, metrics, and scalability)

🧭 GenosRTC Guide (rtc) (Tutorials for data channels and media streaming)
🕵️ Audit Option (audit) (Asynchronous moderation of the oplog with custom prompt)
🤖 NLQ Module (Natural Language for Queries in db.map using prompts)
📍 GEO Query Module (geo) (Geo queries with $near and$ bbox operators)
🔒 GenosDB SM ACLs Module (acls) (Node-level permissions and access control)
🏛️ Governance (Role Promotion) (Rule-based promotion of users from guest to higher roles, driven by GenosDB queries and signed by a present superadmin)

⚙️ GenosDB Worker Architecture (Technical overview of the persistence worker, covering its tiered storage strategy and data integrity mechanisms.)
🔄 GenosDB Hybrid Delta Protocol (Details the dual-mode engine ensuring real-time speed via delta updates and reliability via a full-state fallback.)
🕰️ GenosDB Hybrid Logical Clock (HLC) (An advanced timestamping system that blends physical time with a logical counter to ensure causal event ordering and enable robust, deterministic conflict resolution.)
🧯 GenosDB Fallback Server (Optional superpeer Node.js service to improve availability)
📦 Bundler Configuration (Vite, Webpack, Bun, esbuild, and CDN usage)