@aztec/pxe 0.0.1-commit.8f9871590 → 0.0.1-commit.9117c5f5a

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 (96) hide show
  1. package/dest/config/package_info.js +1 -1
  2. package/dest/contract_function_simulator/contract_function_simulator.d.ts +1 -1
  3. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  4. package/dest/contract_function_simulator/contract_function_simulator.js +8 -8
  5. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -5
  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 +3 -3
  8. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +1 -1
  9. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -2
  10. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  11. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +1 -1
  12. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +1 -1
  13. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  14. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +10 -18
  15. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +1 -1
  16. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  17. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +4 -7
  18. package/dest/contract_logging.d.ts +22 -0
  19. package/dest/contract_logging.d.ts.map +1 -0
  20. package/dest/contract_logging.js +23 -0
  21. package/dest/debug/pxe_debug_utils.d.ts +2 -2
  22. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  23. package/dest/debug/pxe_debug_utils.js +4 -4
  24. package/dest/entrypoints/client/bundle/index.d.ts +2 -1
  25. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  26. package/dest/entrypoints/client/bundle/index.js +1 -0
  27. package/dest/entrypoints/client/lazy/index.d.ts +2 -1
  28. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  29. package/dest/entrypoints/client/lazy/index.js +1 -0
  30. package/dest/logs/log_service.d.ts +1 -1
  31. package/dest/logs/log_service.d.ts.map +1 -1
  32. package/dest/logs/log_service.js +4 -4
  33. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  34. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  35. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  36. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  37. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  38. package/dest/private_kernel/hints/test_utils.js +203 -0
  39. package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
  40. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  41. package/dest/private_kernel/private_kernel_execution_prover.js +13 -5
  42. package/dest/private_kernel/private_kernel_oracle.d.ts +6 -2
  43. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  44. package/dest/private_kernel/private_kernel_oracle.js +7 -3
  45. package/dest/pxe.d.ts +8 -7
  46. package/dest/pxe.d.ts.map +1 -1
  47. package/dest/pxe.js +37 -29
  48. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  49. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  50. package/dest/storage/contract_store/contract_store.js +140 -64
  51. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  52. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  53. package/dest/storage/tagging_store/sender_tagging_store.d.ts +5 -5
  54. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  55. package/dest/storage/tagging_store/sender_tagging_store.js +4 -4
  56. package/dest/tagging/index.d.ts +2 -2
  57. package/dest/tagging/index.d.ts.map +1 -1
  58. package/dest/tagging/index.js +1 -1
  59. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  60. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  61. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +3 -3
  62. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  63. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  64. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  65. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  66. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  67. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +3 -6
  68. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +4 -7
  69. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  70. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +14 -15
  71. package/package.json +16 -16
  72. package/src/config/package_info.ts +1 -1
  73. package/src/contract_function_simulator/contract_function_simulator.ts +15 -17
  74. package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -5
  75. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +1 -1
  76. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +1 -1
  77. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +14 -20
  78. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +8 -7
  79. package/src/contract_logging.ts +39 -0
  80. package/src/debug/pxe_debug_utils.ts +4 -4
  81. package/src/entrypoints/client/bundle/index.ts +1 -0
  82. package/src/entrypoints/client/lazy/index.ts +1 -0
  83. package/src/logs/log_service.ts +10 -5
  84. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  85. package/src/private_kernel/hints/test_utils.ts +325 -0
  86. package/src/private_kernel/private_kernel_execution_prover.ts +13 -6
  87. package/src/private_kernel/private_kernel_oracle.ts +7 -7
  88. package/src/pxe.ts +41 -34
  89. package/src/storage/contract_store/contract_store.ts +170 -71
  90. package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
  91. package/src/storage/tagging_store/sender_tagging_store.ts +8 -8
  92. package/src/tagging/index.ts +1 -1
  93. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +3 -6
  94. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  95. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +4 -9
  96. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +11 -20
@@ -1,6 +1,7 @@
1
1
  import type { FUNCTION_TREE_HEIGHT } from '@aztec/constants';
2
- import type { Fr } from '@aztec/foundation/curves/bn254';
2
+ import { Fr } from '@aztec/foundation/curves/bn254';
3
3
  import { toArray } from '@aztec/foundation/iterable';
4
+ import { BufferReader, numToUInt8, serializeToBuffer } from '@aztec/foundation/serialize';
4
5
  import type { MembershipWitness } from '@aztec/foundation/trees';
5
6
  import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
6
7
  import {
@@ -19,7 +20,8 @@ import {
19
20
  } from '@aztec/stdlib/abi';
20
21
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
21
22
  import {
22
- type ContractClass,
23
+ type ContractClassIdPreimage,
24
+ type ContractClassWithId,
23
25
  type ContractInstanceWithAddress,
24
26
  SerializableContractInstance,
25
27
  getContractClassFromArtifact,
@@ -27,6 +29,68 @@ import {
27
29
 
28
30
  import { PrivateFunctionsTree } from './private_functions_tree.js';
29
31
 
32
+ const VERSION = 1 as const;
33
+
34
+ /**
35
+ * All contract class data except the large packedBytecode.
36
+ * The expensive data from the ContractClass is precomputed and stored in this format to avoid redundant hashing.
37
+ * Since we have to store the artifacts anyway, the final ContractClass is reconstructed by combining this data
38
+ * with the packedBytecode obtained from the former. That way we can have quick class lookups without wasted storage.
39
+ */
40
+ export class SerializableContractClassData {
41
+ public readonly version = VERSION;
42
+ public readonly id: Fr;
43
+ public readonly artifactHash: Fr;
44
+ public readonly privateFunctionsRoot: Fr;
45
+ public readonly publicBytecodeCommitment: Fr;
46
+ public readonly privateFunctions: { selector: FunctionSelector; vkHash: Fr }[];
47
+
48
+ constructor(
49
+ data: ContractClassIdPreimage & {
50
+ id: Fr;
51
+ privateFunctions: { selector: FunctionSelector; vkHash: Fr }[];
52
+ },
53
+ ) {
54
+ this.id = data.id;
55
+ this.artifactHash = data.artifactHash;
56
+ this.privateFunctionsRoot = data.privateFunctionsRoot;
57
+ this.publicBytecodeCommitment = data.publicBytecodeCommitment;
58
+ this.privateFunctions = data.privateFunctions;
59
+ }
60
+
61
+ toBuffer(): Buffer {
62
+ return serializeToBuffer(
63
+ numToUInt8(this.version),
64
+ this.id,
65
+ this.artifactHash,
66
+ this.privateFunctionsRoot,
67
+ this.publicBytecodeCommitment,
68
+ this.privateFunctions.length,
69
+ ...this.privateFunctions.map(fn => serializeToBuffer(fn.selector, fn.vkHash)),
70
+ );
71
+ }
72
+
73
+ static fromBuffer(bufferOrReader: Buffer | BufferReader): SerializableContractClassData {
74
+ const reader = BufferReader.asReader(bufferOrReader);
75
+ const version = reader.readUInt8();
76
+ if (version !== VERSION) {
77
+ throw new Error(`Unexpected contract class data version ${version}`);
78
+ }
79
+ return new SerializableContractClassData({
80
+ id: reader.readObject(Fr),
81
+ artifactHash: reader.readObject(Fr),
82
+ privateFunctionsRoot: reader.readObject(Fr),
83
+ publicBytecodeCommitment: reader.readObject(Fr),
84
+ privateFunctions: reader.readVector({
85
+ fromBuffer: (r: BufferReader) => ({
86
+ selector: r.readObject(FunctionSelector),
87
+ vkHash: r.readObject(Fr),
88
+ }),
89
+ }),
90
+ });
91
+ }
92
+ }
93
+
30
94
  /**
31
95
  * ContractStore serves as a data manager and retriever for Aztec.nr contracts.
32
96
  * It provides methods to obtain contract addresses, function ABI, bytecode, and membership witnesses
@@ -39,42 +103,68 @@ export class ContractStore {
39
103
  // TODO: Update it to be LRU cache so that it doesn't keep all the data all the time.
40
104
  #privateFunctionTrees: Map<string, PrivateFunctionsTree> = new Map();
41
105
 
42
- /** Map from contract address to contract class id */
106
+ /**
107
+ * In-memory cache of deserialized ContractArtifact objects, keyed by class id string.
108
+ * Avoids repeated LMDB reads + JSON.parse + Zod validation on every oracle call.
109
+ * Artifacts are large but immutable after registration — safe to cache for the lifetime of the store.
110
+ */
111
+ // TODO: Update it to be LRU cache so that it doesn't keep all the data all the time.
112
+ #contractArtifactCache: Map<string, ContractArtifact> = new Map();
113
+
114
+ /** Map from contract address to contract class id (avoids KV round-trip on hot path). */
43
115
  #contractClassIdMap: Map<string, Fr> = new Map();
44
116
 
45
117
  #store: AztecAsyncKVStore;
46
118
  #contractArtifacts: AztecAsyncMap<string, Buffer>;
119
+ #contractClassData: AztecAsyncMap<string, Buffer>;
47
120
  #contractInstances: AztecAsyncMap<string, Buffer>;
48
121
 
49
122
  constructor(store: AztecAsyncKVStore) {
50
123
  this.#store = store;
51
124
  this.#contractArtifacts = store.openMap('contract_artifacts');
125
+ this.#contractClassData = store.openMap('contract_classes');
52
126
  this.#contractInstances = store.openMap('contracts_instances');
53
127
  }
54
128
 
55
129
  // Setters
56
130
 
57
- public async addContractArtifact(id: Fr, contract: ContractArtifact): Promise<void> {
58
- // Validation outside transactionAsync - these are not DB operations
131
+ /**
132
+ * Registers a new contract artifact and its corresponding class data.
133
+ * IMPORTANT: This method does not verify that the provided artifact matches the class data or that the class id matches the artifact.
134
+ * It is the caller's responsibility to ensure the consistency and correctness of the provided data.
135
+ * This is done to avoid redundant, expensive contract class computations
136
+ */
137
+ public async addContractArtifact(
138
+ contract: ContractArtifact,
139
+ contractClassWithIdAndPreimage?: ContractClassWithId & ContractClassIdPreimage,
140
+ ): Promise<Fr> {
141
+ const contractClass = contractClassWithIdAndPreimage ?? (await getContractClassFromArtifact(contract));
142
+ const key = contractClass.id.toString();
143
+
144
+ if (this.#contractArtifactCache.has(key)) {
145
+ return contractClass.id;
146
+ }
147
+
59
148
  const privateFunctions = contract.functions.filter(
60
149
  functionArtifact => functionArtifact.functionType === FunctionType.PRIVATE,
61
150
  );
62
-
63
151
  const privateSelectors = await Promise.all(
64
- privateFunctions.map(async privateFunctionArtifact =>
65
- (
66
- await FunctionSelector.fromNameAndParameters(privateFunctionArtifact.name, privateFunctionArtifact.parameters)
67
- ).toString(),
152
+ privateFunctions.map(async fn =>
153
+ (await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters)).toString(),
68
154
  ),
69
155
  );
70
-
71
156
  if (privateSelectors.length !== new Set(privateSelectors).size) {
72
157
  throw new Error('Repeated function selectors of private functions');
73
158
  }
74
159
 
75
- await this.#store.transactionAsync(() =>
76
- this.#contractArtifacts.set(id.toString(), contractArtifactToBuffer(contract)),
77
- );
160
+ this.#contractArtifactCache.set(key, contract);
161
+
162
+ await this.#store.transactionAsync(async () => {
163
+ await this.#contractArtifacts.set(key, contractArtifactToBuffer(contract));
164
+ await this.#contractClassData.set(key, new SerializableContractClassData(contractClass).toBuffer());
165
+ });
166
+
167
+ return contractClass.id;
78
168
  }
79
169
 
80
170
  async addContractInstance(contract: ContractInstanceWithAddress): Promise<void> {
@@ -89,26 +179,17 @@ export class ContractStore {
89
179
  // Private getters
90
180
 
91
181
  async #getContractClassId(contractAddress: AztecAddress): Promise<Fr | undefined> {
92
- if (!this.#contractClassIdMap.has(contractAddress.toString())) {
182
+ const key = contractAddress.toString();
183
+ if (!this.#contractClassIdMap.has(key)) {
93
184
  const instance = await this.getContractInstance(contractAddress);
94
185
  if (!instance) {
95
186
  return;
96
187
  }
97
- this.#contractClassIdMap.set(contractAddress.toString(), instance.currentContractClassId);
188
+ this.#contractClassIdMap.set(key, instance.currentContractClassId);
98
189
  }
99
- return this.#contractClassIdMap.get(contractAddress.toString());
190
+ return this.#contractClassIdMap.get(key);
100
191
  }
101
192
 
102
- /**
103
- * Retrieve or create a ContractTree instance based on the provided class id.
104
- * If an existing tree with the same class id is found in the cache, it will be returned.
105
- * Otherwise, a new ContractTree instance will be created using the contract data from the database
106
- * and added to the cache before returning.
107
- *
108
- * @param classId - The class id of the contract for which the ContractTree is required.
109
- * @returns A ContractTree instance associated with the specified contract address.
110
- * @throws An Error if the contract is not found in the ContractDatabase.
111
- */
112
193
  async #getPrivateFunctionTreeForClassId(classId: Fr): Promise<PrivateFunctionsTree | undefined> {
113
194
  if (!this.#privateFunctionTrees.has(classId.toString())) {
114
195
  const artifact = await this.getContractArtifact(classId);
@@ -121,9 +202,9 @@ export class ContractStore {
121
202
  return this.#privateFunctionTrees.get(classId.toString())!;
122
203
  }
123
204
 
124
- async #getContractArtifactByAddress(contractAddress: AztecAddress): Promise<ContractArtifact | undefined> {
125
- const contractClassId = await this.#getContractClassId(contractAddress);
126
- return contractClassId && this.getContractArtifact(contractClassId);
205
+ async #getArtifactByAddress(contractAddress: AztecAddress): Promise<ContractArtifact | undefined> {
206
+ const classId = await this.#getContractClassId(contractAddress);
207
+ return classId && this.getContractArtifact(classId);
127
208
  }
128
209
 
129
210
  // Public getters
@@ -135,7 +216,7 @@ export class ContractStore {
135
216
  });
136
217
  }
137
218
 
138
- /** Returns a contract instance for a given address. Throws if not found. */
219
+ /** Returns a contract instance for a given address. */
139
220
  public getContractInstance(contractAddress: AztecAddress): Promise<ContractInstanceWithAddress | undefined> {
140
221
  return this.#store.transactionAsync(async () => {
141
222
  const contract = await this.#contractInstances.getAsync(contractAddress.toString());
@@ -143,18 +224,39 @@ export class ContractStore {
143
224
  });
144
225
  }
145
226
 
146
- public getContractArtifact(contractClassId: Fr): Promise<ContractArtifact | undefined> {
147
- return this.#store.transactionAsync(async () => {
148
- const contract = await this.#contractArtifacts.getAsync(contractClassId.toString());
149
- // TODO(@spalladino): AztecAsyncMap lies and returns Uint8Arrays instead of Buffers, hence the extra Buffer.from.
150
- return contract && contractArtifactFromBuffer(Buffer.from(contract));
227
+ /** Returns the raw contract artifact for a given class id. */
228
+ public async getContractArtifact(contractClassId: Fr): Promise<ContractArtifact | undefined> {
229
+ const key = contractClassId.toString();
230
+ const cached = this.#contractArtifactCache.get(key);
231
+ if (cached) {
232
+ return cached;
233
+ }
234
+ const artifact = await this.#store.transactionAsync(async () => {
235
+ const buf = await this.#contractArtifacts.getAsync(key);
236
+ return buf && contractArtifactFromBuffer(buf);
151
237
  });
238
+ if (artifact) {
239
+ this.#contractArtifactCache.set(key, artifact);
240
+ }
241
+ return artifact;
152
242
  }
153
243
 
154
- /** Returns a contract class for a given class id. Throws if not found. */
155
- public async getContractClass(contractClassId: Fr): Promise<ContractClass | undefined> {
244
+ /** Returns a contract class for a given class id. */
245
+ public async getContractClassWithPreimage(
246
+ contractClassId: Fr,
247
+ ): Promise<(ContractClassWithId & ContractClassIdPreimage) | undefined> {
248
+ const key = contractClassId.toString();
249
+ const buf = await this.#contractClassData.getAsync(key);
250
+ if (!buf) {
251
+ return undefined;
252
+ }
253
+ const classData = SerializableContractClassData.fromBuffer(buf);
156
254
  const artifact = await this.getContractArtifact(contractClassId);
157
- return artifact && getContractClassFromArtifact(artifact);
255
+ if (!artifact) {
256
+ return undefined;
257
+ }
258
+ const packedBytecode = artifact.functions.find(f => f.name === 'public_dispatch')?.bytecode ?? Buffer.alloc(0);
259
+ return { ...classData, packedBytecode };
158
260
  }
159
261
 
160
262
  public async getContract(
@@ -173,8 +275,6 @@ export class ContractStore {
173
275
 
174
276
  /**
175
277
  * Retrieves the artifact of a specified function within a given contract.
176
- * The function is identified by its selector, which is a unique code generated from the function's signature.
177
- * Throws an error if the contract address or function selector are invalid or not found.
178
278
  *
179
279
  * @param contractAddress - The AztecAddress representing the contract containing the function.
180
280
  * @param selector - The function selector.
@@ -184,9 +284,12 @@ export class ContractStore {
184
284
  contractAddress: AztecAddress,
185
285
  selector: FunctionSelector,
186
286
  ): Promise<FunctionArtifactWithContractName | undefined> {
187
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
188
- const fnArtifact = artifact && (await this.#findFunctionArtifactBySelector(artifact, selector));
189
- return fnArtifact && { ...fnArtifact, contractName: artifact.name };
287
+ const artifact = await this.#getArtifactByAddress(contractAddress);
288
+ if (!artifact) {
289
+ return undefined;
290
+ }
291
+ const fn = await this.#findFunctionArtifactBySelector(artifact, selector);
292
+ return fn && { ...fn, contractName: artifact.name };
190
293
  }
191
294
 
192
295
  public async getFunctionArtifactWithDebugMetadata(
@@ -207,50 +310,48 @@ export class ContractStore {
207
310
  public async getPublicFunctionArtifact(
208
311
  contractAddress: AztecAddress,
209
312
  ): Promise<FunctionArtifactWithContractName | undefined> {
210
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
211
- const fnArtifact = artifact && artifact.functions.find(fn => fn.functionType === FunctionType.PUBLIC);
212
- return fnArtifact && { ...fnArtifact, contractName: artifact.name };
313
+ const artifact = await this.#getArtifactByAddress(contractAddress);
314
+ const fn = artifact && artifact.functions.find(f => f.functionType === FunctionType.PUBLIC);
315
+ return fn && { ...fn, contractName: artifact.name };
213
316
  }
214
317
 
215
318
  public async getFunctionAbi(
216
319
  contractAddress: AztecAddress,
217
320
  selector: FunctionSelector,
218
321
  ): Promise<FunctionAbi | undefined> {
219
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
322
+ const artifact = await this.#getArtifactByAddress(contractAddress);
220
323
  return artifact && (await this.#findFunctionAbiBySelector(artifact, selector));
221
324
  }
222
325
 
223
326
  /**
224
327
  * Retrieves the debug metadata of a specified function within a given contract.
225
- * The function is identified by its selector, which is a unique code generated from the function's signature.
226
- * Returns undefined if the debug metadata for the given function is not found.
227
- * Throws if the contract has not been added to the database.
228
328
  *
229
329
  * @param contractAddress - The AztecAddress representing the contract containing the function.
230
330
  * @param selector - The function selector.
231
- * @returns The corresponding function's artifact as an object.
331
+ * @returns The corresponding function's debug metadata, or undefined.
232
332
  */
233
333
  public async getFunctionDebugMetadata(
234
334
  contractAddress: AztecAddress,
235
335
  selector: FunctionSelector,
236
336
  ): Promise<FunctionDebugMetadata | undefined> {
237
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
238
- const fnArtifact = artifact && (await this.#findFunctionArtifactBySelector(artifact, selector));
239
- return fnArtifact && getFunctionDebugMetadata(artifact, fnArtifact);
337
+ const artifact = await this.#getArtifactByAddress(contractAddress);
338
+ if (!artifact) {
339
+ return undefined;
340
+ }
341
+ const fn = await this.#findFunctionArtifactBySelector(artifact, selector);
342
+ return fn && getFunctionDebugMetadata(artifact, fn);
240
343
  }
241
344
 
242
345
  public async getPublicFunctionDebugMetadata(
243
346
  contractAddress: AztecAddress,
244
347
  ): Promise<FunctionDebugMetadata | undefined> {
245
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
246
- const fnArtifact = artifact && artifact.functions.find(fn => fn.functionType === FunctionType.PUBLIC);
247
- return fnArtifact && getFunctionDebugMetadata(artifact, fnArtifact);
348
+ const artifact = await this.#getArtifactByAddress(contractAddress);
349
+ const fn = artifact && artifact.functions.find(f => f.functionType === FunctionType.PUBLIC);
350
+ return fn && getFunctionDebugMetadata(artifact, fn);
248
351
  }
249
352
 
250
353
  /**
251
354
  * Retrieve the function membership witness for the given contract class and function selector.
252
- * The function membership witness represents a proof that the function belongs to the specified contract.
253
- * Throws an error if the contract address or function selector is unknown.
254
355
  *
255
356
  * @param contractClassId - The id of the class.
256
357
  * @param selector - The function selector.
@@ -265,23 +366,21 @@ export class ContractStore {
265
366
  }
266
367
 
267
368
  public async getDebugContractName(contractAddress: AztecAddress) {
268
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
369
+ const artifact = await this.#getArtifactByAddress(contractAddress);
269
370
  return artifact?.name;
270
371
  }
271
372
 
272
373
  public async getDebugFunctionName(contractAddress: AztecAddress, selector: FunctionSelector) {
273
- const artifact = await this.#getContractArtifactByAddress(contractAddress);
274
- const fnArtifact = artifact && (await this.#findFunctionAbiBySelector(artifact, selector));
275
- return `${artifact?.name ?? contractAddress}:${fnArtifact?.name ?? selector}`;
374
+ const artifact = await this.#getArtifactByAddress(contractAddress);
375
+ const fn = artifact && (await this.#findFunctionAbiBySelector(artifact, selector));
376
+ return `${artifact?.name ?? contractAddress}:${fn?.name ?? selector}`;
276
377
  }
277
378
 
278
379
  async #findFunctionArtifactBySelector(
279
380
  artifact: ContractArtifact,
280
381
  selector: FunctionSelector,
281
382
  ): Promise<FunctionArtifact | undefined> {
282
- const functions = artifact.functions;
283
- for (let i = 0; i < functions.length; i++) {
284
- const fn = functions[i];
383
+ for (const fn of artifact.functions) {
285
384
  const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
286
385
  if (fnSelector.equals(selector)) {
287
386
  return fn;
@@ -293,9 +392,7 @@ export class ContractStore {
293
392
  artifact: ContractArtifact,
294
393
  selector: FunctionSelector,
295
394
  ): Promise<FunctionAbi | undefined> {
296
- const functions = [...artifact.functions, ...(artifact.nonDispatchPublicFunctions ?? [])];
297
- for (let i = 0; i < functions.length; i++) {
298
- const fn = functions[i];
395
+ for (const fn of [...artifact.functions, ...(artifact.nonDispatchPublicFunctions ?? [])]) {
299
396
  const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
300
397
  if (fnSelector.equals(selector)) {
301
398
  return fn;
@@ -316,10 +413,12 @@ export class ContractStore {
316
413
  throw new Error(`Unknown function ${functionName} in contract ${contract.name}.`);
317
414
  }
318
415
 
416
+ const selector = await FunctionSelector.fromNameAndParameters(functionDao.name, functionDao.parameters);
417
+
319
418
  return FunctionCall.from({
320
419
  name: functionDao.name,
321
420
  to,
322
- selector: await FunctionSelector.fromNameAndParameters(functionDao.name, functionDao.parameters),
421
+ selector,
323
422
  type: functionDao.functionType,
324
423
  hideMsgSender: false,
325
424
  isStatic: functionDao.isStatic,
@@ -1,5 +1,5 @@
1
1
  import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
2
- import type { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
2
+ import type { ExtendedDirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
3
3
 
4
4
  import type { StagedStore } from '../../job_coordinator/job_coordinator.js';
5
5
 
@@ -106,11 +106,11 @@ export class RecipientTaggingStore implements StagedStore {
106
106
  return Promise.resolve();
107
107
  }
108
108
 
109
- getHighestAgedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
109
+ getHighestAgedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
110
110
  return this.#store.transactionAsync(() => this.#readHighestAgedIndex(jobId, secret.toString()));
111
111
  }
112
112
 
113
- updateHighestAgedIndex(secret: DirectionalAppTaggingSecret, index: number, jobId: string): Promise<void> {
113
+ updateHighestAgedIndex(secret: ExtendedDirectionalAppTaggingSecret, index: number, jobId: string): Promise<void> {
114
114
  return this.#store.transactionAsync(async () => {
115
115
  const currentIndex = await this.#readHighestAgedIndex(jobId, secret.toString());
116
116
  if (currentIndex !== undefined && index <= currentIndex) {
@@ -121,11 +121,15 @@ export class RecipientTaggingStore implements StagedStore {
121
121
  });
122
122
  }
123
123
 
124
- getHighestFinalizedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
124
+ getHighestFinalizedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
125
125
  return this.#store.transactionAsync(() => this.#readHighestFinalizedIndex(jobId, secret.toString()));
126
126
  }
127
127
 
128
- updateHighestFinalizedIndex(secret: DirectionalAppTaggingSecret, index: number, jobId: string): Promise<void> {
128
+ updateHighestFinalizedIndex(
129
+ secret: ExtendedDirectionalAppTaggingSecret,
130
+ index: number,
131
+ jobId: string,
132
+ ): Promise<void> {
129
133
  return this.#store.transactionAsync(async () => {
130
134
  const currentIndex = await this.#readHighestFinalizedIndex(jobId, secret.toString());
131
135
  if (currentIndex !== undefined && index < currentIndex) {
@@ -1,5 +1,5 @@
1
1
  import type { AztecAsyncKVStore, AztecAsyncMap } from '@aztec/kv-store';
2
- import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
2
+ import type { ExtendedDirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
3
3
  import { TxHash } from '@aztec/stdlib/tx';
4
4
 
5
5
  import type { StagedStore } from '../../job_coordinator/job_coordinator.js';
@@ -154,7 +154,7 @@ export class SenderTaggingStore implements StagedStore {
154
154
 
155
155
  // The secrets in pre-tags should be unique because we always store just the highest index per given secret-txHash
156
156
  // pair. Below we check that this is the case.
157
- const secretsSet = new Set(preTags.map(preTag => preTag.secret.toString()));
157
+ const secretsSet = new Set(preTags.map(preTag => preTag.extendedSecret.toString()));
158
158
  if (secretsSet.size !== preTags.length) {
159
159
  return Promise.reject(new Error(`Duplicate secrets found when storing pending indexes`));
160
160
  }
@@ -163,10 +163,10 @@ export class SenderTaggingStore implements StagedStore {
163
163
 
164
164
  return this.#store.transactionAsync(async () => {
165
165
  // Prefetch all data, start reads during iteration to keep IndexedDB transaction alive
166
- const preTagReadPromises = preTags.map(({ secret, index }) => {
167
- const secretStr = secret.toString();
166
+ const preTagReadPromises = preTags.map(({ extendedSecret, index }) => {
167
+ const secretStr = extendedSecret.toString();
168
168
  return {
169
- secret,
169
+ extendedSecret,
170
170
  secretStr,
171
171
  index,
172
172
  pending: this.#readPendingIndexes(jobId, secretStr),
@@ -233,7 +233,7 @@ export class SenderTaggingStore implements StagedStore {
233
233
  * [startIndex, endIndex). Returns an empty array if no pending indexes exist in the range.
234
234
  */
235
235
  getTxHashesOfPendingIndexes(
236
- secret: DirectionalAppTaggingSecret,
236
+ secret: ExtendedDirectionalAppTaggingSecret,
237
237
  startIndex: number,
238
238
  endIndex: number,
239
239
  jobId: string,
@@ -252,7 +252,7 @@ export class SenderTaggingStore implements StagedStore {
252
252
  * @param secret - The secret to get the last finalized index for.
253
253
  * @returns The last (highest) finalized index for the given secret.
254
254
  */
255
- getLastFinalizedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
255
+ getLastFinalizedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
256
256
  return this.#store.transactionAsync(() => this.#readLastFinalizedIndex(jobId, secret.toString()));
257
257
  }
258
258
 
@@ -262,7 +262,7 @@ export class SenderTaggingStore implements StagedStore {
262
262
  * @param secret - The directional app tagging secret to query the last used index for.
263
263
  * @returns The last used index.
264
264
  */
265
- getLastUsedIndex(secret: DirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
265
+ getLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret, jobId: string): Promise<number | undefined> {
266
266
  const secretStr = secret.toString();
267
267
 
268
268
  return this.#store.transactionAsync(async () => {
@@ -15,5 +15,5 @@ export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from './constants.js';
15
15
  export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract } from './get_all_logs_by_tags.js';
16
16
 
17
17
  // Re-export tagging-related types from stdlib
18
- export { DirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
18
+ export { ExtendedDirectionalAppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
19
19
  export { type PreTag } from '@aztec/stdlib/logs';
@@ -1,8 +1,7 @@
1
1
  import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
2
  import type { BlockHash } from '@aztec/stdlib/block';
4
3
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
- import type { DirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
4
+ import type { ExtendedDirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
6
5
 
7
6
  import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
8
7
  import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
@@ -10,15 +9,14 @@ import { findHighestIndexes } from './utils/find_highest_indexes.js';
10
9
  import { loadLogsForRange } from './utils/load_logs_for_range.js';
11
10
 
12
11
  /**
13
- * Loads private logs for `app` and sender-recipient pair defined by `secret` and updates the highest aged and
12
+ * Loads private logs for the app-sender-recipient triplet defined by `secret` and updates the highest aged and
14
13
  * finalized indexes in the db. At most load logs from blocks up to and including `anchorBlockNumber`.
15
14
  *
16
15
  * @dev This function can be safely executed "in parallel" for other sender-recipient pairs because the data in
17
16
  * in the tagging data provider is indexed by the secret and hence completely disjoint.
18
17
  */
19
18
  export async function loadPrivateLogsForSenderRecipientPair(
20
- secret: DirectionalAppTaggingSecret,
21
- app: AztecAddress,
19
+ secret: ExtendedDirectionalAppTaggingSecret,
22
20
  aztecNode: AztecNode,
23
21
  taggingStore: RecipientTaggingStore,
24
22
  anchorBlockNumber: BlockNumber,
@@ -96,7 +94,6 @@ export async function loadPrivateLogsForSenderRecipientPair(
96
94
  // Get private logs with their block timestamps and corresponding tagging indexes
97
95
  const privateLogsWithIndexes = await loadLogsForRange(
98
96
  secret,
99
- app,
100
97
  aztecNode,
101
98
  start,
102
99
  end,
@@ -1,32 +1,27 @@
1
1
  import type { BlockNumber } from '@aztec/foundation/branded-types';
2
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
2
  import type { BlockHash } from '@aztec/stdlib/block';
4
3
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
5
- import type { DirectionalAppTaggingSecret, PreTag, TxScopedL2Log } from '@aztec/stdlib/logs';
6
- import { SiloedTag, Tag } from '@aztec/stdlib/logs';
4
+ import type { ExtendedDirectionalAppTaggingSecret, TxScopedL2Log } from '@aztec/stdlib/logs';
5
+ import { SiloedTag } from '@aztec/stdlib/logs';
7
6
 
8
7
  import { getAllPrivateLogsByTags } from '../../get_all_logs_by_tags.js';
9
8
 
10
9
  /**
11
- * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range, `app` and
12
- * `secret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and `end` is
13
- * exclusive.
10
+ * Gets private logs with their corresponding block timestamps and tagging indexes for the given index range and
11
+ * `extendedSecret`. At most load logs from blocks up to and including `anchorBlockNumber`. `start` is inclusive and
12
+ * `end` is exclusive.
14
13
  */
15
14
  export async function loadLogsForRange(
16
- secret: DirectionalAppTaggingSecret,
17
- app: AztecAddress,
15
+ extendedSecret: ExtendedDirectionalAppTaggingSecret,
18
16
  aztecNode: AztecNode,
19
17
  start: number,
20
18
  end: number,
21
19
  anchorBlockNumber: BlockNumber,
22
20
  anchorBlockHash: BlockHash,
23
21
  ): Promise<Array<{ log: TxScopedL2Log; taggingIndex: number }>> {
24
- // Derive tags for the window
25
- const preTags: PreTag[] = Array(end - start)
26
- .fill(0)
27
- .map((_, i) => ({ secret, index: start + i }));
28
- const siloedTags = await Promise.all(preTags.map(preTag => Tag.compute(preTag))).then(tags =>
29
- Promise.all(tags.map(tag => SiloedTag.compute(tag, app))),
22
+ // Derive siloed tags for the window
23
+ const siloedTags = await Promise.all(
24
+ Array.from({ length: end - start }, (_, i) => SiloedTag.compute({ extendedSecret, index: start + i })),
30
25
  );
31
26
 
32
27
  // We use the utility function below to retrieve all logs for the tags across all pages, so we don't need to handle
@@ -37,7 +32,7 @@ export async function loadLogsForRange(
37
32
  const logsWithIndexes: Array<{ log: TxScopedL2Log; taggingIndex: number }> = [];
38
33
  for (let i = 0; i < logs.length; i++) {
39
34
  const logsForTag = logs[i];
40
- const taggingIndex = preTags[i].index;
35
+ const taggingIndex = start + i;
41
36
  for (const log of logsForTag) {
42
37
  if (log.blockNumber <= anchorBlockNumber) {
43
38
  logsWithIndexes.push({ log, taggingIndex });
@@ -1,7 +1,6 @@
1
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
2
1
  import type { BlockHash } from '@aztec/stdlib/block';
3
2
  import type { AztecNode } from '@aztec/stdlib/interfaces/server';
4
- import type { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
3
+ import type { ExtendedDirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
5
4
 
6
5
  import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
7
6
  import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
@@ -11,11 +10,8 @@ import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_taggin
11
10
  /**
12
11
  * Syncs tagging indexes. This function needs to be called whenever a private log is being sent.
13
12
  *
14
- * @param secret - The secret that's unique for (sender, recipient, contract) tuple while the direction of
13
+ * @param secret - The secret that's unique for (sender, recipient, app) tuple while the direction of
15
14
  * sender -> recipient matters.
16
- * @param app - The address of the contract that the logs are tagged for. Needs to be provided because we perform
17
- * second round of siloing in this function which is necessary because kernels do it as well (they silo first field
18
- * of the private log which corresponds to the tag).
19
15
  * @remarks When syncing the indexes as sender we don't care about the log contents - we only care about the highest
20
16
  * pending and highest finalized indexes as that guides the next index choice when sending a log. The next index choice
21
17
  * is simply the highest pending index plus one (or finalized if pending is undefined).
@@ -23,8 +19,7 @@ import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_taggin
23
19
  * updates its status accordingly.
24
20
  */
25
21
  export async function syncSenderTaggingIndexes(
26
- secret: DirectionalAppTaggingSecret,
27
- app: AztecAddress,
22
+ secret: ExtendedDirectionalAppTaggingSecret,
28
23
  aztecNode: AztecNode,
29
24
  taggingStore: SenderTaggingStore,
30
25
  anchorBlockHash: BlockHash,
@@ -59,7 +54,7 @@ export async function syncSenderTaggingIndexes(
59
54
  while (true) {
60
55
  // Load and store indexes for the current window. These indexes may already exist in the database if txs using
61
56
  // them were previously sent from this PXE. Any duplicates are handled by the tagging data provider.
62
- await loadAndStoreNewTaggingIndexes(secret, app, start, end, aztecNode, taggingStore, anchorBlockHash, jobId);
57
+ await loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId);
63
58
 
64
59
  // Retrieve all indexes within the current window from storage and update their status accordingly.
65
60
  const pendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);