@aztec/pxe 4.0.0-devnet.2-patch.4 → 4.0.0-devnet.3-patch.0

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 (168) hide show
  1. package/dest/config/package_info.js +1 -1
  2. package/dest/contract_function_simulator/contract_function_simulator.d.ts +10 -5
  3. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  4. package/dest/contract_function_simulator/contract_function_simulator.js +35 -12
  5. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -7
  6. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  7. package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -11
  8. package/dest/contract_function_simulator/index.d.ts +2 -1
  9. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/index.js +1 -0
  11. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -5
  12. package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
  13. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +7 -9
  14. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +1 -1
  15. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
  16. package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +1 -3
  17. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -6
  18. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +5 -10
  20. package/dest/contract_function_simulator/oracle/interfaces.d.ts +50 -45
  21. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  22. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts +9 -0
  23. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.d.ts.map +1 -0
  24. package/dest/contract_function_simulator/oracle/legacy_oracle_mappings.js +38 -0
  25. package/dest/contract_function_simulator/oracle/oracle.d.ts +64 -44
  26. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  27. package/dest/contract_function_simulator/oracle/oracle.js +187 -97
  28. package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
  29. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +23 -49
  30. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  31. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +50 -81
  32. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +66 -47
  33. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  34. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +190 -99
  35. package/dest/contract_logging.d.ts +27 -0
  36. package/dest/contract_logging.d.ts.map +1 -0
  37. package/dest/contract_logging.js +38 -0
  38. package/dest/contract_sync/contract_sync_service.d.ts +6 -5
  39. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -1
  40. package/dest/contract_sync/contract_sync_service.js +44 -37
  41. package/dest/contract_sync/helpers.d.ts +2 -3
  42. package/dest/contract_sync/helpers.d.ts.map +1 -1
  43. package/dest/contract_sync/helpers.js +7 -2
  44. package/dest/debug/pxe_debug_utils.d.ts +3 -3
  45. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  46. package/dest/debug/pxe_debug_utils.js +4 -4
  47. package/dest/entrypoints/client/bundle/index.d.ts +2 -2
  48. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  49. package/dest/entrypoints/client/bundle/index.js +1 -1
  50. package/dest/entrypoints/client/lazy/index.d.ts +2 -2
  51. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  52. package/dest/entrypoints/client/lazy/index.js +1 -1
  53. package/dest/entrypoints/server/index.d.ts +1 -2
  54. package/dest/entrypoints/server/index.d.ts.map +1 -1
  55. package/dest/entrypoints/server/index.js +0 -1
  56. package/dest/events/event_service.d.ts +3 -2
  57. package/dest/events/event_service.d.ts.map +1 -1
  58. package/dest/events/event_service.js +16 -4
  59. package/dest/logs/log_service.d.ts +6 -7
  60. package/dest/logs/log_service.d.ts.map +1 -1
  61. package/dest/logs/log_service.js +34 -32
  62. package/dest/messages/message_context_service.d.ts +17 -0
  63. package/dest/messages/message_context_service.d.ts.map +1 -0
  64. package/dest/messages/message_context_service.js +36 -0
  65. package/dest/notes/note_service.d.ts +4 -5
  66. package/dest/notes/note_service.d.ts.map +1 -1
  67. package/dest/notes/note_service.js +14 -5
  68. package/dest/notes_filter.d.ts +2 -3
  69. package/dest/notes_filter.d.ts.map +1 -1
  70. package/dest/oracle_version.d.ts +2 -2
  71. package/dest/oracle_version.js +3 -3
  72. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  73. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  74. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +125 -64
  75. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  76. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  77. package/dest/private_kernel/hints/test_utils.js +203 -0
  78. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  79. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  80. package/dest/private_kernel/private_kernel_execution_prover.js +13 -5
  81. package/dest/pxe.d.ts +14 -12
  82. package/dest/pxe.d.ts.map +1 -1
  83. package/dest/pxe.js +56 -35
  84. package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
  85. package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
  86. package/dest/storage/capsule_store/capsule_service.js +50 -0
  87. package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
  88. package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
  89. package/dest/storage/capsule_store/capsule_store.js +33 -28
  90. package/dest/storage/capsule_store/index.d.ts +2 -1
  91. package/dest/storage/capsule_store/index.d.ts.map +1 -1
  92. package/dest/storage/capsule_store/index.js +1 -0
  93. package/dest/storage/metadata.d.ts +1 -1
  94. package/dest/storage/metadata.js +1 -1
  95. package/dest/storage/note_store/note_store.d.ts +1 -1
  96. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  97. package/dest/storage/note_store/note_store.js +2 -2
  98. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  99. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  100. package/dest/storage/tagging_store/sender_tagging_store.d.ts +29 -28
  101. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  102. package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
  103. package/dest/tagging/index.d.ts +3 -3
  104. package/dest/tagging/index.d.ts.map +1 -1
  105. package/dest/tagging/index.js +1 -1
  106. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  107. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  108. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +3 -3
  109. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  110. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  111. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  112. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  113. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  114. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +13 -7
  115. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +4 -3
  116. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
  117. package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +20 -10
  118. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -7
  119. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  120. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +36 -24
  121. package/package.json +16 -16
  122. package/src/config/package_info.ts +1 -1
  123. package/src/contract_function_simulator/contract_function_simulator.ts +55 -24
  124. package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -14
  125. package/src/contract_function_simulator/index.ts +1 -0
  126. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +8 -8
  127. package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +1 -4
  128. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +3 -9
  129. package/src/contract_function_simulator/oracle/interfaces.ts +63 -54
  130. package/src/contract_function_simulator/oracle/legacy_oracle_mappings.ts +98 -0
  131. package/src/contract_function_simulator/oracle/oracle.ts +223 -139
  132. package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
  133. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +58 -103
  134. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +320 -123
  135. package/src/contract_logging.ts +52 -0
  136. package/src/contract_sync/contract_sync_service.ts +77 -59
  137. package/src/contract_sync/helpers.ts +4 -4
  138. package/src/debug/pxe_debug_utils.ts +7 -7
  139. package/src/entrypoints/client/bundle/index.ts +1 -1
  140. package/src/entrypoints/client/lazy/index.ts +1 -1
  141. package/src/entrypoints/server/index.ts +0 -1
  142. package/src/events/event_service.ts +17 -4
  143. package/src/logs/log_service.ts +72 -52
  144. package/src/messages/message_context_service.ts +44 -0
  145. package/src/notes/note_service.ts +18 -8
  146. package/src/notes_filter.ts +1 -3
  147. package/src/oracle_version.ts +3 -3
  148. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +157 -110
  149. package/src/private_kernel/hints/test_utils.ts +325 -0
  150. package/src/private_kernel/private_kernel_execution_prover.ts +13 -6
  151. package/src/pxe.ts +84 -45
  152. package/src/storage/capsule_store/capsule_service.ts +90 -0
  153. package/src/storage/capsule_store/capsule_store.ts +34 -26
  154. package/src/storage/capsule_store/index.ts +1 -0
  155. package/src/storage/metadata.ts +1 -1
  156. package/src/storage/note_store/note_store.ts +2 -5
  157. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  158. package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
  159. package/src/tagging/index.ts +2 -2
  160. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +3 -6
  161. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  162. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +23 -10
  163. package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +26 -11
  164. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -26
  165. package/dest/access_scopes.d.ts +0 -9
  166. package/dest/access_scopes.d.ts.map +0 -1
  167. package/dest/access_scopes.js +0 -6
  168. package/src/access_scopes.ts +0 -9
@@ -0,0 +1,52 @@
1
+ import type { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { type LogLevel, type Logger, applyStringFormatting, createLogger } from '@aztec/foundation/log';
3
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
+ import type { DebugLog } from '@aztec/stdlib/logs';
5
+
6
+ /** Resolves a contract address to a human-readable name, if available. */
7
+ export type ContractNameResolver = (address: AztecAddress) => Promise<string | undefined>;
8
+ export type CONTRACT_LOG_KIND = 'aztecnr' | 'user';
9
+
10
+ /**
11
+ * Creates a logger whose output is prefixed with `contract:<name>(<addrAbbrev>)`.
12
+ */
13
+ export async function createContractLogger(
14
+ contractAddress: AztecAddress,
15
+ getContractName: ContractNameResolver,
16
+ kind: CONTRACT_LOG_KIND,
17
+ options?: { instanceId?: string },
18
+ ): Promise<Logger> {
19
+ const addrAbbrev = contractAddress.toString().slice(0, 10);
20
+ const name = await getContractName(contractAddress);
21
+
22
+ const prefix = kind == 'aztecnr' ? 'aztecnr' : 'contract';
23
+ const module = name ? `${prefix}:${name}(${addrAbbrev})` : `${prefix}:Unknown(${addrAbbrev})`;
24
+ return createLogger(module, options);
25
+ }
26
+
27
+ /**
28
+ * Formats and emits a single contract log message through the given logger.
29
+ */
30
+ export function logContractMessage(logger: Logger, level: LogLevel, message: string, fields: Fr[]): void {
31
+ logger[level](applyStringFormatting(message, fields));
32
+ }
33
+
34
+ /**
35
+ * Displays debug logs collected during public function simulation,
36
+ * using the `contract:` prefixed logger format.
37
+ */
38
+ export async function displayDebugLogs(debugLogs: DebugLog[], getContractName: ContractNameResolver): Promise<void> {
39
+ for (const log of debugLogs) {
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 };
51
+ }
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';
@@ -20,12 +19,12 @@ export class ContractSyncService implements StagedStore {
20
19
  readonly storeName = 'contract_sync';
21
20
 
22
21
  // Tracks contracts synced since last wipe. The cache is keyed per individual scope address
23
- // (`contractAddress:scopeAddress`), or `contractAddress:*` for undefined scopes (all accounts).
22
+ // (`contractAddress:scopeAddress`), or `contractAddress:*` for all scopes (all accounts).
24
23
  // The value is a promise that resolves when the contract is synced.
25
24
  private syncedContracts: Map<string, Promise<void>> = new Map();
26
25
 
27
- // Per-job overridden contract addresses - these contracts should not be synced.
28
- private overriddenContracts: Map<string, Set<string>> = new Map();
26
+ // Per-job excluded contract addresses - these contracts should not be synced.
27
+ private excludedFromSync: Map<string, Set<string>> = new Map();
29
28
 
30
29
  constructor(
31
30
  private aztecNode: AztecNode,
@@ -35,8 +34,8 @@ export class ContractSyncService implements StagedStore {
35
34
  ) {}
36
35
 
37
36
  /** Sets contracts that should be skipped during sync for a specific job. */
38
- setOverriddenContracts(jobId: string, addresses: Set<string>): void {
39
- this.overriddenContracts.set(jobId, addresses);
37
+ setExcludedFromSync(jobId: string, addresses: Set<string>): void {
38
+ this.excludedFromSync.set(jobId, addresses);
40
39
  }
41
40
 
42
41
  /**
@@ -51,72 +50,65 @@ 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
- // Skip sync if this contract has an override for this job (overrides are keyed by contract address only)
60
- const overrides = this.overriddenContracts.get(jobId);
61
- if (overrides?.has(contractAddress.toString())) {
58
+ if (this.#shouldSkipSync(jobId, contractAddress)) {
62
59
  return;
63
60
  }
64
61
 
65
- // Skip sync if we already synced for "all scopes", or if we have an empty list of scopes
66
- const allScopesKey = toKey(contractAddress, 'ALL_SCOPES');
67
- const allScopesExisting = this.syncedContracts.get(allScopesKey);
68
- if (allScopesExisting || (scopes !== 'ALL_SCOPES' && scopes.length == 0)) {
69
- return;
70
- }
71
-
72
- const unsyncedScopes =
73
- scopes === 'ALL_SCOPES'
74
- ? scopes
75
- : scopes.filter(scope => !this.syncedContracts.has(toKey(contractAddress, scope)));
76
- const unsyncedScopesKeys = toKeys(contractAddress, unsyncedScopes);
77
-
78
- if (unsyncedScopesKeys.length > 0) {
79
- // Start sync and store the promise for all unsynced scopes
80
- const promise = this.#doSync(
62
+ this.#startSyncIfNeeded(contractAddress, scopes, scopesToSync =>
63
+ this.#syncContract(
81
64
  contractAddress,
82
65
  functionToInvokeAfterSync,
83
66
  utilityExecutor,
84
67
  anchorBlockHeader,
85
68
  jobId,
86
- unsyncedScopes,
87
- ).catch(err => {
88
- // There was an error syncing the contract, so we remove it from the cache so that it can be retried.
89
- unsyncedScopesKeys.forEach(key => this.syncedContracts.delete(key));
90
- throw err;
91
- });
92
- unsyncedScopesKeys.forEach(key => this.syncedContracts.set(key, promise));
93
- }
69
+ scopesToSync,
70
+ ),
71
+ );
94
72
 
95
- const promises = toKeys(contractAddress, scopes).map(key => this.syncedContracts.get(key)!);
96
- await Promise.all(promises);
73
+ await this.#awaitSync(contractAddress, scopes);
97
74
  }
98
75
 
99
- async #doSync(
76
+ /** Clears sync cache entries for the given scopes of a contract. */
77
+ invalidateContractForScopes(contractAddress: AztecAddress, scopes: AztecAddress[]): void {
78
+ if (scopes.length === 0) {
79
+ return;
80
+ }
81
+ scopes.forEach(scope => this.syncedContracts.delete(toKey(contractAddress, scope)));
82
+ }
83
+
84
+ async #syncContract(
100
85
  contractAddress: AztecAddress,
101
86
  functionToInvokeAfterSync: FunctionSelector | null,
102
- utilityExecutor: (call: FunctionCall, scopes: AccessScopes) => Promise<any>,
87
+ utilityExecutor: (call: FunctionCall, scopes: AztecAddress[]) => Promise<any>,
103
88
  anchorBlockHeader: BlockHeader,
104
89
  jobId: string,
105
- scopes: AccessScopes,
90
+ scopes: AztecAddress[],
106
91
  ): Promise<void> {
107
92
  this.log.debug(`Syncing contract ${contractAddress}`);
93
+
108
94
  await Promise.all([
109
- syncState(
110
- contractAddress,
111
- this.contractStore,
112
- functionToInvokeAfterSync,
113
- utilityExecutor,
114
- this.noteStore,
115
- this.aztecNode,
116
- anchorBlockHeader,
117
- jobId,
118
- scopes,
119
- ),
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
+ })(),
120
112
  verifyCurrentClassId(contractAddress, this.aztecNode, this.contractStore, anchorBlockHeader),
121
113
  ]);
122
114
  this.log.debug(`Contract ${contractAddress} synced`);
@@ -129,8 +121,8 @@ export class ContractSyncService implements StagedStore {
129
121
  }
130
122
 
131
123
  commit(jobId: string): Promise<void> {
132
- // Clear overridden contracts for this job
133
- this.overriddenContracts.delete(jobId);
124
+ // Clear excluded contracts for this job
125
+ this.excludedFromSync.delete(jobId);
134
126
  return Promise.resolve();
135
127
  }
136
128
 
@@ -138,15 +130,41 @@ export class ContractSyncService implements StagedStore {
138
130
  // We clear the synced contracts cache here because, when the job is discarded, any associated database writes from
139
131
  // the sync are also undone.
140
132
  this.syncedContracts.clear();
141
- this.overriddenContracts.delete(jobId);
133
+ this.excludedFromSync.delete(jobId);
142
134
  return Promise.resolve();
143
135
  }
144
- }
136
+ /** Returns true if sync should be skipped for this contract */
137
+ #shouldSkipSync(jobId: string, contractAddress: AztecAddress): boolean {
138
+ return !!this.excludedFromSync.get(jobId)?.has(contractAddress.toString());
139
+ }
145
140
 
146
- function toKeys(contract: AztecAddress, scopes: AccessScopes) {
147
- return scopes === 'ALL_SCOPES' ? [toKey(contract, scopes)] : scopes.map(scope => toKey(contract, scope));
141
+ /** If there are unsynced scopes, starts sync and stores the promise in cache with error cleanup. */
142
+ #startSyncIfNeeded(
143
+ contractAddress: AztecAddress,
144
+ scopes: AztecAddress[],
145
+ syncFn: (scopesToSync: AztecAddress[]) => Promise<void>,
146
+ ): void {
147
+ const scopesToSync = scopes.filter(scope => !this.syncedContracts.has(toKey(contractAddress, scope)));
148
+ const keys = scopesToSync.map(scope => toKey(contractAddress, scope));
149
+ if (keys.length === 0) {
150
+ return;
151
+ }
152
+ const promise = syncFn(scopesToSync).catch(err => {
153
+ keys.forEach(key => this.syncedContracts.delete(key));
154
+ throw err;
155
+ });
156
+ keys.forEach(key => this.syncedContracts.set(key, promise));
157
+ }
158
+
159
+ /** Collects all relevant scope promises (including in-flight ones from concurrent calls) and awaits them. */
160
+ async #awaitSync(contractAddress: AztecAddress, scopes: AztecAddress[]): Promise<void> {
161
+ const promises = scopes
162
+ .map(scope => this.syncedContracts.get(toKey(contractAddress, scope)))
163
+ .filter(p => p !== undefined);
164
+ await Promise.all(promises);
165
+ }
148
166
  }
149
167
 
150
- function toKey(contract: AztecAddress, scope: AztecAddress | 'ALL_SCOPES') {
151
- return scope === 'ALL_SCOPES' ? `${contract.toString()}:*` : `${contract.toString()}:${scope.toString()}`;
168
+ function toKey(contract: AztecAddress, scope: AztecAddress) {
169
+ return `${contract.toString()}:${scope.toString()}`;
152
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';
@@ -18,11 +18,11 @@ import type { NoteStore } from '../storage/note_store/note_store.js';
18
18
  export class PXEDebugUtils {
19
19
  #putJobInQueue!: <T>(job: (jobId: string) => Promise<T>) => Promise<T>;
20
20
  #getSimulatorForTx!: (overrides?: { contracts?: ContractOverrides }) => ContractFunctionSimulator;
21
- #simulateUtility!: (
21
+ #executeUtility!: (
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
 
@@ -37,17 +37,17 @@ export class PXEDebugUtils {
37
37
  public setPXEHelpers(
38
38
  putJobInQueue: <T>(job: (jobId: string) => Promise<T>) => Promise<T>,
39
39
  getSimulatorForTx: (overrides?: { contracts?: ContractOverrides }) => ContractFunctionSimulator,
40
- simulateUtility: (
40
+ executeUtility: (
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
  ) {
48
48
  this.#putJobInQueue = putJobInQueue;
49
49
  this.#getSimulatorForTx = getSimulatorForTx;
50
- this.#simulateUtility = simulateUtility;
50
+ this.#executeUtility = executeUtility;
51
51
  }
52
52
 
53
53
  /**
@@ -73,7 +73,7 @@ export class PXEDebugUtils {
73
73
  filter.contractAddress,
74
74
  null,
75
75
  async (privateSyncCall, execScopes) =>
76
- await this.#simulateUtility(contractFunctionSimulator, privateSyncCall, [], execScopes, jobId),
76
+ await this.#executeUtility(contractFunctionSimulator, privateSyncCall, [], execScopes, jobId),
77
77
  anchorBlockHeader,
78
78
  jobId,
79
79
  filter.scopes,
@@ -1,8 +1,8 @@
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';
5
4
  export * from '../../../error_enriching.js';
5
+ export * from '../../../contract_logging.js';
6
6
  export * from '../../../storage/index.js';
7
7
  export * from './utils.js';
8
8
  export type { PXECreationOptions } from '../../pxe_creation_options.js';
@@ -1,8 +1,8 @@
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';
5
4
  export * from '../../../storage/index.js';
6
5
  export * from '../../../error_enriching.js';
6
+ export * from '../../../contract_logging.js';
7
7
  export * from './utils.js';
8
8
  export { type PXECreationOptions } from '../../pxe_creation_options.js';
@@ -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,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(
@@ -3,14 +3,19 @@ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundatio
3
3
  import type { KeyStore } from '@aztec/key-store';
4
4
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
6
- import { DirectionalAppTaggingSecret, PendingTaggedLog, SiloedTag, Tag, TxScopedL2Log } from '@aztec/stdlib/logs';
6
+ import {
7
+ ExtendedDirectionalAppTaggingSecret,
8
+ PendingTaggedLog,
9
+ SiloedTag,
10
+ Tag,
11
+ TxScopedL2Log,
12
+ } from '@aztec/stdlib/logs';
7
13
  import type { BlockHeader } from '@aztec/stdlib/tx';
8
14
 
9
- import type { AccessScopes } from '../access_scopes.js';
10
15
  import type { LogRetrievalRequest } from '../contract_function_simulator/noir-structs/log_retrieval_request.js';
11
16
  import { LogRetrievalResponse } from '../contract_function_simulator/noir-structs/log_retrieval_response.js';
12
17
  import { AddressStore } from '../storage/address_store/address_store.js';
13
- import { CapsuleStore } from '../storage/capsule_store/capsule_store.js';
18
+ import type { CapsuleService } from '../storage/capsule_store/capsule_service.js';
14
19
  import type { RecipientTaggingStore } from '../storage/tagging_store/recipient_tagging_store.js';
15
20
  import type { SenderAddressBookStore } from '../storage/tagging_store/sender_address_book_store.js';
16
21
  import {
@@ -26,7 +31,7 @@ export class LogService {
26
31
  private readonly aztecNode: AztecNode,
27
32
  private readonly anchorBlockHeader: BlockHeader,
28
33
  private readonly keyStore: KeyStore,
29
- private readonly capsuleStore: CapsuleStore,
34
+ private readonly capsuleService: CapsuleService,
30
35
  private readonly recipientTaggingStore: RecipientTaggingStore,
31
36
  private readonly senderAddressBookStore: SenderAddressBookStore,
32
37
  private readonly addressStore: AddressStore,
@@ -36,17 +41,26 @@ export class LogService {
36
41
  this.log = createLogger('pxe:log_service', bindings);
37
42
  }
38
43
 
39
- 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
+
40
54
  return await Promise.all(
41
55
  logRetrievalRequests.map(async request => {
42
56
  const [publicLog, privateLog] = await Promise.all([
43
57
  this.#getPublicLogByTag(request.tag, request.contractAddress),
44
- this.#getPrivateLogByTag(await SiloedTag.compute(request.tag, request.contractAddress)),
58
+ this.#getPrivateLogByTag(await SiloedTag.computeFromTagAndApp(request.tag, request.contractAddress)),
45
59
  ]);
46
60
 
47
61
  if (publicLog !== null && privateLog !== null) {
48
- throw new Error(
49
- `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.`,
50
64
  );
51
65
  }
52
66
 
@@ -68,9 +82,8 @@ export class LogService {
68
82
  if (logsForTag.length === 0) {
69
83
  return null;
70
84
  } else if (logsForTag.length > 1) {
71
- // TODO(#11627): handle this case
72
- throw new Error(
73
- `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.`,
74
87
  );
75
88
  }
76
89
 
@@ -92,9 +105,8 @@ export class LogService {
92
105
  if (logsForTag.length === 0) {
93
106
  return null;
94
107
  } else if (logsForTag.length > 1) {
95
- // TODO(#11627): handle this case
96
- throw new Error(
97
- `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.`,
98
110
  );
99
111
  }
100
112
 
@@ -108,53 +120,46 @@ export class LogService {
108
120
  );
109
121
  }
110
122
 
111
- public async fetchTaggedLogs(contractAddress: AztecAddress, pendingTaggedLogArrayBaseSlot: Fr, scopes: AccessScopes) {
123
+ public async fetchTaggedLogs(
124
+ contractAddress: AztecAddress,
125
+ pendingTaggedLogArrayBaseSlot: Fr,
126
+ recipient: AztecAddress,
127
+ ) {
112
128
  this.log.verbose(`Fetching tagged logs for ${contractAddress.toString()}`);
113
129
 
114
130
  // We only load logs from block up to and including the anchor block number
115
131
  const anchorBlockNumber = this.anchorBlockHeader.getBlockNumber();
116
132
  const anchorBlockHash = await this.anchorBlockHeader.hash();
117
133
 
118
- // Determine recipients: use scopes if provided, otherwise get all accounts
119
- const recipients = scopes !== 'ALL_SCOPES' && scopes.length > 0 ? scopes : await this.keyStore.getAccounts();
120
-
121
- // For each recipient, fetch secrets, load logs, and store them.
122
- // We run these per-recipient tasks in parallel so that logs are loaded for all recipients concurrently.
123
- await Promise.all(
124
- recipients.map(async recipient => {
125
- // Get all secrets for this recipient (one per sender)
126
- const secrets = await this.#getSecretsForSenders(contractAddress, recipient);
127
-
128
- // Load logs for all sender-recipient pairs in parallel
129
- const logArrays = await Promise.all(
130
- secrets.map(secret =>
131
- loadPrivateLogsForSenderRecipientPair(
132
- secret,
133
- contractAddress,
134
- this.aztecNode,
135
- this.recipientTaggingStore,
136
- anchorBlockNumber,
137
- anchorBlockHash,
138
- this.jobId,
139
- ),
140
- ),
141
- );
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
+ );
142
150
 
143
- // Flatten all logs from all secrets
144
- const allLogs = logArrays.flat();
151
+ // Flatten all logs from all secrets
152
+ const allLogs = logArrays.flat();
145
153
 
146
- // Store the logs for this recipient
147
- if (allLogs.length > 0) {
148
- await this.#storePendingTaggedLogs(contractAddress, pendingTaggedLogArrayBaseSlot, recipient, allLogs);
149
- }
150
- }),
151
- );
154
+ if (allLogs.length > 0) {
155
+ await this.#storePendingTaggedLogs(contractAddress, pendingTaggedLogArrayBaseSlot, recipient, allLogs);
156
+ }
152
157
  }
153
158
 
154
159
  async #getSecretsForSenders(
155
160
  contractAddress: AztecAddress,
156
161
  recipient: AztecAddress,
157
- ): Promise<DirectionalAppTaggingSecret[]> {
162
+ ): Promise<ExtendedDirectionalAppTaggingSecret[]> {
158
163
  const recipientCompleteAddress = await this.addressStore.getCompleteAddress(recipient);
159
164
  if (!recipientCompleteAddress) {
160
165
  return [];
@@ -171,14 +176,24 @@ export class LogService {
171
176
  );
172
177
 
173
178
  return Promise.all(
174
- deduplicatedSenders.map(sender => {
175
- return DirectionalAppTaggingSecret.compute(
179
+ deduplicatedSenders.map(async sender => {
180
+ const secret = await ExtendedDirectionalAppTaggingSecret.compute(
176
181
  recipientCompleteAddress,
177
182
  recipientIvsk,
178
183
  sender,
179
184
  contractAddress,
180
185
  recipient,
181
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;
182
197
  }),
183
198
  );
184
199
  }
@@ -196,13 +211,18 @@ export class LogService {
196
211
  scopedLog.txHash,
197
212
  scopedLog.noteHashes,
198
213
  scopedLog.firstNullifier,
199
- recipient,
200
214
  );
201
215
 
202
216
  return pendingTaggedLog.toFields();
203
217
  });
204
218
 
205
219
  // TODO: This looks like it could belong more at the oracle interface level
206
- 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
+ );
207
227
  }
208
228
  }