elliptic-curve 0.14.0

General purpose Elliptic Curve Cryptography (ECC) support, including traits and generic types for representing various elliptic curve forms, scalars, points, and public/secret keys composed thereof.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

//! Development-related functionality.
//!
//! Helpers and types for writing tests against concrete implementations of
//! the traits in this crate.

pub mod mock_curve;

#[deprecated(
    since = "0.14.0",
    note = "import these types from the `dev::mock_curves` module"
)]
pub use mock_curve::*;

/// Write a series of `criterion`-based benchmarks for arithmetic on a projective curve point.
#[macro_export]
macro_rules! bench_projective {
    ($name:ident, $point_type:ty, $point_a:expr, $point_b:expr, $scalar:expr) => {
        fn bench_add<M: ::criterion::measurement::Measurement>(
            group: &mut ::criterion::BenchmarkGroup<'_, M>,
        ) {
            let x = core::hint::black_box($point_a);
            let y = core::hint::black_box($point_b);
            group.bench_function("add", |b| b.iter(|| x + y));
        }

        fn bench_sub<M: ::criterion::measurement::Measurement>(
            group: &mut ::criterion::BenchmarkGroup<'_, M>,
        ) {
            let x = core::hint::black_box($point_a);
            let y = core::hint::black_box($point_b);
            group.bench_function("sub", |b| b.iter(|| x - y));
        }

        fn bench_neg<M: ::criterion::measurement::Measurement>(
            group: &mut ::criterion::BenchmarkGroup<'_, M>,
        ) {
            let x = core::hint::black_box($point_a);
            group.bench_function("neg", |b| b.iter(|| -x));
        }

        fn bench_point_mul<M: ::criterion::measurement::Measurement>(
            group: &mut ::criterion::BenchmarkGroup<'_, M>,
        ) {
            let p = core::hint::black_box($point_a);
            let s = core::hint::black_box($scalar);
            group.bench_function("point-scalar mul", |b| b.iter(|| p * s));
        }

        fn bench_point_mul_by_generator<M: ::criterion::measurement::Measurement>(
            group: &mut ::criterion::BenchmarkGroup<'_, M>,
        ) {
            use $crate::{group::Group, ops::MulByGeneratorVartime};

            let s = core::hint::black_box($scalar);
            group.bench_function("generator-scalar mul", |b| {
                b.iter(|| ProjectivePoint::mul_by_generator(&s))
            });
            group.bench_function("generator-scalar mul (variable-time)", |b| {
                b.iter(|| ProjectivePoint::mul_by_generator_vartime(&s))
            });
        }

        pub fn $name(c: &mut ::criterion::Criterion) {
            let mut group = c.benchmark_group(stringify!($point_type));
            bench_add(&mut group);
            bench_sub(&mut group);
            bench_neg(&mut group);
            bench_point_mul(&mut group);
            bench_point_mul_by_generator(&mut group);
            group.finish();
        }
    };
}