Struct Config 

pub struct Config {

    pub enabled: bool,
    pub manage_zcashd: bool,
    pub zcashd_source: ZcashdBinarySource,
    pub zcashd_path: Option<PathBuf>,
    pub zcashd_datadir: Option<PathBuf>,
    pub zcashd_extra_args: Vec<String>,
    pub p2p_connect_addr: Option<SocketAddr>,
    pub block_gossip_peer_ips: Vec<IpAddr>,
    pub startup_delay: Duration,
    pub restart_backoff: Duration,
    pub restart_backoff_max: Duration,
    pub restart_reset_after: Duration,
    pub shutdown_grace_period: Duration,
}

Configuration for Zebra zcashd-compat mode.

Fields

enabled: bool

Enables zcashd-compat mode.

zcashd-compat mode supervises or validates a P2P sidecar zcashd process that syncs chain data from Zebra over the legacy Zcash P2P protocol.

manage_zcashd: bool

Whether Zebra should spawn and supervise a zcashd -zebra-compat child process.

Set this to false if zcashd is managed externally.

zcashd_source: ZcashdBinarySource

Preferred source for the zcashd binary.

If zcashd_path is set, that explicit local path overrides this value.

zcashd_path: Option<PathBuf>

Optional explicit path to a local zcashd binary with zcashd-compat support.

When set, Zebra uses this path directly and skips embedded downloads.

zcashd_datadir: Option<PathBuf>

Optional zcashd datadir path.

If unset, Zebra uses a subdirectory in state.cache_dir.

zcashd_extra_args: Vec<String>

Extra command-line arguments passed to zcashd.

This can be provided as:

• a TOML array: zcashd_extra_args = ["-debug=1"]
• a JSON array string (useful for environment variable overrides): ZEBRA_ZCASHD_COMPAT__ZCASHD_EXTRA_ARGS='["-conf=/path/to/zcash.conf","-debug=1"]'

Zebra passes these arguments through unchanged. For first-start bootstrap, Zebra only infers path overrides from the first valid -conf=/path or -datadir=/path form, and logs warnings for paired, empty, or duplicate path options.

Supervised zcashd runs always include -printtoconsole automatically.

p2p_connect_addr: Option<SocketAddr>

The Zebra legacy P2P address supervised zcashd connects to via -connect.

If unset, Zebra derives it from its own bound legacy P2P listener (network.listen_addr), substituting 127.0.0.1 when the listener is bound to an unspecified address. Set this only when zcashd must reach Zebra through a different address, such as across containers.

block_gossip_peer_ips: Vec<IpAddr>

Inbound sidecar peer IPs that must always receive block inventory broadcasts.

If empty while zcashd-compat is enabled, Zebra defaults this list to loopback addresses. This setting is rejected when zcashd-compat is disabled.

Security

This is a trusted-peer privilege boundary, not just a gossip list. Inbound peers connecting from these IPs also:

• use a reserved inbound connection pool of one slot per listed IP (shared across the list, without per-IP accounting), reducing the public inbound pool by the same amount; when the reserved pool is full, further connections from listed IPs compete for public slots like any other peer,
• bypass the recent-IP reconnection rate limit while a reserved slot is free (fallback connections are rate limited normally), and
• are exempt from the FindBlocks/FindHeaders sync stall detector.

Only list addresses where every process is trusted, like the loopback addresses of a host that runs nothing but Zebra and its sidecar. Never list IPs that untrusted machines can connect from.

Because environment values cannot express TOML arrays, this also accepts a JSON array string, e.g. ZEBRA_ZCASHD_COMPAT__BLOCK_GOSSIP_PEER_IPS='["10.0.0.5"]'.

startup_delay: Duration

Delay before the first zcashd spawn attempt.

restart_backoff: Duration

Delay between supervisor restart attempts.

This is the base delay for exponential restart backoff.

restart_backoff_max: Duration

Maximum delay between supervisor restart attempts.

This caps exponential restart backoff while retries continue indefinitely.

restart_reset_after: Duration

Child uptime that resets the supervisor’s consecutive restart count.

shutdown_grace_period: Duration

Grace period for a clean shutdown after sending SIGTERM.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns conservative zcashd-compat defaults for an externally managed zcashd.

Defaults keep zcashd-compat disabled unless explicitly requested, and do not spawn zcashd unless supervision is explicitly enabled. The restart/shutdown settings apply only to supervised zcashd children.

impl<'de> Deserialize<'de> for Config

where Config: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Config

impl PartialEq for Config

fn eq(&self, other: &Config) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Config

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 216 bytes