@aztec/pxe 0.0.1-commit.f504929 → 0.0.1-commit.f650c0a5c

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 (179) hide show
  1. package/dest/bin/check_oracle_version.js +4 -4
  2. package/dest/block_synchronizer/block_synchronizer.d.ts +1 -1
  3. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  4. package/dest/block_synchronizer/block_synchronizer.js +6 -0
  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/contract_function_simulator/contract_function_simulator.d.ts +10 -5
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/contract_function_simulator.js +29 -6
  11. package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
  12. package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
  13. package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
  14. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -5
  15. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  16. package/dest/contract_function_simulator/execution_tagging_index_cache.js +17 -9
  17. package/dest/contract_function_simulator/index.d.ts +2 -1
  18. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/index.js +1 -0
  20. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +4 -6
  21. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +8 -10
  23. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +1 -1
  24. package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +1 -1
  25. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
  26. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  27. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +2 -4
  28. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +4 -7
  29. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  30. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +6 -11
  31. package/dest/contract_function_simulator/oracle/interfaces.d.ts +38 -22
  32. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  33. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  34. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  35. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +47 -0
  36. package/dest/contract_function_simulator/oracle/oracle.d.ts +51 -20
  37. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  38. package/dest/contract_function_simulator/oracle/oracle.js +188 -46
  39. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  40. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +12 -38
  41. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  42. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +21 -44
  43. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +76 -41
  44. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  45. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +258 -87
  46. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  47. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  48. package/dest/contract_function_simulator/pick_notes.js +9 -2
  49. package/dest/contract_logging.d.ts +9 -4
  50. package/dest/contract_logging.d.ts.map +1 -1
  51. package/dest/contract_logging.js +21 -6
  52. package/dest/contract_sync/contract_sync_service.d.ts +6 -5
  53. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  54. package/dest/contract_sync/contract_sync_service.js +44 -37
  55. package/dest/contract_sync/helpers.d.ts +2 -3
  56. package/dest/contract_sync/helpers.d.ts.map +1 -1
  57. package/dest/contract_sync/helpers.js +7 -2
  58. package/dest/debug/pxe_debug_utils.d.ts +3 -3
  59. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  60. package/dest/entrypoints/client/bundle/index.d.ts +1 -2
  61. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  62. package/dest/entrypoints/client/bundle/index.js +0 -1
  63. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  64. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  65. package/dest/entrypoints/client/bundle/utils.js +2 -2
  66. package/dest/entrypoints/client/lazy/index.d.ts +1 -2
  67. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  68. package/dest/entrypoints/client/lazy/index.js +0 -1
  69. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  70. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  71. package/dest/entrypoints/client/lazy/utils.js +2 -2
  72. package/dest/entrypoints/pxe_creation_options.d.ts +3 -1
  73. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  74. package/dest/entrypoints/pxe_creation_options.js +3 -1
  75. package/dest/entrypoints/server/index.d.ts +2 -3
  76. package/dest/entrypoints/server/index.d.ts.map +1 -1
  77. package/dest/entrypoints/server/index.js +1 -2
  78. package/dest/entrypoints/server/utils.d.ts +2 -2
  79. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  80. package/dest/entrypoints/server/utils.js +2 -2
  81. package/dest/events/event_service.d.ts +3 -2
  82. package/dest/events/event_service.d.ts.map +1 -1
  83. package/dest/events/event_service.js +16 -4
  84. package/dest/logs/log_service.d.ts +5 -8
  85. package/dest/logs/log_service.d.ts.map +1 -1
  86. package/dest/logs/log_service.js +24 -37
  87. package/dest/messages/message_context_service.d.ts +17 -0
  88. package/dest/messages/message_context_service.d.ts.map +1 -0
  89. package/dest/messages/message_context_service.js +36 -0
  90. package/dest/notes/note_service.d.ts +4 -5
  91. package/dest/notes/note_service.d.ts.map +1 -1
  92. package/dest/notes/note_service.js +14 -5
  93. package/dest/notes_filter.d.ts +2 -3
  94. package/dest/notes_filter.d.ts.map +1 -1
  95. package/dest/oracle_version.d.ts +4 -3
  96. package/dest/oracle_version.d.ts.map +1 -1
  97. package/dest/oracle_version.js +20 -10
  98. package/dest/pxe.d.ts +9 -7
  99. package/dest/pxe.d.ts.map +1 -1
  100. package/dest/pxe.js +39 -23
  101. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  102. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  103. package/dest/storage/capsule_store/capsule_service.js +50 -0
  104. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  105. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  106. package/dest/storage/capsule_store/capsule_store.js +33 -28
  107. package/dest/storage/capsule_store/index.d.ts +2 -1
  108. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  109. package/dest/storage/capsule_store/index.js +1 -0
  110. package/dest/storage/metadata.d.ts +1 -1
  111. package/dest/storage/metadata.js +1 -1
  112. package/dest/storage/note_store/note_store.d.ts +1 -1
  113. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  114. package/dest/storage/note_store/note_store.js +2 -2
  115. package/dest/storage/tagging_store/sender_tagging_store.d.ts +26 -25
  116. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  117. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  118. package/dest/tagging/index.d.ts +2 -2
  119. package/dest/tagging/index.d.ts.map +1 -1
  120. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +1 -1
  121. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  122. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +10 -1
  123. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  124. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  125. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  126. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +2 -1
  127. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  128. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +24 -11
  129. package/package.json +16 -16
  130. package/src/bin/check_oracle_version.ts +4 -4
  131. package/src/block_synchronizer/block_synchronizer.ts +6 -0
  132. package/src/config/index.ts +1 -1
  133. package/src/contract_function_simulator/contract_function_simulator.ts +42 -10
  134. package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
  135. package/src/contract_function_simulator/execution_tagging_index_cache.ts +16 -11
  136. package/src/contract_function_simulator/index.ts +1 -0
  137. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -9
  138. package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +1 -1
  139. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
  140. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -10
  141. package/src/contract_function_simulator/oracle/interfaces.ts +58 -30
  142. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +104 -0
  143. package/src/contract_function_simulator/oracle/oracle.ts +262 -66
  144. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  145. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +26 -65
  146. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +431 -117
  147. package/src/contract_function_simulator/pick_notes.ts +9 -2
  148. package/src/contract_logging.ts +18 -5
  149. package/src/contract_sync/contract_sync_service.ts +77 -59
  150. package/src/contract_sync/helpers.ts +4 -4
  151. package/src/debug/pxe_debug_utils.ts +3 -3
  152. package/src/entrypoints/client/bundle/index.ts +0 -1
  153. package/src/entrypoints/client/bundle/utils.ts +2 -3
  154. package/src/entrypoints/client/lazy/index.ts +0 -1
  155. package/src/entrypoints/client/lazy/utils.ts +2 -3
  156. package/src/entrypoints/pxe_creation_options.ts +7 -0
  157. package/src/entrypoints/server/index.ts +1 -2
  158. package/src/entrypoints/server/utils.ts +2 -3
  159. package/src/events/event_service.ts +17 -4
  160. package/src/logs/log_service.ts +52 -78
  161. package/src/messages/message_context_service.ts +44 -0
  162. package/src/notes/note_service.ts +18 -8
  163. package/src/notes_filter.ts +1 -3
  164. package/src/oracle_version.ts +20 -10
  165. package/src/pxe.ts +62 -28
  166. package/src/storage/capsule_store/capsule_service.ts +90 -0
  167. package/src/storage/capsule_store/capsule_store.ts +34 -26
  168. package/src/storage/capsule_store/index.ts +1 -0
  169. package/src/storage/metadata.ts +1 -1
  170. package/src/storage/note_store/note_store.ts +2 -5
  171. package/src/storage/tagging_store/sender_tagging_store.ts +182 -135
  172. package/src/tagging/index.ts +1 -1
  173. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +19 -1
  174. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  175. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +19 -9
  176. package/dest/access_scopes.d.ts +0 -9
  177. package/dest/access_scopes.d.ts.map +0 -1
  178. package/dest/access_scopes.js +0 -6
  179. package/src/access_scopes.ts +0 -9
@@ -10,6 +10,7 @@ import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
10
10
  * @param end - The ending index (exclusive) of the window to process.
11
11
  * @param aztecNode - The Aztec node instance to query for logs.
12
12
  * @param taggingStore - The data provider to store pending indexes.
13
+ * @param anchorBlockHash - Hash of a block to use as reference block when querying node.
13
14
  * @param jobId - Job identifier, used to keep writes in-memory until they can be persisted in a data integrity
14
15
  * preserving way.
15
16
  */ export async function loadAndStoreNewTaggingIndexes(extendedSecret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId) {
@@ -21,16 +22,18 @@ import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
21
22
  index: start + i
22
23
  })));
23
24
  const txsForTags = await getTxsContainingTags(siloedTagsForWindow, aztecNode, anchorBlockHash);
24
- const highestIndexMap = getTxHighestIndexMap(txsForTags, start, siloedTagsForWindow.length);
25
- // Now we iterate over the map, reconstruct the preTags and tx hash and store them in the db.
26
- for (const [txHashStr, highestIndex] of highestIndexMap.entries()){
25
+ const txIndexesMap = getTxIndexesMap(txsForTags, start, siloedTagsForWindow.length);
26
+ // Now we iterate over the map, construct the tagging index ranges and store them in the db.
27
+ for (const [txHashStr, indexes] of txIndexesMap.entries()){
27
28
  const txHash = TxHash.fromString(txHashStr);
28
- await taggingStore.storePendingIndexes([
29
+ const ranges = [
29
30
  {
30
31
  extendedSecret,
31
- index: highestIndex
32
+ lowestIndex: Math.min(...indexes),
33
+ highestIndex: Math.max(...indexes)
32
34
  }
33
- ], txHash, jobId);
35
+ ];
36
+ await taggingStore.storePendingIndexes(ranges, txHash, jobId);
34
37
  }
35
38
  }
36
39
  // Returns txs that used the given tags. A tag might have been used in multiple txs and for this reason we return
@@ -41,19 +44,29 @@ async function getTxsContainingTags(tags, aztecNode, anchorBlockHash) {
41
44
  const allLogs = await getAllPrivateLogsByTags(aztecNode, tags, anchorBlockHash);
42
45
  return allLogs.map((logs)=>logs.map((log)=>log.txHash));
43
46
  }
44
- // Returns a map of txHash to the highest index for that txHash.
45
- function getTxHighestIndexMap(txHashesForTags, start, count) {
47
+ // Returns a map of txHash to all indexes for that txHash.
48
+ function getTxIndexesMap(txHashesForTags, start, count) {
46
49
  if (txHashesForTags.length !== count) {
47
50
  throw new Error(`Number of tx hashes arrays does not match number of tags. ${txHashesForTags.length} !== ${count}`);
48
51
  }
49
- const highestIndexMap = new Map();
52
+ const indexesMap = new Map();
53
+ // Iterate over indexes
50
54
  for(let i = 0; i < txHashesForTags.length; i++){
51
55
  const taggingIndex = start + i;
52
56
  const txHashesForTag = txHashesForTags[i];
57
+ // iterate over tx hashes that used that index (tag)
53
58
  for (const txHash of txHashesForTag){
54
59
  const key = txHash.toString();
55
- highestIndexMap.set(key, Math.max(highestIndexMap.get(key) ?? 0, taggingIndex));
60
+ const existing = indexesMap.get(key);
61
+ // Add the index to the tx's indexes
62
+ if (existing) {
63
+ existing.push(taggingIndex);
64
+ } else {
65
+ indexesMap.set(key, [
66
+ taggingIndex
67
+ ]);
68
+ }
56
69
  }
57
70
  }
58
- return highestIndexMap;
71
+ return indexesMap;
59
72
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/pxe",
3
- "version": "0.0.1-commit.f504929",
3
+ "version": "0.0.1-commit.f650c0a5c",
4
4
  "type": "module",
5
5
  "typedocOptions": {
6
6
  "entryPoints": [
@@ -70,19 +70,19 @@
70
70
  ]
71
71
  },
72
72
  "dependencies": {
73
- "@aztec/bb-prover": "0.0.1-commit.f504929",
74
- "@aztec/bb.js": "0.0.1-commit.f504929",
75
- "@aztec/builder": "0.0.1-commit.f504929",
76
- "@aztec/constants": "0.0.1-commit.f504929",
77
- "@aztec/ethereum": "0.0.1-commit.f504929",
78
- "@aztec/foundation": "0.0.1-commit.f504929",
79
- "@aztec/key-store": "0.0.1-commit.f504929",
80
- "@aztec/kv-store": "0.0.1-commit.f504929",
81
- "@aztec/noir-protocol-circuits-types": "0.0.1-commit.f504929",
82
- "@aztec/noir-types": "0.0.1-commit.f504929",
83
- "@aztec/protocol-contracts": "0.0.1-commit.f504929",
84
- "@aztec/simulator": "0.0.1-commit.f504929",
85
- "@aztec/stdlib": "0.0.1-commit.f504929",
73
+ "@aztec/bb-prover": "0.0.1-commit.f650c0a5c",
74
+ "@aztec/bb.js": "0.0.1-commit.f650c0a5c",
75
+ "@aztec/builder": "0.0.1-commit.f650c0a5c",
76
+ "@aztec/constants": "0.0.1-commit.f650c0a5c",
77
+ "@aztec/ethereum": "0.0.1-commit.f650c0a5c",
78
+ "@aztec/foundation": "0.0.1-commit.f650c0a5c",
79
+ "@aztec/key-store": "0.0.1-commit.f650c0a5c",
80
+ "@aztec/kv-store": "0.0.1-commit.f650c0a5c",
81
+ "@aztec/noir-protocol-circuits-types": "0.0.1-commit.f650c0a5c",
82
+ "@aztec/noir-types": "0.0.1-commit.f650c0a5c",
83
+ "@aztec/protocol-contracts": "0.0.1-commit.f650c0a5c",
84
+ "@aztec/simulator": "0.0.1-commit.f650c0a5c",
85
+ "@aztec/stdlib": "0.0.1-commit.f650c0a5c",
86
86
  "koa": "^2.16.1",
87
87
  "koa-router": "^13.1.1",
88
88
  "lodash.omit": "^4.5.0",
@@ -91,8 +91,8 @@
91
91
  "viem": "npm:@aztec/viem@2.38.2"
92
92
  },
93
93
  "devDependencies": {
94
- "@aztec/merkle-tree": "0.0.1-commit.f504929",
95
- "@aztec/noir-test-contracts.js": "0.0.1-commit.f504929",
94
+ "@aztec/noir-test-contracts.js": "0.0.1-commit.f650c0a5c",
95
+ "@aztec/world-state": "0.0.1-commit.f650c0a5c",
96
96
  "@jest/globals": "^30.0.0",
97
97
  "@types/jest": "^30.0.0",
98
98
  "@types/lodash.omit": "^4.5.7",
@@ -13,8 +13,9 @@ import { ORACLE_INTERFACE_HASH } from '../oracle_version.js';
13
13
  *
14
14
  * The Oracle interface needs to be versioned to ensure compatibility between Aztec.nr and PXE. This function computes
15
15
  * a hash of the Oracle interface and compares it against a known hash. If they don't match, it means the interface has
16
- * changed and the ORACLE_VERSION constant needs to be incremented and the ORACLE_INTERFACE_HASH constant needs to be
17
- * updated.
16
+ * changed and the oracle version needs to be bumped:
17
+ * - If the change is backward-breaking (e.g. removing/renaming an oracle), bump ORACLE_VERSION_MAJOR.
18
+ * - If the change is an oracle addition (non-breaking), bump ORACLE_VERSION_MINOR.
18
19
  *
19
20
  * TODO(#16581): The following only takes into consideration changes to the oracles defined in Oracle.ts and omits TXE
20
21
  * oracles. Ensure this checks TXE oracles as well. This hasn't been implemented yet since we don't have a clean TXE
@@ -26,9 +27,8 @@ function assertOracleInterfaceMatches(): void {
26
27
  // We use keccak256 here just because we already have it in the dependencies.
27
28
  const oracleInterfaceHash = keccak256String(oracleInterfaceSignature);
28
29
  if (oracleInterfaceHash !== ORACLE_INTERFACE_HASH) {
29
- // This check exists only to notify you when you need to update the ORACLE_VERSION constant.
30
30
  throw new Error(
31
- `The Oracle interface has changed, which implies a breaking change in the aztec.nr/PXE oracle interface. Update ORACLE_INTERFACE_HASH to ${oracleInterfaceHash} and bump ORACLE_VERSION in pxe/src/oracle_version.ts.`,
31
+ `The Oracle interface has changed. Update ORACLE_INTERFACE_HASH to ${oracleInterfaceHash} in pxe/src/oracle_version.ts and bump the oracle version (ORACLE_VERSION_MAJOR for breaking changes, ORACLE_VERSION_MINOR for oracle additions).`,
32
32
  );
33
33
  }
34
34
  }
@@ -77,6 +77,8 @@ export class BlockSynchronizer implements L2BlockStreamEventHandler {
77
77
  const blockHeader = await this.node.getBlockHeader(BlockNumber(event.block.number));
78
78
  if (blockHeader) {
79
79
  await this.updateAnchorBlockHeader(blockHeader);
80
+ } else {
81
+ this.log.warn(`Block header not found for proven block ${event.block.number}, skipping anchor update`);
80
82
  }
81
83
  }
82
84
  break;
@@ -86,6 +88,8 @@ export class BlockSynchronizer implements L2BlockStreamEventHandler {
86
88
  const blockHeader = await this.node.getBlockHeader(BlockNumber(event.block.number));
87
89
  if (blockHeader) {
88
90
  await this.updateAnchorBlockHeader(blockHeader);
91
+ } else {
92
+ this.log.warn(`Block header not found for finalized block ${event.block.number}, skipping anchor update`);
89
93
  }
90
94
  }
91
95
  break;
@@ -152,6 +156,8 @@ export class BlockSynchronizer implements L2BlockStreamEventHandler {
152
156
  }
153
157
 
154
158
  this.log.debug(`Syncing PXE with the node`);
159
+ // Capture the promise locally so we always await the exact promise we created, even if this.isSyncing is modified
160
+ // between assignment and await (e.g. due to future refactors introducing a yield point).
155
161
  const isSyncing = this.doSync();
156
162
  this.isSyncing = isSyncing;
157
163
  try {
@@ -5,8 +5,8 @@ import {
5
5
  numberConfigHelper,
6
6
  parseBooleanEnv,
7
7
  } from '@aztec/foundation/config';
8
- import { type DataStoreConfig, dataConfigMappings } from '@aztec/kv-store/config';
9
8
  import { type ChainConfig, chainConfigMappings } from '@aztec/stdlib/config';
9
+ import { type DataStoreConfig, dataConfigMappings } from '@aztec/stdlib/kv-store';
10
10
 
11
11
  export { getPackageInfo } from './package_info.js';
12
12
 
@@ -17,6 +17,7 @@ import {
17
17
  MAX_NULLIFIERS_PER_TX,
18
18
  MAX_NULLIFIER_READ_REQUESTS_PER_TX,
19
19
  MAX_PRIVATE_LOGS_PER_TX,
20
+ MAX_TX_LIFETIME,
20
21
  PRIVATE_TX_L2_GAS_OVERHEAD,
21
22
  PUBLIC_TX_L2_GAS_OVERHEAD,
22
23
  TX_DA_GAS_OVERHEAD,
@@ -79,6 +80,7 @@ import {
79
80
  BlockHeader,
80
81
  CallContext,
81
82
  HashedValues,
83
+ type OffchainEffect,
82
84
  PrivateExecutionResult,
83
85
  TxConstantData,
84
86
  TxExecutionRequest,
@@ -87,9 +89,10 @@ import {
87
89
  getFinalMinRevertibleSideEffectCounter,
88
90
  } from '@aztec/stdlib/tx';
89
91
 
90
- import type { AccessScopes } from '../access_scopes.js';
91
92
  import type { ContractSyncService } from '../contract_sync/contract_sync_service.js';
93
+ import type { MessageContextService } from '../messages/message_context_service.js';
92
94
  import type { AddressStore } from '../storage/address_store/address_store.js';
95
+ import { CapsuleService } from '../storage/capsule_store/capsule_service.js';
93
96
  import type { CapsuleStore } from '../storage/capsule_store/capsule_store.js';
94
97
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
95
98
  import type { NoteStore } from '../storage/note_store/note_store.js';
@@ -119,7 +122,7 @@ export type ContractSimulatorRunOpts = {
119
122
  /** The address used as a tagging sender when emitting private logs. */
120
123
  senderForTags?: AztecAddress;
121
124
  /** The accounts whose notes we can access in this call. */
122
- scopes: AccessScopes;
125
+ scopes: AztecAddress[];
123
126
  /** The job ID for staged writes. */
124
127
  jobId: string;
125
128
  };
@@ -138,6 +141,7 @@ export type ContractFunctionSimulatorArgs = {
138
141
  privateEventStore: PrivateEventStore;
139
142
  simulator: CircuitSimulator;
140
143
  contractSyncService: ContractSyncService;
144
+ messageContextService: MessageContextService;
141
145
  };
142
146
 
143
147
  /**
@@ -157,6 +161,7 @@ export class ContractFunctionSimulator {
157
161
  private readonly privateEventStore: PrivateEventStore;
158
162
  private readonly simulator: CircuitSimulator;
159
163
  private readonly contractSyncService: ContractSyncService;
164
+ private readonly messageContextService: MessageContextService;
160
165
 
161
166
  constructor(args: ContractFunctionSimulatorArgs) {
162
167
  this.contractStore = args.contractStore;
@@ -171,6 +176,7 @@ export class ContractFunctionSimulator {
171
176
  this.privateEventStore = args.privateEventStore;
172
177
  this.simulator = args.simulator;
173
178
  this.contractSyncService = args.contractSyncService;
179
+ this.messageContextService = args.messageContextService;
174
180
  this.log = createLogger('simulator');
175
181
  }
176
182
 
@@ -239,8 +245,9 @@ export class ContractFunctionSimulator {
239
245
  senderTaggingStore: this.senderTaggingStore,
240
246
  recipientTaggingStore: this.recipientTaggingStore,
241
247
  senderAddressBookStore: this.senderAddressBookStore,
242
- capsuleStore: this.capsuleStore,
248
+ capsuleService: new CapsuleService(this.capsuleStore, scopes),
243
249
  privateEventStore: this.privateEventStore,
250
+ messageContextService: this.messageContextService,
244
251
  contractSyncService: this.contractSyncService,
245
252
  jobId,
246
253
  totalPublicCalldataCount: 0,
@@ -277,7 +284,7 @@ export class ContractFunctionSimulator {
277
284
  );
278
285
  const publicFunctionsCalldata = await Promise.all(
279
286
  publicCallRequests.map(async r => {
280
- const calldata = await privateExecutionOracle.loadFromExecutionCache(r.calldataHash);
287
+ const calldata = await privateExecutionOracle.getHashPreimage(r.calldataHash);
281
288
  return new HashedValues(calldata, r.calldataHash);
282
289
  }),
283
290
  );
@@ -312,9 +319,9 @@ export class ContractFunctionSimulator {
312
319
  call: FunctionCall,
313
320
  authwits: AuthWitness[],
314
321
  anchorBlockHeader: BlockHeader,
315
- scopes: AccessScopes,
322
+ scopes: AztecAddress[],
316
323
  jobId: string,
317
- ): Promise<Fr[]> {
324
+ ): Promise<{ result: Fr[]; offchainEffects: OffchainEffect[] }> {
318
325
  const entryPointArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(call.to, call.selector);
319
326
 
320
327
  if (entryPointArtifact.functionType !== FunctionType.UTILITY) {
@@ -333,8 +340,10 @@ export class ContractFunctionSimulator {
333
340
  aztecNode: this.aztecNode,
334
341
  recipientTaggingStore: this.recipientTaggingStore,
335
342
  senderAddressBookStore: this.senderAddressBookStore,
336
- capsuleStore: this.capsuleStore,
343
+ capsuleService: new CapsuleService(this.capsuleStore, scopes),
337
344
  privateEventStore: this.privateEventStore,
345
+ messageContextService: this.messageContextService,
346
+ contractSyncService: this.contractSyncService,
338
347
  jobId,
339
348
  scopes,
340
349
  });
@@ -362,7 +371,10 @@ export class ContractFunctionSimulator {
362
371
  });
363
372
 
364
373
  this.log.verbose(`Utility execution for ${call.to}.${call.selector} completed`);
365
- return witnessMapToFields(acirExecutionResult.returnWitness);
374
+ return {
375
+ result: witnessMapToFields(acirExecutionResult.returnWitness),
376
+ offchainEffects: oracle.getOffchainEffects(),
377
+ };
366
378
  } catch (err) {
367
379
  throw createSimulationError(err instanceof Error ? err : new Error('Unknown error during private execution'));
368
380
  }
@@ -432,14 +444,34 @@ export async function generateSimulatedProvingResult(
432
444
 
433
445
  let publicTeardownCallRequest;
434
446
 
447
+ // We set expiration timestamp to anchor_block_timestamp + MAX_TX_LIFETIME (24h) just like kernels do
448
+ let expirationTimestamp =
449
+ privateExecutionResult.entrypoint.publicInputs.anchorBlockHeader.globalVariables.timestamp +
450
+ BigInt(MAX_TX_LIFETIME);
451
+
452
+ let feePayer = AztecAddress.zero();
453
+
435
454
  const executions = [privateExecutionResult.entrypoint];
436
455
 
437
456
  while (executions.length !== 0) {
438
457
  const execution = executions.shift()!;
439
458
  executions.unshift(...execution!.nestedExecutionResults);
440
459
 
460
+ // Just like kernels we overwrite the default value if the call sets it.
461
+ const callExpirationTimestamp = execution.publicInputs.expirationTimestamp;
462
+ if (callExpirationTimestamp !== 0n && callExpirationTimestamp < expirationTimestamp) {
463
+ expirationTimestamp = callExpirationTimestamp;
464
+ }
465
+
441
466
  const { contractAddress } = execution.publicInputs.callContext;
442
467
 
468
+ if (execution.publicInputs.isFeePayer) {
469
+ if (!feePayer.isZero()) {
470
+ throw new Error('Multiple fee payers found in private execution result');
471
+ }
472
+ feePayer = contractAddress;
473
+ }
474
+
443
475
  scopedNoteHashes.push(
444
476
  ...execution.publicInputs.noteHashes
445
477
  .getActiveItems()
@@ -660,8 +692,8 @@ export async function generateSimulatedProvingResult(
660
692
  daGas: TX_DA_GAS_OVERHEAD,
661
693
  }),
662
694
  ),
663
- /*feePayer=*/ AztecAddress.zero(),
664
- /*expirationTimestamp=*/ 0n,
695
+ /*feePayer=*/ feePayer,
696
+ /*expirationTimestamp=*/ expirationTimestamp,
665
697
  hasPublicCalls ? inputsForPublic : undefined,
666
698
  !hasPublicCalls ? inputsForRollup : undefined,
667
699
  );
@@ -0,0 +1,110 @@
1
+ import { Fr } from '@aztec/foundation/curves/bn254';
2
+
3
+ /** In-memory store for ephemeral arrays scoped to a single contract call frame. */
4
+ export class EphemeralArrayService {
5
+ /**
6
+ * Maps a slot to the elements of the array stored at that slot. Each element is a serialized representation of
7
+ * the original type.
8
+ */
9
+ #arrays: Map<string, Fr[][]> = new Map();
10
+
11
+ /** Returns all elements in the array, or an empty array if uninitialized. */
12
+ readArrayAt(slot: Fr): Fr[][] {
13
+ return this.#arrays.get(slot.toString()) ?? [];
14
+ }
15
+
16
+ #setArray(slot: Fr, array: Fr[][]): void {
17
+ this.#arrays.set(slot.toString(), array);
18
+ }
19
+
20
+ /** Returns the number of elements in the array at the given slot. */
21
+ len(slot: Fr): number {
22
+ return this.readArrayAt(slot).length;
23
+ }
24
+
25
+ /** Appends an element to the array and returns the new length. */
26
+ push(slot: Fr, elements: Fr[]): number {
27
+ const array = this.readArrayAt(slot);
28
+ array.push(elements);
29
+ this.#setArray(slot, array);
30
+ return array.length;
31
+ }
32
+
33
+ /** Removes and returns the last element. Throws if empty. */
34
+ pop(slot: Fr): Fr[] {
35
+ const array = this.readArrayAt(slot);
36
+ if (array.length === 0) {
37
+ throw new Error(`Ephemeral array at slot ${slot} is empty`);
38
+ }
39
+ const element = array.pop()!;
40
+ this.#setArray(slot, array);
41
+ return element;
42
+ }
43
+
44
+ /** Returns the element at the given index. Throws if out of bounds. */
45
+ get(slot: Fr, index: number): Fr[] {
46
+ const array = this.readArrayAt(slot);
47
+ if (index < 0 || index >= array.length) {
48
+ throw new Error(
49
+ `Ephemeral array index ${index} out of bounds for array of length ${array.length} at slot ${slot}`,
50
+ );
51
+ }
52
+ return array[index];
53
+ }
54
+
55
+ /** Overwrites the element at the given index. Throws if out of bounds. */
56
+ set(slot: Fr, index: number, value: Fr[]): void {
57
+ const array = this.readArrayAt(slot);
58
+ if (index < 0 || index >= array.length) {
59
+ throw new Error(
60
+ `Ephemeral array index ${index} out of bounds for array of length ${array.length} at slot ${slot}`,
61
+ );
62
+ }
63
+ array[index] = value;
64
+ }
65
+
66
+ /** Removes the element at the given index, shifting subsequent elements backward. Throws if out of bounds. */
67
+ remove(slot: Fr, index: number): void {
68
+ const array = this.readArrayAt(slot);
69
+ if (index < 0 || index >= array.length) {
70
+ throw new Error(
71
+ `Ephemeral array index ${index} out of bounds for array of length ${array.length} at slot ${slot}`,
72
+ );
73
+ }
74
+ array.splice(index, 1);
75
+ }
76
+
77
+ /** Removes all elements from the array. */
78
+ clear(slot: Fr): void {
79
+ this.#arrays.delete(slot.toString());
80
+ }
81
+
82
+ /** Allocates a fresh, unused slot for a new ephemeral array. */
83
+ allocateSlot(): Fr {
84
+ let slot: Fr;
85
+ do {
86
+ slot = Fr.random();
87
+ } while (this.#arrays.has(slot.toString()));
88
+ return slot;
89
+ }
90
+
91
+ /** Creates a new ephemeral array pre-populated with the given elements and returns its slot. */
92
+ newArray(elements: Fr[][]): Fr {
93
+ const slot = this.allocateSlot();
94
+ this.#setArray(slot, elements);
95
+ return slot;
96
+ }
97
+
98
+ /** Copies `count` elements from the source array to the destination array (overwrites destination). */
99
+ copy(srcSlot: Fr, dstSlot: Fr, count: number): void {
100
+ const srcArray = this.readArrayAt(srcSlot);
101
+ if (count > srcArray.length) {
102
+ throw new Error(
103
+ `Cannot copy ${count} elements from ephemeral array of length ${srcArray.length} at slot ${srcSlot}`,
104
+ );
105
+ }
106
+ // Deep copy the elements to avoid aliasing
107
+ const copied = srcArray.slice(0, count).map(el => [...el]);
108
+ this.#setArray(dstSlot, copied);
109
+ }
110
+ }
@@ -1,32 +1,37 @@
1
- import { ExtendedDirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
1
+ import { ExtendedDirectionalAppTaggingSecret, type TaggingIndexRange } from '@aztec/stdlib/logs';
2
2
 
3
3
  /**
4
- * A map that stores the tagging index for a given extended directional app tagging secret.
4
+ * A map that stores the tagging index range for a given extended directional app tagging secret.
5
5
  * Note: The directional app tagging secret is unique for a (sender, recipient, contract) tuple while the direction
6
6
  * of sender -> recipient matters.
7
7
  */
8
8
  export class ExecutionTaggingIndexCache {
9
- private taggingIndexMap: Map<string, number> = new Map();
9
+ private taggingIndexMap: Map<string, { lowestIndex: number; highestIndex: number }> = new Map();
10
10
 
11
11
  public getLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret): number | undefined {
12
- return this.taggingIndexMap.get(secret.toString());
12
+ return this.taggingIndexMap.get(secret.toString())?.highestIndex;
13
13
  }
14
14
 
15
15
  public setLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret, index: number) {
16
16
  const currentValue = this.taggingIndexMap.get(secret.toString());
17
- if (currentValue !== undefined && currentValue !== index - 1) {
18
- throw new Error(`Invalid tagging index update. Current value: ${currentValue}, new value: ${index}`);
17
+ if (currentValue !== undefined && currentValue.highestIndex !== index - 1) {
18
+ throw new Error(`Invalid tagging index update. Current value: ${currentValue.highestIndex}, new value: ${index}`);
19
+ }
20
+ if (currentValue !== undefined) {
21
+ currentValue.highestIndex = index;
22
+ } else {
23
+ this.taggingIndexMap.set(secret.toString(), { lowestIndex: index, highestIndex: index });
19
24
  }
20
- this.taggingIndexMap.set(secret.toString(), index);
21
25
  }
22
26
 
23
27
  /**
24
- * Returns the pre-tags that were used in this execution (and that need to be stored in the db).
28
+ * Returns the tagging index ranges that were used in this execution (and that need to be stored in the db).
25
29
  */
26
- public getUsedPreTags(): PreTag[] {
27
- return Array.from(this.taggingIndexMap.entries()).map(([secret, index]) => ({
30
+ public getUsedTaggingIndexRanges(): TaggingIndexRange[] {
31
+ return Array.from(this.taggingIndexMap.entries()).map(([secret, { lowestIndex, highestIndex }]) => ({
28
32
  extendedSecret: ExtendedDirectionalAppTaggingSecret.fromString(secret),
29
- index,
33
+ lowestIndex,
34
+ highestIndex,
30
35
  }));
31
36
  }
32
37
  }
@@ -4,6 +4,7 @@ export { HashedValuesCache } from './hashed_values_cache.js';
4
4
  export { pickNotes } from './pick_notes.js';
5
5
  export type { NoteData, IMiscOracle, IUtilityExecutionOracle, IPrivateExecutionOracle } from './oracle/interfaces.js';
6
6
  export { MessageLoadOracleInputs } from './oracle/message_load_oracle_inputs.js';
7
+ export { MessageContextService } from '../messages/message_context_service.js';
7
8
  export { UtilityExecutionOracle } from './oracle/utility_execution_oracle.js';
8
9
  export { PrivateExecutionOracle } from './oracle/private_execution_oracle.js';
9
10
  export { Oracle } from './oracle/oracle.js';
@@ -4,12 +4,9 @@ import { EventSelector } from '@aztec/stdlib/abi';
4
4
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import { TxHash } from '@aztec/stdlib/tx';
6
6
 
7
- // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
8
- const MAX_EVENT_SERIALIZED_LEN = 10;
9
-
10
7
  /**
11
8
  * Intermediate struct used to perform batch event validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
12
- * expects for values of this type to be stored in a `CapsuleArray`.
9
+ * expects for values of this type to be stored in a `EphemeralArray`.
13
10
  */
14
11
  export class EventValidationRequest {
15
12
  constructor(
@@ -19,10 +16,9 @@ export class EventValidationRequest {
19
16
  public serializedEvent: Fr[],
20
17
  public eventCommitment: Fr,
21
18
  public txHash: TxHash,
22
- public recipient: AztecAddress,
23
19
  ) {}
24
20
 
25
- static fromFields(fields: Fr[] | FieldReader): EventValidationRequest {
21
+ static fromFields(fields: Fr[], maxEventSerializedLen: number): EventValidationRequest {
26
22
  const reader = FieldReader.asReader(fields);
27
23
 
28
24
  const contractAddress = AztecAddress.fromField(reader.readField());
@@ -30,13 +26,18 @@ export class EventValidationRequest {
30
26
 
31
27
  const randomness = reader.readField();
32
28
 
33
- const eventStorage = reader.readFieldArray(MAX_EVENT_SERIALIZED_LEN);
29
+ const eventStorage = reader.readFieldArray(maxEventSerializedLen);
34
30
  const eventLen = reader.readField().toNumber();
35
31
  const serializedEvent = eventStorage.slice(0, eventLen);
36
32
 
37
33
  const eventCommitment = reader.readField();
38
34
  const txHash = TxHash.fromField(reader.readField());
39
- const recipient = AztecAddress.fromField(reader.readField());
35
+
36
+ if (reader.remainingFields() !== 0) {
37
+ throw new Error(
38
+ `Error converting array of fields to EventValidationRequest: expected ${reader.cursor} fields but received ${fields.length} (maxEventSerializedLen=${maxEventSerializedLen}).`,
39
+ );
40
+ }
40
41
 
41
42
  return new EventValidationRequest(
42
43
  contractAddress,
@@ -45,7 +46,6 @@ export class EventValidationRequest {
45
46
  serializedEvent,
46
47
  eventCommitment,
47
48
  txHash,
48
- recipient,
49
49
  );
50
50
  }
51
51
  }
@@ -5,7 +5,7 @@ import { Tag } from '@aztec/stdlib/logs';
5
5
 
6
6
  /**
7
7
  * Intermediate struct used to perform batch log retrieval by PXE. The `utilityBulkRetrieveLogs` oracle expects values of this
8
- * type to be stored in a `CapsuleArray`.
8
+ * type to be stored in a `EphemeralArray`.
9
9
  */
10
10
  export class LogRetrievalRequest {
11
11
  constructor(
@@ -3,14 +3,11 @@ import { range } from '@aztec/foundation/array';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import type { TxHash } from '@aztec/stdlib/tx';
5
5
 
6
- import { MAX_NOTE_PACKED_LEN } from './note_validation_request.js';
7
-
8
- const MAX_PUBLIC_LOG_LEN_FOR_NOTE_COMPLETION = MAX_NOTE_PACKED_LEN;
9
- const MAX_LOG_CONTENT_LEN = Math.max(MAX_PUBLIC_LOG_LEN_FOR_NOTE_COMPLETION, PRIVATE_LOG_CIPHERTEXT_LEN);
6
+ const MAX_LOG_CONTENT_LEN = PRIVATE_LOG_CIPHERTEXT_LEN;
10
7
 
11
8
  /**
12
9
  * Intermediate struct used to perform batch log retrieval by PXE. The `utilityBulkRetrieveLogs` oracle stores values of this
13
- * type in a `CapsuleArray`.
10
+ * type in a `EphemeralArray`.
14
11
  */
15
12
  export class LogRetrievalResponse {
16
13
  constructor(
@@ -3,12 +3,9 @@ import { FieldReader } from '@aztec/foundation/serialize';
3
3
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import { TxHash } from '@aztec/stdlib/tx';
5
5
 
6
- // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
7
- export const MAX_NOTE_PACKED_LEN = 8;
8
-
9
6
  /**
10
7
  * Intermediate struct used to perform batch note validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
11
- * expects for values of this type to be stored in a `CapsuleArray`.
8
+ * expects for values of this type to be stored in a `EphemeralArray`.
12
9
  */
13
10
  export class NoteValidationRequest {
14
11
  constructor(
@@ -21,10 +18,9 @@ export class NoteValidationRequest {
21
18
  public noteHash: Fr,
22
19
  public nullifier: Fr,
23
20
  public txHash: TxHash,
24
- public recipient: AztecAddress,
25
21
  ) {}
26
22
 
27
- static fromFields(fields: Fr[] | FieldReader): NoteValidationRequest {
23
+ static fromFields(fields: Fr[], maxNotePackedLen: number): NoteValidationRequest {
28
24
  const reader = FieldReader.asReader(fields);
29
25
 
30
26
  const contractAddress = AztecAddress.fromField(reader.readField());
@@ -33,18 +29,17 @@ export class NoteValidationRequest {
33
29
  const randomness = reader.readField();
34
30
  const noteNonce = reader.readField();
35
31
 
36
- const contentStorage = reader.readFieldArray(MAX_NOTE_PACKED_LEN);
32
+ const contentStorage = reader.readFieldArray(maxNotePackedLen);
37
33
  const contentLen = reader.readField().toNumber();
38
34
  const content = contentStorage.slice(0, contentLen);
39
35
 
40
36
  const noteHash = reader.readField();
41
37
  const nullifier = reader.readField();
42
38
  const txHash = TxHash.fromField(reader.readField());
43
- const recipient = AztecAddress.fromField(reader.readField());
44
39
 
45
40
  if (reader.remainingFields() !== 0) {
46
41
  throw new Error(
47
- `Error converting array of fields to NoteValidationRequest. Hint: check that MAX_NOTE_PACKED_LEN is consistent with private_notes::MAX_NOTE_PACKED_LEN in Aztec-nr.`,
42
+ `Error converting array of fields to NoteValidationRequest: expected ${reader.cursor} fields but received ${fields.length} (maxNotePackedLen=${maxNotePackedLen}).`,
48
43
  );
49
44
  }
50
45
 
@@ -58,7 +53,6 @@ export class NoteValidationRequest {
58
53
  noteHash,
59
54
  nullifier,
60
55
  txHash,
61
- recipient,
62
56
  );
63
57
  }
64
58
  }