Versus.rip is a modern, real-time betting platform built on Solana blockchain. Watch AI fighters battle in epic matches while placing bets with cryptocurrency. Experience the thrill of live betting with instant payouts, real-time odds, and a mobile-first design.
Versus transforms AI fighting matches into an exciting betting experience:
- Watch live AI battles streamed directly in the platform
- Bet on red vs blue corners with real SOL cryptocurrency
- Real-time odds updates based on community betting volumes
- Instant blockchain payouts when your fighter wins
- Mobile-optimized for betting on the go
- Achievement system with unlockable rewards
- Referral bonuses for bringing friends
✅ Fully implemented and ready for production!
All services are deployed and working in production:
- Frontend: Modern React 19 + Next.js 15 interface
- Backend: High-performance Fastify API with real-time updates
- Oracle: Solana blockchain integration for secure betting
- Scraper: Twitch chat monitoring for live match detection
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Frontend │◄──►│ Backend API │◄──►│ PostgreSQL │
│ Next.js 15 │ │ Fastify + SSE │ │ Database │
│ React 19 │ │ TypeScript │ │ (Railway) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Solana Wallets │ │ Oracle │ │ Scraper │
│ Phantom/Solflare│ │ Blockchain │ │ Twitch Chat │
│ Integration │ │ Integration │ │ Monitoring │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Live betting interface with red vs blue corner selection
- Dynamic odds that update based on betting volumes
- Real-time updates via Server-Sent Events (no page refresh needed)
- Mobile-first design optimized for phones and tablets
- Solana wallet support - Phantom, Solflare, and more
- Smart contract security - Oracle-controlled betting gates
- Instant payouts - Automatic SOL transfers to winners
- Transparent betting - All transactions on-chain
- Responsive design - Works perfectly on all devices
- Real-time notifications - Live updates on match status
- Achievement system - Unlock rewards for betting milestones
- Referral program - Earn bonuses for inviting friends
- Sub-second updates - Real-time game state changes
- Smart rate limiting - Prevents abuse while maintaining speed
- Optimized loading - Fast page loads and smooth interactions
- Production-ready - Deployed and battle-tested
- Node.js 18+ for development
- Solana wallet (Phantom recommended)
- PostgreSQL database (Railway recommended)
# Clone and install
git clone <repository-url>
cd versus
make install
# Configure environment
cp .env.example .env
# Edit .env with your settings
# Start all services
make run# Backend API
PORT=3001
DATABASE_URL=postgresql://your-database-url
CORS_ORIGIN=http://localhost:3000
# Oracle Service
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
DEPOSIT_GATE_PROGRAM_ID=your-program-id
ORACLE_API_KEY=your-oracle-key
# Scraper Service
BACKEND_API_URL=http://localhost:3001/api
SCRAPER_API_KEY=your-scraper-key
TWITCH_CHANNEL=saltybet
# Frontend
NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_SOLANA_RPC_URL=https://api.devnet.solana.com- Next.js 15 - React framework with App Router
- React 19 - Latest React with modern hooks
- TypeScript 5.9 - Full type safety
- Tailwind CSS v4 - Modern utility-first styling
- Redux Toolkit - Predictable state management
- Solana Wallet Adapter - Seamless wallet integration
- Fastify 5.5 - High-performance Node.js framework
- Server-Sent Events - Real-time updates to all clients
- Drizzle ORM - Type-safe database operations
- PostgreSQL - Reliable, scalable database
- TypeScript - End-to-end type safety
- Solana Web3.js - Blockchain integration
- Smart Contracts - Secure betting gate management
- Oracle Service - Automated payout processing
- Wallet Integration - Support for all major Solana wallets
- Scraper Service - Twitch chat monitoring for match detection
- Oracle Service - Blockchain transaction processing
- Real-time Communication - WebSocket and SSE for live updates
versus/
├── frontend/ # Next.js 15 + React 19 app
│ ├── src/components/ # React components (game, layout, ui)
│ ├── src/redux/ # State management (9 slices)
│ ├── src/hooks/ # Custom React hooks (12 hooks)
│ └── README.md # Frontend documentation
│
├── backend/ # Fastify API + SSE hub
│ ├── src/routes/ # API endpoints (9 routes)
│ ├── src/db/ # Database schema and operations
│ ├── src/services/ # Business logic services
│ └── README.md # Backend documentation
│
├── oracle/ # Blockchain integration service
│ ├── src/oracle/ # Core betting operations
│ ├── src/solana/ # Blockchain interactions
│ ├── src/api/ # Backend communication
│ └── README.md # Oracle documentation
│
├── scraper/ # Twitch chat monitoring
│ ├── src/ # Chat parsing and API integration
│ └── README.md # Scraper documentation
│
├── Makefile # Development commands
└── README.md # This overview
The Scraper monitors Twitch chat for SaltyBet match announcements and extracts fighter information.
The Oracle opens the betting gate on Solana, allowing users to place bets with their wallets.
The Backend broadcasts live updates via Server-Sent Events, showing betting volumes and odds changes.
When a match ends, the Oracle automatically processes payouts and sends SOL to winners.
The Frontend receives real-time updates and immediately reflects changes in the user interface.
- Smart contract validation - Oracle-controlled betting gates
- Rate limiting - 300 requests per minute per IP
- CORS protection - Configurable origin validation
- Input validation - TypeScript type safety throughout
- Service authentication - Secure inter-service communication
- Real-time updates - Sub-second SSE broadcasts
- Optimized queries - Efficient database operations
- Smart caching - Reduced API calls and faster responses
- Mobile optimization - Touch-friendly, fast-loading interface
All services are production-ready and can be deployed to:
- Frontend: Vercel or Railway
- Backend: Railway or VPS
- Database: Railway PostgreSQL
- Services: Railway or VPS with PM2
- Health monitoring - Built-in health check endpoints
- Error recovery - Automatic reconnection and retry logic
- Graceful shutdown - Clean service termination
- Logging - Comprehensive error and performance logging
| Service | Status | Technology | Notes |
|---|---|---|---|
| Frontend | ✅ Complete | Next.js 15 + React 19 | Ready for production, needs final polish |
| Backend | ✅ Complete | Fastify + SSE + PostgreSQL | Fully deployed and working |
| Oracle | ✅ Complete | TypeScript + Solana Web3.js | Handling real blockchain transactions |
| Scraper | ✅ Complete | TypeScript + WebSocket | Monitoring Twitch 24/7 |
- Real cryptocurrency betting with instant blockchain payouts
- Mobile-optimized experience for betting anywhere
- Live match streaming with integrated betting interface
- Achievement system with unlockable rewards and bonuses
- Modern tech stack with TypeScript everywhere
- Real-time architecture with SSE and WebSocket
- Clean separation of concerns across services
- Production-ready with comprehensive error handling
- Scalable architecture ready for millions of users
- Extensible design for new game types and features
- Blockchain-native built for the decentralized future
- Community-driven with referral systems and social features
The platform is fully functional and ready for users. Future enhancements include:
- Tournament system - Multi-match tournaments with brackets
- Advanced analytics - Detailed betting statistics and insights
- Social features - User profiles and community interactions
- Mobile app - Native iOS and Android applications
- Multi-chain support - Expand beyond Solana to other blockchains
We welcome contributions! Check out our individual service READMEs for specific development guides:
- Frontend Development Guide
- Backend Development Guide
- Oracle Development Guide
- Scraper Development Guide
MIT License - see LICENSE for details.