@aztec/pxe 0.0.0-test.1 → 0.0.1-commit.5476d83

package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/tagging_data_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,qBAAa,mBAAmB;;gBAUlB,KAAK,EAAE,iBAAiB;IAS9B,gCAAgC,CAAC,cAAc,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,mCAAmC,CAAC,cAAc,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1F,mCAAmC,CAAC,iBAAiB,EAAE,EAAE,EAAE;IAI3D,gCAAgC,CAAC,iBAAiB,EAAE,EAAE,EAAE;IAQ9D,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzD,kBAAkB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5D,OAAO;CAKd"}
+{"version":3,"file":"tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/tagging_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE9E,qBAAa,mBAAmB;;IAS9B,YAAY,KAAK,EAAE,iBAAiB,EAOnC;IAED;;;;;OAKG;IACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,mBAM3C;IAED;;;;;OAKG;IACH,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,mBAM9C;IAaD;;;;OAIG;IACG,0BAA0B,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEjG;IAED;;;;;OAKG;IACH,6BAA6B,CAAC,OAAO,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAErG;IAED,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjC;IAEK,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D;IAEK,kBAAkB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAElD;IAEK,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAQjE;IAEK,OAAO,oBAIZ;CACF"}

package/dest/storage/tagging_data_provider/tagging_data_provider.js

@@ -3,41 +3,65 @@ import { AztecAddress } from '@aztec/stdlib/aztec-address';
 export class TaggingDataProvider {
     #store;
     #addressBook;
-    // Stores the last index used for each tagging secret, taking direction into account
-    // This is necessary to avoid reusing the same index for the same secret, which happens if
-    // sender and recipient are the same
-    #taggingSecretIndexesForSenders;
-    #taggingSecretIndexesForRecipients;
+    // Stores the last used index for each directional app tagging secret. Taking into account whether we are
+    // requesting the index as a sender or as a recipient because the sender and recipient can be in the same PXE.
+    #lastUsedIndexesAsSenders;
+    #lastUsedIndexesAsRecipients;
     constructor(store){
         this.#store = store;
         this.#addressBook = this.#store.openMap('address_book');
-        this.#taggingSecretIndexesForSenders = this.#store.openMap('tagging_secret_indexes_for_senders');
-        this.#taggingSecretIndexesForRecipients = this.#store.openMap('tagging_secret_indexes_for_recipients');
+        this.#lastUsedIndexesAsSenders = this.#store.openMap('last_used_indexes_as_senders');
+        this.#lastUsedIndexesAsRecipients = this.#store.openMap('last_used_indexes_as_recipients');
     }
-    async setTaggingSecretsIndexesAsSender(indexedSecrets) {
-        await this.#setTaggingSecretsIndexes(indexedSecrets, this.#taggingSecretIndexesForSenders);
+    /**
+   * Sets the last used indexes when sending a log.
+   * @param preTags - The pre tags containing the directional app tagging secrets and the indexes that are to be
+   * updated in the db.
+   * @throws If any two pre tags contain the same directional app tagging secret
+   */ setLastUsedIndexesAsSender(preTags) {
+        this.#assertUniqueSecrets(preTags, 'sender');
+        return Promise.all(preTags.map(({ secret, index })=>this.#lastUsedIndexesAsSenders.set(secret.toString(), index)));
     }
-    async setTaggingSecretsIndexesAsRecipient(indexedSecrets) {
-        await this.#setTaggingSecretsIndexes(indexedSecrets, this.#taggingSecretIndexesForRecipients);
+    /**
+   * Sets the last used indexes when looking for logs.
+   * @param preTags - The pre tags containing the directional app tagging secrets and the indexes that are to be
+   * updated in the db.
+   * @throws If any two pre tags contain the same directional app tagging secret
+   */ setLastUsedIndexesAsRecipient(preTags) {
+        this.#assertUniqueSecrets(preTags, 'recipient');
+        return Promise.all(preTags.map(({ secret, index })=>this.#lastUsedIndexesAsRecipients.set(secret.toString(), index)));
     }
-    async #setTaggingSecretsIndexes(indexedSecrets, storageMap) {
-        await Promise.all(indexedSecrets.map((indexedSecret)=>storageMap.set(indexedSecret.appTaggingSecret.toString(), indexedSecret.index)));
-    }
-    async getTaggingSecretsIndexesAsRecipient(appTaggingSecrets) {
-        return await this.#getTaggingSecretsIndexes(appTaggingSecrets, this.#taggingSecretIndexesForRecipients);
+    // It should never happen that we would receive any two pre tags on the input containing the same directional app
+    // tagging secret as everywhere we always just apply the largest index. Hence this check is a good way to catch
+    // bugs.
+    #assertUniqueSecrets(preTags, role) {
+        const secretStrings = preTags.map(({ secret })=>secret.toString());
+        const uniqueSecrets = new Set(secretStrings);
+        if (uniqueSecrets.size !== secretStrings.length) {
+            throw new Error(`Duplicate secrets found when setting last used indexes as ${role}`);
+        }
     }
-    async getTaggingSecretsIndexesAsSender(appTaggingSecrets) {
-        return await this.#getTaggingSecretsIndexes(appTaggingSecrets, this.#taggingSecretIndexesForSenders);
+    /**
+   * Returns the last used index when sending a log with a given secret.
+   * @param secret - The directional app tagging secret.
+   * @returns The last used index for the given directional app tagging secret, or undefined if not found.
+   */ async getLastUsedIndexesAsSender(secret) {
+        return await this.#lastUsedIndexesAsSenders.getAsync(secret.toString());
     }
-    #getTaggingSecretsIndexes(appTaggingSecrets, storageMap) {
-        return Promise.all(appTaggingSecrets.map(async (secret)=>await storageMap.getAsync(`${secret.toString()}`) ?? 0));
+    /**
+   * Returns the last used indexes when looking for logs as a recipient.
+   * @param secrets - The directional app tagging secrets to obtain the indexes for.
+   * @returns The last used indexes for the given directional app tagging secrets, or undefined if have never yet found
+   * a log for a given secret.
+   */ getLastUsedIndexesAsRecipient(secrets) {
+        return Promise.all(secrets.map((secret)=>this.#lastUsedIndexesAsRecipients.getAsync(secret.toString())));
     }
     resetNoteSyncData() {
         return this.#store.transactionAsync(async ()=>{
-            const recipients = await toArray(this.#taggingSecretIndexesForRecipients.keysAsync());
-            await Promise.all(recipients.map((recipient)=>this.#taggingSecretIndexesForRecipients.delete(recipient)));
-            const senders = await toArray(this.#taggingSecretIndexesForSenders.keysAsync());
-            await Promise.all(senders.map((sender)=>this.#taggingSecretIndexesForSenders.delete(sender)));
+            const keysForSenders = await toArray(this.#lastUsedIndexesAsSenders.keysAsync());
+            await Promise.all(keysForSenders.map((secret)=>this.#lastUsedIndexesAsSenders.delete(secret)));
+            const keysForRecipients = await toArray(this.#lastUsedIndexesAsRecipients.keysAsync());
+            await Promise.all(keysForRecipients.map((secret)=>this.#lastUsedIndexesAsRecipients.delete(secret)));
         });
     }
     async addSenderAddress(address) {

package/dest/synchronizer/index.d.ts

@@ -1,2 +1,2 @@
 export * from './synchronizer.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zeW5jaHJvbml6ZXIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxtQkFBbUIsQ0FBQyJ9

package/dest/synchronizer/synchronizer.d.ts

@@ -1,5 +1,5 @@
 import { type Logger } from '@aztec/foundation/log';
-import type { L2TipsStore } from '@aztec/kv-store/stores';
+import type { L2TipsKVStore } from '@aztec/kv-store/stores';
 import { L2BlockStream, type L2BlockStreamEvent, type L2BlockStreamEventHandler } from '@aztec/stdlib/block';
 import type { AztecNode } from '@aztec/stdlib/interfaces/client';
 import type { PXEConfig } from '../config/index.js';
@@ -7,10 +7,9 @@ import type { NoteDataProvider } from '../storage/note_data_provider/note_data_p
 import type { SyncDataProvider } from '../storage/sync_data_provider/sync_data_provider.js';
 import type { TaggingDataProvider } from '../storage/tagging_data_provider/tagging_data_provider.js';
 /**
- * The Synchronizer class manages the synchronization with the aztec node, allowing PXE to retrieve the
- * latest block header and handle reorgs.
- * It provides methods to trigger a sync and get the block number we are syncec to
- * details, and fetch transactions by hash.
+ * The Synchronizer class orchestrates synchronization between the PXE and Aztec node, maintaining an up-to-date
+ * view of the L2 chain state. It handles block header retrieval, chain reorganizations, and provides an interface
+ * for querying sync status.
  */
 export declare class Synchronizer implements L2BlockStreamEventHandler {
     private node;
@@ -18,20 +17,19 @@ export declare class Synchronizer implements L2BlockStreamEventHandler {
     private noteDataProvider;
     private taggingDataProvider;
     private l2TipsStore;
-    private initialSyncBlockNumber;
     private log;
     private isSyncing;
     protected readonly blockStream: L2BlockStream;
-    constructor(node: AztecNode, syncDataProvider: SyncDataProvider, noteDataProvider: NoteDataProvider, taggingDataProvider: TaggingDataProvider, l2TipsStore: L2TipsStore, config?: Partial<Pick<PXEConfig, 'l2StartingBlock'>>, loggerOrSuffix?: string | Logger);
-    protected createBlockStream(config: Partial<Pick<PXEConfig, 'l2StartingBlock'>>): L2BlockStream;
+    constructor(node: AztecNode, syncDataProvider: SyncDataProvider, noteDataProvider: NoteDataProvider, taggingDataProvider: TaggingDataProvider, l2TipsStore: L2TipsKVStore, config?: Partial<Pick<PXEConfig, 'l2BlockBatchSize'>>, loggerOrSuffix?: string | Logger);
+    protected createBlockStream(config: Partial<Pick<PXEConfig, 'l2BlockBatchSize'>>): L2BlockStream;
     /** Handle events emitted by the block stream. */
     handleBlockStreamEvent(event: L2BlockStreamEvent): Promise<void>;
     /**
-     * Syncs PXE and the node by dowloading the metadata of the latest blocks, allowing simulations to use
+     * Syncs PXE and the node by downloading the metadata of the latest blocks, allowing simulations to use
      * recent data (e.g. notes), and handling any reorgs that might have occurred.
      */
     sync(): Promise<void>;
     private doSync;
     getSynchedBlockNumber(): Promise<number>;
 }
-//# sourceMappingURL=synchronizer.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luY2hyb25pemVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc3luY2hyb25pemVyL3N5bmNocm9uaXplci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sdUJBQXVCLENBQUM7QUFDbEUsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDNUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxLQUFLLGtCQUFrQixFQUFFLEtBQUsseUJBQXlCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM3RyxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUVqRSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHFEQUFxRCxDQUFDO0FBQzVGLE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0scURBQXFELENBQUM7QUFDNUYsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwyREFBMkQsQ0FBQztBQUVyRzs7OztHQUlHO0FBQ0gscUJBQWEsWUFBYSxZQUFXLHlCQUF5QjtJQU0xRCxPQUFPLENBQUMsSUFBSTtJQUNaLE9BQU8sQ0FBQyxnQkFBZ0I7SUFDeEIsT0FBTyxDQUFDLGdCQUFnQjtJQUN4QixPQUFPLENBQUMsbUJBQW1CO0lBQzNCLE9BQU8sQ0FBQyxXQUFXO0lBVHJCLE9BQU8sQ0FBQyxHQUFHLENBQVM7SUFDcEIsT0FBTyxDQUFDLFNBQVMsQ0FBNEI7SUFDN0MsU0FBUyxDQUFDLFFBQVEsQ0FBQyxXQUFXLEVBQUUsYUFBYSxDQUFDO0lBRTlDLFlBQ1UsSUFBSSxFQUFFLFNBQVMsRUFDZixnQkFBZ0IsRUFBRSxnQkFBZ0IsRUFDbEMsZ0JBQWdCLEVBQUUsZ0JBQWdCLEVBQ2xDLG1CQUFtQixFQUFFLG1CQUFtQixFQUN4QyxXQUFXLEVBQUUsYUFBYSxFQUNsQyxNQUFNLEdBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsa0JBQWtCLENBQUMsQ0FBTSxFQUN6RCxjQUFjLENBQUMsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQU9qQztJQUVELFNBQVMsQ0FBQyxpQkFBaUIsQ0FBQyxNQUFNLEVBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsa0JBQWtCLENBQUMsQ0FBQyxpQkFPL0U7SUFFRCxpREFBaUQ7SUFDcEMsc0JBQXNCLENBQUMsS0FBSyxFQUFFLGtCQUFrQixHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FnQzVFO0lBRUQ7OztPQUdHO0lBQ1UsSUFBSSxrQkFlaEI7WUFFYSxNQUFNO0lBZWIscUJBQXFCLG9CQUUzQjtDQUNGIn0=

package/dest/synchronizer/synchronizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synchronizer.d.ts","sourceRoot":"","sources":["../../src/synchronizer/synchronizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AAErG;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,yBAAyB;IAO1D,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,WAAW;IAVrB,OAAO,CAAC,sBAAsB,CAA4B;IAC1D,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAA4B;IAC7C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;gBAGpC,IAAI,EAAE,SAAS,EACf,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,WAAW,EAChC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAM,EACxD,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM;IASlC,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAM/E,iDAAiD;IACpC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7E;;;OAGG;IACU,IAAI;YAiBH,MAAM;IAeP,qBAAqB;CAGnC"}
+{"version":3,"file":"synchronizer.d.ts","sourceRoot":"","sources":["../../src/synchronizer/synchronizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC7G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2DAA2D,CAAC;AAErG;;;;GAIG;AACH,qBAAa,YAAa,YAAW,yBAAyB;IAM1D,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,WAAW;IATrB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,SAAS,CAA4B;IAC7C,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IAE9C,YACU,IAAI,EAAE,SAAS,EACf,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,mBAAmB,EACxC,WAAW,EAAE,aAAa,EAClC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAM,EACzD,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAOjC;IAED,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC,iBAO/E;IAED,iDAAiD;IACpC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC5E;IAED;;;OAGG;IACU,IAAI,kBAehB;YAEa,MAAM;IAeb,qBAAqB,oBAE3B;CACF"}

package/dest/synchronizer/synchronizer.js

@@ -1,18 +1,15 @@
-import { INITIAL_L2_BLOCK_NUM } from '@aztec/constants';
 import { createLogger } from '@aztec/foundation/log';
 import { L2BlockStream } from '@aztec/stdlib/block';
 /**
- * The Synchronizer class manages the synchronization with the aztec node, allowing PXE to retrieve the
- * latest block header and handle reorgs.
- * It provides methods to trigger a sync and get the block number we are syncec to
- * details, and fetch transactions by hash.
+ * The Synchronizer class orchestrates synchronization between the PXE and Aztec node, maintaining an up-to-date
+ * view of the L2 chain state. It handles block header retrieval, chain reorganizations, and provides an interface
+ * for querying sync status.
  */ export class Synchronizer {
     node;
     syncDataProvider;
     noteDataProvider;
     taggingDataProvider;
     l2TipsStore;
-    initialSyncBlockNumber;
     log;
     isSyncing;
     blockStream;
@@ -22,13 +19,15 @@ import { L2BlockStream } from '@aztec/stdlib/block';
         this.noteDataProvider = noteDataProvider;
         this.taggingDataProvider = taggingDataProvider;
         this.l2TipsStore = l2TipsStore;
-        this.initialSyncBlockNumber = INITIAL_L2_BLOCK_NUM - 1;
         this.log = !loggerOrSuffix || typeof loggerOrSuffix === 'string' ? createLogger(loggerOrSuffix ? `pxe:synchronizer:${loggerOrSuffix}` : `pxe:synchronizer`) : loggerOrSuffix;
         this.blockStream = this.createBlockStream(config);
     }
     createBlockStream(config) {
         return new L2BlockStream(this.node, this.l2TipsStore, this, createLogger('pxe:block_stream'), {
-            startingBlock: config.l2StartingBlock
+            batchSize: config.l2BlockBatchSize,
+            // Skipping finalized blocks makes us sync much faster - we only need to download blocks other than the latest one
+            // in order to detect reorgs, and there can be no reorgs on finalized block, making this safe.
+            skipFinalized: true
         });
     }
     /** Handle events emitted by the block stream. */ async handleBlockStreamEvent(event) {
@@ -36,29 +35,28 @@ import { L2BlockStream } from '@aztec/stdlib/block';
         switch(event.type){
             case 'blocks-added':
                 {
-                    const lastBlock = event.blocks.at(-1);
+                    const lastBlock = event.blocks.at(-1).block;
                     this.log.verbose(`Updated pxe last block to ${lastBlock.number}`, {
                         blockHash: lastBlock.hash(),
                         archive: lastBlock.archive.root.toString(),
                         header: lastBlock.header.toInspect()
                     });
-                    await this.syncDataProvider.setHeader(lastBlock.header);
+                    await this.syncDataProvider.setHeader(lastBlock.getBlockHeader());
                     break;
                 }
             case 'chain-pruned':
                 {
-                    this.log.warn(`Pruning data after block ${event.blockNumber} due to reorg`);
+                    this.log.warn(`Pruning data after block ${event.block.number} due to reorg`);
                     // We first unnullify and then remove so that unnullified notes that were created after the block number end up deleted.
                     const lastSynchedBlockNumber = await this.syncDataProvider.getBlockNumber();
-                    await this.noteDataProvider.unnullifyNotesAfter(event.blockNumber, lastSynchedBlockNumber);
-                    await this.noteDataProvider.removeNotesAfter(event.blockNumber);
+                    await this.noteDataProvider.rollbackNotesAndNullifiers(event.block.number, lastSynchedBlockNumber);
                     // Remove all note tagging indexes to force a full resync. This is suboptimal, but unless we track the
                     // block number in which each index is used it's all we can do.
                     await this.taggingDataProvider.resetNoteSyncData();
                     // Update the header to the last block.
-                    const newHeader = await this.node.getBlockHeader(event.blockNumber);
+                    const newHeader = await this.node.getBlockHeader(event.block.number);
                     if (!newHeader) {
-                        this.log.error(`Block header not found for block number ${event.blockNumber} during chain prune`);
+                        this.log.error(`Block header not found for block number ${event.block.number} during chain prune`);
                     } else {
                         await this.syncDataProvider.setHeader(newHeader);
                     }
@@ -67,7 +65,7 @@ import { L2BlockStream } from '@aztec/stdlib/block';
         }
     }
     /**
-   * Syncs PXE and the node by dowloading the metadata of the latest blocks, allowing simulations to use
+   * Syncs PXE and the node by downloading the metadata of the latest blocks, allowing simulations to use
    * recent data (e.g. notes), and handling any reorgs that might have occurred.
    */ async sync() {
         if (this.isSyncing !== undefined) {
@@ -88,7 +86,7 @@ import { L2BlockStream } from '@aztec/stdlib/block';
         let currentHeader;
         try {
             currentHeader = await this.syncDataProvider.getBlockHeader();
-        } catch (e) {
+        } catch  {
             this.log.debug('Header is not set, requesting from the node');
         }
         if (!currentHeader) {
@@ -97,7 +95,7 @@ import { L2BlockStream } from '@aztec/stdlib/block';
         }
         await this.blockStream.sync();
     }
-    async getSynchedBlockNumber() {
-        return await this.syncDataProvider.getBlockNumber() ?? this.initialSyncBlockNumber;
+    getSynchedBlockNumber() {
+        return this.syncDataProvider.getBlockNumber();
     }
 }

package/dest/tagging/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const WINDOW_HALF_SIZE = 10;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGFnZ2luZy9jb25zdGFudHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsZUFBTyxNQUFNLGdCQUFnQixLQUFLLENBQUMifQ==

package/dest/tagging/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/tagging/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,gBAAgB,KAAK,CAAC"}

package/dest/tagging/constants.js

@@ -0,0 +1,2 @@
+// Half the size of the window we slide over the tagging indexes.
+export const WINDOW_HALF_SIZE = 10;

package/dest/tagging/index.d.ts

@@ -0,0 +1,7 @@
+export * from './tag.js';
+export * from './constants.js';
+export * from './siloed_tag.js';
+export * from './utils.js';
+export { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
+export { type PreTag } from '@aztec/stdlib/logs';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsVUFBVSxDQUFDO0FBQ3pCLGNBQWMsZ0JBQWdCLENBQUM7QUFDL0IsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLFlBQVksQ0FBQztBQUMzQixPQUFPLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNqRSxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQyJ9

package/dest/tagging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tagging/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC"}

package/dest/tagging/index.js

@@ -0,0 +1,5 @@
+export * from './tag.js';
+export * from './constants.js';
+export * from './siloed_tag.js';
+export * from './utils.js';
+export { DirectionalAppTaggingSecret } from '@aztec/stdlib/logs';

package/dest/tagging/siloed_tag.d.ts

@@ -0,0 +1,14 @@
+import type { Fr } from '@aztec/foundation/fields';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+import type { Tag } from './tag.js';
+/**
+ * Represents a tag used in private log as it "appears on the chain" - that is the tag is siloed with a contract
+ * address that emitted the log.
+ */
+export declare class SiloedTag {
+    readonly value: Fr;
+    private constructor();
+    static compute(tag: Tag, app: AztecAddress): Promise<SiloedTag>;
+    toString(): string;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2lsb2VkX3RhZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RhZ2dpbmcvc2lsb2VkX3RhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNuRCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVoRSxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFFcEM7OztHQUdHO0FBQ0gscUJBQWEsU0FBUzthQUNnQixLQUFLLEVBQUUsRUFBRTtJQUE3QyxPQUFPLGVBQTBDO0lBRWpELE9BQWEsT0FBTyxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLFlBQVksR0FBRyxPQUFPLENBQUMsU0FBUyxDQUFDLENBR3BFO0lBRUQsUUFBUSxJQUFJLE1BQU0sQ0FFakI7Q0FDRiJ9

package/dest/tagging/siloed_tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siloed_tag.d.ts","sourceRoot":"","sources":["../../src/tagging/siloed_tag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;;GAGG;AACH,qBAAa,SAAS;aACgB,KAAK,EAAE,EAAE;IAA7C,OAAO,eAA0C;IAEjD,OAAa,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAGpE;IAED,QAAQ,IAAI,MAAM,CAEjB;CACF"}

package/dest/tagging/siloed_tag.js

@@ -0,0 +1,20 @@
+import { poseidon2Hash } from '@aztec/foundation/crypto';
+/**
+ * Represents a tag used in private log as it "appears on the chain" - that is the tag is siloed with a contract
+ * address that emitted the log.
+ */ export class SiloedTag {
+    value;
+    constructor(value){
+        this.value = value;
+    }
+    static async compute(tag, app) {
+        const siloedTag = await poseidon2Hash([
+            app,
+            tag.value
+        ]);
+        return new SiloedTag(siloedTag);
+    }
+    toString() {
+        return this.value.toString();
+    }
+}

package/dest/tagging/tag.d.ts

@@ -0,0 +1,12 @@
+import type { Fr } from '@aztec/foundation/fields';
+import type { PreTag } from '@aztec/stdlib/logs';
+/**
+ * Represents a tag of a private log. This is not the tag that "appears" on the chain as this tag is first siloed
+ * with a contract address by kernels before being included in the final log.
+ */
+export declare class Tag {
+    readonly value: Fr;
+    private constructor();
+    static compute(preTag: PreTag): Promise<Tag>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGFnZ2luZy90YWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFakQ7OztHQUdHO0FBQ0gscUJBQWEsR0FBRzthQUNzQixLQUFLLEVBQUUsRUFBRTtJQUE3QyxPQUFPLGVBQTBDO0lBRWpELE9BQWEsT0FBTyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUdqRDtDQUNGIn0=

package/dest/tagging/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/tagging/tag.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,GAAG;aACsB,KAAK,EAAE,EAAE;IAA7C,OAAO,eAA0C;IAEjD,OAAa,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAGjD;CACF"}

package/dest/tagging/tag.js

@@ -0,0 +1,17 @@
+import { poseidon2Hash } from '@aztec/foundation/crypto';
+/**
+ * Represents a tag of a private log. This is not the tag that "appears" on the chain as this tag is first siloed
+ * with a contract address by kernels before being included in the final log.
+ */ export class Tag {
+    value;
+    constructor(value){
+        this.value = value;
+    }
+    static async compute(preTag) {
+        const tag = await poseidon2Hash([
+            preTag.secret.value,
+            preTag.index
+        ]);
+        return new Tag(tag);
+    }
+}

package/dest/tagging/utils.d.ts

@@ -0,0 +1,18 @@
+import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
+export declare function getPreTagsForTheWindow(secretsAndWindows: {
+    secret: DirectionalAppTaggingSecret;
+    leftMostIndex: number;
+    rightMostIndex: number;
+}[]): PreTag[];
+/**
+ * Creates a map from directional app tagging secret to initial index.
+ * @param preTags - The pre tags to get the initial indexes map from.
+ * @returns The map from directional app tagging secret to initial index.
+ */
+export declare function getInitialIndexesMap(preTags: {
+    secret: DirectionalAppTaggingSecret;
+    index: number | undefined;
+}[]): {
+    [k: string]: number;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YWdnaW5nL3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRzlFLHdCQUFnQixzQkFBc0IsQ0FDcEMsaUJBQWlCLEVBQUU7SUFBRSxNQUFNLEVBQUUsMkJBQTJCLENBQUM7SUFBQyxhQUFhLEVBQUUsTUFBTSxDQUFDO0lBQUMsY0FBYyxFQUFFLE1BQU0sQ0FBQTtDQUFFLEVBQUUsR0FDMUcsTUFBTSxFQUFFLENBUVY7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLG9CQUFvQixDQUFDLE9BQU8sRUFBRTtJQUFFLE1BQU0sRUFBRSwyQkFBMkIsQ0FBQztJQUFDLEtBQUssRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFBO0NBQUUsRUFBRSxHQUFHO0lBQ25ILENBQUMsQ0FBQyxFQUFFLE1BQU0sR0FBRyxNQUFNLENBQUM7Q0FDckIsQ0FRQSJ9

package/dest/tagging/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tagging/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG9E,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE;IAAE,MAAM,EAAE,2BAA2B,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAAE,GAC1G,MAAM,EAAE,CAQV;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,2BAA2B,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,GAAG;IACnH,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB,CAQA"}

package/dest/tagging/utils.js

@@ -0,0 +1,24 @@
+// TODO(benesjan): Make this return tags instead - this will moves some complexity from syncTaggedLogs
+export function getPreTagsForTheWindow(secretsAndWindows) {
+    const secrets = [];
+    for (const secretAndWindow of secretsAndWindows){
+        for(let i = secretAndWindow.leftMostIndex; i <= secretAndWindow.rightMostIndex; i++){
+            secrets.push({
+                secret: secretAndWindow.secret,
+                index: i
+            });
+        }
+    }
+    return secrets;
+}
+/**
+ * Creates a map from directional app tagging secret to initial index.
+ * @param preTags - The pre tags to get the initial indexes map from.
+ * @returns The map from directional app tagging secret to initial index.
+ */ export function getInitialIndexesMap(preTags) {
+    const initialIndexes = {};
+    for (const preTag of preTags){
+        initialIndexes[preTag.secret.toString()] = preTag.index ?? 0;
+    }
+    return initialIndexes;
+}

package/package.json

@@ -1,24 +1,22 @@
 {
   "name": "@aztec/pxe",
-  "version": "0.0.0-test.1",
+  "version": "0.0.1-commit.5476d83",
   "type": "module",
   "exports": {
     "./server": "./dest/entrypoints/server/index.js",
     "./client/lazy": "./dest/entrypoints/client/lazy/index.js",
     "./client/bundle": "./dest/entrypoints/client/bundle/index.js",
-    "./config": "./dest/config/index.js",
-    "./testing": "./dest/test/pxe_test_suite.js"
+    "./simulator": "./dest/contract_function_simulator/index.js",
+    "./config": "./dest/config/index.js"
   },
   "bin": "./dest/bin/index.js",
   "scripts": {
-    "build": "yarn clean && yarn generate && tsc -b",
-    "build:dev": "tsc -b --watch",
+    "build": "yarn clean && yarn generate && tsgo -b",
+    "build:dev": "tsgo -b --watch",
     "clean": "rm -rf ./dest .tsbuildinfo ./src/config/package_info.ts",
-    "formatting": "run -T prettier --check ./src && run -T eslint ./src",
-    "formatting:fix": "run -T eslint --fix ./src && run -T prettier -w ./src",
     "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}",
-    "start": "LOG_LEVEL=${LOG_LEVEL:-debug} && node ./dest/bin/index.js",
-    "generate": "node ./scripts/generate_package_info.js"
+    "generate": "node ./scripts/generate_package_info.js",
+    "check_oracle_version": "node ./dest/bin/check_oracle_version.js"
   },
   "inherits": [
     "../package.common.json",
@@ -56,42 +54,47 @@
     "testTimeout": 120000,
     "setupFiles": [
       "../../foundation/src/jest/setup.mjs"
+    ],
+    "testEnvironment": "../../foundation/src/jest/env.mjs",
+    "setupFilesAfterEnv": [
+      "../../foundation/src/jest/setupAfterEnv.mjs"
     ]
   },
   "dependencies": {
-    "@aztec/bb-prover": "0.0.0-test.1",
-    "@aztec/bb.js": "0.0.0-test.1",
-    "@aztec/builder": "0.0.0-test.1",
-    "@aztec/constants": "0.0.0-test.1",
-    "@aztec/ethereum": "0.0.0-test.1",
-    "@aztec/foundation": "0.0.0-test.1",
-    "@aztec/key-store": "0.0.0-test.1",
-    "@aztec/kv-store": "0.0.0-test.1",
-    "@aztec/noir-protocol-circuits-types": "0.0.0-test.1",
-    "@aztec/protocol-contracts": "0.0.0-test.1",
-    "@aztec/simulator": "0.0.0-test.1",
-    "@aztec/stdlib": "0.0.0-test.1",
-    "@msgpack/msgpack": "^3.0.0-beta2",
-    "koa": "^2.14.2",
-    "koa-router": "^12.0.0",
+    "@aztec/bb-prover": "0.0.1-commit.5476d83",
+    "@aztec/bb.js": "0.0.1-commit.5476d83",
+    "@aztec/builder": "0.0.1-commit.5476d83",
+    "@aztec/constants": "0.0.1-commit.5476d83",
+    "@aztec/ethereum": "0.0.1-commit.5476d83",
+    "@aztec/foundation": "0.0.1-commit.5476d83",
+    "@aztec/key-store": "0.0.1-commit.5476d83",
+    "@aztec/kv-store": "0.0.1-commit.5476d83",
+    "@aztec/noir-protocol-circuits-types": "0.0.1-commit.5476d83",
+    "@aztec/noir-types": "0.0.1-commit.5476d83",
+    "@aztec/protocol-contracts": "0.0.1-commit.5476d83",
+    "@aztec/simulator": "0.0.1-commit.5476d83",
+    "@aztec/stdlib": "0.0.1-commit.5476d83",
+    "koa": "^2.16.1",
+    "koa-router": "^13.1.1",
     "lodash.omit": "^4.5.0",
     "sha3": "^2.1.4",
     "tslib": "^2.4.0",
-    "viem": "2.22.8",
-    "@aztec/noir-types": "0.0.0-test.1"
+    "viem": "npm:@aztec/viem@2.38.2"
   },
   "devDependencies": {
-    "@aztec/noir-contracts.js": "0.0.0-test.1",
-    "@jest/globals": "^29.5.0",
-    "@types/jest": "^29.5.0",
+    "@aztec/merkle-tree": "0.0.1-commit.5476d83",
+    "@aztec/noir-test-contracts.js": "0.0.1-commit.5476d83",
+    "@jest/globals": "^30.0.0",
+    "@types/jest": "^30.0.0",
     "@types/lodash.omit": "^4.5.7",
     "@types/lodash.times": "^4.3.9",
-    "@types/node": "^18.7.23",
-    "jest": "^29.5.0",
-    "jest-mock-extended": "^3.0.3",
+    "@types/node": "^22.15.17",
+    "@typescript/native-preview": "7.0.0-dev.20251126.1",
+    "jest": "^30.0.0",
+    "jest-mock-extended": "^4.0.0",
     "lodash.times": "^4.3.2",
     "ts-node": "^10.9.1",
-    "typescript": "^5.0.4"
+    "typescript": "^5.3.3"
   },
   "files": [
     "dest",
@@ -100,6 +103,6 @@
   ],
   "types": "./dest/index.d.ts",
   "engines": {
-    "node": ">=18"
+    "node": ">=20.10"
   }
 }

package/src/bin/check_oracle_version.ts

@@ -0,0 +1,50 @@
+import { keccak256String } from '@aztec/foundation/crypto';
+
+import { Oracle } from '../contract_function_simulator/oracle/oracle.js';
+import { ORACLE_INTERFACE_HASH } from '../oracle_version.js';
+
+/**
+ * Verifies that the Oracle interface matches the expected interface hash.
+ *
+ * The Oracle interface needs to be versioned to ensure compatibility between Aztec.nr and PXE. This function computes
+ * a hash of the Oracle interface and compares it against a known hash. If they don't match, it means the interface has
+ * changed and the ORACLE_VERSION constant needs to be incremented and the ORACLE_INTERFACE_HASH constant needs to be
+ * updated.
+ *
+ * TODO(#16581): The following only takes into consideration changes to the oracles defined in Oracle.ts and omits TXE
+ * oracles. Ensure this checks TXE oracles as well. This hasn't been implemented yet since we don't have a clean TXE
+ * oracle interface like we do in PXE (i.e., there is no single Oracle class that contains only the oracles).
+ */
+function assertOracleInterfaceMatches(): void {
+  const excludedProps = [
+    'handler',
+    'constructor',
+    'toACIRCallback',
+    'handlerAsMisc',
+    'handlerAsUtility',
+    'handlerAsPrivate',
+  ] as const;
+
+  // Create a hashable representation of the oracle interface by concatenating its method names. Return values are
+  // excluded from the hash calculation since they are typically arrays of fields and I didn't manage to reliably
+  // stringify them.
+  // TODO(#16581): we're only checking the functions implemented by the Oracle object, which is really an ACVM
+  // translator, akin to TXE's RPC translator. This is correct in that it is ultimately the foreign interface that
+  // matters, but incorrect in that it does not take into consideration TXE's extended interface. An improvement would
+  // be to check RPCTranslator from TXE, though that still seems a bit fragile.
+  const oracleInterfaceMethodNames = Object.getOwnPropertyNames(Oracle.prototype)
+    .filter(name => !excludedProps.includes(name as (typeof excludedProps)[number]))
+    .sort()
+    .join('');
+
+  // We use keccak256 here just because we already have it in the dependencies.
+  const oracleInterfaceHash = keccak256String(oracleInterfaceMethodNames);
+  if (oracleInterfaceHash !== ORACLE_INTERFACE_HASH) {
+    // This check exists only to notify you when you need to update the ORACLE_VERSION constant.
+    throw new Error(
+      `The Oracle interface has changed, which implies a breaking change in the aztec.nr/PXE oracle interface. Update ORACLE_INTERFACE_HASH to ${oracleInterfaceHash} and bump ORACLE_VERSION in pxe/src/oracle_version.ts.`,
+    );
+  }
+}
+
+assertOracleInterfaceMatches();