Ratatoskr

Resilient Decentralized Messenger

Mission: To ensure information flows even when the "trunk" of the internet is severed.

Original Concept: Alexey Poimtsev

📜 Documentation & Governance

• Concept & Vision: Detailed overview of features (Black Box SOS, Plague Protocol).
• Architecture: Technical design (P2P, Encryption, DHT).
• Roadmap: Granular implementation tasks and engineering goals.
• Milestones: Project release timeline.
• Project Structure: Codebase decomposition and directory map.
• Ethics: Our stance on surveillance and human rights.
• Foundation Charter: Governance principles.
• Trademark Policy: Rules for using the brand.
• SOS Governance: Verification protocol for aid organizations.

🛠️ Features

• Unblockable: P2P architecture using libp2p (GossipSub, Kademlia DHT).
• Secure: End-to-End Encryption (E2EE) by default.
• Emergency Mode: "Black Box SOS" protocol for anonymous distress signals.
• Identity: Self-Sovereign Identity (DID) with BIP-39 mnemonic recovery.
• Resilience: Designed for mesh networking and offline scenarios.

🚀 Getting Started

Prerequisites

• Rust (latest stable)
• Node.js (v18+) & npm

Development

1. Clone the repository:

   git clone https://github.com/alec-c4/ratatoskr.git
   cd ratatoskr
   

2. Run the Relay Server (Terminal 1):

   cargo run -p ratatoskr-server
   

3. Run the Desktop Client (Terminal 2):

   cd ratatoskr-desktop
   npm install
   npm run tauri dev
   

🤝 Contributing

We welcome contributions that align with our Mission. Please read our Architecture guide before submitting PRs.

📄 License

Code is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE for details.

The "Ratatoskr" name and logo are trademarks. See TRADEMARK.md.