use crate::{Field, FieldError, FieldParameters, LegendreSymbol, One, PrimeField, SquareRootField, Zero};
use snarkvm_utilities::{
biginteger::{arithmetic as fa, BigInteger as _BigInteger, BigInteger256 as BigInteger},
bytes::{FromBytes, ToBytes},
serialize::CanonicalDeserialize,
};
use std::{
cmp::{Ord, Ordering, PartialOrd},
fmt::{Debug, Display, Formatter, Result as FmtResult},
io::{Read, Result as IoResult, Write},
marker::PhantomData,
ops::{Add, AddAssign, Div, DivAssign, Mul, MulAssign, Neg, Sub, SubAssign},
str::FromStr,
};
pub trait Fp256Parameters: FieldParameters<BigInteger = BigInteger> {}
#[derive(Derivative)]
#[derivative(
Default(bound = ""),
Hash(bound = ""),
Clone(bound = ""),
Copy(bound = ""),
PartialEq(bound = ""),
Eq(bound = "")
)]
pub struct Fp256<P>(
pub BigInteger,
#[derivative(Debug = "ignore")]
#[doc(hidden)]
pub PhantomData<P>,
);
impl<P: Fp256Parameters> Fp256<P> {
#[inline]
pub fn new(element: BigInteger) -> Self {
Fp256::<P>(element, PhantomData)
}
#[inline]
fn is_valid(&self) -> bool {
self.0 < P::MODULUS
}
#[inline]
fn reduce(&mut self) {
if !self.is_valid() {
self.0.sub_noborrow(&P::MODULUS);
}
}
#[inline]
#[allow(clippy::too_many_arguments)]
fn mont_reduce(
&mut self,
r0: u64,
mut r1: u64,
mut r2: u64,
mut r3: u64,
mut r4: u64,
mut r5: u64,
mut r6: u64,
mut r7: u64,
) {
let k = r0.wrapping_mul(P::INV);
let mut carry = 0;
fa::mac_with_carry(r0, k, P::MODULUS.0[0], &mut carry);
r1 = fa::mac_with_carry(r1, k, P::MODULUS.0[1], &mut carry);
r2 = fa::mac_with_carry(r2, k, P::MODULUS.0[2], &mut carry);
r3 = fa::mac_with_carry(r3, k, P::MODULUS.0[3], &mut carry);
r4 = fa::adc(r4, 0, &mut carry);
let carry2 = carry;
let k = r1.wrapping_mul(P::INV);
let mut carry = 0;
fa::mac_with_carry(r1, k, P::MODULUS.0[0], &mut carry);
r2 = fa::mac_with_carry(r2, k, P::MODULUS.0[1], &mut carry);
r3 = fa::mac_with_carry(r3, k, P::MODULUS.0[2], &mut carry);
r4 = fa::mac_with_carry(r4, k, P::MODULUS.0[3], &mut carry);
r5 = fa::adc(r5, carry2, &mut carry);
let carry2 = carry;
let k = r2.wrapping_mul(P::INV);
let mut carry = 0;
fa::mac_with_carry(r2, k, P::MODULUS.0[0], &mut carry);
r3 = fa::mac_with_carry(r3, k, P::MODULUS.0[1], &mut carry);
r4 = fa::mac_with_carry(r4, k, P::MODULUS.0[2], &mut carry);
r5 = fa::mac_with_carry(r5, k, P::MODULUS.0[3], &mut carry);
r6 = fa::adc(r6, carry2, &mut carry);
let carry2 = carry;
let k = r3.wrapping_mul(P::INV);
let mut carry = 0;
fa::mac_with_carry(r3, k, P::MODULUS.0[0], &mut carry);
r4 = fa::mac_with_carry(r4, k, P::MODULUS.0[1], &mut carry);
r5 = fa::mac_with_carry(r5, k, P::MODULUS.0[2], &mut carry);
r6 = fa::mac_with_carry(r6, k, P::MODULUS.0[3], &mut carry);
r7 = fa::adc(r7, carry2, &mut carry);
(self.0).0[0] = r4;
(self.0).0[1] = r5;
(self.0).0[2] = r6;
(self.0).0[3] = r7;
self.reduce();
}
}
impl<P: Fp256Parameters> Zero for Fp256<P> {
#[inline]
fn zero() -> Self {
Fp256::<P>(BigInteger::from(0), PhantomData)
}
#[inline]
fn is_zero(&self) -> bool {
self.0.is_zero()
}
}
impl<P: Fp256Parameters> One for Fp256<P> {
#[inline]
fn one() -> Self {
Fp256::<P>(P::R, PhantomData)
}
#[inline]
fn is_one(&self) -> bool {
self == &Self::one()
}
}
impl<P: Fp256Parameters> Field for Fp256<P> {
impl_field_from_random_bytes_with_flags!(4);
#[inline]
fn double(&self) -> Self {
let mut temp = *self;
temp.double_in_place();
temp
}
#[inline]
fn double_in_place(&mut self) -> &mut Self {
self.0.mul2();
self.reduce();
self
}
#[inline]
fn characteristic<'a>() -> &'a [u64] {
P::MODULUS.as_ref()
}
#[inline]
fn square(&self) -> Self {
let mut temp = *self;
temp.square_in_place();
temp
}
#[inline]
fn square_in_place(&mut self) -> &mut Self {
let mut carry = 0;
let r1 = fa::mac_with_carry(0, (self.0).0[0], (self.0).0[1], &mut carry);
let r2 = fa::mac_with_carry(0, (self.0).0[0], (self.0).0[2], &mut carry);
let r3 = fa::mac_with_carry(0, (self.0).0[0], (self.0).0[3], &mut carry);
let r4 = carry;
let mut carry = 0;
let r3 = fa::mac_with_carry(r3, (self.0).0[1], (self.0).0[2], &mut carry);
let r4 = fa::mac_with_carry(r4, (self.0).0[1], (self.0).0[3], &mut carry);
let r5 = carry;
let mut carry = 0;
let r5 = fa::mac_with_carry(r5, (self.0).0[2], (self.0).0[3], &mut carry);
let r6 = carry;
let r7 = r6 >> 63;
let r6 = (r6 << 1) | (r5 >> 63);
let r5 = (r5 << 1) | (r4 >> 63);
let r4 = (r4 << 1) | (r3 >> 63);
let r3 = (r3 << 1) | (r2 >> 63);
let r2 = (r2 << 1) | (r1 >> 63);
let r1 = r1 << 1;
let mut carry = 0;
let r0 = fa::mac_with_carry(0, (self.0).0[0], (self.0).0[0], &mut carry);
let r1 = fa::adc(r1, 0, &mut carry);
let r2 = fa::mac_with_carry(r2, (self.0).0[1], (self.0).0[1], &mut carry);
let r3 = fa::adc(r3, 0, &mut carry);
let r4 = fa::mac_with_carry(r4, (self.0).0[2], (self.0).0[2], &mut carry);
let r5 = fa::adc(r5, 0, &mut carry);
let r6 = fa::mac_with_carry(r6, (self.0).0[3], (self.0).0[3], &mut carry);
let r7 = fa::adc(r7, 0, &mut carry);
self.mont_reduce(r0, r1, r2, r3, r4, r5, r6, r7);
self
}
#[inline]
fn inverse(&self) -> Option<Self> {
if self.is_zero() {
None
} else {
let one = BigInteger::from(1);
let mut u = self.0;
let mut v = P::MODULUS;
let mut b = Fp256::<P>(P::R2, PhantomData);
let mut c = Self::zero();
while u != one && v != one {
while u.is_even() {
u.div2();
if b.0.is_even() {
b.0.div2();
} else {
b.0.add_nocarry(&P::MODULUS);
b.0.div2();
}
}
while v.is_even() {
v.div2();
if c.0.is_even() {
c.0.div2();
} else {
c.0.add_nocarry(&P::MODULUS);
c.0.div2();
}
}
if v < u {
u.sub_noborrow(&v);
b.sub_assign(&c);
} else {
v.sub_noborrow(&u);
c.sub_assign(&b);
}
}
if u == one { Some(b) } else { Some(c) }
}
}
fn inverse_in_place(&mut self) -> Option<&mut Self> {
if let Some(inverse) = self.inverse() {
*self = inverse;
Some(self)
} else {
None
}
}
#[inline]
fn frobenius_map(&mut self, _: usize) {
}
}
impl<P: Fp256Parameters> PrimeField for Fp256<P> {
type BigInteger = BigInteger;
type Parameters = P;
#[inline]
fn from_repr(r: BigInteger) -> Option<Self> {
let mut r = Fp256(r, PhantomData);
if r.is_zero() {
Some(r)
} else if r.is_valid() {
r *= &Fp256(P::R2, PhantomData);
Some(r)
} else {
None
}
}
#[inline]
fn into_repr(&self) -> BigInteger {
let mut r = *self;
r.mont_reduce((self.0).0[0], (self.0).0[1], (self.0).0[2], (self.0).0[3], 0, 0, 0, 0);
r.0
}
#[inline]
fn from_repr_raw(r: BigInteger) -> Self {
let r = Fp256(r, PhantomData);
if r.is_valid() { r } else { Self::zero() }
}
#[inline]
fn into_repr_raw(&self) -> BigInteger {
let r = *self;
r.0
}
#[inline]
fn multiplicative_generator() -> Self {
Fp256::<P>(P::GENERATOR, PhantomData)
}
#[inline]
fn root_of_unity() -> Self {
Fp256::<P>(P::ROOT_OF_UNITY, PhantomData)
}
}
impl<P: Fp256Parameters> SquareRootField for Fp256<P> {
#[inline]
fn legendre(&self) -> LegendreSymbol {
use crate::LegendreSymbol::*;
let mut s = self.pow(P::MODULUS_MINUS_ONE_DIV_TWO);
s.reduce();
if s.is_zero() {
Zero
} else if s.is_one() {
QuadraticResidue
} else {
QuadraticNonResidue
}
}
#[inline]
fn sqrt(&self) -> Option<Self> {
sqrt_impl!(Self, P, self)
}
fn sqrt_in_place(&mut self) -> Option<&mut Self> {
if let Some(sqrt) = self.sqrt() {
*self = sqrt;
Some(self)
} else {
None
}
}
}
impl_prime_field_from_int!(Fp256, u128, Fp256Parameters);
impl_prime_field_from_int!(Fp256, u64, Fp256Parameters);
impl_prime_field_from_int!(Fp256, u32, Fp256Parameters);
impl_prime_field_from_int!(Fp256, u16, Fp256Parameters);
impl_prime_field_from_int!(Fp256, u8, Fp256Parameters);
impl_prime_field_standard_sample!(Fp256, Fp256Parameters);
impl<P: Fp256Parameters> ToBytes for Fp256<P> {
#[inline]
fn write<W: Write>(&self, writer: W) -> IoResult<()> {
self.into_repr().write(writer)
}
}
impl<P: Fp256Parameters> FromBytes for Fp256<P> {
#[inline]
fn read<R: Read>(reader: R) -> IoResult<Self> {
BigInteger::read(reader).and_then(|b| match Self::from_repr(b) {
Some(f) => Ok(f),
None => Err(FieldError::InvalidFieldElement.into()),
})
}
}
impl<P: Fp256Parameters> Ord for Fp256<P> {
#[inline(always)]
fn cmp(&self, other: &Self) -> Ordering {
self.into_repr().cmp(&other.into_repr())
}
}
impl<P: Fp256Parameters> PartialOrd for Fp256<P> {
#[inline(always)]
fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
Some(self.cmp(other))
}
}
impl<P: Fp256Parameters> FromStr for Fp256<P> {
type Err = FieldError;
fn from_str(s: &str) -> Result<Self, Self::Err> {
if s.is_empty() {
return Err(FieldError::ParsingEmptyString);
}
if s == "0" {
return Ok(Self::zero());
}
let mut res = Self::zero();
let ten = Self::from_repr(<Self as PrimeField>::BigInteger::from(10)).ok_or(FieldError::InvalidFieldElement)?;
let mut first_digit = true;
for c in s.chars() {
match c.to_digit(10) {
Some(c) => {
if first_digit {
if c == 0 {
return Err(FieldError::InvalidString);
}
first_digit = false;
}
res.mul_assign(&ten);
res.add_assign(
&Self::from_repr(<Self as PrimeField>::BigInteger::from(u64::from(c)))
.ok_or(FieldError::InvalidFieldElement)?,
);
}
None => {
return Err(FieldError::ParsingNonDigitCharacter);
}
}
}
if !res.is_valid() {
Err(FieldError::InvalidFieldElement)
} else {
Ok(res)
}
}
}
impl<P: Fp256Parameters> Debug for Fp256<P> {
#[inline]
fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
write!(f, "Fp256({})", self.into_repr())
}
}
impl<P: Fp256Parameters> Display for Fp256<P> {
#[inline]
fn fmt(&self, f: &mut Formatter<'_>) -> FmtResult {
write!(f, "{}", self.into_repr())
}
}
impl<P: Fp256Parameters> Neg for Fp256<P> {
type Output = Self;
#[inline]
#[must_use]
fn neg(self) -> Self {
if !self.is_zero() {
let mut tmp = P::MODULUS;
tmp.sub_noborrow(&self.0);
Fp256::<P>(tmp, PhantomData)
} else {
self
}
}
}
impl<'a, P: Fp256Parameters> Add<&'a Fp256<P>> for Fp256<P> {
type Output = Self;
#[inline]
fn add(self, other: &Self) -> Self {
let mut result = self;
result.add_assign(other);
result
}
}
impl<'a, P: Fp256Parameters> Sub<&'a Fp256<P>> for Fp256<P> {
type Output = Self;
#[inline]
fn sub(self, other: &Self) -> Self {
let mut result = self;
result.sub_assign(other);
result
}
}
impl<'a, P: Fp256Parameters> Mul<&'a Fp256<P>> for Fp256<P> {
type Output = Self;
#[inline]
fn mul(self, other: &Self) -> Self {
let mut result = self;
result.mul_assign(other);
result
}
}
impl<'a, P: Fp256Parameters> Div<&'a Fp256<P>> for Fp256<P> {
type Output = Self;
#[inline]
fn div(self, other: &Self) -> Self {
let mut result = self;
result.mul_assign(&other.inverse().unwrap());
result
}
}
impl<'a, P: Fp256Parameters> AddAssign<&'a Self> for Fp256<P> {
#[inline]
fn add_assign(&mut self, other: &Self) {
self.0.add_nocarry(&other.0);
self.reduce();
}
}
impl<'a, P: Fp256Parameters> SubAssign<&'a Self> for Fp256<P> {
#[inline]
fn sub_assign(&mut self, other: &Self) {
if other.0 > self.0 {
self.0.add_nocarry(&P::MODULUS);
}
self.0.sub_noborrow(&other.0);
}
}
impl<'a, P: Fp256Parameters> MulAssign<&'a Self> for Fp256<P> {
#[inline]
fn mul_assign(&mut self, other: &Self) {
let mut carry = 0;
let r0 = fa::mac_with_carry(0, (self.0).0[0], (other.0).0[0], &mut carry);
let r1 = fa::mac_with_carry(0, (self.0).0[0], (other.0).0[1], &mut carry);
let r2 = fa::mac_with_carry(0, (self.0).0[0], (other.0).0[2], &mut carry);
let r3 = fa::mac_with_carry(0, (self.0).0[0], (other.0).0[3], &mut carry);
let r4 = carry;
let mut carry = 0;
let r1 = fa::mac_with_carry(r1, (self.0).0[1], (other.0).0[0], &mut carry);
let r2 = fa::mac_with_carry(r2, (self.0).0[1], (other.0).0[1], &mut carry);
let r3 = fa::mac_with_carry(r3, (self.0).0[1], (other.0).0[2], &mut carry);
let r4 = fa::mac_with_carry(r4, (self.0).0[1], (other.0).0[3], &mut carry);
let r5 = carry;
let mut carry = 0;
let r2 = fa::mac_with_carry(r2, (self.0).0[2], (other.0).0[0], &mut carry);
let r3 = fa::mac_with_carry(r3, (self.0).0[2], (other.0).0[1], &mut carry);
let r4 = fa::mac_with_carry(r4, (self.0).0[2], (other.0).0[2], &mut carry);
let r5 = fa::mac_with_carry(r5, (self.0).0[2], (other.0).0[3], &mut carry);
let r6 = carry;
let mut carry = 0;
let r3 = fa::mac_with_carry(r3, (self.0).0[3], (other.0).0[0], &mut carry);
let r4 = fa::mac_with_carry(r4, (self.0).0[3], (other.0).0[1], &mut carry);
let r5 = fa::mac_with_carry(r5, (self.0).0[3], (other.0).0[2], &mut carry);
let r6 = fa::mac_with_carry(r6, (self.0).0[3], (other.0).0[3], &mut carry);
let r7 = carry;
self.mont_reduce(r0, r1, r2, r3, r4, r5, r6, r7);
}
}
impl<'a, P: Fp256Parameters> DivAssign<&'a Self> for Fp256<P> {
#[inline]
fn div_assign(&mut self, other: &Self) {
self.mul_assign(&other.inverse().unwrap());
}
}