Skip to content

Run, capture territories, earn datacoins for real-world data using Yellow statechannels. Came up with this for the Cloka Run Club

Notifications You must be signed in to change notification settings

fabianferno/touchgrass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒฑ touchgrass

Run. Explore. Earn Datacoins.

touchgrass is a gamified running app that turns real-world movement into a new form of data mining.
Built for ETHGlobal, it uses Yellow Network state channels, Reclaim Protocol zkTLS proofs, and Lighthouse Datacoins to reward users for verified, privacy-preserving real-world data contributions.


๐Ÿš€ What It Does

When users go for a run and hit START, touchgrass opens a state channel via Yellow Network (Nitrolite) between their wallet and the backend server.
As they move, their GPS coordinates stream off-chain in real time, allowing instant location updates and gameplay interactions with no gas fees.

While running, users can complete data quests โ€” e.g., spotting potholes, EV chargers, or water fountains.
Each quest generates:

  1. a zkTLS proof (via Reclaim Protocol) verifying time & location without revealing sensitive data,
  2. an LLM-based validation step to check the photo content,
  3. and a Datacoin mint using the Lighthouse SDK.

When the runner presses STOP, the Yellow state channel settles on-chain โ€” finalizing captures, verifying proofs, and distributing Datacoins to the userโ€™s wallet.

All mined Datacoins are stored through Lighthouse and published to 1MB.io as consumer data assets.


๐Ÿง  Why We Built This

We wanted to make touching grass productive โ€” to turn outdoor activity into a decentralized data collection network.
Instead of mining blocks, users mine reality โ€” contributing verifiable, privacy-preserving data that can power open maps, smart cities, and environmental analytics.


๐Ÿ—๏ธ How Itโ€™s Made

  • Next.js โ€” Web app frontend and dashboard
  • Mapbox GL JS โ€” Live map of runners, datacoins, and territories
  • Yellow SDK + Nitrolite Protocol โ€” Session-based off-chain transactions and on-chain settlement
  • Reclaim Protocol (zkTLS) โ€” Privacy-preserving proofs of time and location
  • Lighthouse SDK โ€” Datacoin minting and decentralized storage
  • MongoDB โ€” Run, user, and datacoin persistence
  • LLM Validator (Python microservice) โ€” Content validation for data submissions

Architecture:

About

Run, capture territories, earn datacoins for real-world data using Yellow statechannels. Came up with this for the Cloka Run Club

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •