Go to file
dependabot[bot] cf3ae8fe16
build(deps): bump the ecc group across 1 directory with 3 updates (#9577)
Bumps the ecc group with 3 updates in the / directory: [zcash_address](https://github.com/zcash/librustzcash), [zcash_keys](https://github.com/zcash/librustzcash) and [zcash_protocol](https://github.com/zcash/librustzcash).


Updates `zcash_address` from 0.7.0 to 0.7.1
- [Release notes](https://github.com/zcash/librustzcash/releases)
- [Commits](https://github.com/zcash/librustzcash/compare/zcash_address-0.7.0...zcash_address-0.7.1)

Updates `zcash_keys` from 0.8.0 to 0.8.1
- [Release notes](https://github.com/zcash/librustzcash/releases)
- [Commits](https://github.com/zcash/librustzcash/compare/zcash_keys-0.8.0...zcash_keys-0.8.1)

Updates `zcash_protocol` from 0.5.1 to 0.5.2
- [Release notes](https://github.com/zcash/librustzcash/releases)
- [Commits](https://github.com/zcash/librustzcash/compare/zcash_protocol-0.5.1...zcash_protocol-0.5.2)

---
updated-dependencies:
- dependency-name: zcash_address
  dependency-version: 0.7.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: ecc
- dependency-name: zcash_keys
  dependency-version: 0.8.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: ecc
- dependency-name: zcash_protocol
  dependency-version: 0.5.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: ecc
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2025-06-06 23:51:51 +00:00
.cargo
.github fix(ci): mark `sync-to-checkpoint` test as long-running (#9595) 2025-06-06 22:07:05 +00:00
book fix(network): Allow local outbound connections on Regtest (#9580) 2025-06-06 23:51:48 +00:00
docker fix(ci): pin lightwalletd to v0.4.17 to prevent CI failures (#9575) 2025-06-03 16:10:34 +00:00
docs/decisions
grafana
supply-chain
tower-batch-control tower-batch-control: Fix `Batch::new` compilation with `tokio_unstable` (#9547) 2025-05-26 15:19:34 +01:00
tower-fallback
zebra-chain rpc: add deserialization tests (#9550) 2025-06-03 20:49:57 +00:00
zebra-consensus change(state): Upgrade db format to support new fields in RPC outputs (#9539) 2025-06-03 20:49:53 +00:00
zebra-grpc
zebra-network fix(network): Allow local outbound connections on Regtest (#9580) 2025-06-06 23:51:48 +00:00
zebra-node-services
zebra-rpc rpc: add deserialization tests (#9550) 2025-06-03 20:49:57 +00:00
zebra-scan
zebra-script
zebra-state change(state): Upgrade db format to support new fields in RPC outputs (#9539) 2025-06-03 20:49:53 +00:00
zebra-test fix(clippy, build): fix latest Clippy lints introduced in v1.87.0 and migrate from vergen to vergen_git (#9531) 2025-05-16 15:00:07 +00:00
zebra-utils fix(rpc): Regroup imports (#9521) 2025-05-14 18:36:05 +00:00
zebrad change(consensus): Adds a `Nu6_1` variant to `NetworkUpgrade` (#9526) 2025-06-03 16:10:30 +00:00
.codespellrc
.dockerignore
.firebaserc
.gitattributes
.gitignore
CHANGELOG.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md Update `CONTRIBUTING.md` (#9561) 2025-06-06 15:30:05 -03:00
Cargo.lock build(deps): bump the ecc group across 1 directory with 3 updates (#9577) 2025-06-06 23:51:51 +00:00
Cargo.toml change(deps): Allow Zebra crates to be compiled with alternative versions of their dependencies (#9484) 2025-06-03 16:10:25 +00:00
LICENSE-APACHE
LICENSE-MIT
README.md
SECURITY.md
clippy.toml
codecov.yml
deny.toml
firebase.json
katex-header.html
openapi.yaml
prometheus.yaml
release.toml
rust-toolchain.toml

README.md

Zebra logotype


Integration Tests CI OSes Continuous Delivery codecov Build docs License

Zebra is a Zcash full-node written in Rust.

Getting Started

You can run Zebra using our Docker image or you can build it manually.

Docker

This command will run our latest release, and sync it to the tip:

docker run zfnd/zebra:latest

For more information, read our Docker documentation.

Manual Build

Building Zebra requires Rust, libclang, and a C++ compiler. Below are quick summaries for installing the dependencies.

General instructions for installing dependencies

  1. Install cargo and rustc.

  2. Install Zebra's build dependencies:

    • libclang is a library that might have different names depending on your package manager. Typical names are libclang, libclang-dev, llvm, or llvm-dev.
    • clang or another C++ compiler: g++ (all platforms) or Xcode (macOS).
    • protoc

[!NOTE] Zebra uses the --experimental_allow_proto3_optional flag with protoc during compilation. This flag was introduced in Protocol Buffers v3.12.0 released in May 16, 2020, so make sure you're not using a version of protoc older than 3.12.

Dependencies on Arch

sudo pacman -S rust clang protobuf

Note that the package clang includes libclang as well as the C++ compiler.

Recently the GCC version on Arch has broken a build script in the rocksdb dependency. A workaround is:

export CXXFLAGS="$CXXFLAGS -include cstdint"

Once you have the dependencies in place, you can build and install Zebra with:

cargo install --locked zebrad

You can start Zebra by running

zebrad start

Refer to the Installing Zebra and Running Zebra sections in the book for enabling optional features, detailed configuration and further details.

CI/CD Architecture

Zebra uses a comprehensive CI/CD system built on GitHub Actions to ensure code quality, maintain stability, and automate routine tasks. Our CI/CD infrastructure:

  • Runs automated tests on every PR and commit.
  • Manages deployments to various environments.
  • Handles cross-platform compatibility checks.
  • Automates release processes.

For a detailed understanding of our CI/CD system, including workflow diagrams, infrastructure details, and best practices, see our CI/CD Architecture Documentation.

Documentation

The Zcash Foundation maintains the following resources documenting Zebra:

User support

If Zebra doesn't behave the way you expected, open an issue. We regularly triage new issues and we will respond. We maintain a list of known issues in the Troubleshooting section of the book.

If you want to chat with us, Join the Zcash Foundation Discord Server and find the "zebra-support" channel.

Security

Zebra has a responsible disclosure policy, which we encourage security researchers to follow.

License

Zebra is distributed under the terms of both the MIT license and the Apache License (Version 2.0). Some Zebra crates are distributed under the MIT license only, because some of their code was originally from MIT-licensed projects. See each crate's directory for details.

See LICENSE-APACHE and LICENSE-MIT.