Documentation

Introduction

Welcome to our raffle platform. Our goal is to provide a transparent and fair raffle experience for all users. Our platform allows users to participate in raffles by purchasing tickets. Once all tickets for a raffle are sold, a winner is randomly selected. Below, you will find detailed information on how the platform works, including the percentages and fees, the smart contracts that power the raffles, and our security measures.

How It Works

Users can buy tickets for ongoing raffles. Each raffle has a predetermined number of tickets. Once all tickets are sold, a winner is randomly selected. Here are the steps:

• Select an ongoing raffle.
• Buy one or more tickets using BNB (depending on the type of raffle).
• Wait until all tickets are sold.
• A winner is randomly selected and announced.
• The prize is distributed to the winner, and a portion is allocated to referrers if applicable.

Multi-Raffle

In a Multi-Raffle, participants can purchase more than one ticket. This increases their chances of winning. Here’s how it works:

• Participants can buy multiple tickets for the same raffle.
• The more tickets purchased, the higher the chances of winning.
• Once all tickets are sold, a winner is randomly selected.

Single-Ticket Raffle

In a Single-Ticket Raffle, each participant is limited to purchasing only one ticket. This ensures equal chances of winning for all participants. Here’s how it works:

• Participants can only buy one ticket per raffle.
• Each participant has an equal chance of winning.
• Once all tickets are sold, a winner is randomly selected.

Percentages and Fees

Here is the breakdown of our fees:

• 80% of the total amount goes to the winner.
• 10% is kept by the platform for operational costs.
• 10% is distributed among referrers.

For example, in a raffle with 100 tickets each priced at 1 BNB, the distribution would be as follows:

• Total collected: 100 BNB
• Winner's prize: 80 BNB
• Platform's operational cost: 10 BNB
• Referrers' share: 10 BNB

Smart Contracts

Our raffles are powered by secure and transparent smart contracts. Below is an overview of the smart contracts used:

Raffle Contract

The Raffle contract manages the following:

• Ticket sales and pricing
• Tracking participants
• Selecting winners
• Distributing prizes and referral bonuses

The contract supports two types of raffles:

• Multi-Raffle: Allows participants to buy multiple tickets.
• Single-Ticket Raffle: Limits participants to one ticket each.

You can view the full Raffle contract code on the BscScan Testnet: [BscScan Testnet Link]

RaffleFactory Contract

The RaffleFactory contract is responsible for creating new raffle instances. It ensures that each raffle is set up with the correct parameters, such as ticket price, maximum number of tickets, and whether it allows single ticket purchases only.

You can view the full RaffleFactory contract code on the BscScan Testnet: [BscScan Testnet Link]

Security

We implement multiple security measures to protect our users:

• Smart Contract Audits: Our smart contracts are audited by third-party security experts to ensure there are no vulnerabilities.
• Secure Payments: All transactions are processed through secure and transparent smart contracts on the blockchain.
• Data Privacy: We do not store any sensitive user information. All interactions are conducted via smart contracts.

FAQs

Contract Address

You can view and verify our smart contracts on the BscScan Testnet/Mainnet using the following address:

• Raffle Contract: [Contract Address]
• RaffleFactory Contract: [Contract Address]

Raffle Reset Explanation

When a raffle is reset, all participants' data is cleared, and a new raffle instance is created. The ticket counts for users are reset, and the raffle becomes active again for new participants. This ensures a fresh start for each new raffle, maintaining fairness and transparency.

Referral System

Our referral system rewards users who bring in new participants. Here is how it works:

• When a user buys a ticket using a referrer's link, the referrer is registered in our system.
• If the referred user wins, a portion of the platform fee is allocated to the referrer.
• This encourages users to share the raffle with their network, increasing participation.

User Notifications

Winners are notified directly through the platform in the following ways:

• A toast notification appears when the winner logs into the platform.
• The "My Profile" section displays the total raffles won and the earnings.
• A detailed breakdown of past raffles, including winnings, is available on the dashboard.

This ensures winners are informed promptly, and all users can review their history transparently.

Owner Functions

Only the owner of the contract can perform certain actions to ensure the smooth operation of the platform. These actions include:

• Setting the ticket price.
• Changing the maximum number of tickets.
• Adjusting the winner and referral percentages.
• Creating new raffles through the RaffleFactory contract.

Random Number Generation

Our winner selection process uses a fair and secure random number generation algorithm. The process relies on blockchain properties, which ensures transparency and prevents tampering. The current method includes:

• Hash of the previous block (blockhash).
• Current block number and timestamp.
• Combined with participant data to ensure unpredictability.

This methodology guarantees fairness and makes it computationally infeasible to manipulate the result.

Error Handling and Limitations

We have built-in mechanisms to handle common errors and limitations, including:

• Ensuring that the correct ticket price is paid for each purchase.
• Checking that the maximum number of tickets is not exceeded.
• Verifying single ticket restrictions for specific raffles.

If any issues arise, our support team is available to assist users and ensure a smooth experience.