Skip to content

HashDrop is a cross-chain, AI-powered hashtag reward engine built for DAOs, brands, and communities. It turns social media hashtag participation (like tweets, casts) into verifiable on-chain achievements — delivering rewards such as NFTs or tokens based on the quality of participation.

Notifications You must be signed in to change notification settings

jerrymusaga/HashDrop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HashDrop

HashDrop is a cross-chain, AI-powered hashtag reward engine built for DAOs, brands, and communities. It turns social media hashtag participation (like tweets, casts) into verifiable on-chain achievements — delivering rewards such as NFTs or tokens based on the quality of participation.

HashDrop Campaign Factory - Complete Analysis

🎯 System Overview

HashDrop is a decentralized platform that enables brands and creators to launch hashtag-based social media campaigns with automatic NFT rewards. The system monitors social media engagement (specifically Farcaster) and distributes NFT rewards to participants based on their engagement scores.

Core Components

  • Campaign Factory: Main contract for creating campaigns
  • Campaign Contract: Manages individual campaigns
  • NFT Contract: Handles reward NFT creation and distribution
  • Oracle: Monitors social media for hashtag usage
  • Vault: Stores and manages NFT rewards
  • CCIP Manager: Handles cross-chain functionality

🏗️ System Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   User/Brand    │───▶│ Campaign Factory │───▶│   Campaign      │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │                        │
                                ▼                        ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   NFT Contract  │◀───│      Vault       │◀───│   Oracle        │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │                        │
                                ▼                        ▼
                       ┌──────────────────┐         ┌─────────────────┐
                       │   CCIP Manager   │         │   Farcaster     │
                       │  (Multi-chain)   │         │   Monitoring    │
                       └──────────────────┘         └─────────────────┘

👥 User Types & Scenarios

1. Casual Creator (Simple Campaign)

Profile: Small influencer, content creator, or indie brand Needs: Easy-to-use campaign creation without technical complexity Budget: $50-500

2. Marketing Professional (Advanced Campaign)

Profile: Marketing agency, established brand, growth hacker Needs: Detailed control over tiers, chains, monitoring frequency Budget: $500-10,000+

3. Enterprise Brand (Custom Campaign)

Profile: Large corporation, major brand Needs: White-label solution, custom integrations Budget: $10,000+

📱 Detailed User Stories

Story 1: Casual Creator - "Coffee Shop Promotion"

Character: Sarah, owner of a local coffee shop Goal: Promote new seasonal drink with simple hashtag campaign Technical Knowledge: Basic (knows how to use social media, unfamiliar with crypto)

Scenario Flow:

  1. Discovery: Sarah hears about HashDrop from a crypto-savvy friend

  2. Research: Visits website, sees simple "Launch Campaign" button

  3. Decision: Wants to give away 100 NFTs for #SarahsSpiceLatte posts

  4. Campaign Setup:

    • Hashtag: "#SarahsSpiceLatte"
    • Description: "Show off your Spice Latte moment!"
    • Duration: 14 days
    • NFT Rewards: 100 NFTs
    • NFT Name: "Spice Latte Lover"
    • Image: Photo of the drink
    • Multichain: No (too complicated)
  5. Cost Calculation:

    • Base cost: 100 × 0.001 ETH = 0.1 ETH
    • Monitoring: 14 × 0.01 ETH = 0.14 ETH
    • Total: 0.24 ETH ($400)
  6. Payment: Pays with ETH (friend helps with wallet setup)

  7. Campaign Launch: System automatically configures everything

  8. Monitoring: Oracle starts watching Farcaster for hashtag usage

  9. Results: 150 people use hashtag, first 100 get NFTs automatically

Pain Points Addressed:

  • No need to understand blockchain technology
  • No CCIP configuration required
  • Automatic budget calculation
  • Simple single-tier rewards
  • Built-in monitoring

Story 2: Marketing Professional - "Product Launch Campaign"

Character: Mike, digital marketing manager at a tech startup Goal: Launch new app with sophisticated reward tiers Technical Knowledge: Intermediate (understands marketing funnels, some crypto knowledge)

Scenario Flow:

  1. Planning: Mike plans tiered campaign for app launch

  2. Campaign Design:

    • Hashtag: "#TechAppLaunch2025"
    • Duration: 30 days
    • Total NFTs: 1,000
    • Tiers:
      • Bronze (70%): Basic participants (1+ engagement)
      • Silver (25%): Active promoters (5+ engagements)
      • Gold (5%): Super promoters (20+ engagements)
    • Multi-chain: Yes (Polygon, Arbitrum, Base)
    • Custom monitoring: Every 2 hours
  3. Advanced Configuration:

    AdvancedCampaignParams({
      basic: SimpleCampaignParams({
        hashtag: "#TechAppLaunch2025",
        description: "Revolutionary new app launch!",
        durationDays: 30,
        nftRewardCount: 1000,
        nftName: "App Launch Pioneer",
        nftImageURL: "https://cdn.example.com/base-nft.png",
        enableMultiChain: true
      }),
      tierNames: ["Bronze Pioneer", "Silver Pioneer", "Gold Pioneer"],
      tierImageURLs: ["bronze.png", "silver.png", "gold.png"],
      tierDistribution: [70, 25, 5],
      tierThresholds: [1, 5, 20],
      specificChains: [137, 42161, 8453], // Polygon, Arbitrum, Base
      monitoringHours: 2
    })
  4. Cost Calculation:

    • Base: 1,000 × 0.001 ETH = 1 ETH
    • Multichain premium: 1 ETH × 0.5 = 0.5 ETH
    • Monitoring: 30 × 0.01 ETH = 0.3 ETH
    • Total: 1.8 ETH ($3,000)
  5. Execution: Campaign runs across multiple chains

  6. Results:

    • 2,500 participants across all chains
    • 700 Bronze, 250 Silver, 50 Gold NFTs distributed
    • Real-time analytics dashboard

Advanced Features Used:

  • Custom tier system with different reward levels
  • Multi-chain deployment for broader reach
  • Custom monitoring frequency
  • Specific chain selection
  • Advanced analytics

Story 3: Enterprise Brand - "Global Brand Campaign"

Character: Lisa, CMO of a major fashion brand Goal: Global campaign with region-specific rewards Technical Knowledge: Expert (has dedicated blockchain team)

Scenario Flow:

  1. Strategy: Global campaign with regional customization

  2. Custom Development: Works with HashDrop team for white-label solution

  3. Campaign Structure:

    • Multiple simultaneous campaigns per region
    • Different hashtags: #BrandUSA, #BrandEU, #BrandAPAC
    • Custom smart contracts with brand-specific logic
    • Integration with existing CRM systems
  4. Enterprise Features:

    • Custom CCIP configuration for private chains
    • Bulk campaign creation APIs
    • Advanced analytics and reporting
    • Custom Oracle feeds from multiple social platforms
    • Compliance features for different jurisdictions

🔄 Detailed User Flow - Simple Campaign

Pre-Launch Phase

User Research → Cost Estimation → Wallet Connection → Form Filling → Payment → Confirmation

Launch Phase

Parameter Validation → Contract Deployment → NFT Configuration → Oracle Setup → Campaign Activation

Active Phase

Social Monitoring → Engagement Scoring → Reward Distribution → Real-time Analytics → User Notifications

Post-Campaign Phase

Final Distribution → Analytics Report → Campaign Archive → Community Building → Future Campaign Planning

💰 Cost Structure Breakdown

Simple Campaign (100 NFTs, 14 days, single chain):

  • NFT Base Cost: 100 × 0.001 ETH = 0.1 ETH
  • Monitoring Cost: 14 × 0.01 ETH = 0.14 ETH
  • Gas Fees: ~0.05 ETH (estimated)
  • Platform Fee: 5% of total
  • Total: 0.32 ETH ($530)

Advanced Campaign (1,000 NFTs, 30 days, multichain):

  • NFT Base Cost: 1,000 × 0.001 ETH = 1 ETH
  • Multichain Premium: 1 × 0.5 = 0.5 ETH
  • Monitoring Cost: 30 × 0.01 ETH = 0.3 ETH
  • CCIP Fees: ~0.2 ETH (cross-chain messages)
  • Platform Fee: 5% of total
  • Total: 2.1 ETH ($3,500)

🛡️ Security & Risk Scenarios

Handled Scenarios:

  1. Insufficient Payment: Automatic refund of excess payment
  2. Invalid Parameters: Comprehensive validation before execution
  3. Oracle Failures: Backup monitoring systems
  4. Cross-chain Issues: CCIP redundancy and retry mechanisms
  5. Reentrancy Attacks: ReentrancyGuard implementation

Edge Cases:

  1. Campaign Overflow: More participants than NFTs available
  2. Chain Congestion: Dynamic gas pricing and retry logic
  3. Social Platform Changes: Adaptable Oracle architecture
  4. Regulatory Changes: Compliance modules per jurisdiction

📊 Success Metrics

For Users:

  • Engagement Rate: Hashtag usage vs. target audience
  • Reach Amplification: Social media impressions generated
  • Community Growth: New followers/subscribers gained
  • Brand Awareness: Sentiment analysis and mention tracking

For Platform:

  • Campaign Success Rate: % of campaigns meeting goals
  • User Retention: Repeat campaign creators
  • Cross-chain Adoption: Multi-chain vs single-chain usage
  • Revenue Growth: Total campaign value processed

🚀 Technical Implementation Highlights

Smart Contract Features:

  • Gas Optimization: Batch operations and efficient storage
  • Upgradeability: Proxy patterns for future improvements
  • Modularity: Separate contracts for different functions
  • Cross-chain: CCIP integration for multi-chain support

Oracle Integration:

  • Real-time Monitoring: Automated social media scanning
  • Engagement Scoring: Sophisticated algorithm for fair distribution
  • Anti-gaming: Sybil resistance and authentic engagement detection
  • Scalability: Handles high-volume campaigns efficiently

This system represents a sophisticated yet user-friendly approach to decentralized social media marketing, bridging traditional marketing needs with blockchain technology benefits.

About

HashDrop is a cross-chain, AI-powered hashtag reward engine built for DAOs, brands, and communities. It turns social media hashtag participation (like tweets, casts) into verifiable on-chain achievements — delivering rewards such as NFTs or tokens based on the quality of participation.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •