@aztec/protocol-contracts 0.84.0-nightly.20250410 → 0.84.0-nightly.20250412

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/artifacts/AuthRegistry.json +266 -294
  2. package/artifacts/ContractClassRegisterer.json +200 -200
  3. package/artifacts/ContractInstanceDeployer.json +303 -307
  4. package/artifacts/FeeJuice.json +183 -195
  5. package/artifacts/MultiCallEntrypoint.json +20 -20
  6. package/artifacts/Router.json +180 -180
  7. package/dest/protocol_contract_data.js +7 -7
  8. package/package.json +4 -4
  9. package/src/protocol_contract_data.ts +7 -7
package/artifacts/MultiCallEntrypoint.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "transpiled": true,
3
- "noir_version": "1.0.0-beta.3+0000000000000000000000000000000000000000",
3
+ "noir_version": "1.0.0-beta.4+0000000000000000000000000000000000000000",
4
4
  "name": "MultiCallEntrypoint",
5
5
  "functions": [
6
6
  {
@@ -1653,9 +1653,9 @@
1653
1653
  "error_kind": "string",
1654
1654
  "string": "push out of bounds"
1655
1655
  },
1656
- "16761564377371454734": {
1656
+ "14225679739041873922": {
1657
1657
  "error_kind": "string",
1658
- "string": "Array index out of bounds"
1658
+ "string": "Index out of bounds"
1659
1659
  },
1660
1660
  "17843811134343075018": {
1661
1661
  "error_kind": "string",
@@ -1663,8 +1663,8 @@
1663
1663
  }
1664
1664
  }
1665
1665
  },
1666
- "bytecode": "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",
1667
- "debug_symbols": "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",
1666
+ "bytecode": "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",
1667
+ "debug_symbols": "7Z3dbhtHEkbfRde+6K7+q86rLBaB4ziBAcMObGeBRZB3DymbQ0UiSyBG4nwH4E1gxdPUcY9UZ/iDM3/d/fr+lz9///nDp98+f7376T9/3X38/O7ttw+fP+2++uvO2v3/+/rH20/7L79+e/vl291P1up4c/f+06+7P/Zsf7+5++3Dx/d3P+VU/37z9Gir6XC09ePRo504uKTZfhxccvf44NxmPoDs/lzScri5nzq+Nz8c3sdYji7p5KOXXg5H15z+dfR/39xZv23Nua0Zt605tzV+25pzWzNvW3Nma0q6bc25rcm3rTm3NXbbmnNbU25bc25r6m1rzm3N7Wr47NbcrobPbs3tavjs1tyuhs9uze1q+NzW1NvV8NmtuV0Nn92a29Xw2a25XQ2f3Zp625pzW3O7Gj67Nber4bNbc7saPrs1t6vhs1tzuxo+tzXtdjV8dmtuV8Nnt0b9arjV49Y8OPz01li2fiDJta3cGvWr4Q23pp7cmur5uDXlma2puc8fR1dLR6Ddv2T/Hdqrf4eT12a1Hza1+lxWtHTyDFRbTkB/cPCpDW2lHn5p225vjydrpHuYoQTjSjBzLUwv6dS4PAmT5xzL0XP6ePhDc+qXys2X3ypv49HPWE9k+EyGNzJ8uSa8pTQPv66WrLYYfraDpHK2o3X2Ttmj1yujW1vQk+fHG9nW0rj35bw+uDI7/VPQe132pnt/QtOlaMZVaTwdz6unpz/yLkUzlWhGkqLJUjQmRbN6+rV0vKi38pBm//BNabiO/rr/2PHazwCG0nXumEIwnpRgyNehTr4O9UKGr2T4RobvZPhBhncy/MQ+653puui1Hi/M6ngGvfvyQnH38eAq7p48Y8kNS16w5BVL3pTJZzoc3aeNR+QdSz6w5I4ln1TynKQlGqNLWzRGl9ZojC7t0RhdWqQxOtakOWFVmhPWpTlhZZoT16aZa9PMtWnm2jRzbZq5Ns1cm2auTTPXpplr08y1qXFtalybGtemxrWpcW1qXJsa16bGtalp27Qub2jM9gRd26YRetG2aYiubdMQXdumIbq2TUN0bZuG6No2DdG1bRqia9s0ROfatHBtWrk2rVybVq5NK9emlWvTyrVp5dq0cm1auTatXJs2rk0b16aNa9PGtWnj2rRxbdq4Nm1cmzauTRvXpp1r0861aefatHNteu30yUuic23auTbtXJt2rk0716aDa9PBteng2nRwbbo+pbMdOtemg2vTwbXp4Np0cG3qXJs616bOtalzbXrdGNLLonNt6lybOtemzrWpc22qnUCK0bk21Y4gxehcm2pnkGJ0rk3FQ0ghOtem4imkEB1rUxNvIYXoWJuaeAspRMfadLeei461qYm3kEJ0rE1NvIUUonNtKt5CCtG5NhVvIYXoXJuKt5BCdK5NxVtIITrXpuItpBCda1PxFlKIzrWpeAspROfaVLyFFKJzbSreQgrRuTbltpCM20IybgvJuC0k47aQjNtCMm4LybgtJOO2kIzbQjJuC8m4LSTjtpCM20IybgvJuC0k47aQjNtCMm4LybgtJOO2kIzbQjJuC8m4LSTjtpCM20IybgvJuC0k47aQjNtCMm4LybgtJOO2kIzbQjJuC8m4LSTjtpCM20IybgvJuC0k47aQjNtCMm4LybgtJOO2kIzbQjJuC8m4LSTjtpCM20IybgvJuC0k47aQjNtCMm4LybgtJOO2kIzbQjJuC8m4LSTjtpCM20Ky9S0k935AnyXF6Ln3BT137/kh+j1O1sKx6+K424Izc3nmxHpbTqyP/PjEFi565aI3Lnrnog8uunPRJxW9pMRFz8ro0R3sS5K2aYwubdMYXdqmMbq0TWN0aZvG6NI2jdGlbRqjS9s0RM/SNo3RuTbNXJtmrk3XN4u2Q+faNHNtmrk2zVybZq5NjWtT49rUuDY1rk3XN4u2Q+fa1Lg2Na5NjWtT49q0cG1auDYtXJsWrk3XN4u2Q+fatHBtWrg2LVybFq5NK9emlWvTyrVp5dp0fbNoO3SuTSvXppVr08q1aeXatHFt2rRtGnziuTRtm4bo2jYN0a9rU0/HD9R7ekjj33GaFk7XwhlaOK6FM6VwetLCyVo4poVTtHC0pnLXmspdayp3ranctaZy15rKQ2sqD62pPLSm8tCaykNrKg+tqTy0pvLQmspDayoPransWlPZtaaya01l15rKrjWVXWsqu9ZUdq2p7FpT2bWm8tSaylNrKk+tqTy1pvLUmspTayprNx3CNwy0mw4xus67qfc4q6d9q8s3aH3GOG33ZvKPg9vu5c7lYBtpT1PXpxdelCZL0Vw1spfnHMvRc/qIf+Ytux3od39+MmxqKmj6iqZvaPqOph9oekfTT2H6Og5q6FaXQ3Nt9+j5yh3bNA80lqw+Ew2cbeniZfOn7NIh26ifVLN0yDZGlw7ZxuiViy4dso3RpUO2Mbp0yDZG1w7ZBh/rrFk7ZBuhm3YWPkTXzsKH6NpZ+BBdOwsfokvbNEbXzsKH6NpZ+BBdOwsfonNtalybFq5NC9emhWvTwrXp+mzCduhcmxauTQvXpoVr08K1aeXatHJtWrk2rVybrs8mbIfOtWnl2rRybVq5Nq1cmzauTRvXpo1r08a16fpswnboXJs2rk0b16aNa9PGtWnn2rRzbdq5Nu1cm67PXWyHzrVp59q0c23auTbtXJsOrk0H16aDa9PBten6TMl26FybDq5NB9emg2vTwbWpc23qXJs616bOten6vMx26FybOtemzrWpc23qXJtOrk0n16aTa9PJten6LNB26FybTq5NJ9emk2vTibVpS1ibtoS1aUtYm7aEtWlLWJu2hLVpS1ibtoS1aUtYm7bEtWnm2lS7hRSjc22q3UKK0bk21W4hxehcm2q3kGJ0rk25LaTGbSE1bgupcVtIjdtCatwWUhNvIQWJ8ybeQgrRtW0aomvbNETXtmmELt5CCtG1bRqia9s0RNe2aYiubdMQnWtT8RZSiM61qXgLKUTn2lS8hRSic20q3kIK0bk2FW8hhehcm4q3kEJ0rk3FW0ghOtem4i2kEJ1rU/EWUojOtal4CylE59pUvIUUonNtKt5CCtG5NhVvIYXoXJuKt5BCdK5NxVtIITrXpuItpBCda1PxFlKIzrWpeAspROfaVLyFFKJzbSreQgrRuTYVbyGF6FybireQQnSuTcVbSCE616biLaQQnWtT8RZSiM61qXgLKUTn2lS8hRSic20q3kIK0bk2FW8hhehcm4q3kEJ0rk3FW0ghOtem4i2kEB1r0y7eQgrRsTbt4i2kEB1r056wNu3iLaQQHWvTLt5CCtGxNu3rW0ju/YA+S4rRc+8Leu7e80P0Pc76vtHL4uTr4rjbgjNzeebEeltOrI/86MSubxZth1646JWL3rjonYs+uOjORZ9YdEvK6FHHpZu0TWN0aZvG6NI2jdGlbRqjS9s0Rpe2aYwubdMYXdqmMbq0TUP0wrVp4dq0cG1auDZd3yzaDp1r08K1aeHatHBtWrg2rVybVq5NK9emlWvT9c2i7dC5Nq1cm1auTSvXppVr08a1aePatHFt2rg2Xd8s2g6da9PGtWnj2rRxbdq4Nu1cm3auTTvXpp1r0/XNou3QuTbtXJt2rk0716ada9PBteng2nRwbTq4Nl3fLNoOnWvTwbXp4Np0cG06uDZ1rk2da1Pn2tS5Nl3fLNoOnWtT59rUuTZ1rk2da9PJtenk2nRybTq5Nl3fLNoOnWvTybXp5Np0cm06sTYdCWvTkbA2HUnbpkFRZCRtm4bo2jYN0a9rU0/HYI2nhzT+Hadr4QwtHNfCmVI4V24APYuTtXBMC6do4VQtHK2pnLWmctaayllrKmetqWxaU9m0prJpTWXTmsqmNZVNayqb1lQ2ralsWlPZtKZy0ZrKRWsqF62pXLSmctGaykVrKhetqVy0pnLRmspFaypXralctaZy1ZrKVWsqV62pXLWmctWayuJNh+gNA/GmQ4iu827qHmd9p6HV5Ru0PmOcVqr/OLiVfoSxkb7TZCkak6K56u1U8pxjOXpOH/HPvGW3A/3uz0+HzfpGwqb0DU3f0fQDTe9o+kmm70mYvo6DGrrV5dBc23f0K9+xLM0DjSXbMYTosy33ncnmT9mlb1kW3Z9gdOlblsXolYsufcuyGF36lmUxuvQty2J06VuWxejaNwCNPtY5tG8AGqJr3wA0RNe+AWiIrn0D0BBd2qYxuvYNQEN07RuAhujaNwAN0bVvABqic23qXJs616bOtalzbbo+m7AdOtemzrWpc23qXJs616aTa9PJtenk2nRybbo+m7AdOtemk2vTybXp5Np0Ym3qCWtTT1ibesLa1BPWpp6wNvWEtaknrE09YW3qCWtTT1ybZq5NM9emmWvTzLXp+oTFduhcm2auTTPXpplr08y1qXFtalybGtemxrXp+vTIduhcmxrXpsa1qXFtalybFq5NC9emhWvTwrXp+mTMduhcmxauTQvXpoVr08K1aeXatHJtWrk2rVybrk/9bIfOtWnl2rRybVq5Nq1cmzauTRvXpo1r08a16XXzSC+LzrVp49q0cW3auDZtXJt2rk0716baLaQYnWtT7RZSjM61qXYLKUbn2lS7hRSjc23KbSE5t4Xk3BaSc1tIzm0hObeF5OItpCBx7uItpBBd26YhurZNI3TxFlKIrm3TEF3bpiG6tk1DdG2bhujaNg3RuTYVbyGF6FybireQInTxFlKIzrWpeAspROfaVLyFFKJzbSreQgrRuTYVbyGF6FibTvEWUoiOtekUbyGF6FibzoS16RRvIYXoWJtO8RZSiI616RRvIUXo4i2kEJ1rU/EWUojOtal4CylE59pUvIUUonNtKt5CCtG5NhVvIYXoXJuKt5BCdK5NxVtIITrXpuItpBCda1PxFlKIzrWpeAspROfaVLyFFKJzbSreQgrRuTYVbyGF6FybireQQnSuTcVbSCE616biLaQQnWtT8RZSiM61qXgLKUTn2lS8hRSic20q3kIK0bk2FW8hhehcm4q3kEJ0rk3Xt5Dc+wF991pajJ57X9Bz954fot/jDC0cvy6Ouy04M5dnTqy35cT6yI9P7MSir28WbYeeuejGRS9c9MpFb1z0zkUfyuhR22J2aZvG6NI2DdGHtE1jdGmbxujSNo3RpW0ao0vbNEaXtmmMLm3TGJ1r08G16eDa1Lk2da5NnWtT59p0fbNoO3SuTZ1rU+fa1Lk2da5NJ9emk2vTybXp5Np0fbNoO3SuTSfXppNr08m16cTaNKeE1emOHevTHTtWqDt2rFF37Fil7tixTt2xY6W6Y8dadceO1eqOHezVDPZqBns1g72awV5dnzDakB3s1Qz2agZ7NYO9msFeNbBXDexVA3vVwF5dHzPakB3sVQN71cBeNbBXDezVAvZqAXu1gL1awF5dnzXakB3s1QL2agF7tYC9WsBerWCvVrBXK9irFezV9YGjDdnBXq1gr1awVyvYq/W6XvV0LJZ4epgV8e88LYnxZDEeE+MpYjxVjKeJ8XQxniHG42I8YvO5i83nLjafu9h87mLzuYvN5y42n7vYfO5i87mLzecuNp+H2HweYvN5iM3nITafh9h8HmLzeYjN5yE2n4fYfB5i89nF5rOLzWcXm88uNp9dbD672Hx2sfnsYvPZxeazi83nKTSfd1/88uXDx48ffv/54+d3b799+Pzp635x2v/nzAe4x+GtgW51ebBc2/2j5f2Rpz8J28v8sXCH8WBh2W/L6Q+gxkva5Uv65UvG5Uv88iUnt9ptWVL98ZLTH6WLl+TLl9jlS8rlS+rlS9rlS/rlS8blS/zyJafPvh8mgs/5ryVPf8tLP7wDV8bxl7L0+4c//eGQl3v4/LoPb6/78OV1H76+7sO31334/roPP17w4b08eXh/3Yefr/rwp9+mnnZQ/yzj8Rw5/U5yvMQuX1IuX1IvX9IuX9IvXzIuXnL65eF4ybx4ybj87I/Lz/64/OyPy8/+uPzsn35Nzo53l+nj8e/L6ZfN4iXj8iUnz76NcVgyn/win359KFxy+iWceEm+fIldvqRcvqReuOTv3Zf/e/vlw9tfPr7fPxnZ/+2fn94dnpvsvvz2/z8Of3N49vLHl8/v3v/655f3++cxD57C7DfS8hvry5OT+//V85ved3D3DYKZ3kzbfdvdt/4H",
1668
1668
  "brillig_names": [
1669
1669
  "notify_enqueued_public_function_call_wrapper",
1670
1670
  "call_private_function_internal",
@@ -1690,7 +1690,7 @@
1690
1690
  }
1691
1691
  },
1692
1692
  "bytecode": "H4sIAAAAAAAA/7WTPQ+CMBCGi2KUjzjgoD+jBAyM+LG4OLpXCkpUSAB3frqQXENtwKjAJU17FJ5736OVUB0SzDLqEAyyglmBecTtj8vhQY67hakIdfvku9i2lQZ/Peq3FGBKw/Ax4w/UfzwFzr6o+bwXVndWDo1b66g+H0P5Z/9vSP+LD5418GpAXnmew/oS5Nt74t+Oz8c5SNnXTR1EgnIxdK5CSd0lcZ4SP99QmgZZJhJGDWTUQlU56pVE8YG26fmRdgrSLEpikSZ/Sav6yu6lXLyr8eA57hCOizHTMAb+BDV3X+b2+feXkKuCJ+bT+1Nn6BAztEhI1oRS2yeGwK+CP38vlizs4eEFAAA=",
1693
- "debug_symbols": "rZLLqoMwEIbfJWsXuV/6KuVQosYSCFGiHijiu3cssZVa2o2bYSZ8DF+Sf0K1K8frxcem7dHpPKHQVnbwbYRpmgtUJh+Cv162xwgvhbAH33c2LmM/2DSgE8Gc6AK5WD96pWBH44ODiUK/45WWmdaYP1klPqCCiowKgV9rBZn/CkT4ETaaqdVGmO82nJmMcql3NuIQG81XG6O/20i8vo2kcmcjj7AxlGbaMPHDRuOMKvz2UzOM/zZ5WwaXI9aMsdokbrh17i18XWorV4/JLTHcJBDqGe5AGayF1Xc=",
1693
+ "debug_symbols": "rZLdCoMgGIbvxeMO/P/ZrYwxrCwEsbAajOjeZ2EsarSTTj789OHjUd8RlCYf6qf1VdOB230Eril0bxsfu3HKQB6sc7Z+brcBnAsiC9+12s9t1+vQgxuCFMkMGF8uayHijMo6s3RTduCF5ImW83liBfqBMswSyhj8jqV8emQA0StsJBGrDVPnNpSohFIuDzbsEhtJVxslz204XN+GY36w4VfYKIwTrQj7YyNhQgXc/dQU25cOVufOpIhVgy82ievfrdmFrw1NYcohmDmGmwTGeo93wCSOjaM/",
1694
1694
  "brillig_names": [
1695
1695
  "sync_notes"
1696
1696
  ]
@@ -1827,43 +1827,43 @@
1827
1827
  }
1828
1828
  },
1829
1829
  "file_map": {
1830
- "127": {
1830
+ "104": {
1831
1831
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/macros/functions/utils.nr",
1832
- "source": "use crate::macros::{\n functions::{abi_export::create_fn_abi_export, call_interface_stubs::stub_fn, stub_registry},\n notes::NOTES,\n utils::{\n add_to_hasher, fn_has_noinitcheck, get_fn_visibility, is_fn_contract_library_method,\n is_fn_initializer, is_fn_internal, is_fn_private, is_fn_public, is_fn_test, is_fn_utility,\n is_fn_view, modify_fn_body, module_has_initializer, module_has_storage,\n },\n};\nuse protocol_types::meta::generate_serialize_to_fields;\nuse std::meta::type_of;\n\npub(crate) comptime fn transform_private(f: FunctionDefinition) -> Quoted {\n let fn_abi = create_fn_abi_export(f);\n let fn_stub = stub_fn(f);\n stub_registry::register(f.module(), fn_stub);\n\n // If a function is further modified as unconstrained, we throw an error\n if f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[private] but marked as unconstrained, remove unconstrained keyword\",\n );\n }\n\n let module_has_initializer = module_has_initializer(f.module());\n let module_has_storage = module_has_storage(f.module());\n\n // Private functions undergo a lot of transformations from their Aztec.nr form into a circuit that can be fed to the\n // Private Kernel Circuit.\n // First we change the function signature so that it also receives `PrivateContextInputs`, which contain information\n // about the execution context (e.g. the caller).\n let original_params = f.parameters();\n f.set_parameters(&[(\n quote { inputs },\n quote { crate::context::inputs::private_context_inputs::PrivateContextInputs }.as_type(),\n )]\n .append(original_params));\n\n let mut body = f.body().as_block().unwrap();\n\n // The original params are hashed and passed to the `context` object, so that the kernel can verify we've received\n // the correct values.\n // TODO: Optimize args_hasher for small number of arguments\n let args_hasher_name = quote { args_hasher };\n let args_hasher = original_params.fold(\n quote {\n let mut $args_hasher_name = dep::aztec::hash::ArgsHasher::new();\n },\n |args_hasher, param: (Quoted, Type)| {\n let (name, typ) = param;\n let appended_arg = add_to_hasher(args_hasher_name, name, typ);\n quote {\n $args_hasher\n $appended_arg\n }\n },\n );\n\n let context_creation = quote {\n let mut context = dep::aztec::context::private_context::PrivateContext::new(inputs, dep::aztec::protocol_types::traits::Hash::hash($args_hasher_name));\n };\n\n // Modifications introduced by the different marker attributes.\n let internal_check = if is_fn_internal(f) {\n create_internal_check(f)\n } else {\n quote {}\n };\n\n let view_check = if is_fn_view(f) {\n create_view_check(f)\n } else {\n quote {}\n };\n\n let (assert_initializer, mark_as_initialized) = if is_fn_initializer(f) {\n (create_assert_correct_initializer_args(f), create_mark_as_initialized(f))\n } else {\n (quote {}, quote {})\n };\n\n let storage_init = if module_has_storage {\n quote {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n #[allow(unused_variables)]\n let storage = Storage::init(&mut context);\n }\n } else {\n quote {}\n };\n\n // Initialization checks are not included in contracts that don't have initializers.\n let init_check = if module_has_initializer & !is_fn_initializer(f) & !fn_has_noinitcheck(f) {\n create_init_check(f)\n } else {\n quote {}\n };\n\n // All private functions perform message discovery, since they may need to access notes. This is slightly\n // inefficient and could be improved by only doing it once we actually attempt to read any.\n let message_discovery_call = if NOTES.len() > 0 {\n create_message_discovery_call()\n } else {\n quote {}\n };\n\n // Finally, we need to change the return type to be `PrivateCircuitPublicInputs`, which is what the Private Kernel\n // circuit expects.\n let return_value_var_name = quote { macro__returned__values };\n\n let return_value_type = f.return_type();\n let return_value = if body.len() == 0 {\n quote {}\n } else if return_value_type != type_of(()) {\n // The original return value is passed to a second args hasher which the context receives.\n let (body_without_return, last_body_expr) = body.pop_back();\n let return_value = last_body_expr.quoted();\n let return_value_assignment =\n quote { let $return_value_var_name: $return_value_type = $return_value; };\n let return_hasher_name = quote { return_hasher };\n let return_value_into_hasher =\n add_to_hasher(return_hasher_name, return_value_var_name, return_value_type);\n\n body = body_without_return;\n\n quote {\n let mut $return_hasher_name = dep::aztec::hash::ArgsHasher::new();\n $return_value_assignment\n $return_value_into_hasher\n context.set_return_hash($return_hasher_name);\n }\n } else {\n let (body_without_return, last_body_expr) = body.pop_back();\n if !last_body_expr.has_semicolon()\n & last_body_expr.as_for().is_none()\n & last_body_expr.as_assert().is_none()\n & last_body_expr.as_for_range().is_none()\n & last_body_expr.as_assert_eq().is_none()\n & last_body_expr.as_let().is_none() {\n let unused_return_value_name = f\"_{return_value_var_name}\".quoted_contents();\n body = body_without_return.push_back(\n quote { let $unused_return_value_name = $last_body_expr; }.as_expr().unwrap(),\n );\n }\n quote {}\n };\n\n let context_finish = quote { context.finish() };\n\n let to_prepend = quote {\n $args_hasher\n $context_creation\n $assert_initializer\n $init_check\n $internal_check\n $view_check\n $storage_init\n $message_discovery_call\n };\n\n let to_append = quote {\n $return_value\n $mark_as_initialized\n $context_finish\n };\n let modified_body = modify_fn_body(body, to_prepend, to_append);\n f.set_body(modified_body);\n f.set_return_type(\n quote { dep::protocol_types::abis::private_circuit_public_inputs::PrivateCircuitPublicInputs }\n .as_type(),\n );\n f.set_return_data();\n\n fn_abi\n}\n\npub(crate) comptime fn transform_public(f: FunctionDefinition) -> Quoted {\n let fn_abi = create_fn_abi_export(f);\n let fn_stub = stub_fn(f);\n stub_registry::register(f.module(), fn_stub);\n\n // If a function is further modified as unconstrained, we throw an error\n if f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[public] but marked as unconstrained, remove unconstrained keyword\",\n );\n }\n\n let module_has_initializer = module_has_initializer(f.module());\n let module_has_storage = module_has_storage(f.module());\n\n // Public functions undergo a lot of transformations from their Aztec.nr form.\n let original_params = f.parameters();\n let args_len = original_params\n .map(|(name, typ): (Quoted, Type)| {\n generate_serialize_to_fields(name, typ, &[], false).0.len()\n })\n .fold(0, |acc: u32, val: u32| acc + val);\n\n // Unlike in the private case, in public the `context` does not need to receive the hash of the original params.\n let context_creation = quote {\n let mut context = dep::aztec::context::public_context::PublicContext::new(|| {\n // We start from 1 because we skip the selector for the dispatch function.\n let serialized_args : [Field; $args_len] = dep::aztec::context::public_context::calldata_copy(1, $args_len);\n dep::aztec::hash::hash_args_array(serialized_args)\n });\n };\n\n // Modifications introduced by the different marker attributes.\n let internal_check = if is_fn_internal(f) {\n create_internal_check(f)\n } else {\n quote {}\n };\n\n let view_check = if is_fn_view(f) {\n create_view_check(f)\n } else {\n quote {}\n };\n\n let (assert_initializer, mark_as_initialized) = if is_fn_initializer(f) {\n (create_assert_correct_initializer_args(f), create_mark_as_initialized(f))\n } else {\n (quote {}, quote {})\n };\n\n let storage_init = if module_has_storage {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n quote {\n #[allow(unused_variables)]\n let storage = Storage::init(&mut context);\n }\n } else {\n quote {}\n };\n\n // Initialization checks are not included in contracts that don't have initializers.\n let init_check = if module_has_initializer & !fn_has_noinitcheck(f) & !is_fn_initializer(f) {\n create_init_check(f)\n } else {\n quote {}\n };\n\n let to_prepend = quote {\n $context_creation\n $assert_initializer\n $init_check\n $internal_check\n $view_check\n $storage_init\n };\n\n let to_append = quote {\n $mark_as_initialized\n };\n\n let body = f.body().as_block().unwrap();\n let modified_body = modify_fn_body(body, to_prepend, to_append);\n f.set_body(modified_body);\n\n // All public functions are automatically made unconstrained, even if they were not marked as such. This is because\n // instead of compiling into a circuit, they will compile to bytecode that will be later transpiled into AVM\n // bytecode.\n f.set_unconstrained(true);\n f.set_return_public(true);\n\n fn_abi\n}\n\npub(crate) comptime fn transform_utility(f: FunctionDefinition) {\n // Check if function is marked as unconstrained\n if !f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[utility] but not marked as unconstrained, add unconstrained keyword\",\n );\n }\n\n // Create utility context\n let context_creation =\n quote { let mut context = dep::aztec::context::utility_context::UtilityContext::new(); };\n let module_has_storage = module_has_storage(f.module());\n\n // Initialize Storage if module has storage\n let storage_init = if module_has_storage {\n quote {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n #[allow(unused_variables)]\n let storage = Storage::init(context);\n }\n } else {\n quote {}\n };\n\n // All utility functions perform message discovery, since they may need to access private notes that would be\n // found during this process. This is slightly inefficient and could be improved by only doing it once we actually\n // attempt to read any.\n let message_discovery_call = if NOTES.len() > 0 {\n create_message_discovery_call()\n } else {\n quote {}\n };\n\n // Inject context creation, storage initialization, and message discovery call at the beginning of the function\n // body.\n let to_prepend = quote {\n $context_creation\n $storage_init\n $message_discovery_call\n };\n let body = f.body().as_block().unwrap();\n let modified_body = modify_fn_body(body, to_prepend, quote {});\n f.set_body(modified_body);\n\n f.set_return_public(true);\n}\n\ncomptime fn create_internal_check(f: FunctionDefinition) -> Quoted {\n let name = f.name();\n let assertion_message = f\"Function {name} can only be called internally\";\n quote { assert(context.msg_sender() == context.this_address(), $assertion_message); }\n}\n\ncomptime fn create_view_check(f: FunctionDefinition) -> Quoted {\n let name = f.name();\n let assertion_message = f\"Function {name} can only be called statically\";\n if is_fn_private(f) {\n // Here `context` is of type context::PrivateContext\n quote { assert(context.inputs.call_context.is_static_call == true, $assertion_message); }\n } else {\n // Here `context` is of type context::PublicContext\n quote { assert(context.is_static_call(), $assertion_message); }\n }\n}\n\ncomptime fn create_assert_correct_initializer_args(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::assert_initialization_matches_address_preimage_{fn_visibility}(context);\"\n .quoted_contents()\n}\n\ncomptime fn create_mark_as_initialized(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::mark_as_initialized_{fn_visibility}(&mut context);\"\n .quoted_contents()\n}\n\ncomptime fn create_init_check(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::assert_is_initialized_{fn_visibility}(&mut context);\"\n .quoted_contents()\n}\n\n/// Injects a call to `aztec::discovery::discover_new_messages`, causing for new notes to be added to PXE and made\n/// available for the current execution.\npub(crate) comptime fn create_message_discovery_call() -> Quoted {\n quote {\n /// Safety: message discovery returns nothing and is performed solely for its side-effects. It is therefore\n /// always safe to call.\n unsafe {\n dep::aztec::discovery::discover_new_messages(\n context.this_address(),\n _compute_note_hash_and_nullifier,\n );\n };\n }\n}\n\n/// Checks if each function in the module is marked with either #[private], #[public], #[utility],\n/// #[contract_library_method], or #[test]. Non-macroified functions are not allowed in contracts.\npub(crate) comptime fn check_each_fn_macroified(m: Module) {\n for f in m.functions() {\n let name = f.name();\n if !is_fn_private(f)\n & !is_fn_public(f)\n & !is_fn_utility(f)\n & !is_fn_contract_library_method(f)\n & !is_fn_test(f) {\n panic(\n f\"Function {name} must be marked as either #[private], #[public], #[utility], #[contract_library_method], or #[test]\",\n );\n }\n }\n}\n"
1832
+ "source": "use crate::macros::{\n functions::{abi_export::create_fn_abi_export, call_interface_stubs::stub_fn, stub_registry},\n notes::NOTES,\n utils::{\n add_to_hasher, fn_has_noinitcheck, get_fn_visibility, is_fn_contract_library_method,\n is_fn_initializer, is_fn_internal, is_fn_private, is_fn_public, is_fn_test, is_fn_utility,\n is_fn_view, modify_fn_body, module_has_initializer, module_has_storage,\n },\n};\nuse protocol_types::meta::generate_serialize_to_fields;\nuse std::meta::type_of;\n\npub(crate) comptime fn transform_private(f: FunctionDefinition) -> Quoted {\n let fn_abi = create_fn_abi_export(f);\n let fn_stub = stub_fn(f);\n stub_registry::register(f.module(), fn_stub);\n\n // If a function is further modified as unconstrained, we throw an error\n if f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[private] but marked as unconstrained, remove unconstrained keyword\",\n );\n }\n\n let module_has_initializer = module_has_initializer(f.module());\n let module_has_storage = module_has_storage(f.module());\n\n // Private functions undergo a lot of transformations from their Aztec.nr form into a circuit that can be fed to the\n // Private Kernel Circuit.\n // First we change the function signature so that it also receives `PrivateContextInputs`, which contain information\n // about the execution context (e.g. the caller).\n let original_params = f.parameters();\n f.set_parameters(&[(\n quote { inputs },\n quote { crate::context::inputs::private_context_inputs::PrivateContextInputs }.as_type(),\n )]\n .append(original_params));\n\n let mut body = f.body().as_block().unwrap();\n\n // The original params are hashed and passed to the `context` object, so that the kernel can verify we've received\n // the correct values.\n // TODO: Optimize args_hasher for small number of arguments\n let args_hasher_name = quote { args_hasher };\n let args_hasher = original_params.fold(\n quote {\n let mut $args_hasher_name = dep::aztec::hash::ArgsHasher::new();\n },\n |args_hasher, param: (Quoted, Type)| {\n let (name, typ) = param;\n let appended_arg = add_to_hasher(args_hasher_name, name, typ);\n quote {\n $args_hasher\n $appended_arg\n }\n },\n );\n\n let context_creation = quote {\n let mut context = dep::aztec::context::private_context::PrivateContext::new(inputs, dep::aztec::protocol_types::traits::Hash::hash($args_hasher_name));\n };\n\n // Modifications introduced by the different marker attributes.\n let internal_check = if is_fn_internal(f) {\n create_internal_check(f)\n } else {\n quote {}\n };\n\n let view_check = if is_fn_view(f) {\n create_view_check(f)\n } else {\n quote {}\n };\n\n let (assert_initializer, mark_as_initialized) = if is_fn_initializer(f) {\n (create_assert_correct_initializer_args(f), create_mark_as_initialized(f))\n } else {\n (quote {}, quote {})\n };\n\n let storage_init = if module_has_storage {\n quote {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n #[allow(unused_variables)]\n let storage = Storage::init(&mut context);\n }\n } else {\n quote {}\n };\n\n // Initialization checks are not included in contracts that don't have initializers.\n let init_check = if module_has_initializer & !is_fn_initializer(f) & !fn_has_noinitcheck(f) {\n create_init_check(f)\n } else {\n quote {}\n };\n\n // All private functions perform message discovery, since they may need to access notes. This is slightly\n // inefficient and could be improved by only doing it once we actually attempt to read any.\n let message_discovery_call = if NOTES.len() > 0 {\n create_message_discovery_call()\n } else {\n quote {}\n };\n\n // Finally, we need to change the return type to be `PrivateCircuitPublicInputs`, which is what the Private Kernel\n // circuit expects.\n let return_value_var_name = quote { macro__returned__values };\n\n let return_value_type = f.return_type();\n let return_value = if body.len() == 0 {\n quote {}\n } else if return_value_type != type_of(()) {\n // The original return value is passed to a second args hasher which the context receives.\n let (body_without_return, last_body_expr) = body.pop_back();\n let return_value = last_body_expr.quoted();\n let return_value_assignment =\n quote { let $return_value_var_name: $return_value_type = $return_value; };\n let return_hasher_name = quote { return_hasher };\n let return_value_into_hasher =\n add_to_hasher(return_hasher_name, return_value_var_name, return_value_type);\n\n body = body_without_return;\n\n quote {\n let mut $return_hasher_name = dep::aztec::hash::ArgsHasher::new();\n $return_value_assignment\n $return_value_into_hasher\n context.set_return_hash($return_hasher_name);\n }\n } else {\n let (body_without_return, last_body_expr) = body.pop_back();\n if !last_body_expr.has_semicolon()\n & last_body_expr.as_for().is_none()\n & last_body_expr.as_assert().is_none()\n & last_body_expr.as_for_range().is_none()\n & last_body_expr.as_assert_eq().is_none()\n & last_body_expr.as_let().is_none() {\n let unused_return_value_name = f\"_{return_value_var_name}\".quoted_contents();\n body = body_without_return.push_back(\n quote { let $unused_return_value_name = $last_body_expr; }.as_expr().unwrap(),\n );\n }\n quote {}\n };\n\n let context_finish = quote { context.finish() };\n\n let to_prepend = quote {\n $args_hasher\n $context_creation\n $assert_initializer\n $init_check\n $internal_check\n $view_check\n $storage_init\n $message_discovery_call\n };\n\n let to_append = quote {\n $return_value\n $mark_as_initialized\n $context_finish\n };\n let modified_body = modify_fn_body(body, to_prepend, to_append);\n f.set_body(modified_body);\n f.set_return_type(\n quote { dep::protocol_types::abis::private_circuit_public_inputs::PrivateCircuitPublicInputs }\n .as_type(),\n );\n f.set_return_data();\n\n fn_abi\n}\n\npub(crate) comptime fn transform_public(f: FunctionDefinition) -> Quoted {\n let fn_abi = create_fn_abi_export(f);\n let fn_stub = stub_fn(f);\n stub_registry::register(f.module(), fn_stub);\n\n // If a function is further modified as unconstrained, we throw an error\n if f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[public] but marked as unconstrained, remove unconstrained keyword\",\n );\n }\n\n let module_has_initializer = module_has_initializer(f.module());\n let module_has_storage = module_has_storage(f.module());\n\n // Public functions undergo a lot of transformations from their Aztec.nr form.\n let original_params = f.parameters();\n let args_len = original_params\n .map(|(name, typ): (Quoted, Type)| {\n generate_serialize_to_fields(name, typ, &[], false).0.len()\n })\n .fold(0, |acc: u32, val: u32| acc + val);\n\n // Unlike in the private case, in public the `context` does not need to receive the hash of the original params.\n let context_creation = quote {\n let mut context = dep::aztec::context::public_context::PublicContext::new(|| {\n // We start from 1 because we skip the selector for the dispatch function.\n let serialized_args : [Field; $args_len] = dep::aztec::context::public_context::calldata_copy(1, $args_len);\n dep::aztec::hash::hash_args_array(serialized_args)\n });\n };\n\n // Modifications introduced by the different marker attributes.\n let internal_check = if is_fn_internal(f) {\n create_internal_check(f)\n } else {\n quote {}\n };\n\n let view_check = if is_fn_view(f) {\n create_view_check(f)\n } else {\n quote {}\n };\n\n let (assert_initializer, mark_as_initialized) = if is_fn_initializer(f) {\n (create_assert_correct_initializer_args(f), create_mark_as_initialized(f))\n } else {\n (quote {}, quote {})\n };\n\n let storage_init = if module_has_storage {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n quote {\n #[allow(unused_variables)]\n let storage = Storage::init(&mut context);\n }\n } else {\n quote {}\n };\n\n // Initialization checks are not included in contracts that don't have initializers.\n let init_check = if module_has_initializer & !fn_has_noinitcheck(f) & !is_fn_initializer(f) {\n create_init_check(f)\n } else {\n quote {}\n };\n\n let to_prepend = quote {\n $context_creation\n $assert_initializer\n $init_check\n $internal_check\n $view_check\n $storage_init\n };\n\n let to_append = quote {\n $mark_as_initialized\n };\n\n let body = f.body().as_block().unwrap();\n let modified_body = modify_fn_body(body, to_prepend, to_append);\n f.set_body(modified_body);\n\n // All public functions are automatically made unconstrained, even if they were not marked as such. This is because\n // instead of compiling into a circuit, they will compile to bytecode that will be later transpiled into AVM\n // bytecode.\n f.set_unconstrained(true);\n f.set_return_public(true);\n\n fn_abi\n}\n\npub(crate) comptime fn transform_utility(f: FunctionDefinition) {\n // Check if function is marked as unconstrained\n if !f.is_unconstrained() {\n let name = f.name();\n panic(\n f\"Function {name} is annotated with #[utility] but not marked as unconstrained, add unconstrained keyword\",\n );\n }\n\n // Create utility context\n let context_creation =\n quote { let mut context = dep::aztec::context::utility_context::UtilityContext::new(); };\n let module_has_storage = module_has_storage(f.module());\n\n // Initialize Storage if module has storage\n let storage_init = if module_has_storage {\n quote {\n // Some functions don't access storage, but it'd be quite difficult to only inject this variable if it is\n // referenced. We instead ignore 'unused variable' warnings for it.\n #[allow(unused_variables)]\n let storage = Storage::init(context);\n }\n } else {\n quote {}\n };\n\n // All utility functions perform message discovery, since they may need to access private notes that would be\n // found during this process. This is slightly inefficient and could be improved by only doing it once we actually\n // attempt to read any.\n let message_discovery_call = if NOTES.len() > 0 {\n create_message_discovery_call()\n } else {\n quote {}\n };\n\n // Inject context creation, storage initialization, and message discovery call at the beginning of the function\n // body.\n let to_prepend = quote {\n $context_creation\n $storage_init\n $message_discovery_call\n };\n let body = f.body().as_block().unwrap();\n let modified_body = modify_fn_body(body, to_prepend, quote {});\n f.set_body(modified_body);\n\n f.set_return_public(true);\n}\n\ncomptime fn create_internal_check(f: FunctionDefinition) -> Quoted {\n let name = f.name();\n let assertion_message = f\"Function {name} can only be called internally\";\n quote { assert(context.msg_sender() == context.this_address(), $assertion_message); }\n}\n\ncomptime fn create_view_check(f: FunctionDefinition) -> Quoted {\n let name = f.name();\n let assertion_message = f\"Function {name} can only be called statically\";\n if is_fn_private(f) {\n // Here `context` is of type context::PrivateContext\n quote { assert(context.inputs.call_context.is_static_call == true, $assertion_message); }\n } else {\n // Here `context` is of type context::PublicContext\n quote { assert(context.is_static_call(), $assertion_message); }\n }\n}\n\ncomptime fn create_assert_correct_initializer_args(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::assert_initialization_matches_address_preimage_{fn_visibility}(context);\"\n .quoted_contents()\n}\n\ncomptime fn create_mark_as_initialized(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::mark_as_initialized_{fn_visibility}(&mut context);\"\n .quoted_contents()\n}\n\ncomptime fn create_init_check(f: FunctionDefinition) -> Quoted {\n let fn_visibility = get_fn_visibility(f);\n f\"dep::aztec::macros::functions::initialization_utils::assert_is_initialized_{fn_visibility}(&mut context);\"\n .quoted_contents()\n}\n\n/// Injects a call to `aztec::messages::discovery::discover_new_messages`, causing for new notes to be added to PXE and made\n/// available for the current execution.\npub(crate) comptime fn create_message_discovery_call() -> Quoted {\n quote {\n /// Safety: message discovery returns nothing and is performed solely for its side-effects. It is therefore\n /// always safe to call.\n unsafe {\n dep::aztec::messages::discovery::discover_new_messages(\n context.this_address(),\n _compute_note_hash_and_nullifier,\n );\n };\n }\n}\n\n/// Checks if each function in the module is marked with either #[private], #[public], #[utility],\n/// #[contract_library_method], or #[test]. Non-macroified functions are not allowed in contracts.\npub(crate) comptime fn check_each_fn_macroified(m: Module) {\n for f in m.functions() {\n let name = f.name();\n if !is_fn_private(f)\n & !is_fn_public(f)\n & !is_fn_utility(f)\n & !is_fn_contract_library_method(f)\n & !is_fn_test(f) {\n panic(\n f\"Function {name} must be marked as either #[private], #[public], #[utility], #[contract_library_method], or #[test]\",\n );\n }\n }\n}\n"
1833
1833
  },
1834
- "148": {
1834
+ "143": {
1835
1835
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/oracle/call_private_function.nr",
1836
1836
  "source": "use dep::protocol_types::{\n abis::function_selector::FunctionSelector, address::AztecAddress, utils::reader::Reader,\n};\n\n#[oracle(callPrivateFunction)]\nunconstrained fn call_private_function_oracle(\n _contract_address: AztecAddress,\n _function_selector: FunctionSelector,\n _args_hash: Field,\n _start_side_effect_counter: u32,\n _is_static_call: bool,\n) -> [Field; 2] {}\n\npub unconstrained fn call_private_function_internal(\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args_hash: Field,\n start_side_effect_counter: u32,\n is_static_call: bool,\n) -> (u32, Field) {\n let fields = call_private_function_oracle(\n contract_address,\n function_selector,\n args_hash,\n start_side_effect_counter,\n is_static_call,\n );\n\n let mut reader = Reader::new(fields);\n let end_side_effect_counter = reader.read_u32();\n let returns_hash = reader.read();\n\n (end_side_effect_counter, returns_hash)\n}\n"
1837
1837
  },
1838
- "150": {
1838
+ "145": {
1839
1839
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/oracle/enqueue_public_function_call.nr",
1840
1840
  "source": "use dep::protocol_types::address::AztecAddress;\n\n#[oracle(notifyEnqueuedPublicFunctionCall)]\nunconstrained fn notify_enqueued_public_function_call_oracle(\n _contract_address: AztecAddress,\n _calldata_hash: Field,\n _side_effect_counter: u32,\n _is_static_call: bool,\n) {}\n\nunconstrained fn notify_enqueued_public_function_call_wrapper(\n contract_address: AztecAddress,\n calldata_hash: Field,\n side_effect_counter: u32,\n is_static_call: bool,\n) {\n notify_enqueued_public_function_call_oracle(\n contract_address,\n calldata_hash,\n side_effect_counter,\n is_static_call,\n )\n}\n\npub fn notify_enqueued_public_function_call(\n contract_address: AztecAddress,\n calldata_hash: Field,\n side_effect_counter: u32,\n is_static_call: bool,\n) {\n // Safety: Notifies the simulator that a public call has been enqueued, allowing it to prepare hints for the AVM to process this call.\n unsafe {\n notify_enqueued_public_function_call_wrapper(\n contract_address,\n calldata_hash,\n side_effect_counter,\n is_static_call,\n )\n }\n}\n\n#[oracle(notifySetPublicTeardownFunctionCall)]\nunconstrained fn notify_set_public_teardown_function_call_oracle(\n _contract_address: AztecAddress,\n _calldata_hash: Field,\n _side_effect_counter: u32,\n _is_static_call: bool,\n) {}\n\nunconstrained fn notify_set_public_teardown_function_call_wrapper(\n contract_address: AztecAddress,\n calldata_hash: Field,\n side_effect_counter: u32,\n is_static_call: bool,\n) {\n notify_set_public_teardown_function_call_oracle(\n contract_address,\n calldata_hash,\n side_effect_counter,\n is_static_call,\n )\n}\n\npub fn notify_set_public_teardown_function_call(\n contract_address: AztecAddress,\n calldata_hash: Field,\n side_effect_counter: u32,\n is_static_call: bool,\n) {\n // Safety: Notifies the simulator that a teardown call has been set, allowing it to prepare hints for the AVM to process this call.\n unsafe {\n notify_set_public_teardown_function_call_wrapper(\n contract_address,\n calldata_hash,\n side_effect_counter,\n is_static_call,\n )\n }\n}\n\npub fn notify_set_min_revertible_side_effect_counter(counter: u32) {\n // Safety: This oracle call returns nothing: we only call it for its side effects. It is therefore always safe\n // to call.\n unsafe { notify_set_min_revertible_side_effect_counter_oracle_wrapper(counter) };\n}\n\npub unconstrained fn notify_set_min_revertible_side_effect_counter_oracle_wrapper(counter: u32) {\n notify_set_min_revertible_side_effect_counter_oracle(counter);\n}\n\n#[oracle(notifySetMinRevertibleSideEffectCounter)]\nunconstrained fn notify_set_min_revertible_side_effect_counter_oracle(_counter: u32) {}\n"
1841
1841
  },
1842
- "151": {
1842
+ "146": {
1843
1843
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/oracle/execution.nr",
1844
1844
  "source": "use dep::protocol_types::address::AztecAddress;\n\n#[oracle(getContractAddress)]\nunconstrained fn get_contract_address_oracle() -> AztecAddress {}\n\n#[oracle(getBlockNumber)]\nunconstrained fn get_block_number_oracle() -> u32 {}\n\n#[oracle(getChainId)]\nunconstrained fn get_chain_id_oracle() -> Field {}\n\n#[oracle(getVersion)]\nunconstrained fn get_version_oracle() -> Field {}\n\npub unconstrained fn get_contract_address() -> AztecAddress {\n get_contract_address_oracle()\n}\n\npub unconstrained fn get_block_number() -> u32 {\n get_block_number_oracle()\n}\n\npub unconstrained fn get_chain_id() -> Field {\n get_chain_id_oracle()\n}\n\npub unconstrained fn get_version() -> Field {\n get_version_oracle()\n}\n"
1845
1845
  },
1846
- "267": {
1846
+ "270": {
1847
1847
  "path": "/home/aztec-dev/aztec-packages/noir-projects/noir-protocol-circuits/crates/types/src/address/aztec_address.nr",
1848
1848
  "source": "use crate::{\n address::{\n partial_address::PartialAddress, salted_initialization_hash::SaltedInitializationHash,\n },\n constants::{\n AZTEC_ADDRESS_LENGTH, GENERATOR_INDEX__CONTRACT_ADDRESS_V1, MAX_FIELD_VALUE,\n MAX_PROTOCOL_CONTRACTS,\n },\n contract_class_id::ContractClassId,\n hash::poseidon2_hash_with_separator,\n public_keys::{IvpkM, NpkM, OvpkM, PublicKeys, ToPoint, TpkM},\n traits::{Deserialize, Empty, FromField, Packable, Serialize, ToField},\n utils::field::{pow, sqrt},\n};\n\n// We do below because `use crate::point::Point;` does not work\nuse dep::std::embedded_curve_ops::EmbeddedCurvePoint as Point;\n\nuse crate::public_keys::AddressPoint;\nuse std::{\n embedded_curve_ops::{EmbeddedCurveScalar, fixed_base_scalar_mul as derive_public_key},\n ops::Add,\n};\n\n// Aztec address\npub struct AztecAddress {\n pub inner: Field,\n}\n\nimpl Eq for AztecAddress {\n fn eq(self, other: Self) -> bool {\n self.to_field() == other.to_field()\n }\n}\n\nimpl Empty for AztecAddress {\n fn empty() -> Self {\n Self { inner: 0 }\n }\n}\n\nimpl ToField for AztecAddress {\n fn to_field(self) -> Field {\n self.inner\n }\n}\n\nimpl FromField for AztecAddress {\n fn from_field(value: Field) -> AztecAddress {\n AztecAddress { inner: value }\n }\n}\n\nimpl Serialize<AZTEC_ADDRESS_LENGTH> for AztecAddress {\n fn serialize(self: Self) -> [Field; AZTEC_ADDRESS_LENGTH] {\n [self.to_field()]\n }\n}\n\nimpl Deserialize<AZTEC_ADDRESS_LENGTH> for AztecAddress {\n fn deserialize(fields: [Field; AZTEC_ADDRESS_LENGTH]) -> Self {\n FromField::from_field(fields[0])\n }\n}\n\n/// We implement the Packable trait for AztecAddress because it can be stored in contract's storage (and there\n/// the implementation of Packable is required).\nimpl Packable<AZTEC_ADDRESS_LENGTH> for AztecAddress {\n fn pack(self) -> [Field; AZTEC_ADDRESS_LENGTH] {\n self.serialize()\n }\n\n fn unpack(fields: [Field; AZTEC_ADDRESS_LENGTH]) -> Self {\n Self::deserialize(fields)\n }\n}\n\nimpl AztecAddress {\n pub fn zero() -> Self {\n Self { inner: 0 }\n }\n\n pub fn to_address_point(self) -> AddressPoint {\n // We compute the address point by taking our address, setting it to x, and then solving for y in the\n // equation which defines our bn curve:\n // y^2 = x^3 - 17; x = address\n let x = self.inner;\n let y_squared = pow(x, 3) - 17;\n\n // TODO (#8970): Handle cases where we cannot recover a point from an address\n let mut y = sqrt(y_squared);\n\n // If we get a negative y coordinate (any y where y > MAX_FIELD_VALUE / 2), we pin it to the\n // positive one (any value where y <= MAX_FIELD_VALUE / 2) by subtracting it from the Field modulus\n // note: The field modulus is MAX_FIELD_VALUE + 1\n if (!(y.lt(MAX_FIELD_VALUE / 2) | y.eq(MAX_FIELD_VALUE / 2))) {\n y = (MAX_FIELD_VALUE + 1) - y;\n }\n\n AddressPoint { inner: Point { x: self.inner, y, is_infinite: false } }\n }\n\n pub fn compute(public_keys: PublicKeys, partial_address: PartialAddress) -> AztecAddress {\n let public_keys_hash = public_keys.hash();\n\n let pre_address = poseidon2_hash_with_separator(\n [public_keys_hash.to_field(), partial_address.to_field()],\n GENERATOR_INDEX__CONTRACT_ADDRESS_V1,\n );\n\n let address_point = derive_public_key(EmbeddedCurveScalar::from_field(pre_address)).add(\n public_keys.ivpk_m.to_point(),\n );\n\n // Note that our address is only the x-coordinate of the full address_point. This is okay because when people want to encrypt something and send it to us\n // they can recover our full point using the x-coordinate (our address itself). To do this, they recompute the y-coordinate according to the equation y^2 = x^3 - 17.\n // When they do this, they may get a positive y-coordinate (a value that is less than or equal to MAX_FIELD_VALUE / 2) or\n // a negative y-coordinate (a value that is more than MAX_FIELD_VALUE), and we cannot dictate which one they get and hence the recovered point may sometimes be different than the one\n // our secret can decrypt. Regardless though, they should and will always encrypt using point with the positive y-coordinate by convention.\n // This ensures that everyone encrypts to the same point given an arbitrary x-coordinate (address). This is allowed because even though our original point may not have a positive y-coordinate,\n // with our original secret, we will be able to derive the secret to the point with the flipped (and now positive) y-coordinate that everyone encrypts to.\n AztecAddress::from_field(address_point.x)\n }\n\n pub fn compute_from_class_id(\n contract_class_id: ContractClassId,\n salted_initialization_hash: SaltedInitializationHash,\n public_keys: PublicKeys,\n ) -> Self {\n let partial_address = PartialAddress::compute_from_salted_initialization_hash(\n contract_class_id,\n salted_initialization_hash,\n );\n\n AztecAddress::compute(public_keys, partial_address)\n }\n\n pub fn is_protocol_contract(self) -> bool {\n self.inner.lt(MAX_PROTOCOL_CONTRACTS as Field)\n }\n\n pub fn is_zero(self) -> bool {\n self.inner == 0\n }\n\n pub fn assert_is_zero(self) {\n assert(self.to_field() == 0);\n }\n}\n\n#[test]\nfn compute_address_from_partial_and_pub_keys() {\n let public_keys = PublicKeys {\n npk_m: NpkM {\n inner: Point {\n x: 0x22f7fcddfa3ce3e8f0cc8e82d7b94cdd740afa3e77f8e4a63ea78a239432dcab,\n y: 0x0471657de2b6216ade6c506d28fbc22ba8b8ed95c871ad9f3e3984e90d9723a7,\n is_infinite: false,\n },\n },\n ivpk_m: IvpkM {\n inner: Point {\n x: 0x111223493147f6785514b1c195bb37a2589f22a6596d30bb2bb145fdc9ca8f1e,\n y: 0x273bbffd678edce8fe30e0deafc4f66d58357c06fd4a820285294b9746c3be95,\n is_infinite: false,\n },\n },\n ovpk_m: OvpkM {\n inner: Point {\n x: 0x09115c96e962322ffed6522f57194627136b8d03ac7469109707f5e44190c484,\n y: 0x0c49773308a13d740a7f0d4f0e6163b02c5a408b6f965856b6a491002d073d5b,\n is_infinite: false,\n },\n },\n tpk_m: TpkM {\n inner: Point {\n x: 0x00d3d81beb009873eb7116327cf47c612d5758ef083d4fda78e9b63980b2a762,\n y: 0x2f567d22d2b02fe1f4ad42db9d58a36afd1983e7e2909d1cab61cafedad6193a,\n is_infinite: false,\n },\n },\n };\n\n let partial_address = PartialAddress::from_field(\n 0x0a7c585381b10f4666044266a02405bf6e01fa564c8517d4ad5823493abd31de,\n );\n\n let address = AztecAddress::compute(public_keys, partial_address);\n\n // The following value was generated by `derivation.test.ts`.\n // --> Run the test with AZTEC_GENERATE_TEST_DATA=1 flag to update test data.\n let expected_computed_address_from_partial_and_pubkeys =\n 0x24e4646f58b9fbe7d38e317db8d5636c423fbbdfbe119fc190fe9c64747e0c62;\n assert(address.to_field() == expected_computed_address_from_partial_and_pubkeys);\n}\n\n#[test]\nfn compute_preaddress_from_partial_and_pub_keys() {\n let pre_address = poseidon2_hash_with_separator([1, 2], GENERATOR_INDEX__CONTRACT_ADDRESS_V1);\n let expected_computed_preaddress_from_partial_and_pubkey =\n 0x23ce9be3fa3c846b0f9245cc796902e731d04f086e8a42473bb29e405fc98075;\n assert(pre_address == expected_computed_preaddress_from_partial_and_pubkey);\n}\n\n#[test]\nfn from_field_to_field() {\n let address = AztecAddress { inner: 37 };\n assert_eq(FromField::from_field(address.to_field()), address);\n}\n\n#[test]\nfn serde() {\n let address = AztecAddress { inner: 37 };\n assert_eq(Deserialize::deserialize(address.serialize()), address);\n}\n"
1849
1849
  },
1850
- "285": {
1850
+ "288": {
1851
1851
  "path": "/home/aztec-dev/aztec-packages/noir-projects/noir-protocol-circuits/crates/types/src/hash.nr",
1852
1852
  "source": "use crate::{\n abis::{\n contract_class_function_leaf_preimage::ContractClassFunctionLeafPreimage,\n contract_class_log::ContractClassLog,\n function_selector::FunctionSelector,\n note_hash::ScopedNoteHash,\n nullifier::ScopedNullifier,\n private_log::{PrivateLog, PrivateLogData},\n side_effect::{OrderedValue, scoped::Scoped},\n },\n address::{AztecAddress, EthAddress},\n constants::{\n FUNCTION_TREE_HEIGHT, GENERATOR_INDEX__NOTE_HASH_NONCE, GENERATOR_INDEX__OUTER_NULLIFIER,\n GENERATOR_INDEX__SILOED_NOTE_HASH, GENERATOR_INDEX__UNIQUE_NOTE_HASH, TWO_POW_64,\n },\n merkle_tree::root::root_from_sibling_path,\n messaging::l2_to_l1_message::{L2ToL1Message, ScopedL2ToL1Message},\n poseidon2::Poseidon2Sponge,\n traits::{FromField, Hash, ToField},\n utils::{\n arrays::{array_concat, unsafe_padded_array_length},\n field::{field_from_bytes, field_from_bytes_32_trunc},\n },\n};\n\npub fn sha256_to_field<let N: u32>(bytes_to_hash: [u8; N]) -> Field {\n let sha256_hashed = sha256::digest(bytes_to_hash);\n let hash_in_a_field = field_from_bytes_32_trunc(sha256_hashed);\n\n hash_in_a_field\n}\n\npub fn private_functions_root_from_siblings(\n selector: FunctionSelector,\n vk_hash: Field,\n function_leaf_index: Field,\n function_leaf_sibling_path: [Field; FUNCTION_TREE_HEIGHT],\n) -> Field {\n let function_leaf_preimage = ContractClassFunctionLeafPreimage { selector, vk_hash };\n let function_leaf = function_leaf_preimage.hash();\n root_from_sibling_path(\n function_leaf,\n function_leaf_index,\n function_leaf_sibling_path,\n )\n}\n\npub fn compute_note_hash_nonce(first_nullifier_in_tx: Field, note_index_in_tx: u32) -> Field {\n // Hashing the first nullifier with note index in tx is guaranteed to be unique (because all nullifiers are also\n // unique).\n poseidon2_hash_with_separator(\n [first_nullifier_in_tx, note_index_in_tx as Field],\n GENERATOR_INDEX__NOTE_HASH_NONCE,\n )\n}\n\npub fn compute_unique_note_hash(nonce: Field, siloed_note_hash: Field) -> Field {\n let inputs = [nonce, siloed_note_hash];\n poseidon2_hash_with_separator(inputs, GENERATOR_INDEX__UNIQUE_NOTE_HASH)\n}\n\npub fn compute_siloed_note_hash(app: AztecAddress, note_hash: Field) -> Field {\n poseidon2_hash_with_separator(\n [app.to_field(), note_hash],\n GENERATOR_INDEX__SILOED_NOTE_HASH,\n )\n}\n\n/// Computes unique note hashes from siloed note hashes\npub fn compute_unique_siloed_note_hash(\n siloed_note_hash: Field,\n first_nullifier: Field,\n note_index_in_tx: u32,\n) -> Field {\n if siloed_note_hash == 0 {\n 0\n } else {\n let nonce = compute_note_hash_nonce(first_nullifier, note_index_in_tx);\n compute_unique_note_hash(nonce, siloed_note_hash)\n }\n}\n\n/// Siloing in the context of Aztec refers to the process of hashing a note hash with a contract address (this way\n/// the note hash is scoped to a specific contract). This is used to prevent intermingling of notes between contracts.\npub fn silo_note_hash(note_hash: ScopedNoteHash) -> Field {\n if note_hash.contract_address.is_zero() {\n 0\n } else {\n compute_siloed_note_hash(note_hash.contract_address, note_hash.value())\n }\n}\n\npub fn compute_siloed_nullifier(app: AztecAddress, nullifier: Field) -> Field {\n poseidon2_hash_with_separator(\n [app.to_field(), nullifier],\n GENERATOR_INDEX__OUTER_NULLIFIER,\n )\n}\n\npub fn silo_nullifier(nullifier: ScopedNullifier) -> Field {\n if nullifier.contract_address.is_zero() {\n nullifier.value() // Return value instead of 0 because the first nullifier's contract address is zero.\n } else {\n compute_siloed_nullifier(nullifier.contract_address, nullifier.value())\n }\n}\n\npub fn compute_siloed_private_log_field(contract_address: AztecAddress, field: Field) -> Field {\n poseidon2_hash([contract_address.to_field(), field])\n}\n\npub fn silo_private_log(private_log: Scoped<PrivateLogData>) -> PrivateLog {\n if private_log.contract_address.is_zero() {\n private_log.inner.log\n } else {\n let mut fields = private_log.inner.log.fields;\n fields[0] = compute_siloed_private_log_field(private_log.contract_address, fields[0]);\n PrivateLog { fields }\n }\n}\n\nfn compute_siloed_contract_class_log_field(\n contract_address: AztecAddress,\n first_field: Field,\n) -> Field {\n poseidon2_hash([contract_address.to_field(), first_field])\n}\n\npub fn silo_contract_class_log(contract_class_log: ContractClassLog) -> ContractClassLog {\n if contract_class_log.contract_address.is_zero() {\n contract_class_log\n } else {\n let mut log = contract_class_log;\n log.log.fields[0] = compute_siloed_contract_class_log_field(\n contract_class_log.contract_address,\n log.log.fields[0],\n );\n log\n }\n}\n\npub fn compute_contract_class_log_hash(contract_class_log: ContractClassLog) -> Field {\n let array = contract_class_log.log.fields;\n // Safety: The below length is constrained in the base rollup.\n let length = unsafe { unsafe_padded_array_length(array) };\n if length == 0 {\n 0\n } else {\n poseidon2_hash(array)\n }\n}\n\npub fn merkle_hash(left: Field, right: Field) -> Field {\n poseidon2_hash([left, right])\n}\n\npub fn compute_l2_to_l1_hash(\n contract_address: AztecAddress,\n recipient: EthAddress,\n content: Field,\n rollup_version_id: Field,\n chain_id: Field,\n) -> Field {\n let mut bytes: [u8; 160] = std::mem::zeroed();\n\n let inputs =\n [contract_address.to_field(), rollup_version_id, recipient.to_field(), chain_id, content];\n for i in 0..5 {\n // TODO are bytes be in fr.to_buffer() ?\n let item_bytes: [u8; 32] = inputs[i].to_be_bytes();\n for j in 0..32 {\n bytes[32 * i + j] = item_bytes[j];\n }\n }\n\n sha256_to_field(bytes)\n}\n\npub fn silo_l2_to_l1_message(\n msg: ScopedL2ToL1Message,\n rollup_version_id: Field,\n chain_id: Field,\n) -> Field {\n if msg.contract_address.is_zero() {\n 0\n } else {\n compute_l2_to_l1_hash(\n msg.contract_address,\n msg.message.recipient,\n msg.message.content,\n rollup_version_id,\n chain_id,\n )\n }\n}\n\n// Computes sha256 hash of 2 input hashes.\n//\n// NB: This method now takes in two 31 byte fields - it assumes that any input\n// is the result of a sha_to_field hash and => is truncated\n//\n// TODO(Jan and David): This is used for the encrypted_log hashes.\n// Can we check to see if we can just use hash_to_field or pedersen_compress here?\n//\npub fn accumulate_sha256(input: [Field; 2]) -> Field {\n // This is a note about the cpp code, since it takes an array of Fields\n // instead of a u128.\n // 4 Field elements when converted to bytes will usually\n // occupy 4 * 32 = 128 bytes.\n // However, this function is making the assumption that each Field\n // only occupies 128 bits.\n //\n // TODO(David): This does not seem to be getting guaranteed anywhere in the code?\n // Concatentate two fields into 32x2 = 64 bytes\n // accumulate_sha256 assumes that the inputs are pre-truncated 31 byte numbers\n let mut hash_input_flattened = [0; 64];\n for offset in 0..input.len() {\n let input_as_bytes: [u8; 32] = input[offset].to_be_bytes();\n for byte_index in 0..32 {\n hash_input_flattened[offset * 32 + byte_index] = input_as_bytes[byte_index];\n }\n }\n\n sha256_to_field(hash_input_flattened)\n}\n\npub fn verification_key_hash<let N: u32>(key: [Field; N]) -> Field {\n crate::hash::poseidon2_hash(key)\n}\n\n#[inline_always]\npub fn pedersen_hash<let N: u32>(inputs: [Field; N], hash_index: u32) -> Field {\n std::hash::pedersen_hash_with_separator(inputs, hash_index)\n}\n\npub fn poseidon2_hash<let N: u32>(inputs: [Field; N]) -> Field {\n std::hash::poseidon2::Poseidon2::hash(inputs, N)\n}\n\n#[no_predicates]\npub fn poseidon2_hash_with_separator<let N: u32, T>(inputs: [Field; N], separator: T) -> Field\nwhere\n T: ToField,\n{\n let inputs_with_separator = array_concat([separator.to_field()], inputs);\n poseidon2_hash(inputs_with_separator)\n}\n\n// Performs a fixed length hash with a subarray of the given input.\n// Useful for SpongeBlob in which we aborb M things and want to check it vs a hash of M elts of an N-len array.\n// Using stdlib poseidon, this will always absorb an extra 1 as a 'variable' hash, and not match spongeblob.squeeze()\n// or any ts implementation. Also checks that any remaining elts not hashed are empty.\n#[no_predicates]\npub fn poseidon2_hash_subarray<let N: u32>(input: [Field; N], in_len: u32) -> Field {\n let mut sponge = poseidon2_absorb_chunks(input, in_len, false);\n sponge.squeeze()\n}\n\n// NB the below is the same as std::hash::poseidon2::Poseidon2::hash(), but replacing a range check with a bit check,\n// and absorbing in chunks of 3 below.\n#[no_predicates]\npub fn poseidon2_cheaper_variable_hash<let N: u32>(input: [Field; N], in_len: u32) -> Field {\n let mut sponge = poseidon2_absorb_chunks(input, in_len, true);\n // In the case where the hash preimage is variable-length, we append `1` to the end of the input, to distinguish\n // from fixed-length hashes. (the combination of this additional field element + the hash IV ensures\n // fixed-length and variable-length hashes do not collide)\n if in_len != N {\n sponge.absorb(1);\n }\n sponge.squeeze()\n}\n\n// The below fn reduces gates of a conditional poseidon2 hash by approx 3x (thank you ~* Giant Brain Dev @IlyasRidhuan *~ for the idea)\n// Why? Because when we call stdlib poseidon, we call absorb for each item. When absorbing is conditional, it seems the compiler does not know\n// what cache_size will be when calling absorb, so it assigns the permutation gates for /each i/ rather than /every 3rd i/, which is actually required.\n// The below code forces the compiler to:\n// - absorb normally up to 2 times to set cache_size to 1\n// - absorb in chunks of 3 to ensure perm. only happens every 3rd absorb\n// - absorb normally up to 2 times to add any remaining values to the hash\n// In fixed len hashes, the compiler is able to tell that it will only need to perform the permutation every 3 absorbs.\n// NB: it also replaces unnecessary range checks (i < thing) with a bit check (&= i != thing), which alone reduces the gates of a var. hash by half.\n\n#[no_predicates]\nfn poseidon2_absorb_chunks<let N: u32>(\n input: [Field; N],\n in_len: u32,\n variable: bool,\n) -> Poseidon2Sponge {\n let iv: Field = (in_len as Field) * TWO_POW_64;\n let mut sponge = Poseidon2Sponge::new(iv);\n // Even though shift is always 1 here, if we input in_len = 0 we get an underflow\n // since we cannot isolate computation branches. The below is just to avoid that.\n let shift = if in_len == 0 { 0 } else { 1 };\n if in_len != 0 {\n // cache_size = 0, init absorb\n sponge.cache[0] = input[0];\n sponge.cache_size = 1;\n // shift = num elts already added to make cache_size 1 = 1 for a fresh sponge\n // M = max_chunks = (N - 1 - (N - 1) % 3) / 3: (must be written as a fn of N to compile)\n // max_remainder = (N - 1) % 3;\n // max_chunks = (N - 1 - max_remainder) / 3;\n sponge = poseidon2_absorb_chunks_loop::<N, (N - 1 - (N - 1) % 3) / 3>(\n sponge,\n input,\n in_len,\n variable,\n shift,\n );\n }\n sponge\n}\n\n// NB: If it's not required to check that the non-absorbed elts of 'input' are 0s, set skip_0_check=true\n#[no_predicates]\npub fn poseidon2_absorb_chunks_existing_sponge<let N: u32>(\n in_sponge: Poseidon2Sponge,\n input: [Field; N],\n in_len: u32,\n skip_0_check: bool,\n) -> Poseidon2Sponge {\n let mut sponge = in_sponge;\n // 'shift' is to account for already added inputs\n let mut shift = 0;\n // 'stop' is to avoid an underflow when inputting in_len = 0\n let mut stop = false;\n for i in 0..3 {\n if shift == in_len {\n stop = true;\n }\n if (sponge.cache_size != 1) & (!stop) {\n sponge.absorb(input[i]);\n shift += 1;\n }\n }\n sponge = if stop {\n sponge\n } else {\n // max_chunks = (N - (N % 3)) / 3;\n poseidon2_absorb_chunks_loop::<N, (N - (N % 3)) / 3>(\n sponge,\n input,\n in_len,\n skip_0_check,\n shift,\n )\n };\n sponge\n}\n\n// The below is the loop to absorb elts into a poseidon sponge in chunks of 3\n// shift - the num of elts already absorbed to ensure the sponge's cache_size = 1\n// M - the max number of chunks required to absorb N things (must be comptime to compile)\n// NB: The 0 checks ('Found non-zero field...') are messy, but having a separate loop over N to check\n// for 0s costs 3N gates. Current approach is approx 2N gates.\n#[no_predicates]\nfn poseidon2_absorb_chunks_loop<let N: u32, let M: u32>(\n in_sponge: Poseidon2Sponge,\n input: [Field; N],\n in_len: u32,\n variable: bool,\n shift: u32,\n) -> Poseidon2Sponge {\n assert(in_len <= N, \"Given in_len to absorb is larger than the input array len\");\n // When we have an existing sponge, we may have a shift of 0, and the final 'k+2' below = N\n // The below avoids an overflow\n let skip_last = 3 * M == N;\n // Writing in_sponge: &mut does not compile\n let mut sponge = in_sponge;\n let mut should_add = true;\n // The num of things left over after absorbing in 3s\n let remainder = (in_len - shift) % 3;\n // The num of chunks of 3 to absorb (maximum M)\n let chunks = (in_len - shift - remainder) / 3;\n for i in 0..M {\n // Now we loop through cache size = 1 -> 3\n should_add &= i != chunks;\n // This is the index at the start of the chunk (for readability)\n let k = 3 * i + shift;\n if should_add {\n // cache_size = 1, 2 => just assign\n sponge.cache[1] = input[k];\n sponge.cache[2] = input[k + 1];\n // cache_size = 3 => duplex + perm\n for j in 0..3 {\n sponge.state[j] += sponge.cache[j];\n }\n sponge.state = std::hash::poseidon2_permutation(sponge.state, 4);\n sponge.cache[0] = input[k + 2];\n // cache_size is now 1 again, repeat loop\n } else if (!variable) & (i != chunks) {\n // if we are hashing a fixed len array which is a subarray, we check the remaining elts are 0\n // NB: we don't check at i == chunks, because that chunk contains elts to be absorbed or checked below\n let last_0 = if (i == M - 1) & (skip_last) {\n 0\n } else {\n input[k + 2]\n };\n let all_0 = (input[k] == 0) & (input[k + 1] == 0) & (last_0 == 0);\n assert(all_0, \"Found non-zero field after breakpoint\");\n }\n }\n // we have 'remainder' num of items left to absorb\n should_add = true;\n // below is to avoid overflows (i.e. if inlen is close to N)\n let mut should_check = !variable;\n for i in 0..3 {\n should_add &= i != remainder;\n should_check &= in_len - remainder + i != N;\n if should_add {\n // we want to absorb the final 'remainder' items\n sponge.absorb(input[in_len - remainder + i]);\n } else if should_check {\n assert(input[in_len - remainder + i] == 0, \"Found non-zero field after breakpoint\");\n }\n }\n sponge\n}\n\npub fn poseidon2_hash_with_separator_slice<T>(inputs: [Field], separator: T) -> Field\nwhere\n T: ToField,\n{\n let in_len = inputs.len() + 1;\n let iv: Field = (in_len as Field) * TWO_POW_64;\n let mut sponge = Poseidon2Sponge::new(iv);\n sponge.absorb(separator.to_field());\n\n for i in 0..inputs.len() {\n sponge.absorb(inputs[i]);\n }\n\n sponge.squeeze()\n}\n\n#[no_predicates]\npub fn poseidon2_hash_bytes<let N: u32>(inputs: [u8; N]) -> Field {\n let mut fields = [0; (N + 30) / 31];\n let mut field_index = 0;\n let mut current_field = [0; 31];\n for i in 0..inputs.len() {\n let index = i % 31;\n current_field[index] = inputs[i];\n if index == 30 {\n fields[field_index] = field_from_bytes(current_field, false);\n current_field = [0; 31];\n field_index += 1;\n }\n }\n if field_index != fields.len() {\n fields[field_index] = field_from_bytes(current_field, false);\n }\n poseidon2_hash(fields)\n}\n\n#[test]\nfn poseidon_chunks_matches_fixed() {\n let in_len = 501;\n let mut input: [Field; 4096] = [0; 4096];\n let mut fixed_input = [3; 501];\n assert(in_len == fixed_input.len()); // sanity check\n for i in 0..in_len {\n input[i] = 3;\n }\n let sub_chunk_hash = poseidon2_hash_subarray(input, in_len);\n let fixed_len_hash = std::hash::poseidon2::Poseidon2::hash(fixed_input, fixed_input.len());\n assert(sub_chunk_hash == fixed_len_hash);\n}\n\n#[test]\nfn poseidon_chunks_matches_variable() {\n let in_len = 501;\n let mut input: [Field; 4096] = [0; 4096];\n for i in 0..in_len {\n input[i] = 3;\n }\n let variable_chunk_hash = poseidon2_cheaper_variable_hash(input, in_len);\n let variable_len_hash = std::hash::poseidon2::Poseidon2::hash(input, in_len);\n assert(variable_chunk_hash == variable_len_hash);\n}\n\n#[test]\nfn existing_sponge_poseidon_chunks_matches_fixed() {\n let in_len = 501;\n let mut input: [Field; 4096] = [0; 4096];\n let mut fixed_input = [3; 501];\n assert(in_len == fixed_input.len()); // sanity check\n for i in 0..in_len {\n input[i] = 3;\n }\n // absorb 250 of the 501 things\n let empty_sponge = Poseidon2Sponge::new((in_len as Field) * TWO_POW_64);\n let first_sponge = poseidon2_absorb_chunks_existing_sponge(empty_sponge, input, 250, true);\n // now absorb the final 251 (since they are all 3s, im being lazy and not making a new array)\n let mut final_sponge = poseidon2_absorb_chunks_existing_sponge(first_sponge, input, 251, true);\n let fixed_len_hash = Poseidon2Sponge::hash(fixed_input, fixed_input.len());\n assert(final_sponge.squeeze() == fixed_len_hash);\n}\n\n#[test]\nfn poseidon_chunks_empty_inputs() {\n let in_len = 0;\n let mut input: [Field; 4096] = [0; 4096];\n let mut constructed_empty_sponge = poseidon2_absorb_chunks(input, in_len, true);\n let mut first_sponge =\n poseidon2_absorb_chunks_existing_sponge(constructed_empty_sponge, input, in_len, true);\n assert(first_sponge.squeeze() == constructed_empty_sponge.squeeze());\n}\n\n#[test]\nfn smoke_sha256_to_field() {\n let full_buffer = [\n 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,\n 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47,\n 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70,\n 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93,\n 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112,\n 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130,\n 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148,\n 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159,\n ];\n let result = sha256_to_field(full_buffer);\n\n assert(result == 0x448ebbc9e1a31220a2f3830c18eef61b9bd070e5084b7fa2a359fe729184c7);\n\n // to show correctness of the current ver (truncate one byte) vs old ver (mod full bytes):\n let result_bytes = sha256::digest(full_buffer);\n let truncated_field = crate::utils::field::field_from_bytes_32_trunc(result_bytes);\n assert(truncated_field == result);\n let mod_res = result + (result_bytes[31] as Field);\n assert(mod_res == 0x448ebbc9e1a31220a2f3830c18eef61b9bd070e5084b7fa2a359fe729184e0);\n}\n\n#[test]\nfn compute_l2_l1_hash() {\n // All zeroes\n let hash_result =\n compute_l2_to_l1_hash(AztecAddress::from_field(0), EthAddress::zero(), 0, 0, 0);\n assert(hash_result == 0xb393978842a0fa3d3e1470196f098f473f9678e72463cb65ec4ab5581856c2);\n\n // Non-zero case\n let hash_result = compute_l2_to_l1_hash(\n AztecAddress::from_field(1),\n EthAddress::from_field(3),\n 5,\n 2,\n 4,\n );\n assert(hash_result == 0x3f88c1044a05e5340ed20466276500f6d45ca5603913b9091e957161734e16);\n}\n\n#[test]\nfn silo_l2_to_l1_message_matches_typescript() {\n let version = 4;\n let chainId = 5;\n\n let hash = silo_l2_to_l1_message(\n ScopedL2ToL1Message {\n message: L2ToL1Message { recipient: EthAddress::from_field(1), content: 2, counter: 0 },\n contract_address: AztecAddress::from_field(3),\n },\n version,\n chainId,\n );\n\n // The following value was generated by `l2_to_l1_message.test.ts`\n let hash_from_typescript = 0x00c6155d69febb9d5039b374dd4f77bf57b7c881709aa524a18acaa0bd57476a;\n\n assert_eq(hash, hash_from_typescript);\n}\n"
1853
1853
  },
1854
- "302": {
1854
+ "305": {
1855
1855
  "path": "/home/aztec-dev/aztec-packages/noir-projects/noir-protocol-circuits/crates/types/src/poseidon2.nr",
1856
1856
  "source": "use crate::constants::TWO_POW_64;\n\n// NB: This is a clone of noir/noir-repo/noir_stdlib/src/hash/poseidon2.nr\n// It exists as we sometimes need to perform custom absorption, but the stdlib version\n// has a private absorb() method (it's also designed to just be a hasher)\n// Can be removed when standalone noir poseidon lib exists: See noir#6679\n\ncomptime global RATE: u32 = 3;\n\npub struct Poseidon2Sponge {\n pub cache: [Field; 3],\n pub state: [Field; 4],\n pub cache_size: u32,\n pub squeeze_mode: bool, // 0 => absorb, 1 => squeeze\n}\n\nimpl Poseidon2Sponge {\n #[no_predicates]\n pub fn hash<let N: u32>(input: [Field; N], message_size: u32) -> Field {\n Poseidon2Sponge::hash_internal(input, message_size, message_size != N)\n }\n\n pub(crate) fn new(iv: Field) -> Poseidon2Sponge {\n let mut result =\n Poseidon2Sponge { cache: [0; 3], state: [0; 4], cache_size: 0, squeeze_mode: false };\n result.state[RATE] = iv;\n result\n }\n\n fn perform_duplex(&mut self) {\n // add the cache into sponge state\n for i in 0..RATE {\n // We effectively zero-pad the cache by only adding to the state\n // cache that is less than the specified `cache_size`\n if i < self.cache_size {\n self.state[i] += self.cache[i];\n }\n }\n self.state = std::hash::poseidon2_permutation(self.state, 4);\n }\n\n pub fn absorb(&mut self, input: Field) {\n assert(!self.squeeze_mode);\n if self.cache_size == RATE {\n // If we're absorbing, and the cache is full, apply the sponge permutation to compress the cache\n self.perform_duplex();\n self.cache[0] = input;\n self.cache_size = 1;\n } else {\n // If we're absorbing, and the cache is not full, add the input into the cache\n self.cache[self.cache_size] = input;\n self.cache_size += 1;\n }\n }\n\n pub fn squeeze(&mut self) -> Field {\n assert(!self.squeeze_mode);\n // If we're in absorb mode, apply sponge permutation to compress the cache.\n self.perform_duplex();\n self.squeeze_mode = true;\n\n // Pop one item off the top of the permutation and return it.\n self.state[0]\n }\n\n fn hash_internal<let N: u32>(\n input: [Field; N],\n in_len: u32,\n is_variable_length: bool,\n ) -> Field {\n let iv: Field = (in_len as Field) * TWO_POW_64;\n let mut sponge = Poseidon2Sponge::new(iv);\n for i in 0..input.len() {\n if i < in_len {\n sponge.absorb(input[i]);\n }\n }\n\n // In the case where the hash preimage is variable-length, we append `1` to the end of the input, to distinguish\n // from fixed-length hashes. (the combination of this additional field element + the hash IV ensures\n // fixed-length and variable-length hashes do not collide)\n if is_variable_length {\n sponge.absorb(1);\n }\n sponge.squeeze()\n }\n}\n"
1857
1857
  },
1858
- "360": {
1858
+ "363": {
1859
1859
  "path": "/home/aztec-dev/aztec-packages/noir-projects/noir-protocol-circuits/crates/types/src/utils/reader.nr",
1860
1860
  "source": "pub struct Reader<let N: u32> {\n data: [Field; N],\n offset: u32,\n}\n\nimpl<let N: u32> Reader<N> {\n pub fn new(data: [Field; N]) -> Self {\n Self { data, offset: 0 }\n }\n\n pub fn read(&mut self) -> Field {\n let result = self.data[self.offset];\n self.offset += 1;\n result\n }\n\n pub fn read_u32(&mut self) -> u32 {\n self.read() as u32\n }\n\n pub fn read_bool(&mut self) -> bool {\n self.read() as bool\n }\n\n pub fn read_array<let K: u32>(&mut self) -> [Field; K] {\n let mut result = [0; K];\n for i in 0..K {\n result[i] = self.data[self.offset + i];\n }\n self.offset += K;\n result\n }\n\n pub fn read_struct<T, let K: u32>(&mut self, deserialise: fn([Field; K]) -> T) -> T {\n let result = deserialise(self.read_array());\n result\n }\n\n pub fn read_struct_array<T, let K: u32, let C: u32>(\n &mut self,\n deserialise: fn([Field; K]) -> T,\n mut result: [T; C],\n ) -> [T; C] {\n for i in 0..C {\n result[i] = self.read_struct(deserialise);\n }\n result\n }\n\n pub fn finish(self) {\n assert(self.offset == self.data.len(), \"Reader did not read all data\");\n }\n}\n"
1861
1861
  },
1862
- "54": {
1862
+ "50": {
1863
1863
  "path": "/home/aztec-dev/aztec-packages/noir-projects/noir-contracts/contracts/protocol/multi_call_entrypoint_contract/src/main.nr",
1864
1864
  "source": "// An entrypoint contract that allows everything to go through. Only used for testing\n// Pair this with SignerlessWallet to perform multiple actions before any account contracts are deployed (and without authentication)\nuse dep::aztec::macros::aztec;\n\n#[aztec]\npub contract MultiCallEntrypoint {\n use dep::authwit::entrypoint::app::AppPayload;\n use dep::aztec::macros::functions::private;\n\n #[private]\n fn entrypoint(app_payload: AppPayload) {\n app_payload.execute_calls(&mut context);\n }\n}\n"
1865
1865
  },
1866
- "59": {
1866
+ "55": {
1867
1867
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/authwit/src/entrypoint/app.nr",
1868
1868
  "source": "use dep::aztec::{\n prelude::PrivateContext,\n protocol_types::{\n constants::GENERATOR_INDEX__SIGNATURE_PAYLOAD,\n hash::poseidon2_hash_with_separator,\n traits::{Hash, Serialize},\n },\n};\nuse std::meta::derive;\n\nuse crate::entrypoint::function_call::FunctionCall;\n\n// FUNCTION_CALL_SIZE_IN_BYTES * ACCOUNT_MAX_CALLS + 32\nglobal APP_PAYLOAD_SIZE_IN_BYTES: u32 = 424;\n\nglobal ACCOUNT_MAX_CALLS: u32 = 4;\n\n// Note: If you change the following struct you have to update default_entrypoint.ts\n// docs:start:app-payload-struct\n#[derive(Serialize)]\npub struct AppPayload {\n function_calls: [FunctionCall; ACCOUNT_MAX_CALLS],\n pub nonce: Field,\n}\n// docs:end:app-payload-struct\n\nimpl Hash for AppPayload {\n fn hash(self) -> Field {\n poseidon2_hash_with_separator(self.serialize(), GENERATOR_INDEX__SIGNATURE_PAYLOAD)\n }\n}\n\nimpl AppPayload {\n // Serializes the payload as an array of bytes. Useful for hashing with sha256.\n fn to_be_bytes(self) -> [u8; APP_PAYLOAD_SIZE_IN_BYTES] {\n let mut bytes: BoundedVec<u8, APP_PAYLOAD_SIZE_IN_BYTES> = BoundedVec::new();\n\n for i in 0..ACCOUNT_MAX_CALLS {\n bytes.extend_from_array(self.function_calls[i].to_be_bytes());\n }\n bytes.extend_from_array(self.nonce.to_be_bytes::<32>());\n\n bytes.storage()\n }\n\n // Executes all private and public calls\n // docs:start:entrypoint-execute-calls\n pub fn execute_calls(self, context: &mut PrivateContext) {\n for call in self.function_calls {\n if !call.target_address.is_zero() {\n if call.is_public {\n context.call_public_function_with_calldata_hash(\n call.target_address,\n call.args_hash,\n call.is_static,\n );\n } else {\n let _result = context.call_private_function_with_args_hash(\n call.target_address,\n call.function_selector,\n call.args_hash,\n call.is_static,\n );\n }\n }\n }\n }\n // docs:end:entrypoint-execute-calls\n}\n"
1869
1869
  },
@@ -1871,15 +1871,15 @@
1871
1871
  "path": "std/collections/bounded_vec.nr",
1872
1872
  "source": "use crate::{cmp::Eq, convert::From, runtime::is_unconstrained, static_assert};\n\n/// A `BoundedVec<T, MaxLen>` is a growable storage similar to a `Vec<T>` except that it\n/// is bounded with a maximum possible length. Unlike `Vec`, `BoundedVec` is not implemented\n/// via slices and thus is not subject to the same restrictions slices are (notably, nested\n/// slices - and thus nested vectors as well - are disallowed).\n///\n/// Since a BoundedVec is backed by a normal array under the hood, growing the BoundedVec by\n/// pushing an additional element is also more efficient - the length only needs to be increased\n/// by one.\n///\n/// For these reasons `BoundedVec<T, N>` should generally be preferred over `Vec<T>` when there\n/// is a reasonable maximum bound that can be placed on the vector.\n///\n/// Example:\n///\n/// ```noir\n/// let mut vector: BoundedVec<Field, 10> = BoundedVec::new();\n/// for i in 0..5 {\n/// vector.push(i);\n/// }\n/// assert(vector.len() == 5);\n/// assert(vector.max_len() == 10);\n/// ```\npub struct BoundedVec<T, let MaxLen: u32> {\n storage: [T; MaxLen],\n len: u32,\n}\n\nimpl<T, let MaxLen: u32> BoundedVec<T, MaxLen> {\n /// Creates a new, empty vector of length zero.\n ///\n /// Since this container is backed by an array internally, it still needs an initial value\n /// to give each element. To resolve this, each element is zeroed internally. This value\n /// is guaranteed to be inaccessible unless `get_unchecked` is used.\n ///\n /// Example:\n ///\n /// ```noir\n /// let empty_vector: BoundedVec<Field, 10> = BoundedVec::new();\n /// assert(empty_vector.len() == 0);\n /// ```\n ///\n /// Note that whenever calling `new` the maximum length of the vector should always be specified\n /// via a type signature:\n ///\n /// ```noir\n /// fn good() -> BoundedVec<Field, 10> {\n /// // Ok! MaxLen is specified with a type annotation\n /// let v1: BoundedVec<Field, 3> = BoundedVec::new();\n /// let v2 = BoundedVec::new();\n ///\n /// // Ok! MaxLen is known from the type of `good`'s return value\n /// v2\n /// }\n ///\n /// fn bad() {\n /// // Error: Type annotation needed\n /// // The compiler can't infer `MaxLen` from the following code:\n /// let mut v3 = BoundedVec::new();\n /// v3.push(5);\n /// }\n /// ```\n ///\n /// This defaulting of `MaxLen` (and numeric generics in general) to zero may change in future noir versions\n /// but for now make sure to use type annotations when using bounded vectors. Otherwise, you will receive a\n /// constraint failure at runtime when the vec is pushed to.\n pub fn new() -> Self {\n let zeroed = crate::mem::zeroed();\n BoundedVec { storage: [zeroed; MaxLen], len: 0 }\n }\n\n /// Retrieves an element from the vector at the given index, starting from zero.\n ///\n /// If the given index is equal to or greater than the length of the vector, this\n /// will issue a constraint failure.\n ///\n /// Example:\n ///\n /// ```noir\n /// fn foo<let N: u32>(v: BoundedVec<u32, N>) {\n /// let first = v.get(0);\n /// let last = v.get(v.len() - 1);\n /// assert(first != last);\n /// }\n /// ```\n pub fn get(self, index: u32) -> T {\n assert(index < self.len, \"Attempted to read past end of BoundedVec\");\n self.get_unchecked(index)\n }\n\n /// Retrieves an element from the vector at the given index, starting from zero, without\n /// performing a bounds check.\n ///\n /// Since this function does not perform a bounds check on length before accessing the element,\n /// it is unsafe! Use at your own risk!\n ///\n /// Example:\n ///\n /// ```noir\n /// fn sum_of_first_three<let N: u32>(v: BoundedVec<u32, N>) -> u32 {\n /// // Always ensure the length is larger than the largest\n /// // index passed to get_unchecked\n /// assert(v.len() > 2);\n /// let first = v.get_unchecked(0);\n /// let second = v.get_unchecked(1);\n /// let third = v.get_unchecked(2);\n /// first + second + third\n /// }\n /// ```\n pub fn get_unchecked(self, index: u32) -> T {\n self.storage[index]\n }\n\n /// Writes an element to the vector at the given index, starting from zero.\n ///\n /// If the given index is equal to or greater than the length of the vector, this will issue a constraint failure.\n ///\n /// Example:\n ///\n /// ```noir\n /// fn foo<let N: u32>(v: BoundedVec<u32, N>) {\n /// let first = v.get(0);\n /// assert(first != 42);\n /// v.set(0, 42);\n /// let new_first = v.get(0);\n /// assert(new_first == 42);\n /// }\n /// ```\n pub fn set(&mut self, index: u32, value: T) {\n assert(index < self.len, \"Attempted to write past end of BoundedVec\");\n self.set_unchecked(index, value)\n }\n\n /// Writes an element to the vector at the given index, starting from zero, without performing a bounds check.\n ///\n /// Since this function does not perform a bounds check on length before accessing the element, it is unsafe! Use at your own risk!\n ///\n /// Example:\n ///\n /// ```noir\n /// fn set_unchecked_example() {\n /// let mut vec: BoundedVec<u32, 5> = BoundedVec::new();\n /// vec.extend_from_array([1, 2]);\n ///\n /// // Here we're safely writing within the valid range of `vec`\n /// // `vec` now has the value [42, 2]\n /// vec.set_unchecked(0, 42);\n ///\n /// // We can then safely read this value back out of `vec`.\n /// // Notice that we use the checked version of `get` which would prevent reading unsafe values.\n /// assert_eq(vec.get(0), 42);\n ///\n /// // We've now written past the end of `vec`.\n /// // As this index is still within the maximum potential length of `v`,\n /// // it won't cause a constraint failure.\n /// vec.set_unchecked(2, 42);\n /// println(vec);\n ///\n /// // This will write past the end of the maximum potential length of `vec`,\n /// // it will then trigger a constraint failure.\n /// vec.set_unchecked(5, 42);\n /// println(vec);\n /// }\n /// ```\n pub fn set_unchecked(&mut self, index: u32, value: T) {\n self.storage[index] = value;\n }\n\n /// Pushes an element to the end of the vector. This increases the length\n /// of the vector by one.\n ///\n /// Panics if the new length of the vector will be greater than the max length.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<Field, 2> = BoundedVec::new();\n ///\n /// v.push(1);\n /// v.push(2);\n ///\n /// // Panics with failed assertion \"push out of bounds\"\n /// v.push(3);\n /// ```\n pub fn push(&mut self, elem: T) {\n assert(self.len < MaxLen, \"push out of bounds\");\n\n self.storage[self.len] = elem;\n self.len += 1;\n }\n\n /// Returns the current length of this vector\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<Field, 4> = BoundedVec::new();\n /// assert(v.len() == 0);\n ///\n /// v.push(100);\n /// assert(v.len() == 1);\n ///\n /// v.push(200);\n /// v.push(300);\n /// v.push(400);\n /// assert(v.len() == 4);\n ///\n /// let _ = v.pop();\n /// let _ = v.pop();\n /// assert(v.len() == 2);\n /// ```\n pub fn len(self) -> u32 {\n self.len\n }\n\n /// Returns the maximum length of this vector. This is always\n /// equal to the `MaxLen` parameter this vector was initialized with.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<Field, 5> = BoundedVec::new();\n ///\n /// assert(v.max_len() == 5);\n /// v.push(10);\n /// assert(v.max_len() == 5);\n /// ```\n pub fn max_len(_self: BoundedVec<T, MaxLen>) -> u32 {\n MaxLen\n }\n\n /// Returns the internal array within this vector.\n ///\n /// Since arrays in Noir are immutable, mutating the returned storage array will not mutate\n /// the storage held internally by this vector.\n ///\n /// Note that uninitialized elements may be zeroed out!\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<Field, 5> = BoundedVec::new();\n ///\n /// assert(v.storage() == [0, 0, 0, 0, 0]);\n ///\n /// v.push(57);\n /// assert(v.storage() == [57, 0, 0, 0, 0]);\n /// ```\n pub fn storage(self) -> [T; MaxLen] {\n self.storage\n }\n\n /// Pushes each element from the given array to this vector.\n ///\n /// Panics if pushing each element would cause the length of this vector\n /// to exceed the maximum length.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut vec: BoundedVec<Field, 3> = BoundedVec::new();\n /// vec.extend_from_array([2, 4]);\n ///\n /// assert(vec.len == 2);\n /// assert(vec.get(0) == 2);\n /// assert(vec.get(1) == 4);\n /// ```\n pub fn extend_from_array<let Len: u32>(&mut self, array: [T; Len]) {\n let new_len = self.len + array.len();\n assert(new_len <= MaxLen, \"extend_from_array out of bounds\");\n for i in 0..array.len() {\n self.storage[self.len + i] = array[i];\n }\n self.len = new_len;\n }\n\n /// Pushes each element from the given slice to this vector.\n ///\n /// Panics if pushing each element would cause the length of this vector\n /// to exceed the maximum length.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut vec: BoundedVec<Field, 3> = BoundedVec::new();\n /// vec.extend_from_slice(&[2, 4]);\n ///\n /// assert(vec.len == 2);\n /// assert(vec.get(0) == 2);\n /// assert(vec.get(1) == 4);\n /// ```\n pub fn extend_from_slice(&mut self, slice: [T]) {\n let new_len = self.len + slice.len();\n assert(new_len <= MaxLen, \"extend_from_slice out of bounds\");\n for i in 0..slice.len() {\n self.storage[self.len + i] = slice[i];\n }\n self.len = new_len;\n }\n\n /// Pushes each element from the other vector to this vector. The length of\n /// the other vector is left unchanged.\n ///\n /// Panics if pushing each element would cause the length of this vector\n /// to exceed the maximum length.\n ///\n /// ```noir\n /// let mut v1: BoundedVec<Field, 5> = BoundedVec::new();\n /// let mut v2: BoundedVec<Field, 7> = BoundedVec::new();\n ///\n /// v2.extend_from_array([1, 2, 3]);\n /// v1.extend_from_bounded_vec(v2);\n ///\n /// assert(v1.storage() == [1, 2, 3, 0, 0]);\n /// assert(v2.storage() == [1, 2, 3, 0, 0, 0, 0]);\n /// ```\n pub fn extend_from_bounded_vec<let Len: u32>(&mut self, vec: BoundedVec<T, Len>) {\n let append_len = vec.len();\n let new_len = self.len + append_len;\n assert(new_len <= MaxLen, \"extend_from_bounded_vec out of bounds\");\n\n if is_unconstrained() {\n for i in 0..append_len {\n self.storage[self.len + i] = vec.get_unchecked(i);\n }\n } else {\n let mut exceeded_len = false;\n for i in 0..Len {\n exceeded_len |= i == append_len;\n if !exceeded_len {\n self.storage[self.len + i] = vec.get_unchecked(i);\n }\n }\n }\n self.len = new_len;\n }\n\n /// Creates a new vector, populating it with values derived from an array input.\n /// The maximum length of the vector is determined based on the type signature.\n ///\n /// Example:\n ///\n /// ```noir\n /// let bounded_vec: BoundedVec<Field, 10> = BoundedVec::from_array([1, 2, 3])\n /// ```\n pub fn from_array<let Len: u32>(array: [T; Len]) -> Self {\n static_assert(Len <= MaxLen, \"from array out of bounds\");\n let mut vec: BoundedVec<T, MaxLen> = BoundedVec::new();\n vec.extend_from_array(array);\n vec\n }\n\n /// Pops the element at the end of the vector. This will decrease the length\n /// of the vector by one.\n ///\n /// Panics if the vector is empty.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<Field, 2> = BoundedVec::new();\n /// v.push(1);\n /// v.push(2);\n ///\n /// let two = v.pop();\n /// let one = v.pop();\n ///\n /// assert(two == 2);\n /// assert(one == 1);\n ///\n /// // error: cannot pop from an empty vector\n /// let _ = v.pop();\n /// ```\n pub fn pop(&mut self) -> T {\n assert(self.len > 0);\n self.len -= 1;\n\n let elem = self.storage[self.len];\n self.storage[self.len] = crate::mem::zeroed();\n elem\n }\n\n /// Returns true if the given predicate returns true for any element\n /// in this vector.\n ///\n /// Example:\n ///\n /// ```noir\n /// let mut v: BoundedVec<u32, 3> = BoundedVec::new();\n /// v.extend_from_array([2, 4, 6]);\n ///\n /// let all_even = !v.any(|elem: u32| elem % 2 != 0);\n /// assert(all_even);\n /// ```\n pub fn any<Env>(self, predicate: fn[Env](T) -> bool) -> bool {\n let mut ret = false;\n if is_unconstrained() {\n for i in 0..self.len {\n ret |= predicate(self.storage[i]);\n }\n } else {\n let mut ret = false;\n let mut exceeded_len = false;\n for i in 0..MaxLen {\n exceeded_len |= i == self.len;\n if !exceeded_len {\n ret |= predicate(self.storage[i]);\n }\n }\n }\n ret\n }\n\n /// Creates a new vector of equal size by calling a closure on each element in this vector.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n /// let result = vec.map(|value| value * 2);\n ///\n /// let expected = BoundedVec::from_array([2, 4, 6, 8]);\n /// assert_eq(result, expected);\n /// ```\n pub fn map<U, Env>(self, f: fn[Env](T) -> U) -> BoundedVec<U, MaxLen> {\n let mut ret = BoundedVec::new();\n ret.len = self.len();\n\n if is_unconstrained() {\n for i in 0..self.len() {\n ret.storage[i] = f(self.get_unchecked(i));\n }\n } else {\n for i in 0..MaxLen {\n if i < self.len() {\n ret.storage[i] = f(self.get_unchecked(i));\n }\n }\n }\n\n ret\n }\n\n /// Creates a new vector of equal size by calling a closure on each element\n /// in this vector, along with its index.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n /// let result = vec.mapi(|i, value| i + value * 2);\n ///\n /// let expected = BoundedVec::from_array([2, 5, 8, 11]);\n /// assert_eq(result, expected);\n /// ```\n pub fn mapi<U, Env>(self, f: fn[Env](u32, T) -> U) -> BoundedVec<U, MaxLen> {\n let mut ret = BoundedVec::new();\n ret.len = self.len();\n\n if is_unconstrained() {\n for i in 0..self.len() {\n ret.storage[i] = f(i, self.get_unchecked(i));\n }\n } else {\n for i in 0..MaxLen {\n if i < self.len() {\n ret.storage[i] = f(i, self.get_unchecked(i));\n }\n }\n }\n\n ret\n }\n\n /// Calls a closure on each element in this vector.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n /// let mut result = BoundedVec::<u32, 4>::new();\n /// vec.for_each(|value| result.push(value * 2));\n ///\n /// let expected = BoundedVec::from_array([2, 4, 6, 8]);\n /// assert_eq(result, expected);\n /// ```\n pub fn for_each<Env>(self, f: fn[Env](T) -> ()) {\n if is_unconstrained() {\n for i in 0..self.len() {\n f(self.get_unchecked(i));\n }\n } else {\n for i in 0..MaxLen {\n if i < self.len() {\n f(self.get_unchecked(i));\n }\n }\n }\n }\n\n /// Calls a closure on each element in this vector, along with its index.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n /// let mut result = BoundedVec::<u32, 4>::new();\n /// vec.for_eachi(|i, value| result.push(i + value * 2));\n ///\n /// let expected = BoundedVec::from_array([2, 5, 8, 11]);\n /// assert_eq(result, expected);\n /// ```\n pub fn for_eachi<Env>(self, f: fn[Env](u32, T) -> ()) {\n if is_unconstrained() {\n for i in 0..self.len() {\n f(i, self.get_unchecked(i));\n }\n } else {\n for i in 0..MaxLen {\n if i < self.len() {\n f(i, self.get_unchecked(i));\n }\n }\n }\n }\n\n /// Creates a new BoundedVec from the given array and length.\n /// The given length must be less than or equal to the length of the array.\n ///\n /// This function will zero out any elements at or past index `len` of `array`.\n /// This incurs an extra runtime cost of O(MaxLen). If you are sure your array is\n /// zeroed after that index, you can use `from_parts_unchecked` to remove the extra loop.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_parts([1, 2, 3, 0], 3);\n /// assert_eq(vec.len(), 3);\n /// ```\n pub fn from_parts(mut array: [T; MaxLen], len: u32) -> Self {\n assert(len <= MaxLen);\n let zeroed = crate::mem::zeroed();\n\n if is_unconstrained() {\n for i in len..MaxLen {\n array[i] = zeroed;\n }\n } else {\n for i in 0..MaxLen {\n if i >= len {\n array[i] = zeroed;\n }\n }\n }\n\n BoundedVec { storage: array, len }\n }\n\n /// Creates a new BoundedVec from the given array and length.\n /// The given length must be less than or equal to the length of the array.\n ///\n /// This function is unsafe because it expects all elements past the `len` index\n /// of `array` to be zeroed, but does not check for this internally. Use `from_parts`\n /// for a safe version of this function which does zero out any indices past the\n /// given length. Invalidating this assumption can notably cause `BoundedVec::eq`\n /// to give incorrect results since it will check even elements past `len`.\n ///\n /// Example:\n ///\n /// ```noir\n /// let vec: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 0], 3);\n /// assert_eq(vec.len(), 3);\n ///\n /// // invalid use!\n /// let vec1: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 1], 3);\n /// let vec2: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 2], 3);\n ///\n /// // both vecs have length 3 so we'd expect them to be equal, but this\n /// // fails because elements past the length are still checked in eq\n /// assert_eq(vec1, vec2); // fails\n /// ```\n pub fn from_parts_unchecked(array: [T; MaxLen], len: u32) -> Self {\n assert(len <= MaxLen);\n BoundedVec { storage: array, len }\n }\n}\n\nimpl<T, let MaxLen: u32> Eq for BoundedVec<T, MaxLen>\nwhere\n T: Eq,\n{\n fn eq(self, other: BoundedVec<T, MaxLen>) -> bool {\n // TODO: https://github.com/noir-lang/noir/issues/4837\n //\n // We make the assumption that the user has used the proper interface for working with `BoundedVec`s\n // rather than directly manipulating the internal fields as this can result in an inconsistent internal state.\n if self.len == other.len {\n self.storage == other.storage\n } else {\n false\n }\n }\n}\n\nimpl<T, let MaxLen: u32, let Len: u32> From<[T; Len]> for BoundedVec<T, MaxLen> {\n fn from(array: [T; Len]) -> BoundedVec<T, MaxLen> {\n BoundedVec::from_array(array)\n }\n}\n\nmod bounded_vec_tests {\n\n mod get {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test(should_fail_with = \"Attempted to read past end of BoundedVec\")]\n fn panics_when_reading_elements_past_end_of_vec() {\n let vec: BoundedVec<Field, 5> = BoundedVec::new();\n\n crate::println(vec.get(0));\n }\n }\n\n mod set {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn set_updates_values_properly() {\n let mut vec = BoundedVec::from_array([0, 0, 0, 0, 0]);\n\n vec.set(0, 42);\n assert_eq(vec.storage, [42, 0, 0, 0, 0]);\n\n vec.set(1, 43);\n assert_eq(vec.storage, [42, 43, 0, 0, 0]);\n\n vec.set(2, 44);\n assert_eq(vec.storage, [42, 43, 44, 0, 0]);\n\n vec.set(1, 10);\n assert_eq(vec.storage, [42, 10, 44, 0, 0]);\n\n vec.set(0, 0);\n assert_eq(vec.storage, [0, 10, 44, 0, 0]);\n }\n\n #[test(should_fail_with = \"Attempted to write past end of BoundedVec\")]\n fn panics_when_writing_elements_past_end_of_vec() {\n let mut vec: BoundedVec<Field, 5> = BoundedVec::new();\n vec.set(0, 42);\n\n // Need to use println to avoid DIE removing the write operation.\n crate::println(vec.get(0));\n }\n }\n\n mod map {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn applies_function_correctly() {\n // docs:start:bounded-vec-map-example\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = vec.map(|value| value * 2);\n // docs:end:bounded-vec-map-example\n let expected = BoundedVec::from_array([2, 4, 6, 8]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn applies_function_that_changes_return_type() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = vec.map(|value| (value * 2) as Field);\n let expected: BoundedVec<Field, 4> = BoundedVec::from_array([2, 4, 6, 8]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn does_not_apply_function_past_len() {\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([0, 1]);\n let result = vec.map(|value| if value == 0 { 5 } else { value });\n let expected = BoundedVec::from_array([5, 1]);\n\n assert_eq(result, expected);\n assert_eq(result.get_unchecked(2), 0);\n }\n }\n\n mod mapi {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn applies_function_correctly() {\n // docs:start:bounded-vec-mapi-example\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = vec.mapi(|i, value| i + value * 2);\n // docs:end:bounded-vec-mapi-example\n let expected = BoundedVec::from_array([2, 5, 8, 11]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn applies_function_that_changes_return_type() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = vec.mapi(|i, value| (i + value * 2) as Field);\n let expected: BoundedVec<Field, 4> = BoundedVec::from_array([2, 5, 8, 11]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn does_not_apply_function_past_len() {\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([0, 1]);\n let result = vec.mapi(|_, value| if value == 0 { 5 } else { value });\n let expected = BoundedVec::from_array([5, 1]);\n\n assert_eq(result, expected);\n assert_eq(result.get_unchecked(2), 0);\n }\n }\n\n mod for_each {\n use crate::collections::bounded_vec::BoundedVec;\n\n // map in terms of for_each\n fn for_each_map<T, U, Env, let MaxLen: u32>(\n input: BoundedVec<T, MaxLen>,\n f: fn[Env](T) -> U,\n ) -> BoundedVec<U, MaxLen> {\n let mut output = BoundedVec::<U, MaxLen>::new();\n let output_ref = &mut output;\n input.for_each(|x| output_ref.push(f(x)));\n output\n }\n\n #[test]\n fn smoke_test() {\n let mut acc = 0;\n let acc_ref = &mut acc;\n // docs:start:bounded-vec-for-each-example\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([1, 2, 3]);\n vec.for_each(|value| { *acc_ref += value; });\n // docs:end:bounded-vec-for-each-example\n assert_eq(acc, 6);\n }\n\n #[test]\n fn applies_function_correctly() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = for_each_map(vec, |value| value * 2);\n let expected = BoundedVec::from_array([2, 4, 6, 8]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn applies_function_that_changes_return_type() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = for_each_map(vec, |value| (value * 2) as Field);\n let expected: BoundedVec<Field, 4> = BoundedVec::from_array([2, 4, 6, 8]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn does_not_apply_function_past_len() {\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([0, 1]);\n let result = for_each_map(vec, |value| if value == 0 { 5 } else { value });\n let expected = BoundedVec::from_array([5, 1]);\n\n assert_eq(result, expected);\n assert_eq(result.get_unchecked(2), 0);\n }\n }\n\n mod for_eachi {\n use crate::collections::bounded_vec::BoundedVec;\n\n // mapi in terms of for_eachi\n fn for_eachi_mapi<T, U, Env, let MaxLen: u32>(\n input: BoundedVec<T, MaxLen>,\n f: fn[Env](u32, T) -> U,\n ) -> BoundedVec<U, MaxLen> {\n let mut output = BoundedVec::<U, MaxLen>::new();\n let output_ref = &mut output;\n input.for_eachi(|i, x| output_ref.push(f(i, x)));\n output\n }\n\n #[test]\n fn smoke_test() {\n let mut acc = 0;\n let acc_ref = &mut acc;\n // docs:start:bounded-vec-for-eachi-example\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([1, 2, 3]);\n vec.for_eachi(|i, value| { *acc_ref += i * value; });\n // docs:end:bounded-vec-for-eachi-example\n\n // 0 * 1 + 1 * 2 + 2 * 3\n assert_eq(acc, 8);\n }\n\n #[test]\n fn applies_function_correctly() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = for_eachi_mapi(vec, |i, value| i + value * 2);\n let expected = BoundedVec::from_array([2, 5, 8, 11]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn applies_function_that_changes_return_type() {\n let vec: BoundedVec<u32, 4> = BoundedVec::from_array([1, 2, 3, 4]);\n let result = for_eachi_mapi(vec, |i, value| (i + value * 2) as Field);\n let expected: BoundedVec<Field, 4> = BoundedVec::from_array([2, 5, 8, 11]);\n\n assert_eq(result, expected);\n }\n\n #[test]\n fn does_not_apply_function_past_len() {\n let vec: BoundedVec<u32, 3> = BoundedVec::from_array([0, 1]);\n let result = for_eachi_mapi(vec, |_, value| if value == 0 { 5 } else { value });\n let expected = BoundedVec::from_array([5, 1]);\n\n assert_eq(result, expected);\n assert_eq(result.get_unchecked(2), 0);\n }\n }\n\n mod from_array {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn empty() {\n let empty_array: [Field; 0] = [];\n let bounded_vec = BoundedVec::from_array([]);\n\n assert_eq(bounded_vec.max_len(), 0);\n assert_eq(bounded_vec.len(), 0);\n assert_eq(bounded_vec.storage(), empty_array);\n }\n\n #[test]\n fn equal_len() {\n let array = [1, 2, 3];\n let bounded_vec = BoundedVec::from_array(array);\n\n assert_eq(bounded_vec.max_len(), 3);\n assert_eq(bounded_vec.len(), 3);\n assert_eq(bounded_vec.storage(), array);\n }\n\n #[test]\n fn max_len_greater_then_array_len() {\n let array = [1, 2, 3];\n let bounded_vec: BoundedVec<Field, 10> = BoundedVec::from_array(array);\n\n assert_eq(bounded_vec.max_len(), 10);\n assert_eq(bounded_vec.len(), 3);\n assert_eq(bounded_vec.get(0), 1);\n assert_eq(bounded_vec.get(1), 2);\n assert_eq(bounded_vec.get(2), 3);\n }\n\n #[test(should_fail_with = \"from array out of bounds\")]\n fn max_len_lower_then_array_len() {\n let _: BoundedVec<Field, 2> = BoundedVec::from_array([0; 3]);\n }\n }\n\n mod trait_from {\n use crate::collections::bounded_vec::BoundedVec;\n use crate::convert::From;\n\n #[test]\n fn simple() {\n let array = [1, 2];\n let bounded_vec: BoundedVec<Field, 10> = BoundedVec::from(array);\n\n assert_eq(bounded_vec.max_len(), 10);\n assert_eq(bounded_vec.len(), 2);\n assert_eq(bounded_vec.get(0), 1);\n assert_eq(bounded_vec.get(1), 2);\n }\n }\n\n mod trait_eq {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn empty_equality() {\n let mut bounded_vec1: BoundedVec<Field, 3> = BoundedVec::new();\n let mut bounded_vec2: BoundedVec<Field, 3> = BoundedVec::new();\n\n assert_eq(bounded_vec1, bounded_vec2);\n }\n\n #[test]\n fn inequality() {\n let mut bounded_vec1: BoundedVec<Field, 3> = BoundedVec::new();\n let mut bounded_vec2: BoundedVec<Field, 3> = BoundedVec::new();\n bounded_vec1.push(1);\n bounded_vec2.push(2);\n\n assert(bounded_vec1 != bounded_vec2);\n }\n }\n\n mod from_parts {\n use crate::collections::bounded_vec::BoundedVec;\n\n #[test]\n fn from_parts() {\n // docs:start:from-parts\n let vec: BoundedVec<u32, 4> = BoundedVec::from_parts([1, 2, 3, 0], 3);\n assert_eq(vec.len(), 3);\n\n // Any elements past the given length are zeroed out, so these\n // two BoundedVecs will be completely equal\n let vec1: BoundedVec<u32, 4> = BoundedVec::from_parts([1, 2, 3, 1], 3);\n let vec2: BoundedVec<u32, 4> = BoundedVec::from_parts([1, 2, 3, 2], 3);\n assert_eq(vec1, vec2);\n // docs:end:from-parts\n }\n\n #[test]\n fn from_parts_unchecked() {\n // docs:start:from-parts-unchecked\n let vec: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 0], 3);\n assert_eq(vec.len(), 3);\n\n // invalid use!\n let vec1: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 1], 3);\n let vec2: BoundedVec<u32, 4> = BoundedVec::from_parts_unchecked([1, 2, 3, 2], 3);\n\n // both vecs have length 3 so we'd expect them to be equal, but this\n // fails because elements past the length are still checked in eq\n assert(vec1 != vec2);\n // docs:end:from-parts-unchecked\n }\n }\n}\n"
1873
1873
  },
1874
- "72": {
1874
+ "68": {
1875
1875
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/context/private_context.nr",
1876
1876
  "source": "use dep::protocol_types::debug_log::debug_log_format;\n\nuse crate::{\n context::{inputs::PrivateContextInputs, returns_hash::ReturnsHash},\n hash::{ArgsHasher, hash_args_array, hash_calldata_array},\n keys::constants::{NULLIFIER_INDEX, NUM_KEY_TYPES, OUTGOING_INDEX, sk_generators},\n messaging::process_l1_to_l2_message,\n oracle::{\n block_header::get_block_header_at,\n call_private_function::call_private_function_internal,\n enqueue_public_function_call::{\n notify_enqueued_public_function_call, notify_set_min_revertible_side_effect_counter,\n notify_set_public_teardown_function_call,\n },\n execution_cache,\n key_validation_request::get_key_validation_request,\n notes::{notify_created_nullifier, notify_nullified_note},\n },\n};\nuse dep::protocol_types::{\n abis::{\n call_context::CallContext,\n function_selector::FunctionSelector,\n gas_settings::GasSettings,\n log::Log,\n log_hash::LogHash,\n max_block_number::MaxBlockNumber,\n note_hash::NoteHash,\n nullifier::Nullifier,\n private_call_request::PrivateCallRequest,\n private_circuit_public_inputs::PrivateCircuitPublicInputs,\n private_log::PrivateLogData,\n public_call_request::PublicCallRequest,\n read_request::ReadRequest,\n side_effect::Counted,\n validation_requests::{KeyValidationRequest, KeyValidationRequestAndGenerator},\n },\n address::{AztecAddress, EthAddress},\n block_header::BlockHeader,\n constants::{\n MAX_CONTRACT_CLASS_LOGS_PER_CALL, MAX_ENQUEUED_CALLS_PER_CALL,\n MAX_KEY_VALIDATION_REQUESTS_PER_CALL, MAX_L2_TO_L1_MSGS_PER_CALL,\n MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, MAX_NOTE_HASHES_PER_CALL,\n MAX_NULLIFIER_READ_REQUESTS_PER_CALL, MAX_NULLIFIERS_PER_CALL,\n MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL, MAX_PRIVATE_LOGS_PER_CALL,\n PRIVATE_LOG_SIZE_IN_FIELDS,\n },\n messaging::l2_to_l1_message::L2ToL1Message,\n traits::{Empty, Hash, ToField},\n utils::arrays::array_concat,\n};\n\n// When finished, one can call .finish() to convert back to the abi\npub struct PrivateContext {\n // docs:start:private-context\n pub inputs: PrivateContextInputs,\n pub side_effect_counter: u32,\n\n pub min_revertible_side_effect_counter: u32,\n pub is_fee_payer: bool,\n\n pub args_hash: Field,\n pub return_hash: Field,\n\n pub max_block_number: MaxBlockNumber,\n\n pub note_hash_read_requests: BoundedVec<ReadRequest, MAX_NOTE_HASH_READ_REQUESTS_PER_CALL>,\n pub nullifier_read_requests: BoundedVec<ReadRequest, MAX_NULLIFIER_READ_REQUESTS_PER_CALL>,\n key_validation_requests_and_generators: BoundedVec<KeyValidationRequestAndGenerator, MAX_KEY_VALIDATION_REQUESTS_PER_CALL>,\n\n pub note_hashes: BoundedVec<NoteHash, MAX_NOTE_HASHES_PER_CALL>,\n pub nullifiers: BoundedVec<Nullifier, MAX_NULLIFIERS_PER_CALL>,\n\n pub private_call_requests: BoundedVec<PrivateCallRequest, MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL>,\n pub public_call_requests: BoundedVec<Counted<PublicCallRequest>, MAX_ENQUEUED_CALLS_PER_CALL>,\n pub public_teardown_call_request: PublicCallRequest,\n pub l2_to_l1_msgs: BoundedVec<L2ToL1Message, MAX_L2_TO_L1_MSGS_PER_CALL>,\n // docs:end:private-context\n\n // Header of a block whose state is used during private execution (not the block the transaction is included in).\n pub historical_header: BlockHeader,\n\n pub private_logs: BoundedVec<PrivateLogData, MAX_PRIVATE_LOGS_PER_CALL>,\n pub contract_class_logs_hashes: BoundedVec<LogHash, MAX_CONTRACT_CLASS_LOGS_PER_CALL>,\n\n // Contains the last key validation request for each key type. This is used to cache the last request and avoid\n // fetching the same request multiple times.\n // The index of the array corresponds to the key type (0 nullifier, 1 incoming, 2 outgoing, 3 tagging).\n pub last_key_validation_requests: [Option<KeyValidationRequest>; NUM_KEY_TYPES],\n}\n\nimpl PrivateContext {\n pub fn new(inputs: PrivateContextInputs, args_hash: Field) -> PrivateContext {\n PrivateContext {\n inputs,\n side_effect_counter: inputs.start_side_effect_counter + 1,\n min_revertible_side_effect_counter: 0,\n is_fee_payer: false,\n args_hash,\n return_hash: 0,\n max_block_number: MaxBlockNumber::empty(),\n note_hash_read_requests: BoundedVec::new(),\n nullifier_read_requests: BoundedVec::new(),\n key_validation_requests_and_generators: BoundedVec::new(),\n note_hashes: BoundedVec::new(),\n nullifiers: BoundedVec::new(),\n historical_header: inputs.historical_header,\n private_call_requests: BoundedVec::new(),\n public_call_requests: BoundedVec::new(),\n public_teardown_call_request: PublicCallRequest::empty(),\n l2_to_l1_msgs: BoundedVec::new(),\n private_logs: BoundedVec::new(),\n contract_class_logs_hashes: BoundedVec::new(),\n last_key_validation_requests: [Option::none(); NUM_KEY_TYPES],\n }\n }\n\n pub fn msg_sender(self) -> AztecAddress {\n self.inputs.call_context.msg_sender\n }\n\n pub fn this_address(self) -> AztecAddress {\n self.inputs.call_context.contract_address\n }\n\n pub fn chain_id(self) -> Field {\n self.inputs.tx_context.chain_id\n }\n\n pub fn version(self) -> Field {\n self.inputs.tx_context.version\n }\n\n pub fn gas_settings(self) -> GasSettings {\n self.inputs.tx_context.gas_settings\n }\n\n pub fn selector(self) -> FunctionSelector {\n self.inputs.call_context.function_selector\n }\n\n pub fn get_args_hash(self) -> Field {\n self.args_hash\n }\n\n pub fn push_note_hash(&mut self, note_hash: Field) {\n self.note_hashes.push(NoteHash { value: note_hash, counter: self.next_counter() });\n\n // WARNING(https://github.com/AztecProtocol/aztec-packages/issues/10558): if you delete this debug_log_format line, some tests fail.\n debug_log_format(\n \"Context.note_hashes, after pushing new note hash: {0}\",\n self.note_hashes.storage().map(|nh: NoteHash| nh.value),\n );\n }\n\n pub fn push_nullifier(&mut self, nullifier: Field) {\n notify_created_nullifier(nullifier);\n self.nullifiers.push(\n Nullifier { value: nullifier, note_hash: 0, counter: self.next_counter() },\n );\n }\n\n pub fn push_nullifier_for_note_hash(&mut self, nullifier: Field, nullified_note_hash: Field) {\n let nullifier_counter = self.next_counter();\n notify_nullified_note(nullifier, nullified_note_hash, nullifier_counter);\n self.nullifiers.push(\n Nullifier {\n value: nullifier,\n note_hash: nullified_note_hash,\n counter: nullifier_counter,\n },\n );\n }\n\n // Returns the header of a block whose state is used during private execution (not the block the transaction is\n // included in).\n pub fn get_block_header(self) -> BlockHeader {\n self.historical_header\n }\n\n // Returns the header of an arbitrary block whose block number is less than or equal to the block number\n // of historical header.\n pub fn get_block_header_at(self, block_number: u32) -> BlockHeader {\n get_block_header_at(block_number, self)\n }\n\n pub fn set_return_hash(&mut self, returns_hasher: ArgsHasher) {\n self.return_hash = returns_hasher.hash();\n execution_cache::store(returns_hasher.fields, self.return_hash);\n }\n\n pub fn finish(self) -> PrivateCircuitPublicInputs {\n PrivateCircuitPublicInputs {\n call_context: self.inputs.call_context,\n args_hash: self.args_hash,\n returns_hash: self.return_hash,\n min_revertible_side_effect_counter: self.min_revertible_side_effect_counter,\n is_fee_payer: self.is_fee_payer,\n max_block_number: self.max_block_number,\n note_hash_read_requests: self.note_hash_read_requests.storage(),\n nullifier_read_requests: self.nullifier_read_requests.storage(),\n key_validation_requests_and_generators: self\n .key_validation_requests_and_generators\n .storage(),\n note_hashes: self.note_hashes.storage(),\n nullifiers: self.nullifiers.storage(),\n private_call_requests: self.private_call_requests.storage(),\n public_call_requests: self.public_call_requests.storage(),\n public_teardown_call_request: self.public_teardown_call_request,\n l2_to_l1_msgs: self.l2_to_l1_msgs.storage(),\n start_side_effect_counter: self.inputs.start_side_effect_counter,\n end_side_effect_counter: self.side_effect_counter,\n private_logs: self.private_logs.storage(),\n contract_class_logs_hashes: self.contract_class_logs_hashes.storage(),\n historical_header: self.historical_header,\n tx_context: self.inputs.tx_context,\n }\n }\n\n pub fn set_as_fee_payer(&mut self) {\n dep::protocol_types::debug_log::debug_log_format(\n \"Setting {0} as fee payer\",\n [self.this_address().to_field()],\n );\n self.is_fee_payer = true;\n }\n\n pub fn end_setup(&mut self) {\n // dep::protocol_types::debug_log::debug_log_format(\n // \"Ending setup at counter {0}\",\n // [self.side_effect_counter as Field]\n // );\n self.min_revertible_side_effect_counter = self.side_effect_counter;\n notify_set_min_revertible_side_effect_counter(self.min_revertible_side_effect_counter);\n }\n\n // docs:start:max-block-number\n pub fn set_tx_max_block_number(&mut self, max_block_number: u32) {\n // docs:end:max-block-number\n self.max_block_number =\n MaxBlockNumber::min_with_u32(self.max_block_number, max_block_number);\n }\n\n pub fn push_note_hash_read_request(&mut self, note_hash: Field) {\n let side_effect = ReadRequest { value: note_hash, counter: self.next_counter() };\n self.note_hash_read_requests.push(side_effect);\n }\n\n pub fn push_nullifier_read_request(&mut self, nullifier: Field) {\n let request = ReadRequest { value: nullifier, counter: self.next_counter() };\n self.nullifier_read_requests.push(request);\n }\n\n pub fn request_nsk_app(&mut self, npk_m_hash: Field) -> Field {\n self.request_sk_app(npk_m_hash, NULLIFIER_INDEX)\n }\n\n pub fn request_ovsk_app(&mut self, ovpk_m_hash: Field) -> Field {\n self.request_sk_app(ovpk_m_hash, OUTGOING_INDEX)\n }\n\n fn request_sk_app(&mut self, pk_m_hash: Field, key_index: Field) -> Field {\n let cached_request = self.last_key_validation_requests[key_index as u32].unwrap_or(\n KeyValidationRequest::empty(),\n );\n\n if cached_request.pk_m.hash() == pk_m_hash {\n // We get a match so the cached request is the latest one\n cached_request.sk_app\n } else {\n // We didn't get a match meaning the cached result is stale\n // Typically we'd validate keys by showing that they are the preimage of `pk_m_hash`, but that'd require\n // the oracle returning the master secret keys, which could cause malicious contracts to leak it or learn\n // about secrets from other contracts. We therefore silo secret keys, and rely on the private kernel to\n // validate that we siloed secret key corresponds to correct siloing of the master secret key that hashes\n // to `pk_m_hash`.\n\n // Safety: Kernels verify that the key validation request is valid and below we verify that a request\n // for the correct public key has been received.\n let request = unsafe { get_key_validation_request(pk_m_hash, key_index) };\n assert_eq(request.pk_m.hash(), pk_m_hash, \"Obtained invalid key validation request\");\n\n self.key_validation_requests_and_generators.push(\n KeyValidationRequestAndGenerator {\n request,\n sk_app_generator: sk_generators[key_index as u32],\n },\n );\n self.last_key_validation_requests[key_index as u32] = Option::some(request);\n request.sk_app\n }\n }\n\n // docs:start:context_message_portal\n pub fn message_portal(&mut self, recipient: EthAddress, content: Field) {\n // docs:end:context_message_portal\n let message = L2ToL1Message { recipient, content, counter: self.next_counter() };\n self.l2_to_l1_msgs.push(message);\n }\n\n // docs:start:context_consume_l1_to_l2_message\n // docs:start:consume_l1_to_l2_message\n pub fn consume_l1_to_l2_message(\n &mut self,\n content: Field,\n secret: Field,\n sender: EthAddress,\n leaf_index: Field,\n ) {\n // docs:end:context_consume_l1_to_l2_message\n let nullifier = process_l1_to_l2_message(\n self.historical_header.state.l1_to_l2_message_tree.root,\n self.this_address(),\n sender,\n self.chain_id(),\n self.version(),\n content,\n secret,\n leaf_index,\n );\n\n // Push nullifier (and the \"commitment\" corresponding to this can be \"empty\")\n self.push_nullifier(nullifier)\n }\n // docs:end:consume_l1_to_l2_message\n\n pub fn emit_private_log(&mut self, log: [Field; PRIVATE_LOG_SIZE_IN_FIELDS]) {\n let counter = self.next_counter();\n let private_log = PrivateLogData { log: Log::new(log), note_hash_counter: 0, counter };\n self.private_logs.push(private_log);\n }\n\n pub fn emit_raw_note_log(\n &mut self,\n log: [Field; PRIVATE_LOG_SIZE_IN_FIELDS],\n note_hash_counter: u32,\n ) {\n let counter = self.next_counter();\n let private_log = PrivateLogData { log: Log::new(log), note_hash_counter, counter };\n self.private_logs.push(private_log);\n }\n\n pub fn call_private_function<let ARGS_COUNT: u32>(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args: [Field; ARGS_COUNT],\n ) -> ReturnsHash {\n let args_hash = hash_args_array(args);\n execution_cache::store(args, args_hash);\n self.call_private_function_with_args_hash(\n contract_address,\n function_selector,\n args_hash,\n false,\n )\n }\n\n pub fn static_call_private_function<let ARGS_COUNT: u32>(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args: [Field; ARGS_COUNT],\n ) -> ReturnsHash {\n let args_hash = hash_args_array(args);\n execution_cache::store(args, args_hash);\n self.call_private_function_with_args_hash(\n contract_address,\n function_selector,\n args_hash,\n true,\n )\n }\n\n pub fn call_private_function_no_args(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n ) -> ReturnsHash {\n self.call_private_function_with_args_hash(contract_address, function_selector, 0, false)\n }\n\n pub fn static_call_private_function_no_args(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n ) -> ReturnsHash {\n self.call_private_function_with_args_hash(contract_address, function_selector, 0, true)\n }\n\n pub fn call_private_function_with_args_hash(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args_hash: Field,\n is_static_call: bool,\n ) -> ReturnsHash {\n let mut is_static_call = is_static_call | self.inputs.call_context.is_static_call;\n let start_side_effect_counter = self.side_effect_counter;\n\n // Safety: The oracle simulates the private call and returns the value of the side effects counter after\n // execution of the call (which means that end_side_effect_counter - start_side_effect_counter is\n // the number of side effects that took place), along with the hash of the return values. We validate these\n // by requesting a private kernel iteration in which the return values are constrained to hash\n // to `returns_hash` and the side effects counter to increment from start to end.\n let (end_side_effect_counter, returns_hash) = unsafe {\n call_private_function_internal(\n contract_address,\n function_selector,\n args_hash,\n start_side_effect_counter,\n is_static_call,\n )\n };\n\n self.private_call_requests.push(\n PrivateCallRequest {\n call_context: CallContext {\n msg_sender: self.this_address(),\n contract_address,\n function_selector,\n is_static_call,\n },\n args_hash,\n returns_hash,\n start_side_effect_counter,\n end_side_effect_counter,\n },\n );\n\n // TODO (fees) figure out why this crashes the prover and enable it\n // we need this in order to pay fees inside child call contexts\n // assert(\n // (item.public_inputs.min_revertible_side_effect_counter == 0 as u32)\n // | (item.public_inputs.min_revertible_side_effect_counter\n // > self.min_revertible_side_effect_counter)\n // );\n // if item.public_inputs.min_revertible_side_effect_counter\n // > self.min_revertible_side_effect_counter {\n // self.min_revertible_side_effect_counter = item.public_inputs.min_revertible_side_effect_counter;\n // }\n self.side_effect_counter = end_side_effect_counter + 1;\n ReturnsHash::new(returns_hash)\n }\n\n pub fn call_public_function<let ARGS_COUNT: u32>(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args: [Field; ARGS_COUNT],\n ) {\n let calldata = array_concat([function_selector.to_field()], args);\n let calldata_hash = hash_calldata_array(calldata);\n execution_cache::store(calldata, calldata_hash);\n self.call_public_function_with_calldata_hash(contract_address, calldata_hash, false)\n }\n\n pub fn static_call_public_function<let ARGS_COUNT: u32>(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args: [Field; ARGS_COUNT],\n ) {\n let calldata = array_concat([function_selector.to_field()], args);\n let calldata_hash = hash_calldata_array(calldata);\n execution_cache::store(calldata, calldata_hash);\n self.call_public_function_with_calldata_hash(contract_address, calldata_hash, true)\n }\n\n pub fn call_public_function_no_args(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n ) {\n let calldata_hash = hash_calldata_array([function_selector.to_field()]);\n self.call_public_function_with_calldata_hash(contract_address, calldata_hash, false)\n }\n\n pub fn static_call_public_function_no_args(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n ) {\n let calldata_hash = hash_calldata_array([function_selector.to_field()]);\n self.call_public_function_with_calldata_hash(contract_address, calldata_hash, true)\n }\n\n pub fn call_public_function_with_calldata_hash(\n &mut self,\n contract_address: AztecAddress,\n calldata_hash: Field,\n is_static_call: bool,\n ) {\n let counter = self.next_counter();\n\n let mut is_static_call = is_static_call | self.inputs.call_context.is_static_call;\n\n notify_enqueued_public_function_call(\n contract_address,\n calldata_hash,\n counter,\n is_static_call,\n );\n\n let call_request = PublicCallRequest {\n msg_sender: self.this_address(),\n contract_address,\n is_static_call,\n calldata_hash,\n };\n\n self.public_call_requests.push(Counted::new(call_request, counter));\n }\n\n pub fn set_public_teardown_function<let ARGS_COUNT: u32>(\n &mut self,\n contract_address: AztecAddress,\n function_selector: FunctionSelector,\n args: [Field; ARGS_COUNT],\n ) {\n let calldata = array_concat([function_selector.to_field()], args);\n let calldata_hash = hash_calldata_array(calldata);\n execution_cache::store(calldata, calldata_hash);\n self.set_public_teardown_function_with_calldata_hash(contract_address, calldata_hash, false)\n }\n\n pub fn set_public_teardown_function_with_calldata_hash(\n &mut self,\n contract_address: AztecAddress,\n calldata_hash: Field,\n is_static_call: bool,\n ) {\n let counter = self.next_counter();\n\n let mut is_static_call = is_static_call | self.inputs.call_context.is_static_call;\n\n notify_set_public_teardown_function_call(\n contract_address,\n calldata_hash,\n counter,\n is_static_call,\n );\n\n self.public_teardown_call_request = PublicCallRequest {\n msg_sender: self.this_address(),\n contract_address,\n is_static_call,\n calldata_hash,\n };\n }\n\n fn next_counter(&mut self) -> u32 {\n let counter = self.side_effect_counter;\n self.side_effect_counter += 1;\n counter\n }\n}\n\nimpl Empty for PrivateContext {\n fn empty() -> Self {\n PrivateContext {\n inputs: PrivateContextInputs::empty(),\n side_effect_counter: 0 as u32,\n min_revertible_side_effect_counter: 0 as u32,\n is_fee_payer: false,\n args_hash: 0,\n return_hash: 0,\n max_block_number: MaxBlockNumber::empty(),\n note_hash_read_requests: BoundedVec::new(),\n nullifier_read_requests: BoundedVec::new(),\n key_validation_requests_and_generators: BoundedVec::new(),\n note_hashes: BoundedVec::new(),\n nullifiers: BoundedVec::new(),\n private_call_requests: BoundedVec::new(),\n public_call_requests: BoundedVec::new(),\n public_teardown_call_request: PublicCallRequest::empty(),\n l2_to_l1_msgs: BoundedVec::new(),\n historical_header: BlockHeader::empty(),\n private_logs: BoundedVec::new(),\n contract_class_logs_hashes: BoundedVec::new(),\n last_key_validation_requests: [Option::none(); NUM_KEY_TYPES],\n }\n }\n}\n"
1877
1877
  },
1878
- "75": {
1878
+ "71": {
1879
1879
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/context/utility_context.nr",
1880
1880
  "source": "use crate::oracle::{\n execution::{get_block_number, get_chain_id, get_contract_address, get_version},\n storage::storage_read,\n};\nuse dep::protocol_types::{address::AztecAddress, traits::Packable};\n\npub struct UtilityContext {\n block_number: u32,\n contract_address: AztecAddress,\n version: Field,\n chain_id: Field,\n}\n\nimpl UtilityContext {\n pub unconstrained fn new() -> Self {\n // We could call these oracles on the getters instead of at creation, which makes sense given that they might\n // not even be accessed. However any performance gains are minimal, and we'd rather fail early if a user\n // incorrectly attempts to create a UtilityContext in an environment in which these oracles are not\n // available.\n let block_number = get_block_number();\n let contract_address = get_contract_address();\n let chain_id = get_chain_id();\n let version = get_version();\n Self { block_number, contract_address, version, chain_id }\n }\n\n pub unconstrained fn at(contract_address: AztecAddress) -> Self {\n let block_number = get_block_number();\n let chain_id = get_chain_id();\n let version = get_version();\n Self { block_number, contract_address, version, chain_id }\n }\n\n pub unconstrained fn at_historical(contract_address: AztecAddress, block_number: u32) -> Self {\n let chain_id = get_chain_id();\n let version = get_version();\n Self { block_number, contract_address, version, chain_id }\n }\n\n pub fn block_number(self) -> u32 {\n self.block_number\n }\n\n pub fn this_address(self) -> AztecAddress {\n self.contract_address\n }\n\n pub fn version(self) -> Field {\n self.version\n }\n\n pub fn chain_id(self) -> Field {\n self.chain_id\n }\n\n pub unconstrained fn raw_storage_read<let N: u32>(\n self: Self,\n storage_slot: Field,\n ) -> [Field; N] {\n storage_read(self.this_address(), storage_slot, self.block_number())\n }\n\n pub unconstrained fn storage_read<T, let N: u32>(self, storage_slot: Field) -> T\n where\n T: Packable<N>,\n {\n T::unpack(self.raw_storage_read(storage_slot))\n }\n}\n"
1881
1881
  },
1882
- "98": {
1882
+ "75": {
1883
1883
  "path": "/home/aztec-dev/aztec-packages/noir-projects/aztec-nr/aztec/src/hash.nr",
1884
1884
  "source": "use dep::protocol_types::{\n address::{AztecAddress, EthAddress},\n constants::{\n GENERATOR_INDEX__FUNCTION_ARGS, GENERATOR_INDEX__MESSAGE_NULLIFIER,\n GENERATOR_INDEX__PUBLIC_CALLDATA, GENERATOR_INDEX__SECRET_HASH,\n },\n hash::{poseidon2_hash_with_separator, poseidon2_hash_with_separator_slice, sha256_to_field},\n point::Point,\n traits::{Hash, ToField},\n};\n\npub use dep::protocol_types::hash::{compute_siloed_nullifier, pedersen_hash};\n\npub fn pedersen_commitment<let N: u32>(inputs: [Field; N], hash_index: u32) -> Point {\n std::hash::pedersen_commitment_with_separator(inputs, hash_index)\n}\n\npub fn compute_secret_hash(secret: Field) -> Field {\n poseidon2_hash_with_separator([secret], GENERATOR_INDEX__SECRET_HASH)\n}\n\npub fn compute_l1_to_l2_message_hash(\n sender: EthAddress,\n chain_id: Field,\n recipient: AztecAddress,\n version: Field,\n content: Field,\n secret_hash: Field,\n leaf_index: Field,\n) -> Field {\n let mut hash_bytes = [0 as u8; 224];\n let sender_bytes: [u8; 32] = sender.to_field().to_be_bytes();\n let chain_id_bytes: [u8; 32] = chain_id.to_be_bytes();\n let recipient_bytes: [u8; 32] = recipient.to_field().to_be_bytes();\n let version_bytes: [u8; 32] = version.to_be_bytes();\n let content_bytes: [u8; 32] = content.to_be_bytes();\n let secret_hash_bytes: [u8; 32] = secret_hash.to_be_bytes();\n let leaf_index_bytes: [u8; 32] = leaf_index.to_be_bytes();\n\n for i in 0..32 {\n hash_bytes[i] = sender_bytes[i];\n hash_bytes[i + 32] = chain_id_bytes[i];\n hash_bytes[i + 64] = recipient_bytes[i];\n hash_bytes[i + 96] = version_bytes[i];\n hash_bytes[i + 128] = content_bytes[i];\n hash_bytes[i + 160] = secret_hash_bytes[i];\n hash_bytes[i + 192] = leaf_index_bytes[i];\n }\n\n sha256_to_field(hash_bytes)\n}\n\n// The nullifier of a l1 to l2 message is the hash of the message salted with the secret\npub fn compute_l1_to_l2_message_nullifier(message_hash: Field, secret: Field) -> Field {\n poseidon2_hash_with_separator([message_hash, secret], GENERATOR_INDEX__MESSAGE_NULLIFIER)\n}\n\npub struct ArgsHasher {\n pub fields: [Field],\n}\n\nimpl Hash for ArgsHasher {\n fn hash(self) -> Field {\n hash_args(self.fields)\n }\n}\n\nimpl ArgsHasher {\n pub fn new() -> Self {\n Self { fields: [] }\n }\n\n pub fn add(&mut self, field: Field) {\n self.fields = self.fields.push_back(field);\n }\n\n pub fn add_multiple<let N: u32>(&mut self, fields: [Field; N]) {\n for i in 0..N {\n self.fields = self.fields.push_back(fields[i]);\n }\n }\n}\n\n// Computes the hash of input arguments or return values for private functions, or for authwit creation.\npub fn hash_args_array<let N: u32>(args: [Field; N]) -> Field {\n if args.len() == 0 {\n 0\n } else {\n poseidon2_hash_with_separator(args, GENERATOR_INDEX__FUNCTION_ARGS)\n }\n}\n\n// Same as `hash_args_array`, but takes a slice instead of an array.\npub fn hash_args(args: [Field]) -> Field {\n if args.len() == 0 {\n 0\n } else {\n poseidon2_hash_with_separator_slice(args, GENERATOR_INDEX__FUNCTION_ARGS)\n }\n}\n\n// Computes the hash of calldata for public functions.\npub fn hash_calldata_array<let N: u32>(calldata: [Field; N]) -> Field {\n if calldata.len() == 0 {\n 0\n } else {\n poseidon2_hash_with_separator(calldata, GENERATOR_INDEX__PUBLIC_CALLDATA)\n }\n}\n\n// Same as `hash_calldata_array`, but takes a slice instead of an array.\npub fn hash_calldata(calldata: [Field]) -> Field {\n if calldata.len() == 0 {\n 0\n } else {\n poseidon2_hash_with_separator_slice(calldata, GENERATOR_INDEX__PUBLIC_CALLDATA)\n }\n}\n\n#[test]\nunconstrained fn compute_var_args_hash() {\n let mut input = ArgsHasher::new();\n for i in 0..100 {\n input.add(i as Field);\n }\n let hash = input.hash();\n dep::std::println(hash);\n assert(hash == 0x19b0d74feb06ebde19edd85a28986c97063e84b3b351a8b666c7cac963ce655f);\n}\n"
1885
1885
  }