@aztec/txe 0.0.1-commit.6d3c34e → 0.0.1-commit.7035c9bd6

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 (65) hide show
  1. package/dest/constants.d.ts +1 -2
  2. package/dest/constants.d.ts.map +1 -1
  3. package/dest/constants.js +0 -1
  4. package/dest/index.d.ts +1 -1
  5. package/dest/index.d.ts.map +1 -1
  6. package/dest/index.js +88 -54
  7. package/dest/oracle/interfaces.d.ts +29 -28
  8. package/dest/oracle/interfaces.d.ts.map +1 -1
  9. package/dest/oracle/txe_oracle_public_context.d.ts +13 -13
  10. package/dest/oracle/txe_oracle_public_context.d.ts.map +1 -1
  11. package/dest/oracle/txe_oracle_public_context.js +16 -16
  12. package/dest/oracle/txe_oracle_top_level_context.d.ts +23 -22
  13. package/dest/oracle/txe_oracle_top_level_context.d.ts.map +1 -1
  14. package/dest/oracle/txe_oracle_top_level_context.js +144 -62
  15. package/dest/rpc_translator.d.ts +92 -81
  16. package/dest/rpc_translator.d.ts.map +1 -1
  17. package/dest/rpc_translator.js +323 -176
  18. package/dest/state_machine/archiver.d.ts +20 -69
  19. package/dest/state_machine/archiver.d.ts.map +1 -1
  20. package/dest/state_machine/archiver.js +34 -178
  21. package/dest/state_machine/dummy_p2p_client.d.ts +16 -12
  22. package/dest/state_machine/dummy_p2p_client.d.ts.map +1 -1
  23. package/dest/state_machine/dummy_p2p_client.js +28 -16
  24. package/dest/state_machine/index.d.ts +7 -5
  25. package/dest/state_machine/index.d.ts.map +1 -1
  26. package/dest/state_machine/index.js +39 -12
  27. package/dest/state_machine/mock_epoch_cache.d.ts +24 -8
  28. package/dest/state_machine/mock_epoch_cache.d.ts.map +1 -1
  29. package/dest/state_machine/mock_epoch_cache.js +43 -9
  30. package/dest/state_machine/synchronizer.d.ts +6 -6
  31. package/dest/state_machine/synchronizer.d.ts.map +1 -1
  32. package/dest/state_machine/synchronizer.js +3 -3
  33. package/dest/txe_session.d.ts +12 -6
  34. package/dest/txe_session.d.ts.map +1 -1
  35. package/dest/txe_session.js +112 -28
  36. package/dest/util/encoding.d.ts +17 -17
  37. package/dest/util/txe_public_contract_data_source.d.ts +2 -3
  38. package/dest/util/txe_public_contract_data_source.d.ts.map +1 -1
  39. package/dest/util/txe_public_contract_data_source.js +5 -22
  40. package/dest/utils/block_creation.d.ts +4 -4
  41. package/dest/utils/block_creation.d.ts.map +1 -1
  42. package/dest/utils/block_creation.js +18 -4
  43. package/dest/utils/tx_effect_creation.d.ts +2 -3
  44. package/dest/utils/tx_effect_creation.d.ts.map +1 -1
  45. package/dest/utils/tx_effect_creation.js +3 -6
  46. package/package.json +16 -16
  47. package/src/constants.ts +0 -1
  48. package/src/index.ts +89 -52
  49. package/src/oracle/interfaces.ts +32 -31
  50. package/src/oracle/txe_oracle_public_context.ts +16 -18
  51. package/src/oracle/txe_oracle_top_level_context.ts +178 -111
  52. package/src/rpc_translator.ts +360 -202
  53. package/src/state_machine/archiver.ts +37 -234
  54. package/src/state_machine/dummy_p2p_client.ts +40 -22
  55. package/src/state_machine/index.ts +53 -11
  56. package/src/state_machine/mock_epoch_cache.ts +53 -14
  57. package/src/state_machine/synchronizer.ts +5 -5
  58. package/src/txe_session.ts +129 -88
  59. package/src/util/txe_public_contract_data_source.ts +10 -36
  60. package/src/utils/block_creation.ts +19 -16
  61. package/src/utils/tx_effect_creation.ts +3 -11
  62. package/dest/util/txe_contract_store.d.ts +0 -12
  63. package/dest/util/txe_contract_store.d.ts.map +0 -1
  64. package/dest/util/txe_contract_store.js +0 -22
  65. package/src/util/txe_contract_store.ts +0 -36
@@ -1,12 +1,12 @@
1
1
  import { Fr, Point } from '@aztec/aztec.js/fields';
2
2
  import { MAX_NOTE_HASHES_PER_TX, MAX_NULLIFIERS_PER_TX } from '@aztec/constants';
3
3
  import { BlockNumber } from '@aztec/foundation/branded-types';
4
- import { packAsRetrievedNote } from '@aztec/pxe/simulator';
4
+ import { packAsHintedNote } from '@aztec/pxe/simulator';
5
5
  import { EventSelector, FunctionSelector, NoteSelector } from '@aztec/stdlib/abi';
6
6
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
7
- import { MerkleTreeId } from '@aztec/stdlib/trees';
7
+ import { BlockHash } from '@aztec/stdlib/block';
8
8
  import { addressFromSingle, arrayOfArraysToBoundedVecOfArrays, arrayToBoundedVec, bufferToU8Array, fromArray, fromSingle, fromUintArray, fromUintBoundedVec, toArray, toForeignCallResult, toSingle } from './util/encoding.js';
9
- const MAX_EVENT_LEN = 12; // This is MAX_MESSAGE_CONTENT_LEN - PRIVATE_EVENT_RESERVED_FIELDS
9
+ const MAX_EVENT_LEN = 10; // This is MAX_MESSAGE_CONTENT_LEN - PRIVATE_EVENT_MSG_PLAINTEXT_RESERVED_FIELDS_LEN
10
10
  const MAX_PRIVATE_EVENTS_PER_TXE_QUERY = 5;
11
11
  export class UnavailableOracleError extends Error {
12
12
  constructor(oracleName){
@@ -61,59 +61,69 @@ export class RPCTranslator {
61
61
  return this.oracleHandler;
62
62
  }
63
63
  // TXE session state transition functions - these get handled by the state handler
64
- async txeSetTopLevelTXEContext() {
64
+ // eslint-disable-next-line camelcase
65
+ async aztec_txe_setTopLevelTXEContext() {
65
66
  await this.stateHandler.enterTopLevelState();
66
67
  return toForeignCallResult([]);
67
68
  }
68
- async txeSetPrivateTXEContext(foreignContractAddressIsSome, foreignContractAddressValue, foreignAnchorBlockNumberIsSome, foreignAnchorBlockNumberValue) {
69
+ // eslint-disable-next-line camelcase
70
+ async aztec_txe_setPrivateTXEContext(foreignContractAddressIsSome, foreignContractAddressValue, foreignAnchorBlockNumberIsSome, foreignAnchorBlockNumberValue) {
69
71
  const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
70
72
  const anchorBlockNumber = fromSingle(foreignAnchorBlockNumberIsSome).toBool() ? BlockNumber(fromSingle(foreignAnchorBlockNumberValue).toNumber()) : undefined;
71
73
  const privateContextInputs = await this.stateHandler.enterPrivateState(contractAddress, anchorBlockNumber);
72
74
  return toForeignCallResult(privateContextInputs.toFields().map(toSingle));
73
75
  }
74
- async txeSetPublicTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
76
+ // eslint-disable-next-line camelcase
77
+ async aztec_txe_setPublicTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
75
78
  const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
76
79
  await this.stateHandler.enterPublicState(contractAddress);
77
80
  return toForeignCallResult([]);
78
81
  }
79
- async txeSetUtilityTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
82
+ // eslint-disable-next-line camelcase
83
+ async aztec_txe_setUtilityTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
80
84
  const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
81
85
  await this.stateHandler.enterUtilityState(contractAddress);
82
86
  return toForeignCallResult([]);
83
87
  }
84
88
  // Other oracles - these get handled by the oracle handler
85
89
  // TXE-specific oracles
86
- txeGetDefaultAddress() {
87
- const defaultAddress = this.handlerAsTxe().txeGetDefaultAddress();
90
+ // eslint-disable-next-line camelcase
91
+ aztec_txe_getDefaultAddress() {
92
+ const defaultAddress = this.handlerAsTxe().getDefaultAddress();
88
93
  return toForeignCallResult([
89
94
  toSingle(defaultAddress)
90
95
  ]);
91
96
  }
92
- async txeGetNextBlockNumber() {
93
- const nextBlockNumber = await this.handlerAsTxe().txeGetNextBlockNumber();
97
+ // eslint-disable-next-line camelcase
98
+ async aztec_txe_getNextBlockNumber() {
99
+ const nextBlockNumber = await this.handlerAsTxe().getNextBlockNumber();
94
100
  return toForeignCallResult([
95
101
  toSingle(nextBlockNumber)
96
102
  ]);
97
103
  }
98
- async txeGetNextBlockTimestamp() {
99
- const nextBlockTimestamp = await this.handlerAsTxe().txeGetNextBlockTimestamp();
104
+ // eslint-disable-next-line camelcase
105
+ async aztec_txe_getNextBlockTimestamp() {
106
+ const nextBlockTimestamp = await this.handlerAsTxe().getNextBlockTimestamp();
100
107
  return toForeignCallResult([
101
108
  toSingle(nextBlockTimestamp)
102
109
  ]);
103
110
  }
104
- async txeAdvanceBlocksBy(foreignBlocks) {
111
+ // eslint-disable-next-line camelcase
112
+ async aztec_txe_advanceBlocksBy(foreignBlocks) {
105
113
  const blocks = fromSingle(foreignBlocks).toNumber();
106
- await this.handlerAsTxe().txeAdvanceBlocksBy(blocks);
114
+ await this.handlerAsTxe().advanceBlocksBy(blocks);
107
115
  return toForeignCallResult([]);
108
116
  }
109
- txeAdvanceTimestampBy(foreignDuration) {
117
+ // eslint-disable-next-line camelcase
118
+ aztec_txe_advanceTimestampBy(foreignDuration) {
110
119
  const duration = fromSingle(foreignDuration).toBigInt();
111
- this.handlerAsTxe().txeAdvanceTimestampBy(duration);
120
+ this.handlerAsTxe().advanceTimestampBy(duration);
112
121
  return toForeignCallResult([]);
113
122
  }
114
- async txeDeploy(artifact, instance, foreignSecret) {
123
+ // eslint-disable-next-line camelcase
124
+ async aztec_txe_deploy(artifact, instance, foreignSecret) {
115
125
  const secret = fromSingle(foreignSecret);
116
- await this.handlerAsTxe().txeDeploy(artifact, instance, secret);
126
+ await this.handlerAsTxe().deploy(artifact, instance, secret);
117
127
  return toForeignCallResult([
118
128
  toArray([
119
129
  instance.salt,
@@ -124,59 +134,73 @@ export class RPCTranslator {
124
134
  ])
125
135
  ]);
126
136
  }
127
- async txeCreateAccount(foreignSecret) {
137
+ // eslint-disable-next-line camelcase
138
+ async aztec_txe_createAccount(foreignSecret) {
128
139
  const secret = fromSingle(foreignSecret);
129
- const completeAddress = await this.handlerAsTxe().txeCreateAccount(secret);
140
+ const completeAddress = await this.handlerAsTxe().createAccount(secret);
130
141
  return toForeignCallResult([
131
142
  toSingle(completeAddress.address),
132
143
  ...completeAddress.publicKeys.toFields().map(toSingle)
133
144
  ]);
134
145
  }
135
- async txeAddAccount(artifact, instance, foreignSecret) {
146
+ // eslint-disable-next-line camelcase
147
+ async aztec_txe_addAccount(artifact, instance, foreignSecret) {
136
148
  const secret = fromSingle(foreignSecret);
137
- const completeAddress = await this.handlerAsTxe().txeAddAccount(artifact, instance, secret);
149
+ const completeAddress = await this.handlerAsTxe().addAccount(artifact, instance, secret);
138
150
  return toForeignCallResult([
139
151
  toSingle(completeAddress.address),
140
152
  ...completeAddress.publicKeys.toFields().map(toSingle)
141
153
  ]);
142
154
  }
143
- async txeAddAuthWitness(foreignAddress, foreignMessageHash) {
155
+ // eslint-disable-next-line camelcase
156
+ async aztec_txe_addAuthWitness(foreignAddress, foreignMessageHash) {
144
157
  const address = addressFromSingle(foreignAddress);
145
158
  const messageHash = fromSingle(foreignMessageHash);
146
- await this.handlerAsTxe().txeAddAuthWitness(address, messageHash);
159
+ await this.handlerAsTxe().addAuthWitness(address, messageHash);
147
160
  return toForeignCallResult([]);
148
161
  }
149
162
  // PXE oracles
150
- utilityAssertCompatibleOracleVersion(foreignVersion) {
163
+ // eslint-disable-next-line camelcase
164
+ aztec_utl_assertCompatibleOracleVersion(foreignVersion) {
151
165
  const version = fromSingle(foreignVersion).toNumber();
152
- this.handlerAsMisc().utilityAssertCompatibleOracleVersion(version);
166
+ this.handlerAsMisc().assertCompatibleOracleVersion(version);
153
167
  return toForeignCallResult([]);
154
168
  }
155
- utilityGetRandomField() {
156
- const randomField = this.handlerAsMisc().utilityGetRandomField();
169
+ // eslint-disable-next-line camelcase
170
+ aztec_utl_getRandomField() {
171
+ const randomField = this.handlerAsMisc().getRandomField();
157
172
  return toForeignCallResult([
158
173
  toSingle(randomField)
159
174
  ]);
160
175
  }
161
- async txeGetLastBlockTimestamp() {
162
- const timestamp = await this.handlerAsTxe().txeGetLastBlockTimestamp();
176
+ // eslint-disable-next-line camelcase
177
+ async aztec_txe_getLastBlockTimestamp() {
178
+ const timestamp = await this.handlerAsTxe().getLastBlockTimestamp();
163
179
  return toForeignCallResult([
164
180
  toSingle(new Fr(timestamp))
165
181
  ]);
166
182
  }
167
- async txeGetLastTxEffects() {
168
- const { txHash, noteHashes, nullifiers } = await this.handlerAsTxe().txeGetLastTxEffects();
183
+ // eslint-disable-next-line camelcase
184
+ async aztec_txe_getLastTxEffects() {
185
+ const { txHash, noteHashes, nullifiers } = await this.handlerAsTxe().getLastTxEffects();
169
186
  return toForeignCallResult([
170
187
  toSingle(txHash.hash),
171
188
  ...arrayToBoundedVec(toArray(noteHashes), MAX_NOTE_HASHES_PER_TX),
172
189
  ...arrayToBoundedVec(toArray(nullifiers), MAX_NULLIFIERS_PER_TX)
173
190
  ]);
174
191
  }
175
- async txeGetPrivateEvents(foreignSelector, foreignContractAddress, foreignScope) {
192
+ // eslint-disable-next-line camelcase
193
+ async aztec_txe_getPrivateEvents(foreignSelector, foreignContractAddress, foreignScope) {
176
194
  const selector = EventSelector.fromField(fromSingle(foreignSelector));
177
195
  const contractAddress = addressFromSingle(foreignContractAddress);
178
196
  const scope = addressFromSingle(foreignScope);
179
- const events = await this.handlerAsTxe().txeGetPrivateEvents(selector, contractAddress, scope);
197
+ // TODO(F-335): Avoid doing the following 2 calls here.
198
+ {
199
+ await this.handlerAsTxe().syncContractNonOracleMethod(contractAddress, scope, this.stateHandler.getCurrentJob());
200
+ // We cycle job to commit the stores after the contract sync.
201
+ await this.stateHandler.cycleJob();
202
+ }
203
+ const events = await this.handlerAsTxe().getPrivateEvents(selector, contractAddress, scope);
180
204
  if (events.length > MAX_PRIVATE_EVENTS_PER_TXE_QUERY) {
181
205
  throw new Error(`Array of length ${events.length} larger than maxLen ${MAX_PRIVATE_EVENTS_PER_TXE_QUERY}`);
182
206
  }
@@ -194,48 +218,54 @@ export class RPCTranslator {
194
218
  toSingle(queryLength)
195
219
  ]);
196
220
  }
197
- privateStoreInExecutionCache(foreignValues, foreignHash) {
221
+ // eslint-disable-next-line camelcase
222
+ aztec_prv_storeInExecutionCache(foreignValues, foreignHash) {
198
223
  const values = fromArray(foreignValues);
199
224
  const hash = fromSingle(foreignHash);
200
- this.handlerAsPrivate().privateStoreInExecutionCache(values, hash);
225
+ this.handlerAsPrivate().storeInExecutionCache(values, hash);
201
226
  return toForeignCallResult([]);
202
227
  }
203
- async privateLoadFromExecutionCache(foreignHash) {
228
+ // eslint-disable-next-line camelcase
229
+ async aztec_prv_loadFromExecutionCache(foreignHash) {
204
230
  const hash = fromSingle(foreignHash);
205
- const returns = await this.handlerAsPrivate().privateLoadFromExecutionCache(hash);
231
+ const returns = await this.handlerAsPrivate().loadFromExecutionCache(hash);
206
232
  return toForeignCallResult([
207
233
  toArray(returns)
208
234
  ]);
209
235
  }
210
236
  // When the argument is a slice, noir automatically adds a length field to oracle call.
211
237
  // When the argument is an array, we add the field length manually to the signature.
212
- utilityDebugLog(foreignLevel, foreignMessage, _foreignLength, foreignFields) {
238
+ // eslint-disable-next-line camelcase
239
+ async aztec_utl_log(foreignLevel, foreignMessage, _foreignLength, foreignFields) {
213
240
  const level = fromSingle(foreignLevel).toNumber();
214
241
  const message = fromArray(foreignMessage).map((field)=>String.fromCharCode(field.toNumber())).join('');
215
242
  const fields = fromArray(foreignFields);
216
- this.handlerAsMisc().utilityDebugLog(level, message, fields);
243
+ await this.handlerAsMisc().log(level, message, fields);
217
244
  return toForeignCallResult([]);
218
245
  }
219
- async utilityStorageRead(foreignContractAddress, foreignStartStorageSlot, foreignBlockNumber, foreignNumberOfElements) {
246
+ // eslint-disable-next-line camelcase
247
+ async aztec_utl_storageRead(foreignBlockHash, foreignContractAddress, foreignStartStorageSlot, foreignNumberOfElements) {
248
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
220
249
  const contractAddress = addressFromSingle(foreignContractAddress);
221
250
  const startStorageSlot = fromSingle(foreignStartStorageSlot);
222
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
223
251
  const numberOfElements = fromSingle(foreignNumberOfElements).toNumber();
224
- const values = await this.handlerAsUtility().utilityStorageRead(contractAddress, startStorageSlot, blockNumber, numberOfElements);
252
+ const values = await this.handlerAsUtility().storageRead(blockHash, contractAddress, startStorageSlot, numberOfElements);
225
253
  return toForeignCallResult([
226
254
  toArray(values)
227
255
  ]);
228
256
  }
229
- async utilityGetPublicDataWitness(foreignBlockNumber, foreignLeafSlot) {
230
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
257
+ // eslint-disable-next-line camelcase
258
+ async aztec_utl_getPublicDataWitness(foreignBlockHash, foreignLeafSlot) {
259
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
231
260
  const leafSlot = fromSingle(foreignLeafSlot);
232
- const witness = await this.handlerAsUtility().utilityGetPublicDataWitness(blockNumber, leafSlot);
261
+ const witness = await this.handlerAsUtility().getPublicDataWitness(blockHash, leafSlot);
233
262
  if (!witness) {
234
- throw new Error(`Public data witness not found for slot ${leafSlot} at block ${blockNumber}.`);
263
+ throw new Error(`Public data witness not found for slot ${leafSlot} at block ${blockHash.toString()}.`);
235
264
  }
236
265
  return toForeignCallResult(witness.toNoirRepresentation());
237
266
  }
238
- async utilityGetNotes(foreignOwnerIsSome, foreignOwnerValue, foreignStorageSlot, foreignNumSelects, foreignSelectByIndexes, foreignSelectByOffsets, foreignSelectByLengths, foreignSelectValues, foreignSelectComparators, foreignSortByIndexes, foreignSortByOffsets, foreignSortByLengths, foreignSortOrder, foreignLimit, foreignOffset, foreignStatus, foreignMaxNotes, foreignPackedRetrievedNoteLength) {
267
+ // eslint-disable-next-line camelcase
268
+ async aztec_utl_getNotes(foreignOwnerIsSome, foreignOwnerValue, foreignStorageSlot, foreignNumSelects, foreignSelectByIndexes, foreignSelectByOffsets, foreignSelectByLengths, foreignSelectValues, foreignSelectComparators, foreignSortByIndexes, foreignSortByOffsets, foreignSortByLengths, foreignSortOrder, foreignLimit, foreignOffset, foreignStatus, foreignMaxNotes, foreignPackedHintedNoteLength) {
239
269
  // Parse Option<AztecAddress>: ownerIsSome is 0 for None, 1 for Some
240
270
  const owner = fromSingle(foreignOwnerIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignOwnerValue)) : undefined;
241
271
  const storageSlot = fromSingle(foreignStorageSlot);
@@ -253,23 +283,24 @@ export class RPCTranslator {
253
283
  const offset = fromSingle(foreignOffset).toNumber();
254
284
  const status = fromSingle(foreignStatus).toNumber();
255
285
  const maxNotes = fromSingle(foreignMaxNotes).toNumber();
256
- const packedRetrievedNoteLength = fromSingle(foreignPackedRetrievedNoteLength).toNumber();
257
- const noteDatas = await this.handlerAsUtility().utilityGetNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status);
258
- const returnDataAsArrayOfArrays = noteDatas.map((noteData)=>packAsRetrievedNote({
286
+ const packedHintedNoteLength = fromSingle(foreignPackedHintedNoteLength).toNumber();
287
+ const noteDatas = await this.handlerAsUtility().getNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status);
288
+ const returnDataAsArrayOfArrays = noteDatas.map((noteData)=>packAsHintedNote({
259
289
  contractAddress: noteData.contractAddress,
260
290
  owner: noteData.owner,
261
291
  randomness: noteData.randomness,
262
292
  storageSlot: noteData.storageSlot,
263
293
  noteNonce: noteData.noteNonce,
264
- index: noteData.index,
294
+ isPending: noteData.isPending,
265
295
  note: noteData.note
266
296
  }));
267
297
  // Now we convert each sub-array to an array of ForeignCallSingles
268
298
  const returnDataAsArrayOfForeignCallSingleArrays = returnDataAsArrayOfArrays.map((subArray)=>subArray.map(toSingle));
269
299
  // At last we convert the array of arrays to a bounded vec of arrays
270
- return toForeignCallResult(arrayOfArraysToBoundedVecOfArrays(returnDataAsArrayOfForeignCallSingleArrays, maxNotes, packedRetrievedNoteLength));
300
+ return toForeignCallResult(arrayOfArraysToBoundedVecOfArrays(returnDataAsArrayOfForeignCallSingleArrays, maxNotes, packedHintedNoteLength));
271
301
  }
272
- privateNotifyCreatedNote(foreignOwner, foreignStorageSlot, foreignRandomness, foreignNoteTypeId, foreignNote, foreignNoteHash, foreignCounter) {
302
+ // eslint-disable-next-line camelcase
303
+ aztec_prv_notifyCreatedNote(foreignOwner, foreignStorageSlot, foreignRandomness, foreignNoteTypeId, foreignNote, foreignNoteHash, foreignCounter) {
273
304
  const owner = addressFromSingle(foreignOwner);
274
305
  const storageSlot = fromSingle(foreignStorageSlot);
275
306
  const randomness = fromSingle(foreignRandomness);
@@ -277,31 +308,44 @@ export class RPCTranslator {
277
308
  const note = fromArray(foreignNote);
278
309
  const noteHash = fromSingle(foreignNoteHash);
279
310
  const counter = fromSingle(foreignCounter).toNumber();
280
- this.handlerAsPrivate().privateNotifyCreatedNote(owner, storageSlot, randomness, noteTypeId, note, noteHash, counter);
311
+ this.handlerAsPrivate().notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, note, noteHash, counter);
281
312
  return toForeignCallResult([]);
282
313
  }
283
- async privateNotifyNullifiedNote(foreignInnerNullifier, foreignNoteHash, foreignCounter) {
314
+ // eslint-disable-next-line camelcase
315
+ async aztec_prv_notifyNullifiedNote(foreignInnerNullifier, foreignNoteHash, foreignCounter) {
284
316
  const innerNullifier = fromSingle(foreignInnerNullifier);
285
317
  const noteHash = fromSingle(foreignNoteHash);
286
318
  const counter = fromSingle(foreignCounter).toNumber();
287
- await this.handlerAsPrivate().privateNotifyNullifiedNote(innerNullifier, noteHash, counter);
319
+ await this.handlerAsPrivate().notifyNullifiedNote(innerNullifier, noteHash, counter);
288
320
  return toForeignCallResult([]);
289
321
  }
290
- async privateNotifyCreatedNullifier(foreignInnerNullifier) {
322
+ // eslint-disable-next-line camelcase
323
+ async aztec_prv_notifyCreatedNullifier(foreignInnerNullifier) {
291
324
  const innerNullifier = fromSingle(foreignInnerNullifier);
292
- await this.handlerAsPrivate().privateNotifyCreatedNullifier(innerNullifier);
325
+ await this.handlerAsPrivate().notifyCreatedNullifier(innerNullifier);
293
326
  return toForeignCallResult([]);
294
327
  }
295
- async utilityCheckNullifierExists(foreignInnerNullifier) {
328
+ // eslint-disable-next-line camelcase
329
+ async aztec_prv_isNullifierPending(foreignInnerNullifier, foreignContractAddress) {
296
330
  const innerNullifier = fromSingle(foreignInnerNullifier);
297
- const exists = await this.handlerAsUtility().utilityCheckNullifierExists(innerNullifier);
331
+ const contractAddress = addressFromSingle(foreignContractAddress);
332
+ const isPending = await this.handlerAsPrivate().isNullifierPending(innerNullifier, contractAddress);
333
+ return toForeignCallResult([
334
+ toSingle(new Fr(isPending))
335
+ ]);
336
+ }
337
+ // eslint-disable-next-line camelcase
338
+ async aztec_utl_checkNullifierExists(foreignInnerNullifier) {
339
+ const innerNullifier = fromSingle(foreignInnerNullifier);
340
+ const exists = await this.handlerAsUtility().checkNullifierExists(innerNullifier);
298
341
  return toForeignCallResult([
299
342
  toSingle(new Fr(exists))
300
343
  ]);
301
344
  }
302
- async utilityGetContractInstance(foreignAddress) {
345
+ // eslint-disable-next-line camelcase
346
+ async aztec_utl_getContractInstance(foreignAddress) {
303
347
  const address = addressFromSingle(foreignAddress);
304
- const instance = await this.handlerAsUtility().utilityGetContractInstance(address);
348
+ const instance = await this.handlerAsUtility().getContractInstance(address);
305
349
  return toForeignCallResult([
306
350
  instance.salt,
307
351
  instance.deployer.toField(),
@@ -310,36 +354,53 @@ export class RPCTranslator {
310
354
  ...instance.publicKeys.toFields()
311
355
  ].map(toSingle));
312
356
  }
313
- async utilityGetPublicKeysAndPartialAddress(foreignAddress) {
357
+ // eslint-disable-next-line camelcase
358
+ async aztec_utl_tryGetPublicKeysAndPartialAddress(foreignAddress) {
314
359
  const address = addressFromSingle(foreignAddress);
315
- const { publicKeys, partialAddress } = await this.handlerAsUtility().utilityGetPublicKeysAndPartialAddress(address);
316
- return toForeignCallResult([
317
- toArray([
318
- ...publicKeys.toFields(),
319
- partialAddress
320
- ])
321
- ]);
360
+ const result = await this.handlerAsUtility().tryGetPublicKeysAndPartialAddress(address);
361
+ // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
362
+ // with two fields: `some` (a boolean) and `value` (a field array in this case).
363
+ if (result === undefined) {
364
+ // No data was found so we set `some` to 0 and pad `value` with zeros get the correct return size.
365
+ return toForeignCallResult([
366
+ toSingle(new Fr(0)),
367
+ toArray(Array(13).fill(new Fr(0)))
368
+ ]);
369
+ } else {
370
+ // Data was found so we set `some` to 1 and return it along with `value`.
371
+ return toForeignCallResult([
372
+ toSingle(new Fr(1)),
373
+ toArray([
374
+ ...result.publicKeys.toFields(),
375
+ result.partialAddress
376
+ ])
377
+ ]);
378
+ }
322
379
  }
323
- async utilityGetKeyValidationRequest(foreignPkMHash) {
380
+ // eslint-disable-next-line camelcase
381
+ async aztec_utl_getKeyValidationRequest(foreignPkMHash) {
324
382
  const pkMHash = fromSingle(foreignPkMHash);
325
- const keyValidationRequest = await this.handlerAsUtility().utilityGetKeyValidationRequest(pkMHash);
383
+ const keyValidationRequest = await this.handlerAsUtility().getKeyValidationRequest(pkMHash);
326
384
  return toForeignCallResult(keyValidationRequest.toFields().map(toSingle));
327
385
  }
328
- privateCallPrivateFunction(_foreignTargetContractAddress, _foreignFunctionSelector, _foreignArgsHash, _foreignSideEffectCounter, _foreignIsStaticCall) {
386
+ // eslint-disable-next-line camelcase
387
+ aztec_prv_callPrivateFunction(_foreignTargetContractAddress, _foreignFunctionSelector, _foreignArgsHash, _foreignSideEffectCounter, _foreignIsStaticCall) {
329
388
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::private_context`, use `private_call` instead');
330
389
  }
331
- async utilityGetNullifierMembershipWitness(foreignBlockNumber, foreignNullifier) {
332
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
390
+ // eslint-disable-next-line camelcase
391
+ async aztec_utl_getNullifierMembershipWitness(foreignBlockHash, foreignNullifier) {
392
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
333
393
  const nullifier = fromSingle(foreignNullifier);
334
- const witness = await this.handlerAsUtility().utilityGetNullifierMembershipWitness(blockNumber, nullifier);
394
+ const witness = await this.handlerAsUtility().getNullifierMembershipWitness(blockHash, nullifier);
335
395
  if (!witness) {
336
- throw new Error(`Nullifier membership witness not found at block ${blockNumber}.`);
396
+ throw new Error(`Nullifier membership witness not found at block ${blockHash}.`);
337
397
  }
338
398
  return toForeignCallResult(witness.toNoirRepresentation());
339
399
  }
340
- async utilityGetAuthWitness(foreignMessageHash) {
400
+ // eslint-disable-next-line camelcase
401
+ async aztec_utl_getAuthWitness(foreignMessageHash) {
341
402
  const messageHash = fromSingle(foreignMessageHash);
342
- const authWitness = await this.handlerAsUtility().utilityGetAuthWitness(messageHash);
403
+ const authWitness = await this.handlerAsUtility().getAuthWitness(messageHash);
343
404
  if (!authWitness) {
344
405
  throw new Error(`Auth witness not found for message hash ${messageHash}.`);
345
406
  }
@@ -347,87 +408,112 @@ export class RPCTranslator {
347
408
  toArray(authWitness)
348
409
  ]);
349
410
  }
350
- privateNotifyEnqueuedPublicFunctionCall(_foreignTargetContractAddress, _foreignCalldataHash, _foreignSideEffectCounter, _foreignIsStaticCall) {
411
+ // eslint-disable-next-line camelcase
412
+ aztec_prv_validatePublicCalldata(_foreignCalldataHash) {
351
413
  throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
352
414
  }
353
- privateNotifySetPublicTeardownFunctionCall(_foreignTargetContractAddress, _foreignCalldataHash, _foreignSideEffectCounter, _foreignIsStaticCall) {
415
+ // eslint-disable-next-line camelcase
416
+ aztec_prv_notifyRevertiblePhaseStart(_foreignMinRevertibleSideEffectCounter) {
354
417
  throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
355
418
  }
356
- privateNotifySetMinRevertibleSideEffectCounter(_foreignMinRevertibleSideEffectCounter) {
357
- throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
358
- }
359
- async privateIsSideEffectCounterRevertible(foreignSideEffectCounter) {
419
+ // eslint-disable-next-line camelcase
420
+ async aztec_prv_inRevertiblePhase(foreignSideEffectCounter) {
360
421
  const sideEffectCounter = fromSingle(foreignSideEffectCounter).toNumber();
361
- const isRevertible = await this.handlerAsPrivate().privateIsSideEffectCounterRevertible(sideEffectCounter);
422
+ const isRevertible = await this.handlerAsPrivate().inRevertiblePhase(sideEffectCounter);
362
423
  return toForeignCallResult([
363
424
  toSingle(new Fr(isRevertible))
364
425
  ]);
365
426
  }
366
- utilityGetUtilityContext() {
367
- const context = this.handlerAsUtility().utilityGetUtilityContext();
427
+ // eslint-disable-next-line camelcase
428
+ aztec_utl_getUtilityContext() {
429
+ const context = this.handlerAsUtility().getUtilityContext();
368
430
  return toForeignCallResult(context.toNoirRepresentation());
369
431
  }
370
- async utilityGetBlockHeader(foreignBlockNumber) {
432
+ // eslint-disable-next-line camelcase
433
+ async aztec_utl_getBlockHeader(foreignBlockNumber) {
371
434
  const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
372
- const header = await this.handlerAsUtility().utilityGetBlockHeader(blockNumber);
435
+ const header = await this.handlerAsUtility().getBlockHeader(blockNumber);
373
436
  if (!header) {
374
437
  throw new Error(`Block header not found for block ${blockNumber}.`);
375
438
  }
376
439
  return toForeignCallResult(header.toFields().map(toSingle));
377
440
  }
378
- async utilityGetMembershipWitness(foreignBlockNumber, foreignTreeId, foreignLeafValue) {
379
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
380
- const treeId = fromSingle(foreignTreeId).toNumber();
381
- const leafValue = fromSingle(foreignLeafValue);
382
- const witness = await this.handlerAsUtility().utilityGetMembershipWitness(blockNumber, treeId, leafValue);
441
+ // eslint-disable-next-line camelcase
442
+ async aztec_utl_getNoteHashMembershipWitness(foreignAnchorBlockHash, foreignNoteHash) {
443
+ const blockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
444
+ const noteHash = fromSingle(foreignNoteHash);
445
+ const witness = await this.handlerAsUtility().getNoteHashMembershipWitness(blockHash, noteHash);
383
446
  if (!witness) {
384
- throw new Error(`Membership witness in tree ${MerkleTreeId[treeId]} not found for value ${leafValue} at block ${blockNumber}.`);
447
+ throw new Error(`Note hash ${noteHash} not found in the note hash tree at block ${blockHash.toString()}.`);
385
448
  }
386
- return toForeignCallResult([
387
- toSingle(witness[0]),
388
- toArray(witness.slice(1))
389
- ]);
449
+ return toForeignCallResult(witness.toNoirRepresentation());
390
450
  }
391
- async utilityGetLowNullifierMembershipWitness(foreignBlockNumber, foreignNullifier) {
392
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
451
+ // eslint-disable-next-line camelcase
452
+ async aztec_utl_getBlockHashMembershipWitness(foreignAnchorBlockHash, foreignBlockHash) {
453
+ const anchorBlockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
454
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
455
+ const witness = await this.handlerAsUtility().getBlockHashMembershipWitness(anchorBlockHash, blockHash);
456
+ if (!witness) {
457
+ throw new Error(`Block hash ${blockHash.toString()} not found in the archive tree at anchor block ${anchorBlockHash.toString()}.`);
458
+ }
459
+ return toForeignCallResult(witness.toNoirRepresentation());
460
+ }
461
+ // eslint-disable-next-line camelcase
462
+ async aztec_utl_getLowNullifierMembershipWitness(foreignBlockHash, foreignNullifier) {
463
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
393
464
  const nullifier = fromSingle(foreignNullifier);
394
- const witness = await this.handlerAsUtility().utilityGetLowNullifierMembershipWitness(blockNumber, nullifier);
465
+ const witness = await this.handlerAsUtility().getLowNullifierMembershipWitness(blockHash, nullifier);
395
466
  if (!witness) {
396
- throw new Error(`Low nullifier witness not found for nullifier ${nullifier} at block ${blockNumber}.`);
467
+ throw new Error(`Low nullifier witness not found for nullifier ${nullifier} at block ${blockHash}.`);
397
468
  }
398
469
  return toForeignCallResult(witness.toNoirRepresentation());
399
470
  }
400
- async utilityFetchTaggedLogs(foreignPendingTaggedLogArrayBaseSlot) {
471
+ // eslint-disable-next-line camelcase
472
+ async aztec_utl_fetchTaggedLogs(foreignPendingTaggedLogArrayBaseSlot) {
401
473
  const pendingTaggedLogArrayBaseSlot = fromSingle(foreignPendingTaggedLogArrayBaseSlot);
402
- await this.handlerAsUtility().utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot);
474
+ await this.handlerAsUtility().fetchTaggedLogs(pendingTaggedLogArrayBaseSlot);
403
475
  return toForeignCallResult([]);
404
476
  }
405
- async utilityValidateEnqueuedNotesAndEvents(foreignContractAddress, foreignNoteValidationRequestsArrayBaseSlot, foreignEventValidationRequestsArrayBaseSlot) {
477
+ // eslint-disable-next-line camelcase
478
+ async aztec_utl_validateAndStoreEnqueuedNotesAndEvents(foreignContractAddress, foreignNoteValidationRequestsArrayBaseSlot, foreignEventValidationRequestsArrayBaseSlot, foreignMaxNotePackedLen, foreignMaxEventSerializedLen) {
406
479
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
407
480
  const noteValidationRequestsArrayBaseSlot = fromSingle(foreignNoteValidationRequestsArrayBaseSlot);
408
481
  const eventValidationRequestsArrayBaseSlot = fromSingle(foreignEventValidationRequestsArrayBaseSlot);
409
- await this.handlerAsUtility().utilityValidateEnqueuedNotesAndEvents(contractAddress, noteValidationRequestsArrayBaseSlot, eventValidationRequestsArrayBaseSlot);
482
+ const maxNotePackedLen = fromSingle(foreignMaxNotePackedLen).toNumber();
483
+ const maxEventSerializedLen = fromSingle(foreignMaxEventSerializedLen).toNumber();
484
+ await this.handlerAsUtility().validateAndStoreEnqueuedNotesAndEvents(contractAddress, noteValidationRequestsArrayBaseSlot, eventValidationRequestsArrayBaseSlot, maxNotePackedLen, maxEventSerializedLen);
410
485
  return toForeignCallResult([]);
411
486
  }
412
- async utilityBulkRetrieveLogs(foreignContractAddress, foreignLogRetrievalRequestsArrayBaseSlot, foreignLogRetrievalResponsesArrayBaseSlot) {
487
+ // eslint-disable-next-line camelcase
488
+ async aztec_utl_bulkRetrieveLogs(foreignContractAddress, foreignLogRetrievalRequestsArrayBaseSlot, foreignLogRetrievalResponsesArrayBaseSlot) {
413
489
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
414
490
  const logRetrievalRequestsArrayBaseSlot = fromSingle(foreignLogRetrievalRequestsArrayBaseSlot);
415
491
  const logRetrievalResponsesArrayBaseSlot = fromSingle(foreignLogRetrievalResponsesArrayBaseSlot);
416
- await this.handlerAsUtility().utilityBulkRetrieveLogs(contractAddress, logRetrievalRequestsArrayBaseSlot, logRetrievalResponsesArrayBaseSlot);
492
+ await this.handlerAsUtility().bulkRetrieveLogs(contractAddress, logRetrievalRequestsArrayBaseSlot, logRetrievalResponsesArrayBaseSlot);
417
493
  return toForeignCallResult([]);
418
494
  }
419
- async utilityStoreCapsule(foreignContractAddress, foreignSlot, foreignCapsule) {
495
+ // eslint-disable-next-line camelcase
496
+ async aztec_utl_utilityResolveMessageContexts(foreignContractAddress, foreignMessageContextRequestsArrayBaseSlot, foreignMessageContextResponsesArrayBaseSlot) {
497
+ const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
498
+ const messageContextRequestsArrayBaseSlot = fromSingle(foreignMessageContextRequestsArrayBaseSlot);
499
+ const messageContextResponsesArrayBaseSlot = fromSingle(foreignMessageContextResponsesArrayBaseSlot);
500
+ await this.handlerAsUtility().utilityResolveMessageContexts(contractAddress, messageContextRequestsArrayBaseSlot, messageContextResponsesArrayBaseSlot);
501
+ return toForeignCallResult([]);
502
+ }
503
+ // eslint-disable-next-line camelcase
504
+ async aztec_utl_storeCapsule(foreignContractAddress, foreignSlot, foreignCapsule) {
420
505
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
421
506
  const slot = fromSingle(foreignSlot);
422
507
  const capsule = fromArray(foreignCapsule);
423
- await this.handlerAsUtility().utilityStoreCapsule(contractAddress, slot, capsule);
508
+ await this.handlerAsUtility().storeCapsule(contractAddress, slot, capsule);
424
509
  return toForeignCallResult([]);
425
510
  }
426
- async utilityLoadCapsule(foreignContractAddress, foreignSlot, foreignTSize) {
511
+ // eslint-disable-next-line camelcase
512
+ async aztec_utl_loadCapsule(foreignContractAddress, foreignSlot, foreignTSize) {
427
513
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
428
514
  const slot = fromSingle(foreignSlot);
429
515
  const tSize = fromSingle(foreignTSize).toNumber();
430
- const values = await this.handlerAsUtility().utilityLoadCapsule(contractAddress, slot);
516
+ const values = await this.handlerAsUtility().loadCapsule(contractAddress, slot);
431
517
  // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
432
518
  // with two fields: `some` (a boolean) and `value` (a field array in this case).
433
519
  if (values === null) {
@@ -444,197 +530,256 @@ export class RPCTranslator {
444
530
  ]);
445
531
  }
446
532
  }
447
- async utilityDeleteCapsule(foreignContractAddress, foreignSlot) {
533
+ // eslint-disable-next-line camelcase
534
+ async aztec_utl_deleteCapsule(foreignContractAddress, foreignSlot) {
448
535
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
449
536
  const slot = fromSingle(foreignSlot);
450
- await this.handlerAsUtility().utilityDeleteCapsule(contractAddress, slot);
537
+ await this.handlerAsUtility().deleteCapsule(contractAddress, slot);
451
538
  return toForeignCallResult([]);
452
539
  }
453
- async utilityCopyCapsule(foreignContractAddress, foreignSrcSlot, foreignDstSlot, foreignNumEntries) {
540
+ // eslint-disable-next-line camelcase
541
+ async aztec_utl_copyCapsule(foreignContractAddress, foreignSrcSlot, foreignDstSlot, foreignNumEntries) {
454
542
  const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
455
543
  const srcSlot = fromSingle(foreignSrcSlot);
456
544
  const dstSlot = fromSingle(foreignDstSlot);
457
545
  const numEntries = fromSingle(foreignNumEntries).toNumber();
458
- await this.handlerAsUtility().utilityCopyCapsule(contractAddress, srcSlot, dstSlot, numEntries);
546
+ await this.handlerAsUtility().copyCapsule(contractAddress, srcSlot, dstSlot, numEntries);
459
547
  return toForeignCallResult([]);
460
548
  }
461
549
  // TODO: I forgot to add a corresponding function here, when I introduced an oracle method to txe_oracle.ts.
462
550
  // The compiler didn't throw an error, so it took me a while to learn of the existence of this file, and that I need
463
551
  // to implement this function here. Isn't there a way to programmatically identify that this is missing, given the
464
552
  // existence of a txe_oracle method?
465
- async utilityAes128Decrypt(foreignCiphertextBVecStorage, foreignCiphertextLength, foreignIv, foreignSymKey) {
553
+ // eslint-disable-next-line camelcase
554
+ async aztec_utl_tryAes128Decrypt(foreignCiphertextBVecStorage, foreignCiphertextLength, foreignIv, foreignSymKey) {
466
555
  const ciphertext = fromUintBoundedVec(foreignCiphertextBVecStorage, foreignCiphertextLength, 8);
467
556
  const iv = fromUintArray(foreignIv, 8);
468
557
  const symKey = fromUintArray(foreignSymKey, 8);
469
- const plaintextBuffer = await this.handlerAsUtility().utilityAes128Decrypt(ciphertext, iv, symKey);
470
- return toForeignCallResult(arrayToBoundedVec(bufferToU8Array(plaintextBuffer), foreignCiphertextBVecStorage.length));
558
+ // Noir Option<BoundedVec> is encoded as [is_some: Field, storage: Field[], length: Field].
559
+ try {
560
+ const plaintextBuffer = await this.handlerAsUtility().aes128Decrypt(ciphertext, iv, symKey);
561
+ const [storage, length] = arrayToBoundedVec(bufferToU8Array(plaintextBuffer), foreignCiphertextBVecStorage.length);
562
+ return toForeignCallResult([
563
+ toSingle(new Fr(1)),
564
+ storage,
565
+ length
566
+ ]);
567
+ } catch {
568
+ const zeroStorage = toArray(Array(foreignCiphertextBVecStorage.length).fill(new Fr(0)));
569
+ return toForeignCallResult([
570
+ toSingle(new Fr(0)),
571
+ zeroStorage,
572
+ toSingle(new Fr(0))
573
+ ]);
574
+ }
471
575
  }
472
- async utilityGetSharedSecret(foreignAddress, foreignEphPKField0, foreignEphPKField1, foreignEphPKField2) {
576
+ // eslint-disable-next-line camelcase
577
+ async aztec_utl_getSharedSecret(foreignAddress, foreignEphPKField0, foreignEphPKField1, foreignEphPKField2) {
473
578
  const address = AztecAddress.fromField(fromSingle(foreignAddress));
474
579
  const ephPK = Point.fromFields([
475
580
  fromSingle(foreignEphPKField0),
476
581
  fromSingle(foreignEphPKField1),
477
582
  fromSingle(foreignEphPKField2)
478
583
  ]);
479
- const secret = await this.handlerAsUtility().utilityGetSharedSecret(address, ephPK);
584
+ const secret = await this.handlerAsUtility().getSharedSecret(address, ephPK);
480
585
  return toForeignCallResult(secret.toFields().map(toSingle));
481
586
  }
482
- emitOffchainEffect(_foreignData) {
587
+ // eslint-disable-next-line camelcase
588
+ aztec_utl_invalidateContractSyncCache(foreignContractAddress, foreignScopes, foreignScopeCount) {
589
+ const contractAddress = addressFromSingle(foreignContractAddress);
590
+ const count = fromSingle(foreignScopeCount).toNumber();
591
+ const scopes = fromArray(foreignScopes).slice(0, count).map((f)=>new AztecAddress(f));
592
+ this.handlerAsUtility().invalidateContractSyncCache(contractAddress, scopes);
593
+ return Promise.resolve(toForeignCallResult([]));
594
+ }
595
+ // eslint-disable-next-line camelcase
596
+ aztec_utl_emitOffchainEffect(_foreignData) {
483
597
  throw new Error('Offchain effects are not yet supported in the TestEnvironment');
484
598
  }
485
599
  // AVM opcodes
486
- avmOpcodeEmitUnencryptedLog(_foreignMessage) {
600
+ // eslint-disable-next-line camelcase
601
+ aztec_avm_emitPublicLog(_foreignMessage) {
487
602
  // TODO(#8811): Implement
488
603
  return toForeignCallResult([]);
489
604
  }
490
- async avmOpcodeStorageRead(foreignSlot) {
605
+ // eslint-disable-next-line camelcase
606
+ async aztec_avm_storageRead(foreignSlot, foreignContractAddress) {
491
607
  const slot = fromSingle(foreignSlot);
492
- const value = (await this.handlerAsAvm().avmOpcodeStorageRead(slot)).value;
608
+ const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
609
+ const value = (await this.handlerAsAvm().storageRead(slot, contractAddress)).value;
493
610
  return toForeignCallResult([
494
611
  toSingle(new Fr(value))
495
612
  ]);
496
613
  }
497
- async avmOpcodeStorageWrite(foreignSlot, foreignValue) {
614
+ // eslint-disable-next-line camelcase
615
+ async aztec_avm_storageWrite(foreignSlot, foreignValue) {
498
616
  const slot = fromSingle(foreignSlot);
499
617
  const value = fromSingle(foreignValue);
500
- await this.handlerAsAvm().avmOpcodeStorageWrite(slot, value);
618
+ await this.handlerAsAvm().storageWrite(slot, value);
501
619
  return toForeignCallResult([]);
502
620
  }
503
- async avmOpcodeGetContractInstanceDeployer(foreignAddress) {
621
+ // eslint-disable-next-line camelcase
622
+ async aztec_avm_getContractInstanceDeployer(foreignAddress) {
504
623
  const address = addressFromSingle(foreignAddress);
505
- const instance = await this.handlerAsUtility().utilityGetContractInstance(address);
624
+ const instance = await this.handlerAsUtility().getContractInstance(address);
506
625
  return toForeignCallResult([
507
626
  toSingle(instance.deployer),
508
627
  // AVM requires an extra boolean indicating the instance was found
509
628
  toSingle(new Fr(1))
510
629
  ]);
511
630
  }
512
- async avmOpcodeGetContractInstanceClassId(foreignAddress) {
631
+ // eslint-disable-next-line camelcase
632
+ async aztec_avm_getContractInstanceClassId(foreignAddress) {
513
633
  const address = addressFromSingle(foreignAddress);
514
- const instance = await this.handlerAsUtility().utilityGetContractInstance(address);
634
+ const instance = await this.handlerAsUtility().getContractInstance(address);
515
635
  return toForeignCallResult([
516
636
  toSingle(instance.currentContractClassId),
517
637
  // AVM requires an extra boolean indicating the instance was found
518
638
  toSingle(new Fr(1))
519
639
  ]);
520
640
  }
521
- async avmOpcodeGetContractInstanceInitializationHash(foreignAddress) {
641
+ // eslint-disable-next-line camelcase
642
+ async aztec_avm_getContractInstanceInitializationHash(foreignAddress) {
522
643
  const address = addressFromSingle(foreignAddress);
523
- const instance = await this.handlerAsUtility().utilityGetContractInstance(address);
644
+ const instance = await this.handlerAsUtility().getContractInstance(address);
524
645
  return toForeignCallResult([
525
646
  toSingle(instance.initializationHash),
526
647
  // AVM requires an extra boolean indicating the instance was found
527
648
  toSingle(new Fr(1))
528
649
  ]);
529
650
  }
530
- async avmOpcodeSender() {
531
- const sender = await this.handlerAsAvm().avmOpcodeSender();
651
+ // eslint-disable-next-line camelcase
652
+ async aztec_avm_sender() {
653
+ const sender = await this.handlerAsAvm().sender();
532
654
  return toForeignCallResult([
533
655
  toSingle(sender)
534
656
  ]);
535
657
  }
536
- async avmOpcodeEmitNullifier(foreignNullifier) {
658
+ // eslint-disable-next-line camelcase
659
+ async aztec_avm_emitNullifier(foreignNullifier) {
537
660
  const nullifier = fromSingle(foreignNullifier);
538
- await this.handlerAsAvm().avmOpcodeEmitNullifier(nullifier);
661
+ await this.handlerAsAvm().emitNullifier(nullifier);
539
662
  return toForeignCallResult([]);
540
663
  }
541
- async avmOpcodeEmitNoteHash(foreignNoteHash) {
664
+ // eslint-disable-next-line camelcase
665
+ async aztec_avm_emitNoteHash(foreignNoteHash) {
542
666
  const noteHash = fromSingle(foreignNoteHash);
543
- await this.handlerAsAvm().avmOpcodeEmitNoteHash(noteHash);
667
+ await this.handlerAsAvm().emitNoteHash(noteHash);
544
668
  return toForeignCallResult([]);
545
669
  }
546
- async avmOpcodeNullifierExists(foreignInnerNullifier, foreignTargetAddress) {
547
- const innerNullifier = fromSingle(foreignInnerNullifier);
548
- const targetAddress = AztecAddress.fromField(fromSingle(foreignTargetAddress));
549
- const exists = await this.handlerAsAvm().avmOpcodeNullifierExists(innerNullifier, targetAddress);
670
+ // eslint-disable-next-line camelcase
671
+ async aztec_avm_nullifierExists(foreignSiloedNullifier) {
672
+ const siloedNullifier = fromSingle(foreignSiloedNullifier);
673
+ const exists = await this.handlerAsAvm().nullifierExists(siloedNullifier);
550
674
  return toForeignCallResult([
551
675
  toSingle(new Fr(exists))
552
676
  ]);
553
677
  }
554
- async avmOpcodeAddress() {
555
- const contractAddress = await this.handlerAsAvm().avmOpcodeAddress();
678
+ // eslint-disable-next-line camelcase
679
+ async aztec_avm_address() {
680
+ const contractAddress = await this.handlerAsAvm().address();
556
681
  return toForeignCallResult([
557
682
  toSingle(contractAddress.toField())
558
683
  ]);
559
684
  }
560
- async avmOpcodeBlockNumber() {
561
- const blockNumber = await this.handlerAsAvm().avmOpcodeBlockNumber();
685
+ // eslint-disable-next-line camelcase
686
+ async aztec_avm_blockNumber() {
687
+ const blockNumber = await this.handlerAsAvm().blockNumber();
562
688
  return toForeignCallResult([
563
689
  toSingle(new Fr(blockNumber))
564
690
  ]);
565
691
  }
566
- async avmOpcodeTimestamp() {
567
- const timestamp = await this.handlerAsAvm().avmOpcodeTimestamp();
692
+ // eslint-disable-next-line camelcase
693
+ async aztec_avm_timestamp() {
694
+ const timestamp = await this.handlerAsAvm().timestamp();
568
695
  return toForeignCallResult([
569
696
  toSingle(new Fr(timestamp))
570
697
  ]);
571
698
  }
572
- async avmOpcodeIsStaticCall() {
573
- const isStaticCall = await this.handlerAsAvm().avmOpcodeIsStaticCall();
699
+ // eslint-disable-next-line camelcase
700
+ async aztec_avm_isStaticCall() {
701
+ const isStaticCall = await this.handlerAsAvm().isStaticCall();
574
702
  return toForeignCallResult([
575
703
  toSingle(new Fr(isStaticCall ? 1 : 0))
576
704
  ]);
577
705
  }
578
- async avmOpcodeChainId() {
579
- const chainId = await this.handlerAsAvm().avmOpcodeChainId();
706
+ // eslint-disable-next-line camelcase
707
+ async aztec_avm_chainId() {
708
+ const chainId = await this.handlerAsAvm().chainId();
580
709
  return toForeignCallResult([
581
710
  toSingle(chainId)
582
711
  ]);
583
712
  }
584
- async avmOpcodeVersion() {
585
- const version = await this.handlerAsAvm().avmOpcodeVersion();
713
+ // eslint-disable-next-line camelcase
714
+ async aztec_avm_version() {
715
+ const version = await this.handlerAsAvm().version();
586
716
  return toForeignCallResult([
587
717
  toSingle(version)
588
718
  ]);
589
719
  }
590
- avmOpcodeReturndataSize() {
720
+ // eslint-disable-next-line camelcase
721
+ aztec_avm_returndataSize() {
591
722
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
592
723
  }
593
- avmOpcodeReturndataCopy(_foreignRdOffset, _foreignCopySize) {
724
+ // eslint-disable-next-line camelcase
725
+ aztec_avm_returndataCopy(_foreignRdOffset, _foreignCopySize) {
594
726
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
595
727
  }
596
- avmOpcodeCall(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
728
+ // eslint-disable-next-line camelcase
729
+ aztec_avm_call(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
597
730
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
598
731
  }
599
- avmOpcodeStaticCall(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
732
+ // eslint-disable-next-line camelcase
733
+ aztec_avm_staticCall(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
600
734
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
601
735
  }
602
- avmOpcodeSuccessCopy() {
736
+ // eslint-disable-next-line camelcase
737
+ aztec_avm_successCopy() {
603
738
  throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
604
739
  }
605
- async txePrivateCallNewFlow(foreignFrom, foreignTargetContractAddress, foreignFunctionSelector, foreignArgs, foreignArgsHash, foreignIsStaticCall) {
740
+ // eslint-disable-next-line camelcase
741
+ async aztec_txe_privateCallNewFlow(foreignFrom, foreignTargetContractAddress, foreignFunctionSelector, foreignArgs, foreignArgsHash, foreignIsStaticCall) {
606
742
  const from = addressFromSingle(foreignFrom);
607
743
  const targetContractAddress = addressFromSingle(foreignTargetContractAddress);
608
744
  const functionSelector = FunctionSelector.fromField(fromSingle(foreignFunctionSelector));
609
745
  const args = fromArray(foreignArgs);
610
746
  const argsHash = fromSingle(foreignArgsHash);
611
747
  const isStaticCall = fromSingle(foreignIsStaticCall).toBool();
612
- const returnValues = await this.handlerAsTxe().txePrivateCallNewFlow(from, targetContractAddress, functionSelector, args, argsHash, isStaticCall);
748
+ const returnValues = await this.handlerAsTxe().privateCallNewFlow(from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, this.stateHandler.getCurrentJob());
749
+ // TODO(F-335): Avoid doing the following call here.
750
+ await this.stateHandler.cycleJob();
613
751
  return toForeignCallResult([
614
752
  toArray(returnValues)
615
753
  ]);
616
754
  }
617
- async txeSimulateUtilityFunction(foreignTargetContractAddress, foreignFunctionSelector, foreignArgs) {
755
+ // eslint-disable-next-line camelcase
756
+ async aztec_txe_executeUtilityFunction(foreignTargetContractAddress, foreignFunctionSelector, foreignArgs) {
618
757
  const targetContractAddress = addressFromSingle(foreignTargetContractAddress);
619
758
  const functionSelector = FunctionSelector.fromField(fromSingle(foreignFunctionSelector));
620
759
  const args = fromArray(foreignArgs);
621
- const returnValues = await this.handlerAsTxe().txeSimulateUtilityFunction(targetContractAddress, functionSelector, args);
760
+ const returnValues = await this.handlerAsTxe().executeUtilityFunction(targetContractAddress, functionSelector, args, this.stateHandler.getCurrentJob());
761
+ // TODO(F-335): Avoid doing the following call here.
762
+ await this.stateHandler.cycleJob();
622
763
  return toForeignCallResult([
623
764
  toArray(returnValues)
624
765
  ]);
625
766
  }
626
- async txePublicCallNewFlow(foreignFrom, foreignAddress, foreignCalldata, foreignIsStaticCall) {
767
+ // eslint-disable-next-line camelcase
768
+ async aztec_txe_publicCallNewFlow(foreignFrom, foreignAddress, foreignCalldata, foreignIsStaticCall) {
627
769
  const from = addressFromSingle(foreignFrom);
628
770
  const address = addressFromSingle(foreignAddress);
629
771
  const calldata = fromArray(foreignCalldata);
630
772
  const isStaticCall = fromSingle(foreignIsStaticCall).toBool();
631
- const returnValues = await this.handlerAsTxe().txePublicCallNewFlow(from, address, calldata, isStaticCall);
773
+ const returnValues = await this.handlerAsTxe().publicCallNewFlow(from, address, calldata, isStaticCall);
774
+ // TODO(F-335): Avoid doing the following call here.
775
+ await this.stateHandler.cycleJob();
632
776
  return toForeignCallResult([
633
777
  toArray(returnValues)
634
778
  ]);
635
779
  }
636
- async privateGetSenderForTags() {
637
- const sender = await this.handlerAsPrivate().privateGetSenderForTags();
780
+ // eslint-disable-next-line camelcase
781
+ async aztec_prv_getSenderForTags() {
782
+ const sender = await this.handlerAsPrivate().getSenderForTags();
638
783
  // Return a Noir Option struct with `some` and `value` fields
639
784
  if (sender === undefined) {
640
785
  // No sender found, return Option with some=0 and value=0
@@ -650,15 +795,17 @@ export class RPCTranslator {
650
795
  ]);
651
796
  }
652
797
  }
653
- async privateSetSenderForTags(foreignSenderForTags) {
798
+ // eslint-disable-next-line camelcase
799
+ async aztec_prv_setSenderForTags(foreignSenderForTags) {
654
800
  const senderForTags = AztecAddress.fromField(fromSingle(foreignSenderForTags));
655
- await this.handlerAsPrivate().privateSetSenderForTags(senderForTags);
801
+ await this.handlerAsPrivate().setSenderForTags(senderForTags);
656
802
  return toForeignCallResult([]);
657
803
  }
658
- async privateGetNextAppTagAsSender(foreignSender, foreignRecipient) {
804
+ // eslint-disable-next-line camelcase
805
+ async aztec_prv_getNextAppTagAsSender(foreignSender, foreignRecipient) {
659
806
  const sender = AztecAddress.fromField(fromSingle(foreignSender));
660
807
  const recipient = AztecAddress.fromField(fromSingle(foreignRecipient));
661
- const nextAppTag = await this.handlerAsPrivate().privateGetNextAppTagAsSender(sender, recipient);
808
+ const nextAppTag = await this.handlerAsPrivate().getNextAppTagAsSender(sender, recipient);
662
809
  return toForeignCallResult([
663
810
  toSingle(nextAppTag.value)
664
811
  ]);