zakura 1.0.2

Zakura, an independent, consensus-compatible implementation of a Zcash node
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

//! `validate-vct-sprout-history` subcommand - audits repaired historical Sprout anchors.

use std::path::PathBuf;

use abscissa_core::{Application, Command, Runnable};
use clap::Parser;
use color_eyre::eyre::Result;

use zakura_chain::parameters::Network;
use zakura_state::VctSproutHistoryValidationSummary;

use crate::prelude::APPLICATION;

/// Validate repaired VCT Sprout history in an existing state database
#[derive(Command, Debug, Default, Parser)]
pub struct ValidateVctSproutHistoryCmd {
    /// Path to Zakura's cached state.
    #[clap(long, short, help = "path to directory with the Zakura chain state")]
    cache_dir: Option<PathBuf>,

    /// The network of the chain to validate.
    #[clap(
        long,
        short,
        required = true,
        help = "the network of the chain to load"
    )]
    network: Network,
}

impl Runnable for ValidateVctSproutHistoryCmd {
    /// `validate-vct-sprout-history` sub-command entrypoint.
    fn run(&self) {
        if let Err(error) = self.run_with_config(APPLICATION.config().state.clone()) {
            tracing::error!("Failed to validate VCT Sprout history: {error:#}");
            std::process::exit(1);
        }
    }
}

impl ValidateVctSproutHistoryCmd {
    /// Runs validation using `state_config` as the base state configuration.
    #[allow(clippy::print_stdout)]
    pub fn run_with_config(&self, mut state_config: zakura_state::Config) -> Result<()> {
        if let Some(cache_dir) = self.cache_dir.clone() {
            state_config.cache_dir = cache_dir;
        }

        let summary = zakura_state::validate_vct_sprout_history(state_config, &self.network)?;
        print_summary(&summary);

        Ok(())
    }
}

#[allow(clippy::print_stdout)]
fn print_summary(summary: &VctSproutHistoryValidationSummary) {
    println!("VCT Sprout history is valid:");
    println!("  finalized tip: {}", summary.finalized_tip.0);
    println!(
        "  sprout root at finalized tip height: {}",
        hex::encode(
            summary
                .sprout_root_at_finalized_tip
                .bytes_in_display_order()
        )
    );
    println!("  VCT marker: {}", summary.vct_marker.0);
    println!("  artifact handoff: {}", summary.artifact_handoff.0);
    println!("  checked Sprout anchors: {}", summary.checked_anchor_count);
}