Skip to content

Latest commit

 

History

History
120 lines (47 loc) · 2.83 KB

README.md

File metadata and controls

120 lines (47 loc) · 2.83 KB
Raw

Lottery Dapp

Splash Screen

enter image description here This project is a decentralized application (dapp) for a lottery system built on the Base blockchain. The dapp allows users to participate in a lottery by purchasing tickets using ETH cryptocurrency. The smart contract governing the lottery is deployed on the Base network.

Smart Contract Details

Lottery Contract

  • Ticket Price: 0.001 ETH

  • Maximum Tickets per Lottery: 100

  • Ticket Commission: 0.0001 ETH per ticket

  • Duration: 30 minutes for each lottery

  • Expiration: Timeout in case the lottery is not carried out

  • Lottery Operator: Address of the creator/operator of the lottery

  • Operator's Total Commission: Total commission balance accrued by the operator

  • Last Winner: Address of the last winner of the lottery

  • Last Winner Amount: Amount won by the last winner

Functionalities

  • Users can purchase tickets by sending the required ETH.

  • The operator can draw the winner randomly after the purchase period expires.

  • Winners can withdraw their winnings.

  • The operator can withdraw accumulated commission.

  • The lottery can be restarted if no tickets were purchased.

Technologies Used

  • Solidity for Smart Contract Development

  • Next.js for the Web Application Interface

  • ThirdWeb for Smart Contract Interaction

  • Tailwind CSS for Styling

  • TypeScript for Typed JavaScript Development

How to Use

  1. Ensure you have a compatible Ethereum wallet (such as MetaMask) configured for the Base network and sufficient ETH to purchase tickets.

  2. Access the dapp interface deployed on a web browser.

  3. Connect your Ethereum wallet to the dapp and switch to the Mumbai testnet.

  4. View the current lottery details, such as remaining tickets, ticket price, and total pool, in ETH.

  5. Purchase tickets by specifying the quantity and confirming the transaction.

  6. Monitor the countdown timer for the lottery expiration.

  7. If you win, withdraw your winnings through the interface.

  8. If you're the lottery operator, manage the lottery through the admin controls.

Installation

  1. Clone the repository.

  2. Install dependencies using npm install.

  3. Set up environment variables required for the application.

  4. Run the application using npm run dev.

Known Issues and Future Improvements

  • Improvement: Implement better UI/UX for a more engaging user experience.

  • Known Issue: Lack of extensive error handling in certain scenarios.

  • Enhancement: Add more functionalities like multiple lottery rounds, different prize structures, etc.

Credits

This dapp is powered by ThirdWeb.