Skip to content

chandan989/StrideOn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

54 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โšก StrideOn โšก

THE CITY IS YOUR BATTLEGROUND

Transform your urban environment into a strategic warzone. Convert physical locomotion into competitive territorial warfare while earning VERY tokens via your iPhone.

iOS TestFlight Mission Briefing Command Center Documentation


๐ŸŽฏ The Protocol Vision

StrideOn is a next-generation kinetic warfare protocol built exclusively for iOS. We bridge the gap between legacy fitness applications and complex Web3 combat systems. We've engineered a competitive move-to-earn battleground that's genuinely immersive, hyper-social, and serves as a gateway to the decentralized future.

The Problem

  • Legacy fitness apps: Low retention rates
  • Web3 games: Disconnected from physical reality

The Solution

GPS-based territorial warfare protocol that transforms every urban corridor into a tactical opportunity using Apple CoreLocation and H3 hexagonal spatial indexing.


StrideonScores: 0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0 VERY Token (Mock): 0x5FbDB2315678afecb367f032d93F642f64180aa3

๐Ÿ’ก How It Works

StrideOn deploys cutting-edge H3 hexagonal spatial indexing to transform urban environments into competitive combat zones with precision territorial control.

Core Combat Loop

๐Ÿƒโ€โ™‚๏ธ MOVE โ†’ โš”๏ธ ENGAGE โ†’ ๐Ÿฆ SECURE โ†’ ๐Ÿ’ฐ EXTRACT

Phase 1: Trail Generation

Deploy kinetic energy to generate luminescent GPS pathways mapped to H3 hex cells using MapKit. Every movement becomes part of your digital territorial claim.

Phase 2: Territorial Engagement

Detect hostile agent trails in real-time. Execute trail severance protocols to intercept enemy progressโ€”or deploy strategic loop formations to claim enclosed hexagonal sectors.

Phase 3: Blockchain Settlement

Navigate to designated banking nodes (real-world landmarks) to initiate settlement sequences. Convert claimed territory into permanent VERY tokens via on-chain verification.

Phase 4: Token Extraction

Secure earnings on distributed ledger, compete on global rankings, and establish territorial supremacy.


๐ŸŽฎ Game Mechanics

H3 Hexagonal Grid System

StrideOn uses Uber's H3 for fair, efficient spatial gaming:

  • Resolution 9-10: ~150-300m diameter cells, perfect for city-scale gameplay
  • Equal-Area: Every hex covers the same ground area globally
  • Efficient Neighbors: Fast proximity calculations for player detection
  • Global Consistency: Same hex ID = same location worldwide

Strategic Power-ups

Power-up Effect Duration Cost Use Case
๐Ÿ›ก๏ธ Shield Trail immunity 60s 50 VERY Protect risky expansions
๐Ÿ‘ป Ghost Mode Invisibility 45s 75 VERY Stealth attacks
๐Ÿš€ Speed Boost 2x claim rate 90s 100 VERY Maximize captures
โ„๏ธ Freeze Stop rivals 30s 150 VERY Defensive measure
๐Ÿ”ฅ Territory Burn Destroy claims Instant 200 VERY Aggressive counter

โšก VERY Network Integration

StrideOn is architected to demonstrate Very Network capabilities through deep protocol integration.

Real-World Utility

Transform kinetic energy expenditure into quantifiable value. Unlike abstract DeFi constructs or purely virtual NFT ecosystems, StrideOn generates tangible utility from physical movement.

VeryChat Integration

Real-time social intelligence transmitted directly to VeryChat:

  • Threat Alerts: Instant notifications when hostile agents sever your trail
  • Squad Formation: Coordinate with local operatives for neighborhood domination
  • Social Warfare: Build alliances through competitive engagement

VERY Token Economy

  • Rewards Protocol: Extract tokens for territorial acquisitions
  • Enhancement Systems: Deploy tokens for tactical advantages
  • Staking Mechanisms: Lock tokens for amplified earning multipliers
  • Governance Matrix: Vote on protocol upgrades and territorial expansions

๐Ÿ—๏ธ Technical Architecture

Hybrid Architecture: Velocity + Security

โšก Off-Chain Combat Layer (Velocity-Optimized)

  • FastAPI Neural Core: Sub-150ms response latency for real-time GPS processing
  • Redis Memory Matrix: In-memory hot state cache
  • WebSocket Gateway: Live multiplayer synchronization
  • H3 Spatial Engine: Uber's hexagonal grid system

๐Ÿ”’ On-Chain Settlement Layer (Security-Hardened)

  • Very Mainnet: High-throughput blockchain
  • Smart Contract Vault: Secure banking and reward distribution
  • Merkle Proof Verification: Gas-efficient batch validation
  • VERY Token: Native currency for all operations

Data Flow

iOS App โ†’ GPS Stream โ†’ FastAPI Server โ†’ H3 Mapping โ†’ Redis Cache
                โ†“
        Collision Detection โ†’ WebSocket Broadcast
                โ†“
        Settlement Request โ†’ Smart Contract โ†’ Token Transfer

๐Ÿ“ฑ iOS Application

Built exclusively with Swift and SwiftUI for seamless Apple ecosystem integration.

Tech Stack

  • Swift 5+: Native performance
  • SwiftUI: Reactive UI framework
  • MapKit + H3-Swift: High-precision mapping with hexagonal overlays
  • CoreLocation: Continuous background GPS tracking
  • Combine Framework: Reactive data streams and WebSocket integration
  • Core Data: Local persistence and offline capabilities

Deployment

# Prerequisites: Xcode 15+, iOS 16+ device with GPS
git clone https://github.com/chandan989/StrideOn.git
cd StrideOn/StrideonApp-iOS
open StrideOn.xcodeproj

# Configure signing, enable 'Background Modes' -> 'Location Updates'
# Build and run on device (Simulator has limited GPS capabilities)

๐Ÿ Backend Server

High-performance FastAPI server handling real-time game logic.

Core Components

  • FastAPI + Uvicorn: Async framework for high concurrency
  • WebSocket Manager: Real-time bidirectional communication
  • Redis: In-memory game state and pub/sub messaging
  • Supabase: Persistent database operations
  • H3 Library: Spatial calculations

Real-time Game Loop

class GameServer:
    async def handle_gps_update(self, user_id: str, lat: float, lng: float):
        h3_cell = h3.latlng_to_cell(lat, lng, resolution=9)
        await self.redis.lpush(f"trail:{user_id}:active", h3_cell)
        
        nearby_players = await self.get_nearby_players(h3_cell, radius=5)
        for player in nearby_players:
            if await self.check_trail_intersection(user_id, player.id):
                await self.process_cut_event(user_id, player.id)
        
        await self.websocket_manager.broadcast_to_region(
            h3_cell, 
            {"type": "position_update", "user": user_id, "cell": h3_cell}
        )

Setup

python -m venv .venv && source .venv/bin/activate
pip install fastapi uvicorn supabase redis h3 python-dotenv
uvicorn app:app --reload --host 0.0.0.0 --port 8000

๐ŸŒ Multi-City Expansion

Designed for global scalability from day one.

City Configuration

@dataclass
class CityConfig:
    name: str
    timezone: str
    center_coordinates: Tuple[float, float]
    h3_resolution: int
    daily_reward_pool: int
    special_events: List[str]
    power_up_costs: Dict[str, int]

SUPPORTED_CITIES = {
    "chandigarh": CityConfig(
        name="Chandigarh",
        timezone="Asia/Kolkata",
        center_coordinates=(30.7333, 76.7794),
        h3_resolution=9,
        daily_reward_pool=50000,  # 50K VERY daily
    )
}

๐Ÿš€ Getting Started

For Players

  1. Download via Apple TestFlight
  2. Sign up using Apple ID or VeryChat ID
  3. Complete tutorial (5-minute tactical briefing)
  4. Start moving and initiate territorial claims
  5. Earn VERY tokens by executing banking protocols

For Developers

Backend Deployment

git clone https://github.com/strideon/strideon-game
cd strideon-game
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
redis-server
uvicorn app:app --reload

iOS Setup

cd StrideonApp-iOS
open StrideOn.xcodeproj
# Ensure you have a valid Apple Developer Account for signing
# Run on physical device

Environment Variables

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-key
REDIS_URL=redis://localhost:6379/0
SIGNIFY_RPC_URL=https://rpc.signify.network
VERY_TOKEN_CONTRACT=0x...
WEPIN_APP_ID=your-app-id

๐Ÿ”ฎ Roadmap

Phase Timeline Milestones
Beta Launch Q4 2024 1000+ agents in Chandigarh, iOS TestFlight live
Multi-City Q1 2025 5 Indian cities, squad system, VeryChat integration
Global Scaling Q2 2025 25+ cities worldwide, Apple Watch Ultra integration
Platform Evolution Q3 2025 DAO governance, NFT achievement system
Ecosystem Maturity Q4 2025 Cross-platform sync, esports tournaments

Current Status: iOS neural terminal fully operational (v1.0 Beta)


๐Ÿ“Š Technical Specifications

Performance

  • Response Time: <150ms for real-time operations
  • Concurrent Users: 5000+ per city region
  • GPS Accuracy: ยฑ5 meters in urban areas (CoreLocation)
  • Battery Drain: <8% during active gameplay (iOS optimized)
  • Network Usage: <50MB/hour

Security

  • Anti-cheat: Velocity bounds, GPS consistency, behavioral analysis
  • Privacy: Minimal location retention, user-controlled settings via Apple HealthKit
  • Transactions: Cryptographic signatures and verification

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guide for details.


๐Ÿ“„ License

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


๐Ÿ“ž Contact & Community


โšก READY TO TRANSFORM YOUR URBAN ENVIRONMENT? โšก

Join the kinetic warfare revolution
Making fitness engaging โ€ข Making Web3 accessible

Deploy Now โ€ข Watch Briefing โ€ข Access HQ


Engineered with โšก for the global kinetic warfare community

v1.0.0-iOS | Network Uptime: 99.9%

๐Ÿ† StrideonScores Hackathon Integration

Deployed Contract Addresses (Local Hardhat Network)

  • StrideonScores: 0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0
  • Mock VERY Token: 0x5FbDB2315678afecb367f032d93F642f64180aa3
  • Mock Price Oracle: 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
  • Timelock: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

Run Simulation

cd very-network-integration
npx hardhat run deploy-hackathon.js --network hardhat

About

StrideOn is a decentralized running game where real-world joggers conquer and defend territories by moving through them, all powered by Web3. Using blockchain and GPS, every run you make can help you claim new zones, see other players nearby, and grow your digital domain-without relying on a central authority.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors