/src/spdm-rs/external/ring/src/ec/curve25519/scalar.rs
Line | Count | Source (jump to first uncovered line) |
1 | | // Copyright 2015-2019 Brian Smith. |
2 | | // |
3 | | // Permission to use, copy, modify, and/or distribute this software for any |
4 | | // purpose with or without fee is hereby granted, provided that the above |
5 | | // copyright notice and this permission notice appear in all copies. |
6 | | // |
7 | | // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
8 | | // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
9 | | // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY |
10 | | // SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
11 | | // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION |
12 | | // OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN |
13 | | // CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
14 | | |
15 | | use crate::{ |
16 | | arithmetic::limbs_from_hex, |
17 | | digest, error, limb, |
18 | | polyfill::slice::{self, AsChunks}, |
19 | | }; |
20 | | use core::array; |
21 | | |
22 | | #[repr(transparent)] |
23 | | pub struct Scalar([u8; SCALAR_LEN]); |
24 | | |
25 | | pub const SCALAR_LEN: usize = 32; |
26 | | |
27 | | impl Scalar { |
28 | | // Constructs a `Scalar` from `bytes`, failing if `bytes` encodes a scalar |
29 | | // that is not in the range [0, n). |
30 | 0 | pub fn from_bytes_checked(bytes: [u8; SCALAR_LEN]) -> Result<Self, error::Unspecified> { |
31 | | const ORDER: [limb::Limb; SCALAR_LEN / limb::LIMB_BYTES] = |
32 | | limbs_from_hex("1000000000000000000000000000000014def9dea2f79cd65812631a5cf5d3ed"); |
33 | 0 | let order = ORDER.map(limb::Limb::from); |
34 | 0 |
|
35 | 0 | let (limbs_as_bytes, _empty): (AsChunks<u8, { limb::LIMB_BYTES }>, _) = |
36 | 0 | slice::as_chunks(&bytes); |
37 | 0 | debug_assert!(_empty.is_empty()); |
38 | 0 | let limbs: [limb::Limb; SCALAR_LEN / limb::LIMB_BYTES] = |
39 | 0 | array::from_fn(|i| limb::Limb::from_le_bytes(limbs_as_bytes[i])); |
40 | 0 | limb::verify_limbs_less_than_limbs_leak_bit(&limbs, &order)?; |
41 | | |
42 | 0 | Ok(Self(bytes)) |
43 | 0 | } |
44 | | |
45 | | // Constructs a `Scalar` from `digest` reduced modulo n. |
46 | 0 | pub fn from_sha512_digest_reduced(digest: digest::Digest) -> Self { |
47 | 0 | prefixed_extern! { |
48 | 0 | fn x25519_sc_reduce(s: &mut UnreducedScalar); |
49 | 0 | } |
50 | 0 | let mut unreduced = [0u8; digest::SHA512_OUTPUT_LEN]; |
51 | 0 | unreduced.copy_from_slice(digest.as_ref()); |
52 | 0 | unsafe { x25519_sc_reduce(&mut unreduced) }; |
53 | 0 | Self((&unreduced[..SCALAR_LEN]).try_into().unwrap()) |
54 | 0 | } |
55 | | } |
56 | | |
57 | | #[repr(transparent)] |
58 | | pub struct MaskedScalar([u8; SCALAR_LEN]); |
59 | | |
60 | | impl MaskedScalar { |
61 | 0 | pub fn from_bytes_masked(bytes: [u8; SCALAR_LEN]) -> Self { |
62 | 0 | prefixed_extern! { |
63 | 0 | fn x25519_sc_mask(a: &mut [u8; SCALAR_LEN]); |
64 | 0 | } |
65 | 0 | let mut r = Self(bytes); |
66 | 0 | unsafe { x25519_sc_mask(&mut r.0) }; |
67 | 0 | r |
68 | 0 | } |
69 | | } |
70 | | |
71 | | impl From<MaskedScalar> for Scalar { |
72 | 0 | fn from(MaskedScalar(scalar): MaskedScalar) -> Self { |
73 | 0 | Self(scalar) |
74 | 0 | } |
75 | | } |
76 | | |
77 | | type UnreducedScalar = [u8; UNREDUCED_SCALAR_LEN]; |
78 | | const UNREDUCED_SCALAR_LEN: usize = SCALAR_LEN * 2; |