The main dashboard where players begin their journey. Features quick access to battle modes, daily challenges, and current streak status. The interface displays the player's XP level, available game modes, and daily mystery box claim status. Clean, intuitive navigation ensures players can jump into action within seconds. |
Players choose between different battle types including Quick Match (free entry), Ranked Match (small SOL entry), and Daily Prediction Challenge. Each mode displays potential rewards, current player count, and estimated wait time for matchmaking. The interface clearly communicates the risk-reward balance for each option. |
Character selection screen showcasing available fighters with unique visual designs. Each fighter represents different playstyles and abilities. Players can view their collection, unlock progress, and select their preferred character before entering battle. This adds personalization and progression depth to the competitive experience. |
Comprehensive profile view displaying player statistics, including total XP, current level, win/loss ratio, and active streak count. Shows connected wallet address, earned badges, and overall ranking. Players can track their progression journey and view their competitive standing within the community. |
Daily prediction and trivia challenge interface where players answer Web3-related questions, predict SOL price movements, or guess network fee ranges. Features a countdown timer, question display, and multiple-choice answers. Correct predictions earn XP and maintain daily streaks, encouraging consistent engagement. |
Weekly leaderboard displaying top players ranked by XP earned during the current cycle. Shows player rankings, usernames, XP totals, and win streaks. The leaderboard resets weekly to maintain competitive balance and give all players fresh opportunities to climb the ranks. Real-time updates reflect the latest battle results. |
Daily mystery box claim interface offering free rewards including XP boosts, temporary streak multipliers, and chances to earn rare soulbound badges. Premium mode option allows small SOL entry for enhanced reward probability. Visual feedback shows reward rarity and claim history, creating anticipation and encouraging daily logins. |
Detailed analytics dashboard presenting comprehensive player performance metrics. Includes battle history, win rate trends, XP progression graphs, most-played game modes, and peak performance times. Provides insights into player improvement over time and helps identify strengths and areas for growth. |
ClashGo is a mobile-first competitive micro-game designed specifically for the Solana Mobile ecosystem.
The goal is to create a fast, addictive, daily on-chain competitive experience where users engage in 60-second PvP battles, earn XP, maintain streaks, and climb global leaderboards.
ClashGo demonstrates the power of Solana Mobile by creating a seamless, native mobile experience that integrates blockchain technology without compromising user experience. This showcases Solana's capability to support high-performance mobile dApps.
By implementing daily challenges, streak systems, and mystery boxes, ClashGo drives consistent on-chain activity, increasing transaction volume and network engagement on Solana.
The game introduces a sustainable micro-transaction model with optional SOL entry modes, demonstrating how blockchain games can monetize without complex tokenomics while keeping the barrier to entry low.
ClashGo utilizes Solana's NFT capabilities to create non-transferable achievement badges, showcasing innovative use cases for digital assets beyond trading and speculation.
As an open-source project, ClashGo serves as a reference implementation for developers looking to build mobile-native games on Solana, complete with wallet integration, Anchor programs, and React Native best practices.
The free-to-play mode with optional micro SOL entries provides an accessible entry point for Web2 users to experience blockchain gaming, helping grow the Solana user base.
Most Web3 applications struggle with daily engagement and long-term retention. Many dApps function primarily as financial tools rather than fun consumer experiences.
Solana Mobile requires high-stickiness, mobile-native applications that deliver meaningful on-chain interaction while remaining engaging and easy to use.
ClashGo introduces:
- 60-second PvP micro battles
- Daily streak multiplier system
- On-chain XP tracking
- Soulbound achievement badges
- Weekly global leaderboards
This creates a competitive habit loop powered by on-chain interaction.
- User connects wallet via Solana Mobile Wallet Adapter
- User joins a match (free mode or small SOL entry)
- Auto-matching pairs the player with another competitor
- 60-second challenge begins (tap-speed, reaction, or trivia)
- Smart contract settles the result on-chain
- XP and optional SOL rewards are distributed on-chain
This ensures fast gameplay with meaningful blockchain interaction.
Once per day, users can:
- Predict SOL price movement (up/down)
- Answer a mini Web3 trivia question
- Guess network fee range
Users sign a transaction, optionally stake a small amount of SOL, and earn XP based on accuracy.
This creates an additional daily engagement hook.
Daily free claim includes:
- Small XP reward
- Chance to receive a rare badge
- Temporary streak boost
- Premium mode:
- Small SOL entry
- Higher reward probability
This guarantees daily open behavior.
- Daily login streak tracking
- 7-day streak badge reward
- 30-day rare badge reward
- XP ladder progression system
- Weekly leaderboard reset
This creates long-term engagement and competitive motivation.
PlayerProfile- User profile and statsXPAccount- Experience points trackingStreakAccount- Daily streak managementMatchPool- PvP matchmaking poolPredictionPool- Daily prediction challengesRewardVault- Prize distributionBadgeMint- Soulbound NFT badges
initialize_player()
join_match()
submit_score()
settle_match()
submit_prediction()
claim_mystery_box()
update_streak()
mint_badge()All major interactions are settled on-chain to ensure transparency and fairness.
| Component | Technology |
|---|---|
| Frontend | React Native (Android-first design) |
| Blockchain | Solana + Anchor framework |
| Wallet Integration | Solana Mobile Wallet Adapter |
| Backend | Node.js (match coordination only) |
| Database | PostgreSQL Neon Cloud (off-chain stats caching) |
| Deployment | Functional Android APK required for submission |
- Free mode available
- Optional micro SOL entry mode
- XP is non-transferable
- Badges are soulbound
- No complex inflationary tokenomics
This ensures sustainability and simplicity.
- Connect wallet
- Join live battle
- Play 60-second match
- Show on-chain transaction confirmation
- XP and leaderboard update
- Claim mystery box reward
- Fast, clear, and visually engaging demo sequence
- Node.js (v18 or higher)
- Expo CLI
- Android Studio (for Android development)
- Solana CLI
- Anchor CLI
- Rust toolchain
- Clone the repository
git clone https://github.com/OjusMathur/ClashGo
cd solana-gamefi- Install dependencies
npm install- Install Anchor dependencies
cd anchor
npm install
cd ..- Set up environment variables
cp .env.example .env
# Edit .env with your configuration- Build Anchor program
cd anchor
anchor build
anchor deploy
cd ..- Start the development server
npm start- Run on Android
npm run androidclashgo/
├── anchor/ # Solana Anchor programs
│ ├── programs/ # Smart contracts
│ ├── tests/ # Program tests
│ └── migrations/ # Deployment scripts
├── src/ # React Native source code
│ ├── screens/ # App screens
│ ├── components/ # Reusable components
│ ├── hooks/ # Custom React hooks
│ ├── utils/ # Utility functions
│ └── services/ # API and blockchain services
├── assets/ # Images, fonts, and media
│ ├── pics/ # Screenshot images
│ ├── characters/ # Game character assets
│ ├── battle-icons/ # Battle UI icons
│ └── fonts/ # Custom fonts
├── components/ # Shared components
├── App.tsx # Main app entry point
└── package.json # Dependencies
- Real-time matchmaking
- 60-second quick matches
- Multiple game modes (tap-speed, reaction, trivia)
- On-chain result settlement
- XP tracking and leveling
- Daily streak rewards
- Weekly leaderboards
- Achievement badges
- Daily mystery boxes
- Streak bonuses
- Soulbound NFT badges
- Optional SOL rewards
- Solana Mobile Wallet Adapter
- Anchor program integration
- On-chain transaction verification
- Transparent and fair gameplay
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
ClashGo represents the future of mobile blockchain gaming on Solana:
- Accessibility: Free-to-play with optional micro-transactions
- Engagement: Daily challenges and competitive gameplay
- Innovation: Soulbound badges and on-chain progression
- Sustainability: Simple economy without complex tokenomics
- Mobile-First: Built specifically for Solana Mobile
- Open Source: Reference implementation for developers
By combining addictive gameplay with meaningful blockchain integration, ClashGo demonstrates how Solana can power the next generation of mobile gaming experiences.