A Moderated, Censorship-Resilient Social Network Framework
LIBR is a protocol for building digital public forums and social networks that are both provably censorship-resilient and safeguarded against harmful or illegal content.
Traditional centralized platforms (Facebook, Reddit, Twitter, etc.) control their own databases, which lets them remove or block content at will—undermining free expression. Fully decentralized networks avoid that single point of control, but without any moderation they may become overrun by offensive or malicious posts, turning communities chaotic rather than constructive.
LIBR strikes a balance by using a replicated DHT (Distributed Hash Table) setting for partial immutability—cheaper and faster than storing every message on a full blockchain—while storing necessary global configuration on a public Blockchain (eg., Ethereum). At the same time, content, for each community, is vetted (or approved) by a decentralized moderation quorum (a majority of moderators), so that no single moderator can decide the fate of a message. Only when a majority of moderators approve does a message get stored and shared, keeping the forum both open and safe.
First time contributing to open source? We're here to help!
👉 Start with our Beginner Guide - it has everything you need to get started, explained in simple terms.
🏷️ Look for good first issue labels in our Issues page - these are perfect for newcomers!
💬 Questions? Don't hesitate to ask! Create a new issue or contact our mentors.
LIBR is built with the following components:
- Protocol and Networking Layer (Go): The backbone of the system, implementing the DHT, cryptographic operations, moderation quorum mechanisms, and peer-to-peer communication.
- Blockchain Layer (Solidity): Smart contracts that manage global state, moderator registry, and community governance and incentivization.
- Web Client (React): User-friendly interface for interacting with LIBR communities.
- Mobile Client (Flutter): Native mobile experience for broader accessibility.
- Smart Contracts: Solidity
- Blockchain Interface: Go Ethereum
- Protocol and Networking Logic: Go Lang
- Web Client: React
- Mobile Client: Flutter
- Go 1.21+
- Node.js 18+
- Flutter 3.16+
- Solidity compiler
- Ethereum development environment (Hardhat, Truffle, etc.)
All source code is organized under the src/ directory:
src/
├── core-protocol/ # Go - Core LIBR protocol and moderation logic
├── network/ # Go - P2P networking and DHT operations
├── web-client/ # React/TypeScript - Web interface
├── mobile-client/ # Flutter/Dart - Mobile application
├── contracts/ # Solidity - Smart contracts
└── tests/ # Integration and end-to-end tests
src/core-protocol/: Go (1.21+) - Core LIBR protocol implementation, moderation logic, and data structuressrc/network/: Go (1.21+) - Peer-to-peer networking, DHT operations, and node discoverysrc/web-client/: React with TypeScript - User-facing web application with modern UI/UXsrc/mobile-client/: Flutter/Dart - Cross-platform mobile applicationsrc/contracts/: Solidity - Ethereum smart contracts for global state managementsrc/tests/: Mixed (Go/JS/Dart) - Integration tests and test utilities
# Core protocol
cd src/core-protocol
go run main.go
# Network layer
cd src/network
go run main.go
# Web client
cd src/web-client
npm start
# Mobile client
cd src/mobile-client
flutter run
# Smart contracts (local development)
cd src/contracts
npx hardhat nodeWe've created some tools to make contributing easier:
# 🚀 Quick project setup
./scripts/setup.sh
# 🔍 Check if your commit message is correct
./scripts/validate-commit.sh "feat: add new feature"
# Examples:
./scripts/validate-commit.sh "feat: add dark mode" # ✅ Good
./scripts/validate-commit.sh "fix: button not working" # ✅ Good
./scripts/validate-commit.sh "added new stuff" # ❌ Bad format- Prototype implementation
- Blockchain integration with Ethereum
- Complete web client implementation
- Mobile client development
- Governance model implementation
- Core protocol optimization
- Comprehensive testing and security audits
- Public beta launch
We welcome contributions from the community! Please check out our Contributing Guidelines for details on how to get involved.
For more detailed information about the LIBR protocol and its implementation, check out:
This project is licensed under the MIT License - see the LICENSE file for details.
