@aztec/pxe 0.0.1-commit.d1f2d6c → 0.0.1-commit.d20b825a7

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 (261) hide show
  1. package/dest/bin/check_oracle_version.js +5 -5
  2. package/dest/block_synchronizer/block_synchronizer.d.ts +10 -4
  3. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  4. package/dest/block_synchronizer/block_synchronizer.js +30 -6
  5. package/dest/config/index.d.ts +2 -2
  6. package/dest/config/index.d.ts.map +1 -1
  7. package/dest/config/index.js +8 -15
  8. package/dest/config/package_info.js +1 -1
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts +63 -31
  10. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  11. package/dest/contract_function_simulator/contract_function_simulator.js +206 -77
  12. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  13. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  14. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  15. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -7
  16. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -11
  18. package/dest/contract_function_simulator/index.d.ts +2 -1
  19. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/index.js +1 -0
  21. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +5 -7
  22. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  23. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +9 -11
  24. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +1 -1
  25. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +1 -1
  26. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  27. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  29. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +5 -8
  30. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +7 -12
  32. package/dest/contract_function_simulator/oracle/interfaces.d.ts +62 -46
  33. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  35. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  36. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +47 -0
  37. package/dest/contract_function_simulator/oracle/oracle.d.ts +75 -44
  38. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  39. package/dest/contract_function_simulator/oracle/oracle.js +310 -113
  40. package/dest/contract_function_simulator/oracle/private_execution.d.ts +3 -22
  41. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/oracle/private_execution.js +5 -49
  43. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +60 -84
  44. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  45. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +125 -98
  46. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +128 -70
  47. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  48. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +330 -143
  49. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  50. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  51. package/dest/contract_function_simulator/pick_notes.js +20 -3
  52. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  53. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  54. package/dest/contract_function_simulator/proxied_contract_data_source.js +3 -0
  55. package/dest/contract_logging.d.ts +27 -0
  56. package/dest/contract_logging.d.ts.map +1 -0
  57. package/dest/contract_logging.js +38 -0
  58. package/dest/contract_sync/contract_sync_service.d.ts +44 -0
  59. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  60. package/dest/contract_sync/contract_sync_service.js +116 -0
  61. package/dest/contract_sync/helpers.d.ts +28 -0
  62. package/dest/contract_sync/helpers.d.ts.map +1 -0
  63. package/dest/contract_sync/helpers.js +60 -0
  64. package/dest/debug/pxe_debug_utils.d.ts +24 -10
  65. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  66. package/dest/debug/pxe_debug_utils.js +28 -18
  67. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  68. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  69. package/dest/entrypoints/client/bundle/index.js +2 -0
  70. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  71. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  72. package/dest/entrypoints/client/bundle/utils.js +23 -9
  73. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  74. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  75. package/dest/entrypoints/client/lazy/index.js +2 -0
  76. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  77. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  78. package/dest/entrypoints/client/lazy/utils.js +24 -10
  79. package/dest/entrypoints/pxe_creation_options.d.ts +5 -2
  80. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  81. package/dest/entrypoints/pxe_creation_options.js +3 -1
  82. package/dest/entrypoints/server/index.d.ts +4 -2
  83. package/dest/entrypoints/server/index.d.ts.map +1 -1
  84. package/dest/entrypoints/server/index.js +3 -1
  85. package/dest/entrypoints/server/utils.d.ts +2 -2
  86. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  87. package/dest/entrypoints/server/utils.js +30 -11
  88. package/dest/events/event_service.d.ts +6 -6
  89. package/dest/events/event_service.d.ts.map +1 -1
  90. package/dest/events/event_service.js +31 -11
  91. package/dest/events/private_event_filter_validator.d.ts +3 -2
  92. package/dest/events/private_event_filter_validator.d.ts.map +1 -1
  93. package/dest/events/private_event_filter_validator.js +15 -0
  94. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  95. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  96. package/dest/job_coordinator/job_coordinator.js +3 -2
  97. package/dest/logs/log_service.d.ts +10 -9
  98. package/dest/logs/log_service.d.ts.map +1 -1
  99. package/dest/logs/log_service.js +41 -62
  100. package/dest/messages/message_context_service.d.ts +17 -0
  101. package/dest/messages/message_context_service.d.ts.map +1 -0
  102. package/dest/messages/message_context_service.js +36 -0
  103. package/dest/notes/note_service.d.ts +7 -8
  104. package/dest/notes/note_service.d.ts.map +1 -1
  105. package/dest/notes/note_service.js +23 -15
  106. package/dest/notes_filter.d.ts +24 -0
  107. package/dest/notes_filter.d.ts.map +1 -0
  108. package/dest/notes_filter.js +4 -0
  109. package/dest/oracle_version.d.ts +4 -3
  110. package/dest/oracle_version.d.ts.map +1 -1
  111. package/dest/oracle_version.js +20 -10
  112. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  113. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  114. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  115. package/dest/private_kernel/hints/index.d.ts +1 -1
  116. package/dest/private_kernel/hints/index.js +1 -1
  117. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  118. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  119. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  120. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  121. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  122. package/dest/private_kernel/hints/test_utils.js +203 -0
  123. package/dest/private_kernel/private_kernel_execution_prover.d.ts +3 -2
  124. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  125. package/dest/private_kernel/private_kernel_execution_prover.js +20 -15
  126. package/dest/private_kernel/private_kernel_oracle.d.ts +10 -6
  127. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  128. package/dest/private_kernel/private_kernel_oracle.js +19 -18
  129. package/dest/pxe.d.ts +85 -24
  130. package/dest/pxe.d.ts.map +1 -1
  131. package/dest/pxe.js +169 -87
  132. package/dest/storage/address_store/address_store.d.ts +1 -1
  133. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  134. package/dest/storage/address_store/address_store.js +12 -11
  135. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  136. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  137. package/dest/storage/anchor_block_store/anchor_block_store.js +9 -2
  138. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  139. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  140. package/dest/storage/capsule_store/capsule_service.js +50 -0
  141. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  142. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  143. package/dest/storage/capsule_store/capsule_store.js +42 -36
  144. package/dest/storage/capsule_store/index.d.ts +2 -1
  145. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  146. package/dest/storage/capsule_store/index.js +1 -0
  147. package/dest/storage/contract_store/contract_store.d.ts +42 -16
  148. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  149. package/dest/storage/contract_store/contract_store.js +160 -85
  150. package/dest/storage/metadata.d.ts +1 -1
  151. package/dest/storage/metadata.js +1 -1
  152. package/dest/storage/note_store/note_store.d.ts +14 -4
  153. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  154. package/dest/storage/note_store/note_store.js +149 -109
  155. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  156. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  157. package/dest/storage/private_event_store/private_event_store.js +87 -61
  158. package/dest/storage/private_event_store/stored_private_event.d.ts +4 -4
  159. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -1
  160. package/dest/storage/private_event_store/stored_private_event.js +2 -2
  161. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  162. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  163. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  164. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  165. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  166. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  167. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  168. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  169. package/dest/storage/tagging_store/sender_tagging_store.js +233 -137
  170. package/dest/tagging/get_all_logs_by_tags.d.ts +4 -4
  171. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  172. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  173. package/dest/tagging/index.d.ts +3 -3
  174. package/dest/tagging/index.d.ts.map +1 -1
  175. package/dest/tagging/index.js +1 -1
  176. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +5 -6
  177. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  178. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +8 -22
  179. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  180. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +7 -8
  181. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  182. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  183. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +5 -9
  184. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  185. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  186. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  187. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  188. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  189. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +6 -8
  190. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  191. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  192. package/package.json +25 -16
  193. package/src/bin/check_oracle_version.ts +5 -4
  194. package/src/block_synchronizer/block_synchronizer.ts +45 -21
  195. package/src/config/index.ts +3 -9
  196. package/src/config/package_info.ts +1 -1
  197. package/src/contract_function_simulator/contract_function_simulator.ts +366 -136
  198. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  199. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  200. package/src/contract_function_simulator/index.ts +1 -0
  201. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +10 -10
  202. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +1 -1
  203. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  204. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +5 -11
  205. package/src/contract_function_simulator/oracle/interfaces.ts +90 -62
  206. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +104 -0
  207. package/src/contract_function_simulator/oracle/oracle.ts +391 -150
  208. package/src/contract_function_simulator/oracle/private_execution.ts +5 -83
  209. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +160 -193
  210. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +552 -179
  211. package/src/contract_function_simulator/pick_notes.ts +22 -3
  212. package/src/contract_function_simulator/proxied_contract_data_source.ts +8 -1
  213. package/src/contract_logging.ts +52 -0
  214. package/src/contract_sync/contract_sync_service.ts +176 -0
  215. package/src/contract_sync/helpers.ts +98 -0
  216. package/src/debug/pxe_debug_utils.ts +63 -19
  217. package/src/entrypoints/client/bundle/index.ts +2 -0
  218. package/src/entrypoints/client/bundle/utils.ts +18 -18
  219. package/src/entrypoints/client/lazy/index.ts +2 -0
  220. package/src/entrypoints/client/lazy/utils.ts +19 -18
  221. package/src/entrypoints/pxe_creation_options.ts +9 -1
  222. package/src/entrypoints/server/index.ts +3 -1
  223. package/src/entrypoints/server/utils.ts +24 -29
  224. package/src/events/event_service.ts +35 -12
  225. package/src/events/private_event_filter_validator.ts +21 -1
  226. package/src/job_coordinator/job_coordinator.ts +4 -3
  227. package/src/logs/log_service.ts +77 -106
  228. package/src/messages/message_context_service.ts +44 -0
  229. package/src/notes/note_service.ts +25 -17
  230. package/src/notes_filter.ts +24 -0
  231. package/src/oracle_version.ts +20 -10
  232. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  233. package/src/private_kernel/hints/index.ts +1 -1
  234. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  235. package/src/private_kernel/hints/test_utils.ts +325 -0
  236. package/src/private_kernel/private_kernel_execution_prover.ts +24 -19
  237. package/src/private_kernel/private_kernel_oracle.ts +21 -21
  238. package/src/pxe.ts +318 -144
  239. package/src/storage/address_store/address_store.ts +15 -15
  240. package/src/storage/anchor_block_store/anchor_block_store.ts +9 -1
  241. package/src/storage/capsule_store/capsule_service.ts +90 -0
  242. package/src/storage/capsule_store/capsule_store.ts +52 -34
  243. package/src/storage/capsule_store/index.ts +1 -0
  244. package/src/storage/contract_store/contract_store.ts +193 -101
  245. package/src/storage/metadata.ts +1 -1
  246. package/src/storage/note_store/note_store.ts +168 -134
  247. package/src/storage/private_event_store/private_event_store.ts +106 -81
  248. package/src/storage/private_event_store/stored_private_event.ts +3 -3
  249. package/src/storage/tagging_store/recipient_tagging_store.ts +38 -24
  250. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  251. package/src/storage/tagging_store/sender_tagging_store.ts +287 -156
  252. package/src/tagging/get_all_logs_by_tags.ts +31 -7
  253. package/src/tagging/index.ts +2 -2
  254. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +14 -27
  255. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  256. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +12 -17
  257. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +25 -12
  258. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  259. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +30 -29
  260. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  261. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -3,35 +3,39 @@ import type { BlockNumber } from '@aztec/foundation/branded-types';
3
3
  import { Aes128 } from '@aztec/foundation/crypto/aes128';
4
4
  import { Fr } from '@aztec/foundation/curves/bn254';
5
5
  import { Point } from '@aztec/foundation/curves/grumpkin';
6
- import { LogLevels, applyStringFormatting, createLogger } from '@aztec/foundation/log';
6
+ import { LogLevels, type Logger, createLogger } from '@aztec/foundation/log';
7
7
  import type { MembershipWitness } from '@aztec/foundation/trees';
8
8
  import type { KeyStore } from '@aztec/key-store';
9
+ import { isProtocolContract } from '@aztec/protocol-contracts';
9
10
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
10
11
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
11
- import { L2BlockHash } from '@aztec/stdlib/block';
12
- import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
12
+ import { BlockHash, type L2TipsProvider } from '@aztec/stdlib/block';
13
+ import type { CompleteAddress, ContractInstance, PartialAddress } from '@aztec/stdlib/contract';
13
14
  import { siloNullifier } from '@aztec/stdlib/hash';
14
15
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
15
16
  import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
16
- import { computeAddressSecret } from '@aztec/stdlib/keys';
17
- import { deriveEcdhSharedSecret } from '@aztec/stdlib/logs';
17
+ import { type PublicKeys, computeAddressSecret } from '@aztec/stdlib/keys';
18
+ import { MessageContext, deriveAppSiloedSharedSecret } from '@aztec/stdlib/logs';
18
19
  import { getNonNullifiedL1ToL2MessageWitness } from '@aztec/stdlib/messaging';
19
20
  import type { NoteStatus } from '@aztec/stdlib/note';
20
21
  import { MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
21
- import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
22
+ import type { BlockHeader, Capsule, OffchainEffect } from '@aztec/stdlib/tx';
22
23
 
24
+ import { createContractLogger, logContractMessage, stripAztecnrLogPrefix } from '../../contract_logging.js';
25
+ import type { ContractSyncService } from '../../contract_sync/contract_sync_service.js';
23
26
  import { EventService } from '../../events/event_service.js';
24
27
  import { LogService } from '../../logs/log_service.js';
28
+ import { MessageContextService } from '../../messages/message_context_service.js';
25
29
  import { NoteService } from '../../notes/note_service.js';
26
- import { ORACLE_VERSION } from '../../oracle_version.js';
30
+ import { ORACLE_VERSION_MAJOR } from '../../oracle_version.js';
27
31
  import type { AddressStore } from '../../storage/address_store/address_store.js';
28
- import type { AnchorBlockStore } from '../../storage/anchor_block_store/anchor_block_store.js';
29
- import type { CapsuleStore } from '../../storage/capsule_store/capsule_store.js';
32
+ import type { CapsuleService } from '../../storage/capsule_store/capsule_service.js';
30
33
  import type { ContractStore } from '../../storage/contract_store/contract_store.js';
31
34
  import type { NoteStore } from '../../storage/note_store/note_store.js';
32
35
  import type { PrivateEventStore } from '../../storage/private_event_store/private_event_store.js';
33
36
  import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
34
37
  import type { SenderAddressBookStore } from '../../storage/tagging_store/sender_address_book_store.js';
38
+ import { EphemeralArrayService } from '../ephemeral_array_service.js';
35
39
  import { EventValidationRequest } from '../noir-structs/event_validation_request.js';
36
40
  import { LogRetrievalRequest } from '../noir-structs/log_retrieval_request.js';
37
41
  import { LogRetrievalResponse } from '../noir-structs/log_retrieval_response.js';
@@ -41,6 +45,30 @@ import { pickNotes } from '../pick_notes.js';
41
45
  import type { IMiscOracle, IUtilityExecutionOracle, NoteData } from './interfaces.js';
42
46
  import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
43
47
 
48
+ /** Args for UtilityExecutionOracle constructor. */
49
+ export type UtilityExecutionOracleArgs = {
50
+ contractAddress: AztecAddress;
51
+ /** List of transient auth witnesses to be used during this simulation */
52
+ authWitnesses: AuthWitness[];
53
+ capsules: Capsule[]; // TODO(#12425): Rename to transientCapsules
54
+ anchorBlockHeader: BlockHeader;
55
+ contractStore: ContractStore;
56
+ noteStore: NoteStore;
57
+ keyStore: KeyStore;
58
+ addressStore: AddressStore;
59
+ aztecNode: AztecNode;
60
+ recipientTaggingStore: RecipientTaggingStore;
61
+ senderAddressBookStore: SenderAddressBookStore;
62
+ capsuleService: CapsuleService;
63
+ privateEventStore: PrivateEventStore;
64
+ messageContextService: MessageContextService;
65
+ contractSyncService: ContractSyncService;
66
+ l2TipsStore: L2TipsProvider;
67
+ jobId: string;
68
+ log?: ReturnType<typeof createLogger>;
69
+ scopes: AztecAddress[];
70
+ };
71
+
44
72
  /**
45
73
  * The oracle for an execution of utility contract functions.
46
74
  */
@@ -48,40 +76,101 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
48
76
  isMisc = true as const;
49
77
  isUtility = true as const;
50
78
 
51
- private aztecNrDebugLog = createLogger('aztec-nr:debug_log');
52
-
53
- constructor(
54
- protected readonly contractAddress: AztecAddress,
55
- /** List of transient auth witnesses to be used during this simulation */
56
- protected readonly authWitnesses: AuthWitness[],
57
- protected readonly capsules: Capsule[], // TODO(#12425): Rename to transientCapsules
58
- protected readonly anchorBlockHeader: BlockHeader,
59
- protected readonly contractStore: ContractStore,
60
- protected readonly noteStore: NoteStore,
61
- protected readonly keyStore: KeyStore,
62
- protected readonly addressStore: AddressStore,
63
- protected readonly aztecNode: AztecNode,
64
- protected readonly anchorBlockStore: AnchorBlockStore,
65
- protected readonly recipientTaggingStore: RecipientTaggingStore,
66
- protected readonly senderAddressBookStore: SenderAddressBookStore,
67
- protected readonly capsuleStore: CapsuleStore,
68
- protected readonly privateEventStore: PrivateEventStore,
69
- protected readonly jobId: string,
70
- protected log = createLogger('simulator:client_view_context'),
71
- protected readonly scopes?: AztecAddress[],
72
- ) {}
73
-
74
- public utilityAssertCompatibleOracleVersion(version: number): void {
75
- if (version !== ORACLE_VERSION) {
76
- throw new Error(`Incompatible oracle version. Expected version ${ORACLE_VERSION}, got ${version}.`);
79
+ private contractLogger: Logger | undefined;
80
+ private aztecnrLogger: Logger | undefined;
81
+ private offchainEffects: OffchainEffect[] = [];
82
+ private readonly ephemeralArrayService = new EphemeralArrayService();
83
+
84
+ // We store oracle version to be able to show a nice error message when an oracle handler is missing.
85
+ private contractOracleVersion: { major: number; minor: number } | undefined;
86
+
87
+ protected readonly contractAddress: AztecAddress;
88
+ protected readonly authWitnesses: AuthWitness[];
89
+ protected readonly capsules: Capsule[];
90
+ protected readonly anchorBlockHeader: BlockHeader;
91
+ protected readonly contractStore: ContractStore;
92
+ protected readonly noteStore: NoteStore;
93
+ protected readonly keyStore: KeyStore;
94
+ protected readonly addressStore: AddressStore;
95
+ protected readonly aztecNode: AztecNode;
96
+ protected readonly recipientTaggingStore: RecipientTaggingStore;
97
+ protected readonly senderAddressBookStore: SenderAddressBookStore;
98
+ protected readonly capsuleService: CapsuleService;
99
+ protected readonly privateEventStore: PrivateEventStore;
100
+ protected readonly messageContextService: MessageContextService;
101
+ protected readonly contractSyncService: ContractSyncService;
102
+ protected readonly l2TipsStore: L2TipsProvider;
103
+ protected readonly jobId: string;
104
+ protected logger: ReturnType<typeof createLogger>;
105
+ protected readonly scopes: AztecAddress[];
106
+
107
+ constructor(args: UtilityExecutionOracleArgs) {
108
+ this.contractAddress = args.contractAddress;
109
+ this.authWitnesses = args.authWitnesses;
110
+ this.capsules = args.capsules;
111
+ this.anchorBlockHeader = args.anchorBlockHeader;
112
+ this.contractStore = args.contractStore;
113
+ this.noteStore = args.noteStore;
114
+ this.keyStore = args.keyStore;
115
+ this.addressStore = args.addressStore;
116
+ this.aztecNode = args.aztecNode;
117
+ this.recipientTaggingStore = args.recipientTaggingStore;
118
+ this.senderAddressBookStore = args.senderAddressBookStore;
119
+ this.capsuleService = args.capsuleService;
120
+ this.privateEventStore = args.privateEventStore;
121
+ this.messageContextService = args.messageContextService;
122
+ this.contractSyncService = args.contractSyncService;
123
+ this.l2TipsStore = args.l2TipsStore;
124
+ this.jobId = args.jobId;
125
+ this.logger = args.log ?? createLogger('simulator:client_view_context');
126
+ this.scopes = args.scopes;
127
+ }
128
+
129
+ public assertCompatibleOracleVersion(major: number, minor: number): void {
130
+ // TODO(F-416): Remove this hack on v5 when protocol contracts are redeployed.
131
+ // Protocol contracts/canonical contracts shipped with committed bytecode that cannot be changed. Assert they use
132
+ // the expected pinned version or the current one. We want to allow for both the pinned and the current versions
133
+ // because we want this code to work with both the pinned and unpinned version since some branches do not have the
134
+ // pinned contracts (like e.g. next)
135
+ const LEGACY_ORACLE_VERSION = 12;
136
+ if (isProtocolContract(this.contractAddress)) {
137
+ if (major !== LEGACY_ORACLE_VERSION && major !== ORACLE_VERSION_MAJOR) {
138
+ const hint =
139
+ major > ORACLE_VERSION_MAJOR
140
+ ? 'The contract was compiled with a newer version of Aztec.nr than your private environment supports. Upgrade your private environment to a compatible version.'
141
+ : 'The contract was compiled with an older version of Aztec.nr than your private environment supports. Recompile the contract with a compatible version of Aztec.nr.';
142
+ throw new Error(
143
+ `Incompatible private environment version: ${hint} See https://docs.aztec.network/errors/8 (expected oracle major version ${LEGACY_ORACLE_VERSION} or ${ORACLE_VERSION_MAJOR}, got ${major})`,
144
+ );
145
+ }
146
+ this.contractOracleVersion = { major, minor };
147
+ return;
148
+ }
149
+
150
+ if (major !== ORACLE_VERSION_MAJOR) {
151
+ const hint =
152
+ major > ORACLE_VERSION_MAJOR
153
+ ? 'The contract was compiled with a newer version of Aztec.nr than your private environment supports. Upgrade your private environment to a compatible version.'
154
+ : 'The contract was compiled with an older version of Aztec.nr than your private environment supports. Recompile the contract with a compatible version of Aztec.nr.';
155
+ throw new Error(
156
+ `Incompatible private environment version: ${hint} See https://docs.aztec.network/errors/8 (expected oracle major version ${ORACLE_VERSION_MAJOR}, got ${major})`,
157
+ );
77
158
  }
159
+
160
+ // Major matches - store both major and minor for later diagnostics (e.g. when an oracle is not found)
161
+ this.contractOracleVersion = { major, minor };
162
+ }
163
+
164
+ // Prefixed with "nonOracleFunction" as it is not used as an oracle handler.
165
+ public nonOracleFunctionGetContractOracleVersion(): { major: number; minor: number } | undefined {
166
+ return this.contractOracleVersion;
78
167
  }
79
168
 
80
- public utilityGetRandomField(): Fr {
169
+ public getRandomField(): Fr {
81
170
  return Fr.random();
82
171
  }
83
172
 
84
- public utilityGetUtilityContext(): UtilityContext {
173
+ public getUtilityContext(): UtilityContext {
85
174
  return new UtilityContext(this.anchorBlockHeader, this.contractAddress);
86
175
  }
87
176
 
@@ -90,35 +179,58 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
90
179
  * @param pkMHash - The master public key hash.
91
180
  * @returns A Promise that resolves to nullifier keys.
92
181
  * @throws If the keys are not registered in the key store.
182
+ * @throws If scopes are defined and the account is not in the scopes.
93
183
  */
94
- public utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
184
+ public async getKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest> {
185
+ let hasAccess = false;
186
+ for (let i = 0; i < this.scopes.length && !hasAccess; i++) {
187
+ if (await this.keyStore.accountHasKey(this.scopes[i], pkMHash)) {
188
+ hasAccess = true;
189
+ }
190
+ }
191
+ if (!hasAccess) {
192
+ throw new Error(`Key validation request denied: no scoped account has a key with hash ${pkMHash.toString()}.`);
193
+ }
95
194
  return this.keyStore.getKeyValidationRequest(pkMHash, this.contractAddress);
96
195
  }
97
196
 
98
197
  /**
99
198
  * Fetches the index and sibling path of a leaf at a given block from the note hash tree.
100
- * @param blockHash - The block hash at which to get the membership witness.
101
- * @param leafValue - The leaf value
199
+ * @param blockHash - The hash of a block that contains the note hash tree root in which to find the
200
+ * membership witness.
201
+ * @param noteHash - The note hash to find in the note hash tree.
102
202
  * @returns The membership witness containing the leaf index and sibling path
103
203
  */
104
- public utilityGetNoteHashMembershipWitness(
105
- blockHash: L2BlockHash,
106
- leafValue: Fr,
204
+ public getNoteHashMembershipWitness(
205
+ blockHash: BlockHash,
206
+ noteHash: Fr,
107
207
  ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined> {
108
- return this.aztecNode.getNoteHashMembershipWitness(blockHash, leafValue);
208
+ return this.#queryWithBlockHashNotAfterAnchor(blockHash, () =>
209
+ this.aztecNode.getNoteHashMembershipWitness(blockHash, noteHash),
210
+ );
109
211
  }
110
212
 
111
213
  /**
112
- * Fetches the index and sibling path of a leaf at a given block from the archive tree.
113
- * @param blockHash - The block hash at which to get the membership witness.
114
- * @param leafValue - The leaf value
214
+ * Fetches the index and sibling path of a block hash in the archive tree.
215
+ *
216
+ * Block hashes are the leaves of the archive tree. Each time a new block is added to the chain,
217
+ * its block hash is appended as a new leaf to the archive tree.
218
+ *
219
+ * @param referenceBlockHash - The hash of a block that contains the archive tree root in which to find the membership
220
+ * witness.
221
+ * @param blockHash - The block hash to find in the archive tree.
115
222
  * @returns The membership witness containing the leaf index and sibling path
116
223
  */
117
- public utilityGetArchiveMembershipWitness(
118
- blockHash: L2BlockHash,
119
- leafValue: Fr,
224
+ public getBlockHashMembershipWitness(
225
+ referenceBlockHash: BlockHash,
226
+ blockHash: BlockHash,
120
227
  ): Promise<MembershipWitness<typeof ARCHIVE_HEIGHT> | undefined> {
121
- return this.aztecNode.getArchiveMembershipWitness(blockHash, leafValue);
228
+ // Note that we validate that the reference block hash is at or before the anchor block - we don't test the block
229
+ // hash at all. If the block hash did not exist by the reference block hash, then the node will not return the
230
+ // membership witness as there is none.
231
+ return this.#queryWithBlockHashNotAfterAnchor(referenceBlockHash, () =>
232
+ this.aztecNode.getBlockHashMembershipWitness(referenceBlockHash, blockHash),
233
+ );
122
234
  }
123
235
 
124
236
  /**
@@ -127,11 +239,13 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
127
239
  * @param nullifier - Nullifier we try to find witness for.
128
240
  * @returns The nullifier membership witness (if found).
129
241
  */
130
- public utilityGetNullifierMembershipWitness(
131
- blockHash: L2BlockHash,
242
+ public getNullifierMembershipWitness(
243
+ blockHash: BlockHash,
132
244
  nullifier: Fr,
133
245
  ): Promise<NullifierMembershipWitness | undefined> {
134
- return this.aztecNode.getNullifierMembershipWitness(blockHash, nullifier);
246
+ return this.#queryWithBlockHashNotAfterAnchor(blockHash, () =>
247
+ this.aztecNode.getNullifierMembershipWitness(blockHash, nullifier),
248
+ );
135
249
  }
136
250
 
137
251
  /**
@@ -143,11 +257,13 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
143
257
  * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
144
258
  * we are trying to prove non-inclusion for.
145
259
  */
146
- public utilityGetLowNullifierMembershipWitness(
147
- blockHash: L2BlockHash,
260
+ public getLowNullifierMembershipWitness(
261
+ blockHash: BlockHash,
148
262
  nullifier: Fr,
149
263
  ): Promise<NullifierMembershipWitness | undefined> {
150
- return this.aztecNode.getLowNullifierMembershipWitness(blockHash, nullifier);
264
+ return this.#queryWithBlockHashNotAfterAnchor(blockHash, () =>
265
+ this.aztecNode.getLowNullifierMembershipWitness(blockHash, nullifier),
266
+ );
151
267
  }
152
268
 
153
269
  /**
@@ -156,8 +272,10 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
156
272
  * @param leafSlot - The slot of the public data tree to get the witness for.
157
273
  * @returns - The witness
158
274
  */
159
- public utilityGetPublicDataWitness(blockHash: L2BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined> {
160
- return this.aztecNode.getPublicDataWitness(blockHash, leafSlot);
275
+ public getPublicDataWitness(blockHash: BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined> {
276
+ return this.#queryWithBlockHashNotAfterAnchor(blockHash, () =>
277
+ this.aztecNode.getPublicDataWitness(blockHash, leafSlot),
278
+ );
161
279
  }
162
280
 
163
281
  /**
@@ -165,8 +283,8 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
165
283
  * @param blockNumber - The number of a block of which to get the block header.
166
284
  * @returns Block extracted from a block with block number `blockNumber`.
167
285
  */
168
- public async utilityGetBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined> {
169
- const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
286
+ public async getBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined> {
287
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
170
288
  if (blockNumber > anchorBlockNumber) {
171
289
  throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
172
290
  }
@@ -176,16 +294,21 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
176
294
  }
177
295
 
178
296
  /**
179
- * Retrieve the complete address associated to a given address.
297
+ * Retrieve the public keys and partial address associated to a given address.
180
298
  * @param account - The account address.
181
- * @returns A complete address associated with the input address.
182
- * @throws An error if the account is not registered in the database.
299
+ * @returns The public keys and partial address, or `undefined` if the account is not registered.
183
300
  */
184
- public utilityGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress> {
185
- return this.getCompleteAddress(account);
301
+ public async getPublicKeysAndPartialAddress(
302
+ account: AztecAddress,
303
+ ): Promise<{ publicKeys: PublicKeys; partialAddress: PartialAddress } | undefined> {
304
+ const completeAddress = await this.addressStore.getCompleteAddress(account);
305
+ if (!completeAddress) {
306
+ return undefined;
307
+ }
308
+ return { publicKeys: completeAddress.publicKeys, partialAddress: completeAddress.partialAddress };
186
309
  }
187
310
 
188
- protected async getCompleteAddress(account: AztecAddress): Promise<CompleteAddress> {
311
+ protected async getCompleteAddressOrFail(account: AztecAddress): Promise<CompleteAddress> {
189
312
  const completeAddress = await this.addressStore.getCompleteAddress(account);
190
313
  if (!completeAddress) {
191
314
  throw new Error(
@@ -201,11 +324,7 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
201
324
  * @param address - Address.
202
325
  * @returns A contract instance.
203
326
  */
204
- public utilityGetContractInstance(address: AztecAddress): Promise<ContractInstance> {
205
- return this.getContractInstance(address);
206
- }
207
-
208
- protected async getContractInstance(address: AztecAddress): Promise<ContractInstance> {
327
+ public async getContractInstance(address: AztecAddress): Promise<ContractInstance> {
209
328
  const instance = await this.contractStore.getContractInstance(address);
210
329
  if (!instance) {
211
330
  throw new Error(`No contract instance found for address ${address.toString()}`);
@@ -214,12 +333,11 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
214
333
  }
215
334
 
216
335
  /**
217
- * Returns an auth witness for the given message hash. Checks on the list of transient witnesses
218
- * for this transaction first, and falls back to the local database if not found.
336
+ * Returns an auth witness for the given message hash from the list of transient witnesses for this transaction.
219
337
  * @param messageHash - Hash of the message to authenticate.
220
- * @returns Authentication witness for the requested message hash.
338
+ * @returns Authentication witness for the requested message hash, or undefined if not found.
221
339
  */
222
- public utilityGetAuthWitness(messageHash: Fr): Promise<Fr[] | undefined> {
340
+ public getAuthWitness(messageHash: Fr): Promise<Fr[] | undefined> {
223
341
  return Promise.resolve(this.authWitnesses.find(w => w.requestHash.equals(messageHash))?.witness);
224
342
  }
225
343
 
@@ -245,7 +363,7 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
245
363
  * @param status - The status of notes to fetch.
246
364
  * @returns Array of note data.
247
365
  */
248
- public async utilityGetNotes(
366
+ public async getNotes(
249
367
  owner: AztecAddress | undefined,
250
368
  storageSlot: Fr,
251
369
  numSelects: number,
@@ -262,7 +380,7 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
262
380
  offset: number,
263
381
  status: NoteStatus,
264
382
  ): Promise<NoteData[]> {
265
- const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore, this.jobId);
383
+ const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
266
384
 
267
385
  const dbNotes = await noteService.getNotes(this.contractAddress, owner, storageSlot, status, this.scopes);
268
386
  return pickNotes<NoteData>(dbNotes, {
@@ -285,26 +403,32 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
285
403
  * @param innerNullifier - The inner nullifier.
286
404
  * @returns A boolean indicating whether the nullifier exists in the tree or not.
287
405
  */
288
- public async utilityCheckNullifierExists(innerNullifier: Fr) {
289
- const nullifier = await siloNullifier(this.contractAddress, innerNullifier!);
290
- const [leafIndex] = await this.aztecNode.findLeavesIndexes('latest', MerkleTreeId.NULLIFIER_TREE, [nullifier]);
406
+ public async doesNullifierExist(innerNullifier: Fr) {
407
+ const [nullifier, anchorBlockHash] = await Promise.all([
408
+ siloNullifier(this.contractAddress, innerNullifier!),
409
+ this.anchorBlockHeader.hash(),
410
+ ]);
411
+ const [leafIndex] = await this.aztecNode.findLeavesIndexes(anchorBlockHash, MerkleTreeId.NULLIFIER_TREE, [
412
+ nullifier,
413
+ ]);
291
414
  return leafIndex?.data !== undefined;
292
415
  }
293
416
 
294
417
  /**
295
- * Fetches a message from the executionStore, given its key.
418
+ * Returns the membership witness of an un-nullified L1 to L2 message.
296
419
  * @param contractAddress - Address of a contract by which the message was emitted.
297
420
  * @param messageHash - Hash of the message.
298
421
  * @param secret - Secret used to compute a nullifier.
299
422
  * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
300
423
  * @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
301
424
  */
302
- public async utilityGetL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) {
425
+ public async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) {
303
426
  const [messageIndex, siblingPath] = await getNonNullifiedL1ToL2MessageWitness(
304
427
  this.aztecNode,
305
428
  contractAddress,
306
429
  messageHash,
307
430
  secret,
431
+ await this.anchorBlockHeader.hash(),
308
432
  );
309
433
 
310
434
  return new MessageLoadOracleInputs(messageIndex, siblingPath);
@@ -317,92 +441,194 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
317
441
  * @param startStorageSlot - The starting storage slot.
318
442
  * @param numberOfElements - Number of elements to read from the starting storage slot.
319
443
  */
320
- public async utilityStorageRead(
321
- blockHash: L2BlockHash,
444
+ public getFromPublicStorage(
445
+ blockHash: BlockHash,
322
446
  contractAddress: AztecAddress,
323
447
  startStorageSlot: Fr,
324
448
  numberOfElements: number,
325
449
  ) {
326
- const slots = Array(numberOfElements)
327
- .fill(0)
328
- .map((_, i) => new Fr(startStorageSlot.value + BigInt(i)));
450
+ return this.#queryWithBlockHashNotAfterAnchor(blockHash, async () => {
451
+ const slots = Array(numberOfElements)
452
+ .fill(0)
453
+ .map((_, i) => new Fr(startStorageSlot.value + BigInt(i)));
329
454
 
330
- const values = await Promise.all(
331
- slots.map(storageSlot => this.aztecNode.getPublicStorageAt(blockHash, contractAddress, storageSlot)),
332
- );
455
+ const values = await Promise.all(
456
+ slots.map(storageSlot => this.aztecNode.getPublicStorageAt(blockHash, contractAddress, storageSlot)),
457
+ );
333
458
 
334
- this.log.debug(
335
- `Oracle storage read: slots=[${slots.map(slot => slot.toString()).join(', ')}] address=${contractAddress.toString()} values=[${values.join(', ')}]`,
336
- );
459
+ this.logger.debug(
460
+ `Oracle storage read: slots=[${slots.map(slot => slot.toString()).join(', ')}] address=${contractAddress.toString()} values=[${values.join(', ')}]`,
461
+ );
462
+
463
+ return values;
464
+ });
465
+ }
337
466
 
338
- return values;
467
+ /**
468
+ * Returns a per-contract logger whose output is prefixed with `contract:<name>(<addrAbbrev>)`.
469
+ */
470
+ async #getContractLogger(): Promise<Logger> {
471
+ if (!this.contractLogger) {
472
+ // Purpose of instanceId is to distinguish logs from different instances of the same component. It makes sense
473
+ // to re-use jobId as instanceId here as executions of different PXE jobs are isolated.
474
+ this.contractLogger = await createContractLogger(
475
+ this.contractAddress,
476
+ addr => this.contractStore.getDebugContractName(addr),
477
+ 'user',
478
+ { instanceId: this.jobId },
479
+ );
480
+ }
481
+ return this.contractLogger;
339
482
  }
340
483
 
341
- public utilityDebugLog(level: number, message: string, fields: Fr[]): void {
484
+ /**
485
+ * Returns a per-contract logger whose output is prefixed with `aztecnr:<name>(<addrAbbrev>)`.
486
+ */
487
+ async #getAztecnrLogger(): Promise<Logger> {
488
+ if (!this.aztecnrLogger) {
489
+ // Purpose of instanceId is to distinguish logs from different instances of the same component. It makes sense
490
+ // to re-use jobId as instanceId here as executions of different PXE jobs are isolated.
491
+ this.aztecnrLogger = await createContractLogger(
492
+ this.contractAddress,
493
+ addr => this.contractStore.getDebugContractName(addr),
494
+ 'aztecnr',
495
+ { instanceId: this.jobId },
496
+ );
497
+ }
498
+ return this.aztecnrLogger;
499
+ }
500
+
501
+ public async log(level: number, message: string, fields: Fr[]): Promise<void> {
342
502
  if (!LogLevels[level]) {
343
- throw new Error(`Invalid debug log level: ${level}`);
503
+ throw new Error(`Invalid log level: ${level}`);
344
504
  }
345
- const levelName = LogLevels[level];
346
- this.aztecNrDebugLog[levelName](`${applyStringFormatting(message, fields)}`);
505
+
506
+ const { kind, message: strippedMessage } = stripAztecnrLogPrefix(message);
507
+
508
+ const logger = kind == 'aztecnr' ? await this.#getAztecnrLogger() : await this.#getContractLogger();
509
+ logContractMessage(logger, LogLevels[level], strippedMessage, fields);
510
+ }
511
+
512
+ // Deprecated, only kept for backwards compatibility until Alpha v5 rolls out.
513
+ public async getPendingTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr, scope: AztecAddress) {
514
+ const logService = this.#createLogService();
515
+ const logs = await logService.fetchTaggedLogs(this.contractAddress, scope);
516
+ await this.capsuleService.appendToCapsuleArray(
517
+ this.contractAddress,
518
+ pendingTaggedLogArrayBaseSlot,
519
+ logs.map(log => log.toFields()),
520
+ this.jobId,
521
+ scope,
522
+ );
523
+ }
524
+
525
+ /** Fetches pending tagged logs into a freshly allocated ephemeral array and returns its base slot. */
526
+ public async getPendingTaggedLogsV2(scope: AztecAddress): Promise<Fr> {
527
+ const logService = this.#createLogService();
528
+ const logs = await logService.fetchTaggedLogs(this.contractAddress, scope);
529
+ return this.ephemeralArrayService.newArray(logs.map(log => log.toFields()));
347
530
  }
348
531
 
349
- public async utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr) {
350
- const logService = new LogService(
532
+ #createLogService(): LogService {
533
+ return new LogService(
351
534
  this.aztecNode,
352
- this.anchorBlockStore,
535
+ this.anchorBlockHeader,
536
+ this.l2TipsStore,
353
537
  this.keyStore,
354
- this.capsuleStore,
355
538
  this.recipientTaggingStore,
356
539
  this.senderAddressBookStore,
357
540
  this.addressStore,
358
541
  this.jobId,
542
+ this.logger.getBindings(),
359
543
  );
360
-
361
- const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore, this.jobId);
362
-
363
- // It is acceptable to run the following operations in parallel for several reasons:
364
- // 1. syncTaggedLogs does not write to the note store — it only stores the pending tagged logs in a capsule array,
365
- // which is then processed in Noir after this handler returns.
366
- // 2. Even if syncTaggedLogs did write to the note store, it would not cause inconsistent state.
367
- await Promise.all([
368
- logService.syncTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes),
369
- noteService.syncNoteNullifiers(this.contractAddress),
370
- ]);
371
544
  }
372
545
 
373
546
  /**
374
- * Validates all note and event validation requests enqueued via `enqueue_note_for_validation` and
375
- * `enqueue_event_for_validation`, inserting them into the note database and event store respectively, making them
376
- * queryable via `get_notes` and `getPrivateEvents`.
547
+ * Legacy: validates note/event requests stored in capsule arrays.
377
548
  *
378
- * This automatically clears both validation request queues, so no further work needs to be done by the caller.
379
- * @param contractAddress - The address of the contract that the logs are tagged for.
380
- * @param noteValidationRequestsArrayBaseSlot - The base slot of capsule array containing note validation requests.
381
- * @param eventValidationRequestsArrayBaseSlot - The base slot of capsule array containing event validation requests.
549
+ * Deprecated, only kept for backwards compatibility until Alpha v5 rolls out.
382
550
  */
383
- public async utilityValidateEnqueuedNotesAndEvents(
551
+ public async validateAndStoreEnqueuedNotesAndEvents(
384
552
  contractAddress: AztecAddress,
385
553
  noteValidationRequestsArrayBaseSlot: Fr,
386
554
  eventValidationRequestsArrayBaseSlot: Fr,
555
+ maxNotePackedLen: number,
556
+ maxEventSerializedLen: number,
557
+ scope: AztecAddress,
387
558
  ) {
388
559
  // TODO(#10727): allow other contracts to store notes
389
560
  if (!this.contractAddress.equals(contractAddress)) {
390
561
  throw new Error(`Got a note validation request from ${contractAddress}, expected ${this.contractAddress}`);
391
562
  }
392
563
 
393
- // We read all note and event validation requests and process them all concurrently. This makes the process much
394
- // faster as we don't need to wait for the network round-trip.
395
564
  const noteValidationRequests = (
396
- await this.capsuleStore.readCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot, this.jobId)
397
- ).map(NoteValidationRequest.fromFields);
565
+ await this.capsuleService.readCapsuleArray(
566
+ contractAddress,
567
+ noteValidationRequestsArrayBaseSlot,
568
+ this.jobId,
569
+ scope,
570
+ )
571
+ ).map(fields => NoteValidationRequest.fromFields(fields, maxNotePackedLen));
398
572
 
399
573
  const eventValidationRequests = (
400
- await this.capsuleStore.readCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot, this.jobId)
401
- ).map(EventValidationRequest.fromFields);
574
+ await this.capsuleService.readCapsuleArray(
575
+ contractAddress,
576
+ eventValidationRequestsArrayBaseSlot,
577
+ this.jobId,
578
+ scope,
579
+ )
580
+ ).map(fields => EventValidationRequest.fromFields(fields, maxEventSerializedLen));
581
+
582
+ await this.#processValidationRequests(noteValidationRequests, eventValidationRequests, scope);
402
583
 
403
- const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore, this.jobId);
584
+ await this.capsuleService.setCapsuleArray(
585
+ contractAddress,
586
+ noteValidationRequestsArrayBaseSlot,
587
+ [],
588
+ this.jobId,
589
+ scope,
590
+ );
591
+ await this.capsuleService.setCapsuleArray(
592
+ contractAddress,
593
+ eventValidationRequestsArrayBaseSlot,
594
+ [],
595
+ this.jobId,
596
+ scope,
597
+ );
598
+ }
599
+
600
+ public async validateAndStoreEnqueuedNotesAndEventsV2(
601
+ noteValidationRequestsArrayBaseSlot: Fr,
602
+ eventValidationRequestsArrayBaseSlot: Fr,
603
+ maxNotePackedLen: number,
604
+ maxEventSerializedLen: number,
605
+ scope: AztecAddress,
606
+ ) {
607
+ const noteValidationRequests = this.ephemeralArrayService
608
+ .readArrayAt(noteValidationRequestsArrayBaseSlot)
609
+ .map(fields => NoteValidationRequest.fromFields(fields, maxNotePackedLen));
610
+
611
+ const eventValidationRequests = this.ephemeralArrayService
612
+ .readArrayAt(eventValidationRequestsArrayBaseSlot)
613
+ .map(fields => EventValidationRequest.fromFields(fields, maxEventSerializedLen));
614
+
615
+ await this.#processValidationRequests(noteValidationRequests, eventValidationRequests, scope);
616
+ }
617
+
618
+ /**
619
+ * Dispatches note and event validation requests to the service layer.
620
+ *
621
+ * This function is an auxiliary to support legacy (capsule backed) and new (ephemeral array backed) versions of the
622
+ * `validateAndStoreEnqueuedNotesAndEvents` oracle.
623
+ */
624
+ async #processValidationRequests(
625
+ noteValidationRequests: NoteValidationRequest[],
626
+ eventValidationRequests: EventValidationRequest[],
627
+ scope: AztecAddress,
628
+ ) {
629
+ const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockHeader, this.jobId);
404
630
  const noteStorePromises = noteValidationRequests.map(request =>
405
- noteService.storeNote(
631
+ noteService.validateAndStoreNote(
406
632
  request.contractAddress,
407
633
  request.owner,
408
634
  request.storageSlot,
@@ -412,34 +638,31 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
412
638
  request.noteHash,
413
639
  request.nullifier,
414
640
  request.txHash,
415
- request.recipient,
641
+ scope,
416
642
  ),
417
643
  );
418
644
 
419
- const eventService = new EventService(this.anchorBlockStore, this.aztecNode, this.privateEventStore, this.jobId);
645
+ const eventService = new EventService(this.anchorBlockHeader, this.aztecNode, this.privateEventStore, this.jobId);
420
646
  const eventStorePromises = eventValidationRequests.map(request =>
421
- eventService.storeEvent(
647
+ eventService.validateAndStoreEvent(
422
648
  request.contractAddress,
423
649
  request.eventTypeId,
424
650
  request.randomness,
425
651
  request.serializedEvent,
426
652
  request.eventCommitment,
427
653
  request.txHash,
428
- request.recipient,
654
+ scope,
429
655
  ),
430
656
  );
431
657
 
432
658
  await Promise.all([...noteStorePromises, ...eventStorePromises]);
433
-
434
- // Requests are cleared once we're done.
435
- await this.capsuleStore.setCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot, [], this.jobId);
436
- await this.capsuleStore.setCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot, [], this.jobId);
437
659
  }
438
660
 
439
- public async utilityBulkRetrieveLogs(
661
+ public async getLogsByTag(
440
662
  contractAddress: AztecAddress,
441
663
  logRetrievalRequestsArrayBaseSlot: Fr,
442
664
  logRetrievalResponsesArrayBaseSlot: Fr,
665
+ scope: AztecAddress,
443
666
  ) {
444
667
  // TODO(#10727): allow other contracts to process partial notes
445
668
  if (!this.contractAddress.equals(contractAddress)) {
@@ -449,100 +672,250 @@ export class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOra
449
672
  // We read all log retrieval requests and process them all concurrently. This makes the process much faster as we
450
673
  // don't need to wait for the network round-trip.
451
674
  const logRetrievalRequests = (
452
- await this.capsuleStore.readCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, this.jobId)
675
+ await this.capsuleService.readCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, this.jobId, scope)
453
676
  ).map(LogRetrievalRequest.fromFields);
454
677
 
455
- const logService = new LogService(
456
- this.aztecNode,
457
- this.anchorBlockStore,
458
- this.keyStore,
459
- this.capsuleStore,
460
- this.recipientTaggingStore,
461
- this.senderAddressBookStore,
462
- this.addressStore,
463
- this.jobId,
464
- );
465
-
466
- const maybeLogRetrievalResponses = await logService.bulkRetrieveLogs(logRetrievalRequests);
678
+ const logService = this.#createLogService();
679
+ const maybeLogRetrievalResponses = await logService.fetchLogsByTag(contractAddress, logRetrievalRequests);
467
680
 
468
681
  // Requests are cleared once we're done.
469
- await this.capsuleStore.setCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, [], this.jobId);
682
+ await this.capsuleService.setCapsuleArray(
683
+ contractAddress,
684
+ logRetrievalRequestsArrayBaseSlot,
685
+ [],
686
+ this.jobId,
687
+ scope,
688
+ );
470
689
 
471
690
  // The responses are stored as Option<LogRetrievalResponse> in a second CapsuleArray.
472
- await this.capsuleStore.setCapsuleArray(
691
+ await this.capsuleService.setCapsuleArray(
473
692
  contractAddress,
474
693
  logRetrievalResponsesArrayBaseSlot,
475
694
  maybeLogRetrievalResponses.map(LogRetrievalResponse.toSerializedOption),
476
695
  this.jobId,
696
+ scope,
697
+ );
698
+ }
699
+
700
+ public async getLogsByTagV2(requestArrayBaseSlot: Fr): Promise<Fr> {
701
+ const logRetrievalRequests = this.ephemeralArrayService
702
+ .readArrayAt(requestArrayBaseSlot)
703
+ .map(LogRetrievalRequest.fromFields);
704
+ const logService = this.#createLogService();
705
+
706
+ const maybeLogRetrievalResponses = await logService.fetchLogsByTag(this.contractAddress, logRetrievalRequests);
707
+
708
+ return this.ephemeralArrayService.newArray(maybeLogRetrievalResponses.map(LogRetrievalResponse.toSerializedOption));
709
+ }
710
+
711
+ // Deprecated, only kept for backwards compatibility until Alpha v5 rolls out.
712
+ public async getMessageContextsByTxHash(
713
+ contractAddress: AztecAddress,
714
+ messageContextRequestsArrayBaseSlot: Fr,
715
+ messageContextResponsesArrayBaseSlot: Fr,
716
+ scope: AztecAddress,
717
+ ) {
718
+ try {
719
+ if (!this.contractAddress.equals(contractAddress)) {
720
+ throw new Error(`Got a message context request from ${contractAddress}, expected ${this.contractAddress}`);
721
+ }
722
+
723
+ // TODO(@mverzilli): this is a prime example of where using an ephemeral array would make much more sense, we don't
724
+ // need scopes here, we just need a bit of shared memory to cross boundaries between Noir and TS.
725
+ // At the same time, we don't want to allow any global scope access other than where backwards compatibility
726
+ // forces us to. Hence we need the scope here to be artificial.
727
+ const requestCapsules = await this.capsuleService.readCapsuleArray(
728
+ contractAddress,
729
+ messageContextRequestsArrayBaseSlot,
730
+ this.jobId,
731
+ scope,
732
+ );
733
+
734
+ const txHashes = requestCapsules.map((fields, i) => {
735
+ if (fields.length !== 1) {
736
+ throw new Error(
737
+ `Malformed message context request at index ${i}: expected 1 field (tx hash), got ${fields.length}`,
738
+ );
739
+ }
740
+ return fields[0];
741
+ });
742
+
743
+ const maybeMessageContexts = await this.messageContextService.getMessageContextsByTxHash(
744
+ txHashes,
745
+ this.anchorBlockHeader.getBlockNumber(),
746
+ );
747
+
748
+ // Leave response in response capsule array.
749
+ await this.capsuleService.setCapsuleArray(
750
+ contractAddress,
751
+ messageContextResponsesArrayBaseSlot,
752
+ maybeMessageContexts.map(MessageContext.toSerializedOption),
753
+ this.jobId,
754
+ scope,
755
+ );
756
+ } finally {
757
+ await this.capsuleService.setCapsuleArray(
758
+ contractAddress,
759
+ messageContextRequestsArrayBaseSlot,
760
+ [],
761
+ this.jobId,
762
+ scope,
763
+ );
764
+ }
765
+ }
766
+
767
+ /** Reads tx hash requests from an ephemeral array, resolves their contexts, and returns the response slot. */
768
+ public async getMessageContextsByTxHashV2(requestArrayBaseSlot: Fr): Promise<Fr> {
769
+ const requestFields = this.ephemeralArrayService.readArrayAt(requestArrayBaseSlot);
770
+
771
+ const txHashes = requestFields.map((fields, i) => {
772
+ if (fields.length !== 1) {
773
+ throw new Error(
774
+ `Malformed message context request at index ${i}: expected 1 field (tx hash), got ${fields.length}`,
775
+ );
776
+ }
777
+ return fields[0];
778
+ });
779
+
780
+ const maybeMessageContexts = await this.messageContextService.getMessageContextsByTxHash(
781
+ txHashes,
782
+ this.anchorBlockHeader.getBlockNumber(),
477
783
  );
784
+
785
+ return this.ephemeralArrayService.newArray(maybeMessageContexts.map(MessageContext.toSerializedOption));
478
786
  }
479
787
 
480
- public utilityStoreCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void> {
788
+ public setCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[], scope: AztecAddress): void {
481
789
  if (!contractAddress.equals(this.contractAddress)) {
482
790
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
483
791
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
484
792
  }
485
- this.capsuleStore.storeCapsule(this.contractAddress, slot, capsule, this.jobId);
486
- return Promise.resolve();
793
+ this.capsuleService.setCapsule(contractAddress, slot, capsule, this.jobId, scope);
487
794
  }
488
795
 
489
- public async utilityLoadCapsule(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null> {
796
+ public getCapsule(contractAddress: AztecAddress, slot: Fr, scope: AztecAddress): Promise<Fr[] | null> {
490
797
  if (!contractAddress.equals(this.contractAddress)) {
491
798
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
492
799
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
493
800
  }
494
- return (
495
- // TODO(#12425): On the following line, the pertinent capsule gets overshadowed by the transient one. Tackle this.
496
- this.capsules.find(c => c.contractAddress.equals(contractAddress) && c.storageSlot.equals(slot))?.data ??
497
- (await this.capsuleStore.loadCapsule(this.contractAddress, slot, this.jobId))
498
- );
801
+ return this.capsuleService.getCapsule(contractAddress, slot, this.jobId, scope, this.capsules);
499
802
  }
500
803
 
501
- public utilityDeleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void> {
804
+ public deleteCapsule(contractAddress: AztecAddress, slot: Fr, scope: AztecAddress): void {
502
805
  if (!contractAddress.equals(this.contractAddress)) {
503
806
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
504
807
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
505
808
  }
506
- this.capsuleStore.deleteCapsule(this.contractAddress, slot, this.jobId);
507
- return Promise.resolve();
809
+ this.capsuleService.deleteCapsule(contractAddress, slot, this.jobId, scope);
508
810
  }
509
811
 
510
- public utilityCopyCapsule(
812
+ public copyCapsule(
511
813
  contractAddress: AztecAddress,
512
814
  srcSlot: Fr,
513
815
  dstSlot: Fr,
514
816
  numEntries: number,
817
+ scope: AztecAddress,
515
818
  ): Promise<void> {
516
819
  if (!contractAddress.equals(this.contractAddress)) {
517
820
  // TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
518
821
  throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
519
822
  }
520
- return this.capsuleStore.copyCapsule(this.contractAddress, srcSlot, dstSlot, numEntries, this.jobId);
823
+ return this.capsuleService.copyCapsule(contractAddress, srcSlot, dstSlot, numEntries, this.jobId, scope);
824
+ }
825
+
826
+ /**
827
+ * Clears cached sync state for a contract for a set of scopes, forcing re-sync on the next query so that newly
828
+ * stored notes or events are discovered.
829
+ */
830
+ public setContractSyncCacheInvalid(contractAddress: AztecAddress, scopes: AztecAddress[]): void {
831
+ if (!contractAddress.equals(this.contractAddress)) {
832
+ throw new Error(`Contract ${this.contractAddress} cannot invalidate sync cache of ${contractAddress}`);
833
+ }
834
+ this.contractSyncService.invalidateContractForScopes(contractAddress, scopes);
521
835
  }
522
836
 
523
837
  // TODO(#11849): consider replacing this oracle with a pure Noir implementation of aes decryption.
524
- public utilityAes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer> {
838
+ public decryptAes128(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer> {
525
839
  const aes128 = new Aes128();
526
840
  return aes128.decryptBufferCBC(ciphertext, iv, symKey);
527
841
  }
528
842
 
529
843
  /**
530
- * Retrieves the shared secret for a given address and ephemeral public key.
844
+ * Retrieves the app-siloed shared secret for a given address and ephemeral public key.
531
845
  * @param address - The address to get the secret for.
532
846
  * @param ephPk - The ephemeral public key to get the secret for.
533
- * @returns The secret for the given address.
847
+ * @param contractAddress - The contract address for app-siloing (validated against execution context).
848
+ * @returns The app-siloed shared secret as a Field.
534
849
  */
535
- public utilityGetSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
536
- return this.getSharedSecret(address, ephPk);
537
- }
538
-
539
- protected async getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point> {
540
- // TODO(#12656): return an app-siloed secret
541
- const recipientCompleteAddress = await this.getCompleteAddress(address);
850
+ public async getSharedSecret(address: AztecAddress, ephPk: Point, contractAddress: AztecAddress): Promise<Fr> {
851
+ if (!contractAddress.equals(this.contractAddress)) {
852
+ throw new Error(
853
+ `getSharedSecret called with contract address ${contractAddress}, expected ${this.contractAddress}`,
854
+ );
855
+ }
856
+ const recipientCompleteAddress = await this.getCompleteAddressOrFail(address);
542
857
  const ivskM = await this.keyStore.getMasterSecretKey(
543
858
  recipientCompleteAddress.publicKeys.masterIncomingViewingPublicKey,
544
859
  );
545
860
  const addressSecret = await computeAddressSecret(await recipientCompleteAddress.getPreaddress(), ivskM);
546
- return deriveEcdhSharedSecret(addressSecret, ephPk);
861
+ return deriveAppSiloedSharedSecret(addressSecret, ephPk, this.contractAddress);
862
+ }
863
+
864
+ public pushEphemeral(slot: Fr, elements: Fr[]): number {
865
+ return this.ephemeralArrayService.push(slot, elements);
866
+ }
867
+
868
+ public popEphemeral(slot: Fr): Fr[] {
869
+ return this.ephemeralArrayService.pop(slot);
870
+ }
871
+
872
+ public getEphemeral(slot: Fr, index: number): Fr[] {
873
+ return this.ephemeralArrayService.get(slot, index);
874
+ }
875
+
876
+ public setEphemeral(slot: Fr, index: number, elements: Fr[]): void {
877
+ this.ephemeralArrayService.set(slot, index, elements);
878
+ }
879
+
880
+ public getEphemeralLen(slot: Fr): number {
881
+ return this.ephemeralArrayService.len(slot);
882
+ }
883
+
884
+ public removeEphemeral(slot: Fr, index: number): void {
885
+ this.ephemeralArrayService.remove(slot, index);
886
+ }
887
+
888
+ public clearEphemeral(slot: Fr): void {
889
+ this.ephemeralArrayService.clear(slot);
890
+ }
891
+
892
+ public emitOffchainEffect(data: Fr[]): Promise<void> {
893
+ this.offchainEffects.push({ data, contractAddress: this.contractAddress });
894
+ return Promise.resolve();
895
+ }
896
+
897
+ /** Returns offchain effects collected during execution. */
898
+ public getOffchainEffects(): OffchainEffect[] {
899
+ return this.offchainEffects;
900
+ }
901
+
902
+ /** Runs a query concurrently with a validation that the block hash is not ahead of the anchor block. */
903
+ async #queryWithBlockHashNotAfterAnchor<T>(blockHash: BlockHash, query: () => Promise<T>): Promise<T> {
904
+ const [response] = await Promise.all([
905
+ query(),
906
+ (async () => {
907
+ const header = await this.aztecNode.getBlockHeader(blockHash);
908
+ if (!header) {
909
+ throw new Error(`Could not find block header for block hash ${blockHash}`);
910
+ }
911
+
912
+ if (header.getBlockNumber() > this.anchorBlockHeader.getBlockNumber()) {
913
+ throw new Error(
914
+ `Made a node query with a reference block hash ${blockHash} with block number ${header.getBlockNumber()}, which is ahead of the anchor block number ${this.anchorBlockHeader.getBlockNumber()} (from anchor block hash ${await this.anchorBlockHeader.hash()}).`,
915
+ );
916
+ }
917
+ })(),
918
+ ]);
919
+ return response;
547
920
  }
548
921
  }