Skip to content

feat: port 5 vulnerability detection heuristics from am-i.exposed #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
satsfy wants to merge 3 commits into
base: main
Choose a base branch
from
Open

feat: port 5 vulnerability detection heuristics from am-i.exposed #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8984499
feat(model): create types for new vulnerability categories
satsfy Apr 6, 2026
cb4e08b
feat(engine): implement new privacy vulnerability categories
satsfy Apr 6, 2026
8b3d50c
add(docs): add new vulnerabilities in docs
satsfy Apr 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,13 +111,19 @@ Stealth currently runs **12 detectors** in `stealth-engine`.
| 10 | `EXCHANGE_ORIGIN` | MEDIUM | Signals typical of exchange batch withdrawals |
| 11 | `TAINTED_UTXO_MERGE` | HIGH | Tainted and clean inputs merged |
| 12 | `BEHAVIORAL_FINGERPRINT` | MEDIUM | Repeating transaction patterns |
| 13 | `DUST_ATTACK` | CRITICAL | Coordinated dust-pattern behavior |
| 14 | `PEEL_CHAIN` | HIGH - CRITICAL | Repeated peeling flow across hops |
| 15 | `DETERMINISTIC_LINK` | HIGH | Deterministic input-output mapping |
| 16 | `UNNECESSARY_INPUT` | MEDIUM | Extra inputs increasing CIOH exposure |
| 17 | `TOXIC_CHANGE` | HIGH | Toxic change consolidation patterns |

### Warning types

| Type | Typical severity | Meaning |
| --------------- | ---------------- | ----------------------------------------------- |
| `DORMANT_UTXOS` | LOW | Dormant/hoarded UTXO behavior |
| `DIRECT_TAINT` | HIGH | Funds directly received from known risky source |
| `DETERMINISTIC_LINK` | LOW | Appears as a low-risk ambiguity signal in some transactions |

## How to use the frontend

Expand Down
5 changes: 5 additions & 0 deletions engine/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,11 @@ Primary public scanning API: `TxGraph::detect_all(...)`.
| 10 | Exchange-origin batch withdrawal | MEDIUM |
| 11 | Tainted UTXO merge | HIGH |
| 12 | Behavioural fingerprinting | MEDIUM |
| 13 | Dust attack | CRITICAL |
| 14 | Peel chain | HIGH – CRITICAL |
| 15 | Deterministic input-output link | HIGH |
| 16 | Unnecessary input | MEDIUM |
| 17 | Toxic change | HIGH |

## Prerequisites

Expand Down
Loading
Loading