From 65d88a25e28d41816c798ebe22ce776dab1134f6 Mon Sep 17 00:00:00 2001
From: Jeremy Lee <calijeremylee@gmail.com>
Date: Wed, 29 Oct 2025 14:22:05 -0400
Subject: [PATCH] add comment for clarity

---
 plume/src/spin/Raffle.sol | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/plume/src/spin/Raffle.sol b/plume/src/spin/Raffle.sol
index 2a8647b0..6d4f5d9b 100644
--- a/plume/src/spin/Raffle.sol
+++ b/plume/src/spin/Raffle.sol
@@ -271,6 +271,8 @@ contract Raffle is Initializable, AccessControlUpgradeable, UUPSUpgradeable {
 
     function invalidateWinner(
         uint256 prizeId,
+        // winnerIndex refers to the index of the winner in the prizeWinners array
+        // NOT the winning ticket index
         uint256 winnerIndex
     ) external onlyRole(ADMIN_ROLE) {
         if (winnerIndex >= prizeWinners[prizeId].length) {
@@ -424,6 +426,8 @@ contract Raffle is Initializable, AccessControlUpgradeable, UUPSUpgradeable {
 
     function claimPrize(
         uint256 prizeId,
+        // winnerIndex refers to the index of the winner in the prizeWinners array
+        // NOT the winning ticket index
         uint256 winnerIndex
     ) external {
         // Check if this specific winner exists
@@ -570,6 +574,8 @@ contract Raffle is Initializable, AccessControlUpgradeable, UUPSUpgradeable {
 
     function isWinnerValid(
         uint256 prizeId,
+        // winnerIndex refers to the index of the winner in the prizeWinners array
+        // NOT the winning ticket index
         uint256 winnerIndex
     ) external view returns (bool) {
         return !invalidWinners[prizeId][winnerIndex];