Skip to main content
Version: v1

Compact.js 2.5.0 release notes

For the complete documentation index, see llms.txt
  • Version: 2.5.0
  • Date: 2026-03-20
  • Environment: Preprod, Preview, Mainnet

High-level summary​

Compact.js provides a TypeScript-based execution environment for smart contracts compiled with the Compact language.

This release keeps the same core architecture as previous versions and introduces targeted improvements in command behavior and runtime compatibility.

Audience​

This release is relevant for developers who build tools or frameworks that deploy and interact with contracts on the Midnight blockchain.

New features​

This release introduces no new features.

Improvements​

The circuit command in @midnight-ntwrk/compact-js-command now accepts an optional --input-ledger-params flag.

This flag accepts a file path to a binary-serialized LedgerParameters value. When omitted, Compact.js defaults to initial ledger parameters provided by the network.

Deprecations​

No deprecations in this release.

Breaking changes​

This version of Compact.js is built against @midnight-ntwrk/compact-runtime 0.15.0, which requires Compact Toolchain v0.30.0.

Required action: Recompile contracts against these dependency versions.

Important notes​

This release is primarily a compatibility and tooling update. If your build or deployment workflows pin older compact-runtime or compact-compiler versions, plan a coordinated upgrade to avoid runtime mismatches.