generic-ec 0.5.0

General elliptic curve cryptography
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

//! Accessing backend library representation of point/scalar
//!
//! > You don't normally need to use traits from this module
//!
//! `Point<E>` and `Scalar<E>` provide convenient interface for doing EC arithmetic, while wrapping
//! `E::Point` and `E::Scalar` which actually implement EC arithmetic. You may want to access
//! wrapped `E::Point` and `E::Scalar` if you lack some functionality that cannot be implemented
//! on top of `Point<E>` and `Scalar<E>`.

use subtle::CtOption;

/// Accesses backend library representation of the point/scalar
pub trait AsRaw
where
    Self: Sized,
{
    /// Wrapped point/scalar
    type Raw;

    /// Returns reference to wrapped value
    fn as_raw(&self) -> &Self::Raw;
}

/// Constructs a point/scalar from its backend library representation
pub trait TryFromRaw: AsRaw {
    /// Wraps raw value
    ///
    /// Returns `None` if value doesn't meet wrapper constraints
    fn try_from_raw(raw: Self::Raw) -> Option<Self> {
        Self::ct_try_from_raw(raw).into()
    }
    /// Wraps raw value (constant time)
    ///
    /// Returns `None` if value doesn't meet wrapper constraints
    fn ct_try_from_raw(raw: Self::Raw) -> CtOption<Self>;
}

/// Constructs a point/scalar from its backend library representation when conversion can be done infallibly
pub trait FromRaw: AsRaw {
    /// Infallibly wraps raw value
    fn from_raw(raw: Self::Raw) -> Self;
}