Skip to content

Eras256/SafariLink

Repository files navigation

🦁 SafariLink Platform

The Complete Web3 Hackathon Lifecycle Platform - Optimized for Africa & Emerging Markets

Next.js TypeScript Solidity License

WebsiteDocumentationTwitterDiscord


🎯 The Story

Imagine a world where every Web3 builder in Africa and emerging markets has a clear path from their first hackathon to global funding. A platform that doesn't just host events, but creates lasting connections, verifiable achievements, and real opportunities.

That's SafariLink.

Born from the challenges of virtual hackathons like ETH Safari, SafariLink transforms remote collaboration into immersive, engaging experiences. We've built an end-to-end ecosystem that bridges the gap between local talent and global opportunities, powered by cutting-edge Web3 technology and AI.

🌍 Why SafariLink?

Virtual hackathons face unique challenges:

  • Networking barriers - Hard to connect across timezones and languages
  • Engagement drops - Participants lose interest without real-time interaction
  • Limited feedback - Mentors can't provide timely guidance
  • Fragmented identity - Achievements scattered across platforms
  • Funding gaps - No clear pathway from hackathon to investment

SafariLink solves all of this.


✨ What We've Built

🎮 Core Features

Feature Description Impact
🌐 Virtual Networking Rooms Real-time video and chat rooms for track-based collaboration +300% Networking
🤖 AI Mentor Multilingual 24/7 AI assistant supporting Swahili, English, and French 24/7 Support
📊 Organizer Dashboard Complete metrics on engagement, participation, projects, and sponsor ROI Data-Driven Decisions
💬 Real-time Feedback System Mentors and judges provide instant feedback during development +250% Feedback Quality
👥 Smart Team Matching AI-powered matching based on complementary skills, timezone, and preferences Perfect Teams
🎯 Gamification & Engagement Badges, leaderboards, daily challenges to keep participants active +200% Engagement
🏆 Soulbound NFT Certificates Non-transferable, verifiable hackathon achievements on-chain Permanent Records
💰 On-Chain Prize Distribution Secure, transparent prize distribution via smart contracts Trustless Rewards

📈 Expected Impact

  • +300% Increase in Networking
  • +250% Improvement in Feedback Quality
  • +200% Increase in Engagement
  • +150% Participant Satisfaction

🦁 ETH Safari Evolution Challenge 2025

SafariLink is specifically designed to revolutionize virtual hackathons like ETH Safari, addressing the unique challenges of remote collaboration and engagement in the African Web3 ecosystem.

👉 View ETH Safari Evolution Challenge Proposal


🔗 Deployed Smart Contracts

Ethereum Sepolia Testnet

Our smart contracts are live on Ethereum Sepolia testnet, implementing secure, gas-optimized solutions for hackathon management:

Contract Address Explorer Description
NFTCertificate 0x57691c8016bf1A1cA90224Ca346C3a17310B4846 View on Etherscan Soulbound NFT certificates (EIP-5192) for hackathon achievements
PrizeDistributor 0x1E149bD2340C7360bFcF9c3EC7E8cC5e194db5fD View on Etherscan Secure, transparent prize distribution system

Network Details:

  • Chain ID: 11155111
  • Network: Ethereum Sepolia Testnet
  • Deployer: 0xF93F07b1b35b9DF13e2d53DbAd49396f0A9538D9
  • Deployment Date: November 14, 2025

Contract Features

NFTCertificate

  • ✅ EIP-5192 Soulbound Token implementation
  • ✅ Gas-optimized (no Counters library)
  • ✅ Batch minting support
  • ✅ Emergency pause functionality
  • ✅ Role-based access control
  • ✅ Reentrancy protection

PrizeDistributor

  • ✅ Secure prize distribution
  • ✅ Granular access control (Organizer, Judge roles)
  • ✅ Batch distribution optimization
  • ✅ Reentrancy protection
  • ✅ Emergency pause
  • ✅ Custom errors for gas optimization

🛠️ Technology Stack

Frontend

Next.js React TypeScript Tailwind CSS Wagmi Viem Reown AppKit Framer Motion Zustand TanStack Query Socket.io

Framework & Core:

  • Next.js 15 - App Router, React Server Components, Server Actions
  • React 18.3 - Latest React features with concurrent rendering
  • TypeScript 5.6 - Full type safety across the application

Styling & UI:

  • Tailwind CSS 4 - Utility-first CSS with custom glassmorphism effects
  • Radix UI - Accessible component primitives
  • Shadcn/ui - Beautiful, customizable components
  • Framer Motion - Smooth animations and transitions

Web3 Integration:

  • Reown AppKit - WalletConnect v4 integration
  • Wagmi v2 - React Hooks for Ethereum
  • Viem - TypeScript Ethereum library

State Management:

  • Zustand - Lightweight state management
  • TanStack Query - Powerful data synchronization

Real-time:

  • Socket.io - Real-time bidirectional communication

Backend

Node.js Express TypeScript PostgreSQL Prisma Redis JWT Socket.io

Runtime & Framework:

  • Node.js 20+ - Latest LTS with modern JavaScript features
  • Express.js - Fast, unopinionated web framework
  • TypeScript 5.6 - Type-safe backend development

Database & ORM:

  • PostgreSQL 16 - Robust relational database
  • Prisma ORM - Next-generation ORM with type safety
  • Redis 7 - High-performance caching and rate limiting

Authentication & Security:

  • JWT - JSON Web Token authentication
  • Wallet Signature Verification - Web3 wallet-based auth
  • Zod - Schema validation
  • Helmet - Security headers
  • Rate Limiting - Redis-backed request throttling

Real-time:

  • Socket.io - WebSocket server for real-time features

Smart Contracts

Solidity Hardhat Foundry OpenZeppelin

Framework & Tools:

  • Foundry - Fast, portable, and modular toolkit for Ethereum application development
  • Hardhat - Development environment for Ethereum
  • Solidity ^0.8.20 - Smart contract programming language

Libraries & Standards:

  • OpenZeppelin Contracts - Battle-tested smart contract libraries
  • EIP-5192 - Soulbound Token standard implementation

Supported Networks:

  • Ethereum Sepolia (Deployed ✅)
  • Arbitrum Sepolia
  • Base Sepolia
  • Optimism Sepolia

AI Services

Python FastAPI Google Gemini Scikit-learn

Framework:

  • FastAPI - Modern, fast web framework for building APIs
  • Python 3.11 - Latest Python features and performance

AI & ML:

  • Google Gemini 1.5 Flash - Multilingual AI assistant
  • Scikit-learn - Machine learning for team matching algorithms

Services:

  • Team Matcher - AI-powered team formation
  • Plagiarism Detector - Code similarity detection
  • Mentor Bot - 24/7 multilingual AI mentor

DevOps & Infrastructure

Docker Vercel Railway

Containerization:

  • Docker - Containerization for all services
  • Docker Compose - Multi-container orchestration

Deployment:

  • Vercel - Frontend deployment platform
  • Railway - Backend and AI services deployment

📁 Project Structure

SafariLink/
├── frontend/              # Next.js 15 App Router
│   ├── app/              # Pages and layouts
│   ├── components/       # React components
│   ├── lib/              # Utilities and configs
│   └── hooks/            # Custom React hooks
├── backend/              # Node.js/Express API
│   ├── src/
│   │   ├── controllers/  # Request handlers
│   │   ├── routes/       # API routes
│   │   ├── middleware/   # Auth, validation, rate limiting
│   │   └── config/       # Database, Redis configs
│   └── prisma/           # Database schema
├── contracts/            # Smart Contracts (Foundry/Hardhat)
│   ├── src/             # Solidity contracts
│   ├── test/            # Foundry tests
│   ├── scripts/         # Deployment scripts
│   └── deployments/     # Deployed contract addresses
├── ai-services/         # Python AI microservices
│   ├── team_matcher/    # Team matching service
│   ├── plagiarism_detector/  # Anti-plagiarism service
│   └── mentor_bot/     # AI mentor assistant
├── docs/                # Documentation
└── docker-compose.yml   # Docker orchestration

🚀 Quick Start

Prerequisites

  • Node.js 20+
  • Docker & Docker Compose
  • Foundry (for smart contracts)
  • Python 3.11+ (for AI services)

Installation

# Clone repository
git clone https://github.com/safarilink/platform.git
cd SafariLink

# Install frontend dependencies
cd frontend && npm install

# Install backend dependencies
cd ../backend && npm install

# Install contract dependencies
cd ../contracts && forge install

# Install AI Services dependencies
cd ../ai-services/mentor_bot
pip install -r requirements.txt

# Configure environment variables
# See INSTALLATION.md for detailed setup

# Start services with Docker
cd ../..
docker-compose up -d

# Or run services individually
# Backend
cd backend && npm run dev

# Frontend
cd frontend && npm run dev

# AI Mentor
cd ai-services/mentor_bot
uvicorn main:app --reload --port 8000

# Run database migrations
cd ../../backend && npm run migrate

📖 See INSTALLATION.md for detailed setup instructions.


📚 Documentation


🧪 Testing

# Frontend tests
cd frontend && npm test

# Backend tests
cd backend && npm test

# Smart contract tests
cd contracts && forge test

# Run all tests
npm run test:all

🐳 Docker

# Start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

# Rebuild services
docker-compose up -d --build

🔐 Security

  • ✅ Input validation on all endpoints
  • ✅ Rate limiting with Redis
  • ✅ JWT authentication
  • ✅ Wallet signature verification
  • ✅ Smart contract security best practices
  • ✅ KYC/AML integration ready (Smile ID)
  • ✅ OFAC screening implemented
  • ✅ Reentrancy protection in smart contracts
  • ✅ Access control with role-based permissions

Note: Smart contracts should undergo professional audits before mainnet deployment.


🤝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Please read our contributing guidelines and code of conduct before submitting PRs.


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🙏 Acknowledgments

We're grateful to the amazing open-source community and the following projects:

  • OpenZeppelin - Battle-tested smart contract libraries
  • Reown (WalletConnect) - Web3 wallet integration
  • Google Gemini - AI integration and multilingual support
  • Next.js Team - Amazing React framework
  • Prisma - Next-generation ORM
  • All contributors and builders in the Web3 community

📞 Contact & Community


Built with ❤️ for Web3 builders in Africa and emerging markets

Star History Chart

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors