Provably fair, open-source giveaway winner selection for social media.
Trust Built into the Code.
Website • API Docs • X (Twitter) • Discussions
Fair-Giveaway is an open-source organization building transparent, auditable, and provably fair tools for the online giveaway ecosystem. Our flagship platform, fairgiveaway.online, eliminates the trust deficit in social media giveaways by conducting all randomization client-side using the Web Crypto API.
Every draw is cryptographically secure, every result is permanently recorded, and every participant list is publicly auditable.
┌──────────────────────────────────────────────────────────────────┐
│ How It Works │
├──────────────────────────────────────────────────────────────────┤
│ │
│ 1. SCRAPE & CACHE 2. CLIENT SHUFFLE │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ Tweet URL │──────▶│ Fisher-Yates │ │
│ │ Puppeteer + │ │ Shuffle using │ │
│ │ GraphQL Stream │ │ crypto.getRandom│ │
│ │ ▼ │ │ Values() │ │
│ │ Upstash Redis │ │ (in browser) │ │
│ │ (15 min TTL) │ └────────┬─────────┘ │
│ └─────────────────┘ │ │
│ ▼ │
│ 3. PERMANENT RECORD │
│ ┌─────────────────┐ │
│ │ MongoDB Atlas │ │
│ │ Immutable Proof │ │
│ │ Public Audit │ │
│ └─────────────────┘ │
└──────────────────────────────────────────────────────────────────┘
| Layer | Technology | Provider |
|---|---|---|
| Frontend | Next.js (App Router), TypeScript, Tailwind CSS v4 | Netlify |
| Backend | Bun, ElysiaJS, Puppeteer Headless | VPS (Docker) |
| Cache | Upstash Redis (Serverless) | Upstash |
| Database | MongoDB Atlas | MongoDB Cloud |
| Nodemailer + Zoho Mail SMTP | Zoho |
| Repository | Description |
|---|---|
fairgiveaway-frontend |
Next.js frontend with premium dark-mode UI, platform-scoped routing, client-side cryptographic shuffling, and public draw verification. |
fairgiveaway-backend |
ElysiaJS API server with Puppeteer scraping, anti-bot verification, session management, and permanent result storage. |
.github |
Organization profile, community health files, and shared configuration. |
We welcome developers, designers, and community members! Check out the contribution guidelines in each repository, pick an issue, and submit a Pull Request.
- 💬 GitHub Discussions — Questions, ideas, and feedback
- 🐛 Frontend Issues — UI bugs and feature requests
- 🐛 Backend Issues — API bugs and feature requests
If FairGiveaway has helped you host a transparent giveaway, consider supporting the maintainer:
- Trakteer (IDR): trakteer.id/isaacnewton1/link
- Ko-fi (International): ko-fi.com/isaacnewton1
- GitHub Sponsors: github.com/sponsors/isaacnewton123
If you found this tool helpful for running your giveaway, consider leaving a tip. Your support keeps the platform provably fair and free for everyone!
EVM Address
0x6e9b40a8fe85e7dcff40cfc9aa526106fe8e0546
Solana Address
AnBiWNPW68djMF6ERBpueF8tWmcvHr6iCYzriXwGh9k6
Licensed under the MIT License.
Made with ⚡ and ☕ by the Fair-Giveaway community.
