Decentralized Identity & Reputation System on Base Network
BaseBadge is a comprehensive decentralized identity and reputation management system built on the Base network. It provides users with verifiable credentials, reputation scoring, and social identity features through blockchain technology.
[!IMPORTANT] Judging Note (Sep 9–13, 2025, CEST) During a security-hardening rollout (JWT authentication, nonce management, and rate limiting), basebadge.com briefly showed errors/partial functionality.
The app has been stable since Sep 14, 2025 and is currently live at v0.8.5.
If you visited during that window, please consider a quick re-check now that everything is stable.
I can provide deploy logs, timestamps, and commit IDs upon request. Contact: 0x0mr0m0@gmail.com · Site: https://basebadge.com
- Decentralized Identity Management - Self-sovereign identity on Base network
- Reputation Scoring System - On-chain reputation with multiple metrics
- Badge System - Verifiable credentials and achievements
- Social Identity - Connect with other users and build reputation
- Base Network Integration - Built on Coinbase's Base L2
- Multi-chain Support - Extensible to other networks
- API Integration - RESTful APIs for developers
- Real-time Updates - Live dashboard with automatic updates
- Mobile Responsive - Works on all devices
- Farcaster Integration - Social identity on Farcaster network
- Baseapp Mini App - Mobile-first experience
- Advanced Analytics - Detailed reputation insights
- Community Features - Group reputation and governance
BaseBadge/
├── frontend/ # React.js frontend application
├── backend/ # Node.js/Express backend API
├── onchain/ # Solidity smart contracts
└── docs/ # Project documentation
- Frontend: React.js, TypeScript, Tailwind CSS
- Backend: Node.js, Express.js, MongoDB
- Blockchain: Solidity, Foundry, Base Network
- Infrastructure: Docker, AWS (planned)
- Node.js 18+
- npm or yarn
- Git
- MetaMask or other Web3 wallet
- Clone the repository
git clone https://github.com/MrM002/BaseBadge.git
cd BaseBadge- Install dependencies
npm install- Set up environment variables
cp env.example .env
# Edit .env with your configuration- Start development servers
# Start backend
cd backend && npm run dev
# Start frontend (in new terminal)
cd frontend && npm run dev
# Deploy contracts (in new terminal)
cd onchain && forge build- Access the application
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- Smart Contracts: Deployed on Base network
See our Documentation Index for complete documentation.
- Security Policy - Project security policy
- Contributing Guide - Guidelines for contributing
- Security Guidelines - Security best practices
BaseBadge prioritizes security and follows industry best practices:
- Smart Contract Audits - Regular security audits
- Open Source - Transparent and verifiable code
- Multi-signature Wallets - Secure fund management
- Regular Updates - Security patches and improvements
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- GitHub: MrM002/BaseBadge
- Issues & Bugs: Submit via GitHub Issues
- Security Concerns: Use GitHub Security Advisories
- Frontend: ✅ Production Ready
- Backend: ✅ Production Ready
- Smart Contracts: ✅ Production Ready
- Farcaster Integration: 🚧 In Development
- Baseapp Mini App: 🚧 In Development
- Advanced Analytics: 📋 Planned
- Base Network team for the excellent L2 solution
- Farcaster community for social identity inspiration
- All contributors and community members
Built with ❤️ on Base Network