Livus

Demo

About

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** ```typescript // 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** ```javascript // 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** ```typescript // 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** ```javascript // 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** ```solidity 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](https://github.com/YoruLabs/cannes-eth)