NFI Backtest Engine v1.5.0
v1.5.0 is the Native Stateful Runtime release. It completes the transition of
supported NFI stateful callbacks from handwritten X7 execution paths to
source-compiled generic programs executed by Rust.
Native Stateful Runtime
- Generic state-machine programs preserve source order, typed custom trade state,
bounded helper calls, filled-order iteration, wallet reads, adjustments, partial
exits, and terminal exits. - Managed long and short exits, rebuy, regular adjustment, Derisk/Buyback, and Grind
use source-derived programs as their sole current Native execution path. - Signal numbers, tags, Grind levels, thresholds, state keys, and stake ladders are
IR data. They are not release-specific Rust branches. - Current-runtime X7 shadow backends and method-hash behavior gates are removed.
Backward schema readers remain available for sealed historical evidence.
Upstream compatibility automation
The four-hour watcher binds the NFI revision, engine commit, pinned Freqtrade image,
and semantic-profile fingerprint. Spot and Futures are checked independently, and an
atomic canary validates both mode results and their automation decisions before the
ledger advances.
Only a changed-branch proof with exact trade surface and full state may enable Native.
Missing coverage enters bounded discovery. A structurally new opcode or lowering
opens an evidence-only Draft review while the user-visible official Freqtrade path
remains available when the pinned environment supports the behavior. Draft reviews
and exact-fixture candidates are never approved or merged automatically.
Release boundary
This is a product release with combined_full_x7_certified=false. It includes
same-candidate Windows, Linux, and macOS exact-fixture evidence for the supported
Native Stateful Runtime, but does not relabel prior five-year results. The five-year
Spot certificate remains bound to v1.0.0 and the Futures certificate to v1.1.0.
It also does not claim that every future NFI or Freqtrade behavior is already Native.
Unknown semantics fail closed and remain official-only until a generic implementation
and independent exact evidence are reviewed.
Upgrade
After v1.5.0 is published, run the normal installer again. It selects the matching
wheel, verifies its published SHA-256 digest, and replaces the isolated nfi-bte
installation.