@aztec/pxe 0.0.1-commit.d431d1c → 0.0.1-commit.e3c1de76

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 (175) hide show
  1. package/dest/bin/check_oracle_version.js +1 -1
  2. package/dest/block_synchronizer/block_synchronizer.d.ts +7 -5
  3. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  4. package/dest/block_synchronizer/block_synchronizer.js +56 -16
  5. package/dest/config/index.d.ts +3 -1
  6. package/dest/config/index.d.ts.map +1 -1
  7. package/dest/config/index.js +17 -0
  8. package/dest/contract_function_simulator/contract_function_simulator.d.ts +2 -4
  9. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/contract_function_simulator.js +8 -13
  11. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +1 -1
  12. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +1 -1
  13. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +1 -1
  14. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +1 -1
  15. package/dest/contract_function_simulator/oracle/interfaces.d.ts +13 -10
  16. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/oracle/oracle.d.ts +5 -3
  18. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/oracle/oracle.js +27 -17
  20. package/dest/contract_function_simulator/oracle/private_execution.d.ts +2 -22
  21. package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/oracle/private_execution.js +0 -37
  23. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +10 -3
  24. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  25. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +19 -8
  26. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +21 -15
  27. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  28. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +39 -43
  29. package/dest/contract_sync/index.d.ts +23 -0
  30. package/dest/contract_sync/index.d.ts.map +1 -0
  31. package/dest/contract_sync/index.js +54 -0
  32. package/dest/debug/pxe_debug_utils.d.ts +16 -6
  33. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  34. package/dest/debug/pxe_debug_utils.js +20 -10
  35. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  36. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  37. package/dest/entrypoints/client/bundle/utils.js +12 -6
  38. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  39. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  40. package/dest/entrypoints/client/lazy/utils.js +13 -7
  41. package/dest/entrypoints/pxe_creation_options.d.ts +3 -2
  42. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  43. package/dest/entrypoints/server/index.d.ts +2 -1
  44. package/dest/entrypoints/server/index.d.ts.map +1 -1
  45. package/dest/entrypoints/server/index.js +1 -0
  46. package/dest/entrypoints/server/utils.d.ts +1 -1
  47. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  48. package/dest/entrypoints/server/utils.js +19 -8
  49. package/dest/events/event_service.d.ts +5 -6
  50. package/dest/events/event_service.d.ts.map +1 -1
  51. package/dest/events/event_service.js +6 -7
  52. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  53. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  54. package/dest/job_coordinator/job_coordinator.js +3 -2
  55. package/dest/logs/log_service.d.ts +5 -4
  56. package/dest/logs/log_service.d.ts.map +1 -1
  57. package/dest/logs/log_service.js +18 -15
  58. package/dest/notes/note_service.d.ts +6 -6
  59. package/dest/notes/note_service.d.ts.map +1 -1
  60. package/dest/notes/note_service.js +14 -14
  61. package/dest/oracle_version.d.ts +3 -3
  62. package/dest/oracle_version.d.ts.map +1 -1
  63. package/dest/oracle_version.js +4 -3
  64. package/dest/private_kernel/private_kernel_execution_prover.d.ts +3 -2
  65. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  66. package/dest/private_kernel/private_kernel_execution_prover.js +2 -2
  67. package/dest/private_kernel/private_kernel_oracle.d.ts +3 -3
  68. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  69. package/dest/pxe.d.ts +1 -1
  70. package/dest/pxe.d.ts.map +1 -1
  71. package/dest/pxe.js +19 -15
  72. package/dest/storage/address_store/address_store.d.ts +1 -1
  73. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  74. package/dest/storage/address_store/address_store.js +12 -11
  75. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  76. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  77. package/dest/storage/anchor_block_store/anchor_block_store.js +8 -1
  78. package/dest/storage/capsule_store/capsule_store.js +6 -8
  79. package/dest/storage/contract_store/contract_store.d.ts +1 -2
  80. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  81. package/dest/storage/contract_store/contract_store.js +22 -25
  82. package/dest/storage/metadata.d.ts +1 -1
  83. package/dest/storage/metadata.js +1 -1
  84. package/dest/storage/note_store/note_store.d.ts +48 -50
  85. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  86. package/dest/storage/note_store/note_store.js +276 -252
  87. package/dest/storage/note_store/stored_note.d.ts +16 -0
  88. package/dest/storage/note_store/stored_note.d.ts.map +1 -0
  89. package/dest/storage/note_store/stored_note.js +43 -0
  90. package/dest/storage/private_event_store/private_event_store.d.ts +17 -4
  91. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  92. package/dest/storage/private_event_store/private_event_store.js +198 -147
  93. package/dest/storage/private_event_store/stored_private_event.d.ts +23 -0
  94. package/dest/storage/private_event_store/stored_private_event.d.ts.map +1 -0
  95. package/dest/storage/private_event_store/stored_private_event.js +56 -0
  96. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +1 -1
  97. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  98. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  99. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  100. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  101. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  102. package/dest/storage/tagging_store/sender_tagging_store.d.ts +1 -1
  103. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  104. package/dest/storage/tagging_store/sender_tagging_store.js +183 -113
  105. package/dest/tagging/get_all_logs_by_tags.d.ts +24 -0
  106. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -0
  107. package/dest/tagging/get_all_logs_by_tags.js +46 -0
  108. package/dest/tagging/index.d.ts +2 -1
  109. package/dest/tagging/index.d.ts.map +1 -1
  110. package/dest/tagging/index.js +1 -0
  111. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +3 -2
  112. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  113. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +2 -2
  114. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +3 -2
  115. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  116. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +5 -2
  117. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +3 -2
  118. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  119. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +2 -2
  120. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +1 -1
  121. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  122. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +5 -8
  123. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +3 -2
  124. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  125. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +7 -4
  126. package/package.json +16 -16
  127. package/src/bin/check_oracle_version.ts +1 -0
  128. package/src/block_synchronizer/block_synchronizer.ts +70 -33
  129. package/src/config/index.ts +14 -0
  130. package/src/contract_function_simulator/contract_function_simulator.ts +7 -15
  131. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +1 -1
  132. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +1 -1
  133. package/src/contract_function_simulator/oracle/interfaces.ts +18 -9
  134. package/src/contract_function_simulator/oracle/oracle.ts +34 -21
  135. package/src/contract_function_simulator/oracle/private_execution.ts +1 -60
  136. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +32 -10
  137. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +59 -51
  138. package/src/contract_sync/index.ts +98 -0
  139. package/src/debug/pxe_debug_utils.ts +26 -11
  140. package/src/entrypoints/client/bundle/utils.ts +7 -14
  141. package/src/entrypoints/client/lazy/utils.ts +8 -14
  142. package/src/entrypoints/pxe_creation_options.ts +2 -1
  143. package/src/entrypoints/server/index.ts +1 -0
  144. package/src/entrypoints/server/utils.ts +15 -19
  145. package/src/events/event_service.ts +5 -7
  146. package/src/job_coordinator/job_coordinator.ts +4 -3
  147. package/src/logs/log_service.ts +29 -13
  148. package/src/notes/note_service.ts +21 -20
  149. package/src/oracle_version.ts +4 -3
  150. package/src/private_kernel/private_kernel_execution_prover.ts +6 -3
  151. package/src/private_kernel/private_kernel_oracle.ts +2 -2
  152. package/src/pxe.ts +48 -17
  153. package/src/storage/address_store/address_store.ts +15 -15
  154. package/src/storage/anchor_block_store/anchor_block_store.ts +8 -0
  155. package/src/storage/capsule_store/capsule_store.ts +8 -8
  156. package/src/storage/contract_store/contract_store.ts +22 -31
  157. package/src/storage/metadata.ts +1 -1
  158. package/src/storage/note_store/note_store.ts +314 -318
  159. package/src/storage/note_store/stored_note.ts +48 -0
  160. package/src/storage/private_event_store/private_event_store.ts +250 -190
  161. package/src/storage/private_event_store/stored_private_event.ts +73 -0
  162. package/src/storage/tagging_store/recipient_tagging_store.ts +31 -21
  163. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  164. package/src/storage/tagging_store/sender_tagging_store.ts +210 -126
  165. package/src/tagging/get_all_logs_by_tags.ts +68 -0
  166. package/src/tagging/index.ts +1 -0
  167. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +11 -1
  168. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +7 -1
  169. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +3 -1
  170. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +5 -17
  171. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +12 -3
  172. package/dest/tree_membership/tree_membership_service.d.ts +0 -50
  173. package/dest/tree_membership/tree_membership_service.d.ts.map +0 -1
  174. package/dest/tree_membership/tree_membership_service.js +0 -75
  175. package/src/tree_membership/tree_membership_service.ts +0 -97
@@ -0,0 +1,98 @@
1
+ import { ProtocolContractAddress, isProtocolContract } from '@aztec/protocol-contracts';
2
+ import type { FunctionCall, FunctionSelector } from '@aztec/stdlib/abi';
3
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
+ import type { ContractInstance } from '@aztec/stdlib/contract';
5
+ import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '@aztec/stdlib/delayed-public-mutable';
6
+ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
7
+ import type { BlockHeader } from '@aztec/stdlib/tx';
8
+
9
+ import type { ContractStore } from '../storage/contract_store/contract_store.js';
10
+
11
+ /**
12
+ * Read the current class id of a contract from the execution data provider or AztecNode. If not found, class id
13
+ * from the instance is used.
14
+ * @param contractAddress - The address of the contract to read the class id for.
15
+ * @param instance - The instance of the contract.
16
+ * @param aztecNode - The Aztec node to query for storage.
17
+ * @param header - The header of the block at which to load the DelayedPublicMutable storing the class id.
18
+ * @returns The current class id.
19
+ */
20
+ export async function readCurrentClassId(
21
+ contractAddress: AztecAddress,
22
+ instance: ContractInstance,
23
+ aztecNode: AztecNode,
24
+ header: BlockHeader,
25
+ ) {
26
+ const blockHash = await header.hash();
27
+ const timestamp = header.globalVariables.timestamp;
28
+ const { delayedPublicMutableSlot } = await DelayedPublicMutableValuesWithHash.getContractUpdateSlots(contractAddress);
29
+ const delayedPublicMutableValues = await DelayedPublicMutableValues.readFromTree(delayedPublicMutableSlot, slot =>
30
+ aztecNode.getPublicStorageAt(blockHash, ProtocolContractAddress.ContractInstanceRegistry, slot),
31
+ );
32
+ let currentClassId = delayedPublicMutableValues.svc.getCurrentAt(timestamp)[0];
33
+ if (currentClassId.isZero()) {
34
+ currentClassId = instance.originalContractClassId;
35
+ }
36
+ return currentClassId;
37
+ }
38
+
39
+ export async function syncState(
40
+ contractAddress: AztecAddress,
41
+ contractStore: ContractStore,
42
+ functionToInvokeAfterSync: FunctionSelector | null,
43
+ utilityExecutor: (privateSyncCall: FunctionCall) => Promise<any>,
44
+ ) {
45
+ // Protocol contracts don't have private state to sync
46
+ if (!isProtocolContract(contractAddress)) {
47
+ const syncStateFunctionCall = await contractStore.getFunctionCall('sync_state', [], contractAddress);
48
+ if (functionToInvokeAfterSync && functionToInvokeAfterSync.equals(syncStateFunctionCall.selector)) {
49
+ throw new Error(
50
+ 'Forbidden `sync_state` invocation. `sync_state` can only be invoked by PXE, manual execution can lead to inconsistencies.',
51
+ );
52
+ }
53
+
54
+ return utilityExecutor(syncStateFunctionCall);
55
+ }
56
+ }
57
+
58
+ /**
59
+ * Verify that the current class id of a contract obtained from AztecNode is the same as the one in contract data
60
+ * provider (i.e. PXE's own storage).
61
+ * @param header - The header of the block at which to verify the current class id.
62
+ */
63
+ async function verifyCurrentClassId(
64
+ contractAddress: AztecAddress,
65
+ aztecNode: AztecNode,
66
+ contractStore: ContractStore,
67
+ header: BlockHeader,
68
+ ) {
69
+ const instance = await contractStore.getContractInstance(contractAddress);
70
+ if (!instance) {
71
+ throw new Error(`No contract instance found for address ${contractAddress.toString()}`);
72
+ }
73
+
74
+ const currentClassId = await readCurrentClassId(contractAddress, instance, aztecNode, header);
75
+ if (!instance.currentContractClassId.equals(currentClassId)) {
76
+ throw new Error(
77
+ `Contract ${contractAddress} is outdated, current class id is ${currentClassId}, local class id is ${instance.currentContractClassId}`,
78
+ );
79
+ }
80
+ }
81
+
82
+ /**
83
+ * Ensures the contract's private state is synchronized and that the PXE holds the current class artifact for
84
+ * the contract.
85
+ */
86
+ export async function ensureContractSynced(
87
+ contractAddress: AztecAddress,
88
+ functionToInvokeAfterSync: FunctionSelector | null,
89
+ utilityExecutor: (call: FunctionCall) => Promise<any>,
90
+ aztecNode: AztecNode,
91
+ contractStore: ContractStore,
92
+ header: BlockHeader,
93
+ ): Promise<void> {
94
+ await Promise.all([
95
+ syncState(contractAddress, contractStore, functionToInvokeAfterSync, utilityExecutor),
96
+ verifyCurrentClassId(contractAddress, aztecNode, contractStore, header),
97
+ ]);
98
+ }
@@ -1,7 +1,11 @@
1
+ import { randomBytes } from '@aztec/foundation/crypto/random';
1
2
  import type { NoteDao, NotesFilter } from '@aztec/stdlib/note';
3
+ import type { BlockHeader } from '@aztec/stdlib/tx';
2
4
 
5
+ import type { BlockSynchronizer } from '../block_synchronizer/block_synchronizer.js';
3
6
  import type { PXE } from '../pxe.js';
4
7
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
8
+ import type { AnchorBlockStore } from '../storage/index.js';
5
9
  import type { NoteStore } from '../storage/note_store/note_store.js';
6
10
 
7
11
  /**
@@ -9,18 +13,20 @@ import type { NoteStore } from '../storage/note_store/note_store.js';
9
13
  * No backwards compatibility or API stability should be expected. Use at your own risk.
10
14
  */
11
15
  export class PXEDebugUtils {
12
- #pxe: PXE | undefined = undefined;
16
+ #pxe!: PXE;
17
+ #putJobInQueue!: <T>(job: (jobId: string) => Promise<T>) => Promise<T>;
13
18
 
14
19
  constructor(
15
20
  private contractStore: ContractStore,
16
21
  private noteStore: NoteStore,
22
+ private blockStateSynchronizer: BlockSynchronizer,
23
+ private anchorBlockStore: AnchorBlockStore,
17
24
  ) {}
18
25
 
19
- /**
20
- * Not injected through constructor since they're are co-dependant.
21
- */
22
- public setPXE(pxe: PXE) {
26
+ /** Not injected through constructor since they're are co-dependant */
27
+ public setPXE(pxe: PXE, putJobInQueue: <T>(job: (jobId: string) => Promise<T>) => Promise<T>) {
23
28
  this.#pxe = pxe;
29
+ this.#putJobInQueue = putJobInQueue;
24
30
  }
25
31
 
26
32
  /**
@@ -35,14 +41,23 @@ export class PXEDebugUtils {
35
41
  * @returns The requested notes.
36
42
  */
37
43
  public async getNotes(filter: NotesFilter): Promise<NoteDao[]> {
38
- if (!this.#pxe) {
39
- throw new Error('Cannot getNotes because no PXE is set');
40
- }
41
-
42
44
  // We need to manually trigger private state sync to have a guarantee that all the notes are available.
43
- const call = await this.contractStore.getFunctionCall('sync_private_state', [], filter.contractAddress);
45
+ const call = await this.contractStore.getFunctionCall('sync_state', [], filter.contractAddress);
44
46
  await this.#pxe.simulateUtility(call);
45
47
 
46
- return this.noteStore.getNotes(filter);
48
+ return this.noteStore.getNotes(filter, randomBytes(8).toString('hex'));
49
+ }
50
+
51
+ /** Returns the block header up to which the PXE has synced. */
52
+ public getSyncedBlockHeader(): Promise<BlockHeader> {
53
+ return this.anchorBlockStore.getBlockHeader();
54
+ }
55
+
56
+ /**
57
+ * Triggers a sync of the PXE with the node.
58
+ * Blocks until the sync is complete.
59
+ */
60
+ public sync(): Promise<void> {
61
+ return this.#putJobInQueue(() => this.blockStateSynchronizer.sync());
47
62
  }
48
63
  }
@@ -1,6 +1,5 @@
1
1
  import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
2
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
3
- import { randomBytes } from '@aztec/foundation/crypto/random';
4
3
  import { createLogger } from '@aztec/foundation/log';
5
4
  import { createStore } from '@aztec/kv-store/indexeddb';
6
5
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
@@ -9,6 +8,7 @@ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
9
8
 
10
9
  import type { PXEConfig } from '../../../config/index.js';
11
10
  import { PXE } from '../../../pxe.js';
11
+ import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
12
  import type { PXECreationOptions } from '../../pxe_creation_options.js';
13
13
 
14
14
  /**
@@ -26,13 +26,7 @@ export async function createPXE(
26
26
  config: PXEConfig,
27
27
  options: PXECreationOptions = { loggers: {} },
28
28
  ) {
29
- const logSuffix =
30
- typeof options.useLogSuffix === 'boolean'
31
- ? options.useLogSuffix
32
- ? randomBytes(3).toString('hex')
33
- : undefined
34
- : options.useLogSuffix;
35
-
29
+ const actor = options.loggerActorLabel;
36
30
  const loggers = options.loggers ?? {};
37
31
 
38
32
  const l1Contracts = await aztecNode.getL1ContractAddresses();
@@ -41,14 +35,13 @@ export async function createPXE(
41
35
  l1Contracts,
42
36
  } as PXEConfig;
43
37
 
44
- const storeLogger = loggers.store ? loggers.store : createLogger('pxe:data:idb' + (logSuffix ? `:${logSuffix}` : ''));
38
+ const storeLogger = loggers.store ?? createLogger('pxe:data:idb', { actor });
45
39
 
46
- const store = options.store ?? (await createStore('pxe_data', configWithContracts, storeLogger));
40
+ const store =
41
+ options.store ?? (await createStore('pxe_data', configWithContracts, PXE_DATA_SCHEMA_VERSION, storeLogger));
47
42
 
48
43
  const simulator = options.simulator ?? new WASMSimulator();
49
- const proverLogger = loggers.prover
50
- ? loggers.prover
51
- : createLogger('pxe:bb:wasm:bundle' + (logSuffix ? `:${logSuffix}` : ''));
44
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
52
45
 
53
46
  let prover;
54
47
  if (options.proverOrOptions instanceof BBPrivateKernelProver) {
@@ -58,7 +51,7 @@ export async function createPXE(
58
51
  }
59
52
  const protocolContractsProvider = new BundledProtocolContractsProvider();
60
53
 
61
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
54
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
62
55
  const pxe = await PXE.create(aztecNode, store, prover, simulator, protocolContractsProvider, config, pxeLogger);
63
56
  return pxe;
64
57
  }
@@ -1,6 +1,5 @@
1
1
  import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
2
  import { BBLazyPrivateKernelProver } from '@aztec/bb-prover/client/lazy';
3
- import { randomBytes } from '@aztec/foundation/crypto/random';
4
3
  import { createLogger } from '@aztec/foundation/log';
5
4
  import { createStore } from '@aztec/kv-store/indexeddb';
6
5
  import { LazyProtocolContractsProvider } from '@aztec/protocol-contracts/providers/lazy';
@@ -9,6 +8,7 @@ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
9
8
 
10
9
  import type { PXEConfig } from '../../../config/index.js';
11
10
  import { PXE } from '../../../pxe.js';
11
+ import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
12
  import type { PXECreationOptions } from '../../pxe_creation_options.js';
13
13
 
14
14
  /**
@@ -17,7 +17,7 @@ import type { PXECreationOptions } from '../../pxe_creation_options.js';
17
17
  *
18
18
  * @param aztecNode - The AztecNode instance to be used by the server.
19
19
  * @param config - The PXE Config to use
20
- * @param
20
+ * @param options - (Optional) Optional information for creating an PXE.
21
21
  * @returns A Promise that resolves to the started PXE instance.
22
22
  */
23
23
  export async function createPXE(
@@ -25,12 +25,7 @@ export async function createPXE(
25
25
  config: PXEConfig,
26
26
  options: PXECreationOptions = { loggers: {} },
27
27
  ) {
28
- const logSuffix =
29
- typeof options.useLogSuffix === 'boolean'
30
- ? options.useLogSuffix
31
- ? randomBytes(3).toString('hex')
32
- : undefined
33
- : options.useLogSuffix;
28
+ const actor = options.loggerActorLabel;
34
29
 
35
30
  const l1Contracts = await aztecNode.getL1ContractAddresses();
36
31
  const configWithContracts = {
@@ -40,14 +35,13 @@ export async function createPXE(
40
35
 
41
36
  const loggers = options.loggers ?? {};
42
37
 
43
- const storeLogger = loggers.store ? loggers.store : createLogger('pxe:data:idb' + (logSuffix ? `:${logSuffix}` : ''));
38
+ const storeLogger = loggers.store ?? createLogger('pxe:data:idb', { actor });
44
39
 
45
- const store = options.store ?? (await createStore('pxe_data', configWithContracts, storeLogger));
40
+ const store =
41
+ options.store ?? (await createStore('pxe_data', configWithContracts, PXE_DATA_SCHEMA_VERSION, storeLogger));
46
42
 
47
43
  const simulator = options.simulator ?? new WASMSimulator();
48
- const proverLogger = loggers.prover
49
- ? loggers.prover
50
- : createLogger('pxe:bb:wasm:bundle' + (logSuffix ? `:${logSuffix}` : ''));
44
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
51
45
 
52
46
  let prover;
53
47
  if (options.proverOrOptions instanceof BBPrivateKernelProver) {
@@ -57,7 +51,7 @@ export async function createPXE(
57
51
  }
58
52
  const protocolContractsProvider = new LazyProtocolContractsProvider();
59
53
 
60
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
54
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
61
55
  const pxe = await PXE.create(aztecNode, store, prover, simulator, protocolContractsProvider, config, pxeLogger);
62
56
  return pxe;
63
57
  }
@@ -6,7 +6,8 @@ import type { PrivateKernelProver } from '@aztec/stdlib/interfaces/client';
6
6
 
7
7
  export type PXECreationOptions = {
8
8
  loggers?: { store?: Logger; pxe?: Logger; prover?: Logger };
9
- useLogSuffix?: boolean | string;
9
+ /** Actor label to include in log output (e.g., 'pxe-0', 'pxe-test'). */
10
+ loggerActorLabel?: string;
10
11
  proverOrOptions?: PrivateKernelProver | BBPrivateKernelProverOptions;
11
12
  store?: AztecAsyncKVStore;
12
13
  simulator?: CircuitSimulator;
@@ -7,3 +7,4 @@ export { NoteService } from '../../notes/note_service.js';
7
7
  export { ORACLE_VERSION } from '../../oracle_version.js';
8
8
  export { type PXECreationOptions } from '../pxe_creation_options.js';
9
9
  export { JobCoordinator } from '../../job_coordinator/job_coordinator.js';
10
+ export { syncState } from '../../contract_sync/index.js';
@@ -1,6 +1,5 @@
1
1
  import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
2
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
3
- import { randomBytes } from '@aztec/foundation/crypto/random';
4
3
  import { createLogger } from '@aztec/foundation/log';
5
4
  import { createStore } from '@aztec/kv-store/lmdb-v2';
6
5
  import { BundledProtocolContractsProvider } from '@aztec/protocol-contracts/providers/bundle';
@@ -20,17 +19,13 @@ export async function createPXE(
20
19
  config: PXEConfigWithoutDefaults,
21
20
  options: PXECreationOptions = { loggers: {} },
22
21
  ) {
22
+ const actor = options.loggerActorLabel;
23
+ const recorderLogger = createLogger('simulator:acvm:recording', { actor });
23
24
  const recorder = process.env.CIRCUIT_RECORD_DIR
24
- ? new FileCircuitRecorder(process.env.CIRCUIT_RECORD_DIR)
25
- : new MemoryCircuitRecorder();
26
- const simulator = new SimulatorRecorderWrapper(new WASMSimulator(), recorder);
27
-
28
- const logSuffix =
29
- typeof options.useLogSuffix === 'boolean'
30
- ? options.useLogSuffix
31
- ? randomBytes(3).toString('hex')
32
- : undefined
33
- : options.useLogSuffix;
25
+ ? new FileCircuitRecorder(process.env.CIRCUIT_RECORD_DIR, recorderLogger)
26
+ : new MemoryCircuitRecorder(recorderLogger);
27
+ const simulatorLogger = createLogger('wasm-simulator', { actor });
28
+ const simulator = new SimulatorRecorderWrapper(new WASMSimulator(simulatorLogger), recorder);
34
29
  const loggers = options.loggers ?? {};
35
30
 
36
31
  const { l1ChainId, l1ContractAddresses: l1Contracts, rollupVersion } = await aztecNode.getNodeInfo();
@@ -43,14 +38,15 @@ export async function createPXE(
43
38
  };
44
39
 
45
40
  if (!options.store) {
46
- const storeLogger = loggers.store
47
- ? loggers.store
48
- : createLogger('pxe:data:lmdb' + (logSuffix ? `:${logSuffix}` : ''));
49
- options.store = await createStore('pxe_data', PXE_DATA_SCHEMA_VERSION, configWithContracts, storeLogger);
41
+ const storeLogger = loggers.store ?? createLogger('pxe:data:lmdb', { actor });
42
+ options.store = await createStore(
43
+ 'pxe_data',
44
+ PXE_DATA_SCHEMA_VERSION,
45
+ configWithContracts,
46
+ storeLogger.getBindings(),
47
+ );
50
48
  }
51
- const proverLogger = loggers.prover
52
- ? loggers.prover
53
- : createLogger('pxe:bb:native' + (logSuffix ? `:${logSuffix}` : ''));
49
+ const proverLogger = loggers.prover ?? createLogger('pxe:bb:native', { actor });
54
50
 
55
51
  let prover;
56
52
  if (options.proverOrOptions instanceof BBPrivateKernelProver) {
@@ -61,7 +57,7 @@ export async function createPXE(
61
57
 
62
58
  const protocolContractsProvider = new BundledProtocolContractsProvider();
63
59
 
64
- const pxeLogger = loggers.pxe ? loggers.pxe : createLogger('pxe:service' + (logSuffix ? `:${logSuffix}` : ''));
60
+ const pxeLogger = loggers.pxe ?? createLogger('pxe:service', { actor });
65
61
  const pxe = await PXE.create(
66
62
  aztecNode,
67
63
  options.store,
@@ -3,20 +3,19 @@ import type { EventSelector } from '@aztec/stdlib/abi';
3
3
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import { siloNullifier } from '@aztec/stdlib/hash';
5
5
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
6
- import type { TxHash } from '@aztec/stdlib/tx';
6
+ import type { BlockHeader, TxHash } from '@aztec/stdlib/tx';
7
7
 
8
- import { AnchorBlockStore } from '../storage/anchor_block_store/anchor_block_store.js';
9
8
  import { PrivateEventStore } from '../storage/private_event_store/private_event_store.js';
10
9
 
11
10
  export class EventService {
12
11
  constructor(
13
- private readonly anchorBlockStore: AnchorBlockStore,
12
+ private readonly anchorBlockHeader: BlockHeader,
14
13
  private readonly aztecNode: AztecNode,
15
14
  private readonly privateEventStore: PrivateEventStore,
16
15
  private readonly jobId: string,
17
16
  ) {}
18
17
 
19
- public async storeEvent(
18
+ public async validateAndStoreEvent(
20
19
  contractAddress: AztecAddress,
21
20
  selector: EventSelector,
22
21
  randomness: Fr,
@@ -29,13 +28,12 @@ export class EventService {
29
28
  // (and thus we're less concerned about being ahead of the synced block), we use the synced block number to
30
29
  // maintain consistent behavior in the PXE. Additionally, events should never be ahead of the synced block here
31
30
  // since `fetchTaggedLogs` only processes logs up to the synced block.
32
- const [anchorBlockHeader, siloedEventCommitment, txEffect] = await Promise.all([
33
- this.anchorBlockStore.getBlockHeader(),
31
+ const [siloedEventCommitment, txEffect] = await Promise.all([
34
32
  siloNullifier(contractAddress, eventCommitment),
35
33
  this.aztecNode.getTxEffect(txHash),
36
34
  ]);
37
35
 
38
- const anchorBlockNumber = anchorBlockHeader.getBlockNumber();
36
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
39
37
 
40
38
  if (!txEffect) {
41
39
  throw new Error(`Could not find tx effect for tx hash ${txHash}`);
@@ -1,5 +1,5 @@
1
1
  import { randomBytes } from '@aztec/foundation/crypto/random';
2
- import { createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
3
  import type { AztecAsyncKVStore } from '@aztec/kv-store';
4
4
 
5
5
  /**
@@ -40,7 +40,7 @@ export interface StagedStore {
40
40
  * using a job queue with concurrency=1.
41
41
  */
42
42
  export class JobCoordinator {
43
- private readonly log = createLogger('pxe:job_coordinator');
43
+ private readonly log: Logger;
44
44
 
45
45
  /** The underlying KV store */
46
46
  kvStore: AztecAsyncKVStore;
@@ -48,8 +48,9 @@ export class JobCoordinator {
48
48
  #currentJobId: string | undefined;
49
49
  #stores: Map<string, StagedStore> = new Map();
50
50
 
51
- constructor(kvStore: AztecAsyncKVStore) {
51
+ constructor(kvStore: AztecAsyncKVStore, bindings?: LoggerBindings) {
52
52
  this.kvStore = kvStore;
53
+ this.log = createLogger('pxe:job_coordinator', bindings);
53
54
  }
54
55
 
55
56
  /**
@@ -1,33 +1,40 @@
1
1
  import type { Fr } from '@aztec/foundation/curves/bn254';
2
- import { createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
3
  import type { KeyStore } from '@aztec/key-store';
4
4
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import type { CompleteAddress } from '@aztec/stdlib/contract';
6
6
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
7
7
  import { DirectionalAppTaggingSecret, PendingTaggedLog, SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
8
+ import type { BlockHeader } from '@aztec/stdlib/tx';
8
9
 
9
10
  import type { LogRetrievalRequest } from '../contract_function_simulator/noir-structs/log_retrieval_request.js';
10
11
  import { LogRetrievalResponse } from '../contract_function_simulator/noir-structs/log_retrieval_response.js';
11
12
  import { AddressStore } from '../storage/address_store/address_store.js';
12
- import { AnchorBlockStore } from '../storage/anchor_block_store/anchor_block_store.js';
13
13
  import { CapsuleStore } from '../storage/capsule_store/capsule_store.js';
14
14
  import type { RecipientTaggingStore } from '../storage/tagging_store/recipient_tagging_store.js';
15
15
  import type { SenderAddressBookStore } from '../storage/tagging_store/sender_address_book_store.js';
16
- import { loadPrivateLogsForSenderRecipientPair } from '../tagging/index.js';
16
+ import {
17
+ getAllPrivateLogsByTags,
18
+ getAllPublicLogsByTagsFromContract,
19
+ loadPrivateLogsForSenderRecipientPair,
20
+ } from '../tagging/index.js';
17
21
 
18
22
  export class LogService {
19
- private log = createLogger('log_service');
23
+ private log: Logger;
20
24
 
21
25
  constructor(
22
26
  private readonly aztecNode: AztecNode,
23
- private readonly anchorBlockStore: AnchorBlockStore,
27
+ private readonly anchorBlockHeader: BlockHeader,
24
28
  private readonly keyStore: KeyStore,
25
29
  private readonly capsuleStore: CapsuleStore,
26
30
  private readonly recipientTaggingStore: RecipientTaggingStore,
27
31
  private readonly senderAddressBookStore: SenderAddressBookStore,
28
32
  private readonly addressStore: AddressStore,
29
33
  private readonly jobId: string,
30
- ) {}
34
+ bindings?: LoggerBindings,
35
+ ) {
36
+ this.log = createLogger('pxe:log_service', bindings);
37
+ }
31
38
 
32
39
  public async bulkRetrieveLogs(logRetrievalRequests: LogRetrievalRequest[]): Promise<(LogRetrievalResponse | null)[]> {
33
40
  return await Promise.all(
@@ -49,10 +56,16 @@ export class LogService {
49
56
  }
50
57
 
51
58
  async #getPublicLogByTag(tag: Tag, contractAddress: AztecAddress): Promise<LogRetrievalResponse | null> {
52
- const logs = await this.aztecNode.getPublicLogsByTagsFromContract(contractAddress, [tag]);
53
- const logsForTag = logs[0];
59
+ const anchorBlockHash = await this.anchorBlockHeader.hash();
60
+ const allLogsPerTag = await getAllPublicLogsByTagsFromContract(
61
+ this.aztecNode,
62
+ contractAddress,
63
+ [tag],
64
+ anchorBlockHash,
65
+ );
66
+ const logsForTag = allLogsPerTag[0];
54
67
 
55
- if (logsForTag.length == 0) {
68
+ if (logsForTag.length === 0) {
56
69
  return null;
57
70
  } else if (logsForTag.length > 1) {
58
71
  // TODO(#11627): handle this case
@@ -72,10 +85,11 @@ export class LogService {
72
85
  }
73
86
 
74
87
  async #getPrivateLogByTag(siloedTag: SiloedTag): Promise<LogRetrievalResponse | null> {
75
- const logs = await this.aztecNode.getPrivateLogsByTags([siloedTag]);
76
- const logsForTag = logs[0];
88
+ const anchorBlockHash = await this.anchorBlockHeader.hash();
89
+ const allLogsPerTag = await getAllPrivateLogsByTags(this.aztecNode, [siloedTag], anchorBlockHash);
90
+ const logsForTag = allLogsPerTag[0];
77
91
 
78
- if (logsForTag.length == 0) {
92
+ if (logsForTag.length === 0) {
79
93
  return null;
80
94
  } else if (logsForTag.length > 1) {
81
95
  // TODO(#11627): handle this case
@@ -102,7 +116,8 @@ export class LogService {
102
116
  this.log.verbose('Searching for tagged logs', { contract: contractAddress });
103
117
 
104
118
  // We only load logs from block up to and including the anchor block number
105
- const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
119
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
120
+ const anchorBlockHash = await this.anchorBlockHeader.hash();
106
121
 
107
122
  // Determine recipients: use scopes if provided, otherwise get all accounts
108
123
  const recipients = scopes && scopes.length > 0 ? scopes : await this.keyStore.getAccounts();
@@ -123,6 +138,7 @@ export class LogService {
123
138
  this.aztecNode,
124
139
  this.recipientTaggingStore,
125
140
  anchorBlockNumber,
141
+ anchorBlockHash,
126
142
  this.jobId,
127
143
  ),
128
144
  ),
@@ -1,21 +1,20 @@
1
1
  import { Fr } from '@aztec/foundation/curves/bn254';
2
2
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
3
  import type { DataInBlock } from '@aztec/stdlib/block';
4
- import { L2BlockHash } from '@aztec/stdlib/block';
5
4
  import { computeUniqueNoteHash, siloNoteHash, siloNullifier } from '@aztec/stdlib/hash';
6
5
  import { type AztecNode, MAX_RPC_LEN } from '@aztec/stdlib/interfaces/client';
7
6
  import { Note, NoteDao, NoteStatus } from '@aztec/stdlib/note';
8
7
  import { MerkleTreeId } from '@aztec/stdlib/trees';
9
- import type { TxHash } from '@aztec/stdlib/tx';
8
+ import type { BlockHeader, TxHash } from '@aztec/stdlib/tx';
10
9
 
11
- import type { AnchorBlockStore } from '../storage/anchor_block_store/anchor_block_store.js';
12
10
  import type { NoteStore } from '../storage/note_store/note_store.js';
13
11
 
14
12
  export class NoteService {
15
13
  constructor(
16
14
  private readonly noteStore: NoteStore,
17
15
  private readonly aztecNode: AztecNode,
18
- private readonly anchorBlockStore: AnchorBlockStore,
16
+ private readonly anchorBlockHeader: BlockHeader,
17
+ private readonly jobId: string,
19
18
  ) {}
20
19
 
21
20
  /**
@@ -34,13 +33,16 @@ export class NoteService {
34
33
  status: NoteStatus,
35
34
  scopes?: AztecAddress[],
36
35
  ) {
37
- const noteDaos = await this.noteStore.getNotes({
38
- contractAddress,
39
- owner,
40
- storageSlot,
41
- status,
42
- scopes,
43
- });
36
+ const noteDaos = await this.noteStore.getNotes(
37
+ {
38
+ contractAddress,
39
+ owner,
40
+ storageSlot,
41
+ status,
42
+ scopes,
43
+ },
44
+ this.jobId,
45
+ );
44
46
  return noteDaos.map(
45
47
  ({ contractAddress, owner, storageSlot, randomness, noteNonce, note, noteHash, siloedNullifier }) => ({
46
48
  contractAddress,
@@ -69,9 +71,9 @@ export class NoteService {
69
71
  * @param contractAddress - The contract whose notes should be checked and nullified.
70
72
  */
71
73
  public async syncNoteNullifiers(contractAddress: AztecAddress): Promise<void> {
72
- const anchorBlockHash = L2BlockHash.fromField(await (await this.anchorBlockStore.getBlockHeader()).hash());
74
+ const anchorBlockHash = await this.anchorBlockHeader.hash();
73
75
 
74
- const contractNotes = await this.noteStore.getNotes({ contractAddress });
76
+ const contractNotes = await this.noteStore.getNotes({ contractAddress }, this.jobId);
75
77
 
76
78
  if (contractNotes.length === 0) {
77
79
  return;
@@ -105,10 +107,10 @@ export class NoteService {
105
107
  })
106
108
  .filter(nullifier => nullifier !== undefined) as DataInBlock<Fr>[];
107
109
 
108
- await this.noteStore.applyNullifiers(foundNullifiers);
110
+ await this.noteStore.applyNullifiers(foundNullifiers, this.jobId);
109
111
  }
110
112
 
111
- public async storeNote(
113
+ public async validateAndStoreNote(
112
114
  contractAddress: AztecAddress,
113
115
  owner: AztecAddress,
114
116
  storageSlot: Fr,
@@ -139,9 +141,8 @@ export class NoteService {
139
141
  // number which *should* be recent enough to be available, even for non-archive nodes.
140
142
  // Also note that the note should never be ahead of the synced block here since `fetchTaggedLogs` only processes
141
143
  // logs up to the synced block making this only an additional safety check.
142
- const anchorBlockHeader = await this.anchorBlockStore.getBlockHeader();
143
- const anchorBlockNumber = anchorBlockHeader.getBlockNumber();
144
- const anchorBlockHash = L2BlockHash.fromField(await anchorBlockHeader.hash());
144
+ const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
145
+ const anchorBlockHash = await this.anchorBlockHeader.hash();
145
146
 
146
147
  // By computing siloed and unique note hashes ourselves we prevent contracts from interfering with the note storage
147
148
  // of other contracts, which would constitute a security breach.
@@ -183,12 +184,12 @@ export class NoteService {
183
184
  );
184
185
 
185
186
  // The note was found by `recipient`, so we use that as the scope when storing the note.
186
- await this.noteStore.addNotes([noteDao], recipient);
187
+ await this.noteStore.addNotes([noteDao], recipient, this.jobId);
187
188
 
188
189
  if (nullifierIndex !== undefined) {
189
190
  // We found nullifier index which implies that the note has already been nullified.
190
191
  const { data: _, ...blockHashAndNum } = nullifierIndex;
191
- await this.noteStore.applyNullifiers([{ data: siloedNullifier, ...blockHashAndNum }]);
192
+ await this.noteStore.applyNullifiers([{ data: siloedNullifier, ...blockHashAndNum }], this.jobId);
192
193
  }
193
194
  }
194
195
  }
@@ -4,8 +4,9 @@
4
4
  ///
5
5
  /// @dev Whenever a contract function or Noir test is run, the `utilityAssertCompatibleOracleVersion` oracle is called
6
6
  /// and if the oracle version is incompatible an error is thrown.
7
- export const ORACLE_VERSION = 6;
7
+ export const ORACLE_VERSION = 9;
8
8
 
9
9
  /// This hash is computed as by hashing the Oracle interface and it is used to detect when the Oracle interface changes,
10
- /// which in turn implies that you need to update the ORACLE_VERSION constant.
11
- export const ORACLE_INTERFACE_HASH = '8fb18d1fa560c4844b22c55a3e79c32ffcb71ded9ac409911470ee0296a84d72';
10
+ /// which in turn implies that you need to update the ORACLE_VERSION constant in this file and in
11
+ /// `noir-projects/aztec-nr/aztec/src/oracle/version.nr`.
12
+ export const ORACLE_INTERFACE_HASH = '9866cc52510acaef75a3d47a0ed501fd9ff92b9d53b2c8a88c8a3ffd04ced81f';