Logos ecosystem repositories
Review the key repositories across the logos organisations.
The Logos project is organised into several GitHub organisations, each focused on one part of the system. This page highlights the most important repositories for understanding the project and getting started with development. The selection is curated rather than exhaustive.
Orientation and contribution resources
These repositories explain what Logos is building and how to take part, with no code to run.
| Repository | Description |
|---|---|
| logos-docs | Documentation, standards, and templates for Logos projects. |
| roadmap | A Markdown-based view of the Logos roadmap. |
| ideas | Community-sourced project ideas to build on top of Logos. |
| rfp | Grants for building in the Logos ecosystem. |
Logos Basecamp
Logos Basecamp is the desktop shell for Logos.
| Repository | Description |
|---|---|
| logos-basecamp | The Logos Basecamp repository. |
Logos Core
Logos Core is the modular runtime that ties applications together.
| Repository | Description |
|---|---|
| scaffold | CLI that bootstraps a runnable Logos application environment. |
| logos-liblogos | The core runtime library for the Logos modular application platform. |
| logos-logoscore-cli | The headless CLI runtime for the Logos modular application platform. |
| logos-logoscore-py | Python wrapper for the logoscore CLI. |
| logos-package-manager | C++ library and CLI for local Logos package management. |
| logos-package-downloader | Module download tooling. No official description; purpose inferred. |
| logos-module-builder | C++ library and CLI (lgpd) for fetching Logos module catalogs and downloading .lgx packages. |
| logos-app-builder | Shared Nix library for building Logos UI applications. |
| Overwatch | Self-contained services application framework. |
Core modules and applications
Modules plug into Logos Core to provide specific capabilities, and user-interface repositories are the front-end applications built on those modules. Modules and applications live in both organisations.
| Repository | Description |
|---|---|
| logos-chat-module | A Logos Core module that exposes Logos Chat. |
| logos-chat-ui | UI application for the Logos Chat SDK proof of concept. |
| logos-wallet-module | Early-stage wallet module built on go-wallet-sdk. |
| logos-accounts-module | Early-stage account-management module built on go-wallet-sdk. |
| logos-blockchain-module | Core module wrapping logos-blockchain-c. |
| logos-blockchain-ui | Blockchain UI application for Logos Core. |
| logos-execution-zone-module | Logos Execution Zone module for Logos Core. No official description; purpose inferred. |
| logos-execution-zone-wallet-ui | Logos Execution Zone wallet UI. No official description; purpose inferred. |
| logos-libp2p-module | A Logos module that integrates libp2p networking capabilities. |
Logos Blockchain
The Logos Blockchain is the foundational infrastructure of the Logos technology stack.
| Repository | Description |
|---|---|
| logos-blockchain | The Logos blockchain repository. |
| logos-blockchain-block-explorer-template | Python block explorer and indexer template. |
| nimbos | Nim client for the Logos chain. |
Logos Execution Zone
The Logos Execution Zone (LEZ) is the primary execution layer for applications built on the Logos stack.
| Repository | Description |
|---|---|
| logos-execution-zone | The LEZ repository. |
| lez-programs | Essential Logos Execution Zone programs built by Logos. |
| lez-multisig | Multisig built with the lez-framework program macro. |
| logos-lez-rln | Logos Execution Zone program for RLN registration. |
| logos-sql-zone | Password-manager demo built with the Zone SDK. |
| lez-fuzzing | Adversarial testing and fuzzing infrastructure for LEZ. |
Logos messaging
Logos Messaging is the project's decentralised communication system.
| Repository | Description |
|---|---|
| logos-delivery | Logos messaging protocols implemented in Nim, formerly nwaku. |
| logos-delivery-js | Logos messaging protocols implemented in JavaScript and TypeScript, formerly Waku v2. |
| logos-delivery-python-bindings | Python wrapper around the node. |
| sds-go-bindings | Go bindings for the SDS reliability protocol. No official description; purpose inferred. |
| nim-sds | Nim implementation of the end-to-end reliability protocol. |
| nim-segmentation | Message segmentation. No official description; purpose inferred. |
| logos-delivery-rlnv2-contract | RLN-v2 smart contracts, written in Solidity. |
| specs | Protocol specifications. No official description; purpose inferred. |
| logos-delivery-compose | Docker-compose files to deploy a node. |
| logos-delivery-simulator | Simulates a network with multiple nodes, traffic, and users. |
| logos-delivery-interop-tests | Interoperability tests. No official description; purpose inferred. |
| libchat | Supporting library for Logos Chat, written in Rust. |
| awesome-logos-delivery | Community-curated list of resources. |
Logos Storage
Logos Storage is the project's privacy-preserving, decentralised storage system.
| Repository | Description |
|---|---|
| logos-storage-nim | The storage node and durability engine, formerly nim-codex. |
| logos-storage-nim-dht | A DHT based on Discv5 with libp2p provider-record support. |
| circom-compat-ffi | FFI for circom-compat (ark-circom), used for zero-knowledge proving. |
| logos-storage-research | Durability-engine research. |
| logos-storage-nim-cs-dist-tests | Distributed system tests for the node. |
| logos-storage-local-harness | A bash harness for running the node without containers. |
| transport-over-mix | Transport-layer abstraction over Mix, with spec and reference implementation. |
| libp2p-storage-mix-transport | Experiments with a storage transport over the libp2p Mix protocol. |
| mix-hidden-services | Hidden services over Mix. |
| lioness_blockcipher | Rust implementation of the LIONESS wide-block cipher. |
| logos-storage-docs-obsidian | Indexed, searchable documentation as an Obsidian vault. |
AnonComms
AnonComms focuses on building the core elements that allow privacy-preserving communication and coordination across the Logos stack. The work is at early stages, see the latest update in the roadmap.
Standards, governance, and verification
These repositories define how Logos documents, proposes, and verifies changes.
| Repository | Description |
|---|---|
| logos-lips | Logos Improvement Proposals Index. |
| logos-doctest | Executable documentation that can be verified and rendered. |
| logos-tutorial | Tutorial materials |