Botan 3.6.1
Crypto and TLS for C&
Botan::EC_Point_Var_Point_Precompute Class Referencefinal

#include <point_mul.h>

Public Member Functions

 EC_Point_Var_Point_Precompute (const EC_Point &point, RandomNumberGenerator &rng, std::vector< BigInt > &ws)
 
EC_Point mul (const BigInt &k, RandomNumberGenerator &rng, const BigInt &group_order, std::vector< BigInt > &ws) const
 

Detailed Description

Definition at line 41 of file point_mul.h.

Constructor & Destructor Documentation

◆ EC_Point_Var_Point_Precompute()

Botan::EC_Point_Var_Point_Precompute::EC_Point_Var_Point_Precompute ( const EC_Point & point,
RandomNumberGenerator & rng,
std::vector< BigInt > & ws )

Definition at line 166 of file point_mul.cpp.

168 :
169 m_curve(ipoint.get_curve()), m_p_words(m_curve.get_p_words()), m_window_bits(4) {
170 if(ws.size() < EC_Point::WORKSPACE_SIZE) {
171 ws.resize(EC_Point::WORKSPACE_SIZE);
172 }
173
174 auto point = ipoint;
175 point.randomize_repr(rng);
176
177 std::vector<EC_Point> U(static_cast<size_t>(1) << m_window_bits);
178 U[0] = point.zero();
179 U[1] = point;
180
181 for(size_t i = 2; i < U.size(); i += 2) {
182 U[i] = U[i / 2].double_of(ws);
183 U[i + 1] = U[i].plus(point, ws);
184 }
185
186 // Hack to handle Blinded_Point_Multiply
187 if(rng.is_seeded()) {
188 // Skipping zero point since it can't be randomized
189 for(size_t i = 1; i != U.size(); ++i) {
190 U[i].randomize_repr(rng);
191 }
192 }
193
194 m_T.resize(U.size() * 3 * m_p_words);
195
196 word* p = &m_T[0];
197 for(size_t i = 0; i != U.size(); ++i) {
198 U[i].get_x().encode_words(p, m_p_words);
199 U[i].get_y().encode_words(p + m_p_words, m_p_words);
200 U[i].get_z().encode_words(p + 2 * m_p_words, m_p_words);
201 p += 3 * m_p_words;
202 }
203}

References Botan::RandomNumberGenerator::is_seeded(), Botan::EC_Point::randomize_repr(), and Botan::EC_Point::WORKSPACE_SIZE.

Member Function Documentation

◆ mul()

EC_Point Botan::EC_Point_Var_Point_Precompute::mul ( const BigInt & k,
RandomNumberGenerator & rng,
const BigInt & group_order,
std::vector< BigInt > & ws ) const

Definition at line 205 of file point_mul.cpp.

208 {
209 if(k.is_negative()) {
210 throw Invalid_Argument("EC_Point_Var_Point_Precompute scalar must be positive");
211 }
212 if(ws.size() < EC_Point::WORKSPACE_SIZE) {
213 ws.resize(EC_Point::WORKSPACE_SIZE);
214 }
215
216 // Choose a small mask m and use k' = k + m*order (Coron's 1st countermeasure)
217 const BigInt scalar = k + group_order * blinding_mask(group_order, rng);
218
219 const size_t elem_size = 3 * m_p_words;
220 const size_t window_elems = static_cast<size_t>(1) << m_window_bits;
221
222 size_t windows = round_up(scalar.bits(), m_window_bits) / m_window_bits;
223 EC_Point R(m_curve);
224 secure_vector<word> e(elem_size);
225
226 if(windows > 0) {
227 windows--;
228
229 const uint32_t w = scalar.get_substring(windows * m_window_bits, m_window_bits);
230
231 clear_mem(e.data(), e.size());
232 for(size_t i = 1; i != window_elems; ++i) {
233 const auto wmask = CT::Mask<word>::is_equal(w, i);
234
235 for(size_t j = 0; j != elem_size; ++j) {
236 e[j] |= wmask.if_set_return(m_T[i * elem_size + j]);
237 }
238 }
239
240 R.add(&e[0], m_p_words, &e[m_p_words], m_p_words, &e[2 * m_p_words], m_p_words, ws);
241
242 /*
243 Randomize after adding the first nibble as before the addition R
244 is zero, and we cannot effectively randomize the point
245 representation of the zero point.
246 */
247 R.randomize_repr(rng, ws[0].get_word_vector());
248 }
249
250 while(windows) {
251 R.mult2i(m_window_bits, ws);
252
253 const uint32_t w = scalar.get_substring((windows - 1) * m_window_bits, m_window_bits);
254
255 clear_mem(e.data(), e.size());
256 for(size_t i = 1; i != window_elems; ++i) {
257 const auto wmask = CT::Mask<word>::is_equal(w, i);
258
259 for(size_t j = 0; j != elem_size; ++j) {
260 e[j] |= wmask.if_set_return(m_T[i * elem_size + j]);
261 }
262 }
263
264 R.add(&e[0], m_p_words, &e[m_p_words], m_p_words, &e[2 * m_p_words], m_p_words, ws);
265
266 windows--;
267 }
268
269 BOTAN_ASSERT_NOMSG(R.on_the_curve());
270
271 return R;
272}
#define BOTAN_ASSERT_NOMSG(expr)
Definition assert.h:59
static constexpr Mask< T > is_equal(T x, T y)
Definition ct_utils.h:434
constexpr size_t round_up(size_t n, size_t align_to)
Definition rounding.h:25
std::vector< T, secure_allocator< T > > secure_vector
Definition secmem.h:61
constexpr void clear_mem(T *ptr, size_t n)
Definition mem_ops.h:120

References Botan::EC_Point::add(), Botan::BigInt::bits(), BOTAN_ASSERT_NOMSG, Botan::clear_mem(), Botan::BigInt::get_substring(), Botan::BigInt::is_negative(), Botan::EC_Point::mult2i(), Botan::EC_Point::on_the_curve(), Botan::EC_Point::randomize_repr(), and Botan::round_up().


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