@aztec/pxe 0.0.1-commit.e558bd1c → 0.0.1-commit.e5a3663dd

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 (246) hide show
  1. package/dest/bin/check_oracle_version.js +4 -4
  2. package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
  3. package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
  4. package/dest/block_synchronizer/block_stream_source.js +37 -0
  5. package/dest/block_synchronizer/block_synchronizer.d.ts +6 -2
  6. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  7. package/dest/block_synchronizer/block_synchronizer.js +30 -10
  8. package/dest/config/index.d.ts +2 -2
  9. package/dest/config/index.d.ts.map +1 -1
  10. package/dest/config/index.js +8 -15
  11. package/dest/config/package_info.js +1 -1
  12. package/dest/contract_function_simulator/contract_function_simulator.d.ts +62 -30
  13. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  14. package/dest/contract_function_simulator/contract_function_simulator.js +206 -76
  15. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  16. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  17. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  18. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -7
  19. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -11
  21. package/dest/contract_function_simulator/index.d.ts +2 -1
  22. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  23. package/dest/contract_function_simulator/index.js +1 -0
  24. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -6
  25. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  26. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -10
  27. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +1 -1
  28. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +1 -1
  29. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  30. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  32. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -7
  33. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -11
  35. package/dest/contract_function_simulator/oracle/interfaces.d.ts +63 -45
  36. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  37. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  38. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  39. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +47 -0
  40. package/dest/contract_function_simulator/oracle/oracle.d.ts +76 -44
  41. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/oracle/oracle.js +289 -97
  43. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  44. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +58 -86
  45. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +121 -95
  47. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +124 -64
  48. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +356 -126
  50. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  51. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/pick_notes.js +20 -3
  53. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  54. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  55. package/dest/contract_function_simulator/proxied_contract_data_source.js +3 -0
  56. package/dest/contract_logging.d.ts +27 -0
  57. package/dest/contract_logging.d.ts.map +1 -0
  58. package/dest/contract_logging.js +38 -0
  59. package/dest/contract_sync/contract_sync_service.d.ts +7 -4
  60. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  61. package/dest/contract_sync/contract_sync_service.js +69 -35
  62. package/dest/contract_sync/helpers.d.ts +2 -2
  63. package/dest/contract_sync/helpers.d.ts.map +1 -1
  64. package/dest/contract_sync/helpers.js +9 -4
  65. package/dest/debug/pxe_debug_utils.d.ts +5 -6
  66. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  67. package/dest/debug/pxe_debug_utils.js +4 -7
  68. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  69. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  70. package/dest/entrypoints/client/bundle/index.js +2 -0
  71. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  72. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  73. package/dest/entrypoints/client/bundle/utils.js +11 -3
  74. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  75. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  76. package/dest/entrypoints/client/lazy/index.js +2 -0
  77. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  78. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  79. package/dest/entrypoints/client/lazy/utils.js +11 -3
  80. package/dest/entrypoints/pxe_creation_options.d.ts +3 -1
  81. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  82. package/dest/entrypoints/pxe_creation_options.js +3 -1
  83. package/dest/entrypoints/server/index.d.ts +3 -2
  84. package/dest/entrypoints/server/index.d.ts.map +1 -1
  85. package/dest/entrypoints/server/index.js +2 -1
  86. package/dest/entrypoints/server/utils.d.ts +2 -2
  87. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  88. package/dest/entrypoints/server/utils.js +11 -3
  89. package/dest/events/event_service.d.ts +3 -2
  90. package/dest/events/event_service.d.ts.map +1 -1
  91. package/dest/events/event_service.js +26 -5
  92. package/dest/events/private_event_filter_validator.d.ts +3 -2
  93. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  94. package/dest/events/private_event_filter_validator.js +15 -0
  95. package/dest/logs/log_service.d.ts +7 -7
  96. package/dest/logs/log_service.d.ts.map +1 -1
  97. package/dest/logs/log_service.js +33 -48
  98. package/dest/messages/message_context_service.d.ts +17 -0
  99. package/dest/messages/message_context_service.d.ts.map +1 -0
  100. package/dest/messages/message_context_service.js +36 -0
  101. package/dest/notes/note_service.d.ts +4 -4
  102. package/dest/notes/note_service.d.ts.map +1 -1
  103. package/dest/notes/note_service.js +17 -7
  104. package/dest/notes_filter.d.ts +24 -0
  105. package/dest/notes_filter.d.ts.map +1 -0
  106. package/dest/notes_filter.js +4 -0
  107. package/dest/oracle_version.d.ts +4 -3
  108. package/dest/oracle_version.d.ts.map +1 -1
  109. package/dest/oracle_version.js +20 -10
  110. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  111. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  112. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  113. package/dest/private_kernel/hints/index.d.ts +1 -1
  114. package/dest/private_kernel/hints/index.js +1 -1
  115. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  116. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  117. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  118. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  119. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  120. package/dest/private_kernel/hints/test_utils.js +203 -0
  121. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  122. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  123. package/dest/private_kernel/private_kernel_execution_prover.js +18 -13
  124. package/dest/private_kernel/private_kernel_oracle.d.ts +10 -6
  125. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  126. package/dest/private_kernel/private_kernel_oracle.js +19 -18
  127. package/dest/pxe.d.ts +84 -24
  128. package/dest/pxe.d.ts.map +1 -1
  129. package/dest/pxe.js +153 -83
  130. package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
  131. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  132. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  133. package/dest/storage/capsule_store/capsule_service.js +50 -0
  134. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  135. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  136. package/dest/storage/capsule_store/capsule_store.js +36 -28
  137. package/dest/storage/capsule_store/index.d.ts +2 -1
  138. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  139. package/dest/storage/capsule_store/index.js +1 -0
  140. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  141. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  142. package/dest/storage/contract_store/contract_store.js +148 -70
  143. package/dest/storage/metadata.d.ts +1 -1
  144. package/dest/storage/metadata.js +1 -1
  145. package/dest/storage/note_store/note_store.d.ts +3 -3
  146. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  147. package/dest/storage/note_store/note_store.js +3 -4
  148. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  149. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  150. package/dest/storage/private_event_store/private_event_store.js +3 -0
  151. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  152. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  153. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  154. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  155. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  156. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  157. package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
  158. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  159. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  160. package/dest/tagging/index.d.ts +3 -3
  161. package/dest/tagging/index.d.ts.map +1 -1
  162. package/dest/tagging/index.js +1 -1
  163. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  164. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  165. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +8 -22
  166. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  167. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  168. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  169. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  170. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  171. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  172. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  173. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  174. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  175. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  176. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  177. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  178. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  179. package/package.json +16 -16
  180. package/src/bin/check_oracle_version.ts +4 -4
  181. package/src/block_synchronizer/block_stream_source.ts +52 -0
  182. package/src/block_synchronizer/block_synchronizer.ts +33 -11
  183. package/src/config/index.ts +3 -9
  184. package/src/config/package_info.ts +1 -1
  185. package/src/contract_function_simulator/contract_function_simulator.ts +366 -138
  186. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  187. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  188. package/src/contract_function_simulator/index.ts +1 -0
  189. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -9
  190. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +1 -1
  191. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  192. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -10
  193. package/src/contract_function_simulator/oracle/interfaces.ts +91 -53
  194. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +104 -0
  195. package/src/contract_function_simulator/oracle/oracle.ts +378 -140
  196. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  197. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +151 -183
  198. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +598 -156
  199. package/src/contract_function_simulator/pick_notes.ts +22 -3
  200. package/src/contract_function_simulator/proxied_contract_data_source.ts +8 -1
  201. package/src/contract_logging.ts +52 -0
  202. package/src/contract_sync/contract_sync_service.ts +102 -55
  203. package/src/contract_sync/helpers.ts +8 -3
  204. package/src/debug/pxe_debug_utils.ts +11 -14
  205. package/src/entrypoints/client/bundle/index.ts +2 -0
  206. package/src/entrypoints/client/bundle/utils.ts +11 -4
  207. package/src/entrypoints/client/lazy/index.ts +2 -0
  208. package/src/entrypoints/client/lazy/utils.ts +11 -4
  209. package/src/entrypoints/pxe_creation_options.ts +7 -0
  210. package/src/entrypoints/server/index.ts +2 -1
  211. package/src/entrypoints/server/utils.ts +9 -10
  212. package/src/events/event_service.ts +30 -5
  213. package/src/events/private_event_filter_validator.ts +21 -1
  214. package/src/logs/log_service.ts +63 -91
  215. package/src/messages/message_context_service.ts +44 -0
  216. package/src/notes/note_service.ts +19 -8
  217. package/src/notes_filter.ts +24 -0
  218. package/src/oracle_version.ts +20 -10
  219. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  220. package/src/private_kernel/hints/index.ts +1 -1
  221. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  222. package/src/private_kernel/hints/test_utils.ts +325 -0
  223. package/src/private_kernel/private_kernel_execution_prover.ts +18 -16
  224. package/src/private_kernel/private_kernel_oracle.ts +21 -21
  225. package/src/pxe.ts +278 -131
  226. package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
  227. package/src/storage/capsule_store/capsule_service.ts +90 -0
  228. package/src/storage/capsule_store/capsule_store.ts +44 -26
  229. package/src/storage/capsule_store/index.ts +1 -0
  230. package/src/storage/contract_store/contract_store.ts +181 -80
  231. package/src/storage/metadata.ts +1 -1
  232. package/src/storage/note_store/note_store.ts +5 -5
  233. package/src/storage/private_event_store/private_event_store.ts +4 -0
  234. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  235. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  236. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  237. package/src/tagging/get_all_logs_by_tags.ts +28 -4
  238. package/src/tagging/index.ts +2 -2
  239. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +12 -25
  240. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  241. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  242. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +23 -10
  243. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  244. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -26
  245. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  246. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -0,0 +1,325 @@
1
+ import {
2
+ MAX_KEY_VALIDATION_REQUESTS_PER_CALL,
3
+ MAX_KEY_VALIDATION_REQUESTS_PER_TX,
4
+ MAX_NOTE_HASHES_PER_CALL,
5
+ MAX_NOTE_HASHES_PER_TX,
6
+ MAX_NOTE_HASH_READ_REQUESTS_PER_CALL,
7
+ MAX_NOTE_HASH_READ_REQUESTS_PER_TX,
8
+ MAX_NULLIFIERS_PER_CALL,
9
+ MAX_NULLIFIERS_PER_TX,
10
+ MAX_NULLIFIER_READ_REQUESTS_PER_CALL,
11
+ MAX_NULLIFIER_READ_REQUESTS_PER_TX,
12
+ MAX_PRIVATE_LOGS_PER_CALL,
13
+ MAX_PRIVATE_LOGS_PER_TX,
14
+ } from '@aztec/constants';
15
+ import { makeTuple } from '@aztec/foundation/array';
16
+ import { Fr } from '@aztec/foundation/curves/bn254';
17
+ import { Point } from '@aztec/foundation/curves/grumpkin';
18
+ import type { Serializable } from '@aztec/foundation/serialize';
19
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
20
+ import {
21
+ ClaimedLengthArray,
22
+ KeyValidationRequest,
23
+ KeyValidationRequestAndSeparator,
24
+ NoteHash,
25
+ Nullifier,
26
+ PrivateCircuitPublicInputs,
27
+ PrivateKernelCircuitPublicInputs,
28
+ type PrivateKernelSimulateOutput,
29
+ ReadRequest,
30
+ ScopedKeyValidationRequestAndSeparator,
31
+ ScopedNoteHash,
32
+ ScopedNullifier,
33
+ ScopedReadRequest,
34
+ } from '@aztec/stdlib/kernel';
35
+ import { PrivateLogData, ScopedPrivateLogData } from '@aztec/stdlib/kernel';
36
+ import { PrivateLog } from '@aztec/stdlib/logs';
37
+ import { PrivateCallExecutionResult } from '@aztec/stdlib/tx';
38
+ import { VerificationKeyData } from '@aztec/stdlib/vks';
39
+
40
+ const DEFAULT_CONTRACT_ADDRESS = AztecAddress.fromBigInt(987654n);
41
+
42
+ /**
43
+ * Builds a ClaimedLengthArray from a list of items, padding to the required size.
44
+ */
45
+ function makeClaimed<T extends Serializable, N extends number>(items: T[], emptyFactory: { empty(): T }, maxSize: N) {
46
+ const padded = makeTuple(maxSize, i => items[i] ?? emptyFactory.empty());
47
+ return new ClaimedLengthArray<T, typeof maxSize>(padded, items.length);
48
+ }
49
+
50
+ /** Builder for PrivateKernelCircuitPublicInputs with fluent API for adding side effects. */
51
+ export class PrivateKernelCircuitPublicInputsBuilder {
52
+ private noteHashes: ScopedNoteHash[] = [];
53
+ private nullifiers: ScopedNullifier[] = [];
54
+ private noteHashReadRequests: ScopedReadRequest[] = [];
55
+ private nullifierReadRequests: ScopedReadRequest[] = [];
56
+ private keyValidationRequests: ScopedKeyValidationRequestAndSeparator[] = [];
57
+ private privateLogs: ScopedPrivateLogData[] = [];
58
+ private nextCounter: number;
59
+
60
+ constructor(
61
+ private contractAddress: AztecAddress = DEFAULT_CONTRACT_ADDRESS,
62
+ startCounter = 1,
63
+ ) {
64
+ this.nextCounter = startCounter;
65
+ }
66
+
67
+ private getCounter(sideEffectCounter?: number): number {
68
+ if (sideEffectCounter !== undefined) {
69
+ this.nextCounter = sideEffectCounter + 1;
70
+ return sideEffectCounter;
71
+ }
72
+ return this.nextCounter++;
73
+ }
74
+
75
+ /** Adds a note hash to the accumulated data. Defaults are generated randomly. */
76
+ addNoteHash(opts?: { value?: Fr; counter?: number; contractAddress?: AztecAddress }): this {
77
+ const value = opts?.value ?? Fr.random();
78
+ const counter = this.getCounter(opts?.counter);
79
+ const addr = opts?.contractAddress ?? this.contractAddress;
80
+ this.noteHashes.push(new NoteHash(value, counter).scope(addr));
81
+ return this;
82
+ }
83
+
84
+ /** Adds a nullifier to the accumulated data. Defaults are generated randomly. */
85
+ addNullifier(opts?: { value?: Fr; noteHash?: Fr; counter?: number; contractAddress?: AztecAddress }): this {
86
+ const value = opts?.value ?? Fr.random();
87
+ const noteHash = opts?.noteHash ?? Fr.ZERO;
88
+ const counter = this.getCounter(opts?.counter);
89
+ const addr = opts?.contractAddress ?? this.contractAddress;
90
+ this.nullifiers.push(new Nullifier(value, noteHash, counter).scope(addr));
91
+ return this;
92
+ }
93
+
94
+ /** Adds a pending note hash read request (non-empty contract address, can match a pending note hash). */
95
+ addPendingNoteHashReadRequest(opts?: { value?: Fr; counter?: number; contractAddress?: AztecAddress }): this {
96
+ const value = opts?.value ?? Fr.random();
97
+ const counter = this.getCounter(opts?.counter);
98
+ const addr = opts?.contractAddress ?? this.contractAddress;
99
+ this.noteHashReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), addr));
100
+ return this;
101
+ }
102
+
103
+ /** Adds a settled note hash read request (empty contract address, resolved against the note hash tree). */
104
+ addSettledNoteHashReadRequest(opts?: { value?: Fr; counter?: number }): this {
105
+ const value = opts?.value ?? Fr.random();
106
+ const counter = this.getCounter(opts?.counter);
107
+ this.noteHashReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), AztecAddress.ZERO));
108
+ return this;
109
+ }
110
+
111
+ /** Adds a pending nullifier read request (non-empty contract address, can match a pending nullifier). */
112
+ addPendingNullifierReadRequest(opts?: { value?: Fr; counter?: number; contractAddress?: AztecAddress }): this {
113
+ const value = opts?.value ?? Fr.random();
114
+ const counter = this.getCounter(opts?.counter);
115
+ const addr = opts?.contractAddress ?? this.contractAddress;
116
+ this.nullifierReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), addr));
117
+ return this;
118
+ }
119
+
120
+ /** Adds a settled nullifier read request (empty contract address, resolved against the nullifier tree). */
121
+ addSettledNullifierReadRequest(opts?: { value?: Fr; counter?: number }): this {
122
+ const value = opts?.value ?? Fr.random();
123
+ const counter = this.getCounter(opts?.counter);
124
+ this.nullifierReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), AztecAddress.ZERO));
125
+ return this;
126
+ }
127
+
128
+ /** Adds a key validation request to validation requests. */
129
+ addKeyValidationRequest(opts?: { contractAddress?: AztecAddress }): this {
130
+ const addr = opts?.contractAddress ?? this.contractAddress;
131
+ this.keyValidationRequests.push(
132
+ new ScopedKeyValidationRequestAndSeparator(
133
+ new KeyValidationRequestAndSeparator(
134
+ new KeyValidationRequest(new Point(Fr.random(), Fr.random(), false), Fr.random()),
135
+ Fr.random(),
136
+ ),
137
+ addr,
138
+ ),
139
+ );
140
+ return this;
141
+ }
142
+
143
+ /** Adds a private log to the accumulated data. Defaults are generated randomly. */
144
+ addPrivateLog(opts?: { noteHashCounter?: number; counter?: number; contractAddress?: AztecAddress }): this {
145
+ const noteHashCounter = opts?.noteHashCounter ?? 0;
146
+ const counter = this.getCounter(opts?.counter);
147
+ const addr = opts?.contractAddress ?? this.contractAddress;
148
+ this.privateLogs.push(
149
+ new ScopedPrivateLogData(new PrivateLogData(PrivateLog.empty(), noteHashCounter, counter), addr),
150
+ );
151
+ return this;
152
+ }
153
+
154
+ /** Builds the PrivateKernelCircuitPublicInputs with all added side effects. */
155
+ build(): PrivateKernelCircuitPublicInputs {
156
+ const publicInputs = PrivateKernelCircuitPublicInputs.empty();
157
+ publicInputs.end.noteHashes = makeClaimed(this.noteHashes, ScopedNoteHash, MAX_NOTE_HASHES_PER_TX);
158
+ publicInputs.end.nullifiers = makeClaimed(this.nullifiers, ScopedNullifier, MAX_NULLIFIERS_PER_TX);
159
+ publicInputs.end.privateLogs = makeClaimed(this.privateLogs, ScopedPrivateLogData, MAX_PRIVATE_LOGS_PER_TX);
160
+ publicInputs.validationRequests.noteHashReadRequests = makeClaimed(
161
+ this.noteHashReadRequests,
162
+ ScopedReadRequest,
163
+ MAX_NOTE_HASH_READ_REQUESTS_PER_TX,
164
+ );
165
+ publicInputs.validationRequests.nullifierReadRequests = makeClaimed(
166
+ this.nullifierReadRequests,
167
+ ScopedReadRequest,
168
+ MAX_NULLIFIER_READ_REQUESTS_PER_TX,
169
+ );
170
+ publicInputs.validationRequests.scopedKeyValidationRequestsAndSeparators = makeClaimed(
171
+ this.keyValidationRequests,
172
+ ScopedKeyValidationRequestAndSeparator,
173
+ MAX_KEY_VALIDATION_REQUESTS_PER_TX,
174
+ );
175
+ return publicInputs;
176
+ }
177
+ }
178
+
179
+ /** Builder for PrivateCircuitPublicInputs (call-level) with fluent API for adding side effects. */
180
+ export class PrivateCircuitPublicInputsBuilder {
181
+ private noteHashes: NoteHash[] = [];
182
+ private nullifiers: Nullifier[] = [];
183
+ private noteHashReadRequests: ScopedReadRequest[] = [];
184
+ private nullifierReadRequests: ScopedReadRequest[] = [];
185
+ private keyValidationRequests: KeyValidationRequestAndSeparator[] = [];
186
+ private privateLogs: PrivateLogData[] = [];
187
+ private nextCounter: number;
188
+
189
+ constructor(
190
+ private contractAddress: AztecAddress = DEFAULT_CONTRACT_ADDRESS,
191
+ startCounter = 1,
192
+ ) {
193
+ this.nextCounter = startCounter;
194
+ }
195
+
196
+ private getCounter(sideEffectCounter?: number): number {
197
+ if (sideEffectCounter !== undefined) {
198
+ this.nextCounter = sideEffectCounter + 1;
199
+ return sideEffectCounter;
200
+ }
201
+ return this.nextCounter++;
202
+ }
203
+
204
+ /** Adds a note hash. Defaults are generated randomly. */
205
+ addNoteHash(opts?: { value?: Fr; counter?: number }): this {
206
+ const value = opts?.value ?? Fr.random();
207
+ const counter = this.getCounter(opts?.counter);
208
+ this.noteHashes.push(new NoteHash(value, counter));
209
+ return this;
210
+ }
211
+
212
+ /** Adds a nullifier. Defaults are generated randomly. */
213
+ addNullifier(opts?: { value?: Fr; noteHash?: Fr; counter?: number }): this {
214
+ const value = opts?.value ?? Fr.random();
215
+ const noteHash = opts?.noteHash ?? Fr.ZERO;
216
+ const counter = this.getCounter(opts?.counter);
217
+ this.nullifiers.push(new Nullifier(value, noteHash, counter));
218
+ return this;
219
+ }
220
+
221
+ /** Adds a pending note hash read request (non-empty contract address, can match a pending note hash). */
222
+ addPendingNoteHashReadRequest(opts?: { value?: Fr; counter?: number }): this {
223
+ const value = opts?.value ?? Fr.random();
224
+ const counter = this.getCounter(opts?.counter);
225
+ this.noteHashReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), this.contractAddress));
226
+ return this;
227
+ }
228
+
229
+ /** Adds a settled note hash read request (empty contract address, resolved against the note hash tree). */
230
+ addSettledNoteHashReadRequest(opts?: { value?: Fr; counter?: number }): this {
231
+ const value = opts?.value ?? Fr.random();
232
+ const counter = this.getCounter(opts?.counter);
233
+ this.noteHashReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), AztecAddress.ZERO));
234
+ return this;
235
+ }
236
+
237
+ /** Adds a pending nullifier read request (non-empty contract address, can match a pending nullifier). */
238
+ addPendingNullifierReadRequest(opts?: { value?: Fr; counter?: number }): this {
239
+ const value = opts?.value ?? Fr.random();
240
+ const counter = this.getCounter(opts?.counter);
241
+ this.nullifierReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), this.contractAddress));
242
+ return this;
243
+ }
244
+
245
+ /** Adds a settled nullifier read request (empty contract address, resolved against the nullifier tree). */
246
+ addSettledNullifierReadRequest(opts?: { value?: Fr; counter?: number }): this {
247
+ const value = opts?.value ?? Fr.random();
248
+ const counter = this.getCounter(opts?.counter);
249
+ this.nullifierReadRequests.push(new ScopedReadRequest(new ReadRequest(value, counter), AztecAddress.ZERO));
250
+ return this;
251
+ }
252
+
253
+ /** Adds a key validation request. */
254
+ addKeyValidationRequest(): this {
255
+ this.keyValidationRequests.push(
256
+ new KeyValidationRequestAndSeparator(
257
+ new KeyValidationRequest(new Point(Fr.random(), Fr.random(), false), Fr.random()),
258
+ Fr.random(),
259
+ ),
260
+ );
261
+ return this;
262
+ }
263
+
264
+ /** Adds a private log. Defaults are generated randomly. */
265
+ addPrivateLog(opts?: { noteHashCounter?: number; counter?: number }): this {
266
+ const noteHashCounter = opts?.noteHashCounter ?? 0;
267
+ const counter = this.getCounter(opts?.counter);
268
+ this.privateLogs.push(new PrivateLogData(PrivateLog.empty(), noteHashCounter, counter));
269
+ return this;
270
+ }
271
+
272
+ /** Builds the PrivateCircuitPublicInputs with all added side effects. */
273
+ build(): PrivateCircuitPublicInputs {
274
+ const publicInputs = PrivateCircuitPublicInputs.empty();
275
+ publicInputs.callContext.contractAddress = this.contractAddress;
276
+ publicInputs.noteHashes = makeClaimed(this.noteHashes, NoteHash, MAX_NOTE_HASHES_PER_CALL);
277
+ publicInputs.nullifiers = makeClaimed(this.nullifiers, Nullifier, MAX_NULLIFIERS_PER_CALL);
278
+ publicInputs.privateLogs = makeClaimed(this.privateLogs, PrivateLogData, MAX_PRIVATE_LOGS_PER_CALL);
279
+ publicInputs.noteHashReadRequests = makeClaimed(
280
+ this.noteHashReadRequests,
281
+ ScopedReadRequest,
282
+ MAX_NOTE_HASH_READ_REQUESTS_PER_CALL,
283
+ );
284
+ publicInputs.nullifierReadRequests = makeClaimed(
285
+ this.nullifierReadRequests,
286
+ ScopedReadRequest,
287
+ MAX_NULLIFIER_READ_REQUESTS_PER_CALL,
288
+ );
289
+ publicInputs.keyValidationRequestsAndSeparators = makeClaimed(
290
+ this.keyValidationRequests,
291
+ KeyValidationRequestAndSeparator,
292
+ MAX_KEY_VALIDATION_REQUESTS_PER_CALL,
293
+ );
294
+ return publicInputs;
295
+ }
296
+ }
297
+
298
+ /** Wraps a PrivateKernelCircuitPublicInputs in a PrivateKernelSimulateOutput. */
299
+ export function makeKernelOutput(
300
+ publicInputs?: PrivateKernelCircuitPublicInputs,
301
+ ): PrivateKernelSimulateOutput<PrivateKernelCircuitPublicInputs> {
302
+ return {
303
+ publicInputs: publicInputs ?? PrivateKernelCircuitPublicInputs.empty(),
304
+ verificationKey: VerificationKeyData.empty(),
305
+ outputWitness: new Map(),
306
+ bytecode: Buffer.from([]),
307
+ };
308
+ }
309
+
310
+ /** Wraps a PrivateCircuitPublicInputs in a PrivateCallExecutionResult. */
311
+ export function makeExecutionResult(publicInputs?: PrivateCircuitPublicInputs): PrivateCallExecutionResult {
312
+ return new PrivateCallExecutionResult(
313
+ Buffer.alloc(0),
314
+ Buffer.alloc(0),
315
+ new Map(),
316
+ publicInputs ?? PrivateCircuitPublicInputs.empty(),
317
+ [],
318
+ new Map(),
319
+ [],
320
+ [],
321
+ [],
322
+ [],
323
+ [],
324
+ );
325
+ }
@@ -33,6 +33,7 @@ import {
33
33
  } from '@aztec/stdlib/tx';
34
34
  import { VerificationKeyAsFields, VerificationKeyData, VkData } from '@aztec/stdlib/vks';
35
35
 
36
+ import { computeTxExpirationTimestamp } from './hints/compute_tx_expiration_timestamp.js';
36
37
  import { PrivateKernelResetPrivateInputsBuilder } from './hints/private_kernel_reset_private_inputs_builder.js';
37
38
  import type { PrivateKernelOracle } from './private_kernel_oracle.js';
38
39
 
@@ -116,6 +117,7 @@ export class PrivateKernelExecutionProver {
116
117
  splitCounter,
117
118
  );
118
119
  while (resetBuilder.needsReset()) {
120
+ // Inner reset: without siloing.
119
121
  const witgenTimer = new Timer();
120
122
  const privateInputs = await resetBuilder.build(this.oracle);
121
123
  output = generateWitnesses
@@ -216,16 +218,24 @@ export class PrivateKernelExecutionProver {
216
218
  firstIteration = false;
217
219
  }
218
220
 
219
- // Reset.
220
- let resetBuilder = new PrivateKernelResetPrivateInputsBuilder(
221
+ // Final reset: include siloing of note hashes, nullifiers and private logs.
222
+ const finalResetBuilder = new PrivateKernelResetPrivateInputsBuilder(
221
223
  output,
222
224
  [],
223
225
  noteHashNullifierCounterMap,
224
226
  splitCounter,
225
227
  );
226
- while (resetBuilder.needsReset()) {
228
+ if (!finalResetBuilder.needsReset()) {
229
+ // The final reset must be performed exactly once, because each tx has at least one nullifier that requires
230
+ // siloing, and siloing cannot be done multiple times.
231
+ // While, in theory, it might be possible to silo note hashes first and then run another reset to silo nullifiers
232
+ // and/or private logs, we currently don't have standalone dimensions for the arrays that require siloing. As a
233
+ // result, all necessary siloing must be done together in a single reset.
234
+ // Refer to the possible combinations of dimensions in private_kernel_reset_config.json.
235
+ throw new Error('Nothing to reset for the final reset.');
236
+ } else {
227
237
  const witgenTimer = new Timer();
228
- const privateInputs = await resetBuilder.build(this.oracle);
238
+ const privateInputs = await finalResetBuilder.build(this.oracle);
229
239
  output = generateWitnesses
230
240
  ? await this.proofCreator.generateResetOutput(privateInputs)
231
241
  : await this.proofCreator.simulateReset(privateInputs);
@@ -239,8 +249,6 @@ export class PrivateKernelExecutionProver {
239
249
  witgen: witgenTimer.ms(),
240
250
  },
241
251
  });
242
-
243
- resetBuilder = new PrivateKernelResetPrivateInputsBuilder(output, [], noteHashNullifierCounterMap, splitCounter);
244
252
  }
245
253
 
246
254
  if (output.publicInputs.feePayer.isZero() && skipFeeEnforcement) {
@@ -260,20 +268,14 @@ export class PrivateKernelExecutionProver {
260
268
  // TODO: Enable padding once we better understand the final amounts to pad to.
261
269
  const paddedSideEffectAmounts = PaddedSideEffectAmounts.empty();
262
270
 
263
- // Use the aggregated includeByTimestamp set throughout the tx execution.
264
- // TODO: Call `computeTxIncludeByTimestamp` to round the value down and reduce precision, improving privacy.
265
- const includeByTimestampUpperBound = previousKernelData.publicInputs.includeByTimestamp;
266
- const anchorBlockTimestamp = previousKernelData.publicInputs.constants.anchorBlockHeader.globalVariables.timestamp;
267
- if (includeByTimestampUpperBound <= anchorBlockTimestamp) {
268
- throw new Error(
269
- `Include-by timestamp must be greater than the anchor block timestamp. Anchor block timestamp: ${anchorBlockTimestamp}. Include-by timestamp: ${includeByTimestampUpperBound}.`,
270
- );
271
- }
271
+ // Round the aggregated expirationTimestamp down to reduce precision and avoid leaking which private
272
+ // functions were called via their exact expiration offsets.
273
+ const expirationTimestampUpperBound = computeTxExpirationTimestamp(previousKernelData.publicInputs);
272
274
 
273
275
  const privateInputs = new PrivateKernelTailCircuitPrivateInputs(
274
276
  previousKernelData,
275
277
  paddedSideEffectAmounts,
276
- includeByTimestampUpperBound,
278
+ expirationTimestampUpperBound,
277
279
  );
278
280
 
279
281
  const witgenTimer = new Timer();
@@ -7,17 +7,13 @@ import { getVKIndex, getVKSiblingPath } from '@aztec/noir-protocol-circuits-type
7
7
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
8
8
  import type { FunctionSelector } from '@aztec/stdlib/abi';
9
9
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
10
- import { BlockHash } from '@aztec/stdlib/block';
11
- import {
12
- type ContractInstanceWithAddress,
13
- computeContractClassIdPreimage,
14
- computeSaltedInitializationHash,
15
- } from '@aztec/stdlib/contract';
10
+ import { type ContractInstanceWithAddress, computeSaltedInitializationHash } from '@aztec/stdlib/contract';
16
11
  import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '@aztec/stdlib/delayed-public-mutable';
17
12
  import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
18
13
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
19
14
  import { UpdatedClassIdHints } from '@aztec/stdlib/kernel';
20
15
  import type { NullifierMembershipWitness } from '@aztec/stdlib/trees';
16
+ import type { BlockHeader } from '@aztec/stdlib/tx';
21
17
  import type { VerificationKeyAsFields } from '@aztec/stdlib/vks';
22
18
 
23
19
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
@@ -30,7 +26,7 @@ export class PrivateKernelOracle {
30
26
  private contractStore: ContractStore,
31
27
  private keyStore: KeyStore,
32
28
  private node: AztecNode,
33
- private blockHash: BlockHash,
29
+ private blockHeader: BlockHeader,
34
30
  ) {}
35
31
 
36
32
  /** Retrieves the preimage of a contract address from the registered contract instances db. */
@@ -49,11 +45,15 @@ export class PrivateKernelOracle {
49
45
 
50
46
  /** Retrieves the preimage of a contract class id from the contract classes db. */
51
47
  public async getContractClassIdPreimage(contractClassId: Fr) {
52
- const contractClass = await this.contractStore.getContractClass(contractClassId);
48
+ const contractClass = await this.contractStore.getContractClassWithPreimage(contractClassId);
53
49
  if (!contractClass) {
54
50
  throw new Error(`Contract class not found when getting class id preimage. Class id: ${contractClassId}.`);
55
51
  }
56
- return computeContractClassIdPreimage(contractClass);
52
+ return {
53
+ artifactHash: contractClass.artifactHash,
54
+ privateFunctionsRoot: contractClass.privateFunctionsRoot,
55
+ publicBytecodeCommitment: contractClass.publicBytecodeCommitment,
56
+ };
57
57
  }
58
58
 
59
59
  /** Returns a membership witness with the sibling path and leaf index in our private functions tree. */
@@ -80,22 +80,20 @@ export class PrivateKernelOracle {
80
80
  }
81
81
 
82
82
  /** Returns a membership witness with the sibling path and leaf index in our note hash tree. */
83
- getNoteHashMembershipWitness(noteHash: Fr): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
84
- return this.node.getNoteHashMembershipWitness(this.blockHash, noteHash);
83
+ async getNoteHashMembershipWitness(
84
+ noteHash: Fr,
85
+ ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
86
+ return this.node.getNoteHashMembershipWitness(await this.blockHeader.hash(), noteHash);
85
87
  }
86
88
 
87
89
  /** Returns a membership witness with the sibling path and leaf index in our nullifier indexed merkle tree. */
88
- getNullifierMembershipWitness(nullifier: Fr): Promise<NullifierMembershipWitness | undefined> {
89
- return this.node.getNullifierMembershipWitness(this.blockHash, nullifier);
90
+ async getNullifierMembershipWitness(nullifier: Fr): Promise<NullifierMembershipWitness | undefined> {
91
+ return this.node.getNullifierMembershipWitness(await this.blockHeader.hash(), nullifier);
90
92
  }
91
93
 
92
94
  /** Returns the root of our note hash merkle tree. */
93
- async getNoteHashTreeRoot(): Promise<Fr> {
94
- const header = await this.node.getBlockHeader(this.blockHash);
95
- if (!header) {
96
- throw new Error(`No block header found for block hash ${this.blockHash}`);
97
- }
98
- return header.state.partial.noteHashTree.root;
95
+ getNoteHashTreeRoot(): Fr {
96
+ return this.blockHeader.state.partial.noteHashTree.root;
99
97
  }
100
98
 
101
99
  /**
@@ -126,14 +124,16 @@ export class PrivateKernelOracle {
126
124
  ProtocolContractAddress.ContractInstanceRegistry,
127
125
  delayedPublicMutableHashSlot,
128
126
  );
129
- const updatedClassIdWitness = await this.node.getPublicDataWitness(this.blockHash, hashLeafSlot);
127
+ const blockHash = await this.blockHeader.hash();
128
+
129
+ const updatedClassIdWitness = await this.node.getPublicDataWitness(blockHash, hashLeafSlot);
130
130
 
131
131
  if (!updatedClassIdWitness) {
132
132
  throw new Error(`No public data tree witness found for ${hashLeafSlot}`);
133
133
  }
134
134
 
135
135
  const readStorage = (storageSlot: Fr) =>
136
- this.node.getPublicStorageAt(this.blockHash, ProtocolContractAddress.ContractInstanceRegistry, storageSlot);
136
+ this.node.getPublicStorageAt(blockHash, ProtocolContractAddress.ContractInstanceRegistry, storageSlot);
137
137
  const delayedPublicMutableValues = await DelayedPublicMutableValues.readFromTree(
138
138
  delayedPublicMutableSlot,
139
139
  readStorage,