Struct SecretPoint 

pub struct SecretPoint<E: Curve>(/* private fields */);

Point representing sensitive information (like a derived secret)

Secret point should be treated with an extra care. You shouldn’t do any branching (e.g. Eq, Ord) on the secret to avoid timing side-channel attacks, so it implements only constant time traits (like ConstantTimeEq).

Also, when alloc feature is enabled, we enforce extra measures:

• Secret point leaves no trace in RAM after it’s dropped
  Memory is zeroized after use
• All clones of a secret point refer to the same region in the memory
  I.e. there will always be only one instance of the point in the memory no matter how many clones you make

All these guarantees can be bypassed by calling .as_ref() and obtaining &Point<E> that is not protected from timing attacks, leaving traces in the memory, etc.

Implementations

impl<E: Curve> SecretPoint<E>

pub fn new(point: &mut Point<E>) -> Self

Constructs a new secret point

Takes the original point by mutable reference instead of taking by value to avoid leaving copies of the point on stack. Point behind the reference will be zeroized after the function has returned.

pub fn generator() -> Self

Returns the generator defined in the curve specs

pub fn zero() -> Self

Returns identity point $\O$

pub fn as_nonsecret(&self) -> &Point<E>

Obtain the reference to the point, which you can use for any operations necessary. This bypasses all the secrecy guarantees, so be careful when handling the resulting value; ideally this reference should not be held for longer than one expression

The AsRef impl uses this method under the hood, and is provided as a less explicit but very convenient alternative

pub fn to_bytes(&self, compressed: bool) -> EncodedSecretPoint<E>

Encodes a point as bytes

pub fn from_bytes(bytes: &[u8]) -> Result<Self, InvalidPoint>

Decodes a point from bytes

Trait Implementations

impl<E: Curve> Add<&Generator<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &Generator<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&Generator<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &Generator<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&NonZero<Point<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &NonZero<Point<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&NonZero<Point<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &NonZero<Point<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&NonZero<SecretPoint<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &NonZero<SecretPoint<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&NonZero<SecretPoint<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &NonZero<SecretPoint<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&Point<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &Point<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&Point<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &Point<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for Point<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for &Point<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for Generator<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for &Generator<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for &NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<&SecretPoint<E>> for &NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<Generator<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: Generator<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<Generator<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: Generator<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<NonZero<Point<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: NonZero<Point<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<NonZero<Point<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: NonZero<Point<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<NonZero<SecretPoint<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: NonZero<SecretPoint<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<NonZero<SecretPoint<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: NonZero<SecretPoint<E>>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<Point<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: Point<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<Point<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: Point<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for Point<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for &Point<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for Generator<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for &Generator<E>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for &NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> Add<SecretPoint<E>> for &NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the + operator.

fn add(self, rhs: SecretPoint<E>) -> Self::Output

Performs the + operation.

impl<E: Curve> AddAssign<&SecretPoint<E>> for Point<E>

fn add_assign(&mut self, rhs: &SecretPoint<E>)

Performs the += operation.

impl<E: Curve> AddAssign<SecretPoint<E>> for Point<E>

fn add_assign(&mut self, rhs: SecretPoint<E>)

Performs the += operation.

impl<E: Curve> AsRef<Point<E>> for SecretPoint<E>

fn as_ref(&self) -> &Point<E>

Converts this type into a shared reference of the (usually inferred) input type.

impl<E: Curve> Clone for SecretPoint<E>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<E: Curve> ConstantTimeEq for SecretPoint<E>

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

Determine if two items are equal.

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

Determine if two items are NOT equal.

impl<E: Curve> Debug for SecretPoint<E>

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

Formats the value using the given formatter.

impl<'de, E: Curve> Deserialize<'de> for SecretPoint<E>

Available on crate feature serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, E: Curve> DeserializeAs<'de, SecretPoint<E>> for Compact

Available on crate feature serde only.

fn deserialize_as<D>(deserializer: D) -> Result<SecretPoint<E>, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<E: Curve> From<NonZero<SecretPoint<E>>> for SecretPoint<E>

fn from(secret_point: NonZero<SecretPoint<E>>) -> Self

Converts to this type from the input type.

impl<E: Curve> Mul<&NonZero<Scalar<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &NonZero<Scalar<E>>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&NonZero<Scalar<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &NonZero<Scalar<E>>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&Scalar<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&Scalar<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&SecretPoint<E>> for Scalar<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&SecretPoint<E>> for &Scalar<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&SecretPoint<E>> for NonZero<Scalar<E>>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<&SecretPoint<E>> for &NonZero<Scalar<E>>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<NonZero<Scalar<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: NonZero<Scalar<E>>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<NonZero<Scalar<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: NonZero<Scalar<E>>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<Scalar<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<Scalar<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<SecretPoint<E>> for Scalar<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<SecretPoint<E>> for &Scalar<E>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<SecretPoint<E>> for NonZero<Scalar<E>>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Mul<SecretPoint<E>> for &NonZero<Scalar<E>>

type Output = Point<E>

The resulting type after applying the * operator.

fn mul(self, rhs: SecretPoint<E>) -> Self::Output

Performs the * operation.

impl<E: Curve> Serialize for SecretPoint<E>

Available on crate feature serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<E: Curve> SerializeAs<SecretPoint<E>> for Compact

Available on crate feature serde only.

fn serialize_as<S>( source: &SecretPoint<E>, serializer: S, ) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<E: Curve> Sub<&Generator<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &Generator<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&Generator<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &Generator<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&NonZero<Point<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &NonZero<Point<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&NonZero<Point<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &NonZero<Point<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&NonZero<SecretPoint<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &NonZero<SecretPoint<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&NonZero<SecretPoint<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &NonZero<SecretPoint<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&Point<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &Point<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&Point<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &Point<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for Point<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for &Point<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for Generator<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for &Generator<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for &NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<&SecretPoint<E>> for &NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: &SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<Generator<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: Generator<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<Generator<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: Generator<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<NonZero<Point<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: NonZero<Point<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<NonZero<Point<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: NonZero<Point<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<NonZero<SecretPoint<E>>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: NonZero<SecretPoint<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<NonZero<SecretPoint<E>>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: NonZero<SecretPoint<E>>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<Point<E>> for SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: Point<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<Point<E>> for &SecretPoint<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: Point<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for Point<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for &Point<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for Generator<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for &Generator<E>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for &NonZero<Point<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> Sub<SecretPoint<E>> for &NonZero<SecretPoint<E>>

type Output = Point<E>

The resulting type after applying the - operator.

fn sub(self, rhs: SecretPoint<E>) -> Self::Output

Performs the - operation.

impl<E: Curve> SubAssign<&SecretPoint<E>> for Point<E>

fn sub_assign(&mut self, rhs: &SecretPoint<E>)

Performs the -= operation.

impl<E: Curve> SubAssign<SecretPoint<E>> for Point<E>

fn sub_assign(&mut self, rhs: SecretPoint<E>)

Performs the -= operation.

impl<'s, E: Curve> Sum<&'s NonZero<SecretPoint<E>>> for SecretPoint<E>

fn sum<I: Iterator<Item = &'s NonZero<SecretPoint<E>>>>(iter: I) -> Self

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

impl<'s, E: Curve> Sum<&'s SecretPoint<E>> for Point<E>

fn sum<I: Iterator<Item = &'s SecretPoint<E>>>(iter: I) -> Self

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

impl<E: Curve> Sum<NonZero<SecretPoint<E>>> for SecretPoint<E>

fn sum<I: Iterator<Item = NonZero<SecretPoint<E>>>>(iter: I) -> Self

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

impl<E: Curve> Sum<SecretPoint<E>> for Point<E>

fn sum<I: Iterator<Item = SecretPoint<E>>>(iter: I) -> Self

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

impl<E: Curve> TryFrom<SecretPoint<E>> for NonZero<SecretPoint<E>>

type Error = ZeroPoint

The type returned in the event of a conversion error.

fn try_from(secret_point: SecretPoint<E>) -> Result<Self, Self::Error>

Performs the conversion.