2026-06-02 17:59:43 +02:00

59 lines
2.6 KiB
Rust

/// Generates a `pub mod artifacts` containing the circuit compilation
/// artifacts.
///
/// The artifacts are loaded from `LBC_ROOT_DIR/{circuit_dir}/`, set by the
/// crate's build script.
///
/// # Generated items
///
/// | Item | Description |
/// |-------------------------|-----------------------------------------------------------|
/// | `PROVING_KEY_PATH` | Path to the proving key (`.zkey`) |
/// | `PROVING_KEY` | Proving key bytes (`embed-proving-key` flag) |
/// | `VERIFICATION_KEY_PATH` | Path to the verification key (`.json`) |
/// | `VERIFICATION_KEY` | Verification key bytes (`embed-verification-key` flag) |
/// | `CIRCUIT_PATH` | Path to the witness generator data |
/// | `CIRCUIT` | Witness generator data bytes (`embed-circuit` flag) |
///
/// The path constants are always available. Each byte static requires its
/// own feature flag in the calling crate.
///
/// # Feature flag placement
///
/// The required feature flags must be declared in the calling crate's
/// `[features]` section. `#[cfg(feature = "...")]` inside a `macro_rules!` body
/// is evaluated in the calling crate's context, not this crate's.
///
/// # Example
///
/// ```ignore
/// lbc_common::circuit_artifacts!("poq"); // uses {LBC_ROOT_DIR}/poq/
/// ```
#[macro_export]
macro_rules! circuit_artifacts {
($circuit_dir:literal) => {
pub mod artifacts {
macro_rules! __circuit_file {
($file:literal) => {
// "LBC_ROOT_DIR" must stay in sync with the constant in `lbc-build`.
// env!() requires a literal so the name cannot be shared.
concat!(env!("LBC_ROOT_DIR"), "/", $circuit_dir, "/", $file)
};
}
pub const PROVING_KEY_PATH: &str = __circuit_file!("proving_key.zkey");
#[cfg(feature = "embed-proving-key")]
pub static PROVING_KEY: &[u8] = include_bytes!(__circuit_file!("proving_key.zkey"));
pub const VERIFICATION_KEY_PATH: &str = __circuit_file!("verification_key.json");
#[cfg(feature = "embed-verification-key")]
pub static VERIFICATION_KEY: &[u8] =
include_bytes!(__circuit_file!("verification_key.json"));
pub const CIRCUIT_PATH: &str = __circuit_file!("witness_generator.dat");
#[cfg(feature = "embed-circuit")]
pub static CIRCUIT: &[u8] = include_bytes!(__circuit_file!("witness_generator.dat"));
}
};
}