Skip to content

Releases: valargroup/zebra

v5.0.0-rc.3

04 Jun 14:25
3f35436

Choose a tag to compare

v5.0.0-rc.3 Pre-release
Pre-release

Release candidate for the public fork's v5 rollback build.

Changes since rc.2:

  • Retry missing block downloads inside the active sync round, avoiding long stalls when a peer reports notfound for a required block hash.

v5.0.0-rc.2

03 Jun 18:53
828eaa6

Choose a tag to compare

v5.0.0-rc.2 Pre-release
Pre-release

Release candidate for the public fork's v5 rollback build.

Changes since rc.1:

  • Increase sync tip acquisition / restart-operation timeout to 30 seconds.
  • Keep post-round public sync restart sleep at 10 seconds.
  • Keep regtest restart delay at 2 seconds.

v5.0.0-rc.1

03 Jun 18:31
d25e102

Choose a tag to compare

v5.0.0-rc.1 Pre-release
Pre-release

Release candidate for the public fork's v5 rollback build.

Changes:

  • Tune sync defaults for faster public-fork block sync: retry sync rounds and tip acquisition after 2 seconds.
  • Increase default block download concurrency to 100.
  • Increase the default peer target size to 100.
  • Cap inbound peers at the peer target size.

Zebra v5.0.0-rc.0 rollback utility build

03 Jun 15:59
4d2536f

Choose a tag to compare

Rollback utility build based on Zebra v5.0.0 with finalized-state rollback support.

Assets

The Linux x86_64 archive contains both binaries:

  • zebra - the standard Zebra node binary
  • zebra-rollback-state - standalone finalized-state rollback utility

Rollback performance

For modern v5 rollback targets, zebra-rollback-state no longer replays note
commitment trees from genesis when the removed block range did not change the
Sprout tree. It loads the target Sapling and Orchard roots from the existing
height-indexed state and rebuilds only the history tree from the active network
upgrade activation height.

If any rolled-back block contains Sprout commitments, rollback deliberately uses
the full tree rebuild path so the Sprout tip tree is reset to the target height
instead of being left at the pre-rollback tip.

Using zebra-rollback-state

Stop Zebra before rolling back the state database.

Download and unpack the archive:

curl -L -O https://github.com/valargroup/zebra/releases/download/v5.0.0-rc.0/zebra-v5.0.0-rc.0-x86_64-unknown-linux-gnu.tar.gz
curl -L -O https://github.com/valargroup/zebra/releases/download/v5.0.0-rc.0/zebra-v5.0.0-rc.0-x86_64-unknown-linux-gnu.tar.gz.sha256
sha256sum -c zebra-v5.0.0-rc.0-x86_64-unknown-linux-gnu.tar.gz.sha256
tar -xzf zebra-v5.0.0-rc.0-x86_64-unknown-linux-gnu.tar.gz

Preview the rollback plan without changing state:

./zebra-rollback-state \
  --network mainnet \
  --cache-dir "$HOME/.cache/zebra" \
  --height <HEIGHT> \
  --dry-run

Apply the rollback by omitting --dry-run:

./zebra-rollback-state \
  --network mainnet \
  --cache-dir "$HOME/.cache/zebra" \
  --height <HEIGHT>

Use --network testnet for Testnet. Pass the root Zebra cache directory,
usually $HOME/.cache/zebra on Linux, not the nested state/vN/mainnet or
state/vN/testnet directory.

To preserve rolled-back finalized blocks in the non-finalized backup cache, add:

--keep-rolled-back-blocks

Full help:

./zebra-rollback-state --help

v4.5.0-jsonl-traces

29 May 22:11
610d6e4

Choose a tag to compare

v4.5.0-jsonl-traces Pre-release
Pre-release

Private/debug prerelease for v4.5 mainnet JSONL trace binaries. Built from evan/jsonl-traces-v4.5-mainnet with default-release-binaries and p2p-tracing.

NU7 testnet v0.1.2

22 May 05:41
f26fed0

Choose a tag to compare

NU7 testnet v0.1.2 Pre-release
Pre-release

NU7 testnet pre-release v0.1.2.

Changes since v0.1.1:

  • feat(sync): batch block downloads to speed up sync from few peers — new [sync] block_download_batch_size option (default 100). Blocks now stream back-to-back from a single peer per request, so syncing from only a few peers is no longer capped at one block per network round-trip. Set to 1 for the previous behavior.
  • fix(docker): add missing workspace members to release build context.

Linux x86_64 zebrad binary and container artifacts are built and attached automatically by the Fork release artifacts workflow.

NU7 testnet v0.1.1

22 May 02:41
7f89b69

Choose a tag to compare

NU7 testnet v0.1.1 Pre-release
Pre-release

NU7 testnet pre-release v0.1.1.

Changes since v0.1.0:

  • feat(zebrad): warn at startup if Linux TCP slow-start-after-idle is enabled, which resets the TCP congestion window between block requests and significantly reduces single-peer block-propagation throughput (ZcashFoundation#10513).

Linux x86_64 zebrad binary and container artifacts are built and attached automatically by the Fork release artifacts workflow.

NU7 testnet v0.1.0

21 May 03:46
2ab9b89

Choose a tag to compare

NU7 testnet v0.1.0 Pre-release
Pre-release

Test release for NU7 testnet binaries and container artifacts.