ImpactChain

There are a total of 4 flows comprising in our app. The app is made to benefit for a social cause. This is a social media app and the mobile app is set up on the World ecosystem and there is Desktop based frontend as well. Contracts are deployed on World Mainnet.

Flow 1 : Social Media Post
Users can create posts which reflect the good deeds they did on that day that are automatically tokenized as NFTs with their metadata securely stored on IPFS. These posts become unique digital assets that other users can interact with. Community members can “like” posts or financially support them through “cheers,” which transfer funds directly to the post creator. Additionally, posts can be labeled and categorized by an AI model, helping to structure the content and make it more valuable for future dataset aggregation.

Flow 2: Campaign Management Creators can start larger campaigns around specific causes, such as organizing a tree plantation drive or cleaning a local river. Campaigns may or may not include bounties. If a bounty is added, the funder such as an NGO chooses DAO voters who will validate participation. Campaigns include details like type of activity and location, which helps in aggregating localized datasets. Participants RSVP by staking an amount. After the campaign, DAO voters verify who actually attended. Verified participants receive their bounty and staked funds back, while those unverified lose their stake, which gets redistributed to those who participated genuinely. Attestation flow: To ensure trust and transparency, DAO voters provide digital signatures confirming verified good deeds or campaign participation. These signatures are compiled into an attestation proof, stored on IPFS, and referenced on-chain. Attestations not only validate specific good deeds but also contribute to a participant’s long-term reputation. This reputation score can influence eligibility for future campaigns and increase trust in their contributions.

Flow 3: Dataset Monetization All verified good deeds and campaign data (such as photos of tree plantations, geolocations of clean-up drives, or logs of animal care activities) are aggregated into datasets by a Data DAO. The DAO cleans, organizes, and labels the data, transforming it into structured, trustworthy datasets. These datasets can then be monetized by offering access to governments, NGOs, or organizations that need reliable environmental, social, or community-related data. This creates a positive cycle: individuals are rewarded for doing good, and society benefits from high-quality datasets that drive larger impact projects.

Technology Stack

Frontend (React + TypeScript) • Framework: React 19 with TypeScript • Build Tool: Vite for fast development and building • Styling: Tailwind CSS 4.1.13 with custom animations • State Management: Zustand for global state • Routing: React Router DOM v7 • Web3 Integration: Wagmi v2.17.5 + Viem v2.37.8 • UI Components: Radix UI primitives with custom styling • Animations: Framer Motion + GSAP + Lenis for smooth scrolling

Smart Contracts (Solidity) • Language: Solidity ^0.8.27 • Framework: OpenZeppelin Contracts ^5.4.0 • Three main contracts:

1. SocialMediaPosts.sol - ERC721 NFT contract for posts
2. CampaignBountyManager.sol - Campaign creation and bounty distribution
3. SimpleDAOVoting.sol - DAO voting and attestation system

Backend Services • Node.js/Express servers for different functionalities • Supabase for database and real-time features • Lighthouse Protocol for IPFS storage and file management • Twitter API integration for social sharing

Key Integrations & Partner Technologies

1. Lighthouse Protocol (@lighthouse-web3/sdk)

   • Benefit: Decentralized file storage on IPFS with built-in authentication
   • Implementation: Handles image uploads, metadata storage, and content delivery
   • Why it matters: Eliminates centralized storage dependencies while providing reliable file management
   • Integration: Custom hooks (useLighthouseUpload, useLighthouseFetch) for seamless frontend integration

2. Supabase

   • Benefit: Real-time PostgreSQL database with instant subscriptions
   • Implementation: Stores user profiles, post metadata, and interaction data
   • Why it matters: Provides fast querying and real-time updates while maintaining decentralization
   • Integration: Custom service layer (supabaseService) for data synchronization

3. ENS (Ethereum Name Service)

   • Benefit: Human-readable identities and profile management
   • Implementation: Resolves wallet addresses to readable names and avatars
   • Why it matters: Improves user experience and builds trust through recognizable identities
   • Integration: Custom hooks (useEnsProfile) for seamless ENS resolution

4. World App Mini App

   • Benefit: Gasless transactions and mobile-first Web3 experience
   • Implementation: Account abstraction for simplified blockchain interactions
   • Why it matters: Removes barriers for non-crypto users and enables mobile adoption
   • Integration: Custom wallet connection and transaction handling

5. 1MB.io

   • Benefit: High-performance data delivery and CDN services
   • Implementation: Accelerates content delivery for images and metadata
   • Why it matters: Ensures fast loading times for decentralized content
   • Integration: Optimized data fetching and caching strategies

6. Twitter API

   • Benefit: Social media integration for campaign sharing
   • Implementation: OAuth 1.0a authentication with web intent fallback
   • Why it matters: Expands reach and enables viral campaign distribution
   • Integration: Custom service (twitterService) with CORS-safe implementation

Architecture Highlights

Hybrid On-Chain/Off-Chain Design • Critical data (posts, campaigns, votes) stored on-chain for immutability • Metadata, images, and user profiles stored on IPFS via Lighthouse • Supabase provides fast querying and real-time features • 1MB.io ensures optimal content delivery performance

Gas Optimization Techniques • Packed structs in smart contracts (e.g., Post struct uses bit packing) • Custom errors instead of require statements for gas efficiency • Efficient storage patterns and mappings • Minimal on-chain data storage with IPFS references

Mobile-First Approach • World App integration for gasless transactions • Responsive design with mobile-optimized components • Account abstraction for simplified user experience • Progressive Web App capabilities

Notable Technical Implementations

1. Attestation System: Cryptographic proof generation for verified activities using keccak256 hashing
2. Stake-Based RSVP: Economic incentives for genuine participation with automatic stake forfeiture
3. DAO Voting: Decentralized verification with majority consensus and automatic attestation generation
4. IPFS Integration: Decentralized content storage with Lighthouse authentication and 1MB.io delivery
5. Real-time Sync: Supabase subscriptions for live updates across all connected clients
6. ENS Profile System: Comprehensive identity management with fallback mechanisms

Hacky but Notable Features

1. Web Intent Twitter Integration: Uses Twitter's web intent API to avoid CORS issues instead of direct API calls - opens Twitter in popup window for user authentication
2. Hybrid Storage Strategy: Combines on-chain verification with off-chain performance optimization using multiple storage layers
3. Gas-Efficient Struct Packing: Manually packed structs to minimize storage costs (e.g., Post struct packs 5 fields into optimized storage slots)
4. Account Abstraction: Custom implementation for gasless transactions using World App's infrastructure
5. Fallback Mechanisms: Multiple fallback systems for ENS resolution, image loading, and data fetching
6. Progressive Enhancement: Graceful degradation from Web3 features to traditional web functionality

Data Flow Architecture

Post Creation Flow:

1. User uploads image → Lighthouse IPFS storage
2. Metadata creation → Supabase + IPFS
3. NFT minting → Smart contract
4. Real-time sync → Supabase subscriptions
5. Content delivery → 1MB.io CDN

Campaign Flow:

1. Campaign creation → Smart contract
2. RSVP with stakes → Contract escrow
3. Event execution → Off-chain tracking
4. DAO voting → Smart contract verification
5. Reward distribution → Automatic payout
6. Attestation generation → Cryptographic proof

The platform represents a sophisticated integration of multiple Web3 technologies to create a comprehensive social impact ecosystem that incentivizes genuine participation while maintaining decentralization and verifiability, with special focus on mobile accessibility through gasless transactions and optimal performance through strategic partner integrations.