RaffleDrop

🎯 Overview

LuckyBid is a decentralized raffle-style marketplace where anyone can sell real-world or digital products, and buyers participate for a chance to win them at a fraction of the cost. Once the minimum funding goal (tickets sold) is met, a verifiably-random winner is selected using Switchboard VRF — ensuring fairness, transparency, and zero-trust execution on the Solana blockchain.

✨ Key Features

💰 Seller Guarantee: Sellers receive the full selling price when the raffle concludes successfully
🎟️ Affordable Participation: Buyers pay only a small entry fee for a chance to win high-value items
⚖️ Provably Fair Selection: Winners are chosen using verifiable on-chain randomness (Switchboard VRF)
📜 Smart-Legal Contracts: Optional legally-binding agreements prevent sellers from listing products elsewhere
🔒 Secure Escrow: All funds are held in Program Derived Address (PDA) vaults until conditions are met

🏗️ System Architecture

flowchart TD
    A[User / Buyer / Seller] --> B[Next.js Web App]
    B -->|Wallet Connect / Create Raffle / Buy Ticket| C[Anchor Smart Contract]
    C -->|Create Raffle PDA| D[Escrow Vault PDA]
    C -->|Collect Tickets SOL/USDC| D
    C -->|Trigger VRF Request| E[Switchboard VRF]
    E -->|Return Random Winner| C
    C -->|Payout Seller + Assign Winner| D
    C -->|Store Item Metadata| F[Arweave / IPFS]

Loading

🪙 Payment Flow

flowchart TD
    A[User Buys Ticket] --> B[Transfer Funds to Raffle PDA Vault]
    B --> C{Tickets >= Minimum Threshold?}
    C -->|Yes| D[Trigger Switchboard VRF Draw]
    D --> E[Winner Randomly Selected]
    E --> F[Seller Paid from PDA Vault]
    F --> G[Item / Escrow Released to Winner]
    C -->|No Deadline Passed| H[Refund Buyers Automatically]
    H --> I[Seller Deposit / NFT Returned]

Loading

🚀 Quick Start

Step 1: Install dependencies

pnpm install

Step 2: Sync program ID

pnpm anchor keys sync

Step 3: Build the program

pnpm anchor build

Step 4: Deploy to devnet

pnpm anchor deploy --provider.cluster devnet

Step 5: Start the frontend

pnpm dev

Notes:

• Ensure you have pnpm installed globally. If not, install it using:

  npm install -g pnpm

• Make sure you have Solana CLI and Anchor CLI installed and configured properly. Refer to the Anchor documentation for setup instructions.
• Replace --provider.cluster devnet with --provider.cluster mainnet for deploying to the mainnet.