Skip to content

Commit

Permalink
add field generator macros
Browse files Browse the repository at this point in the history
  • Loading branch information
kilic committed May 25, 2024
1 parent f7c6b4c commit b6b05d5
Show file tree
Hide file tree
Showing 43 changed files with 2,440 additions and 5,496 deletions.
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
/target
target
Cargo.lock
**/*.rs.bk
.vscode
Expand Down
4 changes: 3 additions & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ impls = "1"
getrandom = { version = "0.2", features = ["js"] }

[dependencies]
halo2derive = {path = "derive"}
subtle = "2.5"
ff = { version = "0.13.0", default-features = false, features = ["std"] }
group = "0.13.0"
Expand All @@ -35,6 +36,7 @@ rand = "0.8"
rand_core = { version = "0.6", default-features = false }
lazy_static = "1.4.0"
num-bigint = "0.4.3"
num-integer = "0.1.46"
num-traits = "0.2"
paste = "1.0.11"
serde = { version = "1.0", default-features = false, optional = true }
Expand All @@ -48,7 +50,7 @@ digest = "0.10.7"

[features]
default = ["bits"]
asm = []
asm = ["halo2derive/asm"]
bits = ["ff/bits"]
bn256-table = []
derive_serde = ["serde/derive", "serde_arrays", "hex", "pasta_curves/serde"]
Expand Down
19 changes: 19 additions & 0 deletions derive/Cargo.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
[package]
edition = "2021"
name = "halo2derive"
version = "0.1.0"

[lib]
proc-macro = true

[dependencies]
num-bigint = "0.4"
num-integer = "0.1"
num-traits = "0.2"
proc-macro2 = "1.0"
quote = "1.0"
syn = {version = "1.0", features = ["full"]}

[features]
default = []
asm = []
340 changes: 340 additions & 0 deletions derive/src/field/arith.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,340 @@
use proc_macro2::TokenStream;
use quote::format_ident as fmtid;
use quote::quote;

fn select(cond: bool, this: TokenStream, other: TokenStream) -> TokenStream {
if cond {
this
} else {
other
}
}

pub(crate) fn impl_arith(field: &syn::Ident, num_limbs: usize, inv: u64) -> TokenStream {
let impl_add = impl_add(field, num_limbs);
let impl_sub = impl_sub(field, num_limbs);
let impl_neg = impl_neg(field, num_limbs);
let impl_mont = impl_mont(field, num_limbs, inv);
let impl_from_mont = impl_from_mont(field, num_limbs, inv);
let impl_mul = impl_mul(field, num_limbs, false);
let impl_square = impl_square(field, num_limbs);
let wide_num_limbs = num_limbs * 2;
quote::quote! {
impl #field {
#[inline(always)]
pub const fn add(&self, rhs: &Self) -> Self {
#impl_add
}

#[inline]
pub const fn double(&self) -> Self {
self.add(self)
}

#[inline(always)]
pub const fn sub(&self, rhs: &Self) -> Self {
#impl_sub
}

#[inline(always)]
pub const fn neg(&self) -> Self {
#impl_neg
}

#[inline(always)]
pub const fn mul(&self, rhs: &Self) -> Self{
#impl_mul
}

#[inline(always)]
pub const fn square(&self) -> Self{
#impl_square
}

#[inline(always)]
pub(crate) const fn montgomery_reduce(r: &[u64; #wide_num_limbs]) -> Self {
#impl_mont
}

#[inline(always)]
pub(crate) const fn from_mont(&self) -> [u64; #num_limbs] {
#impl_from_mont
}
}
}
}

pub(crate) fn impl_arith_always_const(
field: &syn::Ident,
num_limbs: usize,
inv: u64,
) -> TokenStream {
let impl_sub = impl_sub(field, num_limbs);
let impl_mont = impl_mont(field, num_limbs, inv);
let impl_mul = impl_mul(field, num_limbs, true);
let wide_num_limbs = num_limbs * 2;
quote::quote! {
impl #field {

#[inline(always)]
pub(crate) const fn sub_const(&self, rhs: &Self) -> Self {
#impl_sub
}


#[inline(always)]
pub(crate) const fn mul_const(&self, rhs: &Self) -> Self{
#impl_mul
}

#[inline(always)]
pub(crate) const fn montgomery_reduce_const(r: &[u64; #wide_num_limbs]) -> Self {
#impl_mont
}
}
}
}

fn impl_mul(field: &syn::Ident, num_limbs: usize, constant: bool) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb, mac}; };
for i in 0..num_limbs {
for j in 0..num_limbs {
let r_out = fmtid!("r_{}", i + j);
let r_next = fmtid!("r_{}", i + j + 1);
let r_in = select(i == 0, quote! {0}, quote! {#r_out});
let carry_in = select(j == 0, quote! {0}, quote! {carry});
let carry_out = select(j == num_limbs - 1, quote! {#r_next}, quote! {carry});
gen.extend(
quote! { let (#r_out, #carry_out) = mac(#r_in, self.0[#i], rhs.0[#j], #carry_in); },
);
}
}

let r: Vec<_> = (0..num_limbs * 2).map(|i| fmtid!("r_{}", i)).collect();
let mont_red = if constant {
quote! { #field::montgomery_reduce_const(&[#(#r),*]) }
} else {
quote! { #field::montgomery_reduce(&[#(#r),*]) }
};
quote! {
#gen
#mont_red
}
}

fn impl_square(field: &syn::Ident, num_limbs: usize) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb, mac}; };
for i in 0..num_limbs - 1 {
let start_index = i * 2 + 1;
for j in 0..num_limbs - i - 1 {
let r_out = fmtid!("r_{}", start_index + j);
let r_in = select(i == 0, quote! {0}, quote! {#r_out});
let r_next = fmtid!("r_{}", start_index + j + 1);
let carry_in = select(j == 0, quote! {0}, quote! {carry});
let carry_out = select(j == num_limbs - i - 2, quote! {#r_next}, quote! {carry});
let j = i + j + 1;
gen.extend(quote! { let (#r_out, #carry_out) = mac(#r_in, self.0[#i], self.0[#j], #carry_in); });
}
}

for i in (1..num_limbs * 2).rev() {
let (r_cur, r_next) = (fmtid!("r_{}", i), fmtid!("r_{}", i - 1));
if i == num_limbs * 2 - 1 {
gen.extend(quote! { let #r_cur = #r_next >> 63; });
} else if i == 1 {
gen.extend(quote! { let #r_cur = (#r_cur << 1); });
} else {
gen.extend(quote! { let #r_cur = (#r_cur << 1) | (#r_next >> 63); });
}
}

for i in 0..num_limbs {
let index = i * 2;
let r_cur = fmtid!("r_{}", index);
let r_next = fmtid!("r_{}", index + 1);
let r_cur_in = select(i == 0, quote! {0}, quote! {#r_cur});
let carry_in = select(i == 0, quote! {0}, quote! {carry});
let carry_out = select(i == num_limbs - 1, quote! {_}, quote! {carry});
gen.extend(quote! {
let (#r_cur, carry) = mac(#r_cur_in, self.0[#i], self.0[#i], #carry_in);
let (#r_next, #carry_out) = adc(0, #r_next, carry);
});
}

let r: Vec<_> = (0..num_limbs * 2).map(|i| fmtid!("r_{}", i)).collect();
quote! {
#gen
#field::montgomery_reduce(&[#(#r),*])
}
}

fn impl_add(field: &syn::Ident, num_limbs: usize) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb}; };

(0..num_limbs).for_each(|i| {
let carry = select(i == 0, quote! {0}, quote! {carry});
let d_i = fmtid!("d_{}", i);
gen.extend(quote! { let ( #d_i, carry) = adc(self.0[#i], rhs.0[#i], #carry); });
});

(0..num_limbs).for_each(|i| {
let borrow = select(i == 0, quote! {0}, quote! {borrow});
let d_i = fmtid!("d_{}", i);
gen.extend(quote! { let (#d_i, borrow) = sbb(#d_i, Self::MODULUS_LIMBS[#i], #borrow); });
});
gen.extend(quote! {let (_, borrow) = sbb(carry, 0, borrow);});

(0..num_limbs).for_each(|i| {
let carry_in = select(i == 0, quote! {0}, quote! {carry});
let carry_out = select(i == num_limbs - 1, quote! {_}, quote! {carry});
let d_i = fmtid!("d_{}", i);
gen.extend(
quote! { let (#d_i, #carry_out) = adc(#d_i, Self::MODULUS_LIMBS[#i] & borrow, #carry_in); },
);
});

let ret: Vec<_> = (0..num_limbs).map(|i| fmtid!("d_{}", i)).collect();

quote! {
#gen
#field([#(#ret),*])
}
}

fn impl_sub(field: &syn::Ident, num_limbs: usize) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb}; };

(0..num_limbs).for_each(|i| {
let borrow = select(i == 0, quote! {0}, quote! {borrow});
let d_i = fmtid!("d_{}", i);
gen.extend(quote! { let (#d_i, borrow) = sbb(self.0[#i], rhs.0[#i], #borrow); });
});

(0..num_limbs).for_each(|i| {
let carry_in = select(i == 0, quote! {0}, quote! {carry});
let carry_out = select(i == num_limbs - 1, quote! {_}, quote! {carry});
let d_i = fmtid!("d_{}", i);
gen.extend(
quote! { let (#d_i, #carry_out) = adc(#d_i, Self::MODULUS_LIMBS[#i] & borrow, #carry_in); },
);
});

let ret: Vec<_> = (0..num_limbs).map(|i| fmtid!("d_{}", i)).collect();

quote! {
#gen
#field([#(#ret),*])
}
}

fn impl_neg(field: &syn::Ident, num_limbs: usize) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb}; };

(0..num_limbs).for_each(|i| {
let borrow_in = select(i == 0, quote! {0}, quote! {borrow});
let borrow_out = select(i == num_limbs - 1, quote! {_}, quote! {borrow});
let d_i = fmtid!("d_{}", i);
gen.extend(quote! { let (#d_i, #borrow_out) = sbb(Self::MODULUS_LIMBS[#i], self.0[#i], #borrow_in); })
});

let mask_limbs: Vec<_> = (0..num_limbs)
.map(|i| quote::quote! { self.0[#i] })
.collect();
gen.extend(quote! { let mask = (((#(#mask_limbs)|*) == 0) as u64).wrapping_sub(1); });

let ret: Vec<_> = (0..num_limbs)
.map(|i| {
let d_i = fmtid!("d_{}", i);
quote! { #d_i & mask }
})
.collect();

quote! {
#gen
#field([#(#ret),*])
}
}

fn impl_mont(field: &syn::Ident, num_limbs: usize, inv: u64) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb, mac}; };

for i in 0..num_limbs {
if i == 0 {
gen.extend(quote! { let k = r[0].wrapping_mul(#inv); });

for j in 0..num_limbs {
let r_out = fmtid!("r_{}", j);
let r_out = select(j == 0, quote! {_}, quote! {#r_out});
let carry_in = select(j == 0, quote! {0}, quote! {carry});
gen.extend(quote! { let (#r_out, carry) = mac(r[#j], k, Self::MODULUS_LIMBS[#j], #carry_in); });
}
let r_out = fmtid!("r_{}", num_limbs);
gen.extend(quote! { let (#r_out, carry2) = adc(r[#num_limbs], 0, carry); });
} else {
let r_i = fmtid!("r_{}", i);
gen.extend(quote! { let k = #r_i.wrapping_mul(#inv); });

for j in 0..num_limbs {
let r_in = fmtid!("r_{}", j + i);
let r_out = select(j == 0, quote! {_}, quote! {#r_in});
let carry_in = select(j == 0, quote! {0}, quote! {carry});
gen.extend(quote! { let (#r_out, carry) = mac(#r_in, k, Self::MODULUS_LIMBS[#j], #carry_in); });
}
let idx = num_limbs + i;
let r_out = fmtid!("r_{}", idx);
gen.extend(quote! { let (#r_out, carry2) = adc(r[#idx], carry2, carry); });
}
}

(0..num_limbs).for_each(|i| {
let borrow = select(i == 0, quote! {0}, quote! {borrow});
let d_i = fmtid!("d_{}", i);
let r_in = fmtid!("r_{}", num_limbs + i);
gen.extend(quote! { let (#d_i, borrow) = sbb(#r_in, Self::MODULUS_LIMBS[#i], #borrow); });
});

gen.extend(quote! {let (_, borrow) = sbb(carry2, 0, borrow);});

(0..num_limbs).for_each(|i| {
let carry_in = select(i == 0, quote! {0}, quote! {carry});
let carry_out = select(i == num_limbs - 1, quote! {_}, quote! {carry});
let d_i = fmtid!("d_{}", i);
gen.extend(
quote! { let (#d_i, #carry_out) = adc(#d_i, Self::MODULUS_LIMBS[#i] & borrow, #carry_in); },
);
});
let ret: Vec<_> = (0..num_limbs).map(|i| fmtid!("d_{}", i)).collect();

quote! {
#gen
#field([#(#ret),*])
}
}

fn impl_from_mont(field: &syn::Ident, num_limbs: usize, inv: u64) -> TokenStream {
let mut gen = quote! { use crate::arithmetic::{adc, sbb, mac}; };

for i in 0..num_limbs {
let r_i = fmtid!("r_{}", i);
if i == 0 {
gen.extend(quote! { let k = self.0[0].wrapping_mul(#inv); });
} else {
gen.extend(quote! { let k = #r_i.wrapping_mul(#inv); });
}

for j in 0..num_limbs {
let r_ij = fmtid!("r_{}", (j + i) % num_limbs);
let r_out = select(j == 0, quote! {_}, quote! {#r_ij});
let r_ij = select(i == 0, quote! {self.0[#j]}, quote! {#r_ij});
let carry_in = select(j == 0, quote! {0}, quote! {#r_i});
gen.extend(
quote! { let (#r_out, #r_i) = mac(#r_ij, k, Self::MODULUS_LIMBS[#j], #carry_in); },
);
}
}
let ret: Vec<_> = (0..num_limbs).map(|i| fmtid!("r_{}", i)).collect();
quote! {
#gen
#field([#(#ret),*]).sub(&#field(Self::MODULUS_LIMBS)).0
}
}
Loading

0 comments on commit b6b05d5

Please sign in to comment.