An AI-powered multi-agent pipeline for investigating on-chain attack transactions. Produces comprehensive incident reports with root-cause analysis, self-correcting Analyst-Validator debate, and optional Foundry PoC exploits.

## Pipeline

1. **Parse input**— tx_hash, chain, hints
2. **Setup**— analysis directory + incident brief
3. **Planner**— analysis plan, call trace
4. **Data Collector**— manifest, contract sources
5. **Manifest Check**— auto-corrects manifest
6. **Debate Loop**— Analyst writes report; Validator challenges; repeat up to 2x
7. **Report**— final incident report with code snippets, attack flow, loss analysis
8. **PoC [optional]**— Foundry exploit test

## What Makes It Different

– **Code Snippets**— Every report includes the vulnerable Solidity code with root cause annotation
– **On-chain Artifacts**— TX traces, decoded calldata, verified contract sources, funds flow analysis
– **Analyst-Validator Debate**— Multi-agent pipeline with adversarial review ensures factual accuracy

## Supported Chains

AliasChainChain IDEthereum1BNB Chain56Arbitrum One42161Polygon137Optimism10Avalanche43114Base8453

## Install

“`
Install skill https://github.com/DarkNavySecurity/web3-skills/
“`

## Usage

“`
# Analyze a transaction /exploit-investigator 0x eth # With extra hints /exploit-investigator 0x eth “suspected price manipulation” # Generate Foundry PoC /exploit-investigator poc 0x
“`