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

//! Field element encoding support.

use crate::Curve;
use array::{Array, typenum::Unsigned};
use bigint::{ArrayEncoding, ByteOrder, Encoding};

/// Size of serialized field elements of this elliptic curve.
pub type FieldBytesSize<C> = <C as Curve>::FieldBytesSize;

/// Byte representation of a base/scalar field element of a given curve.
pub type FieldBytes<C> = Array<u8, FieldBytesSize<C>>;

/// Decode the provided [`FieldBytes`] as an integer.
///
/// Note that the resulting integer is the raw representation of the given `bytes` and is not
/// reduced by any modulus.
pub fn bytes_to_uint<C: Curve>(bytes: &FieldBytes<C>) -> C::Uint {
    C::Uint::from_slice_truncated(bytes, modulus_bits::<C>(), C::FIELD_ENDIANNESS)
}

/// Encode the provided integer as [`FieldBytes`].
///
/// Note that the output may be truncated if it overflows the width of [`FieldBytes`].
pub fn uint_to_bytes<C: Curve>(uint: &C::Uint) -> FieldBytes<C> {
    let field_bytes_len = FieldBytesSize::<C>::USIZE;
    let uint_bytes_len = <<C as Curve>::Uint as ArrayEncoding>::ByteSize::USIZE;
    debug_assert!(field_bytes_len <= uint_bytes_len);

    let mut field_bytes = FieldBytes::<C>::default();
    match C::FIELD_ENDIANNESS {
        ByteOrder::BigEndian => {
            let offset = uint_bytes_len.saturating_sub(field_bytes_len);
            field_bytes.copy_from_slice(&uint.to_be_byte_array()[offset..]);
        }
        ByteOrder::LittleEndian => {
            field_bytes.copy_from_slice(&uint.to_le_byte_array()[..field_bytes_len]);
        }
    }

    field_bytes
}

// TODO(tarcieri): store full bit precision of the modulus on `Curve`
#[allow(clippy::cast_possible_truncation)]
const fn modulus_bits<C: Curve>() -> u32 {
    (FieldBytesSize::<C>::USIZE * 8) as u32
}