Network: mainnet. snarkOS v4.13.1 promotes testnet-v4.13.1 and uses the published snarkVM =4.13.1 crates. The application changes are those accepted in testnet-v4.13.0. This patch aligns the release versions and includes the snarkVM CUDA packaging correction. All changes below apply to every network.
Who needs to act
There is no activation height. This release has no consensus change, and V22 stays the latest consensus version. Mainnet validators and node operators may upgrade at their convenience. Nodes on v4.12.x and v4.13.x can run on the same network.
Validators, read Upgrade safety below.
Changes since v4.12.1
Validators
- Upgrade safety (#4534). Validators exchange their consensus version schedules in the gateway handshake.
- If validators holding at least one-third of committee stake require a newer consensus version at a given height, an outdated node stops 100 blocks before that height. It does not continue building blocks under the older schedule.
- When this happens, the validator writes a
required-consensus-upgradefile to its data directory and exits with status 1. - New metrics:
snarkos_consensus_needs_upgradesnarkos_consensus_required_upgrade_heightsnarkos_consensus_required_upgrade_version
- This release does not introduce a new consensus version or activation height.
- Genesis binding (#4618). The gateway handshake carries the genesis block hash. A validator disconnects a v4.13.x peer that runs on a different genesis block.
- Handshake compatibility (#4534, #4618). The gateway event version moves from 10 to 12. Validators still accept peers at version 10 or later, so v4.12.x and v4.13.x validators connect in both directions.
- Proposal spacing (#4551). Certification time now counts toward the minimum gap between proposals, so rounds can be slightly shorter.
- Worker refill (#4552). Workers refill their memory pools after a local proposal.
Clients and sync
- Block requests (#4588). Block sync re-issues the requests that a responsive peer skipped.
- Prover solutions (#4584). Clients drop solutions from provers that are at their solution limit. They no longer relay them.
- CDN compression (#4608). The CDN sync asks for zstd-compressed block files. It still reads uncompressed files.
REST API
- v1 deprecation (#4650). The v1 REST API and the unversioned routes are deprecated.
- They still work. Their responses now carry
DeprecationandLinkheaders. - The legacy
/peers/count,/peers/all,/peers/all/metrics, and/sync_statusaliases also return deprecation headers, including under/v2. - To move to
/v2, see the REST v2 migration guide.
- They still work. Their responses now carry
- Compact JSON (#4548). Responses are compact JSON, not pretty-printed.
- Gzip (#4537). A response is gzip-compressed when the client sends
Accept-Encoding: gzip.
CLI
snarkos developerand/v2(#4650). Thesnarkos developercommands now use/v2.- An
--endpointwithout a version gets/v2/appended. - An endpoint with a query string is rejected.
- An
Tools
- Ledger distribution (#4597, #4600). The
fastsynctool moves into snarkOS assnarkos-ledger-distribution. It reads blocks from the node's ledger database. The bucket format does not change.
Metrics
- Per-call-site counts (#4582). Transaction verification, memory pool admission and gossip are now counted per call site.
- Counters (#4582).
snarkos_consensus_unconfirmed_transactions_totalandsnarkos_consensus_unconfirmed_solutions_totalchange from gauges to counters.
snarkVM
- snarkVM 4.13.1. This preserves the accepted v4.13.0 application code and fixes the crate packaging. See its release notes.
- Proving and execution checks are stricter on the prover side.
- Includes field arithmetic, circuit synthesis, and ledger optimizations.
- The CUDA crate includes its build script and kernel sources, which were missing from the published 4.13.0 crate.
- Published dependency. snarkOS uses the exact snarkVM
=4.13.1crates.io version from the accepted release candidate.
Dependencies
- Build tooling:
libz-sys1.1.33 fixes RUSTSEC-2026-0544. tracing-subscriber0.3.23 (RUSTSEC-2025-0055, #4523)jsonwebtoken11.1 (#4544)axum-extra0.12 (#4548)sha20.11 (#4613)- One duplicate crate is trimmed (#4598).
Developers
- Fuzz helpers (#4641). The proptest generators are available behind a
fuzz-helpersfeature. - Example (#4625). The
simple_nodeexample runs again. - CI. CI gains:
- stress, load and sync tests on the Gauntlet host.
- release devnet scripts.
- telemetry tests.
- a twice-weekly snarkVM bump.
- a twice-daily merge of the release branches into
staging.
Full changelog: v4.12.1...v4.13.1