Botan::Blinder Class Reference

#include <blinding.h>

Public Member Functions
BigInt	blind (const BigInt &x) const
	Blinder (const Blinder &)=delete
	Blinder (const Modular_Reducer &reducer, RandomNumberGenerator &rng, std::function< BigInt(const BigInt &)> fwd_func, std::function< BigInt(const BigInt &)> inv_func)
Blinder &	operator= (const Blinder &)=delete
RandomNumberGenerator &	rng () const
BigInt	unblind (const BigInt &x) const

Detailed Description

Blinding Function Object.

Definition at line 22 of file blinding.h.

Constructor & Destructor Documentation

Blinder() [1/2]

Botan::Blinder::Blinder	(	const Modular_Reducer &	reducer,
		RandomNumberGenerator &	rng,
		std::function< BigInt(const BigInt &)>	fwd_func,
		std::function< BigInt(const BigInt &)>	inv_func )

Parameters

reducer	precomputed Barrett reduction for the modulus
rng	the RNG to use for generating the nonce
fwd_func	a function that calculates the modular exponentiation of the public exponent and the given value (the nonce)
inv_func	a function that calculates the modular inverse of the given value (the nonce)

Note

Lifetime: The rng and reducer arguments are captured by reference and must live as long as the Blinder does

Definition at line 12 of file blinding.cpp.

                                                         :
      m_reducer(reducer),
      m_rng(rng),
      m_fwd_fn(std::move(fwd)),
      m_inv_fn(std::move(inv)),
      m_modulus_bits(reducer.get_modulus().bits()),
      m_e{},
      m_d{},
      m_counter{} {
   const BigInt k = blinding_nonce();
   m_e = m_fwd_fn(k);
   m_d = m_inv_fn(k);
}

Blinder() [2/2]

Botan::Blinder::Blinder ( const Blinder & )

delete

Member Function Documentation

blind()

BigInt Botan::Blinder::blind

(

const BigInt &

x

)

const

Blind a value. The blinding nonce k is freshly generated after BOTAN_BLINDING_REINIT_INTERVAL calls to blind(). BOTAN_BLINDING_REINIT_INTERVAL = 0 means a fresh nonce is only generated once. On every other call, an updated nonce is used for blinding: k' = k*k mod n.

Parameters

x	value to blind

Returns

blinded value

Definition at line 33 of file blinding.cpp.

                                           {
   ++m_counter;
 
   if((BOTAN_BLINDING_REINIT_INTERVAL > 0) && (m_counter > BOTAN_BLINDING_REINIT_INTERVAL)) {
      const BigInt k = blinding_nonce();
      m_e = m_fwd_fn(k);
      m_d = m_inv_fn(k);
      m_counter = 0;
   } else {
      m_e = m_reducer.square(m_e);
      m_d = m_reducer.square(m_d);
   }
 
   return m_reducer.multiply(i, m_e);
}

References BOTAN_BLINDING_REINIT_INTERVAL, Botan::Modular_Reducer::multiply(), and Botan::Modular_Reducer::square().

operator=()

Blinder & Botan::Blinder::operator= ( const Blinder & )

delete

rng()

RandomNumberGenerator & Botan::Blinder::rng ( ) const

inline

Definition at line 63 of file blinding.h.

{ return m_rng; }

unblind()

BigInt Botan::Blinder::unblind

(

const BigInt &

x

)

const

Unblind a value.

Parameters

x	value to unblind

Returns

unblinded value

Definition at line 49 of file blinding.cpp.

                                             {
   return m_reducer.multiply(i, m_d);
}

References Botan::Modular_Reducer::multiply().

---

The documentation for this class was generated from the following files:

• src/lib/pubkey/blinding/blinding.h
• src/lib/pubkey/blinding/blinding.cpp