How kaagaaz/waypoint works
Waypoint is an Android hotspot-security app. The user opens the dashboard and starts monitoring; the foreground honeypot service listens on configured ports, records connection attempts, and can start the VPN-based protection service. Threat records feed the incident-log feature, while settings cover theme and auto-resolve preferences. The README also describes packet inspection, scan/ARP-spoofing detection, packet blocking, and deceptive honeypot responses, but the sampled service excerpt only demonstrates port listeners and connection logging; those deeper capabilities are not represented as implemented flows here.
Main entry points: HoneypotService.kt Honeypot listener · WayPointAdaptiveScaffold.kt App navigation · MainActivity.kt Main activity · dashboardScreen.kt Dashboard
Components 20
App experience
- Main activity
app/java+kotlin/com.example.waypointv12/MainActivity.kt - App navigation
app/java+kotlin/com.example.waypointv12/UI/Navigation/WayPointAdaptiveScaffold.kt - Dashboard
app/java+kotlin/com.example.waypointv12/UI/Dashboard/dashboardScreen.kt - Dashboard state
app/java+kotlin/com.example.waypointv12/UI/Dashboard/dashboardViewModel.kt - Incident log
app/java+kotlin/com.example.waypointv12/UI/Logs/LogSreeen.kt - Log state
app/java+kotlin/com.example.waypointv12/UI/Logs/LogViewModel.kt - Settings
app/java+kotlin/com.example.waypointv12/UI/Settings/SettingSreeen.kt - Menu
app/java+kotlin/com.example.waypointv12/UI/Menu/MenuScreen.kt
Threat monitoring
- Honeypot listener
app/java+kotlin/com.example.waypointv12/service/HoneypotService.kt - File scanner
app/java+kotlin/com.example.waypointv12/Data/FileScanner.kt
Protection
- VPN protection
app/java+kotlin/com.example.waypointv12/service/CoreProtectionService.kt
State and records
- User preferences
app/java+kotlin/com.example.waypointv12/Data/UserPreferenceRepository.kt - Threat database
app/java+kotlin/com.example.waypointv12/Data/AppDatabase.kt - Threat repository
app/java+kotlin/com.example.waypointv12/Data/ThreatRepository.kt - Threat DAO
app/java+kotlin/com.example.waypointv12/Data/ThreatDao.kt - Threat record
app/java+kotlin/com.example.waypointv12/Data/Threat.kt - Encrypted storage
app/java+kotlin/com.example.waypointv12/Data/EncryptedStorage.kt
Other components
- User
- Network host
- Android network
Connections 20
- User → Main activity: opens app
- Main activity → App navigation: shows UI
- Main activity → Honeypot listener: starts service
- Main activity → VPN protection: starts service
- App navigation → Dashboard: routes to
- App navigation → Incident log: routes to
- App navigation → Settings: routes to
- App navigation → Menu: routes to
- Dashboard → Dashboard state: requests state
- Dashboard state → File scanner: runs scan
- Honeypot listener → Android network: observes connectivity
- Network host → Honeypot listener: connects to port
- Honeypot listener → Threat repository: inserts threat
- Honeypot listener → VPN protection: starts protection
- Honeypot listener → User preferences: reads auto-resolve
- Threat database → Threat DAO: provides DAO
- Threat repository → Threat DAO: calls
- Threat repository → Threat record: stores records
- Dashboard → Incident log: opens logs
- Settings → Dashboard state: changes theme