All notable public changes for EllipticZero are summarized here.
The project follows a source-available release track under FSL-1.1-ALv2.
Package version: 0.1.9.
- Added case-level recall, miss-rate, precision, specificity, and targeted false-positive metrics to the pinned SmartBugs validator.
- Added a reproducible reentrancy case study with a local hardened fixture, Markdown export, full-session commands, and before/after verification.
- Added public feedback routing with free-form Issues, a feedback template, stronger Pull Request checks, and direct private vulnerability reporting.
- Added compact verified-evidence sections to both README files.
- Narrowed admin-surface detection so ordinary withdrawal, burn, and preference functions are not mislabeled as administrative paths.
- Fixed calibration blockers so a baseline comparison with no regressions no longer reports a regression-like blocker.
- Added a deterministic benchmark scorecard with anomaly-bearing smart-contract fixtures, ECC golden cases, and a clean control contract.
- Added a cross-platform production release gate for tests, benchmark regression, package metadata, and installed-wheel smoke checks.
- Added explicit agent tool-request review against the approved local registry.
- Added a pinned SmartBugs Curated subset validator with five annotated vulnerability-family cases and one clean control.
- Added repository, copyright, and SPDX license headers to production source files, enforced by the release gate.
- Extended repo-scale Solidity compilation with bounded multi-file source maps and project-aware Slither execution.
- Hardened Foundry and Echidna execution with isolated outputs, sanitized environments, deterministic Echidna settings, and safety-gated Forge tests.
- Bounded hosted-provider transport payloads and responses, improved fallback budget handling, and made report-agent evidence sharing visible in the provider context preview.
- Expanded CI across Linux, Windows, macOS, Python 3.11, and Python 3.14.
- Separated managed Solidity compiler caches by operating system so Windows, WSL/Linux, and macOS binaries cannot shadow one another.
- Fixed live Foundry JSON inspection, Echidna property-name recovery, virtualenv
console-script discovery, and legacy
.call.value(...)/.send(...)review paths found during real WSL toolchain validation.
- Added normalized smart-contract findings for built-in pattern checks:
each candidate keeps severity, confidence, local evidence, line hints, fix
direction, and recheck path in
result_data. - Added signature deadline / expiry review signals for permit-like signature
paths that use
ecrecoverwithout an expiry boundary. - Added Chainlink-style oracle round-completeness review signals for
latestRoundData/getRoundDatapaths that do not preserve anansweredInRound >= roundIdstyle check.
- Tightened smart-contract wording from broad "bounded audit" phrasing toward scoped security review and normalized review signals.
- Added interactive smart-contract folder input: the console can accept a local contract directory, select a representative Solidity/Vyper file, and preserve the scoped contract root for repo-scale review.
- Added
contract-reentrancy-review-lane, a safe synthetic golden case for external-call ordering, withdrawal accounting, and reentrancy-adjacent review lanes. - Added line hints for built-in smart-contract pattern findings, finding cards, manual-review items, and SARIF exported results.
- Shifted public positioning toward smart-contract audit first, with defensive ECC research as the second supported domain.
- Tightened README and evaluation docs to reduce repeated capability lists and keep reviewer-facing descriptions shorter.
- Added a lightweight known-case threat-intel layer: allowlisted SmartBugs metadata and Slither detector-family profiles can be cached locally, matched against smart-contract review signals, and shown in reports without executing remote code.
- Added
KNOWN CASESto the interactive evaluation lab for updating profiles, inspecting the local cache, and reviewing allowed metadata sources. - Added deeper scoped smart-contract review signals for signature domain separation, Chainlink-style oracle answer bounds, and immediate upgrade paths that lack an explicit delay, queue, or governance control.
- Added token balance-delta and oracle decimal-scaling review signals for fee-on-transfer style accounting and price-precision checks.
- Added matching built-in corpus cases for token balance-delta and oracle decimal-scaling review so the new families are covered by local benchmark sweeps.
- Added richer Slither/Foundry evidence ingestion: Slither findings keep
normalized severity and source-location summaries, while Foundry projects can
contribute local
forge testresults whenfoundry.tomlis present.
- Moved
EVALUATION LABto the main interactive menu and renamed the former advanced area toSYSTEM / TOOLSto reduce nested navigation.
- Added saved-run Markdown report export through
--export-report-md. - Added a compact review snapshot near the top of console and Markdown reports.
- Added clearer mock-mode onboarding: localized validation errors, semantic-light seed validation, compact seed examples, and boxed console summaries.
- Added a post-run session-actions menu for one-step
report.mdandreview.sarifexport. - Added an interactive
EVALUATION LABmenu for golden cases, experiment packs, project or saved-run summaries, baseline comparison, and provider context preview. - Added
report.mdto reproducibility bundles when a session report is available. JSON evidence artifacts remain the source of truth.
- Final CLI reports include the exact saved-run evaluation command whenever a reproducibility bundle is produced.
- Added SARIF 2.1.0 saved-run review output for CI and GitHub Code Scanning workflows.
- SARIF results include stable partial fingerprints, tags, and EllipticZero severity metadata for cleaner CI triage.
- Added a provider context preview CLI path so hosted-provider runs can be reviewed for possible context exposure before any live model call.
- Expanded the existing evaluation and security guides with provider privacy, sandbox limits, artifact boundaries, golden cases, and SARIF review checks.
report_snapshot_summaryandreport_snapshot_countin manifests and bundle overviews so compact smart-contract / ECC triage and remediation-delta signals are visible without opening the full session JSON.--evaluation-summary --replay-session/--replay-manifest/--replay-bundlemode for compact reviewer summaries of saved runs without re-execution.- Saved-run evaluation summaries include a
review_statusblock with evidence depth, comparison readiness, missing artifacts, and manual-review posture.
- Machine-readable
--evaluation-summary --evaluation-summary-format jsonoutput for evaluator and integration workflows. - Smart-contract finding cards that connect bounded potential issues to evidence, risk context, defensive fix direction, and a recheck path.
- Evidence-coverage summaries, toolchain fingerprints, and secret-redaction summaries in reports, manifests, bundle overviews, and export notes.
- Secret redaction for saved session JSON, trace JSONL, comparative-report, and bundle JSON snapshots before export.
- Buyer-demo guidance for the no-key vault/permission golden case.
- More compact smart-contract finding-card text for first-screen review.
- Compact
--evaluation-summaryCLI path for no-key evaluator orientation. - Evaluator-facing case-study snapshots for vault-permission review, repo-scale lending-protocol triage, and ECC point-format review.
Initial public FSL release track.
- Local-first bounded research workflow for smart-contract audit and ECC research.
- Orchestrated agent roles: Orchestrator, Math, Cryptography, Strategy, Hypothesis, Critic, and Report.
- Reproducible session artifacts, traces, manifests, bundles, replay, and doctor/self-check paths.
- Smart-contract repo-scale audit layer with parser, compile, inventory, first-party/dependency scoping, protocol maps, entrypoint lanes, function-family priorities, casebook matching, benchmark packs, and before/after comparison support.
- ECC benchmark depth for point formats, curve metadata, aliases, curve-family transitions, subgroup/cofactor hygiene, twist hygiene, and bounded domain-completeness checks.
- Golden/synthetic evaluator cases for stable smart-contract and ECC smoke checks.
- Provider configuration for
mock,openai,openrouter,gemini, andanthropic, with live smoke checks available when a user supplies their own keys. - Buyer-facing documentation for licensing, commercial use, environment profiles, use cases, sample outputs, and evaluation.
- GitHub issue templates, pull-request template, tests workflow, CodeQL workflow, Dependabot configuration, and security policy.
- Bounded local plugin loading rules.
- Export-root filtering for reproducibility manifests and bundles.
- Report language that keeps local evidence, model interpretation, confidence, residual risk, and manual-review boundaries separate.
- Responsible-use and private vulnerability-reporting documentation.
- Public source-available licensing under
FSL-1.1-ALv2. - Apache License 2.0 future-license transition for each published version on the second anniversary of that version becoming available.
- Separate commercial-license guidance for competing commercial use, hosted or managed service use, SaaS/platform deployment, OEM, white-label, resale, and similar product scenarios.