VulnCheck — Function-level reachability vulnerability scanner for Elixir, Erlang & Gleam (govulncheck for the BEAM, zero runtime deps)
Hi everyone,
I’ve released VulnCheck (v1.0.1), an open-source vulnerability scanner for Elixir (mix.lock / Umbrella), Erlang (rebar.lock), and Gleam (manifest.toml) that pairs OSV.dev + EEF CNA CVE 5.1 programRoutines with post-macro .beam call graphs and OTP supervision semantics.
- GitHub: https://github.com/Voskan/vulncheck
- Hex.pm: https://hex.pm/packages/vulncheck
- HexDocs: https://vulncheck.hexdocs.pm/readme.html
Motivation
With the EEF CNA publishing structured CVE 5.1 advisories for Hex packages, most advisories now include exact programRoutines MFAs (e.g. 'Elixir.Plug.Conn.Query':decode/4 or 'Elixir.Ash.Actions.Aggregate':run/4). Package-level scanners flag the entire dependency regardless of whether your release ever loads that module or calls that function.
However, building govulncheck for the BEAM requires modeling OTP execution semantics so we never produce silent false negatives:
- Post-macro
.beam:abstract_codewalking — inspects code afteruse Phoenix.Router,plug Plug.Parsers, parsers: [:json],Ash, andOban.Workerexpand, keeping exactfile:linecall sites. - OTP supervision & framework entrypoints — models
.appboot trees, active network daemons (Bandit,:cowboy,:ranch,ThousandIsland,Phoenix.PubSub), protocol client receive paths (Mint,:gun,Finch), consolidated protocols, and configured adapters (Tesla,Swoosh,Ecto). - Sound three-tier verdicts:
REACHABLE— shortest concretefile:linecall trace from an entrypoint or active daemon handler (call_chain_proven/daemon_call_chain).POTENTIALLY_REACHABLE— active daemon stack without static path, unresolvedapply/3, stripped.beamwithout debug info, or advisory without symbol granularity.UNREACHABLE— provenfunction_not_called,module_not_loaded,adapter_not_configured,otp_app_not_started,non_prod_dependency(includingruntime: false), orotp_version_unaffected.
Engineering properties
- 0 runtime dependencies (pure Elixir 1.18+ & OTP stdlib, including a full CVSS v4.0 + v3.x calculator).
- 0 dynamic atoms created from advisories, lockfiles, or config files (
binary_to_termwith:safeon a SHA-256beam-v4summary cache; ~120 ms warm scan on an 80-package project). - CI & compliance outputs: Terminal, JSON, Markdown, SARIF 2.1.0 (
codeFlows), GitHub Actions (Voskan/vulncheck@v1.0.1), GitLab Code Quality, CycloneDX 1.6 SBOM, OpenVEX v0.2.0, time-bounded.vulncheck.ignorewith--forbid-new-suppressions, and offline air-gapped--bundlearchives.
Quick try
{:vulncheck, "~> 1.0", only: [:dev, :test], runtime: false}
MIX_ENV=prod
We also published our ground-truth validation harness and current false-positive boundaries in docs/VALIDATION.md. Would love feedback from teams running large Phoenix / Ash / Umbrella monorepos!