@aztec/txe 0.0.1-commit.96bb3f7 → 0.0.1-commit.9d2bcf6d

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 (48) 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/oracle/interfaces.d.ts +3 -3
  5. package/dest/oracle/interfaces.d.ts.map +1 -1
  6. package/dest/oracle/txe_oracle_public_context.d.ts +3 -3
  7. package/dest/oracle/txe_oracle_public_context.d.ts.map +1 -1
  8. package/dest/oracle/txe_oracle_public_context.js +6 -6
  9. package/dest/oracle/txe_oracle_top_level_context.d.ts +3 -2
  10. package/dest/oracle/txe_oracle_top_level_context.d.ts.map +1 -1
  11. package/dest/oracle/txe_oracle_top_level_context.js +33 -24
  12. package/dest/rpc_translator.d.ts +17 -11
  13. package/dest/rpc_translator.d.ts.map +1 -1
  14. package/dest/rpc_translator.js +73 -48
  15. package/dest/state_machine/archiver.d.ts +20 -69
  16. package/dest/state_machine/archiver.d.ts.map +1 -1
  17. package/dest/state_machine/archiver.js +34 -178
  18. package/dest/state_machine/index.d.ts +1 -1
  19. package/dest/state_machine/index.d.ts.map +1 -1
  20. package/dest/state_machine/index.js +22 -4
  21. package/dest/state_machine/mock_epoch_cache.d.ts +6 -6
  22. package/dest/state_machine/mock_epoch_cache.d.ts.map +1 -1
  23. package/dest/state_machine/mock_epoch_cache.js +7 -7
  24. package/dest/state_machine/synchronizer.d.ts +3 -3
  25. package/dest/state_machine/synchronizer.d.ts.map +1 -1
  26. package/dest/txe_session.d.ts +5 -3
  27. package/dest/txe_session.d.ts.map +1 -1
  28. package/dest/txe_session.js +31 -15
  29. package/dest/util/encoding.d.ts +17 -17
  30. package/dest/utils/block_creation.d.ts +4 -4
  31. package/dest/utils/block_creation.d.ts.map +1 -1
  32. package/dest/utils/block_creation.js +16 -4
  33. package/dest/utils/tx_effect_creation.d.ts +2 -3
  34. package/dest/utils/tx_effect_creation.d.ts.map +1 -1
  35. package/dest/utils/tx_effect_creation.js +3 -6
  36. package/package.json +16 -16
  37. package/src/constants.ts +0 -1
  38. package/src/oracle/interfaces.ts +2 -2
  39. package/src/oracle/txe_oracle_public_context.ts +6 -8
  40. package/src/oracle/txe_oracle_top_level_context.ts +72 -28
  41. package/src/rpc_translator.ts +76 -50
  42. package/src/state_machine/archiver.ts +35 -234
  43. package/src/state_machine/index.ts +26 -4
  44. package/src/state_machine/mock_epoch_cache.ts +6 -11
  45. package/src/state_machine/synchronizer.ts +2 -2
  46. package/src/txe_session.ts +38 -24
  47. package/src/utils/block_creation.ts +17 -16
  48. package/src/utils/tx_effect_creation.ts +3 -11
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aztec/txe",
3
- "version": "0.0.1-commit.96bb3f7",
3
+ "version": "0.0.1-commit.9d2bcf6d",
4
4
  "type": "module",
5
5
  "exports": "./dest/index.js",
6
6
  "bin": "./dest/bin/index.js",
@@ -61,27 +61,27 @@
61
61
  ]
62
62
  },
63
63
  "dependencies": {
64
- "@aztec/accounts": "0.0.1-commit.96bb3f7",
65
- "@aztec/archiver": "0.0.1-commit.96bb3f7",
66
- "@aztec/aztec-node": "0.0.1-commit.96bb3f7",
67
- "@aztec/aztec.js": "0.0.1-commit.96bb3f7",
68
- "@aztec/bb-prover": "0.0.1-commit.96bb3f7",
69
- "@aztec/constants": "0.0.1-commit.96bb3f7",
70
- "@aztec/foundation": "0.0.1-commit.96bb3f7",
71
- "@aztec/key-store": "0.0.1-commit.96bb3f7",
72
- "@aztec/kv-store": "0.0.1-commit.96bb3f7",
73
- "@aztec/protocol-contracts": "0.0.1-commit.96bb3f7",
74
- "@aztec/pxe": "0.0.1-commit.96bb3f7",
75
- "@aztec/simulator": "0.0.1-commit.96bb3f7",
76
- "@aztec/stdlib": "0.0.1-commit.96bb3f7",
77
- "@aztec/world-state": "0.0.1-commit.96bb3f7",
64
+ "@aztec/accounts": "0.0.1-commit.9d2bcf6d",
65
+ "@aztec/archiver": "0.0.1-commit.9d2bcf6d",
66
+ "@aztec/aztec-node": "0.0.1-commit.9d2bcf6d",
67
+ "@aztec/aztec.js": "0.0.1-commit.9d2bcf6d",
68
+ "@aztec/bb-prover": "0.0.1-commit.9d2bcf6d",
69
+ "@aztec/constants": "0.0.1-commit.9d2bcf6d",
70
+ "@aztec/foundation": "0.0.1-commit.9d2bcf6d",
71
+ "@aztec/key-store": "0.0.1-commit.9d2bcf6d",
72
+ "@aztec/kv-store": "0.0.1-commit.9d2bcf6d",
73
+ "@aztec/protocol-contracts": "0.0.1-commit.9d2bcf6d",
74
+ "@aztec/pxe": "0.0.1-commit.9d2bcf6d",
75
+ "@aztec/simulator": "0.0.1-commit.9d2bcf6d",
76
+ "@aztec/stdlib": "0.0.1-commit.9d2bcf6d",
77
+ "@aztec/world-state": "0.0.1-commit.9d2bcf6d",
78
78
  "zod": "^3.23.8"
79
79
  },
80
80
  "devDependencies": {
81
81
  "@jest/globals": "^30.0.0",
82
82
  "@types/jest": "^30.0.0",
83
83
  "@types/node": "^22.15.17",
84
- "@typescript/native-preview": "7.0.0-dev.20251126.1",
84
+ "@typescript/native-preview": "7.0.0-dev.20260113.1",
85
85
  "jest": "^30.0.0",
86
86
  "jest-mock-extended": "^4.0.0",
87
87
  "ts-node": "^10.9.1",
package/src/constants.ts CHANGED
@@ -1,4 +1,3 @@
1
1
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
2
2
 
3
3
  export const DEFAULT_ADDRESS = AztecAddress.fromNumber(42);
4
- export const TXE_JOB_ID = 'test-job-id';
@@ -33,9 +33,9 @@ export interface IAvmExecutionOracle {
33
33
  avmOpcodeVersion(): Promise<Fr>;
34
34
  avmOpcodeEmitNullifier(nullifier: Fr): Promise<void>;
35
35
  avmOpcodeEmitNoteHash(noteHash: Fr): Promise<void>;
36
- avmOpcodeNullifierExists(innerNullifier: Fr, targetAddress: AztecAddress): Promise<boolean>;
36
+ avmOpcodeNullifierExists(siloedNullifier: Fr): Promise<boolean>;
37
37
  avmOpcodeStorageWrite(slot: Fr, value: Fr): Promise<void>;
38
- avmOpcodeStorageRead(slot: Fr): Promise<Fr>;
38
+ avmOpcodeStorageRead(slot: Fr, contractAddress: AztecAddress): Promise<Fr>;
39
39
  }
40
40
 
41
41
  /**
@@ -78,13 +78,11 @@ export class TXEOraclePublicContext implements IAvmExecutionOracle {
78
78
  this.transientUniqueNoteHashes.push(siloedNoteHash);
79
79
  }
80
80
 
81
- async avmOpcodeNullifierExists(innerNullifier: Fr, targetAddress: AztecAddress): Promise<boolean> {
82
- const nullifier = await siloNullifier(targetAddress, innerNullifier!);
83
-
81
+ async avmOpcodeNullifierExists(siloedNullifier: Fr): Promise<boolean> {
84
82
  const treeIndex = (
85
- await this.forkedWorldTrees.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, [nullifier.toBuffer()])
83
+ await this.forkedWorldTrees.findLeafIndices(MerkleTreeId.NULLIFIER_TREE, [siloedNullifier.toBuffer()])
86
84
  )[0];
87
- const transientIndex = this.transientSiloedNullifiers.find(n => n.equals(nullifier));
85
+ const transientIndex = this.transientSiloedNullifiers.find(n => n.equals(siloedNullifier));
88
86
 
89
87
  return treeIndex !== undefined || transientIndex !== undefined;
90
88
  }
@@ -101,8 +99,8 @@ export class TXEOraclePublicContext implements IAvmExecutionOracle {
101
99
  ]);
102
100
  }
103
101
 
104
- async avmOpcodeStorageRead(slot: Fr): Promise<Fr> {
105
- const leafSlot = await computePublicDataTreeLeafSlot(this.contractAddress, slot);
102
+ async avmOpcodeStorageRead(slot: Fr, contractAddress: AztecAddress): Promise<Fr> {
103
+ const leafSlot = await computePublicDataTreeLeafSlot(contractAddress, slot);
106
104
 
107
105
  const lowLeafResult = await this.forkedWorldTrees.getPreviousValueIndex(
108
106
  MerkleTreeId.PUBLIC_DATA_TREE,
@@ -119,7 +117,7 @@ export class TXEOraclePublicContext implements IAvmExecutionOracle {
119
117
  )) as PublicDataTreeLeafPreimage
120
118
  ).leaf.value;
121
119
 
122
- this.logger.debug('AVM storage read', { slot, value });
120
+ this.logger.debug('AVM storage read', { slot, contractAddress, value });
123
121
 
124
122
  return value;
125
123
  }
@@ -22,6 +22,7 @@ import {
22
22
  SenderAddressBookStore,
23
23
  SenderTaggingStore,
24
24
  enrichPublicSimulationError,
25
+ syncState,
25
26
  } from '@aztec/pxe/server';
26
27
  import {
27
28
  ExecutionNoteCache,
@@ -80,7 +81,7 @@ import {
80
81
  import type { UInt64 } from '@aztec/stdlib/types';
81
82
  import { ForkCheckpoint } from '@aztec/world-state';
82
83
 
83
- import { DEFAULT_ADDRESS, TXE_JOB_ID } from '../constants.js';
84
+ import { DEFAULT_ADDRESS } from '../constants.js';
84
85
  import type { TXEStateMachine } from '../state_machine/index.js';
85
86
  import type { TXEAccountStore } from '../util/txe_account_store.js';
86
87
  import type { TXEContractStore } from '../util/txe_contract_store.js';
@@ -106,6 +107,7 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
106
107
  private senderAddressBookStore: SenderAddressBookStore,
107
108
  private capsuleStore: CapsuleStore,
108
109
  private privateEventStore: PrivateEventStore,
110
+ private jobId: string,
109
111
  private nextBlockTimestamp: bigint,
110
112
  private version: Fr,
111
113
  private chainId: Fr,
@@ -156,7 +158,8 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
156
158
  }
157
159
 
158
160
  async txeGetLastTxEffects() {
159
- const block = await this.stateMachine.archiver.getL2Block('latest');
161
+ const latestBlockNumber = await this.stateMachine.archiver.getBlockNumber();
162
+ const block = await this.stateMachine.archiver.getBlock(latestBlockNumber);
160
163
 
161
164
  if (block!.body.txEffects.length != 1) {
162
165
  // Note that calls like env.mine() will result in blocks with no transactions, hitting this
@@ -299,7 +302,17 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
299
302
  await this.executeUtilityCall(call);
300
303
  };
301
304
 
302
- await this.contractStore.syncPrivateState(targetContractAddress, functionSelector, utilityExecutor);
305
+ const blockHeader = await this.stateMachine.anchorBlockStore.getBlockHeader();
306
+ await syncState(
307
+ targetContractAddress,
308
+ this.contractStore,
309
+ functionSelector,
310
+ utilityExecutor,
311
+ this.noteStore,
312
+ this.stateMachine.node,
313
+ blockHeader,
314
+ this.jobId,
315
+ );
303
316
 
304
317
  const blockNumber = await this.txeGetNextBlockNumber();
305
318
 
@@ -311,10 +324,13 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
311
324
 
312
325
  const txContext = new TxContext(this.chainId, this.version, gasSettings);
313
326
 
314
- const blockHeader = await this.stateMachine.anchorBlockStore.getBlockHeader();
315
-
316
327
  const protocolNullifier = await computeProtocolNullifier(getSingleTxBlockRequestHash(blockNumber));
317
328
  const noteCache = new ExecutionNoteCache(protocolNullifier);
329
+ // In production, the account contract sets the min revertible counter before calling the app function.
330
+ // Since TXE bypasses the account contract, we simulate this by setting minRevertibleSideEffectCounter to 1,
331
+ // marking all side effects as revertible.
332
+ const minRevertibleSideEffectCounter = 1;
333
+ await noteCache.setMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter);
318
334
  const taggingIndexCache = new ExecutionTaggingIndexCache();
319
335
 
320
336
  const simulator = new WASMSimulator();
@@ -338,15 +354,14 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
338
354
  this.keyStore,
339
355
  this.addressStore,
340
356
  this.stateMachine.node,
341
- this.stateMachine.anchorBlockStore,
342
357
  this.senderTaggingStore,
343
358
  this.recipientTaggingStore,
344
359
  this.senderAddressBookStore,
345
360
  this.capsuleStore,
346
361
  this.privateEventStore,
347
- TXE_JOB_ID,
348
- 0,
349
- 1,
362
+ this.jobId,
363
+ 0, // totalPublicArgsCount
364
+ minRevertibleSideEffectCounter, // (start) sideEffectCounter
350
365
  undefined, // log
351
366
  undefined, // scopes
352
367
  /**
@@ -382,19 +397,21 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
382
397
  }),
383
398
  );
384
399
 
385
- // TXE's top level context does not track side effect counters, and as such, minRevertibleSideEffectCounter is always 0.
386
- // This has the unfortunate consequence of always producing revertible nullifiers, which means we
387
- // must set the firstNullifierHint to Fr.ZERO so the txRequestHash is always used as nonce generator
388
- result = new PrivateExecutionResult(executionResult, Fr.ZERO, publicFunctionsCalldata);
400
+ noteCache.finish();
401
+ const nonceGenerator = noteCache.getNonceGenerator();
402
+ result = new PrivateExecutionResult(executionResult, nonceGenerator, publicFunctionsCalldata);
389
403
  } catch (err) {
390
404
  throw createSimulationError(err instanceof Error ? err : new Error('Unknown error during private execution'));
391
405
  }
392
406
 
393
- // According to the protocol rules, the nonce generator for the note hashes
394
- // can either be the first nullifier in the tx or the hash of the initial tx request
395
- // if there are none.
396
- const nonceGenerator = result.firstNullifier.equals(Fr.ZERO) ? protocolNullifier : result.firstNullifier;
397
- const { publicInputs } = await generateSimulatedProvingResult(result, nonceGenerator, this.contractStore);
407
+ // According to the protocol rules, there must be at least one nullifier in the tx. The first nullifier is used as
408
+ // the nonce generator for the note hashes.
409
+ // We pass the non-zero minRevertibleSideEffectCounter to make sure the side effects are split correctly.
410
+ const { publicInputs } = await generateSimulatedProvingResult(
411
+ result,
412
+ this.contractStore,
413
+ minRevertibleSideEffectCounter,
414
+ );
398
415
 
399
416
  const globals = makeGlobalVariables();
400
417
  globals.blockNumber = blockNumber;
@@ -405,7 +422,11 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
405
422
 
406
423
  const forkedWorldTrees = await this.stateMachine.synchronizer.nativeWorldStateService.fork();
407
424
 
408
- const contractsDB = new PublicContractsDB(new TXEPublicContractDataSource(blockNumber, this.contractStore));
425
+ const bindings = this.logger.getBindings();
426
+ const contractsDB = new PublicContractsDB(
427
+ new TXEPublicContractDataSource(blockNumber, this.contractStore),
428
+ bindings,
429
+ );
409
430
  const guardedMerkleTrees = new GuardedMerkleTreeOperations(forkedWorldTrees);
410
431
  const config = PublicSimulatorConfig.from({
411
432
  skipFeeEnforcement: true,
@@ -418,8 +439,10 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
418
439
  globals,
419
440
  guardedMerkleTrees,
420
441
  contractsDB,
421
- new CppPublicTxSimulator(guardedMerkleTrees, contractsDB, globals, config),
442
+ new CppPublicTxSimulator(guardedMerkleTrees, contractsDB, globals, config, bindings),
422
443
  new TestDateProvider(),
444
+ undefined,
445
+ createLogger('simulator:public-processor', bindings),
423
446
  );
424
447
 
425
448
  const tx = await Tx.create({
@@ -516,7 +539,11 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
516
539
 
517
540
  const forkedWorldTrees = await this.stateMachine.synchronizer.nativeWorldStateService.fork();
518
541
 
519
- const contractsDB = new PublicContractsDB(new TXEPublicContractDataSource(blockNumber, this.contractStore));
542
+ const bindings2 = this.logger.getBindings();
543
+ const contractsDB = new PublicContractsDB(
544
+ new TXEPublicContractDataSource(blockNumber, this.contractStore),
545
+ bindings2,
546
+ );
520
547
  const guardedMerkleTrees = new GuardedMerkleTreeOperations(forkedWorldTrees);
521
548
  const config = PublicSimulatorConfig.from({
522
549
  skipFeeEnforcement: true,
@@ -525,8 +552,16 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
525
552
  collectStatistics: false,
526
553
  collectCallMetadata: true,
527
554
  });
528
- const simulator = new CppPublicTxSimulator(guardedMerkleTrees, contractsDB, globals, config);
529
- const processor = new PublicProcessor(globals, guardedMerkleTrees, contractsDB, simulator, new TestDateProvider());
555
+ const simulator = new CppPublicTxSimulator(guardedMerkleTrees, contractsDB, globals, config, bindings2);
556
+ const processor = new PublicProcessor(
557
+ globals,
558
+ guardedMerkleTrees,
559
+ contractsDB,
560
+ simulator,
561
+ new TestDateProvider(),
562
+ undefined,
563
+ createLogger('simulator:public-processor', bindings2),
564
+ );
530
565
 
531
566
  // We're simulating a scenario in which private execution immediately enqueues a public call and halts. The private
532
567
  // kernel init would in this case inject a nullifier with the transaction request hash as a non-revertible
@@ -636,9 +671,19 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
636
671
  }
637
672
 
638
673
  // Sync notes before executing utility function to discover notes from previous transactions
639
- await this.contractStore.syncPrivateState(targetContractAddress, functionSelector, async call => {
640
- await this.executeUtilityCall(call);
641
- });
674
+ const blockHeader = await this.stateMachine.anchorBlockStore.getBlockHeader();
675
+ await syncState(
676
+ targetContractAddress,
677
+ this.contractStore,
678
+ functionSelector,
679
+ async call => {
680
+ await this.executeUtilityCall(call);
681
+ },
682
+ this.noteStore,
683
+ this.stateMachine.node,
684
+ blockHeader,
685
+ this.jobId,
686
+ );
642
687
 
643
688
  const call = new FunctionCall(
644
689
  artifact.name,
@@ -677,12 +722,11 @@ export class TXEOracleTopLevelContext implements IMiscOracle, ITxeExecutionOracl
677
722
  this.keyStore,
678
723
  this.addressStore,
679
724
  this.stateMachine.node,
680
- this.stateMachine.anchorBlockStore,
681
725
  this.recipientTaggingStore,
682
726
  this.senderAddressBookStore,
683
727
  this.capsuleStore,
684
728
  this.privateEventStore,
685
- TXE_JOB_ID,
729
+ this.jobId,
686
730
  );
687
731
  const acirExecutionResult = await new WASMSimulator()
688
732
  .executeUserCircuit(toACVMWitness(0, call.args), entryPointArtifact, new Oracle(oracle).toACIRCallback())
@@ -6,11 +6,11 @@ import {
6
6
  type IMiscOracle,
7
7
  type IPrivateExecutionOracle,
8
8
  type IUtilityExecutionOracle,
9
- packAsRetrievedNote,
9
+ packAsHintedNote,
10
10
  } from '@aztec/pxe/simulator';
11
11
  import { type ContractArtifact, EventSelector, FunctionSelector, NoteSelector } from '@aztec/stdlib/abi';
12
12
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
13
- import { MerkleTreeId } from '@aztec/stdlib/trees';
13
+ import { BlockHash } from '@aztec/stdlib/block';
14
14
 
15
15
  import type { IAvmExecutionOracle, ITxeExecutionOracle } from './oracle/interfaces.js';
16
16
  import type { TXESessionStateHandler } from './txe_session.js';
@@ -346,34 +346,34 @@ export class RPCTranslator {
346
346
  }
347
347
 
348
348
  async utilityStorageRead(
349
+ foreignBlockHash: ForeignCallSingle,
349
350
  foreignContractAddress: ForeignCallSingle,
350
351
  foreignStartStorageSlot: ForeignCallSingle,
351
- foreignBlockNumber: ForeignCallSingle,
352
352
  foreignNumberOfElements: ForeignCallSingle,
353
353
  ) {
354
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
354
355
  const contractAddress = addressFromSingle(foreignContractAddress);
355
356
  const startStorageSlot = fromSingle(foreignStartStorageSlot);
356
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
357
357
  const numberOfElements = fromSingle(foreignNumberOfElements).toNumber();
358
358
 
359
359
  const values = await this.handlerAsUtility().utilityStorageRead(
360
+ blockHash,
360
361
  contractAddress,
361
362
  startStorageSlot,
362
- blockNumber,
363
363
  numberOfElements,
364
364
  );
365
365
 
366
366
  return toForeignCallResult([toArray(values)]);
367
367
  }
368
368
 
369
- async utilityGetPublicDataWitness(foreignBlockNumber: ForeignCallSingle, foreignLeafSlot: ForeignCallSingle) {
370
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
369
+ async utilityGetPublicDataWitness(foreignBlockHash: ForeignCallSingle, foreignLeafSlot: ForeignCallSingle) {
370
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
371
371
  const leafSlot = fromSingle(foreignLeafSlot);
372
372
 
373
- const witness = await this.handlerAsUtility().utilityGetPublicDataWitness(blockNumber, leafSlot);
373
+ const witness = await this.handlerAsUtility().utilityGetPublicDataWitness(blockHash, leafSlot);
374
374
 
375
375
  if (!witness) {
376
- throw new Error(`Public data witness not found for slot ${leafSlot} at block ${blockNumber}.`);
376
+ throw new Error(`Public data witness not found for slot ${leafSlot} at block ${blockHash.toString()}.`);
377
377
  }
378
378
  return toForeignCallResult(witness.toNoirRepresentation());
379
379
  }
@@ -396,7 +396,7 @@ export class RPCTranslator {
396
396
  foreignOffset: ForeignCallSingle,
397
397
  foreignStatus: ForeignCallSingle,
398
398
  foreignMaxNotes: ForeignCallSingle,
399
- foreignPackedRetrievedNoteLength: ForeignCallSingle,
399
+ foreignPackedHintedNoteLength: ForeignCallSingle,
400
400
  ) {
401
401
  // Parse Option<AztecAddress>: ownerIsSome is 0 for None, 1 for Some
402
402
  const owner = fromSingle(foreignOwnerIsSome).toBool()
@@ -417,7 +417,7 @@ export class RPCTranslator {
417
417
  const offset = fromSingle(foreignOffset).toNumber();
418
418
  const status = fromSingle(foreignStatus).toNumber();
419
419
  const maxNotes = fromSingle(foreignMaxNotes).toNumber();
420
- const packedRetrievedNoteLength = fromSingle(foreignPackedRetrievedNoteLength).toNumber();
420
+ const packedHintedNoteLength = fromSingle(foreignPackedHintedNoteLength).toNumber();
421
421
 
422
422
  const noteDatas = await this.handlerAsUtility().utilityGetNotes(
423
423
  owner,
@@ -438,13 +438,13 @@ export class RPCTranslator {
438
438
  );
439
439
 
440
440
  const returnDataAsArrayOfArrays = noteDatas.map(noteData =>
441
- packAsRetrievedNote({
441
+ packAsHintedNote({
442
442
  contractAddress: noteData.contractAddress,
443
443
  owner: noteData.owner,
444
444
  randomness: noteData.randomness,
445
445
  storageSlot: noteData.storageSlot,
446
446
  noteNonce: noteData.noteNonce,
447
- index: noteData.index,
447
+ isPending: noteData.isPending,
448
448
  note: noteData.note,
449
449
  }),
450
450
  );
@@ -456,11 +456,7 @@ export class RPCTranslator {
456
456
 
457
457
  // At last we convert the array of arrays to a bounded vec of arrays
458
458
  return toForeignCallResult(
459
- arrayOfArraysToBoundedVecOfArrays(
460
- returnDataAsArrayOfForeignCallSingleArrays,
461
- maxNotes,
462
- packedRetrievedNoteLength,
463
- ),
459
+ arrayOfArraysToBoundedVecOfArrays(returnDataAsArrayOfForeignCallSingleArrays, maxNotes, packedHintedNoteLength),
464
460
  );
465
461
  }
466
462
 
@@ -516,6 +512,15 @@ export class RPCTranslator {
516
512
  return toForeignCallResult([]);
517
513
  }
518
514
 
515
+ async privateIsNullifierPending(foreignInnerNullifier: ForeignCallSingle, foreignContractAddress: ForeignCallSingle) {
516
+ const innerNullifier = fromSingle(foreignInnerNullifier);
517
+ const contractAddress = addressFromSingle(foreignContractAddress);
518
+
519
+ const isPending = await this.handlerAsPrivate().privateIsNullifierPending(innerNullifier, contractAddress);
520
+
521
+ return toForeignCallResult([toSingle(new Fr(isPending))]);
522
+ }
523
+
519
524
  async utilityCheckNullifierExists(foreignInnerNullifier: ForeignCallSingle) {
520
525
  const innerNullifier = fromSingle(foreignInnerNullifier);
521
526
 
@@ -540,12 +545,23 @@ export class RPCTranslator {
540
545
  );
541
546
  }
542
547
 
543
- async utilityGetPublicKeysAndPartialAddress(foreignAddress: ForeignCallSingle) {
548
+ async utilityTryGetPublicKeysAndPartialAddress(foreignAddress: ForeignCallSingle) {
544
549
  const address = addressFromSingle(foreignAddress);
545
550
 
546
- const { publicKeys, partialAddress } = await this.handlerAsUtility().utilityGetPublicKeysAndPartialAddress(address);
551
+ const result = await this.handlerAsUtility().utilityTryGetPublicKeysAndPartialAddress(address);
547
552
 
548
- return toForeignCallResult([toArray([...publicKeys.toFields(), partialAddress])]);
553
+ // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
554
+ // with two fields: `some` (a boolean) and `value` (a field array in this case).
555
+ if (result === undefined) {
556
+ // No data was found so we set `some` to 0 and pad `value` with zeros get the correct return size.
557
+ return toForeignCallResult([toSingle(new Fr(0)), toArray(Array(13).fill(new Fr(0)))]);
558
+ } else {
559
+ // Data was found so we set `some` to 1 and return it along with `value`.
560
+ return toForeignCallResult([
561
+ toSingle(new Fr(1)),
562
+ toArray([...result.publicKeys.toFields(), result.partialAddress]),
563
+ ]);
564
+ }
549
565
  }
550
566
 
551
567
  async utilityGetKeyValidationRequest(foreignPkMHash: ForeignCallSingle) {
@@ -568,17 +584,14 @@ export class RPCTranslator {
568
584
  );
569
585
  }
570
586
 
571
- async utilityGetNullifierMembershipWitness(
572
- foreignBlockNumber: ForeignCallSingle,
573
- foreignNullifier: ForeignCallSingle,
574
- ) {
575
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
587
+ async utilityGetNullifierMembershipWitness(foreignBlockHash: ForeignCallSingle, foreignNullifier: ForeignCallSingle) {
588
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
576
589
  const nullifier = fromSingle(foreignNullifier);
577
590
 
578
- const witness = await this.handlerAsUtility().utilityGetNullifierMembershipWitness(blockNumber, nullifier);
591
+ const witness = await this.handlerAsUtility().utilityGetNullifierMembershipWitness(blockHash, nullifier);
579
592
 
580
593
  if (!witness) {
581
- throw new Error(`Nullifier membership witness not found at block ${blockNumber}.`);
594
+ throw new Error(`Nullifier membership witness not found at block ${blockHash}.`);
582
595
  }
583
596
  return toForeignCallResult(witness.toNoirRepresentation());
584
597
  }
@@ -639,36 +652,49 @@ export class RPCTranslator {
639
652
  return toForeignCallResult(header.toFields().map(toSingle));
640
653
  }
641
654
 
642
- async utilityGetMembershipWitness(
643
- foreignBlockNumber: ForeignCallSingle,
644
- foreignTreeId: ForeignCallSingle,
645
- foreignLeafValue: ForeignCallSingle,
655
+ async utilityGetNoteHashMembershipWitness(
656
+ foreignAnchorBlockHash: ForeignCallSingle,
657
+ foreignNoteHash: ForeignCallSingle,
646
658
  ) {
647
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
648
- const treeId = fromSingle(foreignTreeId).toNumber();
649
- const leafValue = fromSingle(foreignLeafValue);
659
+ const blockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
660
+ const noteHash = fromSingle(foreignNoteHash);
661
+
662
+ const witness = await this.handlerAsUtility().utilityGetNoteHashMembershipWitness(blockHash, noteHash);
663
+
664
+ if (!witness) {
665
+ throw new Error(`Note hash ${noteHash} not found in the note hash tree at block ${blockHash.toString()}.`);
666
+ }
667
+ return toForeignCallResult(witness.toNoirRepresentation());
668
+ }
669
+
670
+ async utilityGetBlockHashMembershipWitness(
671
+ foreignAnchorBlockHash: ForeignCallSingle,
672
+ foreignBlockHash: ForeignCallSingle,
673
+ ) {
674
+ const anchorBlockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
675
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
650
676
 
651
- const witness = await this.handlerAsUtility().utilityGetMembershipWitness(blockNumber, treeId, leafValue);
677
+ const witness = await this.handlerAsUtility().utilityGetBlockHashMembershipWitness(anchorBlockHash, blockHash);
652
678
 
653
679
  if (!witness) {
654
680
  throw new Error(
655
- `Membership witness in tree ${MerkleTreeId[treeId]} not found for value ${leafValue} at block ${blockNumber}.`,
681
+ `Block hash ${blockHash.toString()} not found in the archive tree at anchor block ${anchorBlockHash.toString()}.`,
656
682
  );
657
683
  }
658
- return toForeignCallResult([toSingle(witness[0]), toArray(witness.slice(1))]);
684
+ return toForeignCallResult(witness.toNoirRepresentation());
659
685
  }
660
686
 
661
687
  async utilityGetLowNullifierMembershipWitness(
662
- foreignBlockNumber: ForeignCallSingle,
688
+ foreignBlockHash: ForeignCallSingle,
663
689
  foreignNullifier: ForeignCallSingle,
664
690
  ) {
665
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
691
+ const blockHash = new BlockHash(fromSingle(foreignBlockHash));
666
692
  const nullifier = fromSingle(foreignNullifier);
667
693
 
668
- const witness = await this.handlerAsUtility().utilityGetLowNullifierMembershipWitness(blockNumber, nullifier);
694
+ const witness = await this.handlerAsUtility().utilityGetLowNullifierMembershipWitness(blockHash, nullifier);
669
695
 
670
696
  if (!witness) {
671
- throw new Error(`Low nullifier witness not found for nullifier ${nullifier} at block ${blockNumber}.`);
697
+ throw new Error(`Low nullifier witness not found for nullifier ${nullifier} at block ${blockHash}.`);
672
698
  }
673
699
  return toForeignCallResult(witness.toNoirRepresentation());
674
700
  }
@@ -681,7 +707,7 @@ export class RPCTranslator {
681
707
  return toForeignCallResult([]);
682
708
  }
683
709
 
684
- public async utilityValidateEnqueuedNotesAndEvents(
710
+ public async utilityValidateAndStoreEnqueuedNotesAndEvents(
685
711
  foreignContractAddress: ForeignCallSingle,
686
712
  foreignNoteValidationRequestsArrayBaseSlot: ForeignCallSingle,
687
713
  foreignEventValidationRequestsArrayBaseSlot: ForeignCallSingle,
@@ -690,7 +716,7 @@ export class RPCTranslator {
690
716
  const noteValidationRequestsArrayBaseSlot = fromSingle(foreignNoteValidationRequestsArrayBaseSlot);
691
717
  const eventValidationRequestsArrayBaseSlot = fromSingle(foreignEventValidationRequestsArrayBaseSlot);
692
718
 
693
- await this.handlerAsUtility().utilityValidateEnqueuedNotesAndEvents(
719
+ await this.handlerAsUtility().utilityValidateAndStoreEnqueuedNotesAndEvents(
694
720
  contractAddress,
695
721
  noteValidationRequestsArrayBaseSlot,
696
722
  eventValidationRequestsArrayBaseSlot,
@@ -828,10 +854,11 @@ export class RPCTranslator {
828
854
  return toForeignCallResult([]);
829
855
  }
830
856
 
831
- async avmOpcodeStorageRead(foreignSlot: ForeignCallSingle) {
857
+ async avmOpcodeStorageRead(foreignSlot: ForeignCallSingle, foreignContractAddress: ForeignCallSingle) {
832
858
  const slot = fromSingle(foreignSlot);
859
+ const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
833
860
 
834
- const value = (await this.handlerAsAvm().avmOpcodeStorageRead(slot)).value;
861
+ const value = (await this.handlerAsAvm().avmOpcodeStorageRead(slot, contractAddress)).value;
835
862
 
836
863
  return toForeignCallResult([toSingle(new Fr(value))]);
837
864
  }
@@ -903,11 +930,10 @@ export class RPCTranslator {
903
930
  return toForeignCallResult([]);
904
931
  }
905
932
 
906
- async avmOpcodeNullifierExists(foreignInnerNullifier: ForeignCallSingle, foreignTargetAddress: ForeignCallSingle) {
907
- const innerNullifier = fromSingle(foreignInnerNullifier);
908
- const targetAddress = AztecAddress.fromField(fromSingle(foreignTargetAddress));
933
+ async avmOpcodeNullifierExists(foreignSiloedNullifier: ForeignCallSingle) {
934
+ const siloedNullifier = fromSingle(foreignSiloedNullifier);
909
935
 
910
- const exists = await this.handlerAsAvm().avmOpcodeNullifierExists(innerNullifier, targetAddress);
936
+ const exists = await this.handlerAsAvm().avmOpcodeNullifierExists(siloedNullifier);
911
937
 
912
938
  return toForeignCallResult([toSingle(new Fr(exists))]);
913
939
  }