Struct DifferentialPrivacy 

pub struct DifferentialPrivacy { /* private fields */ }

Differential privacy for gradient protection

Implementations

impl DifferentialPrivacy

pub fn new( epsilon: f64, delta: f64, sensitivity: f64, mechanism: DPMechanism, ) -> Self

Create a new differential privacy instance

pub fn add_gaussian_noise( &mut self, gradient: &mut [f32], ) -> Result<(), GradientError>

Add Gaussian noise to gradient (for DP-SGD) Calibrated according to sensitivity and privacy parameters

pub fn add_laplacian_noise( &mut self, gradient: &mut [f32], ) -> Result<(), GradientError>

Add Laplacian noise to gradient Calibrated according to L1 sensitivity and privacy parameters

pub fn apply_dp_sgd( &mut self, gradient: &mut [f32], clip_norm: f32, ) -> Result<(), GradientError>

Apply DP-SGD (Differential Private Stochastic Gradient Descent) This clips gradients and adds noise

pub fn remaining_budget(&self) -> f64

Get remaining privacy budget

pub fn is_budget_exhausted(&self) -> bool

Check if privacy budget is exhausted

pub fn get_privacy_params(&self) -> (f64, f64)

Get privacy parameters

pub fn calculate_noise_multiplier( epsilon: f64, delta: f64, sensitivity: f64, ) -> f64

Calculate noise multiplier for given privacy parameters Used in DP-SGD implementations

pub fn add_gaussian_noise_sens(&self, gradient: &mut [f32], sensitivity: f32)

Add calibrated Gaussian noise to a gradient slice (stateless, sensitivity supplied).

σ = sensitivity × √(2 ln(1.25/δ)) / ε

Uses Box-Muller transform for Normal sampling (no rand_distr dependency).

pub fn add_laplace_noise_sens(&self, gradient: &mut [f32], sensitivity: f32)

Add calibrated Laplace noise to a gradient slice (stateless, sensitivity supplied).

scale = sensitivity / ε

pub fn clip_l2(&self, gradient: &mut [f32], max_norm: f32)

Clip gradient in-place to L2 norm ≤ max_norm.

pub fn remaining_budget_after(&self, rounds_used: u32) -> f32

Return remaining epsilon budget after rounds_used rounds, each costing ε/100.

This mirrors the per-round consumption used by add_gaussian_noise (mutable version).

pub fn is_exhausted_after(&self, rounds_used: u32) -> bool

True if the budget would be exhausted after rounds_used rounds.