ClashGrid Technical Whitepaper
A Blockchain-Based Strategic Combat Game
Abstract
ClashGrid is a fully decentralized, turn-based strategic combat game built on the Solana blockchain. The game combines classical strategy mechanics with blockchain-verified randomness, elemental combat systems, and economic incentives through SOL wagering. This whitepaper presents the mathematical foundations, game mechanics, economic model, and technical architecture of ClashGrid.
Table of Contents
1. Introduction
1.1 Vision
ClashGrid represents a paradigm shift in blockchain gaming, offering a fully on-chain strategy game where every action is verifiable, every outcome is deterministic yet unpredictable, and every victory is economically rewarded. The game eliminates traditional gaming's trust requirements by leveraging blockchain's immutable nature.
1.2 Core Principles
- Transparency: All game logic executes on-chain
- Fairness: Blockchain-verified randomness ensures unbiased outcomes
- Economic Incentives: SOL wagering creates meaningful stakes
- Strategic Depth: Complex elemental and unit interactions
- Accessibility: Free-to-play options alongside wagered matches
2. Game Mechanics
2.1 Game Overview
ClashGrid is played on an 8×8 grid battlefield where two players command armies of elemental units. Each player deploys 8 units with varying types and elemental affinities, engaging in turn-based tactical combat until one army is eliminated.
2.2 Unit System
| Unit Type | Role | Health | Damage | Movement | Range | Special |
|---|---|---|---|---|---|---|
| Warrior | Glass Cannon | 10 | 6 | 1 | 1 | - |
| Mage | Mobile Artillery | 8 | 6 | 1 | 3 | - |
| Tank | Frontline Anchor | 16 | 5 | 1 | 2 | - |
| Healer | Mobile Support | 10 | 2 | 2 | 2 | Heal: 5 |
2.3 Elemental System
Units possess one of four elemental affinities following a cyclic advantage system:
Elemental Bonuses
+1 Damage to all attacks
+1 Heal Amount (healers only)
+2 Health points
+1 Movement range
3. Mathematical Framework
3.1 Damage Calculation
Base Damage Formula:
D_base = U_damage × E_multiplier × B_attack• U_damage = Unit's base damage value
• E_multiplier = Elemental effectiveness multiplier
• B_attack = Random attack bonus (0 or 1)
Elemental Multipliers:
E_multiplier = {
1.5, if attacker has elemental advantage
0.75, if attacker has elemental disadvantage
1.0, otherwise
}Advantage Examples:
- Fire vs Air: 1.5x damage
- Water vs Fire: 1.5x damage
- Earth vs Water: 1.5x damage
- Air vs Earth: 1.5x damage
3.2 Random Bonus System
Blockchain-Verified Randomness:
Seed = SHA256(blockhash || match_id)
selected_unit = Seed mod 8
B_attack = 1 (for selected unit), 0 (otherwise)Properties:
- Exactly 1 unit per side gets +1 attack bonus
- Deterministic per match (same seed = same bonuses)
- Unpredictable across matches
- Healers are excluded from random attack bonuses
3.3 Healing Mechanics
Base Healing Formula:
H_base = U_heal × E_compatibility × B_heal• U_heal = Unit's base healing value
• E_compatibility = Elemental compatibility bonus
• B_heal = Elemental healing bonus
Elemental Compatibility:
E_compatibility = {
1.25, if healer and target share element
1.15, if healer and target are complementary
1.0, otherwise
}4. Economic Model
4.1 Wagering System
Wager Constraints:
W_min ≤ W_match ≤ W_max• W_min = 0.01 SOL (minimum wager)
• W_max = 600 SOL (maximum wager)
• W_match = match wager amount
4.2 Prize Distribution
Winner's Share:
P_winner = (2 × W_match) × 0.98Development Fee:
F_dev = 0.02 (2%)4.3 Economic Incentive Analysis
Break-even Win Rate:
33.8%Players need to win more than 1 in 3 games to be profitable
5. Blockchain Architecture
5.1 Solana Program Structure
pub struct GameState {
pub authority: Pubkey,
}
pub struct MatchAccount {
pub player_one: Pubkey,
pub player_two: Pubkey,
pub match_id: u64,
pub state: MatchState,
pub winner: Option<Pubkey>,
pub wager_amount: u64,
pub created_at: i64,
}5.2 Instruction Set
Core Instructions:
- • CreateMatch
- • JoinMatch
- • CompleteMatch
- • ClaimWinnings
- • CancelMatch
Match States:
- • Created
- • InProgress
- • Ended
- • Draw
- • WinningsClaimed
- • Cancelled
8. Tokenomics
8.1 CLASHG Token
Token Specifications:
- • Symbol: CLASHG
- • Decimals: 9
- • Network: Solana (SPL Token)
- • Total Supply: 1,000,000,000 CLASHG
Token Utility:
- • Governance voting
- • Staking rewards
- • Premium features
- • Tournament entry
8.2 Token Distribution
10. Conclusion
ClashGrid represents a significant advancement in blockchain gaming, successfully combining strategic depth with economic incentives while maintaining complete transparency and fairness. The mathematical framework ensures balanced gameplay, the economic model creates sustainable incentives, and the blockchain architecture provides unprecedented security and verifiability.
The game's success demonstrates the viability of fully on-chain gaming experiences and establishes a foundation for the next generation of decentralized games. Through continued development and community engagement, ClashGrid aims to become the premier strategic combat game on Solana.
Additional Resources
This whitepaper is a living document and will be updated as the game evolves.
Document Version: 1.1 | Last Updated: January 2026 | Authors: ClashGrid Development Team