trueluck Smart Contract Basic Functions.

About trueluck functions.

The TrueLuck smart contract powers all raffle and lottery rooms deployed on Polygon PoS. It handles ticket purchases, room management, winner selection, and automated payouts in a fully on-chain and transparent way.

🎟️ Ticketing

buyTicket() → Allows users to purchase raffle tickets (directly in USDT if on Polygon, or via Stargate if cross-chain).

Validates payment and mints an entry into the raffle room.

Tracks buyer address and number of tickets.

🏠 Room Management

createRoom() → Factory function to spawn new raffle rooms with rules (ticket cap, ticket price, duration).

fillRoom() → Tracks when a room reaches its capacity (all tickets sold).

closeRoom() → Finalizes the room once the winner is determined and payout is done.

🎲 Randomness

requestRandomness() → Calls Chainlink VRF once the room is full.

fulfillRandomness() → Receives the random number from Chainlink and stores it securely on-chain.

🏆 Winner & Payout

selectWinner() → Uses the VRF random number to select a winning ticket.

payoutWinner() → Sends USDT on Polygon to the winner’s wallet automatically.

🔄 Safety / Extras

refundTickets() → Handles refunds if a room fails to fill or a transaction error occurs.

getRoomStatus() → Public view function to check status (open, filled, winner decided, closed).

getPlayerEntries() → Shows how many tickets a player owns in a given room.

✅ Everything is transparent, automated, and on-chain.

No manual intervention, no centralized control—just fair raffles powered by Polygon, Stargate, and Chainlink VRF.