@aztec/pxe 0.0.1-commit.e6bd8901 → 0.0.1-commit.ec7ac5448

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 (257) hide show
  1. package/dest/bin/check_oracle_version.js +4 -4
  2. package/dest/block_synchronizer/block_synchronizer.d.ts +5 -3
  3. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  4. package/dest/block_synchronizer/block_synchronizer.js +17 -5
  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 +1 -1
  8. package/dest/config/package_info.js +1 -1
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts +60 -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 +201 -74
  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 +4 -6
  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 +8 -10
  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 +4 -7
  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 +6 -11
  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.js +5 -3
  41. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +53 -79
  42. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  43. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +109 -89
  44. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +124 -67
  45. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  46. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +326 -140
  47. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  48. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  49. package/dest/contract_function_simulator/pick_notes.js +9 -2
  50. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
  51. package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
  52. package/dest/contract_function_simulator/proxied_contract_data_source.js +3 -0
  53. package/dest/contract_logging.d.ts +27 -0
  54. package/dest/contract_logging.d.ts.map +1 -0
  55. package/dest/contract_logging.js +38 -0
  56. package/dest/contract_sync/contract_sync_service.d.ts +44 -0
  57. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  58. package/dest/contract_sync/contract_sync_service.js +104 -0
  59. package/dest/contract_sync/helpers.d.ts +28 -0
  60. package/dest/contract_sync/helpers.d.ts.map +1 -0
  61. package/dest/contract_sync/{index.js → helpers.js} +20 -16
  62. package/dest/debug/pxe_debug_utils.d.ts +24 -10
  63. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  64. package/dest/debug/pxe_debug_utils.js +28 -18
  65. package/dest/entrypoints/client/bundle/index.d.ts +3 -1
  66. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  67. package/dest/entrypoints/client/bundle/index.js +2 -0
  68. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  69. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  70. package/dest/entrypoints/client/bundle/utils.js +23 -9
  71. package/dest/entrypoints/client/lazy/index.d.ts +3 -1
  72. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  73. package/dest/entrypoints/client/lazy/index.js +2 -0
  74. package/dest/entrypoints/client/lazy/utils.d.ts +3 -3
  75. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  76. package/dest/entrypoints/client/lazy/utils.js +24 -10
  77. package/dest/entrypoints/pxe_creation_options.d.ts +5 -2
  78. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  79. package/dest/entrypoints/pxe_creation_options.js +3 -1
  80. package/dest/entrypoints/server/index.d.ts +4 -3
  81. package/dest/entrypoints/server/index.d.ts.map +1 -1
  82. package/dest/entrypoints/server/index.js +3 -2
  83. package/dest/entrypoints/server/utils.d.ts +2 -2
  84. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  85. package/dest/entrypoints/server/utils.js +30 -11
  86. package/dest/events/event_service.d.ts +5 -5
  87. package/dest/events/event_service.d.ts.map +1 -1
  88. package/dest/events/event_service.js +20 -9
  89. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  90. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  91. package/dest/job_coordinator/job_coordinator.js +3 -2
  92. package/dest/logs/log_service.d.ts +8 -9
  93. package/dest/logs/log_service.d.ts.map +1 -1
  94. package/dest/logs/log_service.js +38 -62
  95. package/dest/messages/message_context_service.d.ts +17 -0
  96. package/dest/messages/message_context_service.d.ts.map +1 -0
  97. package/dest/messages/message_context_service.js +36 -0
  98. package/dest/notes/note_service.d.ts +7 -8
  99. package/dest/notes/note_service.d.ts.map +1 -1
  100. package/dest/notes/note_service.js +23 -15
  101. package/dest/notes_filter.d.ts +24 -0
  102. package/dest/notes_filter.d.ts.map +1 -0
  103. package/dest/notes_filter.js +4 -0
  104. package/dest/oracle_version.d.ts +4 -3
  105. package/dest/oracle_version.d.ts.map +1 -1
  106. package/dest/oracle_version.js +20 -10
  107. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  108. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  109. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  110. package/dest/private_kernel/hints/index.d.ts +1 -1
  111. package/dest/private_kernel/hints/index.js +1 -1
  112. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  113. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  114. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  115. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  116. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  117. package/dest/private_kernel/hints/test_utils.js +203 -0
  118. package/dest/private_kernel/private_kernel_execution_prover.d.ts +3 -2
  119. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  120. package/dest/private_kernel/private_kernel_execution_prover.js +21 -13
  121. package/dest/private_kernel/private_kernel_oracle.d.ts +8 -4
  122. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  123. package/dest/private_kernel/private_kernel_oracle.js +7 -3
  124. package/dest/pxe.d.ts +73 -24
  125. package/dest/pxe.d.ts.map +1 -1
  126. package/dest/pxe.js +131 -78
  127. package/dest/storage/address_store/address_store.d.ts +1 -1
  128. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  129. package/dest/storage/address_store/address_store.js +12 -11
  130. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  131. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  132. package/dest/storage/anchor_block_store/anchor_block_store.js +8 -1
  133. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  134. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  135. package/dest/storage/capsule_store/capsule_service.js +50 -0
  136. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  137. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  138. package/dest/storage/capsule_store/capsule_store.js +39 -36
  139. package/dest/storage/capsule_store/index.d.ts +2 -1
  140. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  141. package/dest/storage/capsule_store/index.js +1 -0
  142. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  143. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  144. package/dest/storage/contract_store/contract_store.js +157 -72
  145. package/dest/storage/metadata.d.ts +1 -1
  146. package/dest/storage/metadata.js +1 -1
  147. package/dest/storage/note_store/note_store.d.ts +13 -3
  148. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  149. package/dest/storage/note_store/note_store.js +147 -107
  150. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  151. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  152. package/dest/storage/private_event_store/private_event_store.js +84 -61
  153. package/dest/storage/private_event_store/stored_private_event.d.ts +4 -4
  154. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -1
  155. package/dest/storage/private_event_store/stored_private_event.js +2 -2
  156. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  157. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  158. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  159. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  160. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  161. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  162. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  163. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  164. package/dest/storage/tagging_store/sender_tagging_store.js +233 -137
  165. package/dest/tagging/get_all_logs_by_tags.d.ts +4 -4
  166. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  167. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  168. package/dest/tagging/index.d.ts +3 -3
  169. package/dest/tagging/index.d.ts.map +1 -1
  170. package/dest/tagging/index.js +1 -1
  171. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +5 -6
  172. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  173. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +7 -7
  174. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  175. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +7 -8
  176. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  177. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  178. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +5 -9
  179. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  180. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  181. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  182. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  183. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  184. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +6 -8
  185. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  186. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  187. package/package.json +25 -16
  188. package/src/bin/check_oracle_version.ts +4 -4
  189. package/src/block_synchronizer/block_synchronizer.ts +29 -19
  190. package/src/config/index.ts +1 -1
  191. package/src/config/package_info.ts +1 -1
  192. package/src/contract_function_simulator/contract_function_simulator.ts +360 -133
  193. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  194. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  195. package/src/contract_function_simulator/index.ts +1 -0
  196. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -9
  197. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +1 -1
  198. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  199. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -10
  200. package/src/contract_function_simulator/oracle/interfaces.ts +90 -62
  201. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +104 -0
  202. package/src/contract_function_simulator/oracle/oracle.ts +391 -150
  203. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  204. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +136 -187
  205. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +544 -174
  206. package/src/contract_function_simulator/pick_notes.ts +9 -2
  207. package/src/contract_function_simulator/proxied_contract_data_source.ts +8 -1
  208. package/src/contract_logging.ts +52 -0
  209. package/src/contract_sync/contract_sync_service.ts +170 -0
  210. package/src/contract_sync/{index.ts → helpers.ts} +23 -25
  211. package/src/debug/pxe_debug_utils.ts +63 -19
  212. package/src/entrypoints/client/bundle/index.ts +2 -0
  213. package/src/entrypoints/client/bundle/utils.ts +18 -18
  214. package/src/entrypoints/client/lazy/index.ts +2 -0
  215. package/src/entrypoints/client/lazy/utils.ts +19 -18
  216. package/src/entrypoints/pxe_creation_options.ts +9 -1
  217. package/src/entrypoints/server/index.ts +3 -2
  218. package/src/entrypoints/server/utils.ts +24 -29
  219. package/src/events/event_service.ts +21 -10
  220. package/src/job_coordinator/job_coordinator.ts +4 -3
  221. package/src/logs/log_service.ts +72 -106
  222. package/src/messages/message_context_service.ts +44 -0
  223. package/src/notes/note_service.ts +24 -16
  224. package/src/notes_filter.ts +24 -0
  225. package/src/oracle_version.ts +20 -10
  226. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  227. package/src/private_kernel/hints/index.ts +1 -1
  228. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  229. package/src/private_kernel/hints/test_utils.ts +325 -0
  230. package/src/private_kernel/private_kernel_execution_prover.ts +25 -15
  231. package/src/private_kernel/private_kernel_oracle.ts +9 -9
  232. package/src/pxe.ts +243 -131
  233. package/src/storage/address_store/address_store.ts +15 -15
  234. package/src/storage/anchor_block_store/anchor_block_store.ts +8 -0
  235. package/src/storage/capsule_store/capsule_service.ts +90 -0
  236. package/src/storage/capsule_store/capsule_store.ts +42 -34
  237. package/src/storage/capsule_store/index.ts +1 -0
  238. package/src/storage/contract_store/contract_store.ts +186 -76
  239. package/src/storage/metadata.ts +1 -1
  240. package/src/storage/note_store/note_store.ts +166 -132
  241. package/src/storage/private_event_store/private_event_store.ts +102 -81
  242. package/src/storage/private_event_store/stored_private_event.ts +3 -3
  243. package/src/storage/tagging_store/recipient_tagging_store.ts +38 -24
  244. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  245. package/src/storage/tagging_store/sender_tagging_store.ts +287 -156
  246. package/src/tagging/get_all_logs_by_tags.ts +31 -7
  247. package/src/tagging/index.ts +2 -2
  248. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +9 -12
  249. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  250. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +12 -17
  251. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +25 -12
  252. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  253. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +30 -29
  254. package/dest/contract_sync/index.d.ts +0 -23
  255. package/dest/contract_sync/index.d.ts.map +0 -1
  256. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  257. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -1,11 +1,13 @@
1
- import { toArray } from '@aztec/foundation/iterable';
2
1
  import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
3
- import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
4
- import { TxHash } from '@aztec/stdlib/tx';
2
+ import { ExtendedDirectionalAppTaggingSecret, SiloedTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
3
+ import { TxEffect, TxHash } from '@aztec/stdlib/tx';
5
4
 
6
5
  import type { StagedStore } from '../../job_coordinator/job_coordinator.js';
7
6
  import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../../tagging/constants.js';
8
7
 
8
+ /** Internal representation of a pending index range entry. */
9
+ type PendingIndexesEntry = { lowestIndex: number; highestIndex: number; txHash: string };
10
+
9
11
  /**
10
12
  * Data provider of tagging data used when syncing the sender tagging indexes. The recipient counterpart of this class
11
13
  * is called RecipientTaggingStore. We have the data stores separate for sender and recipient because
@@ -16,20 +18,19 @@ export class SenderTaggingStore implements StagedStore {
16
18
 
17
19
  #store: AztecAsyncKVStore;
18
20
 
19
- // Stores the pending indexes for each directional app tagging secret. Pending here means that the tx that contained
20
- // the private logs with tags corresponding to these indexes has not been finalized yet.
21
- //
22
- // We don't store just the highest index because if their transaction is dropped we'd then need the information about
23
- // the lower pending indexes. For each secret-tx pair however we only store the largest index used in that tx, since
24
- // the smaller ones are irrelevant due to tx atomicity.
21
+ // Stores the pending index ranges for each directional app tagging secret. Pending here means that the tx that
22
+ // contained the private logs with tags corresponding to these indexes has not been finalized yet.
25
23
  //
26
- // TODO(#17615): This assumes no logs are used in the non-revertible phase.
24
+ // We store the full range (lowestIndex, highestIndex) for each secret-tx pair because transactions can partially
25
+ // revert, in which case only some logs (from the non-revertible phase) survive onchain. By storing the range,
26
+ // we can expand it and check each individual siloed tag against the TxEffect to determine which indexes made it
27
+ // onchain.
27
28
  //
28
- // directional app tagging secret => { pending index, txHash }[]
29
- #pendingIndexes: AztecAsyncMap<string, { index: number; txHash: string }[]>;
29
+ // directional app tagging secret => { lowestIndex, highestIndex, txHash }[]
30
+ #pendingIndexes: AztecAsyncMap<string, PendingIndexesEntry[]>;
30
31
 
31
- // jobId => directional app tagging secret => { pending index, txHash }[]
32
- #pendingIndexesForJob: Map<string, Map<string, { index: number; txHash: string }[]>>;
32
+ // jobId => directional app tagging secret => { lowestIndex, highestIndex, txHash }[]
33
+ #pendingIndexesForJob: Map<string, Map<string, PendingIndexesEntry[]>>;
33
34
 
34
35
  // Stores the last (highest) finalized index for each directional app tagging secret. We care only about the last
35
36
  // index because unlike the pending indexes, it will never happen that a finalized index would be removed and hence
@@ -51,7 +52,7 @@ export class SenderTaggingStore implements StagedStore {
51
52
  this.#lastFinalizedIndexesForJob = new Map();
52
53
  }
53
54
 
54
- #getPendingIndexesForJob(jobId: string): Map<string, { index: number; txHash: string }[]> {
55
+ #getPendingIndexesForJob(jobId: string): Map<string, PendingIndexesEntry[]> {
55
56
  let pendingIndexesForJob = this.#pendingIndexesForJob.get(jobId);
56
57
  if (!pendingIndexesForJob) {
57
58
  pendingIndexesForJob = new Map();
@@ -69,32 +70,24 @@ export class SenderTaggingStore implements StagedStore {
69
70
  return jobStagedLastFinalizedIndexes;
70
71
  }
71
72
 
72
- async #readPendingIndexes(jobId: string, secret: string): Promise<{ index: number; txHash: string }[]> {
73
- const jobStagedPendingIndexes = this.#getPendingIndexesForJob(jobId);
74
- const pendingIndexes = jobStagedPendingIndexes.get(secret);
75
- // We return the staged version of this if it exists, if not, we read from the DB.
76
- // If the DB also has nothing, we return an empty array [].
77
- return pendingIndexes !== undefined ? pendingIndexes : ((await this.#pendingIndexes.getAsync(secret)) ?? []);
73
+ async #readPendingIndexes(jobId: string, secret: string): Promise<PendingIndexesEntry[]> {
74
+ // Always issue DB read to keep IndexedDB transaction alive (they auto-commit when a new micro-task starts and there
75
+ // are no pending read requests). The staged value still takes precedence if it exists.
76
+ const dbValue = await this.#pendingIndexes.getAsync(secret);
77
+ const staged = this.#getPendingIndexesForJob(jobId).get(secret);
78
+ return staged !== undefined ? staged : (dbValue ?? []);
78
79
  }
79
80
 
80
- #writePendingIndexes(jobId: string, secret: string, pendingIndexes: { index: number; txHash: string }[]) {
81
+ #writePendingIndexes(jobId: string, secret: string, pendingIndexes: PendingIndexesEntry[]) {
81
82
  this.#getPendingIndexesForJob(jobId).set(secret, pendingIndexes);
82
83
  }
83
84
 
84
- /**
85
- * Returns a job view of all the secrets that have a corresponding list of pending indexes either in persistent
86
- * storage or the current job.
87
- */
88
- async #readSecretsWithPendingIndexes(jobId: string): Promise<string[]> {
89
- const storedSecrets = new Set(await toArray(this.#pendingIndexes.keysAsync()));
90
- const stagedSecrets = this.#getPendingIndexesForJob(jobId).keys();
91
- return [...storedSecrets.union(new Set(stagedSecrets))];
92
- }
93
-
94
85
  async #readLastFinalizedIndex(jobId: string, secret: string): Promise<number | undefined> {
95
- return (
96
- this.#getLastFinalizedIndexesForJob(jobId).get(secret) ?? (await this.#lastFinalizedIndexes.getAsync(secret))
97
- );
86
+ // Always issue DB read to keep IndexedDB transaction alive (they auto-commit when a new micro-task starts and there
87
+ // are no pending read requests). The staged value still takes precedence if it exists.
88
+ const dbValue = await this.#lastFinalizedIndexes.getAsync(secret);
89
+ const staged = this.#getLastFinalizedIndexesForJob(jobId).get(secret);
90
+ return staged ?? dbValue;
98
91
  }
99
92
 
100
93
  #writeLastFinalizedIndex(jobId: string, secret: string, lastFinalizedIndex: number) {
@@ -135,98 +128,108 @@ export class SenderTaggingStore implements StagedStore {
135
128
  }
136
129
 
137
130
  /**
138
- * Stores pending indexes.
139
- * @remarks Ignores the index if the same preTag + txHash combination already exists in the db with the same index.
140
- * This is expected to happen because whenever we start sync we start from the last finalized index and we can have
141
- * pending indexes already stored from previous syncs.
142
- * @param preTags - The pre-tags containing the directional app tagging secrets and the indexes that are to be
143
- * stored in the db.
144
- * @param txHash - The tx in which the pretags were used in private logs.
131
+ * Stores pending index ranges.
132
+ * @remarks If the same (secret, txHash) pair already exists in the db with an equal range, it's a no-op. This is
133
+ * expected to happen because whenever we start sync we start from the last finalized index and we can have pending
134
+ * ranges already stored from previous syncs. If the ranges differ, it throws an error as that indicates a bug.
135
+ * @param ranges - The tagging index ranges containing the directional app tagging secrets and the index ranges that are
136
+ * to be stored in the db.
137
+ * @param txHash - The tx in which the tagging indexes were used in private logs.
145
138
  * @param jobId - job context for staged writes to this store. See `JobCoordinator` for more details.
146
- * @throws If any two pre-tags contain the same directional app tagging secret. This is enforced because we care
147
- * only about the highest index for a given secret that was used in the tx. Hence this check is a good way to catch
148
- * bugs.
149
- * @throws If the newly stored pending index is further than window length from the highest finalized index for the
150
- * same secret. This is enforced in order to give a guarantee to a recipient that he doesn't need to look further than
151
- * window length ahead of the highest finalized index.
152
- * @throws If a secret + txHash pair already exists in the db with a different index value. It should never happen
153
- * that we would attempt to store a different index for a given secret-txHash pair because we always store just the
154
- * highest index for a given secret-txHash pair. Hence this is a good way to catch bugs.
155
- * @throws If the newly stored pending index is lower than or equal to the last finalized index for the same secret.
156
- * This is enforced because this should never happen if the syncing is done correctly as we look for logs from higher
157
- * indexes than finalized ones.
139
+ * @throws If the highestIndex is further than window length from the highest finalized index for the same secret.
140
+ * @throws If the lowestIndex is lower than or equal to the last finalized index for the same secret.
141
+ * @throws If a different range already exists for the same (secret, txHash) pair.
158
142
  */
159
- async storePendingIndexes(preTags: PreTag[], txHash: TxHash, jobId: string) {
160
- // The secrets in pre-tags should be unique because we always store just the highest index per given secret-txHash
161
- // pair. Below we check that this is the case.
162
- const secretsSet = new Set(preTags.map(preTag => preTag.secret.toString()));
163
- if (secretsSet.size !== preTags.length) {
164
- throw new Error(`Duplicate secrets found when storing pending indexes`);
143
+ storePendingIndexes(ranges: TaggingIndexRange[], txHash: TxHash, jobId: string): Promise<void> {
144
+ if (ranges.length === 0) {
145
+ return Promise.resolve();
165
146
  }
166
147
 
167
- for (const { secret, index } of preTags) {
168
- // First we check that for any secret the highest used index in tx is not further than window length from
169
- // the highest finalized index.
170
- const finalizedIndex = (await this.getLastFinalizedIndex(secret, jobId)) ?? 0;
171
- if (index > finalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN) {
172
- throw new Error(
173
- `Highest used index ${index} is further than window length from the highest finalized index ${finalizedIndex}.
174
- Tagging window length ${UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN} is configured too low. Contact the Aztec team
175
- to increase it!`,
176
- );
177
- }
178
-
179
- // Throw if the new pending index is lower than or equal to the last finalized index
180
- const secretStr = secret.toString();
181
- const lastFinalizedIndex = await this.#readLastFinalizedIndex(jobId, secretStr);
182
- if (lastFinalizedIndex !== undefined && index <= lastFinalizedIndex) {
183
- throw new Error(
184
- `Cannot store pending index ${index} for secret ${secretStr}: ` +
185
- `it is lower than or equal to the last finalized index ${lastFinalizedIndex}`,
186
- );
187
- }
188
-
189
- // Check if this secret + txHash combination already exists
190
- const txHashStr = txHash.toString();
191
- const existingForSecret = await this.#readPendingIndexes(jobId, secretStr);
192
- const existingForSecretAndTx = existingForSecret.find(entry => entry.txHash === txHashStr);
148
+ const txHashStr = txHash.toString();
149
+
150
+ return this.#store.transactionAsync(async () => {
151
+ // Prefetch all data, start reads during iteration to keep IndexedDB transaction alive
152
+ const rangeReadPromises = ranges.map(range => ({
153
+ range,
154
+ secretStr: range.extendedSecret.toString(),
155
+ pending: this.#readPendingIndexes(jobId, range.extendedSecret.toString()),
156
+ finalized: this.#readLastFinalizedIndex(jobId, range.extendedSecret.toString()),
157
+ }));
158
+
159
+ // Await all reads together
160
+ const rangeData = await Promise.all(
161
+ rangeReadPromises.map(async item => ({
162
+ ...item,
163
+ pendingData: await item.pending,
164
+ finalizedIndex: await item.finalized,
165
+ })),
166
+ );
167
+
168
+ // Process in memory and validate
169
+ for (const { range, secretStr, pendingData, finalizedIndex } of rangeData) {
170
+ // Check that the highest index is not further than window length from the highest finalized index.
171
+ if (range.highestIndex > (finalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN) {
172
+ throw new Error(
173
+ `Highest used index ${range.highestIndex} is further than window length from the highest finalized index ${finalizedIndex ?? 0}.
174
+ Tagging window length ${UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN} is configured too low. Contact the Aztec team
175
+ to increase it!`,
176
+ );
177
+ }
193
178
 
194
- if (existingForSecretAndTx) {
195
- // If it exists with a different index, throw an error
196
- if (existingForSecretAndTx.index !== index) {
179
+ // Throw if the lowest index is lower than or equal to the last finalized index
180
+ if (finalizedIndex !== undefined && range.lowestIndex <= finalizedIndex) {
197
181
  throw new Error(
198
- `Cannot store index ${index} for secret ${secretStr} and txHash ${txHashStr}: ` +
199
- `a different index ${existingForSecretAndTx.index} already exists for this secret-txHash pair`,
182
+ `Cannot store pending index range [${range.lowestIndex}, ${range.highestIndex}] for secret ${secretStr}: ` +
183
+ `lowestIndex is lower than or equal to the last finalized index ${finalizedIndex}`,
200
184
  );
201
185
  }
202
- // If it exists with the same index, ignore the update (no-op)
203
- } else {
204
- // If it doesn't exist, add it
205
- this.#writePendingIndexes(jobId, secretStr, [...existingForSecret, { index, txHash: txHashStr }]);
186
+
187
+ // Check if an entry with the same txHash already exists
188
+ const existingEntry = pendingData.find(entry => entry.txHash === txHashStr);
189
+
190
+ if (existingEntry) {
191
+ // Assert that the ranges are equal — different ranges for the same (secret, txHash) indicates a bug
192
+ if (existingEntry.lowestIndex !== range.lowestIndex || existingEntry.highestIndex !== range.highestIndex) {
193
+ throw new Error(
194
+ `Conflicting range for secret ${secretStr} and txHash ${txHashStr}: ` +
195
+ `existing [${existingEntry.lowestIndex}, ${existingEntry.highestIndex}] vs ` +
196
+ `new [${range.lowestIndex}, ${range.highestIndex}]`,
197
+ );
198
+ }
199
+ // Exact duplicate — skip
200
+ } else {
201
+ this.#writePendingIndexes(jobId, secretStr, [
202
+ ...pendingData,
203
+ { lowestIndex: range.lowestIndex, highestIndex: range.highestIndex, txHash: txHashStr },
204
+ ]);
205
+ }
206
206
  }
207
- }
207
+ });
208
208
  }
209
209
 
210
210
  /**
211
- * Returns the transaction hashes of all pending transactions that contain indexes within a specified range
212
- * for a given directional app tagging secret.
211
+ * Returns the transaction hashes of all pending transactions that contain highest indexes within a specified range
212
+ * for a given directional app tagging secret. We check based on the highest indexes only as that is the relevant
213
+ * information for the caller of this function.
213
214
  * @param secret - The directional app tagging secret to query pending indexes for.
214
215
  * @param startIndex - The lower bound of the index range (inclusive).
215
216
  * @param endIndex - The upper bound of the index range (exclusive).
216
217
  * @returns An array of unique transaction hashes for pending transactions that contain indexes in the range
217
218
  * [startIndex, endIndex). Returns an empty array if no pending indexes exist in the range.
218
219
  */
219
- async getTxHashesOfPendingIndexes(
220
- secret: DirectionalAppTaggingSecret,
220
+ getTxHashesOfPendingIndexes(
221
+ secret: ExtendedDirectionalAppTaggingSecret,
221
222
  startIndex: number,
222
223
  endIndex: number,
223
224
  jobId: string,
224
225
  ): Promise<TxHash[]> {
225
- const existing = await this.#readPendingIndexes(jobId, secret.toString());
226
- const txHashes = existing
227
- .filter(entry => entry.index >= startIndex && entry.index < endIndex)
228
- .map(entry => entry.txHash);
229
- return Array.from(new Set(txHashes)).map(TxHash.fromString);
226
+ return this.#store.transactionAsync(async () => {
227
+ const existing = await this.#readPendingIndexes(jobId, secret.toString());
228
+ const txHashes = existing
229
+ .filter(entry => entry.highestIndex >= startIndex && entry.highestIndex < endIndex)
230
+ .map(entry => entry.txHash);
231
+ return Array.from(new Set(txHashes)).map(TxHash.fromString);
232
+ });
230
233
  }
231
234
 
232
235
  /**
@@ -234,8 +237,8 @@ export class SenderTaggingStore implements StagedStore {
234
237
  * @param secret - The secret to get the last finalized index for.
235
238
  * @returns The last (highest) finalized index for the given secret.
236
239
  */
237
- getLastFinalizedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
238
- return this.#readLastFinalizedIndex(jobId, secret.toString());
240
+ getLastFinalizedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
241
+ return this.#store.transactionAsync(() => this.#readLastFinalizedIndex(jobId, secret.toString()));
239
242
  }
240
243
 
241
244
  /**
@@ -244,102 +247,230 @@ export class SenderTaggingStore implements StagedStore {
244
247
  * @param secret - The directional app tagging secret to query the last used index for.
245
248
  * @returns The last used index.
246
249
  */
247
- async getLastUsedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
250
+ getLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
248
251
  const secretStr = secret.toString();
249
- const pendingTxScopedIndexes = await this.#readPendingIndexes(jobId, secretStr);
250
- const pendingIndexes = pendingTxScopedIndexes.map(entry => entry.index);
251
252
 
252
- if (pendingTxScopedIndexes.length === 0) {
253
- return this.#readLastFinalizedIndex(jobId, secretStr);
254
- }
253
+ return this.#store.transactionAsync(async () => {
254
+ const pendingPromise = this.#readPendingIndexes(jobId, secretStr);
255
+ const finalizedPromise = this.#readLastFinalizedIndex(jobId, secretStr);
256
+
257
+ const [pendingEntries, lastFinalized] = await Promise.all([pendingPromise, finalizedPromise]);
255
258
 
256
- // As the last used index we return the highest one from the pending indexes. Note that this value will be always
257
- // higher than the last finalized index because we prune lower pending indexes when a tx is finalized.
258
- return Math.max(...pendingIndexes);
259
+ if (pendingEntries.length === 0) {
260
+ return lastFinalized;
261
+ }
262
+
263
+ // As the last used index we return the highest one from the pending index ranges. Note that this value will be
264
+ // always higher than the last finalized index because we prune lower pending indexes when a tx is finalized.
265
+ return Math.max(...pendingEntries.map(entry => entry.highestIndex));
266
+ });
259
267
  }
260
268
 
261
269
  /**
262
270
  * Drops all pending indexes corresponding to the given transaction hashes.
263
271
  */
264
- async dropPendingIndexes(txHashes: TxHash[], jobId: string) {
272
+ dropPendingIndexes(txHashes: TxHash[], jobId: string): Promise<void> {
265
273
  if (txHashes.length === 0) {
266
- return;
274
+ return Promise.resolve();
267
275
  }
268
276
 
269
277
  const txHashStrings = new Set<string>(txHashes.map(txHash => txHash.toString()));
270
- const allSecrets = await this.#readSecretsWithPendingIndexes(jobId);
271
-
272
- for (const secret of allSecrets) {
273
- const pendingData = await this.#readPendingIndexes(jobId, secret);
274
- if (pendingData) {
275
- const filtered = pendingData.filter(item => !txHashStrings.has(item.txHash));
276
- if (filtered.length === 0) {
277
- this.#writePendingIndexes(jobId, secret, []);
278
- } else if (filtered.length !== pendingData.length) {
279
- // Some items were filtered out, so update the pending data
280
- this.#writePendingIndexes(jobId, secret, filtered);
278
+
279
+ return this.#store.transactionAsync(async () => {
280
+ // Prefetch all data, start reads during iteration to keep IndexedDB transaction alive
281
+ const secretReadPromises: Map<string, Promise<PendingIndexesEntry[]>> = new Map();
282
+
283
+ for await (const secret of this.#pendingIndexes.keysAsync()) {
284
+ secretReadPromises.set(secret, this.#readPendingIndexes(jobId, secret));
285
+ }
286
+
287
+ // Add staged-only secrets (sync, no DB)
288
+ for (const secret of this.#getPendingIndexesForJob(jobId).keys()) {
289
+ if (!secretReadPromises.has(secret)) {
290
+ secretReadPromises.set(secret, Promise.resolve(this.#getPendingIndexesForJob(jobId).get(secret) ?? []));
281
291
  }
282
- // else: No items were filtered out (txHashes not found for this secret) --> no-op
283
292
  }
284
- }
293
+
294
+ // Await all reads together
295
+ const secrets = [...secretReadPromises.keys()];
296
+ const pendingDataResults = await Promise.all(secretReadPromises.values());
297
+
298
+ // Process in memory
299
+ for (let i = 0; i < secrets.length; i++) {
300
+ const secret = secrets[i];
301
+ const pendingData = pendingDataResults[i];
302
+
303
+ if (pendingData && pendingData.length > 0) {
304
+ const filtered = pendingData.filter(item => !txHashStrings.has(item.txHash));
305
+ if (filtered.length === 0) {
306
+ this.#writePendingIndexes(jobId, secret, []);
307
+ } else if (filtered.length !== pendingData.length) {
308
+ // Some items were filtered out, so update the pending data
309
+ this.#writePendingIndexes(jobId, secret, filtered);
310
+ }
311
+ // else: No items were filtered out (txHashes not found for this secret) --> no-op
312
+ }
313
+ }
314
+ });
315
+ }
316
+
317
+ /** Prefetches all pending and finalized index data for every secret (from both DB and staged writes). */
318
+ #getSecretsWithPendingData(
319
+ jobId: string,
320
+ ): Promise<{ secret: string; pendingData: PendingIndexesEntry[]; lastFinalized: number | undefined }[]> {
321
+ return this.#store.transactionAsync(async () => {
322
+ // Prefetch all data, start reads during iteration to keep IndexedDB transaction alive
323
+ const secretDataPromises: Map<
324
+ string,
325
+ { pending: Promise<PendingIndexesEntry[]>; finalized: Promise<number | undefined> }
326
+ > = new Map();
327
+
328
+ for await (const secret of this.#pendingIndexes.keysAsync()) {
329
+ secretDataPromises.set(secret, {
330
+ pending: this.#readPendingIndexes(jobId, secret),
331
+ finalized: this.#readLastFinalizedIndex(jobId, secret),
332
+ });
333
+ }
334
+
335
+ // Add staged-only secrets (sync, no DB)
336
+ for (const secret of this.#getPendingIndexesForJob(jobId).keys()) {
337
+ if (!secretDataPromises.has(secret)) {
338
+ secretDataPromises.set(secret, {
339
+ pending: Promise.resolve(this.#getPendingIndexesForJob(jobId).get(secret) ?? []),
340
+ finalized: Promise.resolve(this.#getLastFinalizedIndexesForJob(jobId).get(secret)),
341
+ });
342
+ }
343
+ }
344
+
345
+ // Await all reads together
346
+ const secrets = [...secretDataPromises.keys()];
347
+ const dataResults = await Promise.all(
348
+ secrets.map(async secret => ({
349
+ secret,
350
+ pendingData: await secretDataPromises.get(secret)!.pending,
351
+ lastFinalized: await secretDataPromises.get(secret)!.finalized,
352
+ })),
353
+ );
354
+
355
+ return dataResults.filter(r => r.pendingData.length > 0);
356
+ });
285
357
  }
286
358
 
287
359
  /**
288
360
  * Updates pending indexes corresponding to the given transaction hashes to be finalized and prunes any lower pending
289
361
  * indexes.
290
362
  */
291
- async finalizePendingIndexes(txHashes: TxHash[], jobId: string) {
363
+ async finalizePendingIndexes(txHashes: TxHash[], jobId: string): Promise<void> {
292
364
  if (txHashes.length === 0) {
293
365
  return;
294
366
  }
295
367
 
296
- for (const txHash of txHashes) {
297
- const txHashStr = txHash.toString();
368
+ const txHashStrings = new Set(txHashes.map(tx => tx.toString()));
369
+ const secretsWithData = await this.#getSecretsWithPendingData(jobId);
298
370
 
299
- const allSecrets = await this.#readSecretsWithPendingIndexes(jobId);
371
+ for (const { secret, pendingData, lastFinalized } of secretsWithData) {
372
+ let currentPending = pendingData;
373
+ let currentFinalized = lastFinalized;
300
374
 
301
- for (const secret of allSecrets) {
302
- const pendingData = await this.#readPendingIndexes(jobId, secret);
303
- if (!pendingData) {
375
+ // Process all txHashes for this secret
376
+ for (const txHashStr of txHashStrings) {
377
+ const matchingEntries = currentPending.filter(item => item.txHash === txHashStr);
378
+ if (matchingEntries.length === 0) {
379
+ // This is expected as a higher index might have already been finalized which would lead to pruning of
380
+ // pending entries.
304
381
  continue;
305
382
  }
306
383
 
307
- const matchingIndexes = pendingData.filter(item => item.txHash === txHashStr).map(item => item.index);
308
- if (matchingIndexes.length === 0) {
309
- continue;
310
- }
311
-
312
- if (matchingIndexes.length > 1) {
384
+ if (matchingEntries.length > 1) {
313
385
  // We should always just store the highest pending index for a given tx hash and secret because the lower
314
386
  // values are irrelevant.
315
- throw new Error(`Multiple pending indexes found for tx hash ${txHashStr} and secret ${secret}`);
387
+ throw new Error(`Multiple pending entries found for tx hash ${txHashStr} and secret ${secret}`);
316
388
  }
317
389
 
318
- let lastFinalized = await this.#readLastFinalizedIndex(jobId, secret);
319
- const newFinalized = matchingIndexes[0];
390
+ const newFinalized = matchingEntries[0].highestIndex;
320
391
 
321
- if (newFinalized < (lastFinalized ?? 0)) {
392
+ if (newFinalized < (currentFinalized ?? 0)) {
322
393
  // This should never happen because when last finalized index was finalized we should have pruned the lower
323
394
  // pending indexes.
324
395
  throw new Error(
325
- `New finalized index ${newFinalized} is smaller than the current last finalized index ${lastFinalized}`,
396
+ `New finalized index ${newFinalized} is smaller than the current last finalized index ${currentFinalized}`,
326
397
  );
327
398
  }
328
399
 
329
- this.#writeLastFinalizedIndex(jobId, secret, newFinalized);
330
- lastFinalized = newFinalized;
400
+ currentFinalized = newFinalized;
331
401
 
332
402
  // When we add pending indexes, we ensure they are higher than the last finalized index. However, because we
333
403
  // cannot control the order in which transactions are finalized, there may be pending indexes that are now
334
404
  // obsolete because they are lower than the most recently finalized index. For this reason, we prune these
335
405
  // outdated pending indexes.
336
- const remainingItemsOfHigherIndex = pendingData.filter(item => item.index > (lastFinalized ?? 0));
337
- if (remainingItemsOfHigherIndex.length === 0) {
338
- this.#writePendingIndexes(jobId, secret, []);
339
- } else {
340
- this.#writePendingIndexes(jobId, secret, remainingItemsOfHigherIndex);
406
+ currentPending = currentPending.filter(item => item.highestIndex > currentFinalized!);
407
+ }
408
+
409
+ // Write final state if changed
410
+ if (currentFinalized !== lastFinalized) {
411
+ this.#writeLastFinalizedIndex(jobId, secret, currentFinalized!);
412
+ }
413
+ if (currentPending !== pendingData) {
414
+ this.#writePendingIndexes(jobId, secret, currentPending);
415
+ }
416
+ }
417
+ }
418
+
419
+ /**
420
+ * Handles finalization of pending indexes for a transaction whose execution was partially reverted.
421
+ * Recomputes the siloed tags for each pending index of the given tx and checks which ones appear in the
422
+ * TxEffect's private logs (i.e., which ones made it onchain). Those that survived are finalized; those that
423
+ * didn't are dropped.
424
+ * @param txEffect - The tx effect of the partially reverted transaction.
425
+ * @param jobId - job context for staged writes to this store. See `JobCoordinator` for more details.
426
+ */
427
+ async finalizePendingIndexesOfAPartiallyRevertedTx(txEffect: TxEffect, jobId: string): Promise<void> {
428
+ const txHashStr = txEffect.txHash.toString();
429
+
430
+ // Build a set of all siloed tag values that made it onchain (first field of each private log).
431
+ const onChainTags = new Set<string>(txEffect.privateLogs.map(log => log.fields[0].toString()));
432
+
433
+ const secretsWithData = await this.#getSecretsWithPendingData(jobId);
434
+
435
+ for (const { secret, pendingData, lastFinalized } of secretsWithData) {
436
+ const matchingEntries = pendingData.filter(item => item.txHash === txHashStr);
437
+ if (matchingEntries.length === 0) {
438
+ // This is expected as a higher index might have already been finalized which would lead to pruning of
439
+ // pending entries.
440
+ continue;
441
+ }
442
+
443
+ if (matchingEntries.length > 1) {
444
+ // We should always just store the highest pending index for a given tx hash and secret because the lower
445
+ // values are irrelevant.
446
+ throw new Error(`Multiple pending entries found for tx hash ${txHashStr} and secret ${secret}`);
447
+ }
448
+
449
+ const pendingEntry = matchingEntries[0];
450
+
451
+ // Expand each matching entry's range and recompute siloed tags for each index.
452
+ const extendedSecret = ExtendedDirectionalAppTaggingSecret.fromString(secret);
453
+ let highestSurvivingIndex: number | undefined;
454
+
455
+ for (let index = pendingEntry.lowestIndex; index <= pendingEntry.highestIndex; index++) {
456
+ const siloedTag = await SiloedTag.compute({ extendedSecret, index });
457
+ if (onChainTags.has(siloedTag.value.toString())) {
458
+ highestSurvivingIndex = highestSurvivingIndex !== undefined ? Math.max(highestSurvivingIndex, index) : index;
341
459
  }
342
460
  }
461
+
462
+ // Remove all entries for this txHash from pending (both surviving and non-surviving).
463
+ let currentPending = pendingData.filter(item => item.txHash !== txHashStr);
464
+
465
+ if (highestSurvivingIndex !== undefined) {
466
+ const newFinalized = Math.max(lastFinalized ?? 0, highestSurvivingIndex);
467
+ this.#writeLastFinalizedIndex(jobId, secret, newFinalized);
468
+
469
+ // Prune pending indexes that are now <= the finalized index.
470
+ currentPending = currentPending.filter(item => item.highestIndex > newFinalized);
471
+ }
472
+
473
+ this.#writePendingIndexes(jobId, secret, currentPending);
343
474
  }
344
475
  }
345
476
  }
@@ -1,6 +1,6 @@
1
1
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
- import type { L2BlockHash } from '@aztec/stdlib/block';
3
- import { MAX_LOGS_PER_TAG } from '@aztec/stdlib/interfaces/api-limit';
2
+ import type { BlockHash } from '@aztec/stdlib/block';
3
+ import { MAX_LOGS_PER_TAG, MAX_RPC_LEN } from '@aztec/stdlib/interfaces/api-limit';
4
4
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
5
  import type { SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
6
6
 
@@ -31,6 +31,26 @@ async function getAllPages<T>(numTags: number, fetchPage: (page: number) => Prom
31
31
  return allResultsPerTag;
32
32
  }
33
33
 
34
+ /**
35
+ * Splits tags into chunks of MAX_RPC_LEN, fetches logs for each chunk using getAllPages, then stitches the results
36
+ * back into a single array preserving the original tag order.
37
+ */
38
+ async function getAllPagesInBatches<Tag, T>(
39
+ tags: Tag[],
40
+ fetchAllPagesForBatch: (batch: Tag[]) => Promise<T[][]>,
41
+ ): Promise<T[][]> {
42
+ if (tags.length <= MAX_RPC_LEN) {
43
+ return fetchAllPagesForBatch(tags);
44
+ }
45
+
46
+ const batches: Tag[][] = [];
47
+ for (let i = 0; i < tags.length; i += MAX_RPC_LEN) {
48
+ batches.push(tags.slice(i, i + MAX_RPC_LEN));
49
+ }
50
+ const batchResults = await Promise.all(batches.map(fetchAllPagesForBatch));
51
+ return batchResults.flat();
52
+ }
53
+
34
54
  /**
35
55
  * Fetches all private logs for the given tags, automatically paginating through all pages.
36
56
  * @param aztecNode - The Aztec node to query.
@@ -42,9 +62,11 @@ async function getAllPages<T>(numTags: number, fetchPage: (page: number) => Prom
42
62
  export function getAllPrivateLogsByTags(
43
63
  aztecNode: AztecNode,
44
64
  tags: SiloedTag[],
45
- anchorBlockHash: L2BlockHash,
65
+ anchorBlockHash: BlockHash,
46
66
  ): Promise<TxScopedL2Log[][]> {
47
- return getAllPages(tags.length, page => aztecNode.getPrivateLogsByTags(tags, page, anchorBlockHash));
67
+ return getAllPagesInBatches(tags, batch =>
68
+ getAllPages(batch.length, page => aztecNode.getPrivateLogsByTags(batch, page, anchorBlockHash)),
69
+ );
48
70
  }
49
71
 
50
72
  /**
@@ -60,9 +82,11 @@ export function getAllPublicLogsByTagsFromContract(
60
82
  aztecNode: AztecNode,
61
83
  contractAddress: AztecAddress,
62
84
  tags: Tag[],
63
- anchorBlockHash: L2BlockHash,
85
+ anchorBlockHash: BlockHash,
64
86
  ): Promise<TxScopedL2Log[][]> {
65
- return getAllPages(tags.length, page =>
66
- aztecNode.getPublicLogsByTagsFromContract(contractAddress, tags, page, anchorBlockHash),
87
+ return getAllPagesInBatches(tags, batch =>
88
+ getAllPages(batch.length, page =>
89
+ aztecNode.getPublicLogsByTagsFromContract(contractAddress, batch, page, anchorBlockHash),
90
+ ),
67
91
  );
68
92
  }