Whitepaper

KaspaLuckyBot is an innovative project built on the Kaspa blockchain. It provides a transparent, fair, and engaging platform for Kaspa (KAS) holders to participate in a decentralized luck-based game. By leveraging the speed and security of the Kaspa network, the bot offers an accessible way for users to test their luck while contributing to the project's ecosystem. This white paper outlines the core mechanics, financial model, and vision for the KaspaLuckyBot project.

1. Introduction: The Vision

   The goal of KaspaLuckyBot is to create a simple and verifiable game of chance. Acknowledging the need for engaging applications within the Kaspa ecosystem, the bot was developed to provide a fun and rewarding experience for users. The game operates on a lottery-style model, where participants purchase tickets for a chance to win a significant portion of a shared pot, with all transactions and drawing logic designed to be as transparent as possible.

2. Core Mechanics

   The KaspaLuckyBot game is designed with a straightforward system of tickets, odds, and prize distribution.

   • Tickets: There are two types of tickets available for purchase, each contributing a specific weight to a user's chance of winning:
     • Standard Ticket: The base entry ticket. Each standard ticket is assigned a value of 2 Effective Odds Units.
     • Golden Ticket: A premium ticket with a higher weight, offering a significantly greater chance of winning. Each golden ticket is assigned a value of 6 Effective Odds Units.
   • Effective Odds Units: This is the core metric for determining a user's probability of winning. It represents the total “weight” a user holds in the lottery pool. A user's chance of winning is calculated as a ratio of their total effective odds units to the total effective odds units of all participants.
   • The Prize Pot: The prize pot is funded by the KAS collected from ticket purchases. The pot size increases with each new ticket sold, providing a dynamic and growing prize for the winner.
3. Financial Model

   The KaspaLuckyBot is a self-sustaining project with a clear and transparent financial model designed to reward winners and support continuous development.

   • Pot Distribution: For each game round, the gross pot is divided as follows:
     • Winner's Share (80%): The majority of the pot is allocated to the lucky winner, providing a substantial and compelling reward. This high percentage ensures the game remains highly attractive to participants.
     • Service Fee (20%): The remaining 20% of the pot is allocated as a service fee, which is used to cover operational costs, fund future development, and support marketing efforts to grow the game.
   • Sustainability: The 20% service fee ensures the long-term viability of the project. It covers server costs, API fees, and development hours required to maintain the bot and introduce new features, ensuring the game can run reliably and evolve over time.
4. Transparency and Security

   The integrity of the KaspaLuckyBot is paramount. The project leverages the inherent transparency and security of the Kaspa blockchain to ensure fairness.

   • Verifiable Operations: All ticket purchases and prize payouts are recorded as on-chain transactions, providing a public and immutable ledger of all activity.
   • Randomized Drawing: The winning ticket is selected using a verifiable and transparent method. A randomized sequence is used for choosing a winner, applying a weighted selection so tickets with higher weight have a greater chance of being chosen.

     Here’s how the randomization works:

     • Build a list of all individual tickets, assigning a weight to each one based on its type (e.g., golden tickets have a higher weight than standard ones).
     • Calculate the totalWeight of all tickets combined.
     • Generate a single, random integer r using crypto.randomInt() within the range of totalWeight. The crypto module provides a cryptographically secure source of randomness, ideal for a lottery or prize draw.
     • Iterate through the tickets, accumulating their weights until the cumulative total is greater than or equal to r. The ticket that crosses the threshold is declared the winner.

     This ensures a fair outcome and properly favors “golden” tickets as intended. The project is committed to using an audited and secure process, such as a verifiable random function (VRF) or a publicly auditable seed, to ensure that every participant has a fair and equal chance of winning based on their effective odds units.

5. Future Development

   While the core functionality is already operational, the KaspaLuckyBot team is committed to continuous improvement and expansion. Future plans include:

   • Transition to Smart Contract Model: Plans to migrate the core game logic to a smart contract on the Kaspa network to achieve true decentralization, ensuring the drawing process is entirely trustless and verifiable on-chain.
   • Introduction of New Game Modes: Exploring new variations of the game with different prize structures or ticket systems to keep the experience fresh and engaging.
   • User-Voted Features: Implementing a system for users to propose and vote on new features, ensuring the bot's development is aligned with user desires.
   • Enhanced Analytics: Providing users with detailed, in-bot analytics about their participation, odds, and game history.
6. Conclusion

   KaspaLuckyBot is more than just a game; it is a project designed to add a layer of fun and engagement to the Kaspa ecosystem. By offering a transparent, fair, and rewarding experience, the bot aims to attract new users and provide a valuable service to the existing community. The transparent financial model and commitment to continuous improvement ensure that KaspaLuckyBot is a sustainable and long-lasting part of the Kaspa network.