mirror of
https://github.com/saymrwulf/betrusted-curve25519-dalek-source.git
synced 2026-09-06 20:41:11 +00:00
90b69c13ee
This reverts commit804dab8924, reversing changes made to5d15ca77ff. This is due to a (previously undocumented) contract on the behaviours of (potentially unreduced mod \ell) "packed" scalars w.r.t. to the manner in which their bytes are interpreted. Upon documentation fixes and corresponding fixes being made on top of the floodyberry/optimized_scalar branch, this revert will again be reverted and then the additional changes merged (à la file:///usr/share/doc/git/html/howto/revert-a-faulty-merge.html). Signed-off-by: Isis Lovecruft <isis@patternsinthevoid.net>
91 lines
2.7 KiB
Rust
91 lines
2.7 KiB
Rust
// -*- mode: rust; -*-
|
|
//
|
|
// This file is part of curve25519-dalek.
|
|
// Copyright (c) 2016-2017 Isis Lovecruft, Henry de Valence
|
|
// See LICENSE for licensing information.
|
|
//
|
|
// Authors:
|
|
// - Isis Agora Lovecruft <isis@patternsinthevoid.net>
|
|
// - Henry de Valence <hdevalence@hdevalence.ca>
|
|
|
|
#![cfg_attr(not(feature = "std"), no_std)]
|
|
#![cfg_attr(feature = "alloc", feature(alloc))]
|
|
#![cfg_attr(feature = "nightly", feature(i128_type))]
|
|
#![cfg_attr(feature = "bench", feature(test))]
|
|
#![cfg_attr(all(feature = "nightly", feature = "std"), feature(zero_one))]
|
|
|
|
#![allow(unused_features)]
|
|
#![deny(missing_docs)] // refuse to compile if documentation is missing
|
|
|
|
//! # curve25519-dalek
|
|
//!
|
|
//! **A Rust implementation of field and group operations on an Edwards curve
|
|
//! over GF(2^255 - 19).**
|
|
//!
|
|
//! **[SPOILER ALERT]** The Twelfth Doctor's first encounter with the Daleks is
|
|
//! in his second full episode, "Into the Dalek". A beleaguered ship of the
|
|
//! "Combined Galactic Resistance" has discovered a broken Dalek that has
|
|
//! turned "good", desiring to kill all other Daleks. The Doctor, Clara and a
|
|
//! team of soldiers are miniaturized and enter the Dalek, which the Doctor
|
|
//! names Rusty. They repair the damage, but accidentally restore it to its
|
|
//! original nature, causing it to go on the rampage and alert the Dalek fleet
|
|
//! to the whereabouts of the rebel ship. However, the Doctor manages to
|
|
//! return Rusty to its previous state by linking his mind with the Dalek's:
|
|
//! Rusty shares the Doctor's view of the universe's beauty, but also his deep
|
|
//! hatred of the Daleks. Rusty destroys the other Daleks and departs the
|
|
//! ship, determined to track down and bring an end to the Dalek race.
|
|
|
|
#[cfg(all(test, feature = "bench"))]
|
|
extern crate test;
|
|
|
|
#[cfg(test)]
|
|
extern crate sha2;
|
|
|
|
#[macro_use]
|
|
extern crate arrayref;
|
|
|
|
extern crate generic_array;
|
|
extern crate digest;
|
|
extern crate subtle;
|
|
|
|
#[cfg(feature = "serde")]
|
|
extern crate serde;
|
|
#[cfg(all(test, feature = "serde"))]
|
|
extern crate serde_cbor;
|
|
|
|
#[cfg(feature = "std")]
|
|
extern crate core;
|
|
|
|
#[cfg(feature = "std")]
|
|
extern crate rand;
|
|
|
|
#[cfg(feature = "alloc")]
|
|
extern crate alloc;
|
|
|
|
// Modules for low-level operations directly on field elements and curve points.
|
|
|
|
pub mod field;
|
|
#[cfg(not(feature="radix_51"))]
|
|
mod field_32bit;
|
|
#[cfg(feature="radix_51")]
|
|
mod field_64bit;
|
|
|
|
pub mod scalar;
|
|
pub mod edwards;
|
|
pub mod montgomery;
|
|
|
|
// Feature gate decaf while our implementation is unfinished and probably incorrect.
|
|
#[cfg(feature = "yolocrypto")]
|
|
pub mod decaf;
|
|
|
|
// Other miscelaneous utilities.
|
|
|
|
pub mod utils;
|
|
|
|
// Low-level curve and point constants, as well as pre-computed curve group elements.
|
|
|
|
pub mod constants;
|
|
#[cfg(not(feature="radix_51"))]
|
|
mod constants_32bit;
|
|
#[cfg(feature="radix_51")]
|
|
mod constants_64bit;
|