zebra_consensus/primitives/groth16/
params.rs

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
72
73
74
75
76
77
78
79
80
81
82
//! Loading and checking correctness of Groth16 Sapling and Sprout parameters.

use bellman::groth16;
use bls12_381::Bls12;

mod parse_parameters;

use parse_parameters::parse_sapling_parameters;

lazy_static::lazy_static! {
    /// Groth16 Zero-Knowledge Proof parameters for the Sapling and Sprout circuits.
    ///
    /// This static is accessed when Zebra needs to use these parameters for verification.
    ///
    /// # Panics
    ///
    /// If the parameter data in the `zebrad` binary is invalid.
    pub static ref GROTH16_PARAMETERS: Groth16Parameters = Groth16Parameters::new();
}

/// Groth16 Zero-Knowledge Proof parameters for the Sapling and Sprout circuits.
pub struct Groth16Parameters {
    /// The Sapling circuit Groth16 parameters.
    pub sapling: SaplingParameters,

    /// The Sprout circuit Groth16 spend parameter.
    pub sprout: SproutParameters,
}

/// Groth16 Zero-Knowledge Proof spend and output parameters for the Sapling circuit.
pub struct SaplingParameters {
    pub spend: groth16::Parameters<Bls12>,
    pub spend_prepared_verifying_key: groth16::PreparedVerifyingKey<Bls12>,

    pub output: groth16::Parameters<Bls12>,
    pub output_prepared_verifying_key: groth16::PreparedVerifyingKey<Bls12>,
}

/// Groth16 Zero-Knowledge Proof spend parameters for the Sprout circuit.
///
/// Adding value to the Sprout pool was disabled by the Canopy network upgrade.
pub struct SproutParameters {
    pub joinsplit_prepared_verifying_key: groth16::PreparedVerifyingKey<Bls12>,
}

impl Groth16Parameters {
    /// Loads the Sprout and Sapling Groth16 parameters from the `zebrad` binary, and checks that
    /// the data is valid.
    ///
    /// # Panics
    ///
    /// If the parameter data in the `zebrad` binary is invalid.
    fn new() -> Groth16Parameters {
        tracing::info!("checking and loading Zcash Sapling and Sprout parameters");

        let (sapling_spend_bytes, sapling_output_bytes) =
            wagyu_zcash_parameters::load_sapling_parameters();
        let sprout_vk_bytes = include_bytes!("sprout-groth16.vk");

        let sapling = parse_sapling_parameters(
            sapling_spend_bytes.as_slice(),
            sapling_output_bytes.as_slice(),
        );

        let sprout_vk = groth16::VerifyingKey::<Bls12>::read(&sprout_vk_bytes[..])
            .expect("should be able to parse Sprout verification key");
        let sprout_vk = groth16::prepare_verifying_key(&sprout_vk);

        let sprout = SproutParameters {
            joinsplit_prepared_verifying_key: sprout_vk,
        };

        tracing::info!("Zcash Sapling and Sprout parameters loaded and verified");

        Groth16Parameters { sapling, sprout }
    }

    /// Returns a hint that helps users recover from parameter loading failures.
    pub fn failure_hint() -> String {
        "Hint: re-run `zebrad` or re-install it from a trusted source".to_string()
    }
}