Struct jubjub::AffinePoint
source · [−]pub struct AffinePoint { /* private fields */ }
Expand description
This represents a Jubjub point in the affine (u, v)
coordinates.
Implementations
sourceimpl AffinePoint
impl AffinePoint
sourcepub fn is_identity(&self) -> Choice
pub fn is_identity(&self) -> Choice
Determines if this point is the identity.
sourcepub fn mul_by_cofactor(&self) -> ExtendedPoint
pub fn mul_by_cofactor(&self) -> ExtendedPoint
Multiplies this point by the cofactor, producing an
ExtendedPoint
sourcepub fn is_small_order(&self) -> Choice
pub fn is_small_order(&self) -> Choice
Determines if this point is of small order.
sourcepub fn is_torsion_free(&self) -> Choice
pub fn is_torsion_free(&self) -> Choice
Determines if this point is torsion free and so is in the prime order subgroup.
sourcepub fn is_prime_order(&self) -> Choice
pub fn is_prime_order(&self) -> Choice
Determines if this point is prime order, or in other words that
the smallest scalar multiplied by this point that produces the
identity is r
. This is equivalent to checking that the point
is both torsion free and not the identity.
sourcepub fn from_bytes(b: [u8; 32]) -> CtOption<Self>
pub fn from_bytes(b: [u8; 32]) -> CtOption<Self>
Attempts to interpret a byte representation of an affine point, failing if the element is not on the curve or non-canonical.
sourcepub fn from_bytes_pre_zip216_compatibility(b: [u8; 32]) -> CtOption<Self>
pub fn from_bytes_pre_zip216_compatibility(b: [u8; 32]) -> CtOption<Self>
Attempts to interpret a byte representation of an affine point, failing if the element is not on the curve.
Most non-canonical encodings will also cause a failure. However, this API preserves (for use in consensus-critical protocols) a bug in the parsing code that caused two non-canonical encodings to be silently accepted:
- (0, 1), which is the identity;
- (0, -1), which is a point of order two.
Each of these has a single non-canonical encoding in which the value of the sign bit is 1.
See ZIP 216 for a more detailed description of the bug, as well as its fix.
sourcepub fn batch_from_bytes(
items: impl Iterator<Item = [u8; 32]>
) -> Vec<CtOption<Self>>
pub fn batch_from_bytes(
items: impl Iterator<Item = [u8; 32]>
) -> Vec<CtOption<Self>>
Attempts to interpret a batch of byte representations of affine points.
Returns None for each element if it is not on the curve, or is non-canonical according to ZIP 216.
sourcepub const fn to_extended(&self) -> ExtendedPoint
pub const fn to_extended(&self) -> ExtendedPoint
Returns an ExtendedPoint
for use in arithmetic operations.
sourcepub const fn to_niels(&self) -> AffineNielsPoint
pub const fn to_niels(&self) -> AffineNielsPoint
Performs a pre-processing step that produces an AffineNielsPoint
for use in multiple additions.
sourcepub const fn from_raw_unchecked(u: Fq, v: Fq) -> AffinePoint
pub const fn from_raw_unchecked(u: Fq, v: Fq) -> AffinePoint
Constructs an AffinePoint given u
and v
without checking
that the point is on the curve.
Trait Implementations
sourceimpl<'a, 'b> Add<&'b AffinePoint> for &'a ExtendedPoint
impl<'a, 'b> Add<&'b AffinePoint> for &'a ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the +
operator.
sourcefn add(self, other: &'b AffinePoint) -> ExtendedPoint
fn add(self, other: &'b AffinePoint) -> ExtendedPoint
Performs the +
operation. Read more
sourceimpl<'b> Add<&'b AffinePoint> for ExtendedPoint
impl<'b> Add<&'b AffinePoint> for ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the +
operator.
sourcefn add(self, rhs: &'b AffinePoint) -> ExtendedPoint
fn add(self, rhs: &'b AffinePoint) -> ExtendedPoint
Performs the +
operation. Read more
sourceimpl<'a> Add<AffinePoint> for &'a ExtendedPoint
impl<'a> Add<AffinePoint> for &'a ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the +
operator.
sourcefn add(self, rhs: AffinePoint) -> ExtendedPoint
fn add(self, rhs: AffinePoint) -> ExtendedPoint
Performs the +
operation. Read more
sourceimpl Add<AffinePoint> for ExtendedPoint
impl Add<AffinePoint> for ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the +
operator.
sourcefn add(self, rhs: AffinePoint) -> ExtendedPoint
fn add(self, rhs: AffinePoint) -> ExtendedPoint
Performs the +
operation. Read more
sourceimpl<'b> AddAssign<&'b AffinePoint> for ExtendedPoint
impl<'b> AddAssign<&'b AffinePoint> for ExtendedPoint
sourcefn add_assign(&mut self, rhs: &'b AffinePoint)
fn add_assign(&mut self, rhs: &'b AffinePoint)
Performs the +=
operation. Read more
sourceimpl AddAssign<AffinePoint> for ExtendedPoint
impl AddAssign<AffinePoint> for ExtendedPoint
sourcefn add_assign(&mut self, rhs: AffinePoint)
fn add_assign(&mut self, rhs: AffinePoint)
Performs the +=
operation. Read more
sourceimpl Clone for AffinePoint
impl Clone for AffinePoint
sourcefn clone(&self) -> AffinePoint
fn clone(&self) -> AffinePoint
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl CofactorCurveAffine for AffinePoint
impl CofactorCurveAffine for AffinePoint
type Scalar = Fr
type Curve = ExtendedPoint
sourcefn is_identity(&self) -> Choice
fn is_identity(&self) -> Choice
Determines if this point represents the point at infinity; the additive identity. Read more
sourceimpl ConditionallySelectable for AffinePoint
impl ConditionallySelectable for AffinePoint
sourceimpl ConstantTimeEq for AffinePoint
impl ConstantTimeEq for AffinePoint
sourceimpl Debug for AffinePoint
impl Debug for AffinePoint
sourceimpl Default for AffinePoint
impl Default for AffinePoint
sourcefn default() -> AffinePoint
fn default() -> AffinePoint
Returns the identity.
sourceimpl Display for AffinePoint
impl Display for AffinePoint
sourceimpl<'a> From<&'a ExtendedPoint> for AffinePoint
impl<'a> From<&'a ExtendedPoint> for AffinePoint
sourcefn from(extended: &'a ExtendedPoint) -> AffinePoint
fn from(extended: &'a ExtendedPoint) -> AffinePoint
Constructs an affine point from an extended point
using the map (U, V, Z, T1, T2) => (U/Z, V/Z)
as Z is always nonzero. This requires a field inversion
and so it is recommended to perform these in a batch
using batch_normalize
instead.
sourceimpl From<AffinePoint> for ExtendedPoint
impl From<AffinePoint> for ExtendedPoint
sourcefn from(affine: AffinePoint) -> ExtendedPoint
fn from(affine: AffinePoint) -> ExtendedPoint
Constructs an extended point (with Z = 1
) from
an affine point using the map (u, v) => (u, v, 1, u, v)
.
sourceimpl From<ExtendedPoint> for AffinePoint
impl From<ExtendedPoint> for AffinePoint
sourcefn from(extended: ExtendedPoint) -> AffinePoint
fn from(extended: ExtendedPoint) -> AffinePoint
Converts to this type from the input type.
sourceimpl GroupEncoding for AffinePoint
impl GroupEncoding for AffinePoint
sourcefn from_bytes(bytes: &Self::Repr) -> CtOption<Self>
fn from_bytes(bytes: &Self::Repr) -> CtOption<Self>
Attempts to deserialize a group element from its encoding.
sourcefn from_bytes_unchecked(bytes: &Self::Repr) -> CtOption<Self>
fn from_bytes_unchecked(bytes: &Self::Repr) -> CtOption<Self>
Attempts to deserialize a group element, not checking if the element is valid. Read more
sourceimpl<'a, 'b> Mul<&'b Fr> for &'a AffinePoint
impl<'a, 'b> Mul<&'b Fr> for &'a AffinePoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the *
operator.
sourcefn mul(self, other: &'b Fr) -> ExtendedPoint
fn mul(self, other: &'b Fr) -> ExtendedPoint
Performs the *
operation. Read more
sourceimpl<'b> Mul<&'b Fr> for AffinePoint
impl<'b> Mul<&'b Fr> for AffinePoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the *
operator.
sourcefn mul(self, rhs: &'b Fr) -> ExtendedPoint
fn mul(self, rhs: &'b Fr) -> ExtendedPoint
Performs the *
operation. Read more
sourceimpl<'a> Mul<Fr> for &'a AffinePoint
impl<'a> Mul<Fr> for &'a AffinePoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the *
operator.
sourcefn mul(self, rhs: Fr) -> ExtendedPoint
fn mul(self, rhs: Fr) -> ExtendedPoint
Performs the *
operation. Read more
sourceimpl Mul<Fr> for AffinePoint
impl Mul<Fr> for AffinePoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the *
operator.
sourcefn mul(self, rhs: Fr) -> ExtendedPoint
fn mul(self, rhs: Fr) -> ExtendedPoint
Performs the *
operation. Read more
sourceimpl Neg for AffinePoint
impl Neg for AffinePoint
sourcefn neg(self) -> AffinePoint
fn neg(self) -> AffinePoint
This computes the negation of a point P = (u, v)
as -P = (-u, v)
.
type Output = AffinePoint
type Output = AffinePoint
The resulting type after applying the -
operator.
sourceimpl PartialEq<AffinePoint> for AffinePoint
impl PartialEq<AffinePoint> for AffinePoint
sourceimpl<'a, 'b> Sub<&'b AffinePoint> for &'a ExtendedPoint
impl<'a, 'b> Sub<&'b AffinePoint> for &'a ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the -
operator.
sourcefn sub(self, other: &'b AffinePoint) -> ExtendedPoint
fn sub(self, other: &'b AffinePoint) -> ExtendedPoint
Performs the -
operation. Read more
sourceimpl<'b> Sub<&'b AffinePoint> for ExtendedPoint
impl<'b> Sub<&'b AffinePoint> for ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the -
operator.
sourcefn sub(self, rhs: &'b AffinePoint) -> ExtendedPoint
fn sub(self, rhs: &'b AffinePoint) -> ExtendedPoint
Performs the -
operation. Read more
sourceimpl<'a> Sub<AffinePoint> for &'a ExtendedPoint
impl<'a> Sub<AffinePoint> for &'a ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the -
operator.
sourcefn sub(self, rhs: AffinePoint) -> ExtendedPoint
fn sub(self, rhs: AffinePoint) -> ExtendedPoint
Performs the -
operation. Read more
sourceimpl Sub<AffinePoint> for ExtendedPoint
impl Sub<AffinePoint> for ExtendedPoint
type Output = ExtendedPoint
type Output = ExtendedPoint
The resulting type after applying the -
operator.
sourcefn sub(self, rhs: AffinePoint) -> ExtendedPoint
fn sub(self, rhs: AffinePoint) -> ExtendedPoint
Performs the -
operation. Read more
sourceimpl<'b> SubAssign<&'b AffinePoint> for ExtendedPoint
impl<'b> SubAssign<&'b AffinePoint> for ExtendedPoint
sourcefn sub_assign(&mut self, rhs: &'b AffinePoint)
fn sub_assign(&mut self, rhs: &'b AffinePoint)
Performs the -=
operation. Read more
sourceimpl SubAssign<AffinePoint> for ExtendedPoint
impl SubAssign<AffinePoint> for ExtendedPoint
sourcefn sub_assign(&mut self, rhs: AffinePoint)
fn sub_assign(&mut self, rhs: AffinePoint)
Performs the -=
operation. Read more
impl Copy for AffinePoint
impl Eq for AffinePoint
impl StructuralEq for AffinePoint
Auto Trait Implementations
impl RefUnwindSafe for AffinePoint
impl Send for AffinePoint
impl Sync for AffinePoint
impl Unpin for AffinePoint
impl UnwindSafe for AffinePoint
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T> FmtForward for T
impl<T> FmtForward for T
fn fmt_binary(self) -> FmtBinary<Self> where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self> where
Self: Binary,
Causes self
to use its Binary
implementation when Debug
-formatted. Read more
fn fmt_display(self) -> FmtDisplay<Self> where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self> where
Self: Display,
Causes self
to use its Display
implementation when
Debug
-formatted. Read more
fn fmt_lower_exp(self) -> FmtLowerExp<Self> where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self> where
Self: LowerExp,
Causes self
to use its LowerExp
implementation when
Debug
-formatted. Read more
fn fmt_lower_hex(self) -> FmtLowerHex<Self> where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self> where
Self: LowerHex,
Causes self
to use its LowerHex
implementation when
Debug
-formatted. Read more
fn fmt_octal(self) -> FmtOctal<Self> where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self> where
Self: Octal,
Causes self
to use its Octal
implementation when Debug
-formatted. Read more
fn fmt_pointer(self) -> FmtPointer<Self> where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self> where
Self: Pointer,
Causes self
to use its Pointer
implementation when
Debug
-formatted. Read more
fn fmt_upper_exp(self) -> FmtUpperExp<Self> where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self> where
Self: UpperExp,
Causes self
to use its UpperExp
implementation when
Debug
-formatted. Read more
fn fmt_upper_hex(self) -> FmtUpperHex<Self> where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self> where
Self: UpperHex,
Causes self
to use its UpperHex
implementation when
Debug
-formatted. Read more
fn fmt_list(self) -> FmtList<Self> where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self> where
&'a Self: for<'a> IntoIterator,
Formats each item in a sequence. Read more
impl<T> Pipe for T where
T: ?Sized,
impl<T> Pipe for T where
T: ?Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
Pipes by value. This is generally the method you want to use. Read more
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where
R: 'a,
Borrows self
and passes that borrow into the pipe function. Read more
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where
R: 'a,
Mutably borrows self
and passes that borrow into the pipe function. Read more
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R where
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R where
Self: Borrow<B>,
B: 'a + ?Sized,
R: 'a,
Borrows self
, then passes self.borrow()
into the pipe function. Read more
fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R where
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,
fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R where
Self: BorrowMut<B>,
B: 'a + ?Sized,
R: 'a,
Mutably borrows self
, then passes self.borrow_mut()
into the pipe
function. Read more
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R where
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R where
Self: AsRef<U>,
U: 'a + ?Sized,
R: 'a,
Borrows self
, then passes self.as_ref()
into the pipe function.
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R where
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R where
Self: AsMut<U>,
U: 'a + ?Sized,
R: 'a,
Mutably borrows self
, then passes self.as_mut()
into the pipe
function. Read more
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Deref<Target = T>,
T: 'a + ?Sized,
R: 'a,
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Deref<Target = T>,
T: 'a + ?Sized,
R: 'a,
Borrows self
, then passes self.deref()
into the pipe function.
impl<T> Tap for T
impl<T> Tap for T
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,
Immutable access to the Borrow<B>
of a value. Read more
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,
Mutable access to the BorrowMut<B>
of a value. Read more
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,
Immutable access to the AsRef<R>
view of a value. Read more
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,
Mutable access to the AsMut<R>
view of a value. Read more
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self where
Self: Deref<Target = T>,
T: ?Sized,
Immutable access to the Deref::Target
of a value. Read more
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self where
Self: DerefMut<Target = T> + Deref,
T: ?Sized,
Mutable access to the Deref::Target
of a value. Read more
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
Calls .tap()
only in debug builds, and is erased in release builds.
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
Calls .tap_mut()
only in debug builds, and is erased in release
builds. Read more
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self where
Self: Borrow<B>,
B: ?Sized,
Calls .tap_borrow()
only in debug builds, and is erased in release
builds. Read more
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self where
Self: BorrowMut<B>,
B: ?Sized,
Calls .tap_borrow_mut()
only in debug builds, and is erased in release
builds. Read more
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self where
Self: AsRef<R>,
R: ?Sized,
Calls .tap_ref()
only in debug builds, and is erased in release
builds. Read more
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self where
Self: AsMut<R>,
R: ?Sized,
Calls .tap_ref_mut()
only in debug builds, and is erased in release
builds. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more