/cryptotux-raffle

A decentralized, transparent, and verifiable raffle system built on blockchain technology

Primary LanguageTypeScript

CryptoTux Raffle 🎫

A decentralized and verifiable raffle system built on Moonbeam Network.

📑 Article - 🟢 Demo Live

Project Structure 📂

cryptotux-raffle/
├── RANDOMNESS.md          # Documentation on random number generation
├── README.md             # Main project documentation
│
├── docs/                 # Documentation and guides
│   ├── CUSTOMIZATION.md  # How to customize the raffle
│   ├── DEPLOYMENT.md     # Deployment instructions
│   ├── FORK.md          # How to fork and modify
│   └── LICENCE          # Project license
│
├── moonbeam-raffle/     # Smart Contract Implementation
│   ├── contracts/       # Smart contract source files
│   │   └── LocalVRFRaffle.sol    # Main raffle contract
│   ├── data/           # Configuration data
│   │   └── participants.ts        # Participant management
│   ├── scripts/        # Deployment and interaction scripts
│   │   ├── deploy.ts             # Contract deployment
│   │   └── verify-participants.ts # Verification tools
│   └── ignition_backup/ # Deployment configurations backup
│
└── raffle-interface/    # Frontend Application
    ├── components/      # React component library
    │   ├── common/     # Shared UI components
    │   └── raffle/     # Raffle-specific components
    ├── config/         # Application configuration
    ├── constants/      # Global constants and contracts
    ├── hooks/          # Custom React hooks
    ├── pages/          # Next.js page components
    │   └── api/       # Secure API endpoints
    ├── public/         # Static assets and images
    ├── styles/         # Global styles and themes
    ├── types/          # TypeScript type definitions
    └── utils/          # Utility functions and raffle logic

Quick Start 🚀

  1. Clone and Install:
git clone https://github.com/cyphertux/cryptotux-raffle.git
cd cryptotux-raffle
  1. Smart Contracts: See moonbeam-raffle/README.md
  2. Frontend: See raffle-interface/README.md
  3. Detailed Guides: Check the docs folder

Features ✨

  • 🔒 Secure & Verifiable

    • Custom VRF implementation
    • Transparent random number generation
    • On-chain verification
    • API authentication

  • 🌐 Multi-Network Support

    • Moonbase Alpha (testnet)
    • Asset Hub Westend (Polkadot testnet)

  • 🎯 Fair Distribution

    • Decentralized winner selection
    • Verifiable randomness
    • Anti-manipulation safeguards

  • 📱 Modern Interface

    • Responsive design
    • Real-time WebSocket updates
    • User-friendly interactions
    • 6-second block time optimization

Documentation 📚

Comprehensive documentation available in the docs folder:

Development Status 🚧

  • ✅ Smart Contract Implementation
  • ✅ Frontend Interface
  • ✅ API Authentication
  • ✅ WebSocket Integration
  • ✅ Basic Documentation
  • 🔄 Advanced Features (In Progress)

License 📄

This project is licensed under LICENSE

Contact 📧

Contributing 🤝

Contributions are welcome! Please read our Contributing Guidelines first.