| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522 |
- use halo2::{
- circuit::{Layouter, SimpleFloorPlanner},
- plonk,
- plonk::{Advice, Circuit, Column, ConstraintSystem, Instance as InstanceColumn},
- };
- use halo2_gadgets::{
- ecc::{
- chip::{EccChip, EccConfig},
- FixedPoint, Point,
- },
- poseidon::{Hash as PoseidonHash, Pow5T3Chip as PoseidonChip, Pow5T3Config as PoseidonConfig},
- primitives::poseidon::{ConstantLength, P128Pow5T3},
- sinsemilla::{
- chip::{SinsemillaChip, SinsemillaConfig},
- merkle::{
- chip::{MerkleChip, MerkleConfig},
- MerklePath,
- },
- },
- utilities::{
- lookup_range_check::LookupRangeCheckConfig, CellValue, UtilitiesInstructions, Var,
- },
- };
- use log::debug;
- use pasta_curves::pallas;
- use super::vm_stack::{Stack, Witness};
- use crate::{
- crypto::constants::{
- sinsemilla::{OrchardCommitDomains, OrchardHashDomains},
- OrchardFixedBases,
- },
- zkas::{decoder::ZkBinary, opcode::Opcode},
- };
- #[derive(Clone)]
- pub struct VmConfig {
- primary: Column<InstanceColumn>,
- advices: [Column<Advice>; 10],
- ecc_config: EccConfig,
- merkle_cfg1: MerkleConfig<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases>,
- merkle_cfg2: MerkleConfig<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases>,
- sinsemilla_cfg1: SinsemillaConfig<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases>,
- _sinsemilla_cfg2: SinsemillaConfig<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases>,
- poseidon_config: PoseidonConfig<pallas::Base>,
- }
- impl VmConfig {
- fn ecc_chip(&self) -> EccChip<OrchardFixedBases> {
- EccChip::construct(self.ecc_config.clone())
- }
- /*
- fn sinsemilla_chip_1(
- &self,
- ) -> SinsemillaChip<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases> {
- SinsemillaChip::construct(self.sinsemilla_cfg1.clone())
- }
- fn sinsemilla_chip_2(
- &self,
- ) -> SinsemillaChip<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases> {
- SinsemillaChip::construct(self.sinsemilla_cfg2.clone())
- }
- */
- fn merkle_chip_1(
- &self,
- ) -> MerkleChip<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases> {
- MerkleChip::construct(self.merkle_cfg1.clone())
- }
- fn merkle_chip_2(
- &self,
- ) -> MerkleChip<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases> {
- MerkleChip::construct(self.merkle_cfg2.clone())
- }
- fn poseidon_chip(&self) -> PoseidonChip<pallas::Base> {
- PoseidonChip::construct(self.poseidon_config.clone())
- }
- }
- #[derive(Default)]
- pub struct ZkCircuit {
- constants: Vec<String>,
- witnesses: Vec<Witness>,
- opcodes: Vec<(Opcode, Vec<usize>)>,
- }
- impl ZkCircuit {
- pub fn new(witnesses: Vec<Witness>, circuit_code: ZkBinary) -> Self {
- let constants = circuit_code.constants.iter().map(|x| x.1.clone()).collect();
- Self { constants, witnesses, opcodes: circuit_code.opcodes }
- }
- }
- impl UtilitiesInstructions<pallas::Base> for ZkCircuit {
- type Var = CellValue<pallas::Base>;
- }
- impl Circuit<pallas::Base> for ZkCircuit {
- type Config = VmConfig;
- type FloorPlanner = SimpleFloorPlanner;
- fn without_witnesses(&self) -> Self {
- Self::default()
- }
- fn configure(meta: &mut ConstraintSystem<pallas::Base>) -> Self::Config {
- // Advice columns used in the circuit
- let advices = [
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- meta.advice_column(),
- ];
- // Fixed columns for the Sinsemilla generator lookup table
- let table_idx = meta.lookup_table_column();
- let lookup = (table_idx, meta.lookup_table_column(), meta.lookup_table_column());
- // Instance column used for public inputs
- let primary = meta.instance_column();
- meta.enable_equality(primary.into());
- // Permutation over all advice columns
- for advice in advices.iter() {
- meta.enable_equality((*advice).into());
- }
- // Poseidon requires four advice columns, while ECC incomplete addition
- // requires six. We can reduce the proof size by sharing fixed columns
- // between the ECC and Poseidon chips.
- // TODO: For multiple invocations perhaps they could/should be configured
- // in parallel rather than sharing?
- let lagrange_coeffs = [
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- meta.fixed_column(),
- ];
- let rc_a = lagrange_coeffs[2..5].try_into().unwrap();
- let rc_b = lagrange_coeffs[5..8].try_into().unwrap();
- // Also use the first Lagrange coefficient column for loading global constants.
- meta.enable_constant(lagrange_coeffs[0]);
- // Use one of the right-most advice columns for all of our range checks.
- let range_check = LookupRangeCheckConfig::configure(meta, advices[9], table_idx);
- // Configuration for curve point operations.
- // This uses 10 advice columns and spans the whole circuit.
- let ecc_config = EccChip::<OrchardFixedBases>::configure(
- meta,
- advices,
- lagrange_coeffs,
- range_check.clone(),
- );
- // Configuration for the Poseidon hash
- let poseidon_config = PoseidonChip::configure(
- meta,
- P128Pow5T3,
- advices[6..9].try_into().unwrap(),
- advices[5],
- rc_a,
- rc_b,
- );
- // Configuration for a Sinsemilla hash instantiation and a
- // Merkle hash instantiation using this Sinsemilla instance.
- // Since the Sinsemilla config uses only 5 advice columns,
- // we can fit two instances side-by-side.
- let (sinsemilla_cfg1, merkle_cfg1) = {
- let sinsemilla_cfg1 = SinsemillaChip::configure(
- meta,
- advices[..5].try_into().unwrap(),
- advices[6],
- lagrange_coeffs[0],
- lookup,
- range_check.clone(),
- );
- let merkle_cfg1 = MerkleChip::configure(meta, sinsemilla_cfg1.clone());
- (sinsemilla_cfg1, merkle_cfg1)
- };
- let (_sinsemilla_cfg2, merkle_cfg2) = {
- let sinsemilla_cfg2 = SinsemillaChip::configure(
- meta,
- advices[5..].try_into().unwrap(),
- advices[7],
- lagrange_coeffs[1],
- lookup,
- range_check,
- );
- let merkle_cfg2 = MerkleChip::configure(meta, sinsemilla_cfg2.clone());
- (sinsemilla_cfg2, merkle_cfg2)
- };
- VmConfig {
- primary,
- advices,
- ecc_config,
- merkle_cfg1,
- merkle_cfg2,
- sinsemilla_cfg1,
- _sinsemilla_cfg2,
- poseidon_config,
- }
- }
- fn synthesize(
- &self,
- config: Self::Config,
- mut layouter: impl Layouter<pallas::Base>,
- ) -> std::result::Result<(), plonk::Error> {
- debug!("Entering synthesize()");
- // Our stack which holds everything we reference.
- let mut stack: Vec<Stack> = vec![];
- // Offset for public inputs
- let mut public_inputs_offset = 0;
- // Load the Sinsemilla generator lookup table used by the whole circuit.
- SinsemillaChip::load(config.sinsemilla_cfg1.clone(), &mut layouter)?;
- // Construct the ECC chip.
- let ecc_chip = config.ecc_chip();
- // Construct the Merkle chips
- let merkle_chip_1 = config.merkle_chip_1();
- let merkle_chip_2 = config.merkle_chip_2();
- // This constant one is used for short multiplication
- let one = self.load_private(
- layouter.namespace(|| "Load constant one"),
- config.advices[0],
- Some(pallas::Base::one()),
- )?;
- // Lookup and push the constants onto the stack
- for constant in &self.constants {
- debug!("Pushing constant `{}` to stack index {}", constant.as_str(), stack.len());
- match constant.as_str() {
- "VALUE_COMMIT_VALUE" => {
- let vcv = OrchardFixedBases::ValueCommitV;
- let vcv = FixedPoint::from_inner(ecc_chip.clone(), vcv);
- stack.push(Stack::Var(Witness::EcFixedPoint(vcv)));
- }
- "VALUE_COMMIT_RANDOM" => {
- let vcr = OrchardFixedBases::ValueCommitR;
- let vcr = FixedPoint::from_inner(ecc_chip.clone(), vcr);
- stack.push(Stack::Var(Witness::EcFixedPoint(vcr)));
- }
- "NULLIFIER_K" => {
- let nfk = OrchardFixedBases::NullifierK;
- let nfk = FixedPoint::from_inner(ecc_chip.clone(), nfk);
- stack.push(Stack::Var(Witness::EcFixedPoint(nfk)));
- }
- _ => unimplemented!(),
- }
- }
- // Push the witnesses onto the stack, and potentially, if the witness
- // is in the Base field (like the entire circuit is), load it into a
- // table cell.
- for witness in &self.witnesses {
- match witness {
- Witness::EcPoint(_) => {
- debug!("Pushing EcPoint to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- Witness::EcFixedPoint(_) => {
- debug!("Pushing EcFixedPoint to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- Witness::Base(v) => {
- debug!("Loading Base element into cell");
- let w = self.load_private(
- layouter.namespace(|| "Load witness into cell"),
- config.advices[0],
- Some(*v),
- )?;
- debug!("Pushing Base to stack index {}", stack.len());
- stack.push(Stack::Cell(w));
- }
- Witness::Scalar(_) => {
- debug!("Pushing Scalar to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- Witness::MerklePath(_) => {
- debug!("Pushing MerklePath to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- Witness::Uint32(_) => {
- debug!("Pushing Uint32 to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- Witness::Uint64(_) => {
- debug!("Pushing Uint64 to stack index {}", stack.len());
- stack.push(Stack::Var(witness.clone()));
- }
- }
- }
- // And now, work through opcodes
- for opcode in &self.opcodes {
- match opcode.0 {
- Opcode::EcAdd => {
- debug!("Executing `EcAdd{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let lhs: Point<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[0]].clone().into();
- let rhs: Point<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[1]].clone().into();
- let ret = lhs.add(layouter.namespace(|| "EcAdd()"), &rhs)?;
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Var(Witness::EcPoint(ret)));
- }
- Opcode::EcMul => {
- debug!("Executing `EcMul{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let lhs: FixedPoint<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[1]].clone().into();
- let rhs: pallas::Scalar = stack[args[0]].clone().into();
- let (ret, _) = lhs.mul(layouter.namespace(|| "EcMul()"), Some(rhs))?;
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Var(Witness::EcPoint(ret)));
- }
- Opcode::EcMulBase => {
- debug!("Executing `EcMulBase{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let lhs: FixedPoint<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[1]].clone().into();
- let rhs: CellValue<pallas::Base> = stack[args[0]].clone().into();
- let ret = lhs.mul_base_field(layouter.namespace(|| "EcMulBase()"), rhs)?;
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Var(Witness::EcPoint(ret)));
- }
- Opcode::EcMulShort => {
- debug!("Executing `EcMulShort{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let lhs: FixedPoint<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[1]].clone().into();
- let rhs: CellValue<pallas::Base> = stack[args[0]].clone().into();
- let (ret, _) =
- lhs.mul_short(layouter.namespace(|| "EcMulShort()"), (rhs, one))?;
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Var(Witness::EcPoint(ret)));
- }
- Opcode::EcGetX => {
- debug!("Executing `EcGetX{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let point: Point<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[0]].clone().into();
- let ret = point.inner().x();
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Cell(ret));
- }
- Opcode::EcGetY => {
- debug!("Executing `EcGetY{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let point: Point<pallas::Affine, EccChip<OrchardFixedBases>> =
- stack[args[0]].clone().into();
- let ret = point.inner().y();
- debug!("Pushing result to stack index {}", stack.len());
- stack.push(Stack::Cell(ret));
- }
- Opcode::PoseidonHash => {
- debug!("Executing `PoseidonHash{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let mut poseidon_message: Vec<CellValue<pallas::Base>> =
- Vec::with_capacity(args.len());
- for idx in args {
- poseidon_message.push(stack[*idx].clone().into());
- }
- macro_rules! poseidon_hash {
- ($len:expr, $hasher:ident, $output:ident, $cell:ident) => {
- let $hasher = PoseidonHash::<_, _, P128Pow5T3, _, 3, 2>::init(
- config.poseidon_chip(),
- layouter.namespace(|| "PoseidonHash init"),
- ConstantLength::<$len>,
- )?;
- let $output = $hasher.hash(
- layouter.namespace(|| "PoseidonHash hash"),
- poseidon_message.try_into().unwrap(),
- )?;
- let $cell: CellValue<pallas::Base> = $output.inner().into();
- debug!("Pushing hash to stack index {}", stack.len());
- stack.push(Stack::Cell($cell));
- };
- }
- // I can't find a better way to do this
- match args.len() {
- 1 => {
- poseidon_hash!(1, a, b, c);
- }
- 2 => {
- poseidon_hash!(2, a, b, c);
- }
- 3 => {
- poseidon_hash!(3, a, b, c);
- }
- 4 => {
- poseidon_hash!(4, a, b, c);
- }
- 5 => {
- poseidon_hash!(5, a, b, c);
- }
- 6 => {
- poseidon_hash!(6, a, b, c);
- }
- 7 => {
- poseidon_hash!(7, a, b, c);
- }
- 8 => {
- poseidon_hash!(8, a, b, c);
- }
- _ => unimplemented!(),
- }
- }
- Opcode::CalculateMerkleRoot => {
- debug!("Executing `CalculateMerkleRoot{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let leaf_pos = stack[args[0]].clone().into();
- let merkle_path = stack[args[1]].clone().into();
- let leaf = stack[args[2]].clone().into();
- let path = MerklePath {
- chip_1: merkle_chip_1.clone(),
- chip_2: merkle_chip_2.clone(),
- domain: OrchardHashDomains::MerkleCrh,
- leaf_pos,
- path: merkle_path,
- };
- let root =
- path.calculate_root(layouter.namespace(|| "CalculateMerkleRoot()"), leaf)?;
- debug!("Pushing merkle root to stack index {}", stack.len());
- stack.push(Stack::Cell(root));
- }
- Opcode::ConstrainInstance => {
- debug!("Executing `ConstrainInstance{:?}` opcode", opcode.1);
- let args = &opcode.1;
- let var: CellValue<pallas::Base> = stack[args[0]].clone().into();
- layouter.constrain_instance(
- var.cell(),
- config.primary,
- public_inputs_offset,
- )?;
- public_inputs_offset += 1;
- }
- _ => unimplemented!(),
- }
- }
- debug!("Exiting synthesize()");
- Ok(())
- }
- }
|