Expand description
Zebra is a Zcash full node written in Rust. Follow the introductory page in the Zebra Book to learn more.
§About Zcash
Zcash is a cryptocurrency designed to preserve the user’s privacy. Like most cryptocurrencies, it works by a collection of software nodes run by members of the Zcash community or any other interested parties. The nodes talk to each other in peer-to-peer fashion in order to maintain the state of the Zcash blockchain. They also communicate with miners who create new blocks. When a Zcash user sends Zcash, their wallet broadcasts transactions to these nodes which will eventually reach miners, and the mined transaction will then go through Zcash nodes until they reach the recipient’s wallet which will report the received Zcash to the recipient.
§Alternative Implementations
The original Zcash node is named zcashd
and is developed by the Electric Coin
Company as a fork of the original Bitcoin node. Zebra, on the other hand, is
an independent Zcash node implementation developed from scratch. Since they
implement the same protocol, zcashd
and Zebra nodes can communicate with each
other and maintain the Zcash network together.
§Zebra Advantages
These are some of the advantages or benefits of Zebra:
- Better performance: since it was implemented from scratch in an async, parallelized way, Zebra
is currently faster than
zcashd
. - Better security: since it is developed in a memory-safe language (Rust), Zebra is less likely to be affected by memory-safety and correctness security bugs that could compromise the environment where it is run.
- Better governance: with a new node deployment, there will be more developers who can implement different features for the Zcash network.
- Dev accessibility: supports more developers, which gives new developers options for contributing to Zcash protocol development.
- Runtime safety: with an independent implementation, the detection of consensus bugs can happen quicker, reducing the risk of consensus splits.
- Spec safety: with several node implementations, it is much easier to notice bugs and ambiguity in protocol specification.
- User options: different nodes present different features and tradeoffs for users to decide on their preferred options.
- Additional contexts: wider target deployments for people to use a consensus node in more contexts e.g. mobile, wasm, etc.
§Configuration
The command below places the generated zebrad.toml
config file in the default preferences directory of Linux:
zebrad generate -o ~/.config/zebrad.toml
See config::ZebradConfig
for other OSes default locations or more information about how to configure Zebra.
§Zebra Feature Flags
The following Cargo features are available at compile time:
§JSON-RPC
getblocktemplate-rpcs
: Mining pool RPC support, enabled by default in production builds.
§Metrics
- configuring a
tracing.progress_bar
: shows key metrics in the terminal using progress bars, and automatically configures Zebra to send logs to a file. (Theprogress-bar
feature is activated by default.) prometheus
: export metrics to prometheus.
Read the metrics section of the book for more details.
§Tracing
Sending traces to different subscribers:
- configuring a
tracing.log_file
: appends traces to a file on disk. journald
: send tracing spans and events tosystemd-journald
.sentry
: send crash and panic events to sentry.io.flamegraph
: generate a flamegraph of tracing spans.
Changing the traces that are collected:
filter-reload
: dynamically reload tracing filters at runtime.error-debug
: enable extra debugging in release builds.tokio-console
: enable tokio’sconsole-subscriber
(needs specific compiler flags)- A set of features that skip verbose tracing.
The default features ignore
debug
andtrace
logs in release builds.
Read the tracing section of the book for more details.
§Testing
proptest-impl
: enable randomised test data generation.lightwalletd-grpc-tests
: enable Zebra JSON-RPC tests that querylightwalletd
using gRPC.
§Experimental
elasticsearch
: save block data into elasticsearch database. Read the elasticsearch section of the book for more details.shielded-scan
: enable experimental support for scanning shielded transactions. Read the shielded-scan section of the book for more details.internal-miner
: enable experimental support for mining inside Zebra, without an external mining pool. This feature is only supported on testnet. Use a GPU or ASIC on mainnet for efficient mining.
§Zebra crates
The Zebra monorepo is a collection of the following crates:
- tower-batch-control
- tower-fallback
- zebra-chain
- zebra-consensus
- zebra-network
- zebra-node-services
- zebra-rpc
- zebra-scan
- zebra-script
- zebra-state
- zebra-test
- zebra-utils
- zebrad
The links in the list above point to the documentation of the public APIs of the crates. For the documentation of the internal APIs, follow https://doc-internal.zebra.zfnd.org that lists all Zebra crates as well in the left sidebar.
Modules§
- Zebrad Abscissa Application
- Zebrad Subcommands
- Holds components of a Zebra node.
- Zebrad Config
- Application-local prelude: conveniently import types/functions/macros which are generally useful and should be available everywhere.
- Integration with sentry.io for event reporting.
Type Aliases§
- Error type alias to make working with tower traits easier.