Zebra: the Zcash Foundation client.
We are currently in the process of heavy refactoring; for the next several weeks, it's very likely that external PRs may fall out of sync or have code refactored out from under them.
Installing from source
zebra from source requires
Minimal supported version is
rustc 1.35.0 (fd19989 2019-05-23), and we generally target the stable channel.
Install rustc and cargo
cargo are a part of rust tool-chain.
An easy way to install the stable binaries for Linux and Mac is to run this in your shell:
curl https://sh.rustup.rs -sSf | sh
Windows binaries can be downloaded from rust-lang website.
Install C and C++ compilers
You will need the clang and gcc compilers plus cmake to build some of the dependencies.
You will need to make sure you have Xcode installed. If you already have Homebrew installed, you probably also already have the Xcode tools installed as well. If not, you can run the command below:
sudo apt-get update sudo apt-get install build-essential cmake clang
Clone and build zebra
Now let's clone
zebra and enter it's directory:
git clone https://github.com/ZcashFoundation/zebra cd zebra # builds zebra in release mode cargo build -p zebra --release
zebra is now available at
Installing the snap
In any of the supported Linux distros:
sudo snap install zebra --edge
zebra has internal unit tests and it conforms to external integration tests.
Running unit tests
Assuming that repository is already cloned, we can run unit tests with this command:
cargo test --all
By default parity connects to Zcash seednodes. Full list is here.
To start syncing the main network, just start the client without any arguments:
To start syncing the testnet:
To not print any syncing progress add
Importing zcashd database
It it is possible to import existing
# where $ZCASH_DB is path to your zcashd database. By default: # on macOS: "/Users/user/Library/Application Support/Zcash" # on Linux: "~/.zcash" ./target/release/zebra import "$ZCASH_DB/blocks"
By default, import verifies the imported blocks. You can disable this, by adding the
./target/release/zebra --verification-level=none import "$ZCASH_DB/blocks"
Command line interface
Full list of CLI options, which is available under
zebra --help: see here
This is a section only for developers and power users.
You can enable detailed client logging by setting the environment variable
zebra started with this environment variable will print all logs coming from
verification module with verbosity
info or higher. Available log levels are:
It's also possible to start logging from multiple modules in the same time:
zebra documentation will be available here. Meanwhile it's only possible to build it locally:
cd zebra ./tools/doc.sh open target/doc/zebra/index.html