Tokamon

A location-based reward service where you earn TON tokens by visiting stores.

• Web (Spot Registration): https://go.tokamon.io
• iOS App: Download via TestFlight invite link
• Network: Thanos Sepolia (Tokamak Network Testnet)

See the User Guide for usage instructions.

Project Structure

tokamon/
├── client/             # Web client (Vite + React)
├── app/                # Mobile app (Expo + React Native)
├── contracts/          # Smart contracts (Foundry)
├── listener-server/    # Blockchain listener + API server (Cloud Run)
├── functions/          # Firebase Cloud Functions
├── shared/             # Shared modules (networks.js)
└── docs/               # Documentation

Documentation

• User Guide — App download, earning TON, spot registration
• Development: Setup Guide · Device Claim · Device ID
• Operations: Cloud Run Deploy/Monitoring · Alert Response · Deploy Guide · Security
• Architecture: Overview · DB Schema