Update nexus: fix conflicts and sync local changes

2026-04-26 12:06:50 +08:00
parent 191797c01b
commit f09834b5a5
2443 changed files with 254323 additions and 255154 deletions
--- a/wiki/concepts/Reentrancy.md
+++ b/wiki/concepts/Reentrancy.md
@@ -1,65 +1,65 @@
---
-title: "Reentrancy"
-type: concept
-tags: [smart-contract, vulnerability, defi, solidity, security]
-sources: [blockchain-security-auditor]
-last_updated: 2026-04-25
---
-
-## 中文定义
-
-**重入攻击（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
-```solidity
-// ✅ 正确顺序：先更新状态，再执行外部调用
-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
-```solidity
-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` 检测器可发现大多数经典重入漏洞
+---
+title: "Reentrancy"
+type: concept
+tags: [smart-contract, vulnerability, defi, solidity, security]
+sources: [blockchain-security-auditor]
+last_updated: 2026-04-25
+---
+
+## 中文定义
+
+**重入攻击（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
+```solidity
+// ✅ 正确顺序：先更新状态，再执行外部调用
+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
+```solidity
+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` 检测器可发现大多数经典重入漏洞