@aztec/pxe 0.0.1-commit.e0f15ab9b → 0.0.1-commit.e304674f1

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 (138) hide show
  1. package/dest/block_synchronizer/block_synchronizer.d.ts +1 -1
  2. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  3. package/dest/block_synchronizer/block_synchronizer.js +6 -0
  4. package/dest/contract_function_simulator/contract_function_simulator.d.ts +3 -4
  5. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  6. package/dest/contract_function_simulator/contract_function_simulator.js +4 -3
  7. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +2 -3
  8. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  9. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +2 -5
  10. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -3
  11. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  12. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +2 -5
  13. package/dest/contract_function_simulator/oracle/interfaces.d.ts +19 -19
  14. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  15. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +1 -1
  16. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +18 -22
  18. package/dest/contract_function_simulator/oracle/oracle.d.ts +38 -19
  19. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/oracle/oracle.js +60 -39
  21. package/dest/contract_function_simulator/oracle/private_execution.js +1 -1
  22. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +7 -8
  23. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  24. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +16 -7
  25. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +30 -29
  26. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  27. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +115 -79
  28. package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
  29. package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
  30. package/dest/contract_function_simulator/pick_notes.js +9 -2
  31. package/dest/contract_logging.d.ts +9 -4
  32. package/dest/contract_logging.d.ts.map +1 -1
  33. package/dest/contract_logging.js +21 -6
  34. package/dest/contract_sync/contract_sync_service.d.ts +3 -4
  35. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  36. package/dest/contract_sync/contract_sync_service.js +12 -22
  37. package/dest/contract_sync/helpers.d.ts +2 -3
  38. package/dest/contract_sync/helpers.d.ts.map +1 -1
  39. package/dest/contract_sync/helpers.js +7 -2
  40. package/dest/debug/pxe_debug_utils.d.ts +3 -3
  41. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  42. package/dest/entrypoints/client/bundle/index.d.ts +1 -2
  43. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  44. package/dest/entrypoints/client/bundle/index.js +0 -1
  45. package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
  46. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  47. package/dest/entrypoints/client/bundle/utils.js +2 -2
  48. package/dest/entrypoints/client/lazy/index.d.ts +1 -2
  49. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  50. package/dest/entrypoints/client/lazy/index.js +0 -1
  51. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  52. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  53. package/dest/entrypoints/client/lazy/utils.js +2 -2
  54. package/dest/entrypoints/pxe_creation_options.d.ts +3 -1
  55. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  56. package/dest/entrypoints/pxe_creation_options.js +3 -1
  57. package/dest/entrypoints/server/index.d.ts +1 -2
  58. package/dest/entrypoints/server/index.d.ts.map +1 -1
  59. package/dest/entrypoints/server/index.js +0 -1
  60. package/dest/entrypoints/server/utils.d.ts +2 -2
  61. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  62. package/dest/entrypoints/server/utils.js +2 -2
  63. package/dest/events/event_service.d.ts +3 -2
  64. package/dest/events/event_service.d.ts.map +1 -1
  65. package/dest/events/event_service.js +16 -4
  66. package/dest/logs/log_service.d.ts +6 -7
  67. package/dest/logs/log_service.d.ts.map +1 -1
  68. package/dest/logs/log_service.js +32 -30
  69. package/dest/messages/message_context_service.d.ts +3 -3
  70. package/dest/messages/message_context_service.d.ts.map +1 -1
  71. package/dest/messages/message_context_service.js +3 -3
  72. package/dest/notes/note_service.d.ts +4 -5
  73. package/dest/notes/note_service.d.ts.map +1 -1
  74. package/dest/notes/note_service.js +14 -5
  75. package/dest/notes_filter.d.ts +2 -3
  76. package/dest/notes_filter.d.ts.map +1 -1
  77. package/dest/oracle_version.d.ts +2 -2
  78. package/dest/oracle_version.js +2 -2
  79. package/dest/pxe.d.ts +4 -5
  80. package/dest/pxe.d.ts.map +1 -1
  81. package/dest/pxe.js +6 -4
  82. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  83. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  84. package/dest/storage/capsule_store/capsule_service.js +50 -0
  85. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  86. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  87. package/dest/storage/capsule_store/capsule_store.js +33 -28
  88. package/dest/storage/capsule_store/index.d.ts +2 -1
  89. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  90. package/dest/storage/capsule_store/index.js +1 -0
  91. package/dest/storage/metadata.d.ts +1 -1
  92. package/dest/storage/metadata.js +1 -1
  93. package/dest/storage/note_store/note_store.d.ts +1 -1
  94. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  95. package/dest/storage/note_store/note_store.js +2 -2
  96. package/package.json +16 -16
  97. package/src/block_synchronizer/block_synchronizer.ts +6 -0
  98. package/src/contract_function_simulator/contract_function_simulator.ts +6 -6
  99. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +0 -3
  100. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +0 -3
  101. package/src/contract_function_simulator/oracle/interfaces.ts +26 -17
  102. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +13 -50
  103. package/src/contract_function_simulator/oracle/oracle.ts +79 -33
  104. package/src/contract_function_simulator/oracle/private_execution.ts +1 -1
  105. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +19 -10
  106. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +204 -91
  107. package/src/contract_function_simulator/pick_notes.ts +9 -2
  108. package/src/contract_logging.ts +18 -5
  109. package/src/contract_sync/contract_sync_service.ts +32 -43
  110. package/src/contract_sync/helpers.ts +4 -4
  111. package/src/debug/pxe_debug_utils.ts +3 -3
  112. package/src/entrypoints/client/bundle/index.ts +0 -1
  113. package/src/entrypoints/client/bundle/utils.ts +2 -3
  114. package/src/entrypoints/client/lazy/index.ts +0 -1
  115. package/src/entrypoints/client/lazy/utils.ts +2 -3
  116. package/src/entrypoints/pxe_creation_options.ts +7 -0
  117. package/src/entrypoints/server/index.ts +0 -1
  118. package/src/entrypoints/server/utils.ts +2 -3
  119. package/src/events/event_service.ts +17 -4
  120. package/src/logs/log_service.ts +63 -48
  121. package/src/messages/message_context_service.ts +3 -4
  122. package/src/notes/note_service.ts +18 -8
  123. package/src/notes_filter.ts +1 -3
  124. package/src/oracle_version.ts +2 -2
  125. package/src/pxe.ts +11 -10
  126. package/src/storage/capsule_store/capsule_service.ts +90 -0
  127. package/src/storage/capsule_store/capsule_store.ts +34 -26
  128. package/src/storage/capsule_store/index.ts +1 -0
  129. package/src/storage/metadata.ts +1 -1
  130. package/src/storage/note_store/note_store.ts +2 -5
  131. package/dest/access_scopes.d.ts +0 -9
  132. package/dest/access_scopes.d.ts.map +0 -1
  133. package/dest/access_scopes.js +0 -6
  134. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts +0 -16
  135. package/dest/contract_function_simulator/noir-structs/message_tx_context.d.ts.map +0 -1
  136. package/dest/contract_function_simulator/noir-structs/message_tx_context.js +0 -57
  137. package/src/access_scopes.ts +0 -9
  138. package/src/contract_function_simulator/noir-structs/message_tx_context.ts +0 -55
@@ -86,8 +86,15 @@ interface ContainsNote {
86
86
 
87
87
  const selectPropertyFromPackedNoteContent = (noteData: Fr[], selector: PropertySelector): Fr => {
88
88
  const noteValueBuffer = noteData[selector.index].toBuffer();
89
- const noteValue = noteValueBuffer.subarray(selector.offset, selector.offset + selector.length);
90
- return Fr.fromBuffer(noteValue);
89
+ // Noir's PropertySelector counts offset from the LSB (last byte of the big-endian buffer),
90
+ // so offset=0,length=Fr.SIZE_IN_BYTES reads the entire field, and offset=0,length=1 reads the last byte.
91
+ const start = Fr.SIZE_IN_BYTES - selector.offset - selector.length;
92
+ const end = Fr.SIZE_IN_BYTES - selector.offset;
93
+ const noteValue = noteValueBuffer.subarray(start, end);
94
+ // Left-pad to Fr.SIZE_IN_BYTES so Fr.fromBuffer interprets the value correctly.
95
+ const padded = Buffer.alloc(Fr.SIZE_IN_BYTES);
96
+ noteValue.copy(padded, Fr.SIZE_IN_BYTES - noteValue.length);
97
+ return Fr.fromBuffer(padded);
91
98
  };
92
99
 
93
100
  const selectNotes = <T extends ContainsNote>(noteDatas: T[], selects: Select[]): T[] =>
@@ -5,18 +5,22 @@ import type { DebugLog } from '@aztec/stdlib/logs';
5
5
 
6
6
  /** Resolves a contract address to a human-readable name, if available. */
7
7
  export type ContractNameResolver = (address: AztecAddress) => Promise<string | undefined>;
8
+ export type CONTRACT_LOG_KIND = 'aztecnr' | 'user';
8
9
 
9
10
  /**
10
- * Creates a logger whose output is prefixed with `contract_log::<name>(<addrAbbrev>)`.
11
+ * Creates a logger whose output is prefixed with `contract:<name>(<addrAbbrev>)`.
11
12
  */
12
13
  export async function createContractLogger(
13
14
  contractAddress: AztecAddress,
14
15
  getContractName: ContractNameResolver,
16
+ kind: CONTRACT_LOG_KIND,
15
17
  options?: { instanceId?: string },
16
18
  ): Promise<Logger> {
17
19
  const addrAbbrev = contractAddress.toString().slice(0, 10);
18
20
  const name = await getContractName(contractAddress);
19
- const module = name ? `contract_log::${name}(${addrAbbrev})` : `contract_log::Unknown(${addrAbbrev})`;
21
+
22
+ const prefix = kind == 'aztecnr' ? 'aztecnr' : 'contract';
23
+ const module = name ? `${prefix}:${name}(${addrAbbrev})` : `${prefix}:Unknown(${addrAbbrev})`;
20
24
  return createLogger(module, options);
21
25
  }
22
26
 
@@ -29,11 +33,20 @@ export function logContractMessage(logger: Logger, level: LogLevel, message: str
29
33
 
30
34
  /**
31
35
  * Displays debug logs collected during public function simulation,
32
- * using the `contract_log::` prefixed logger format.
36
+ * using the `contract:` prefixed logger format.
33
37
  */
34
38
  export async function displayDebugLogs(debugLogs: DebugLog[], getContractName: ContractNameResolver): Promise<void> {
35
39
  for (const log of debugLogs) {
36
- const logger = await createContractLogger(log.contractAddress, getContractName);
37
- logContractMessage(logger, log.level, log.message, log.fields);
40
+ const { kind, message } = stripAztecnrLogPrefix(log.message);
41
+ const logger = await createContractLogger(log.contractAddress, getContractName, kind);
42
+ logContractMessage(logger, log.level, message, log.fields);
43
+ }
44
+ }
45
+
46
+ export function stripAztecnrLogPrefix(message: string): { kind: CONTRACT_LOG_KIND; message: string } {
47
+ if (message.startsWith('[aztec-nr] ')) {
48
+ return { kind: 'aztecnr', message: message.slice('[aztec-nr] '.length) };
49
+ } else {
50
+ return { kind: 'user', message };
38
51
  }
39
52
  }
@@ -4,7 +4,6 @@ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
5
  import type { BlockHeader } from '@aztec/stdlib/tx';
6
6
 
7
- import type { AccessScopes } from '../access_scopes.js';
8
7
  import type { StagedStore } from '../job_coordinator/job_coordinator.js';
9
8
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
10
9
  import type { NoteStore } from '../storage/note_store/note_store.js';
@@ -51,10 +50,10 @@ export class ContractSyncService implements StagedStore {
51
50
  async ensureContractSynced(
52
51
  contractAddress: AztecAddress,
53
52
  functionToInvokeAfterSync: FunctionSelector | null,
54
- utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<any>,
53
+ utilityExecutor: (call: FunctionCall, scopes: AztecAddress[]) => Promise<any>,
55
54
  anchorBlockHeader: BlockHeader,
56
55
  jobId: string,
57
- scopes: AccessScopes,
56
+ scopes: AztecAddress[],
58
57
  ): Promise<void> {
59
58
  if (this.#shouldSkipSync(jobId, contractAddress)) {
60
59
  return;
@@ -74,36 +73,42 @@ export class ContractSyncService implements StagedStore {
74
73
  await this.#awaitSync(contractAddress, scopes);
75
74
  }
76
75
 
77
- /** Clears sync cache entries for the given scopes of a contract. Also clears the ALL_SCOPES entry. */
76
+ /** Clears sync cache entries for the given scopes of a contract. */
78
77
  invalidateContractForScopes(contractAddress: AztecAddress, scopes: AztecAddress[]): void {
79
78
  if (scopes.length === 0) {
80
79
  return;
81
80
  }
82
81
  scopes.forEach(scope => this.syncedContracts.delete(toKey(contractAddress, scope)));
83
- this.syncedContracts.delete(toKey(contractAddress, 'ALL_SCOPES'));
84
82
  }
85
83
 
86
84
  async #syncContract(
87
85
  contractAddress: AztecAddress,
88
86
  functionToInvokeAfterSync: FunctionSelector | null,
89
- utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<any>,
87
+ utilityExecutor: (call: FunctionCall, scopes: AztecAddress[]) => Promise<any>,
90
88
  anchorBlockHeader: BlockHeader,
91
89
  jobId: string,
92
- scopes: AccessScopes,
90
+ scopes: AztecAddress[],
93
91
  ): Promise<void> {
94
92
  this.log.debug(`Syncing contract ${contractAddress}`);
93
+
95
94
  await Promise.all([
96
- syncState(
97
- contractAddress,
98
- this.contractStore,
99
- functionToInvokeAfterSync,
100
- utilityExecutor,
101
- this.noteStore,
102
- this.aztecNode,
103
- anchorBlockHeader,
104
- jobId,
105
- scopes,
106
- ),
95
+ // Call sync_state sequentially for each scope address — each invocation synchronizes one account's private
96
+ // state using scoped capsule arrays.
97
+ (async () => {
98
+ for (const scope of scopes) {
99
+ await syncState(
100
+ contractAddress,
101
+ this.contractStore,
102
+ functionToInvokeAfterSync,
103
+ utilityExecutor,
104
+ this.noteStore,
105
+ this.aztecNode,
106
+ anchorBlockHeader,
107
+ jobId,
108
+ scope,
109
+ );
110
+ }
111
+ })(),
107
112
  verifyCurrentClassId(contractAddress, this.aztecNode, this.contractStore, anchorBlockHeader),
108
113
  ]);
109
114
  this.log.debug(`Contract ${contractAddress} synced`);
@@ -136,11 +141,11 @@ export class ContractSyncService implements StagedStore {
136
141
  /** If there are unsynced scopes, starts sync and stores the promise in cache with error cleanup. */
137
142
  #startSyncIfNeeded(
138
143
  contractAddress: AztecAddress,
139
- scopes: AccessScopes,
140
- syncFn: (scopesToSync: AccessScopes) => Promise<void>,
144
+ scopes: AztecAddress[],
145
+ syncFn: (scopesToSync: AztecAddress[]) => Promise<void>,
141
146
  ): void {
142
- const scopesToSync = this.#getScopesToSync(contractAddress, scopes);
143
- const keys = toKeys(contractAddress, scopesToSync);
147
+ const scopesToSync = scopes.filter(scope => !this.syncedContracts.has(toKey(contractAddress, scope)));
148
+ const keys = scopesToSync.map(scope => toKey(contractAddress, scope));
144
149
  if (keys.length === 0) {
145
150
  return;
146
151
  }
@@ -151,31 +156,15 @@ export class ContractSyncService implements StagedStore {
151
156
  keys.forEach(key => this.syncedContracts.set(key, promise));
152
157
  }
153
158
 
154
- /** Filters out scopes that are already cached, returning only those that still need syncing. */
155
- #getScopesToSync(contractAddress: AztecAddress, scopes: AccessScopes): AccessScopes {
156
- if (this.syncedContracts.has(toKey(contractAddress, 'ALL_SCOPES'))) {
157
- // If we are already syncing all scopes, then return an empty list
158
- return [];
159
- }
160
- if (scopes === 'ALL_SCOPES') {
161
- return 'ALL_SCOPES';
162
- }
163
- return scopes.filter(scope => !this.syncedContracts.has(toKey(contractAddress, scope)));
164
- }
165
-
166
159
  /** Collects all relevant scope promises (including in-flight ones from concurrent calls) and awaits them. */
167
- async #awaitSync(contractAddress: AztecAddress, scopes: AccessScopes): Promise<void> {
168
- const promises = toKeys(contractAddress, scopes)
169
- .map(key => this.syncedContracts.get(key))
160
+ async #awaitSync(contractAddress: AztecAddress, scopes: AztecAddress[]): Promise<void> {
161
+ const promises = scopes
162
+ .map(scope => this.syncedContracts.get(toKey(contractAddress, scope)))
170
163
  .filter(p => p !== undefined);
171
164
  await Promise.all(promises);
172
165
  }
173
166
  }
174
167
 
175
- function toKeys(contract: AztecAddress, scopes: AccessScopes) {
176
- return scopes === 'ALL_SCOPES' ? [toKey(contract, scopes)] : scopes.map(scope => toKey(contract, scope));
177
- }
178
-
179
- function toKey(contract: AztecAddress, scope: AztecAddress | 'ALL_SCOPES') {
180
- return scope === 'ALL_SCOPES' ? `${contract.toString()}:*` : `${contract.toString()}:${scope.toString()}`;
168
+ function toKey(contract: AztecAddress, scope: AztecAddress) {
169
+ return `${contract.toString()}:${scope.toString()}`;
181
170
  }
@@ -6,7 +6,6 @@ import { DelayedPublicMutableValues, DelayedPublicMutableValuesWithHash } from '
6
6
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
7
7
  import type { BlockHeader } from '@aztec/stdlib/tx';
8
8
 
9
- import type { AccessScopes } from '../access_scopes.js';
10
9
  import { NoteService } from '../notes/note_service.js';
11
10
  import type { ContractStore } from '../storage/contract_store/contract_store.js';
12
11
  import type { NoteStore } from '../storage/note_store/note_store.js';
@@ -43,16 +42,16 @@ export async function syncState(
43
42
  contractAddress: AztecAddress,
44
43
  contractStore: ContractStore,
45
44
  functionToInvokeAfterSync: FunctionSelector | null,
46
- utilityExecutor: (privateSyncCall: FunctionCall, scopes: AccessScopes) => Promise<any>,
45
+ utilityExecutor: (privateSyncCall: FunctionCall, scopes: AztecAddress[]) => Promise<any>,
47
46
  noteStore: NoteStore,
48
47
  aztecNode: AztecNode,
49
48
  anchorBlockHeader: BlockHeader,
50
49
  jobId: string,
51
- scopes: AccessScopes,
50
+ scope: AztecAddress,
52
51
  ) {
53
52
  // Protocol contracts don't have private state to sync
54
53
  if (!isProtocolContract(contractAddress)) {
55
- const syncStateFunctionCall = await contractStore.getFunctionCall('sync_state', [], contractAddress);
54
+ const syncStateFunctionCall = await contractStore.getFunctionCall('sync_state', [scope], contractAddress);
56
55
  if (functionToInvokeAfterSync && functionToInvokeAfterSync.equals(syncStateFunctionCall.selector)) {
57
56
  throw new Error(
58
57
  'Forbidden `sync_state` invocation. `sync_state` can only be invoked by PXE, manual execution can lead to inconsistencies.',
@@ -60,6 +59,7 @@ export async function syncState(
60
59
  }
61
60
 
62
61
  const noteService = new NoteService(noteStore, aztecNode, anchorBlockHeader, jobId);
62
+ const scopes: AztecAddress[] = [scope];
63
63
 
64
64
  // Both sync_state and syncNoteNullifiers interact with the note store, but running them in parallel is safe
65
65
  // because note store is designed to handle concurrent operations.
@@ -1,9 +1,9 @@
1
1
  import type { FunctionCall } from '@aztec/stdlib/abi';
2
2
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
3
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
4
  import type { NoteDao } from '@aztec/stdlib/note';
4
5
  import type { ContractOverrides } from '@aztec/stdlib/tx';
5
6
 
6
- import type { AccessScopes } from '../access_scopes.js';
7
7
  import type { BlockSynchronizer } from '../block_synchronizer/block_synchronizer.js';
8
8
  import type { ContractFunctionSimulator } from '../contract_function_simulator/contract_function_simulator.js';
9
9
  import type { ContractSyncService } from '../contract_sync/contract_sync_service.js';
@@ -22,7 +22,7 @@ export class PXEDebugUtils {
22
22
  contractFunctionSimulator: ContractFunctionSimulator,
23
23
  call: FunctionCall,
24
24
  authWitnesses: AuthWitness[] | undefined,
25
- scopes: AccessScopes,
25
+ scopes: AztecAddress[],
26
26
  jobId: string,
27
27
  ) => Promise<any>;
28
28
 
@@ -41,7 +41,7 @@ export class PXEDebugUtils {
41
41
  contractFunctionSimulator: ContractFunctionSimulator,
42
42
  call: FunctionCall,
43
43
  authWitnesses: AuthWitness[] | undefined,
44
- scopes: AccessScopes,
44
+ scopes: AztecAddress[],
45
45
  jobId: string,
46
46
  ) => Promise<any>,
47
47
  ) {
@@ -1,4 +1,3 @@
1
- export * from '../../../access_scopes.js';
2
1
  export * from '../../../notes_filter.js';
3
2
  export * from '../../../pxe.js';
4
3
  export * from '../../../config/index.js';
@@ -1,4 +1,3 @@
1
- import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
1
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
3
2
  import { createLogger } from '@aztec/foundation/log';
4
3
  import { createStore } from '@aztec/kv-store/indexeddb';
@@ -9,7 +8,7 @@ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
9
8
  import type { PXEConfig } from '../../../config/index.js';
10
9
  import { PXE } from '../../../pxe.js';
11
10
  import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
- import type { PXECreationOptions } from '../../pxe_creation_options.js';
11
+ import { type PXECreationOptions, isPrivateKernelProver } from '../../pxe_creation_options.js';
13
12
 
14
13
  /**
15
14
  * Create and start an PXE instance with the given AztecNode.
@@ -44,7 +43,7 @@ export async function createPXE(
44
43
  const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
45
44
 
46
45
  let prover;
47
- if (options.proverOrOptions instanceof BBPrivateKernelProver) {
46
+ if (isPrivateKernelProver(options.proverOrOptions)) {
48
47
  prover = options.proverOrOptions;
49
48
  } else {
50
49
  prover = new BBBundlePrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
@@ -1,4 +1,3 @@
1
- export * from '../../../access_scopes.js';
2
1
  export * from '../../../notes_filter.js';
3
2
  export * from '../../../pxe.js';
4
3
  export * from '../../../config/index.js';
@@ -1,4 +1,3 @@
1
- import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
1
  import { BBLazyPrivateKernelProver } from '@aztec/bb-prover/client/lazy';
3
2
  import { createLogger } from '@aztec/foundation/log';
4
3
  import { createStore } from '@aztec/kv-store/indexeddb';
@@ -9,7 +8,7 @@ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
9
8
  import type { PXEConfig } from '../../../config/index.js';
10
9
  import { PXE } from '../../../pxe.js';
11
10
  import { PXE_DATA_SCHEMA_VERSION } from '../../../storage/metadata.js';
12
- import type { PXECreationOptions } from '../../pxe_creation_options.js';
11
+ import { type PXECreationOptions, isPrivateKernelProver } from '../../pxe_creation_options.js';
13
12
 
14
13
  /**
15
14
  * Create and start an PXE instance with the given AztecNode.
@@ -44,7 +43,7 @@ export async function createPXE(
44
43
  const proverLogger = loggers.prover ?? createLogger('pxe:bb:wasm:bundle', { actor });
45
44
 
46
45
  let prover;
47
- if (options.proverOrOptions instanceof BBPrivateKernelProver) {
46
+ if (isPrivateKernelProver(options.proverOrOptions)) {
48
47
  prover = options.proverOrOptions;
49
48
  } else {
50
49
  prover = new BBLazyPrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
@@ -12,3 +12,10 @@ export type PXECreationOptions = {
12
12
  store?: AztecAsyncKVStore;
13
13
  simulator?: CircuitSimulator;
14
14
  };
15
+
16
+ /** Checks if the given value implements the PrivateKernelProver interface via duck-typing. */
17
+ export function isPrivateKernelProver(value: unknown): value is PrivateKernelProver {
18
+ return (
19
+ typeof value === 'object' && value !== null && typeof (value as PrivateKernelProver).createChonkProof === 'function'
20
+ );
21
+ }
@@ -1,4 +1,3 @@
1
- export * from '../../access_scopes.js';
2
1
  export * from '../../notes_filter.js';
3
2
  export * from '../../pxe.js';
4
3
  export * from '../../config/index.js';
@@ -1,4 +1,3 @@
1
- import { BBPrivateKernelProver } from '@aztec/bb-prover/client';
2
1
  import { BBBundlePrivateKernelProver } from '@aztec/bb-prover/client/bundle';
3
2
  import { createLogger } from '@aztec/foundation/log';
4
3
  import { createStore } from '@aztec/kv-store/lmdb-v2';
@@ -10,7 +9,7 @@ import type { AztecNode } from '@aztec/stdlib/interfaces/client';
10
9
  import type { PXEConfig } from '../../config/index.js';
11
10
  import { PXE } from '../../pxe.js';
12
11
  import { PXE_DATA_SCHEMA_VERSION } from '../../storage/index.js';
13
- import type { PXECreationOptions } from '../pxe_creation_options.js';
12
+ import { type PXECreationOptions, isPrivateKernelProver } from '../pxe_creation_options.js';
14
13
 
15
14
  type PXEConfigWithoutDefaults = Omit<PXEConfig, 'l1Contracts' | 'l1ChainId' | 'l2BlockBatchSize' | 'rollupVersion'>;
16
15
 
@@ -49,7 +48,7 @@ export async function createPXE(
49
48
  const proverLogger = loggers.prover ?? createLogger('pxe:bb:native', { actor });
50
49
 
51
50
  let prover;
52
- if (options.proverOrOptions instanceof BBPrivateKernelProver) {
51
+ if (isPrivateKernelProver(options.proverOrOptions)) {
53
52
  prover = options.proverOrOptions;
54
53
  } else {
55
54
  prover = new BBBundlePrivateKernelProver(simulator, { ...options.proverOrOptions, logger: proverLogger });
@@ -1,4 +1,5 @@
1
1
  import type { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { createLogger } from '@aztec/foundation/log';
2
3
  import type { EventSelector } from '@aztec/stdlib/abi';
3
4
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
5
  import { siloNullifier } from '@aztec/stdlib/hash';
@@ -13,6 +14,7 @@ export class EventService {
13
14
  private readonly aztecNode: AztecNode,
14
15
  private readonly privateEventStore: PrivateEventStore,
15
16
  private readonly jobId: string,
17
+ private readonly log = createLogger('pxe:event_service'),
16
18
  ) {}
17
19
 
18
20
  public async validateAndStoreEvent(
@@ -36,19 +38,30 @@ export class EventService {
36
38
  const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
37
39
 
38
40
  if (!txEffect) {
39
- throw new Error(`Could not find tx effect for tx hash ${txHash}`);
41
+ // We error out instead of just logging a warning and skipping the event because this would indicate a bug. This
42
+ // is because the node has already served info about this tx either when obtaining the log (TxScopedL2Log contain
43
+ // tx info) or when getting metadata for the offchain message (before the message got passed to `process_log`).
44
+ throw new Error(`Could not find tx effect for tx hash ${txHash} when processing an event.`);
40
45
  }
41
46
 
42
47
  if (txEffect.l2BlockNumber > anchorBlockNumber) {
43
- throw new Error(`Could not find tx effect for tx hash ${txHash} as of block number ${anchorBlockNumber}`);
48
+ // We should never process a message from a tx past the anchor block. If we got here, a preprocessing step made
49
+ // a mistake.
50
+ throw new Error(
51
+ `Obtained a newer tx effect for ${txHash} for an event validation request than the anchor block ${anchorBlockNumber}. This is a bug as smart contracts should not issue event validation requests for events from blocks newer than the anchor block.`,
52
+ );
44
53
  }
45
54
 
46
55
  // Find the index of the event commitment in the nullifiers array to determine event ordering within the tx
47
56
  const eventIndexInTx = txEffect.data.nullifiers.findIndex(n => n.equals(siloedEventCommitment));
48
57
  if (eventIndexInTx === -1) {
49
- throw new Error(
50
- `Event commitment ${eventCommitment} (siloed as ${siloedEventCommitment}) is not present in tx ${txHash}`,
58
+ // Unlike in NoteService, this might not be a bug since the commitment hasn't been verified yet in the message
59
+ // processing pipeline. A malformed or malicious message could trigger this condition. Because of this we don't
60
+ // error out and we just show a warning.
61
+ this.log.warn(
62
+ `Skipping event whose commitment is not present in its tx. siloedEventCommitment=${siloedEventCommitment}, contract=${contractAddress}, selector=${selector}, eventCommitment=${eventCommitment}, txHash=${txHash}`,
51
63
  );
64
+ return;
52
65
  }
53
66
 
54
67
  return this.privateEventStore.storePrivateEventLog(
@@ -12,11 +12,10 @@ import {
12
12
  } from '@aztec/stdlib/logs';
13
13
  import type { BlockHeader } from '@aztec/stdlib/tx';
14
14
 
15
- import type { AccessScopes } from '../access_scopes.js';
16
15
  import type { LogRetrievalRequest } from '../contract_function_simulator/noir-structs/log_retrieval_request.js';
17
16
  import { LogRetrievalResponse } from '../contract_function_simulator/noir-structs/log_retrieval_response.js';
18
17
  import { AddressStore } from '../storage/address_store/address_store.js';
19
- import { CapsuleStore } from '../storage/capsule_store/capsule_store.js';
18
+ import type { CapsuleService } from '../storage/capsule_store/capsule_service.js';
20
19
  import type { RecipientTaggingStore } from '../storage/tagging_store/recipient_tagging_store.js';
21
20
  import type { SenderAddressBookStore } from '../storage/tagging_store/sender_address_book_store.js';
22
21
  import {
@@ -32,7 +31,7 @@ export class LogService {
32
31
  private readonly aztecNode: AztecNode,
33
32
  private readonly anchorBlockHeader: BlockHeader,
34
33
  private readonly keyStore: KeyStore,
35
- private readonly capsuleStore: CapsuleStore,
34
+ private readonly capsuleService: CapsuleService,
36
35
  private readonly recipientTaggingStore: RecipientTaggingStore,
37
36
  private readonly senderAddressBookStore: SenderAddressBookStore,
38
37
  private readonly addressStore: AddressStore,
@@ -42,7 +41,16 @@ export class LogService {
42
41
  this.log = createLogger('pxe:log_service', bindings);
43
42
  }
44
43
 
45
- public async bulkRetrieveLogs(logRetrievalRequests: LogRetrievalRequest[]): Promise<(LogRetrievalResponse | null)[]> {
44
+ public async fetchLogsByTag(
45
+ contractAddress: AztecAddress,
46
+ logRetrievalRequests: LogRetrievalRequest[],
47
+ ): Promise<(LogRetrievalResponse | null)[]> {
48
+ for (const request of logRetrievalRequests) {
49
+ if (!contractAddress.equals(request.contractAddress)) {
50
+ throw new Error(`Got a log retrieval request from ${request.contractAddress}, expected ${contractAddress}`);
51
+ }
52
+ }
53
+
46
54
  return await Promise.all(
47
55
  logRetrievalRequests.map(async request => {
48
56
  const [publicLog, privateLog] = await Promise.all([
@@ -51,8 +59,8 @@ export class LogService {
51
59
  ]);
52
60
 
53
61
  if (publicLog !== null && privateLog !== null) {
54
- throw new Error(
55
- `Found both a public and private log when searching for tag ${request.tag} from contract ${request.contractAddress}`,
62
+ this.log.warn(
63
+ `Found both a public and private log for tag ${request.tag} from contract ${request.contractAddress}. This may indicate a contract bug. Returning the public log.`,
56
64
  );
57
65
  }
58
66
 
@@ -74,9 +82,8 @@ export class LogService {
74
82
  if (logsForTag.length === 0) {
75
83
  return null;
76
84
  } else if (logsForTag.length > 1) {
77
- // TODO(#11627): handle this case
78
- throw new Error(
79
- `Got ${logsForTag.length} logs for tag ${tag} and contract ${contractAddress.toString()}. getPublicLogByTag currently only supports a single log per tag`,
85
+ this.log.warn(
86
+ `Expected at most 1 public log for tag ${tag} and contract ${contractAddress.toString()}, got ${logsForTag.length}. This may indicate a contract bug. Returning the first log.`,
80
87
  );
81
88
  }
82
89
 
@@ -98,9 +105,8 @@ export class LogService {
98
105
  if (logsForTag.length === 0) {
99
106
  return null;
100
107
  } else if (logsForTag.length > 1) {
101
- // TODO(#11627): handle this case
102
- throw new Error(
103
- `Got ${logsForTag.length} logs for tag ${siloedTag}. getPrivateLogByTag currently only supports a single log per tag`,
108
+ this.log.warn(
109
+ `Expected at most 1 private log for tag ${siloedTag}, got ${logsForTag.length}. This may indicate a contract bug. Returning the first log.`,
104
110
  );
105
111
  }
106
112
 
@@ -114,46 +120,40 @@ export class LogService {
114
120
  );
115
121
  }
116
122
 
117
- public async fetchTaggedLogs(contractAddress: AztecAddress, pendingTaggedLogArrayBaseSlot: Fr, scopes: AccessScopes) {
123
+ public async fetchTaggedLogs(
124
+ contractAddress: AztecAddress,
125
+ pendingTaggedLogArrayBaseSlot: Fr,
126
+ recipient: AztecAddress,
127
+ ) {
118
128
  this.log.verbose(`Fetching tagged logs for ${contractAddress.toString()}`);
119
129
 
120
130
  // We only load logs from block up to and including the anchor block number
121
131
  const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
122
132
  const anchorBlockHash = await this.anchorBlockHeader.hash();
123
133
 
124
- // Determine recipients: use scopes if provided, otherwise get all accounts
125
- const recipients = scopes !== 'ALL_SCOPES' && scopes.length > 0 ? scopes : await this.keyStore.getAccounts();
126
-
127
- // For each recipient, fetch secrets, load logs, and store them.
128
- // We run these per-recipient tasks in parallel so that logs are loaded for all recipients concurrently.
129
- await Promise.all(
130
- recipients.map(async recipient => {
131
- // Get all secrets for this recipient (one per sender)
132
- const secrets = await this.#getSecretsForSenders(contractAddress, recipient);
133
-
134
- // Load logs for all sender-recipient pairs in parallel
135
- const logArrays = await Promise.all(
136
- secrets.map(secret =>
137
- loadPrivateLogsForSenderRecipientPair(
138
- secret,
139
- this.aztecNode,
140
- this.recipientTaggingStore,
141
- anchorBlockNumber,
142
- anchorBlockHash,
143
- this.jobId,
144
- ),
145
- ),
146
- );
134
+ // Get all secrets for this recipient (one per sender)
135
+ const secrets = await this.#getSecretsForSenders(contractAddress, recipient);
136
+
137
+ // Load logs for all sender-recipient pairs in parallel
138
+ const logArrays = await Promise.all(
139
+ secrets.map(secret =>
140
+ loadPrivateLogsForSenderRecipientPair(
141
+ secret,
142
+ this.aztecNode,
143
+ this.recipientTaggingStore,
144
+ anchorBlockNumber,
145
+ anchorBlockHash,
146
+ this.jobId,
147
+ ),
148
+ ),
149
+ );
147
150
 
148
- // Flatten all logs from all secrets
149
- const allLogs = logArrays.flat();
151
+ // Flatten all logs from all secrets
152
+ const allLogs = logArrays.flat();
150
153
 
151
- // Store the logs for this recipient
152
- if (allLogs.length > 0) {
153
- await this.#storePendingTaggedLogs(contractAddress, pendingTaggedLogArrayBaseSlot, recipient, allLogs);
154
- }
155
- }),
156
- );
154
+ if (allLogs.length > 0) {
155
+ await this.#storePendingTaggedLogs(contractAddress, pendingTaggedLogArrayBaseSlot, recipient, allLogs);
156
+ }
157
157
  }
158
158
 
159
159
  async #getSecretsForSenders(
@@ -176,14 +176,24 @@ export class LogService {
176
176
  );
177
177
 
178
178
  return Promise.all(
179
- deduplicatedSenders.map(sender => {
180
- return ExtendedDirectionalAppTaggingSecret.compute(
179
+ deduplicatedSenders.map(async sender => {
180
+ const secret = await ExtendedDirectionalAppTaggingSecret.compute(
181
181
  recipientCompleteAddress,
182
182
  recipientIvsk,
183
183
  sender,
184
184
  contractAddress,
185
185
  recipient,
186
186
  );
187
+
188
+ if (!secret) {
189
+ // Note that all senders originate from either the SenderAddressBookStore or the KeyStore.
190
+ // TODO(F-512): make sure we actually prevent registering invalid senders.
191
+ throw new Error(
192
+ `Failed to compute a tagging secret for sender ${sender} - this implies this is an invalid address, which should not happen as they have been previously registered in PXE.`,
193
+ );
194
+ }
195
+
196
+ return secret;
187
197
  }),
188
198
  );
189
199
  }
@@ -201,13 +211,18 @@ export class LogService {
201
211
  scopedLog.txHash,
202
212
  scopedLog.noteHashes,
203
213
  scopedLog.firstNullifier,
204
- recipient,
205
214
  );
206
215
 
207
216
  return pendingTaggedLog.toFields();
208
217
  });
209
218
 
210
219
  // TODO: This looks like it could belong more at the oracle interface level
211
- return this.capsuleStore.appendToCapsuleArray(contractAddress, capsuleArrayBaseSlot, pendingTaggedLogs, this.jobId);
220
+ return this.capsuleService.appendToCapsuleArray(
221
+ contractAddress,
222
+ capsuleArrayBaseSlot,
223
+ pendingTaggedLogs,
224
+ this.jobId,
225
+ recipient,
226
+ );
212
227
  }
213
228
  }
@@ -1,9 +1,8 @@
1
1
  import { Fr } from '@aztec/foundation/curves/bn254';
2
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
3
+ import { MessageContext } from '@aztec/stdlib/logs';
3
4
  import { TxHash } from '@aztec/stdlib/tx';
4
5
 
5
- import { MessageTxContext } from '../contract_function_simulator/noir-structs/message_tx_context.js';
6
-
7
6
  /** Resolves transaction hashes into the context needed to process messages. */
8
7
  export class MessageContextService {
9
8
  constructor(private readonly aztecNode: AztecNode) {}
@@ -15,7 +14,7 @@ export class MessageContextService {
15
14
  * process messages that originated from that transaction. Returns `null` for tx hashes that are zero, not yet
16
15
  * available, or in blocks beyond the anchor block.
17
16
  */
18
- resolveMessageContexts(txHashes: Fr[], anchorBlockNumber: number): Promise<(MessageTxContext | null)[]> {
17
+ getMessageContextsByTxHash(txHashes: Fr[], anchorBlockNumber: number): Promise<(MessageContext | null)[]> {
19
18
  // TODO: optimize, we might be hitting the node to get the same txHash repeatedly
20
19
  return Promise.all(
21
20
  txHashes.map(async txHashField => {
@@ -38,7 +37,7 @@ export class MessageContextService {
38
37
  throw new Error(`Tx effect for ${txHash} has no nullifiers`);
39
38
  }
40
39
 
41
- return new MessageTxContext(data.txHash, data.noteHashes, data.nullifiers[0]);
40
+ return new MessageContext(data.txHash, data.noteHashes, data.nullifiers[0]);
42
41
  }),
43
42
  );
44
43
  }