Documentation

Technical Overview and Product Whitepaper

Vision

ClashGo aims to bring competitive gaming to the Solana Mobile ecosystem with a focus on fairness, speed, and accessibility. We believe mobile gaming should be fast, transparent, and rewarding for players who show up daily. Our mission is to create an engaging PvP experience that respects players' time while leveraging blockchain technology for true ownership and verifiable outcomes.

Problem

Traditional mobile games suffer from several critical issues that diminish player experience and trust:

  • Opaque matchmaking and reward systems that favor monetization over fairness, leaving players questioning game integrity
  • Long session times that don't fit modern mobile usage patterns, requiring 30+ minutes per match
  • Centralized control over player achievements and progression, with no true ownership of earned rewards
  • Limited transparency in competitive outcomes and rankings, making it impossible to verify fair play
  • Pay-to-win mechanics that create unfair advantages and frustrate dedicated players

Solution

ClashGo addresses these challenges through innovative blockchain integration and player-first design:

  • On-chain settlement via Solana Anchor programs for transparent, verifiable results that can't be manipulated
  • 60-second micro battles designed for quick mobile sessions, perfect for playing anywhere, anytime
  • Soulbound badges and non-transferable XP that represent genuine achievement and skill progression
  • Daily streak multipliers that reward consistent engagement without requiring hours of grinding
  • Free-to-play core with optional micro SOL entry for competitive modes, ensuring accessibility for all
  • Real-time matchmaking that pairs players of similar skill levels for balanced, competitive matches

Gameplay Flow

Connection

Players connect their Solana Mobile Wallet Adapter to authenticate and enable on-chain features. No email or password required. The wallet integration is seamless and secure, taking less than 10 seconds to complete. Your wallet becomes your identity in the ClashGo ecosystem.

Match Entry

Choose between free practice mode or competitive mode with optional micro SOL entry. Matchmaking pairs players of similar skill levels using our ELO-based ranking system. Queue times are typically under 30 seconds during peak hours. Select your preferred game mode and jump straight into action.

Battle

Engage in fast-paced 60-second PvP battles where every decision counts. Strategic card selection, timing, and resource management determine the winner. Matches are quick enough to play during a coffee break but deep enough to reward skill and strategy. Real-time combat keeps you on your toes.

Settlement

Results are settled on-chain through our Anchor program within seconds of match completion. Winners receive XP, maintain streaks, and earn badges. All outcomes are verifiable on Solana's blockchain explorer. No disputes, no cheating - just pure, transparent competition. Transaction fees are minimal thanks to Solana's efficiency.

Progression

Daily streaks multiply XP gains up to 5x for consistent players. Weekly leaderboards showcase top performers with special recognition and rewards. Mystery boxes provide daily rewards for active players, including rare badges and bonus XP. Your progression is permanent and verifiable on-chain.

Architecture

Frontend

React Native mobile application with Solana Mobile Wallet Adapter integration. Optimized for performance on mobile devices with smooth 60 FPS gameplay. Built with TypeScript for type safety and maintainability. Supports both Android and iOS platforms with native performance.

Backend

Node.js API server handling matchmaking, game logic, and database operations. PostgreSQL stores player data, match history, and leaderboards with full ACID compliance. Redis caching layer ensures sub-100ms response times. Horizontally scalable architecture ready for millions of players.

Blockchain

Solana Anchor program manages on-chain settlement, RewardVault for prize distribution, and soulbound badge minting. All critical game outcomes are recorded on-chain for transparency. Smart contracts are audited and open-source. Leverages Solana's 400ms block times for near-instant settlement.

Economy

XP is non-transferable and earned through gameplay, preventing market manipulation. Badges are soulbound NFTs representing achievements that can't be bought or sold. Optional micro SOL entry modes create competitive prize pools managed by the RewardVault smart contract. 95% of entry fees go to winners, 5% supports development.

Tech Stack

  • React Native - Cross-platform mobile development with native performance and smooth animations
  • Node.js - Backend API and game server with Express.js framework for robust routing
  • PostgreSQL - Player data and match history with full relational database capabilities
  • Solana - Blockchain settlement and verification with sub-second finality
  • Anchor - Smart contract framework for on-chain logic with built-in security features
  • Redis - In-memory caching for lightning-fast matchmaking and leaderboard queries
  • TypeScript - Type-safe development across frontend and backend

Roadmap

ClashGo is currently in active development with alpha testing planned for Q2 2026. We are focused on delivering a polished core experience before expanding features. Planned updates include tournament modes, clan systems, and seasonal events. Join our waitlist to be notified when we launch and get early access to exclusive founder badges.