Struct EffectInjector 

pub struct EffectInjector { /* private fields */ }

Controlled effect injector for timing tests.

Provides a safe, configurable way to inject timing effects with built-in safety limits and common patterns.

Example

use tacet::helpers::effect::EffectInjector;

let injector = EffectInjector::new();

// In a timing test:
TimingOracle::for_attacker(AttackerModel::AdjacentNetwork)
    .test(inputs, |&should_delay| {
        injector.conditional_delay(should_delay, 200);
    });

Implementations

impl EffectInjector

pub fn new() -> Self

Create a new effect injector with default safety limit (100μs).

Important: Call init_effect_injection() before creating the first EffectInjector to ensure calibration doesn’t interfere with timing measurements.

pub fn with_max_ns(max_ns: u64) -> Self

Create an effect injector with a custom maximum delay.

Arguments

• max_ns - Maximum delay in nanoseconds

pub fn delay_ns(&self, ns: u64)

Inject a fixed delay.

The delay is clamped to this injector’s maximum.

pub fn conditional_delay(&self, condition: bool, delay_ns: u64)

Inject a conditional delay (common pattern for timing tests).

If condition is true, delays by delay_ns. If false, no delay is applied.

This is the standard pattern for baseline vs sample timing tests:

• Baseline: condition=false (no delay)
• Sample: condition=true (delay applied)

pub fn proportional_delay(&self, value: u64, ns_per_unit: f64)

Inject a delay proportional to a value.

Useful for simulating data-dependent timing where larger values take longer to process.

Arguments

• value - The value to scale by
• ns_per_unit - Nanoseconds of delay per unit of value

pub fn hamming_weight_delay(&self, data: &[u8], ns_per_bit: f64)

Inject a delay based on Hamming weight (number of 1 bits).

Simulates timing leaks where processing time depends on the number of set bits in the data.

Arguments

• data - Byte slice to compute Hamming weight from
• ns_per_bit - Nanoseconds of delay per set bit

pub fn max_ns(&self) -> u64

Get the maximum delay this injector will apply.

Trait Implementations

impl Clone for EffectInjector

fn clone(&self) -> EffectInjector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EffectInjector

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

Formats the value using the given formatter.

impl Default for EffectInjector

fn default() -> Self

Returns the “default value” for a type.