rscrypto 0.1.1

Pure Rust cryptography, hardware-accelerated: BLAKE3, SHA-2/3, AES-GCM, ChaCha20-Poly1305, Ed25519, X25519, HMAC, HKDF, Argon2, CRC. no_std, WASM, ten CPU architectures.
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

//! Shared Edwards25519 arithmetic used by both Ed25519 and X25519.
//!
//! X25519 public-key derivation is fixed-base scalar multiplication on the
//! same Curve25519 basepoint. Reuse the Ed25519 basepoint machinery instead of
//! maintaining a second precompute stack for the identical scalar-mul problem.

#[allow(dead_code)]
#[path = "ed25519/constants.rs"]
pub(crate) mod constants;
#[allow(dead_code)]
#[path = "ed25519/field.rs"]
pub(crate) mod field;
#[cfg(target_arch = "x86_64")]
#[allow(dead_code)]
#[path = "ed25519/field_avx2.rs"]
pub(crate) mod field_avx2;
#[cfg(target_arch = "x86_64")]
#[allow(dead_code)]
#[path = "ed25519/field_ifma.rs"]
pub(crate) mod field_ifma;
#[allow(dead_code)]
#[path = "ed25519/point.rs"]
pub(crate) mod point;
#[cfg(target_arch = "x86_64")]
#[allow(dead_code)]
#[path = "ed25519/point_avx2.rs"]
pub(crate) mod point_avx2;
#[allow(dead_code)]
#[path = "ed25519/scalar.rs"]
pub(crate) mod scalar;

/// Dispatch `[s]B` (fixed-base scalar mul) to the fastest available path.
#[must_use]
pub(crate) fn basepoint_mul_dispatch(scalar_bytes: &[u8; 32]) -> point::ExtendedPoint {
  #[cfg(target_arch = "x86_64")]
  {
    let caps = crate::platform::caps();
    if caps.has(crate::platform::caps::x86::AVX512IFMA)
      && caps.has(crate::platform::caps::x86::AVX512VL)
      && caps.has(crate::platform::caps::x86::AVX2)
    {
      // SAFETY: AVX-512 IFMA + VL + AVX2 confirmed by runtime detection.
      return unsafe { point_avx2::scalar_mul_basepoint_ifma(scalar_bytes) };
    }
    if caps.has(crate::platform::caps::x86::AVX2) {
      // SAFETY: AVX2 confirmed by runtime detection.
      return unsafe { point_avx2::scalar_mul_basepoint_avx2(scalar_bytes) };
    }
  }
  point::ExtendedPoint::scalar_mul_basepoint(scalar_bytes)
}