mint_contract.rs 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453
  1. use darkfi_sdk::crypto::constants::{
  2. sinsemilla::{OrchardCommitDomains, OrchardHashDomains},
  3. NullifierK, OrchardFixedBases, OrchardFixedBasesFull, ValueCommitV,
  4. };
  5. use halo2_gadgets::{
  6. ecc::{
  7. chip::{EccChip, EccConfig},
  8. FixedPoint, FixedPointBaseField, FixedPointShort, ScalarFixed, ScalarFixedShort,
  9. },
  10. poseidon::{
  11. primitives as poseidon, Hash as PoseidonHash, Pow5Chip as PoseidonChip,
  12. Pow5Config as PoseidonConfig,
  13. },
  14. sinsemilla::chip::{SinsemillaChip, SinsemillaConfig},
  15. utilities::lookup_range_check::LookupRangeCheckConfig,
  16. };
  17. use halo2_proofs::{
  18. circuit::{floor_planner, AssignedCell, Layouter, Value},
  19. pasta::{pallas, Fp},
  20. plonk,
  21. plonk::{Advice, Circuit, Column, ConstraintSystem, Instance as InstanceColumn},
  22. };
  23. use crate::zk::assign_free_advice;
  24. #[derive(Clone, Debug)]
  25. pub struct MintConfig {
  26. primary: Column<InstanceColumn>,
  27. advices: [Column<Advice>; 10],
  28. ecc_config: EccConfig<OrchardFixedBases>,
  29. poseidon_config: PoseidonConfig<pallas::Base, 3, 2>,
  30. sinsemilla_config:
  31. SinsemillaConfig<OrchardHashDomains, OrchardCommitDomains, OrchardFixedBases>,
  32. }
  33. impl MintConfig {
  34. fn ecc_chip(&self) -> EccChip<OrchardFixedBases> {
  35. EccChip::construct(self.ecc_config.clone())
  36. }
  37. fn poseidon_chip(&self) -> PoseidonChip<pallas::Base, 3, 2> {
  38. PoseidonChip::construct(self.poseidon_config.clone())
  39. }
  40. }
  41. // The public input array offsets
  42. const MINT_COIN_OFFSET: usize = 0;
  43. const MINT_VALCOMX_OFFSET: usize = 1;
  44. const MINT_VALCOMY_OFFSET: usize = 2;
  45. const MINT_TOKCOMX_OFFSET: usize = 3;
  46. const MINT_TOKCOMY_OFFSET: usize = 4;
  47. #[derive(Default, Debug)]
  48. pub struct MintContract {
  49. /// X coordinate for public key
  50. pub pub_x: Value<pallas::Base>,
  51. /// Y coordinate for public key
  52. pub pub_y: Value<pallas::Base>,
  53. /// The value of this coin
  54. pub value: Value<pallas::Base>,
  55. /// The token ID
  56. pub token: Value<pallas::Base>,
  57. /// Unique serial number corresponding to this coin
  58. pub serial: Value<pallas::Base>,
  59. /// Random blinding factor for coin
  60. pub coin_blind: Value<pallas::Base>,
  61. /// Allows composing this ZK proof to invoke other contracts
  62. pub spend_hook: Value<pallas::Base>,
  63. /// Data passed from this coin to the invoked contract
  64. pub user_data: Value<pallas::Base>,
  65. /// Random blinding factor for value commitment
  66. pub value_blind: Value<pallas::Scalar>,
  67. /// Random blinding factor for the token ID
  68. pub token_blind: Value<pallas::Scalar>,
  69. }
  70. impl Circuit<pallas::Base> for MintContract {
  71. type Config = MintConfig;
  72. type FloorPlanner = floor_planner::V1;
  73. fn without_witnesses(&self) -> Self {
  74. Self::default()
  75. }
  76. fn configure(meta: &mut ConstraintSystem<pallas::Base>) -> Self::Config {
  77. // Advice columns used in the circuit
  78. let advices = [
  79. meta.advice_column(),
  80. meta.advice_column(),
  81. meta.advice_column(),
  82. meta.advice_column(),
  83. meta.advice_column(),
  84. meta.advice_column(),
  85. meta.advice_column(),
  86. meta.advice_column(),
  87. meta.advice_column(),
  88. meta.advice_column(),
  89. ];
  90. // Fixed columns for the Sinsemilla generator lookup table
  91. let table_idx = meta.lookup_table_column();
  92. let lookup = (table_idx, meta.lookup_table_column(), meta.lookup_table_column());
  93. // Instance column used for public inputs
  94. let primary = meta.instance_column();
  95. meta.enable_equality(primary);
  96. // Permutation over all advice columns
  97. for advice in advices.iter() {
  98. meta.enable_equality(*advice);
  99. }
  100. let ecc_lagrange_coeffs = [
  101. meta.fixed_column(),
  102. meta.fixed_column(),
  103. meta.fixed_column(),
  104. meta.fixed_column(),
  105. meta.fixed_column(),
  106. meta.fixed_column(),
  107. meta.fixed_column(),
  108. meta.fixed_column(),
  109. ];
  110. let poseidon_lagrange_coeffs = [
  111. meta.fixed_column(),
  112. meta.fixed_column(),
  113. meta.fixed_column(),
  114. meta.fixed_column(),
  115. meta.fixed_column(),
  116. meta.fixed_column(),
  117. ];
  118. let rc_a = poseidon_lagrange_coeffs[0..3].try_into().unwrap();
  119. let rc_b = poseidon_lagrange_coeffs[3..6].try_into().unwrap();
  120. // Also use the first Lagrange coefficient column for loading global constants.
  121. meta.enable_constant(ecc_lagrange_coeffs[0]);
  122. // Use one of the right-most advice columns for all of our range checks.
  123. let range_check = LookupRangeCheckConfig::configure(meta, advices[9], table_idx);
  124. // Configuration for curve point operations.
  125. // This uses 10 advice columns and spans the whole circuit.
  126. let ecc_config = EccChip::<OrchardFixedBases>::configure(
  127. meta,
  128. advices,
  129. ecc_lagrange_coeffs,
  130. range_check,
  131. );
  132. // Configuration for the Poseidon hash
  133. let poseidon_config = PoseidonChip::configure::<poseidon::P128Pow5T3>(
  134. meta,
  135. advices[7..10].try_into().unwrap(),
  136. advices[6],
  137. rc_a,
  138. rc_b,
  139. );
  140. let sinsemilla_config = SinsemillaChip::configure(
  141. meta,
  142. advices[..5].try_into().unwrap(),
  143. advices[6],
  144. ecc_lagrange_coeffs[0],
  145. lookup,
  146. range_check,
  147. );
  148. MintConfig { primary, advices, ecc_config, poseidon_config, sinsemilla_config }
  149. }
  150. fn synthesize(
  151. &self,
  152. config: Self::Config,
  153. mut layouter: impl Layouter<pallas::Base>,
  154. ) -> Result<(), plonk::Error> {
  155. // Load the Sinsemilla generator lookup table used by the whole circuit.
  156. SinsemillaChip::load(config.sinsemilla_config.clone(), &mut layouter)?;
  157. let ecc_chip = config.ecc_chip();
  158. let pub_x = assign_free_advice(
  159. layouter.namespace(|| "load pubkey x"),
  160. config.advices[6],
  161. self.pub_x,
  162. )?;
  163. let pub_y = assign_free_advice(
  164. layouter.namespace(|| "load pubkey y"),
  165. config.advices[6],
  166. self.pub_y,
  167. )?;
  168. let value =
  169. assign_free_advice(layouter.namespace(|| "load value"), config.advices[6], self.value)?;
  170. let token =
  171. assign_free_advice(layouter.namespace(|| "load token"), config.advices[6], self.token)?;
  172. let serial = assign_free_advice(
  173. layouter.namespace(|| "load serial"),
  174. config.advices[6],
  175. self.serial,
  176. )?;
  177. let spend_hook = assign_free_advice(
  178. layouter.namespace(|| "load spend_hook"),
  179. config.advices[6],
  180. self.spend_hook,
  181. )?;
  182. let user_data = assign_free_advice(
  183. layouter.namespace(|| "load user_data"),
  184. config.advices[6],
  185. self.user_data,
  186. )?;
  187. let coin_blind = assign_free_advice(
  188. layouter.namespace(|| "load coin_blind"),
  189. config.advices[6],
  190. self.coin_blind,
  191. )?;
  192. // =========
  193. // Coin hash
  194. // =========
  195. let coin = {
  196. let poseidon_message = [
  197. pub_x,
  198. pub_y,
  199. value.clone(),
  200. token.clone(),
  201. serial,
  202. spend_hook,
  203. user_data,
  204. coin_blind,
  205. ];
  206. let poseidon_hasher = PoseidonHash::<
  207. _,
  208. _,
  209. poseidon::P128Pow5T3,
  210. poseidon::ConstantLength<8>,
  211. 3,
  212. 2,
  213. >::init(
  214. config.poseidon_chip(), layouter.namespace(|| "Poseidon init")
  215. )?;
  216. let poseidon_output =
  217. poseidon_hasher.hash(layouter.namespace(|| "Poseidon hash"), poseidon_message)?;
  218. let poseidon_output: AssignedCell<Fp, Fp> = poseidon_output;
  219. poseidon_output
  220. };
  221. // Constrain the coin C
  222. layouter.constrain_instance(coin.cell(), config.primary, MINT_COIN_OFFSET)?;
  223. // ================
  224. // Value commitment
  225. // ================
  226. // This constant one is used for short multiplication
  227. let one = assign_free_advice(
  228. layouter.namespace(|| "load constant one"),
  229. config.advices[6],
  230. Value::known(pallas::Base::one()),
  231. )?;
  232. // v * G_1
  233. let (commitment, _) = {
  234. let value_commit_v = FixedPointShort::from_inner(ecc_chip.clone(), ValueCommitV);
  235. let value = ScalarFixedShort::new(
  236. ecc_chip.clone(),
  237. layouter.namespace(|| "value"),
  238. (value, one),
  239. )?;
  240. value_commit_v.mul(layouter.namespace(|| "[value] ValueCommitV"), value)?
  241. };
  242. // r_V * G_2
  243. let (blind, _rcv) = {
  244. let rcv = ScalarFixed::new(
  245. ecc_chip.clone(),
  246. layouter.namespace(|| "value_blind"),
  247. self.value_blind,
  248. )?;
  249. let value_commit_r =
  250. FixedPoint::from_inner(ecc_chip.clone(), OrchardFixedBasesFull::ValueCommitR);
  251. value_commit_r.mul(layouter.namespace(|| "[value_blind] ValueCommitR"), rcv)?
  252. };
  253. let value_commit = commitment.add(layouter.namespace(|| "valuecommit"), &blind)?;
  254. // Constrain the value commitment coordinates
  255. layouter.constrain_instance(
  256. value_commit.inner().x().cell(),
  257. config.primary,
  258. MINT_VALCOMX_OFFSET,
  259. )?;
  260. layouter.constrain_instance(
  261. value_commit.inner().y().cell(),
  262. config.primary,
  263. MINT_VALCOMY_OFFSET,
  264. )?;
  265. // ================
  266. // Token commitment
  267. // ================
  268. // a * G_1
  269. let commitment = {
  270. let token_commit_v = FixedPointBaseField::from_inner(ecc_chip.clone(), NullifierK);
  271. token_commit_v.mul(layouter.namespace(|| "[token] NullifierK"), token)?
  272. };
  273. // r_A * G_2
  274. let (blind, _rca) = {
  275. let rca = ScalarFixed::new(
  276. ecc_chip.clone(),
  277. layouter.namespace(|| "token_blind"),
  278. self.token_blind,
  279. )?;
  280. let token_commit_r =
  281. FixedPoint::from_inner(ecc_chip, OrchardFixedBasesFull::ValueCommitR);
  282. token_commit_r.mul(layouter.namespace(|| "[token_blind] ValueCommitR"), rca)?
  283. };
  284. let token_commit = commitment.add(layouter.namespace(|| "tokencommit"), &blind)?;
  285. // Constrain the token commitment coordinates
  286. layouter.constrain_instance(
  287. token_commit.inner().x().cell(),
  288. config.primary,
  289. MINT_TOKCOMX_OFFSET,
  290. )?;
  291. layouter.constrain_instance(
  292. token_commit.inner().y().cell(),
  293. config.primary,
  294. MINT_TOKCOMY_OFFSET,
  295. )?;
  296. // At this point we've enforced all of our public inputs.
  297. Ok(())
  298. }
  299. }
  300. #[cfg(test)]
  301. mod tests {
  302. use super::*;
  303. use crate::{
  304. crypto::{
  305. keypair::PublicKey,
  306. proof::{ProvingKey, VerifyingKey},
  307. util::{pedersen_commitment_base, pedersen_commitment_u64},
  308. Proof,
  309. },
  310. Result,
  311. };
  312. use halo2_gadgets::poseidon::{
  313. primitives as poseidon,
  314. primitives::{ConstantLength, P128Pow5T3},
  315. };
  316. use halo2_proofs::{
  317. circuit::Value,
  318. dev::{CircuitLayout, MockProver},
  319. };
  320. use pasta_curves::{
  321. arithmetic::CurveAffine,
  322. group::{ff::Field, Curve},
  323. };
  324. use rand::rngs::OsRng;
  325. use std::time::Instant;
  326. #[test]
  327. fn mint_circuit_assert() -> Result<()> {
  328. let value = 42;
  329. let token_id = pallas::Base::random(&mut OsRng);
  330. let value_blind = pallas::Scalar::random(&mut OsRng);
  331. let token_blind = pallas::Scalar::random(&mut OsRng);
  332. let serial = pallas::Base::random(&mut OsRng);
  333. let coin_blind = pallas::Base::random(&mut OsRng);
  334. let public_key = PublicKey::random(&mut OsRng);
  335. let coords = public_key.0.to_affine().coordinates().unwrap();
  336. let spend_hook = pallas::Base::random(&mut OsRng);
  337. let user_data = pallas::Base::random(&mut OsRng);
  338. let msg = [
  339. *coords.x(),
  340. *coords.y(),
  341. pallas::Base::from(value),
  342. token_id,
  343. serial,
  344. spend_hook,
  345. user_data,
  346. coin_blind,
  347. ];
  348. let coin = poseidon::Hash::<_, P128Pow5T3, ConstantLength<8>, 3, 2>::init().hash(msg);
  349. let value_commit = pedersen_commitment_u64(value, value_blind);
  350. let value_coords = value_commit.to_affine().coordinates().unwrap();
  351. let token_commit = pedersen_commitment_base(token_id, token_blind);
  352. let token_coords = token_commit.to_affine().coordinates().unwrap();
  353. let public_inputs =
  354. vec![coin, *value_coords.x(), *value_coords.y(), *token_coords.x(), *token_coords.y()];
  355. let circuit = MintContract {
  356. pub_x: Value::known(*coords.x()),
  357. pub_y: Value::known(*coords.y()),
  358. value: Value::known(pallas::Base::from(value)),
  359. token: Value::known(token_id),
  360. serial: Value::known(serial),
  361. coin_blind: Value::known(coin_blind),
  362. spend_hook: Value::known(spend_hook),
  363. user_data: Value::known(user_data),
  364. value_blind: Value::known(value_blind),
  365. token_blind: Value::known(token_blind),
  366. };
  367. use plotters::prelude::*;
  368. let root =
  369. BitMapBackend::new("target/mint_circuit_layout.png", (3840, 2160)).into_drawing_area();
  370. root.fill(&WHITE).unwrap();
  371. let root = root.titled("Mint Circuit Layout", ("sans-serif", 60)).unwrap();
  372. CircuitLayout::default().render(11, &circuit, &root).unwrap();
  373. let prover = MockProver::run(11, &circuit, vec![public_inputs.clone()])?;
  374. prover.assert_satisfied();
  375. let now = Instant::now();
  376. let proving_key = ProvingKey::build(11, &circuit);
  377. println!("ProvingKey built [{:?}]", now.elapsed());
  378. let now = Instant::now();
  379. let proof = Proof::create(&proving_key, &[circuit], &public_inputs, &mut OsRng)?;
  380. println!("Proof created [{:?}]", now.elapsed());
  381. let circuit = MintContract::default();
  382. let now = Instant::now();
  383. let verifying_key = VerifyingKey::build(11, &circuit);
  384. println!("VerifyingKey built [{:?}]", now.elapsed());
  385. let now = Instant::now();
  386. proof.verify(&verifying_key, &public_inputs)?;
  387. println!("Proof verified [{:?}]", now.elapsed());
  388. println!("Proof size [{} kB]", proof.as_ref().len() as f64 / 1024.0);
  389. Ok(())
  390. }
  391. }