hackquest logo

Runera

Runera turns real effort into on-chain reputation

Videos

Project image 1
Project image 2
Project image 3
Project image 4

Tech Stack

Next
Web3
Solidity
Postgresql
Prisma

Description

Runera Move-to-Earn on Arbitrum

Turn every run into a permanent digital reputation.

Runera is a Move-to-Earn fitness dApp built on Arbitrum Sepolia that transforms your physical running activity into verifiable on-chain achievements. Connect your wallet, record GPS-verified runs, earn XP, level up through tiers, join competitive events, and collect soulbound achievement NFT, all powered by smart contracts on Arbitrum.


Problem Statement

Millions of people run every day, but their effort remains invisible and unverifiable. Existing fitness apps store data on centralized servers with no way to prove authenticity. Meanwhile, the Web3 fitness space is dominated by token-speculation models that prioritize financial incentives over genuine health outcomes.

There is no trusted system that lets runners own, prove, and showcase their fitness achievements in a tamper-proof, decentralized way.


Solution

Runera introduces Proof of Workout — a system where every verified run is backed by GPS data, anti-cheat validation, and on-chain state updates. Your running history becomes a soulbound digital identity that no one can fake or take away.

  • Soulbound Profile NFT (ERC-1155): Each user mints a non-transferable profile that tracks XP, level, tier, run count, total distance, and streak — all stored on-chain.

  • GPS Verification Pipeline: Runs are recorded with real-time GPS tracking, then validated through backend anti-cheat checks (pace limits, duration, distance thresholds, device fingerprinting) before stats are committed on-chain via EIP-712 signed messages.

  • Event-Driven Achievements: Users join time-bound competitive events, and upon completion, claim soulbound Achievement NFTs with tiered rankings (Bronze to Diamond).

  • Cosmetic Marketplace: A fully on-chain marketplace for tradeable cosmetic NFTs (shoes, outfits, accessories, frames) with escrow-based listings and a 5% platform fee.


Key Features

Authentication & Wallet

Seamless onboarding powered by Privy — users can log in with email, Google, or external wallets (MetaMask, WalletConnect). Embedded wallets are auto-created for non-crypto users, removing all Web3 friction.

Login Page

Home Dashboard

A comprehensive dashboard showing your current streak, weekly activity calendar, XP progress, level and tier status, latest verified runs, active events, and earned achievements — all in one glance.

Home Dashboard

GPS Run Recording

Real-time GPS tracking with live distance, pace, and duration metrics. Runs are visualized on an interactive map with route polylines. After completion, data is submitted for backend verification with a smooth validation animation.

Run Recording

Run Summary

Profile & Soulbound Identity

Your on-chain identity card. View your tier badge (Bronze through Diamond), XP progress bar, total stats, earned achievement NFTs, and equipped cosmetics. New users go through a guided 3-step onboarding: create wallet, claim testnet ETH, mint profile NFT.

Profile Page

Profile Onboarding

Events & Achievements

Browse and join competitive running events with distance targets and time windows. Track your progress with visual progress bars. Upon completion, claim soulbound Achievement NFTs directly from the smart contract with tiered rankings and XP bonuses.

Events Page

Event Detail

Event Manager

Authorized event managers can create new events directly from the frontend — setting distance targets, time windows, participant caps, and configuring on-chain rewards including badge name, icon, tier, XP bonus, and cosmetic item rewards.

Event Manager

Cosmetic Marketplace

A peer-to-peer marketplace for cosmetic NFTs. Browse banners and items by rarity (Common to Mythic), purchase with ETH, and equip them on your profile. Each cosmetic is an ERC-1155 token with on-chain metadata.

Marketplace

Streak & Activity Tracking

Daily streak tracking with a 4-week activity calendar. Maintain your streak by running consistently — your current and longest streaks are displayed prominently across the dashboard and profile.

Streak Calendar

Technical Architecture

Stack

Layer

Technology

Frontend

Next.js 16, TypeScript, Tailwind CSS v4

Backend

Node.js, Express, Prisma, PostgreSQL

Smart Contracts

Solidity, Foundry, ERC-1155

Blockchain

Arbitrum Sepolia

Authentication

Privy (embedded + external wallets)

Contract Interaction

Viem v2

Maps

React Leaflet

Deployment

Vercel (Frontend), Railway (Backend)

Architecture Diagram

User (Mobile/Desktop Browser)
        |
   Next.js Frontend (Vercel)
     /         \
Backend API     Smart Contracts
(Railway)       (Arbitrum Sepolia)
  |                  |
PostgreSQL    ERC-1155 NFTs
(Prisma)      (Profile, Achievement,
               Cosmetic, Marketplace,
               Events, AccessControl)

Data Flow

  1. Authentication: Privy handles wallet creation and signing. Backend verifies wallet signature via nonce challenge.

  2. Run Recording: Frontend captures GPS data → submits to backend → backend validates anti-cheat rules → signs EIP-712 message → updates on-chain profile stats.

  3. Events: Backend tracks participation and progress → on verified run completion, marks event progress → user claims Achievement NFT via smart contract.

  4. Marketplace: Smart contract handles escrow listings, purchases, and fee distribution. Frontend reads contract state via Viem.


Smart Contracts

All contracts are deployed on Arbitrum Sepolia and verified on-chain.

Contract

Address

AccessControl

https://sepolia.arbiscan.io/address/0x3518B6A434F79625011321E348d14895946e3Be9

ProfileNFT

https://sepolia.arbiscan.io/address/0xAcb9b3e8dadA2d25Db5420634Fb0eD96161824A5

AchievementNFT

https://sepolia.arbiscan.io/address/0xb2935413BAB7ABc75BBf1A91082b0F32cbB6E74F

CosmeticNFT

https://sepolia.arbiscan.io/address/0x94777E23b8E545eC57BD84DB58e0A800E9Db5aAD

Marketplace

https://sepolia.arbiscan.io/address/0x786b9b1475fFB5FA79af27054C614B53Efb053de

EventRegistry

https://sepolia.arbiscan.io/address/0x79651C3dd00661623bBA528c60A350C83C228Bc7

Deployer: https://sepolia.arbiscan.io/address/0x77CaAB88171A33Dbe09F94a0276aCE0d04D5e561

Contract Highlights

  • ProfileNFT (ERC-1155): Soulbound profile token storing XP, level, tier, run count, total distance, and streak. Supports gasless registration via registerFor().

  • AchievementNFT (ERC-1155): Soulbound achievement badges with 5-tier ranking system. Each achievement links to a specific event with custom metadata.

  • CosmeticNFT (ERC-1155): Transferable cosmetic items across 4 categories (Shoes, Outfit, Accessory, Frame) and 6 rarity levels (Common to Mythic).

  • Marketplace: Escrow-based P2P marketplace with partial order fills and 5% platform fee.

  • EventRegistry: On-chain event management with configurable rewards (XP, cosmetics, achievement badges).

  • AccessControl: Role-based permission system for backend signers and event managers.


What Makes Runera Different

  • Proof of Workout, not Proof of Speculation. Runera rewards actual physical activity, not token trading. Your achievements are earned through real runs verified by GPS and anti-cheat systems.

  • Soulbound Digital Identity. Your profile NFT and achievement badges are non-transferable. They represent your genuine fitness journey — not something that can be bought or sold.

  • Zero Web3 Friction. With Privy-powered embedded wallets, users can sign up with email or Google and start running immediately. No MetaMask setup, no seed phrases, no gas management for newcomers.

  • Hybrid Architecture. Backend handles speed-sensitive operations (run validation, event tracking) while smart contracts ensure immutability and verifiability of core achievements.

  • Anti-Cheat First. Every run goes through multi-layer validation: GPS path analysis, pace bounds checking, duration verification, and device fingerprinting before any on-chain reward is issued.


Roadmap

Completed (MVP)

  • Wallet authentication with Privy

  • Soulbound Profile NFT with dynamic tier progression

  • GPS run recording with anti-cheat validation

  • Event system with Achievement NFT rewards

  • Cosmetic marketplace with ERC-1155 items

  • Home dashboard with streak tracking

  • Full on-chain stats synchronization

In Progress

  • Public achievement verification endpoint

  • Proof Card generation (shareable 1200x630 PNG)

  • Enhanced run history with detailed analytics

Planned

  • Global leaderboard and runner rankings

  • Social features (follow runners, activity feed)

  • Elevation tracking for trail runs

  • Push notifications and run reminders

  • Mobile-native experience (PWA enhancement)

  • Mainnet deployment on Arbitrum One


Meet the Team

Runera is developed by a dedicated team focused on merging health with technology:

Fiegoldes Shindy — Project Manager

Bagus Wikan Yogasartono — Smart Contract Engineer

Emmanuel Abel Zoe — Frontend Developer

Matthew Alexander Sujanto — Backend Developer

Built with excellence for the Arbitrum Ecosystem.


Links

Progress During Hackathon

  • Week 1 (Feb 6-12): Foundation — repos, smart contracts deployment, scaffolding

  • Week 2 (Feb 13-19): Core features — profile onboarding, dashboard, GPS tracking, API integration, deployment

  • Week 3 (Feb 20-22): Events, marketplace, polish — event system, manager dashboard, cosmetics, final fixes

  • Summary table: 6 contracts, 5 pages, 12+ endpoints, 30+ commits, 16 days

Fundraising Status

Marked as not fundraising since Runera is a hackathon project built self-funded with free-tier infrastructure. Kept it honest and straightforward.

Team Leader
EEmmanuel Zoe
Project Link
Sector
SocialFiNFTOther