chore(release): v3.0.0 rc.0 (#10000)

* add main changelog

* bump zebra-chain

* bump zebra-consensus

* bump zebra-network

* bump zebra-node-services

* bump zebra-rpc

* bump zebra-state

* bump zebra-test

* bump zebra-utils

* bump zebrad

* update end of support for release candidate

* changelog for #9973

* Apply suggestions from code review

Co-authored-by: Marek <mail@marek.onl>

---------

Co-authored-by: Marek <mail@marek.onl>

Author: oxarbitrage

CHANGELOG.md

@@ -5,42 +5,89 @@ All notable changes to Zebra are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org).
 
-## Unreleased
+## [Zebra 3.0.0-rc.0](https://github.com/ZcashFoundation/zebra/releases/tag/v3.0.0-rc.0) - 2025-10-15
+
+In this release, we add the **Mainnet activation height for Network Upgrade 6.1 (NU6.1)**, which will activate at block **3,146,400**.
+
+This is a **release candidate**. Its support is set to expire before the activation height. If no issues are found, this candidate will become the final release for NU6.1.
+
+This release also includes significant updates to Zebra's CI and Docker setup, as well as performance optimizations.
+
 
 ### Breaking Changes
 
-- Migrate `zebrad` to a layered configuration using config-rs. Environment variables must use the
-  `ZEBRA_SECTION__KEY` format (double underscore for nesting), for example:
-  `ZEBRA_NETWORK__NETWORK`, `ZEBRA_RPC__LISTEN_ADDR`, `ZEBRA_RPC__ENABLE_COOKIE_AUTH`,
-  `ZEBRA_RPC__COOKIE_DIR`, `ZEBRA_TRACING__FILTER`, `ZEBRA_STATE__CACHE_DIR`,
-  `ZEBRA_MINING__MINER_ADDRESS`. Legacy `ZEBRA_*` test/path variables and `ZEBRA_RUST_LOG` are no
-  longer honored. Update any scripts, Docker configs, or systemd units that relied on the old names
-  ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
-
-- Docker entrypoint simplified: it no longer generates a `zebrad.toml` or translates legacy Docker
-  environment variables. To use a file, set `CONFIG_FILE_PATH` (the entrypoint forwards it via
-  `--config`). Otherwise, configure via `ZEBRA_*` variables. `ZEBRA_CONF_PATH` has been removed in
-  favor of `CONFIG_FILE_PATH`. Docker setups that used variables like `ZEBRA_RPC_PORT`,
-  `ZEBRA_COOKIE_DIR`, `NETWORK`, `ENABLE_COOKIE_AUTH`, or `MINER_ADDRESS` must switch to the
-  config-rs equivalents shown above ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
-
-- Fully removed the `getblocktemplate-rpcs` feature flag from `zebrad/Cargo.toml`.
-  All functionality previously guarded by this flag has already been made the default.
-  As a result, the following build command is no longer supported:
+- Migrate `zebrad` to a layered configuration using config-rs. Environment variables must use the `ZEBRA_SECTION__KEY` format (double underscore for nesting), for example: `ZEBRA_NETWORK__NETWORK`, `ZEBRA_RPC__LISTEN_ADDR`, `ZEBRA_RPC__ENABLE_COOKIE_AUTH`, `ZEBRA_RPC__COOKIE_DIR` `ZEBRA_TRACING__FILTER` `ZEBRA_STATE__CACHE_DIR`, `ZEBRA_MINING__MINER_ADDRESS`. Legacy `ZEBRA_*` test/path variables and `ZEBRA_RUST_LOG` are no longer honored. Update any scripts, Docker configs, or systemd units that relied on the old names ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
+- Docker entrypoint simplified: it no longer generates a `zebrad.toml` or translates legacy Docker environment variables. To use a file, set `CONFIG_FILE_PATH` (the entrypoint forwards it via `--config`). Otherwise, configure via `ZEBRA_*` variables. `ZEBRA_CONF_PATH` has been removed in favor of `CONFIG_FILE_PATH`. Docker setups that used variables like `ZEBRA_RPC_PORT`, `ZEBRA_COOKIE_DIR`, `NETWORK`, `ENABLE_COOKIE_AUTH`, or `MINER_ADDRESS` must switch to the config-rs equivalents shown above ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
+- Fully removed the `getblocktemplate-rpcs` feature flag from `zebrad/Cargo.toml`. All functionality previously guarded by this flag has already been made the default. As a result, the following build command is no longer supported:
   ```
   cargo build --features getblocktemplate-rpcs
   ```
   ([#9964](https://github.com/ZcashFoundation/zebra/pull/9964))
-- Expects the block commitment bytes of Heartwood activation blocks to be the `hashBlockCommitments` after NU5 activation
 
 ### Changed
 
-- `zebrad` now loads configuration from defaults, an optional TOML file, and environment variables,
-  with precedence: Env > TOML > Defaults ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
-- Docker and book documentation updated to describe `CONFIG_FILE_PATH` and `ZEBRA_*` environment
-  variable usage; removed references to `ZEBRA_CONF_PATH` and legacy Docker variables
-  ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
-- Added deserialization logic to call `extend_funding_streams()` when the flag is true for both configured Testnets and Regtest
+- `zebrad` now loads configuration from defaults, an optional TOML file, and environment variables, with precedence: Env > TOML > Defaults ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
+- Docker and book documentation updated to describe `CONFIG_FILE_PATH` and `ZEBRA_*` environment variable usage; removed references to `ZEBRA_CONF_PATH` and legacy Docker variables ([#9768](https://github.com/ZcashFoundation/zebra/pull/9768)).
+- Implemented nextest and optimized Docker test builds ([#9435](https://github.com/ZcashFoundation/zebra/pull/9435))
+- Replaced light wallet .proto files with canonical versions obtained from https://github.com/zcash/lightwallet-protocol ([#9783](https://github.com/ZcashFoundation/zebra/pull/9783))
+- Allow `zebra-rpc` to be compiled without `protoc` ([#9819](https://github.com/ZcashFoundation/zebra/pull/9819))
+- Switched Sapling verifier ([#9737](https://github.com/ZcashFoundation/zebra/pull/9737))
+- Refactor Sapling parameters loading ([#9678](https://github.com/ZcashFoundation/zebra/pull/9678))
+- Adopt upstream types for sapling commitments where possible ([#9828](https://github.com/ZcashFoundation/zebra/pull/9828))
+- Updated transaction verifier to use `orchard::bundle::BatchValidator` ([#9308](https://github.com/ZcashFoundation/zebra/pull/9308))
+- Improved error propagations ([#9921](https://github.com/ZcashFoundation/zebra/pull/9921), [#9919](https://github.com/ZcashFoundation/zebra/pull/9919), [#9848](https://github.com/ZcashFoundation/zebra/pull/9848))
+- Broadcast block submissions to all peers in the peer set ([#9907](https://github.com/ZcashFoundation/zebra/pull/9907))
+- Removed outdated seeders ([#9932](https://github.com/ZcashFoundation/zebra/pull/9932))
+- Apply suggestions for code cleanup from NU6.1 audit. ([#9952](https://github.com/ZcashFoundation/zebra/pull/9952))
+- Always return `1.0` from `getblockchaininfo` as the verification progress on Regtest ([#9908](https://github.com/ZcashFoundation/zebra/pull/9908))
+- Corrected number of addresses for the FPF funding stream extension on Testnet ([#9786](https://github.com/ZcashFoundation/zebra/pull/9786))
+- Simplified a test to use regtest instead of fake activation heights ([#9792](https://github.com/ZcashFoundation/zebra/pull/9792))
+- Re-enable and update `disconnects_from_misbehaving_peers` test ([#9735](https://github.com/ZcashFoundation/zebra/pull/9735))
+- Improve connection times in regtest framework ([#9917](https://github.com/ZcashFoundation/zebra/pull/9917))
+- Always wait for RPC port to open in cached state tests ([#9903](https://github.com/ZcashFoundation/zebra/pull/9903))
+- Allow configuration of funding streams on Regtest ([#9710](https://github.com/ZcashFoundation/zebra/pull/9710))
+- Implemented draft ZIP 2003 for NU7 and use Testnet network protocol versions on Regtest ([#9787](https://github.com/ZcashFoundation/zebra/pull/9787))
+
+### Added
+
+- NU6.1 activation height, funding streams, lockbox disbursments, and current network protocol version ([#9987](https://github.com/ZcashFoundation/zebra/pull/9987))
+- Backup non-finalized blocks in state cache directory ([#9809](https://github.com/ZcashFoundation/zebra/pull/9809))
+- Complete `z_gettreestate` ([#9798](https://github.com/ZcashFoundation/zebra/pull/9798))
+- `getmempoolinfo` RPC method ([#9870](https://github.com/ZcashFoundation/zebra/pull/9870))
+- `getnetworkinfo` RPC method ([#9887](https://github.com/ZcashFoundation/zebra/pull/9887))
+- Support side chains in `getrawtransaction` ([#9884](https://github.com/ZcashFoundation/zebra/pull/9884))
+- Support single-string or object params in `getaddresstxids` ([#9854](https://github.com/ZcashFoundation/zebra/pull/9854))
+- Exposed `z_validateaddress` logic for library consumers ([#9859](https://github.com/ZcashFoundation/zebra/pull/9859))
+- Missing Orchard fields to `getrawtransaction` ([#9808](https://github.com/ZcashFoundation/zebra/pull/9808))
+- `vjoinsplit` field to `getrawtransaction` ([#9805](https://github.com/ZcashFoundation/zebra/pull/9805))
+- Use specific error code for `addnode`; reuse message in response filter ([#9931](https://github.com/ZcashFoundation/zebra/pull/9931))
+- Support for the `chainInfo` field in `getaddressutxos` RPC method ([#9875](https://github.com/ZcashFoundation/zebra/pull/9875))
+- Allow for cycling through configured funding stream addresses ([#9989](https://github.com/ZcashFoundation/zebra/pull/9989))
+- Introduce `BytesInDisplayOrder` trait to standardize byte-reversed encoding in RPC ([#9810](https://github.com/ZcashFoundation/zebra/pull/9810))
+- `MappedRequest` helper trait and refactors error types used by `CommitSemanticallyVerifiedBlock` requests ([#9923](https://github.com/ZcashFoundation/zebra/pull/9923))
+- Useful standard trait implementations to ease downstream use ([#9926](https://github.com/ZcashFoundation/zebra/pull/9926))
+- Added `ZFuture` variant to `NetworkUpgrade` ([#9814](https://github.com/ZcashFoundation/zebra/pull/9814))
+- Allow configuration of checkpoints on test networks ([#9888](https://github.com/ZcashFoundation/zebra/pull/9888))
+- Added HTTP `/healthy` and `/ready` endpoints ([#9895](https://github.com/ZcashFoundation/zebra/pull/9895), [#9886](https://github.com/ZcashFoundation/zebra/pull/9886))
+- New book page on profiling Zebra ([#9983](https://github.com/ZcashFoundation/zebra/pull/9983))
+- Deserialization logic to call `extend_funding_streams()` when the flag is true for both configured Testnets and Regtest ([#9989](https://github.com/ZcashFoundation/zebra/pull/9989))
+
+### Fixed
+
+- Restore initial sync performance by avoiding RocksDB merge operations when the on-disk database format is up-to-date ([#9973](https://github.com/ZcashFoundation/zebra/pull/9973))
+- Use `STANDARD` Base64 for RPC auth encoding/decoding ([#9968](https://github.com/ZcashFoundation/zebra/pull/9968))
+- Expects the block commitment bytes of Heartwood activation blocks to be the `hashBlockCommitments` after NU5 activation ([#9982](https://github.com/ZcashFoundation/zebra/pull/9982))
+- Fixed UTXO selection loop to iterate over entries instead of repeating first ([#9826](https://github.com/ZcashFoundation/zebra/pull/9826))
+- Improve extra argument passing to zebra in qa framework([#9858](https://github.com/ZcashFoundation/zebra/pull/9858))
+- Avoid heap allocations in `expand_zero_be_bytes()` ([#9951](https://github.com/ZcashFoundation/zebra/pull/9951))
+- Fixed `sanitize_avoids_leaks` test to validate sanitized MetaAddr ([#9867](https://github.com/ZcashFoundation/zebra/pull/9867))
+- Corrected `at_least_one!` count-form and add unit test ([#9871](https://github.com/ZcashFoundation/zebra/pull/9871))
+
+### Contributors
+
+Thank you to everyone who contributed to this release, we couldn't make Zebra without you:
+@Fibonacci747, @Galoretka, @GarmashAlex, @JacksonEi, @MozirDmitriy, @Olexandr88, @arya2, @conradoplg, @gap-editor, @gustavovalverde, @natalieesk, @nuttycom, @oxarbitrage, @radik878, @sashass1315, @str4d, @syszery, @upbqdn and @zancas
+
 
 ## [Zebra 2.5.0](https://github.com/ZcashFoundation/zebra/releases/tag/v2.5.0) - 2025-08-07
 

Cargo.lock

@@ -6747,7 +6747,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-chain"
-version = "2.0.0"
+version = "3.0.0"
 dependencies = [
  "bech32",
  "bitflags 2.9.4",
@@ -6814,7 +6814,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-consensus"
-version = "2.0.0"
+version = "3.0.0"
 dependencies = [
  "bellman",
  "blake2b_simd",
@@ -6861,7 +6861,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-network"
-version = "1.1.0"
+version = "2.0.0"
 dependencies = [
  "bitflags 2.9.4",
  "byteorder",
@@ -6902,7 +6902,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-node-services"
-version = "1.0.1"
+version = "2.0.0"
 dependencies = [
  "color-eyre",
  "jsonrpsee-types",
@@ -6915,7 +6915,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-rpc"
-version = "2.0.1"
+version = "3.0.0"
 dependencies = [
  "base64 0.22.1",
  "chrono",
@@ -6981,7 +6981,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-state"
-version = "2.0.0"
+version = "3.0.0"
 dependencies = [
  "bincode",
  "chrono",
@@ -7029,7 +7029,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-test"
-version = "1.0.1"
+version = "2.0.0"
 dependencies = [
  "color-eyre",
  "futures",
@@ -7056,7 +7056,7 @@ dependencies = [
 
 [[package]]
 name = "zebra-utils"
-version = "2.0.0"
+version = "3.0.0"
 dependencies = [
  "color-eyre",
  "hex",
@@ -7084,7 +7084,7 @@ dependencies = [
 
 [[package]]
 name = "zebrad"
-version = "2.5.0"
+version = "3.0.0-rc.0"
 dependencies = [
  "abscissa_core",
  "atty",

tower-batch-control/Cargo.toml

@@ -42,7 +42,7 @@ tokio-test = { workspace = true }
 tower-fallback = { path = "../tower-fallback/", version = "0.2.41" }
 tower-test = { workspace = true }
 
-zebra-test = { path = "../zebra-test/", version = "1.0.1" }
+zebra-test = { path = "../zebra-test/", version = "2.0.0" }
 
 [lints]
 workspace = true

tower-fallback/Cargo.toml

@@ -24,7 +24,7 @@ tracing = { workspace = true }
 [dev-dependencies]
 tokio = { workspace = true, features = ["full", "tracing", "test-util"] }
 
-zebra-test = { path = "../zebra-test/", version = "1.0.1" }
+zebra-test = { path = "../zebra-test/", version = "2.0.0" }
 
 [lints]
 workspace = true

zebra-chain/CHANGELOG.md

@@ -5,7 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.1.0] - XXXX-XX-XX
+## [3.0.0] - 2025-10-15
+
+In this release we removed a significant amount of Sapling-related code in favor of upstream implementations.
+These changes break the public API and may require updates in downstream crates. ([#9828](https://github.com/ZcashFoundation/zebra/issues/9828))
+
+### Breaking Changes
+
+- The `ValueCommitment` type no longer derives `Copy`.
+- `zebra-chain::Errors` has new variants.
+- ` ValueCommitment::new` and `ValueCommitment::randomized` methods were removed.
+- Constant `NU6_1_ACTIVATION_HEIGHT_TESTNET` was removed as is now part of `activation_heights` module.
+- Structs `sapling::NoteCommitment`, `sapling::NotSmallOrderValueCommitment` and `sapling::tree::Node` were
+  removed.
 
 ### Added
 

zebra-chain/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zebra-chain"
-version = "2.0.0"
+version = "3.0.0"
 authors = ["Zcash Foundation <zebra@zfnd.org>"]
 description = "Core Zcash data structures"
 license = "MIT OR Apache-2.0"
@@ -132,7 +132,7 @@ proptest-derive = { workspace = true, optional = true }
 rand = { workspace = true, optional = true }
 rand_chacha = { workspace = true, optional = true }
 
-zebra-test = { path = "../zebra-test/", version = "1.0.1", optional = true }
+zebra-test = { path = "../zebra-test/", version = "2.0.0", optional = true }
 
 [dev-dependencies]
 # Benchmarks
@@ -152,7 +152,7 @@ rand_chacha = { workspace = true }
 
 tokio = { workspace = true, features = ["full", "tracing", "test-util"] }
 
-zebra-test = { path = "../zebra-test/", version = "1.0.1" }
+zebra-test = { path = "../zebra-test/", version = "2.0.0" }
 
 [[bench]]
 name = "block"

zebra-consensus/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.0] - 2025-10-15
+
+In this release, the Sapling parameters were refactored ([#9678](https://github.com/ZcashFoundation/zebra/pull/9678)),
+and the Sapling verifiers now use the `BatchValidator`. The transaction verifier was also updated to use
+`orchard::bundle::BatchValidator` ([#9308](https://github.com/ZcashFoundation/zebra/pull/9308)).
+
+Additionally, the checkpoint logic was moved out of `zebra-consensus` into `zebra-chain`
+to simplify configuration in testnet and regtest modes. ([#9888](https://github.com/ZcashFoundation/zebra/pull/9888))
+
+### Breaking Changes
+
+- Removed public statics used for Groth16 verification:
+    - `SPEND_VERIFIER`
+    - `OUTPUT_VERIFIER`
+- Removed or renamed public structs:
+    - `zebra_consensus::groth16::Groth16Parameters`
+    - `zebra_consensus::groth16::GROTH16_PARAMETERS`
+    - `zebra_consensus::CheckpointList`
+    - `zebra_consensus::halo2::BatchVerifier`
+- Removed public trait:
+    - `zebra_consensus::ParameterCheckpoint`
+- Moved checkpoint configuration and related structures to zebra-chain.
+
+
 ## [2.0.0] - 2025-08-07
 
 Support for NU6.1 testnet activation.

zebra-consensus/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zebra-consensus"
-version = "2.0.0"
+version = "3.0.0"
 authors = ["Zcash Foundation <zebra@zfnd.org>"]
 description = "Implementation of Zcash consensus checks"
 license = "MIT OR Apache-2.0"
@@ -62,9 +62,9 @@ tower-fallback = { path = "../tower-fallback/", version = "0.2.41" }
 tower-batch-control = { path = "../tower-batch-control/", version = "0.2.41" }
 
 zebra-script = { path = "../zebra-script", version = "2.0.0" }
-zebra-state = { path = "../zebra-state", version = "2.0.0" }
-zebra-node-services = { path = "../zebra-node-services", version = "1.0.1" }
-zebra-chain = { path = "../zebra-chain", version = "2.0.0" }
+zebra-state = { path = "../zebra-state", version = "3.0.0" }
+zebra-node-services = { path = "../zebra-node-services", version = "2.0.0" }
+zebra-chain = { path = "../zebra-chain", version = "3.0.0" }
 
 zcash_protocol.workspace = true
 
@@ -88,9 +88,9 @@ tokio = { workspace = true, features = ["full", "tracing", "test-util"] }
 tracing-error = { workspace = true }
 tracing-subscriber = { workspace = true }
 
-zebra-state = { path = "../zebra-state", version = "2.0.0", features = ["proptest-impl"] }
-zebra-chain = { path = "../zebra-chain", version = "2.0.0", features = ["proptest-impl"] }
-zebra-test = { path = "../zebra-test/", version = "1.0.1" }
+zebra-state = { path = "../zebra-state", version = "3.0.0", features = ["proptest-impl"] }
+zebra-chain = { path = "../zebra-chain", version = "3.0.0", features = ["proptest-impl"] }
+zebra-test = { path = "../zebra-test/", version = "2.0.0" }
 
 [lints]
 workspace = true

zebra-network/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2025-10-15
+
+Added a new `Request::AdvertiseBlockToAll` variant to support block advertisement
+across peers ([#9907](https://github.com/ZcashFoundation/zebra/pull/9907)).
+
+### Breaking Changes
+
+- Added `AdvertiseBlockToAll` variant to the `Request` enum.
+
+
 ## [1.1.0] - 2025-08-07
 
 Support for NU6.1 testnet activation.

zebra-network/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zebra-network"
-version = "1.1.0"
+version = "2.0.0"
 authors = ["Zcash Foundation <zebra@zfnd.org>", "Tower Maintainers <team@tower-rs.com>"]
 description = "Networking code for Zebra"
 # # Legal
@@ -83,7 +83,7 @@ howudoin = { workspace = true, optional = true }
 proptest = { workspace = true, optional = true }
 proptest-derive = { workspace = true, optional = true }
 
-zebra-chain = { path = "../zebra-chain", version = "2.0.0", features = ["async-error"] }
+zebra-chain = { path = "../zebra-chain", version = "3.0.0", features = ["async-error"] }
 
 [dev-dependencies]
 proptest = { workspace = true }