EVM Hack Registry

一个自包含、可离线运行的存档，包含数百个DeFi/EVM漏洞利用概念证明，涵盖2017年至2026年多个区块链。每个漏洞利用都是一个独立的Foundry项目，包含实际链上合约源代码、捕获的anvil区块状态快照以及AI分析的报告和堆栈跟踪，用于解释漏洞。所有内容可通过git克隆进行端到端复现。该注册表是生态系统中结构化黑客数据的来源。A self-contained, offline-runnable archive containing hundreds of proof-of-concept (PoC) exploits for DeFi/EVM vulnerabilities, covering multiple blockchains spanning from 2017 to 2026. Each exploit is a standalone Foundry project that includes actual on-chain contract source code, captured anvil blockchain state snapshots, as well as AI-analyzed reports and stack traces that explain the underlying vulnerabilities. All contents are fully reproducible end-to-end via git cloning. This registry serves as a structured source of hacking-related data within the blockchain ecosystem.

原始信息汇总

数据集概述

EVM Hack Registry 是一个自包含、可离线运行的 DeFi / EVM 漏洞利用概念验证（PoC）归档库，覆盖 2017 年至 2026 年期间发生在多条链上的数百个安全事件。

核心特性

• 独立 PoC 项目：每个漏洞利用案例都是一个独立的 Foundry 项目（文件夹命名格式为 YYYY-MM-Name_exp/），拥有自己的 foundry.toml、test/ 和 src/ 目录，消除了 Solidity 版本冲突。
• 包含真实合约源码：从 Etherscan 下载的实际受攻击合约源码保存在 sources/ 目录下，可读性强，便于调试。
• 离线可运行：每个 PoC 附带 anvil_state.json 快照文件，运行时不依赖任何网络、RPC 密钥或归档节点。
• AI 分析报告：每个 PoC 包含一份 AI 生成的 <Name>_exp.md 分析报告，说明漏洞原因、攻击流程和涉及的关键合约。
• 内置运行脚本：提供 run_poc.sh 和 run_all.sh 脚本，可并行执行所有 PoC，并支持 Docker 容器化运行（docker run --rm --network none）。

数据集构成

每个漏洞利用案例文件夹包含以下核心文件：

文件/目录	说明
src/、test/、sources/	漏洞利用测试代码 + 从 Etherscan 获取的受害者合约源码
anvil_state.json	链上区块状态快照（anvil 格式），用于离线运行
output.txt	参考的 forge test 输出
<Name>_exp.md	AI 分析的漏洞利用报告（根因、攻击流程、相关合约）

数据规模与状态

• PoC 文件夹数量：约 845 个
• 包含 anvil_state.json：约 845 个
• output.txt 状态为 Suite result: ok：约 811 个
• output.txt 状态为 Suite result: FAILED：约 24 个（已记录）
• 所有 PoC 的 foundry.toml 中均 不包含 [rpc_endpoints]，无外部运行时依赖。

漏洞分类体系

使用 AuditVault 智能合约安全分类法进行标签化标记，类别层级为 vuln/。每个 PoC 可标记多个类别（平均约 2.3 个类别），标签写在每个 <Name>_exp.md 报告的标题下。

主要分类概览（按标签数量排序）：

分类	标签数量
vuln/logic/…	538
vuln/access-control/…	425
vuln/oracle/…	327
vuln/defi/…	166
vuln/arithmetic/…	112
vuln/dependency/…	90
vuln/governance/…	65
vuln/reentrancy/…	63
其余分类（auth、bridge、input-validation、data、dos、business-logic）	共约 48

热门具体漏洞类（标签数量前 20）：

具体类（AuditVault slug）	标签数量
vuln/access-control/missing-auth	254
vuln/oracle/price-manipulation	176
vuln/defi/slippage	120
vuln/oracle/spot-price	113
vuln/logic/state-update	94
vuln/logic/incorrect-state-transition	87
vuln/dependency/unsafe-external-call	74
vuln/logic/missing-check	71
vuln/logic/incorrect-order-of-operations	71
vuln/logic/missing-validation	68
vuln/logic/reward-calculation	63
vuln/governance/flash-loan-attack	57
vuln/access-control/missing-modifier	45
vuln/logic/price-calculation	39
vuln/arithmetic/rounding	35
vuln/reentrancy/single-function	33
vuln/arithmetic/precision-loss	32
vuln/access-control/broken-logic	30
vuln/access-control/missing-validation	23
vuln/defi/sandwich-attack	20

生态系统

该注册库是下游工具的数据源：

• evm-hack-poc：可分享的 PoC ZIP 归档包
• evm-hack-analyzer：浏览器内的调试器，可加载并标注 PoC
• crypto.training/hacks：该数据集的公开可浏览镜像

运行方式

• 单个 PoC 离线运行：_shared/run-poc/run_poc.sh 2021-08-PolyNetwork_exp -vvvvv
• 并行运行所有 PoC：_shared/run-poc/run_all.sh
• Docker 离线运行：docker run --rm --network none evm-hack-registry
• 输出对比：_shared/run-poc/compare_output.sh _shared/results/<timestamp>

注意：该注册库衍生自 SunWeb3Sec/DeFiHackLabs，解决了原始项目中依赖归档节点、Solidity 版本冲突、缺少合约源码、无法离线复现等问题。

许可与声明

• 许可协议：同原始 PoC 项目及 DeFiHackLabs 许可。
• 声明：本数据集仅用于教育和防御性安全研究，禁止用于攻击真实系统或窃取资金。

搜集汇总

数据集介绍

构建方式

在去中心化金融安全研究中，对历史攻击事件的系统性复盘是防范未来威胁的重要基石。EVM Hack Registry数据集正是为应对这一需求而生，它通过对DeFiHackLabs社区中分散的POC资源进行深度重构与标准化封装而成。每个攻击案例均被迁移至独立的Foundry项目文件夹中，并配备了从Etherscan获取的完整受害者合约源代码、一个捕获了精准区块状态的anvil快照文件，以及一份由AI分析生成的漏洞研究报告与堆栈追踪记录。所有实验均可不依赖任何外部网络连接或RPC节点，仅通过git clone即可实现端到端的离线复现。

特点

该数据集最为显著的特性在于其高度自洽的离线复现能力，它将原本依赖易失效的归档节点的攻击POC，转变为每个案例都拥有独立的Solidity编译器配置、兼容的合约版本以及固化于anvil状态快照中的链上数据。这种设计彻底杜绝了因版本冲突或节点不可用导致的运行失败风险。数据集涵盖了横跨2017年至2026年、分布于数十条公链上的超过845个DeFi攻击事件，每个案例均标注了基于AuditVault分类法的漏洞标签，平均每个案例拥有约2.3个标签，形成了迄今为止最为全面的智能合约漏洞类型图谱。

使用方法

使用该数据集的方法极为简便，用户只需通过标准的git clone命令克隆仓库后，即可利用配套的run_poc.sh脚本对单个攻击案例进行深度分析，支持指定详细的堆栈追踪等级。对于大规模系统性研究，run_all.sh脚本支持并行运行所有案例，实现高效的批量复现与结果比对。此外，数据集还提供了与evm-hack-analyzer浏览器端调试工具的无缝对接接口，研究者可通过构建的ZIP档案在可视化界面中交互式探查攻击流程。项目同样提供了Docker镜像，确保在隔离环境下完全离线的运行体验。

背景与挑战

背景概述

EVM Hack Registry 是一个聚焦于去中心化金融（DeFi）与以太坊虚拟机（EVM）生态安全漏洞的可复现研究数据集，由安全研究员 sanbir 主导创建，并基于 SunWeb3Sec/DeFiHackLabs 社区成果衍生而来。该数据集覆盖了从2017年至2026年间横跨多链的数百次安全事件，通过将每个漏洞利用（PoC）独立封装为包含真实合约源码、链上状态快照及AI分析报告的自包含 Foundry 项目，彻底解决了传统漏洞复现中依赖归档节点、编译环境冲突和缺乏离线运行能力等关键痛点。其数据被进一步用于构建共享存档（evm-hack-poc）、浏览器内调试器（evm-hack-analyzer）等工具，为智能合约安全研究、教育和防御性安全审计提供了结构化、可复现的实证基础，对推动区块链安全社区的系统性漏洞分析具有显著影响力。

当前挑战

该数据集所解决的领域核心挑战在于：DeFi 安全事件频发，但传统漏洞复现流程高度依赖归档节点和实时RPC接口，公共节点状态裁剪和速率限制导致大多数历史攻击无法离线重现；同时，原始PoC跨多个Solidity版本、缺乏源码且无缓存状态，研究者难以深入分析漏洞根因。构建过程中面临的挑战包括：从分散的跨链历史区块中捕获并固化约845个攻击的链上状态，需协调不同链、区块高度与版本兼容性；从Etherscan批量下载并整理受攻击合约的扁平化源码，确保可读性；以及为每个PoC统一生成AI解析的漏洞分类标签（涵盖70余种类型，实例超过1851个），构建系统化的安全知识图谱。

常用场景

经典使用场景

EVM Hack Registry作为一个高度结构化的去中心化金融（DeFi）安全漏洞研究数据集，其最经典的用途在于为智能合约安全研究人员与白帽黑客提供一个可完全离线复现的、跨越2017至2026年多个区块链网络（如以太坊、BSC、Arbitrum等）的历史攻击事件武器库。该数据集将超过840个攻击概念验证（PoC）封装为独立的Foundry项目，每一个都集成了从Etherscan拉取的受害人合约源码、基于anvil的状态快照以及人工智能分析的漏洞栈追踪说明，使研究者无需持有任何归档节点RPC密钥或网络连接，即可通过git clone后在本地环境端到端地重放、调试与分析诸如逻辑错误、价格预言机操控、重入攻击和闪电贷治理攻击等各类经典漏洞类型。这种离线自包含的特性极大地降低了DeFi安全分析的门槛，使得从初学者到资深专家都能在统一、稳定且可复现的实验沙箱中深入理解每次攻击的完整技术细节。

解决学术问题

该数据集系统性地解决了智能合约安全学术研究中长期存在的两大核心难题：一是历史攻击事件的可复现性困境——此前像DeFiHackLabs等资料虽然汇总了大量PoC，但因依赖实时归档节点RPC、多链多区块分叉协调繁琐以及Solidity版本冲突等问题，导致绝大多数案例无法在离线或标准环境下成功运行，严重阻碍了安全模式的可验证分析与教学传播；二是漏洞分类与知识抽取的标准化缺失——EVM Hack Registry通过引入AuditVault安全分类体系，为每个PoC标注了多达70种精细化的漏洞类别标签（如逻辑状态更新错误、访问控制缺失、算术精度损失等），使得学术研究者能够基于超过1851个标签实例进行大规模、系统化的漏洞模式聚类与统计学分析。该数据集因此成为了从经验性案例收集转向可重复计算性安全研究的桥梁性基础设施，显著推动了DeFi安全领域的理论建模与实证分析的科学化进程。

衍生相关工作

该数据集衍生了一系列在社区中产生广泛影响的经典研究工具与知识产品。其中，evm-hack-analyzer作为一款浏览器端交互式调试器，能够直接加载该数据集生成的ZIP归档，让用户在图形界面中逐行执行攻击交易并实时观察堆栈变化，极大地增强了PoC的教学交互性与分析透明度。evm-hack-poc项目则将数据集中的每个PoC打包成可分发、可共享的ZIP文件，通过crypto.training/hacks公开镜像站点提供在线浏览，形成了从结构化数据库到轻量级教学资源的完整分发链路。在学术引用方面，许多DeFi安全论文在讨论预测机操纵、闪电贷攻击或跨链桥漏洞时，均将该数据集的标签体系与复现方法作为实验基准，例如部分研究基于其标记的逻辑类漏洞（538个实例）训练了针对智能合约关键路径的异常检测模型。此外，该数据集作为SunWeb3Sec/DeFiHackLabs的衍生物，其设计的离线状态快照与Independ编译策略已被后续多个安全研究平台借鉴，成为构建可复现安全实验环境的推荐范本。