Struct DecafPoint 

pub struct DecafPoint(pub(crate) ExtendedPoint);

A Decaf point in the Twisted Edwards curve

Tuple Fields

0: ExtendedPoint

Implementations

impl DecafPoint

pub const GENERATOR: DecafPoint

The generator point

pub const IDENTITY: DecafPoint

The identity point

pub fn is_identity(&self) -> Choice

Check if the point is the identity

pub fn add(&self, other: &DecafPoint) -> DecafPoint

Add two points

pub fn sub(&self, other: &DecafPoint) -> DecafPoint

Subtract two points

pub fn compress(&self) -> CompressedDecaf

Compress this point

pub fn from_uniform_bytes(bytes: &[u8; 112]) -> Self

Construct a DecafPoint from 112 bytes of data.

If the input bytes are uniformly distributed, the resulting point will be uniformly distributed over the group, and its discrete log with respect to other points is unknown.

Implements map to curve according see https://datatracker.ietf.org/doc/rfc9380/ section 5.3.4 by splitting the input into two 56-byte halves, then applies the decaf448_map to each, and adds the results.

pub fn random(rng: impl CryptoRng) -> Self

👎Deprecated since 0.14.0: use the Generate trait instead

DEPRECATED: Return a DecafPoint chosen uniformly at random using a user-provided RNG.

Use the Generate trait instead.

Trait Implementations

impl Add<&AffinePoint> for &DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: &DecafAffinePoint) -> Self::Output

Performs the + operation.

impl<'b> Add<&'b AffinePoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: &'b DecafAffinePoint) -> DecafPoint

Performs the + operation.

impl Add<&DecafPoint> for &DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: &DecafPoint) -> Self::Output

Performs the + operation.

impl Add<&DecafPoint> for &DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, other: &DecafPoint) -> DecafPoint

Performs the + operation.

impl<'b> Add<&'b DecafPoint> for DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: &'b DecafPoint) -> DecafPoint

Performs the + operation.

impl<'b> Add<&'b DecafPoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: &'b DecafPoint) -> DecafPoint

Performs the + operation.

impl<'a> Add<AffinePoint> for &'a DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafAffinePoint) -> DecafPoint

Performs the + operation.

impl Add<AffinePoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafAffinePoint) -> DecafPoint

Performs the + operation.

impl<'a> Add<DecafPoint> for &'a DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafPoint) -> DecafPoint

Performs the + operation.

impl<'a> Add<DecafPoint> for &'a DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafPoint) -> DecafPoint

Performs the + operation.

impl Add<DecafPoint> for DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafPoint) -> DecafPoint

Performs the + operation.

impl Add for DecafPoint

type Output = DecafPoint

The resulting type after applying the + operator.

fn add(self, rhs: DecafPoint) -> DecafPoint

Performs the + operation.

impl AddAssign<&AffinePoint> for DecafPoint

fn add_assign(&mut self, other: &DecafAffinePoint)

Performs the += operation.

impl AddAssign<&DecafPoint> for DecafAffinePoint

fn add_assign(&mut self, rhs: &DecafPoint)

Performs the += operation.

impl AddAssign<&DecafPoint> for DecafPoint

fn add_assign(&mut self, other: &DecafPoint)

Performs the += operation.

impl AddAssign<AffinePoint> for DecafPoint

fn add_assign(&mut self, rhs: DecafAffinePoint)

Performs the += operation.

impl AddAssign<DecafPoint> for DecafAffinePoint

fn add_assign(&mut self, rhs: DecafPoint)

Performs the += operation.

impl AddAssign for DecafPoint

fn add_assign(&mut self, other: DecafPoint)

Performs the += operation.

impl Clone for DecafPoint

fn clone(&self) -> DecafPoint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CofactorGroup for DecafPoint

type Subgroup = DecafPoint

The large prime-order subgroup in which cryptographic operations are performed. If Self implements PrimeGroup, then Self::Subgroup may be Self.

fn clear_cofactor(&self) -> Self::Subgroup

Maps self to the prime-order subgroup by multiplying this element by some k-multiple of the cofactor.

fn into_subgroup(self) -> CtOption<Self::Subgroup>

Returns self if it is contained in the prime-order subgroup.

fn is_torsion_free(&self) -> Choice

Determines if this element is “torsion free”, i.e., is contained in the prime-order subgroup.

fn is_small_order(&self) -> Choice

Determines if this element is of small order.

impl ConditionallySelectable for DecafPoint

fn conditional_select(a: &Self, b: &Self, choice: Choice) -> Self

Select a or b according to choice.

fn conditional_assign(&mut self, other: &Self, choice: Choice)

Conditionally assign other to self, according to choice.

fn conditional_swap(a: &mut Self, b: &mut Self, choice: Choice)

Conditionally swap self and other if choice == 1; otherwise, reassign both unto themselves.

impl ConstantTimeEq for DecafPoint

fn ct_eq(&self, other: &DecafPoint) -> Choice

Determine if two items are equal.

fn ct_ne(&self, other: &Self) -> Choice

Determine if two items are NOT equal.

impl CtEq for DecafPoint

fn ct_eq(&self, other: &Self) -> Choice

Determine if self is equal to other in constant-time.

fn ct_ne(&self, other: &Rhs) -> Choice

Determine if self is NOT equal to other in constant-time.

impl CtSelect for DecafPoint

fn ct_select(&self, other: &Self, choice: Choice) -> Self

Select between self and other based on choice, returning a copy of the value.

fn ct_swap(&mut self, other: &mut Self, choice: Choice)

Conditionally swap self and other if choice is Choice::TRUE.

impl Curve for DecafPoint

type Affine = AffinePoint

The affine representation for this elliptic curve.

fn to_affine(&self) -> Self::Affine

Converts this element into its affine representation.

fn batch_normalize(p: &[Self], q: &mut [Self::Affine])

Converts a batch of projective elements into affine elements. This function will panic if p.len() != q.len().

impl Debug for DecafPoint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DecafPoint

fn default() -> Self

Returns the “default value” for a type.

impl Display for DecafPoint

fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl From<&AffinePoint> for DecafPoint

fn from(point: &DecafAffinePoint) -> Self

Converts to this type from the input type.

impl From<&DecafPoint> for [u8; 56]

fn from(compressed: &DecafPoint) -> [u8; 56]

Converts to this type from the input type.

impl From<&DecafPoint> for DecafAffinePoint

fn from(point: &DecafPoint) -> Self

Converts to this type from the input type.

impl From<&DecafPoint> for EdwardsPoint

fn from(point: &DecafPoint) -> Self

Converts to this type from the input type.

impl From<&DecafPoint> for Vec<u8>

Available on crate feature alloc only.

fn from(point: &DecafPoint) -> Vec<u8>

Converts to this type from the input type.

impl From<&EdwardsPoint> for DecafPoint

fn from(point: &EdwardsPoint) -> Self

Converts to this type from the input type.

impl From<AffinePoint> for DecafPoint

fn from(point: DecafAffinePoint) -> Self

Converts to this type from the input type.

impl From<DecafPoint> for [u8; 56]

fn from(point: DecafPoint) -> [u8; 56]

Converts to this type from the input type.

impl From<DecafPoint> for DecafAffinePoint

fn from(point: DecafPoint) -> Self

Converts to this type from the input type.

impl From<DecafPoint> for EdwardsPoint

fn from(point: DecafPoint) -> Self

Converts to this type from the input type.

impl From<DecafPoint> for Vec<u8>

Available on crate feature alloc only.

fn from(compressed: DecafPoint) -> Vec<u8>

Converts to this type from the input type.

impl From<EdwardsPoint> for DecafPoint

fn from(point: EdwardsPoint) -> Self

Converts to this type from the input type.

impl From<NonIdentity<DecafPoint>> for DecafPoint

fn from(decaf: NonIdentity<DecafPoint>) -> Self

Converts to this type from the input type.

impl Generate for DecafPoint

fn try_generate_from_rng<R: TryCryptoRng + ?Sized>( rng: &mut R, ) -> Result<Self, R::Error>

Generate random key using the provided TryCryptoRng.

fn generate_from_rng<R>(rng: &mut R) -> Self

where R: CryptoRng + ?Sized,

Generate random key using the provided CryptoRng.

fn try_generate() -> Result<Self, Error>

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

fn generate() -> Self

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

impl Group for DecafPoint

type Scalar = Scalar<Decaf448>

Scalars modulo the order of this group’s scalar field.

fn try_random<R>(rng: &mut R) -> Result<Self, R::Error>

where R: TryRng + ?Sized,

Returns an element chosen uniformly at random from the non-identity elements of this group using a user-provided fallible RNG.

fn identity() -> Self

Returns the additive identity, also known as the “neutral element”.

fn generator() -> Self

Returns a fixed generator of the prime-order subgroup.

fn is_identity(&self) -> Choice

Determines if this point is the identity.

fn double(&self) -> Self

Doubles this element.

fn random<R>(rng: &mut R) -> Self

where R: Rng + ?Sized,

Returns an element chosen uniformly at random from the non-identity elements of this group using a user-provided infallible RNG.

fn mul_by_generator(scalar: &Self::Scalar) -> Self

Multiply by the generator of the prime-order subgroup.

impl GroupEncoding for DecafPoint

type Repr = Array<u8, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B1>, B1>, B0>, B0>, B0>>

The encoding of group elements.

fn from_bytes(bytes: &Self::Repr) -> CtOption<Self>

Attempts to deserialize a group element from its encoding.

fn from_bytes_unchecked(bytes: &Self::Repr) -> CtOption<Self>

Attempts to deserialize a group element, not checking if the element is valid.

fn to_bytes(&self) -> Self::Repr

Converts this element into its byte encoding. This may or may not support encoding the identity.

impl LinearCombination<[(DecafPoint, Scalar<Decaf448>)]> for DecafPoint

fn lincomb(points_and_scalars: &PointsAndScalars) -> Self

Calculates x1 * k1 + ... + xn * kn.

fn lincomb_vartime(points_and_scalars: &PointsAndScalars) -> Self

Calculates x1 * k1 + ... + xn * kn.

impl<const N: usize> LinearCombination<[(DecafPoint, Scalar<Decaf448>); N]> for DecafPoint

fn lincomb(points_and_scalars: &PointsAndScalars) -> Self

Calculates x1 * k1 + ... + xn * kn.

fn lincomb_vartime(points_and_scalars: &PointsAndScalars) -> Self

Calculates x1 * k1 + ... + xn * kn.

impl LowerHex for DecafPoint

fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl Mul<&Scalar<Decaf448>> for &DecafPoint

Scalar Mul Operations

type Output = DecafPoint

The resulting type after applying the * operator.

fn mul(self, scalar: &DecafScalar) -> DecafPoint

Performs the * operation.

impl<'b> Mul<&'b Scalar<Decaf448>> for DecafPoint

type Output = DecafPoint

The resulting type after applying the * operator.

fn mul(self, rhs: &'b DecafScalar) -> DecafPoint

Performs the * operation.

impl<'a> Mul<Scalar<Decaf448>> for &'a DecafPoint

type Output = DecafPoint

The resulting type after applying the * operator.

fn mul(self, rhs: DecafScalar) -> DecafPoint

Performs the * operation.

impl Mul<Scalar<Decaf448>> for DecafPoint

type Output = DecafPoint

The resulting type after applying the * operator.

fn mul(self, rhs: DecafScalar) -> DecafPoint

Performs the * operation.

impl<'s> MulAssign<&'s Scalar<Decaf448>> for DecafPoint

fn mul_assign(&mut self, scalar: &'s DecafScalar)

Performs the *= operation.

impl MulAssign<Scalar<Decaf448>> for DecafPoint

fn mul_assign(&mut self, scalar: DecafScalar)

Performs the *= operation.

impl MulByGeneratorVartime for DecafPoint

fn mul_by_generator_vartime(scalar: &Self::Scalar) -> Self

Multiply by the generator of the prime-order subgroup.

fn mul_by_generator_and_mul_add_vartime( a: &Self::Scalar, b: &Self::Scalar, p: &Self, ) -> Self

Multiply a by the generator of the prime-order subgroup, adding the result to the point P multiplied by the scalar b, i.e. compute aG + bP.

impl MulVartime<&Scalar<Decaf448>> for &DecafPoint

fn mul_vartime(self, scalar: &DecafScalar) -> DecafPoint

Multiply self by rhs in variable-time.

impl MulVartime<&Scalar<Decaf448>> for DecafPoint

fn mul_vartime(self, scalar: &DecafScalar) -> DecafPoint

Multiply self by rhs in variable-time.

impl MulVartime<Scalar<Decaf448>> for DecafPoint

fn mul_vartime(self, scalar: DecafScalar) -> DecafPoint

Multiply self by rhs in variable-time.

impl Neg for &DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn neg(self) -> DecafPoint

Performs the unary - operation.

impl Neg for DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn neg(self) -> DecafPoint

Performs the unary - operation.

impl PartialEq for DecafPoint

fn eq(&self, other: &DecafPoint) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Sub<&AffinePoint> for &DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: &DecafAffinePoint) -> Self::Output

Performs the - operation.

impl<'b> Sub<&'b AffinePoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: &'b DecafAffinePoint) -> DecafPoint

Performs the - operation.

impl Sub<&DecafPoint> for &DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: &DecafPoint) -> Self::Output

Performs the - operation.

impl Sub<&DecafPoint> for &DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, other: &DecafPoint) -> DecafPoint

Performs the - operation.

impl<'b> Sub<&'b DecafPoint> for DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: &'b DecafPoint) -> DecafPoint

Performs the - operation.

impl<'b> Sub<&'b DecafPoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: &'b DecafPoint) -> DecafPoint

Performs the - operation.

impl<'a> Sub<AffinePoint> for &'a DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafAffinePoint) -> DecafPoint

Performs the - operation.

impl Sub<AffinePoint> for DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafAffinePoint) -> DecafPoint

Performs the - operation.

impl<'a> Sub<DecafPoint> for &'a DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafPoint) -> DecafPoint

Performs the - operation.

impl<'a> Sub<DecafPoint> for &'a DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafPoint) -> DecafPoint

Performs the - operation.

impl Sub<DecafPoint> for DecafAffinePoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafPoint) -> DecafPoint

Performs the - operation.

impl Sub for DecafPoint

type Output = DecafPoint

The resulting type after applying the - operator.

fn sub(self, rhs: DecafPoint) -> DecafPoint

Performs the - operation.

impl SubAssign<&AffinePoint> for DecafPoint

fn sub_assign(&mut self, other: &DecafAffinePoint)

Performs the -= operation.

impl SubAssign<&DecafPoint> for DecafAffinePoint

fn sub_assign(&mut self, rhs: &DecafPoint)

Performs the -= operation.

impl SubAssign<&DecafPoint> for DecafPoint

fn sub_assign(&mut self, other: &DecafPoint)

Performs the -= operation.

impl SubAssign<AffinePoint> for DecafPoint

fn sub_assign(&mut self, rhs: DecafAffinePoint)

Performs the -= operation.

impl SubAssign<DecafPoint> for DecafAffinePoint

fn sub_assign(&mut self, rhs: DecafPoint)

Performs the -= operation.

impl SubAssign for DecafPoint

fn sub_assign(&mut self, other: DecafPoint)

Performs the -= operation.

impl<T> Sum<T> for DecafPoint

where T: Borrow<DecafPoint>,

fn sum<I>(iter: I) -> Self

where I: Iterator<Item = T>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<&[u8]> for DecafPoint

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&[u8; 56]> for DecafPoint

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8; 56]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&Vec<u8>> for DecafPoint

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: &Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<[u8; 56]> for DecafPoint

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: [u8; 56]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Box<[u8]>> for DecafPoint

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: Box<[u8]>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<DecafPoint> for NonIdentity<DecafPoint>

The constant-time alternative is available at NonIdentity::new().

type Error = Error

The type returned in the event of a conversion error.

fn try_from(point: DecafPoint) -> Result<Self, Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for DecafPoint

Available on crate feature alloc only.

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(bytes: Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl UpperHex for DecafPoint

fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl Copy for DecafPoint

impl DefaultIsZeroes for DecafPoint

impl Eq for DecafPoint

impl PrimeGroup for DecafPoint