nexus/wiki/concepts/Reentrancy.md at 82741b1c69efe56a5cff21b0ad9a2d1037abdb55

Files

weishen 55d3745bb0 ingest: Blockchain Security Auditor + 4 entities + 2 concepts

- Source: blockchain-security-auditor.md (The Agency Specialized, smart contract security audit agent)
- Entities: The-DAO-2016, Euler-Finance, Nomad-Bridge, Curve-Finance
- Concepts: Reentrancy, Oracle-Manipulation
- Updated: index.md (消除了source missing标记), overview.md, log.md

2026-04-25 10:52:41 +08:00

2.9 KiB

Raw Blame History

title, type, tags, sources, last_updated

title

type

中文定义

重入攻击（Reentrancy）：智能合约在执行外部调用后、在状态更新前，允许攻击者通过回调函数再次进入合约逻辑，从而在状态被正确更新前回滚执行、重复提取资金或操纵合约状态的漏洞类型。

问题描述

当合约 A 调用合约 B 的函数时，合约 B 可以在其 receive()/fallback() 函数中回调合约 A 的函数。如果合约 A 在外部调用之前读取了状态（如用户余额），但在该调用返回后才更新状态（清零余额），攻击者合约 B 可以在余额清零前回拨合约 A 的函数，再次触发提取逻辑。

攻击模式

1. 单函数重入（Single-Function Reentrancy）

最简单的模式：同一个函数在执行中被再次调用。The DAO 和 Curve Finance 属于此类。

2. 跨函数重入（Cross-Function Reentrancy）

攻击者通过不同的函数路径重入合约，利用状态不一致进行攻击。例如：withdraw() 读取的余额与 transfer() 检查的余额不同步。

3. 只读重入（Read-Only Reentrancy）

攻击者通过 view 函数读取合约状态（在外部调用期间），利用该状态作为预言机输入进行攻击，无需写入合约。

4. ERC-777 / ERC-1155 钩子重入

即使合约没有 receive() 函数，使用 ERC-777 代币标准时，transfer() 会触发 tokensReceived() 钩子，攻击者可在钩子中重入。

防御机制

Checks-Effects-Interactions Pattern

// ✅ 正确顺序：先更新状态，再执行外部调用
function withdraw() external {
    uint256 amount = balances[msg.sender];
    require(amount > 0);
    balances[msg.sender] = 0;          // 先更新状态
    (bool success,) = msg.sender.call{value: amount}(""); // 后外部调用
    require(success);
}

Reentrancy Guard

import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";

contract SecureVault is ReentrancyGuard {
    function withdraw() external nonReentrant {
        // nonReentrant 修饰符防止任何重入
    }
}

关键案例

The-DAO-2016：历史上首个大规模重入攻击，损失 360 万 ETH，直接导致 ETH/ETC 硬分叉
Curve-Finance：Vyper 编译器 bug 导致 nonreentrant 失效，损失超 7000 万美元
blockchain-security-auditor 的 Source Page 示例代码：展示了完整的有漏洞合约和修复后合约

关联概念

Access-Control：权限控制缺失会加剧重入攻击的影响
Flash-Loan-Attack：重入攻击常与闪电贷结合使用
Checks-Effects-Interactions Pattern：标准防御模式
Slither：Slither 的 reentrancy-eth 检测器可发现大多数经典重入漏洞

2.9 KiB Raw Blame History Unescape Escape