Livus

Own your health data, compete in challenges with real metrics from Oura and Whoop, and earn rewards

Livus

Created At

ETHGlobal Cannes

Winner of

World - Best Mini App 2nd place

The Graph - Best Application Built on Hypergraph (Knowledge Graph Framework) 2nd place

Project Description

Livus is a comprehensive Web3 health platform that solves two critical problems in the digital health space: data ownership and health engagement.

The Problem

Current health apps create data silos where users lose control of their health information. Additionally, most fitness apps lack meaningful incentives to maintain healthy habits, leading to poor long-term engagement.

Our Solution

1. Health Wallet - True Data Ownership Livus creates the first decentralized health wallet where users truly own their health data. Using The Graph's indexing infrastructure and Hypergraph Protocol for private storage, we enable:

  • Cross-app portability: Take your health history to any compatible application
  • Permission-based sharing: Users control who accesses their data through cryptographic signatures
  • Interoperable ecosystem: Build once, use everywhere across health apps
  • Private encrypted storage: Personal health data stored in wallet-authenticated private spaces

2. AI Health Assistant - Privacy-First Insights Powered by Oasis ROFL (Runtime On-chain Federated Learning), we provide users with personalized health insights without compromising privacy:

  • Trusted Execution Environment: DeepSeek R1 1.5B model runs in Intel TDX secure enclaves
  • Zero data exposure: Health analysis happens without raw data leaving the secure environment
  • Personalized recommendations: AI-driven insights for sleep optimization, challenge preparation, and health goals
  • HIPAA compliance: Enterprise-grade privacy protection for sensitive health data

3. Gamified Health Challenges We combine real health data with blockchain-based challenges to create sustainable engagement:

  • Stake-to-play mechanics: Users stake WLD tokens to participate in health challenges
  • Real health metrics: Integration with Oura and Whoop devices via Terra API
  • Automated prize distribution: Smart contracts distribute rewards based on actual health achievements
  • Human verification: World ID ensures only verified humans participate, preventing bot manipulation

Key Innovations

Decentralized Health Data Infrastructure

  • Users own their health data through The Graph subgraphs and Hypergraph Protocol
  • Health metrics are indexed and queryable across applications
  • Privacy-preserving AI analytics through Oasis ROFL integration
  • Cryptographic wallet-based authentication for health data access

Privacy-First AI Health Assistant

  • DeepSeek R1 1.5B model running in Oasis ROFL Trusted Execution Environment
  • Zero-exposure health analysis with personalized insights and recommendations
  • HIPAA-compliant processing of sensitive health data
  • Challenge optimization and health goal recommendations

Transparent Challenge System

  • Smart contracts on Worldchain manage all challenge logic
  • Real-time health data determines winners automatically
  • Cryptographic proofs ensure fair competition

Seamless User Experience

  • Native World App integration with MiniKit SDK
  • Gasless transactions through Permit2 integration
  • Mobile-first design optimized for daily health tracking

Target Market

  • Health-conscious individuals seeking better engagement tools
  • Fitness app developers wanting to integrate with user-owned health data
  • Healthcare providers needing interoperable patient data
  • Researchers requiring aggregated, anonymized health insights

Vision

Livus aims to become the foundational layer for a new generation of health applications built on user-owned data, where individuals control their health information and are rewarded for maintaining healthy lifestyles.

How it's Made

Architecture Overview

Livus is built as a multi-layered Web3 application combining blockchain infrastructure, real-world data integration, and mobile-first user experience.

Core Technologies

Frontend - Next.js 15 + World App Integration

  • Next.js 15 with App Router for modern React development
  • MiniKit SDK for seamless World App integration
  • TypeScript for type-safe development
  • Tailwind CSS for responsive, mobile-first UI
  • Viem for blockchain interactions

Backend - Node.js + Real-time Data Processing

  • Express.js API server with real-time webhook processing
  • Terra API integration for Oura and Whoop device data
  • Winston for comprehensive logging and monitoring
  • Supabase for PostgreSQL database with real-time subscriptions

Blockchain - Solidity + Worldchain

  • Solidity 0.8.19 smart contracts with security best practices
  • Worldchain Mainnet for low-cost, WLD-native transactions
  • Permit2 integration for gasless user transactions
  • Foundry for contract development and testing

Privacy & Data Infrastructure

  • The Graph Protocol for decentralized health data indexing and cross-app compatibility
  • Hypergraph Protocol for private, encrypted health data storage with wallet-based authentication
  • Oasis ROFL for privacy-preserving AI health analytics in Trusted Execution Environments

Partner Technology Integrations

World Ecosystem - Complete Integration

// World ID Human Verification
const result = await MiniKit.commandsAsync.verify({
  action: "verify-human",
  signal: "",
  verification_level: "orb",
});

// Gasless WLD Transactions via Permit2
const { finalPayload } = await MiniKit.commandsAsync.sendTransaction({
  transaction: [joinTransaction],
  permit2: [permitConfig],
});

Benefits of World Integration:

  • Sybil resistance: World ID prevents bot participation
  • Native WLD support: Seamless token staking and rewards
  • Mobile-first UX: Optimized for World App ecosystem
  • Gasless transactions: Better user experience through Permit2

Terra API - Real Health Data

// Process real-time health data webhooks
app.post("/api/terra/webhook", async (req, res) => {
  const { type, data } = req.body;
  switch (type) {
    case "sleep":
      await processSleepMetrics(data);
      break;
    case "activity":
      await processActivityData(data);
      break;
  }
});

Benefits of Terra Integration:

  • Device agnostic: Works with Oura, Whoop, and other devices
  • Real-time data: Immediate health metric updates
  • Comprehensive metrics: Sleep, activity, HRV, and more
  • Reliable infrastructure: Production-ready health data pipeline

The Graph - Decentralized Health Data

// Health data indexing for cross-app compatibility
const GET_USER_HEALTH_WALLET = gql`
  query GetUserHealthWallet($userAddress: String!) {
    user(id: $userAddress) {
      healthMetrics {
        sleepEfficiency
        averageHRV
        dailySteps
        timestamp
      }
      challengeHistory {
        id
        result
        prize
      }
    }
  }
`;

// Cross-app data sharing with permissions
const shareHealthData = async (targetApp: string, permissions: string[]) => {
  const signature = await signPermission(permissions);
  return await graphClient.shareData(targetApp, signature);
};

Benefits of The Graph Integration:

  • Data portability: Users can take their health history to any compatible app
  • Decentralized indexing: No single point of failure for health data
  • Permission-based access: Users control who can access their data
  • Interoperable ecosystem: Enables a new generation of health applications

Oasis ROFL - Private AI Health Assistant

// Private health analysis in Trusted Execution Environment
const getHealthInsights = async (userHealthData) => {
  const response = await fetch("/api/oasis/chat", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      message: `Analyze my health data: ${JSON.stringify(userHealthData)}`,
      system:
        "You are a health assistant. Provide personalized insights based on the user's health metrics.",
    }),
  });

  const insights = await response.json();
  return insights;
};

// Secure health data processing without exposure
const analyzeHealthTrends = async (healthMetrics) => {
  const analysis = await oasisROFL.processHealthData({
    data: healthMetrics,
    model: "deepseek-r1-1.5b",
    privacy: "maximum",
  });
  return analysis;
};

Benefits of Oasis Integration:

  • Privacy-preserving AI: Health analysis without data exposure
  • Trusted Execution: Intel TDX hardware-level security
  • HIPAA compliance: Enterprise-grade privacy protection
  • Personalized insights: AI-driven health recommendations and challenge optimization

Smart Contract Architecture

HealthChallengePool.sol - Core Challenge Logic

function joinChallengeWithPermit2(
    uint256 challengeId,
    ISignatureTransfer.PermitTransferFrom memory permit,
    ISignatureTransfer.SignatureTransferDetails memory transferDetails,
    bytes memory signature
) external {
    // Permit2 gasless WLD transfer
    PERMIT2.permitTransferFrom(permit, transferDetails, msg.sender, signature);

    // Add participant to challenge
    participants[challengeId][msg.sender] = true;
    challenges[challengeId].participantCount++;
}

Security Features:

  • Signature verification: Backend-signed challenge completion
  • Reentrancy protection: SafeGuards on all state changes
  • Access control: Owner-only critical functions
  • Permit2 integration: Secure, gasless token transfers

Notable Technical Achievements

1. Privacy-Preserving AI Health Assistant Successfully integrated Oasis ROFL to provide users with personalized health insights without exposing sensitive data. The DeepSeek R1 1.5B model runs in Intel TDX Trusted Execution Environment, ensuring HIPAA-compliant health analysis while maintaining maximum privacy.

2. Decentralized Health Data Ownership Implemented user-owned health data through Hypergraph Protocol with wallet-based authentication. Users can securely store their health metrics in private encrypted spaces and control access through cryptographic signatures.

3. Gasless UX with Permit2 Instead of requiring users to hold ETH for gas, we implemented Permit2 signatures allowing users to participate in challenges with only WLD tokens. This dramatically improves onboarding for non-crypto natives.

4. Real-time Health Data Processing We built a robust webhook system that processes health data from multiple device types in real-time, calculating challenge-specific metrics and updating user progress instantly.

5. Cross-platform Health Wallet Architecture Using The Graph (in development) and Hypergraph Protocol, we're creating a health data layer that allows users to own their data while enabling other applications to build on top of it with proper permissions.

6. Mobile-first World App Integration Complete MiniKit SDK integration with optimized mobile UI, human verification flows, and transaction handling specifically designed for the World App ecosystem.

Development Challenges & Solutions

Challenge: Integrating real-world health data with blockchain Solution: Built a reliable webhook processing system with Terra API that validates and stores health metrics, then uses cryptographic signatures to ensure data integrity when determining challenge winners.

Challenge: Creating gasless transactions for better UX Solution: Implemented Permit2 integration allowing users to sign permits for WLD transfers without needing ETH, making the platform accessible to users who only hold WLD.

Challenge: Ensuring fair competition in health challenges Solution: Combined World ID human verification with real device data from Terra API, creating a system where only verified humans with actual health tracking devices can participate.

Future Technical Roadmap

The Graph Health Wallet Expansion

  • Health data subgraphs for cross-app compatibility (in development)
  • Advanced user-controlled data permissions and sharing
  • Decentralized health data marketplace
  • Healthcare provider integration with consent management

Oasis AI Assistant Enhancements

  • Multi-modal health analysis combining lifestyle and biometric data
  • Predictive health modeling for early intervention
  • Federated learning across user base while maintaining privacy
  • Integration with healthcare research (anonymized data contribution)

Advanced Health Metrics

  • Real-time anomaly detection in health patterns
  • Personalized challenge difficulty adjustment
  • Social health challenges with privacy-preserving leaderboards
  • Integration with additional health device manufacturers

Repository Structure

livus/
├── client/          # Next.js frontend with World App integration
├── server/          # Node.js backend with Terra API webhooks
├── contracts/       # Solidity smart contracts on Worldchain
└── docs_integrations/ # Technical documentation

Live Demo: Deployed on Worldchain Mainnet Contract: 0xB36b82E2090D574Dfd5f3bCc835af09A3De8fb1F GitHub: YoruLabs/cannes-eth

background image mobile

Join the mailing list

Get the latest news and updates