Khoj - Web3 Treasure Hunt Platform

Khoj (meaning "search" or "discovery" in Hindi) is a gamified geo-location based treasure hunt platform that combines real-world exploration with Web3 technology. Built during ETHIndia Hackathon 2024, Khoj transforms traditional scavenger hunts into an immersive blockchain experience with a dream to bring millions of new users to the Web3 world.

Khoj allows users to participate in location-based AI treasure hunts where they solve riddles, visit physical locations, and earn onchain rewards. Users receive unique NFTs upon registration, and the platform supports multiple blockchain networks for maximum accessibility.

• Progressive Riddles: Each hunt consists of multiple interconnected clues that tell a story.
• Location-Based Verification: The answer to each clue is a physical location.
• Personalised Clues: The clues are tailored to the user's taste using AI while still keeping the answer same.
• Multiple Attempts: Players get 3 attempts per clue to verify their location
• Real-time Collaboration: Built-in video chat for team coordination.
• Rewards & Reputation: Fastest players win rewards based on a reputation score generated which can be redeemed later.

• Multi-Chain Support: Deployed across Base, Moonbeam Parachain, and BNB Chain
• Smart Wallet Integration: Seamless login via Coinbase Developer Platform SDK
• NFT Registration: Unique NFTs minted for each registered user
• Decentralized Storage: Rich media and hunt data stored on Walrus network
• Trust Scoring: Dynamic trust score & attestation system based on hunt completion metrics
• Blockchain Attestations: Every solved clue is attested on-chain via True Network
• Smart Contract Integration: Hunt registration and reward distribution handled on-chain
• Token Rewards: Earn Crypto Coins and special perks based on performance

• Superior UX:
• Sleek UI: Modern, responsive interface with playful design elements
• Picture-in-Picture: Continue video collaboration while solving clues
• Reward Marketplace: Redeem earned rewards for real-world perks

1. Co-Branded Hunts

   Brands can sponsor treasure hunts to promote their products or services. Example: A sports brand can create a hunt where players visit local gyms and sports shops, promoting their latest line of athletic wear.

2. Airdrops

   Projects and blockchain platforms can organize hunts to distribute airdrops to their community. Example: A new blockchain project might require participants to solve riddles related to their platform to earn free tokens.

3. Community Engagement

   DAOs and NFT communities can host collaborative hunts to strengthen member connections. Example: An NFT art community might host a hunt to physical art galleries, ending with exclusive NFT drops.

4. Educational Hunts

   Organizations can use Khoj to create educational experiences. Example: A museum could create a hunt where participants explore exhibits while solving riddles about history or science.

5. Local Tourism Promotion

   Tourism boards or local councils can host hunts that encourage exploration of cultural landmarks. Example: A hunt through a city's historical sites with rewards tied to local crafts or businesses.

6. Team-Building Activities

   Corporations can use Khoj for team-building exercises. Example: Employees work together to solve riddles and explore company campuses or nearby landmarks.

7. Event-Based Engagement

   Conferences, expos, and festivals can host themed hunts to enhance attendee experiences. Example: A hackathon event could include a hunt guiding participants to booths of key sponsors and talks.

8. Fitness and Wellness Incentives

   Khoj can partner with fitness apps or gyms to encourage physical activity. Example: Users participate in a hunt requiring them to run or walk to specific locations.

• Frontend: React, TypeScript, TailwindCSS
• Web3:
  • True Network SDK for attestations
  • Multi-chain deployment (Base, Moonbeam, BNB Chain)
  • Coinbase's CDP SDK for smart wallet authentication
  • Lit Protocol for secure location verification and blind compute
  • Walrus for decentralized storage
• Storage & Media:
  • Walrus Network for NFT and hunt data
  • Distributed content delivery
• Video: Huddle01 for real-time collaboration
• UI Components:
  • Radix UI primitives
  • Recharts for data visualization
  • Custom animated components

• Trust attestations for hunt completions
• Verifiable location proofs
• Reputation scoring system

• L2 smart contract deployment
• Low-cost transactions
• Fast finality for real-time updates

• Decentralized video collaboration
• Web3-native communication
• Secure team coordination

• CDP SDK for smart wallet integration
• Seamless user onboarding
• Secure authentication
• OnchainKit for transactions
• Wallet integration

• Distributed secret management
• Blind compute network capabilities
• Secure location verification
• Cross-chain composability
• Privacy-preserving computations

• Decentralized storage for NFT metadata
• Rich media content storage (images, videos, audio)
• Efficient erasure coding for data availability
• Sui-powered coordination layer
• Cost-effective content distribution

1. Clone the repository:

git clone https://github.com/yourusername/khoj.git

2. Install dependencies:

cd khoj
npm install

3. Set up environment variables:

cp .env.example .env
# Add your API keys for:
# - True Network
# - Huddle01
# - Other services

4. Start the development server:

npm run dev

1. Register: Create an account and receive your unique NFT using CDP SDK
2. Browse Hunts: Explore available treasure hunts stored on Walrus network
3. Connect Wallet: Use smart wallet login powered by CDP SDK
4. Solve Riddles: Each hunt presents a series of location-based riddles
5. Verify Location: Use Lit Protocol to securely verify your presence
6. Collaborate: Use Huddle01's video chat to work with other hunters
7. Earn Trust: Build your trust score through successful completions
8. Claim Rewards: Earn rewards on your preferred supported chain

Your trust score (0-10) is calculated based on:

• Speed of hunt completion
• Accuracy of location verification
• Number of attempts used
• Collaboration with other players

Higher scores unlock:

• Better ETH rewards
• Exclusive hunts
• Merchant discounts
• Additional attempts for difficult clues

We welcome contributions! Please see our Contributing Guidelines for details.

This project is licensed under the MIT License - see the LICENSE file for details.

• Built during ETHIndia Hackathon 2024
• True Network team for their attestation infrastructure
• Huddle01 team for their video collaboration platform
• Base for providing the L2 infrastructure
• Coinbase for OnchainKit

• Abhiraj Mengade
• Ayush Kumar Singh
• Mardav Gandhi
• Parth Mittal
• Shubham Rasal

Built with ❤️ by Team Khoj