Skip to content

Zebra v6.2.0

Choose a tag to compare

View all tags
@zebra-release zebra-release released this 17 Jul 22:07
v6.2.0
135c136
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Zebra 6.2.0 adds an experimental migration path for exchanges and custodial services that still depend on the zcashd wallet and RPC interfaces. Zebra handles Zcash networking and consensus while a constrained zcashd sidecar retains the existing wallet, RPC, and ZMQ surface. Existing Zebra deployments are unchanged unless zcashd-compat mode is enabled.

Update Priority

User Type Priority Reason
Exchanges and custodial services evaluating migration from zcashd Medium Adds the experimental zcashd-compat mode and migration tooling
General operators Low No required migration; existing node operation is unchanged

Added

  • New experimental zcashd-compat mode (zebrad start --zcashd-compat or the [zcashd_compat] configuration section). Zebra faces the Zcash network while a hard-locked zcashd wallet runs as a sidecar connected only to the local Zebra node. Zebra can optionally download, supervise, and restart the SHA256-pinned sidecar. The release also includes an interactive installer with binary, Docker, and source-build modes, plus operational documentation and sync-check tooling (#10952). Credits to the Zakura authors for the major part of this implementation.
  • New Regtest-only generatetoaddress RPC that mines blocks paying the coinbase to a caller-specified address. This allows test harnesses to fund multiple wallets from one Zebra node (#10952).

Fixed

  • The installer's docker-supervised mode now configures the embedded sidecar source, so its generated command works with the published Zebra image (#11008).

How to Upgrade

Upgrading from Zebra 6.1.0 does not require a state migration or resync.

Docker

docker pull zfnd/zebra:6.2.0
# or update your compose file and:
docker compose pull && docker compose up -d

Binary

  1. Stop zebrad (systemctl stop zebrad or Ctrl+C) and wait for a clean shutdown.
  2. Replace the binary with zebrad-6.2.0-<arch>-unknown-linux-gnu.tar.gz from this release's assets, or run cargo binstall zebrad.
  3. Start zebrad again.

Source

git fetch && git checkout v6.2.0
cargo build --release

Source builds require Rust 1.91 or newer, protoc, a C++ compiler, and libclang.

For installation and safety guidance, see zcashd-compat mode.

Compatibility

Component Supported
Operating systems Linux (prebuilt binaries: x86_64 and aarch64, glibc 2.34+); macOS and Windows via source build
Zcash protocol All network upgrades through NU6.3 (Ironwood)
State database Format 28.0.0; unchanged from Zebra 6.1.0, no resync required
Minimum Rust for source builds 1.91
zcashd compatibility Experimental constrained-sidecar mode; review the safety guidance before production use
End of support Block 3,537,960, approximately 105 days after release

Contributors

Thank you to everyone who contributed to this release. We couldn't make Zebra without you:

@arya2 and @gustavovalverde.

Contributors

arya2 and gustavovalverde
Assets 8
Loading