Skip to content

Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇

feat(lisdex): B63 - the six gates that graded a binary nothing proved matched its source

CarterPerez-dev0248d22652d3
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh
index e2772840..32ff3589 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/build-magma-libpng.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
MAGMA_SRC="${MAGMA_ROOT:-/opt/magma}"
MAGMA="$MAGMA_SRC/magma"
WORK="${MAGMA_WORK:-/opt/magma-work}"
@@ -19,7 +22,7 @@ else
OUT_ROOT="$WORK/out/libpng-nonfatal"
CANARY_MODE="FATAL canaries OFF - canaries LOG ONLY and execution continues into the real corruption"
fi
-HARNESS_SRC="${LISDEX_HARNESS:-/work/harnesses/libpng_read.c}"
+HARNESS_SRC="$LISDEX_HARNESS_SRC"
DRIVER="${LISDEX_AFL_DRIVER:-/usr/local/lib/afl/libAFLDriver.a}"
HARNESS_BIN="lisdex_libpng_read"
PATCH_STAMP="$TARGET/.lisdex-patched"
@@ -208,6 +211,9 @@ done
printf '\n'
if [ "$FAILURES" -eq 0 ]; then
+ # Written only here, so a build that failed verification never leaves a stamp claiming the
+ # binaries match the source. The gates read it back and refuse to grade a stale target.
+ lisdex_stamp_harness "$OUT_ROOT"
printf '[lisdex] MAGMA LIBPNG TARGET READY (canaries ON, fixes OFF, %s)\n' "$CANARY_MODE"
printf '[lisdex] fuzz target : %s\n' "$OUT_ROOT/afl/$HARNESS_BIN"
printf '[lisdex] cmplog : %s\n' "$OUT_ROOT/cmplog/$HARNESS_BIN"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh
index aeaa4372..35931c3f 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m1-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
OUT_ROOT="$WORK/out/libpng"
REPO="$WORK/libpng/repo"
@@ -28,6 +31,7 @@ die() {
[ -x "$OUT_ROOT/afl/$HARNESS_BIN" ] || die "target not built; run: just magma-libpng"
[ -x "$OUT_ROOT/cmplog/$HARNESS_BIN" ] || die "cmplog target not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
log "stage 1/5: build lisdex CLI"
cargo build -p lisdex
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh
index 5408ecf4..0dc74007 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m10-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
OUT_ROOT="$WORK/out/libpng"
SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"
@@ -46,6 +49,7 @@ if [ "${1:-}" = "reset" ]; then
fi
[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
[ -f "$DASH_MANIFEST" ] || die "run this from the project root; $DASH_MANIFEST not found"
mkdir -p "$GATE" "$EMPTY"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh
index 38f6285c..aa91c0ff 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m6-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
OUT_ROOT="$WORK/out/libpng"
SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"
@@ -36,6 +39,7 @@ if [ "${1:-}" = "reset" ]; then
fi
[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"
[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"
[ -d "$DICT_DIR" ] || die "AFL++ dictionaries missing at $DICT_DIR"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh
index 4f57cc98..8e22498d 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m7-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
REPO="$WORK/libpng/repo"
OUT_ROOT="$WORK/out/libpng"
@@ -41,6 +44,7 @@ fi
[ -d "$REPO" ] || die "magma libpng not fetched; run: just magma-libpng"
[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"
[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"
[ -d "$FIXTURES" ] || die "captured report fixtures missing at $FIXTURES"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh
index d91fd16f..9c0ab1dd 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m8-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
REPO="$WORK/libpng/repo"
OUT_ROOT="$WORK/out/libpng"
@@ -40,6 +43,7 @@ fi
[ -d "$REPO" ] || die "magma libpng not fetched; run: just magma-libpng"
[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"
[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"
[ -d "$FIXTURES" ] || die "captured report fixtures missing at $FIXTURES"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh
index 733260ed..ca675815 100755
--- a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/m9-gate.sh
@@ -4,6 +4,9 @@
set -euo pipefail
+# shellcheck source=scripts/magma-guard.sh
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/magma-guard.sh"
+
WORK="${MAGMA_WORK:-/opt/magma-work}"
OUT_ROOT="$WORK/out/libpng"
SEEDS="$WORK/libpng/corpus/libpng_read_fuzzer"
@@ -54,6 +57,7 @@ if [ "${1:-}" = "reset" ]; then
fi
[ -x "$TARGET" ] || die "magma libpng not built; run: just magma-libpng"
+require_harness_current "$OUT_ROOT"
[ -x "$CMPLOG" ] || die "cmplog target missing at $CMPLOG"
[ -d "$SEEDS" ] || die "seed corpus missing at $SEEDS"
[ -f "$TUI_MANIFEST" ] || die "run this from the project root; $TUI_MANIFEST not found"
diff --git a/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.sh b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.sh
new file mode 100644
index 00000000..0f328acb
--- /dev/null
+++ b/PROJECTS/advanced/zero-day-vulnerability-scanner/scripts/magma-guard.sh
@@ -0,0 +1,54 @@
+# ©AngelaMos | 2026
+# magma-guard.sh
+# shellcheck shell=bash
+
+# The hand-written magma harness is the one build input no stamp covered. `build-magma-libpng.sh`
+# already refuses to run against a drifted magma commit or a changed canary selection, but the
+# harness it compiles into the target was only ever existence-checked, so editing
+# `harnesses/libpng_read.c` and running a gate graded the previous binary and reported PASS.
+# Measured 2026-08-18: with LISDEX_MAX_PIXELS cut from 1<<24 to 1<<2, a change that rejects
+# essentially every seed before it reaches png_read_row, `just m1-gate` still printed
+# "M1 EXIT GATE PASSED" at exit 0 against a byte-identical binary.
+
+LISDEX_HARNESS_SRC="${LISDEX_HARNESS:-/work/harnesses/libpng_read.c}"
+LISDEX_HARNESS_STAMP_NAME=".lisdex-harness-sha"
+
+lisdex_harness_sha() {
+ sha256sum "$LISDEX_HARNESS_SRC" | cut -d' ' -f1
+}
+
+lisdex_stamp_harness() {
+ local out_root="$1"
+ lisdex_harness_sha > "$out_root/$LISDEX_HARNESS_STAMP_NAME"
+}
+
+# Sourced by every gate that runs the hand-written target, so the diagnosis is written once.
+# Exits rather than returning: a gate that graded the wrong binary has no result worth printing.
+require_harness_current() {
+ local out_root="$1"
+ local stamp="$out_root/$LISDEX_HARNESS_STAMP_NAME"
+ local want have
+
+ if [ ! -f "$LISDEX_HARNESS_SRC" ]; then
+ printf '\n[gate] FAIL: hand-written harness missing at %s\n' \
+ "$LISDEX_HARNESS_SRC" >&2
+ exit 1
+ fi
+
+ want="$(lisdex_harness_sha)"
+
+ if [ ! -f "$stamp" ]; then
+ printf '\n[gate] FAIL: %s was built before the harness was stamped, so nothing proves it
+ matches %s - run: just magma-libpng\n' "$out_root" "$LISDEX_HARNESS_SRC" >&2
+ exit 1
+ fi
+
+ have="$(cat "$stamp")"
+ if [ "$want" != "$have" ]; then
+ printf '\n[gate] FAIL: %s changed since the target was built, so this gate would grade
+ the previous binary - run: just magma-libpng
+ source now : %s
+ built from : %s\n' "$LISDEX_HARNESS_SRC" "$want" "$have" >&2
+ exit 1
+ fi
+}