Struct ScalarCore

pub struct ScalarCore<C: Curve> { /* private fields */ }

Generic scalar type with core functionality.

This type provides a baseline level of scalar arithmetic functionality which is always available for all curves, regardless of if they implement any arithmetic traits.

serde support

When the optional serde feature of this create is enabled, Serialize and Deserialize impls are provided for this type.

The serialization is a fixed-width big endian encoding. When used with textual formats, the binary data is encoded as hexadecimal.

Implementations

impl<C> ScalarCore<C>

where C: Curve,

pub const ZERO: Self = _

Zero scalar.

pub const ONE: Self = _

Multiplicative identity.

pub const MODULUS: C::UInt = C::ORDER

Scalar modulus.

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

Generate a random ScalarCore.

pub fn new(uint: C::UInt) -> CtOption<Self>

Create a new scalar from Curve::UInt.

pub fn from_be_bytes(bytes: FieldBytes<C>) -> CtOption<Self>

Decode ScalarCore from big endian bytes.

pub fn from_be_slice(slice: &[u8]) -> Result<Self>

Decode ScalarCore from a big endian byte slice.

pub fn from_le_bytes(bytes: FieldBytes<C>) -> CtOption<Self>

Decode ScalarCore from little endian bytes.

pub fn from_le_slice(slice: &[u8]) -> Result<Self>

Decode ScalarCore from a little endian byte slice.

pub fn as_uint(&self) -> &C::UInt

Borrow the inner C::UInt.

pub fn as_limbs(&self) -> &[Limb]

Borrow the inner limbs as a slice.

pub fn is_zero(&self) -> Choice

Is this ScalarCore value equal to zero?

pub fn is_even(&self) -> Choice

Is this ScalarCore value even?

pub fn is_odd(&self) -> Choice

Is this ScalarCore value odd?

pub fn to_be_bytes(self) -> FieldBytes<C>

Encode ScalarCore as big endian bytes.

pub fn to_le_bytes(self) -> FieldBytes<C>

Encode ScalarCore as little endian bytes.

Trait Implementations

impl<C> Add<&ScalarCore<C>> for ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<C> Add for ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self

Performs the + operation.

impl<C> AddAssign<&ScalarCore<C>> for ScalarCore<C>

where C: Curve,

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

Performs the += operation.

impl<C> AddAssign for ScalarCore<C>

where C: Curve,

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<C> AsRef<[Limb]> for ScalarCore<C>

where C: Curve,

fn as_ref(&self) -> &[Limb]

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

impl<C: Clone + Curve> Clone for ScalarCore<C>

where C::UInt: Clone,

fn clone(&self) -> ScalarCore<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> ConditionallySelectable for ScalarCore<C>

where C: Curve,

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<C> ConstantTimeEq for ScalarCore<C>

where C: Curve,

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

Determine if two items are equal.

impl<C> ConstantTimeGreater for ScalarCore<C>

where C: Curve,

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

Determine whether self > other.

impl<C> ConstantTimeLess for ScalarCore<C>

where C: Curve,

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

Determine whether self < other.

impl<C: Debug + Curve> Debug for ScalarCore<C>

where C::UInt: Debug,

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

Formats the value using the given formatter.

impl<C: Default + Curve> Default for ScalarCore<C>

where C::UInt: Default,

fn default() -> ScalarCore<C>

Returns the “default value” for a type.

impl<'de, C> Deserialize<'de> for ScalarCore<C>

where C: Curve,

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<C> Display for ScalarCore<C>

where C: Curve,

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

Formats the value using the given formatter.

impl<C> From<&NonZeroScalar<C>> for ScalarCore<C>

where C: Curve + ScalarArithmetic,

fn from(scalar: &NonZeroScalar<C>) -> ScalarCore<C>

Converts to this type from the input type.

impl<C> From<NonZeroScalar<C>> for ScalarCore<C>

where C: Curve + ScalarArithmetic,

fn from(scalar: NonZeroScalar<C>) -> ScalarCore<C>

Converts to this type from the input type.

impl<C> From<u64> for ScalarCore<C>

where C: Curve,

fn from(n: u64) -> Self

Converts to this type from the input type.

impl<C> FromStr for ScalarCore<C>

where C: Curve,

type Err = Error

The associated error which can be returned from parsing.

fn from_str(hex: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl<C> IsHigh for ScalarCore<C>

where C: Curve,

fn is_high(&self) -> Choice

Is this scalar greater than or equal to n / 2?

impl<C> LowerHex for ScalarCore<C>

where C: Curve,

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

Formats the value using the given formatter.

impl<C> Neg for &ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the - operator.

fn neg(self) -> ScalarCore<C>

Performs the unary - operation.

impl<C> Neg for ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl<C> Ord for ScalarCore<C>

where C: Curve,

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<C> PartialEq for ScalarCore<C>

where C: Curve,

fn eq(&self, other: &Self) -> 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<C> PartialOrd for ScalarCore<C>

where C: Curve,

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<C> Serialize for ScalarCore<C>

where C: Curve,

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<C> Sub<&ScalarCore<C>> for ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<C> Sub for ScalarCore<C>

where C: Curve,

type Output = ScalarCore<C>

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Self

Performs the - operation.

impl<C> SubAssign<&ScalarCore<C>> for ScalarCore<C>

where C: Curve,

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

Performs the -= operation.

impl<C> SubAssign for ScalarCore<C>

where C: Curve,

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl<C> UpperHex for ScalarCore<C>

where C: Curve,

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

Formats the value using the given formatter.

impl<C: Copy + Curve> Copy for ScalarCore<C>

where C::UInt: Copy,

impl<C: Curve> DefaultIsZeroes for ScalarCore<C>

impl<C: Curve> Eq for ScalarCore<C>