@aztec/pxe 0.0.1-commit.03f7ef2 → 0.0.1-commit.04852196a

package/dest/storage/note_data_provider/note_data_provider.js

@@ -1,322 +0,0 @@
-import { toBufferBE } from '@aztec/foundation/bigint-buffer';
-import { toArray } from '@aztec/foundation/iterable';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { NoteStatus } from '@aztec/stdlib/note';
-import { NoteDao } from '@aztec/stdlib/note';
-/**
- * NoteDataProvider manages the storage and retrieval of notes.
- *
- * Notes can be active or nullified. This class processes new notes, nullifications,
- * and performs rollback handling in the case of a reorg.
- **/ export class NoteDataProvider {
-    #store;
-    #notes;
-    #nullifiedNotes;
-    #nullifierToNoteId;
-    #nullifiersByBlockNumber;
-    #nullifiedNotesToScope;
-    #nullifiedNotesByContract;
-    #nullifiedNotesByStorageSlot;
-    #nullifiedNotesByNullifier;
-    #scopes;
-    #notesToScope;
-    #notesByContractAndScope;
-    #notesByStorageSlotAndScope;
-    constructor(store){
-        this.#store = store;
-        this.#notes = store.openMap('notes');
-        this.#nullifiedNotes = store.openMap('nullified_notes');
-        this.#nullifierToNoteId = store.openMap('nullifier_to_note');
-        this.#nullifiersByBlockNumber = store.openMultiMap('nullifier_to_block_number');
-        this.#nullifiedNotesToScope = store.openMultiMap('nullified_notes_to_scope');
-        this.#nullifiedNotesByContract = store.openMultiMap('nullified_notes_by_contract');
-        this.#nullifiedNotesByStorageSlot = store.openMultiMap('nullified_notes_by_storage_slot');
-        this.#nullifiedNotesByNullifier = store.openMap('nullified_notes_by_nullifier');
-        this.#scopes = store.openMap('scopes');
-        this.#notesToScope = store.openMultiMap('notes_to_scope');
-        this.#notesByContractAndScope = new Map();
-        this.#notesByStorageSlotAndScope = new Map();
-    }
-    /**
-   * Creates and initializes a new NoteDataProvider instance.
-   *
-   * This factory method creates a NoteDataProvider and restores any existing
-   * scope-specific indexes from the database.
-   *
-   * @param store - The key-value store to use for persistence
-   * @returns Promise resolving to a fully initialized NoteDataProvider instance
-   */ static async create(store) {
-        const pxeDB = new NoteDataProvider(store);
-        for await (const scope of pxeDB.#scopes.keysAsync()){
-            pxeDB.#notesByContractAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_contract`));
-            pxeDB.#notesByStorageSlotAndScope.set(scope, store.openMultiMap(`${scope}:notes_by_storage_slot`));
-        }
-        return pxeDB;
-    }
-    /**
-   * Adds a new scope to the note data provider.
-   *
-   * Scopes provide privacy isolation by creating separate indexes for each user.
-   * Each scope gets its own set of indexes for efficient note retrieval by various criteria.
-   *
-   * @param scope - The AztecAddress representing the scope/user to add
-   * @returns Promise resolving to true if scope was added, false if it already existed
-   */ async addScope(scope) {
-        const scopeString = scope.toString();
-        if (await this.#scopes.hasAsync(scopeString)) {
-            return false;
-        }
-        await this.#scopes.set(scopeString, true);
-        this.#notesByContractAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_contract`));
-        this.#notesByStorageSlotAndScope.set(scopeString, this.#store.openMultiMap(`${scopeString}:notes_by_storage_slot`));
-        return true;
-    }
-    /**
-   * Adds multiple notes to the data provider under the specified scope.
-   *
-   * Notes are stored using their index from the notes hash tree as the key, which provides
-   * uniqueness and maintains creation order. Each note is indexed by multiple criteria
-   * for efficient retrieval.
-   *
-   * @param notes - Notes to store
-   * @param scope - The scope (user/account) under which to store the notes
-   */ addNotes(notes, scope) {
-        return this.#store.transactionAsync(async ()=>{
-            if (!await this.#scopes.hasAsync(scope.toString())) {
-                await this.addScope(scope);
-            }
-            for (const dao of notes){
-                const noteIndex = toBufferBE(dao.index, 32).toString('hex');
-                await this.#notes.set(noteIndex, dao.toBuffer());
-                await this.#notesToScope.set(noteIndex, scope.toString());
-                await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
-                await this.#notesByContractAndScope.get(scope.toString()).set(dao.contractAddress.toString(), noteIndex);
-                await this.#notesByStorageSlotAndScope.get(scope.toString()).set(dao.storageSlot.toString(), noteIndex);
-            }
-        });
-    }
-    /**
-   * Synchronizes notes and nullifiers to a specific block number.
-   *
-   * This method ensures that the state of notes and nullifiers is consistent with the
-   * specified block number. It restores any notes that were nullified after the given block
-   * and deletes any active notes created after that block.
-   *
-   * @param blockNumber - The new chain tip after a reorg
-   * @param synchedBlockNumber - The block number up to which PXE managed to sync before the reorg happened.
-   */ async rollbackNotesAndNullifiers(blockNumber, synchedBlockNumber) {
-        await this.#rewindNullifiersAfterBlock(blockNumber, synchedBlockNumber);
-        await this.#deleteActiveNotesAfterBlock(blockNumber);
-    }
-    /**
-   * Deletes (removes) all active notes created after the specified block number.
-   *
-   * Permanently delete notes from the active notes store, e.g. during a reorg.
-   * Note: This only affects #notes (active notes), not #nullifiedNotes.
-   *
-   * @param blockNumber - Notes created after this block number will be deleted
-   */ #deleteActiveNotesAfterBlock(blockNumber) {
-        return this.#store.transactionAsync(async ()=>{
-            const notes = await toArray(this.#notes.valuesAsync());
-            for (const note of notes){
-                const noteDao = NoteDao.fromBuffer(note);
-                if (noteDao.l2BlockNumber > blockNumber) {
-                    const noteIndex = toBufferBE(noteDao.index, 32).toString('hex');
-                    await this.#notes.delete(noteIndex);
-                    await this.#notesToScope.delete(noteIndex);
-                    await this.#nullifierToNoteId.delete(noteDao.siloedNullifier.toString());
-                    const scopes = await toArray(this.#scopes.keysAsync());
-                    for (const scope of scopes){
-                        await this.#notesByContractAndScope.get(scope).deleteValue(noteDao.contractAddress.toString(), noteIndex);
-                        await this.#notesByStorageSlotAndScope.get(scope).deleteValue(noteDao.storageSlot.toString(), noteIndex);
-                    }
-                }
-            }
-        });
-    }
-    /**
-   * Rewinds nullifications after a given block number.
-   *
-   * This operation "unnullifies" notes, rolling back nullifications that occurred
-   * in orphaned blocks, e.g. during a reorg.  The notes are restored to the
-   * active notes store and removed from the nullified store.
-   *
-   * @param blockNumber - Revert nullifications that occurred after this block
-   * @param synchedBlockNumber - Upper bound for the block range to process
-   */ async #rewindNullifiersAfterBlock(blockNumber, synchedBlockNumber) {
-        await this.#store.transactionAsync(async ()=>{
-            const nullifiersToUndo = [];
-            const currentBlockNumber = blockNumber + 1;
-            for(let i = currentBlockNumber; i <= synchedBlockNumber; i++){
-                nullifiersToUndo.push(...await toArray(this.#nullifiersByBlockNumber.getValuesAsync(i)));
-            }
-            const notesIndexesToReinsert = await Promise.all(nullifiersToUndo.map((nullifier)=>this.#nullifiedNotesByNullifier.getAsync(nullifier)));
-            const notNullNoteIndexes = notesIndexesToReinsert.filter((noteIndex)=>noteIndex != undefined);
-            const nullifiedNoteBuffers = await Promise.all(notNullNoteIndexes.map((noteIndex)=>this.#nullifiedNotes.getAsync(noteIndex)));
-            const noteDaos = nullifiedNoteBuffers.filter((buffer)=>buffer != undefined).map((buffer)=>NoteDao.fromBuffer(buffer));
-            for (const dao of noteDaos){
-                const noteIndex = toBufferBE(dao.index, 32).toString('hex');
-                await this.#notes.set(noteIndex, dao.toBuffer());
-                await this.#nullifierToNoteId.set(dao.siloedNullifier.toString(), noteIndex);
-                const scopes = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteIndex));
-                if (scopes.length === 0) {
-                    // We should never run into this error because notes always have a scope assigned to them - either on initial
-                    // insertion via `addNotes` or when removing their nullifiers.
-                    throw new Error(`No scopes found for nullified note with index ${noteIndex}`);
-                }
-                for (const scope of scopes){
-                    await this.#notesByContractAndScope.get(scope.toString()).set(dao.contractAddress.toString(), noteIndex);
-                    await this.#notesByStorageSlotAndScope.get(scope.toString()).set(dao.storageSlot.toString(), noteIndex);
-                    await this.#notesToScope.set(noteIndex, scope);
-                }
-                await this.#nullifiedNotes.delete(noteIndex);
-                await this.#nullifiedNotesToScope.delete(noteIndex);
-                await this.#nullifiersByBlockNumber.deleteValue(dao.l2BlockNumber, dao.siloedNullifier.toString());
-                await this.#nullifiedNotesByContract.deleteValue(dao.contractAddress.toString(), noteIndex);
-                await this.#nullifiedNotesByStorageSlot.deleteValue(dao.storageSlot.toString(), noteIndex);
-                await this.#nullifiedNotesByNullifier.delete(dao.siloedNullifier.toString());
-            }
-        });
-    }
-    /**
-   * Retrieves notes based on the provided filter criteria.
-   *
-   * This method queries both active and optionally nullified notes based on the filter
-   * parameters.
-   *
-   * @param filter - Filter criteria including contractAddress (required), and optional
-   *                 owner, storageSlot, status, scopes, and siloedNullifier.
-   * @returns Filtered and deduplicated notes (a note might be present in multiple scopes - we ensure it is only
-   * returned once if this is the case)
-   * @throws If filtering by an empty scopes array. Scopes have to be set to undefined or to a non-empty array.
-   */ async getNotes(filter) {
-        filter.status = filter.status ?? NoteStatus.ACTIVE;
-        // throw early if scopes is an empty array
-        if (filter.scopes !== undefined && filter.scopes.length === 0) {
-            throw new Error('Trying to get notes with an empty scopes array. Scopes have to be set to undefined if intending on not filtering by scopes.');
-        }
-        const candidateNoteSources = [];
-        filter.scopes ??= (await toArray(this.#scopes.keysAsync())).map((addressString)=>AztecAddress.fromString(addressString));
-        const activeNoteIdsPerScope = [];
-        for (const scope of new Set(filter.scopes)){
-            const formattedScopeString = scope.toString();
-            if (!await this.#scopes.hasAsync(formattedScopeString)) {
-                throw new Error('Trying to get incoming notes of a scope that is not in the PXE database');
-            }
-            activeNoteIdsPerScope.push(filter.storageSlot ? await toArray(this.#notesByStorageSlotAndScope.get(formattedScopeString).getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#notesByContractAndScope.get(formattedScopeString).getValuesAsync(filter.contractAddress.toString())));
-        }
-        candidateNoteSources.push({
-            ids: new Set(activeNoteIdsPerScope.flat()),
-            notes: this.#notes
-        });
-        // If status is ACTIVE_OR_NULLIFIED we add nullified notes as candidates on top of the default active ones.
-        if (filter.status === NoteStatus.ACTIVE_OR_NULLIFIED) {
-            const nullifiedIds = filter.storageSlot ? await toArray(this.#nullifiedNotesByStorageSlot.getValuesAsync(filter.storageSlot.toString())) : await toArray(this.#nullifiedNotesByContract.getValuesAsync(filter.contractAddress.toString()));
-            const setOfScopes = new Set(filter.scopes.map((s)=>s.toString()));
-            const filteredNullifiedIds = new Set();
-            for (const noteId of nullifiedIds){
-                const scopeList = await toArray(this.#nullifiedNotesToScope.getValuesAsync(noteId));
-                if (scopeList.some((scope)=>setOfScopes.has(scope))) {
-                    filteredNullifiedIds.add(noteId);
-                }
-            }
-            if (filteredNullifiedIds.size > 0) {
-                candidateNoteSources.push({
-                    ids: filteredNullifiedIds,
-                    notes: this.#nullifiedNotes
-                });
-            }
-        }
-        const result = [];
-        for (const { ids, notes } of candidateNoteSources){
-            for (const id of ids){
-                const serializedNote = await notes.getAsync(id);
-                if (!serializedNote) {
-                    continue;
-                }
-                const note = NoteDao.fromBuffer(serializedNote);
-                if (!note.contractAddress.equals(filter.contractAddress)) {
-                    continue;
-                }
-                if (filter.owner && !note.owner.equals(filter.owner)) {
-                    continue;
-                }
-                if (filter.storageSlot && !note.storageSlot.equals(filter.storageSlot)) {
-                    continue;
-                }
-                if (filter.siloedNullifier && !note.siloedNullifier.equals(filter.siloedNullifier)) {
-                    continue;
-                }
-                result.push(note);
-            }
-        }
-        // A note might be present in multiple scopes - we ensure it is only returned once
-        const deduplicated = [];
-        for (const note of result){
-            if (!deduplicated.some((existing)=>existing.equals(note))) {
-                deduplicated.push(note);
-            }
-        }
-        return deduplicated;
-    }
-    /**
-   * Transitions notes from "active" to "nullified" state.
-   *
-   * This operation processes a batch of nullifiers to mark the corresponding notes
-   * as spent/nullified.  The operation is atomic - if any nullifier is not found,
-   * the entire operation fails and no notes are modified.
-   *
-   * @param nullifiers - Array of nullifiers with their block numbers to process
-   * @returns Promise resolving to array of nullified NoteDao objects
-   * @throws Error if any nullifier is not found in the active notes
-   */ applyNullifiers(nullifiers) {
-        if (nullifiers.length === 0) {
-            return Promise.resolve([]);
-        }
-        return this.#store.transactionAsync(async ()=>{
-            const nullifiedNotes = [];
-            for (const blockScopedNullifier of nullifiers){
-                const { data: nullifier, l2BlockNumber: blockNumber } = blockScopedNullifier;
-                const nullifierKey = nullifier.toString();
-                const noteIndex = await this.#nullifierToNoteId.getAsync(nullifierKey);
-                if (!noteIndex) {
-                    // Check if already nullified?
-                    const alreadyNullified = await this.#nullifiedNotesByNullifier.getAsync(nullifierKey);
-                    if (alreadyNullified) {
-                        throw new Error(`Nullifier already applied in applyNullifiers`);
-                    }
-                    throw new Error('Nullifier not found in applyNullifiers');
-                }
-                const noteBuffer = noteIndex ? await this.#notes.getAsync(noteIndex) : undefined;
-                if (!noteBuffer) {
-                    throw new Error('Note not found in applyNullifiers');
-                }
-                const noteScopes = await toArray(this.#notesToScope.getValuesAsync(noteIndex));
-                if (noteScopes.length === 0) {
-                    // We should never run into this error because notes always have a scope assigned to them - either on initial
-                    // insertion via `addNotes` or when removing their nullifiers.
-                    throw new Error('Note scopes are missing in applyNullifiers');
-                }
-                const note = NoteDao.fromBuffer(noteBuffer);
-                nullifiedNotes.push(note);
-                await this.#notes.delete(noteIndex);
-                await this.#notesToScope.delete(noteIndex);
-                const scopes = await toArray(this.#scopes.keysAsync());
-                for (const scope of scopes){
-                    await this.#notesByContractAndScope.get(scope).deleteValue(note.contractAddress.toString(), noteIndex);
-                    await this.#notesByStorageSlotAndScope.get(scope).deleteValue(note.storageSlot.toString(), noteIndex);
-                }
-                for (const scope of noteScopes){
-                    await this.#nullifiedNotesToScope.set(noteIndex, scope);
-                }
-                await this.#nullifiedNotes.set(noteIndex, note.toBuffer());
-                await this.#nullifiersByBlockNumber.set(blockNumber, nullifier.toString());
-                await this.#nullifiedNotesByContract.set(note.contractAddress.toString(), noteIndex);
-                await this.#nullifiedNotesByStorageSlot.set(note.storageSlot.toString(), noteIndex);
-                await this.#nullifiedNotesByNullifier.set(nullifier.toString(), noteIndex);
-                await this.#nullifierToNoteId.delete(nullifier.toString());
-            }
-            return nullifiedNotes;
-        });
-    }
-}

package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts

@@ -1,51 +0,0 @@
-import { Fr } from '@aztec/foundation/curves/bn254';
-import type { AztecAsyncKVStore } from '@aztec/kv-store';
-import type { EventSelector } from '@aztec/stdlib/abi';
-import type { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { type InTx, TxHash } from '@aztec/stdlib/tx';
-import type { PackedPrivateEvent } from '../../pxe.js';
-export type PrivateEventDataProviderFilter = {
-    contractAddress: AztecAddress;
-    fromBlock: number;
-    toBlock: number;
-    scopes: AztecAddress[];
-    txHash?: TxHash;
-};
-type PrivateEventMetadata = InTx & {
-    contractAddress: AztecAddress;
-    scope: AztecAddress;
-};
-/**
- * Stores decrypted private event logs.
- */
-export declare class PrivateEventDataProvider {
-    #private;
-    logger: import("@aztec/foundation/log").Logger;
-    constructor(store: AztecAsyncKVStore);
-    /**
-     * Store a private event log.
-     * @param eventSelector - The event selector of the event.
-     * @param msgContent - The content of the event.
-     * @param eventCommitmentIndex - The index of the event commitment in the nullifier tree.
-     * @param metadata
-     *  contractAddress - The address of the contract that emitted the event.
-     *  scope - The address to which the event is scoped.
-     *  txHash - The transaction hash of the event log.
-     *  blockNumber - The block number in which the event was emitted.
-     */
-    storePrivateEventLog(eventSelector: EventSelector, msgContent: Fr[], eventCommitmentIndex: number, metadata: PrivateEventMetadata): Promise<void>;
-    /**
-     * Returns the private events given search parameters.
-     * @param eventSelector - The event selector to filter by.
-     * @param filter - Filtering criteria:
-     *  contractAddress: The address of the contract to get events from.
-     *  fromBlock: The block number to search from (inclusive).
-     *  toBlock: The block number to search upto (exclusive).
-     *  scope: - The addresses that decrypted the logs.
-     * @returns - The event log contents, augmented with metadata about
-     *  the transaction and block it the event was included in .
-     */
-    getPrivateEvents(eventSelector: EventSelector, filter: PrivateEventDataProviderFilter): Promise<PackedPrivateEvent[]>;
-}
-export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJpdmF0ZV9ldmVudF9kYXRhX3Byb3ZpZGVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc3RvcmFnZS9wcml2YXRlX2V2ZW50X2RhdGFfcHJvdmlkZXIvcHJpdmF0ZV9ldmVudF9kYXRhX3Byb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUdwRCxPQUFPLEtBQUssRUFBbUIsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFDekYsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDdkQsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFaEUsT0FBTyxFQUFFLEtBQUssSUFBSSxFQUFFLE1BQU0sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXJELE9BQU8sS0FBSyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXZELE1BQU0sTUFBTSw4QkFBOEIsR0FBRztJQUMzQyxlQUFlLEVBQUUsWUFBWSxDQUFDO0lBQzlCLFNBQVMsRUFBRSxNQUFNLENBQUM7SUFDbEIsT0FBTyxFQUFFLE1BQU0sQ0FBQztJQUNoQixNQUFNLEVBQUUsWUFBWSxFQUFFLENBQUM7SUFDdkIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pCLENBQUM7QUFVRixLQUFLLG9CQUFvQixHQUFHLElBQUksR0FBRztJQUNqQyxlQUFlLEVBQUUsWUFBWSxDQUFDO0lBQzlCLEtBQUssRUFBRSxZQUFZLENBQUM7Q0FDckIsQ0FBQztBQUVGOztHQUVHO0FBQ0gscUJBQWEsd0JBQXdCOztJQVNuQyxNQUFNLHlDQUErQztJQUVyRCxZQUFZLEtBQUssRUFBRSxpQkFBaUIsRUFLbkM7SUFNRDs7Ozs7Ozs7OztPQVVHO0lBQ0gsb0JBQW9CLENBQ2xCLGFBQWEsRUFBRSxhQUFhLEVBQzVCLFVBQVUsRUFBRSxFQUFFLEVBQUUsRUFDaEIsb0JBQW9CLEVBQUUsTUFBTSxFQUM1QixRQUFRLEVBQUUsb0JBQW9CLEdBQzdCLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0E4QmY7SUFFRDs7Ozs7Ozs7OztPQVVHO0lBQ1UsZ0JBQWdCLENBQzNCLGFBQWEsRUFBRSxhQUFhLEVBQzVCLE1BQU0sRUFBRSw4QkFBOEIsR0FDckMsT0FBTyxDQUFDLGtCQUFrQixFQUFFLENBQUMsQ0F3Qy9CO0NBQ0YifQ==

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

@@ -1 +0,0 @@
-{"version":3,"file":"private_event_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/private_event_data_provider/private_event_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAGpD,OAAO,KAAK,EAAmB,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,EAAE,YAAY,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAUF,KAAK,oBAAoB,GAAG,IAAI,GAAG;IACjC,eAAe,EAAE,YAAY,CAAC;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,qBAAa,wBAAwB;;IASnC,MAAM,yCAA+C;IAErD,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAMD;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,EAAE,EAAE,EAChB,oBAAoB,EAAE,MAAM,EAC5B,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA8Bf;IAED;;;;;;;;;;OAUG;IACU,gBAAgB,CAC3B,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwC/B;CACF"}

package/dest/storage/private_event_data_provider/private_event_data_provider.js

@@ -1,115 +0,0 @@
-import { BlockNumber } from '@aztec/foundation/branded-types';
-import { Fr } from '@aztec/foundation/curves/bn254';
-import { createLogger } from '@aztec/foundation/log';
-import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
-import { L2BlockHash } from '@aztec/stdlib/block';
-import { TxHash } from '@aztec/stdlib/tx';
-/**
- * Stores decrypted private event logs.
- */ export class PrivateEventDataProvider {
-    #store;
-    /** Array storing the actual private event log entries containing the log content and block number */ #eventLogs;
-    /** Map from contract_address_scope_eventSelector to array of indices into #eventLogs for efficient lookup */ #eventLogIndex;
-    /** Map from eventCommitmentIndex to boolean indicating if log has been seen. */ #seenLogs;
-    logger = createLogger('private_event_data_provider');
-    constructor(store){
-        this.#store = store;
-        this.#eventLogs = this.#store.openArray('private_event_logs');
-        this.#eventLogIndex = this.#store.openMap('private_event_log_index');
-        this.#seenLogs = this.#store.openMap('seen_logs');
-    }
-    #keyFor(contractAddress, scope, eventSelector) {
-        return `${contractAddress.toString()}_${scope.toString()}_${eventSelector.toString()}`;
-    }
-    /**
-   * Store a private event log.
-   * @param eventSelector - The event selector of the event.
-   * @param msgContent - The content of the event.
-   * @param eventCommitmentIndex - The index of the event commitment in the nullifier tree.
-   * @param metadata
-   *  contractAddress - The address of the contract that emitted the event.
-   *  scope - The address to which the event is scoped.
-   *  txHash - The transaction hash of the event log.
-   *  blockNumber - The block number in which the event was emitted.
-   */ storePrivateEventLog(eventSelector, msgContent, eventCommitmentIndex, metadata) {
-        const { contractAddress, scope, txHash, l2BlockNumber, l2BlockHash } = metadata;
-        return this.#store.transactionAsync(async ()=>{
-            const key = this.#keyFor(contractAddress, scope, eventSelector);
-            // Check if this exact log has already been stored using eventCommitmentIndex as unique identifier
-            const hasBeenSeen = await this.#seenLogs.getAsync(eventCommitmentIndex);
-            if (hasBeenSeen) {
-                this.logger.verbose('Ignoring duplicate event log', {
-                    txHash: txHash.toString(),
-                    eventCommitmentIndex
-                });
-                return;
-            }
-            this.logger.verbose('storing private event log', {
-                contractAddress,
-                scope,
-                msgContent,
-                l2BlockNumber
-            });
-            const index = await this.#eventLogs.lengthAsync();
-            await this.#eventLogs.push({
-                msgContent: serializeToBuffer(msgContent),
-                l2BlockNumber,
-                l2BlockHash: l2BlockHash.toBuffer(),
-                eventCommitmentIndex,
-                txHash: txHash.toBuffer()
-            });
-            const existingIndices = await this.#eventLogIndex.getAsync(key) || [];
-            await this.#eventLogIndex.set(key, [
-                ...existingIndices,
-                index
-            ]);
-            // Mark this log as seen using eventCommitmentIndex
-            await this.#seenLogs.set(eventCommitmentIndex, true);
-        });
-    }
-    /**
-   * Returns the private events given search parameters.
-   * @param eventSelector - The event selector to filter by.
-   * @param filter - Filtering criteria:
-   *  contractAddress: The address of the contract to get events from.
-   *  fromBlock: The block number to search from (inclusive).
-   *  toBlock: The block number to search upto (exclusive).
-   *  scope: - The addresses that decrypted the logs.
-   * @returns - The event log contents, augmented with metadata about
-   *  the transaction and block it the event was included in .
-   */ async getPrivateEvents(eventSelector, filter) {
-        const events = [];
-        for (const scope of filter.scopes){
-            const key = this.#keyFor(filter.contractAddress, scope, eventSelector);
-            const indices = await this.#eventLogIndex.getAsync(key) || [];
-            for (const index of indices){
-                const entry = await this.#eventLogs.atAsync(index);
-                if (!entry || entry.l2BlockNumber < filter.fromBlock || entry.l2BlockNumber >= filter.toBlock) {
-                    continue;
-                }
-                // Convert buffer back to Fr array
-                const reader = BufferReader.asReader(entry.msgContent);
-                const numFields = entry.msgContent.length / Fr.SIZE_IN_BYTES;
-                const msgContent = reader.readArray(numFields, Fr);
-                const txHash = TxHash.fromBuffer(entry.txHash);
-                const l2BlockHash = L2BlockHash.fromBuffer(entry.l2BlockHash);
-                if (filter.txHash && !txHash.equals(filter.txHash)) {
-                    continue;
-                }
-                events.push({
-                    eventCommitmentIndex: entry.eventCommitmentIndex,
-                    event: {
-                        packedEvent: msgContent,
-                        l2BlockNumber: BlockNumber(entry.l2BlockNumber),
-                        txHash,
-                        l2BlockHash,
-                        eventSelector
-                    }
-                });
-            }
-        }
-        // Sort by eventCommitmentIndex only
-        events.sort((a, b)=>a.eventCommitmentIndex - b.eventCommitmentIndex);
-        return events.map((ev)=>ev.event);
-    }
-}

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

@@ -1,3 +0,0 @@
-export { SenderTaggingDataProvider } from './sender_tagging_data_provider.js';
-export { RecipientTaggingDataProvider } from './recipient_tagging_data_provider.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zdG9yYWdlL3RhZ2dpbmdfZGF0YV9wcm92aWRlci9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUM5RSxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxzQ0FBc0MsQ0FBQyJ9

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC"}

package/dest/storage/tagging_data_provider/index.js

@@ -1,2 +0,0 @@
-export { SenderTaggingDataProvider } from './sender_tagging_data_provider.js';
-export { RecipientTaggingDataProvider } from './recipient_tagging_data_provider.js';

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

@@ -1,31 +0,0 @@
-import type { AztecAsyncKVStore } from '@aztec/kv-store';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import type { DirectionalAppTaggingSecret, PreTag } from '@aztec/stdlib/logs';
-/**
- * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class is
- * called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
- * the algorithms are completely disjoint and there is not data reuse between the 2.
- */
-export declare class RecipientTaggingDataProvider {
-    #private;
-    constructor(store: AztecAsyncKVStore);
-    /**
-     * 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
-     */
-    setLastUsedIndexes(preTags: PreTag[]): Promise<void[]>;
-    /**
-     * Returns the last used indexes when looking for logs.
-     * @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.
-     */
-    getLastUsedIndexes(secrets: DirectionalAppTaggingSecret[]): Promise<(number | undefined)[]>;
-    resetNoteSyncData(): Promise<void>;
-    addSenderAddress(address: AztecAddress): Promise<boolean>;
-    getSenderAddresses(): Promise<AztecAddress[]>;
-    removeSenderAddress(address: AztecAddress): Promise<boolean>;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVjaXBpZW50X3RhZ2dpbmdfZGF0YV9wcm92aWRlci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3N0b3JhZ2UvdGFnZ2luZ19kYXRhX3Byb3ZpZGVyL3JlY2lwaWVudF90YWdnaW5nX2RhdGFfcHJvdmlkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLEVBQUUsaUJBQWlCLEVBQWlCLE1BQU0saUJBQWlCLENBQUM7QUFDeEUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzNELE9BQU8sS0FBSyxFQUFFLDJCQUEyQixFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRTlFOzs7O0dBSUc7QUFDSCxxQkFBYSw0QkFBNEI7O0lBT3ZDLFlBQVksS0FBSyxFQUFFLGlCQUFpQixFQUtuQztJQUVEOzs7OztPQUtHO0lBQ0gsa0JBQWtCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxtQkFRbkM7SUFFRDs7Ozs7T0FLRztJQUNILGtCQUFrQixDQUFDLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxHQUFHLE9BQU8sQ0FBQyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsRUFBRSxDQUFDLENBRTFGO0lBRUQsaUJBQWlCLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUtqQztJQU9LLGdCQUFnQixDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVE5RDtJQUVLLGtCQUFrQixJQUFJLE9BQU8sQ0FBQyxZQUFZLEVBQUUsQ0FBQyxDQUVsRDtJQUVLLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxZQUFZLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQVFqRTtDQUNGIn0=

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

@@ -1 +0,0 @@
-{"version":3,"file":"recipient_tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/recipient_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;;;;GAIG;AACH,qBAAa,4BAA4B;;IAOvC,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,mBAQnC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAE1F;IAED,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjC;IAOK,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;CACF"}

package/dest/storage/tagging_data_provider/recipient_tagging_data_provider.js

@@ -1,65 +0,0 @@
-import { toArray } from '@aztec/foundation/iterable';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-/**
- * Data provider of tagging data used when syncing the logs as a recipient. The sender counterpart of this class is
- * called SenderTaggingDataProvider. We have the providers separate for the sender and recipient because
- * the algorithms are completely disjoint and there is not data reuse between the 2.
- */ export class RecipientTaggingDataProvider {
-    #store;
-    #addressBook;
-    // Stores the last used index for each directional app tagging secret.
-    #lastUsedIndexes;
-    constructor(store){
-        this.#store = store;
-        this.#addressBook = this.#store.openMap('address_book');
-        this.#lastUsedIndexes = this.#store.openMap('last_used_indexes');
-    }
-    /**
-   * 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
-   */ setLastUsedIndexes(preTags) {
-        // Non-unique secrets would indicate a bug in the caller function.
-        const secretsSet = new Set(preTags.map((preTag)=>preTag.secret.toString()));
-        if (secretsSet.size !== preTags.length) {
-            throw new Error(`Duplicate secrets found when setting last used indexes`);
-        }
-        return Promise.all(preTags.map(({ secret, index })=>this.#lastUsedIndexes.set(secret.toString(), index)));
-    }
-    /**
-   * Returns the last used indexes when looking for logs.
-   * @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.
-   */ getLastUsedIndexes(secrets) {
-        return Promise.all(secrets.map((secret)=>this.#lastUsedIndexes.getAsync(secret.toString())));
-    }
-    resetNoteSyncData() {
-        return this.#store.transactionAsync(async ()=>{
-            const keys = await toArray(this.#lastUsedIndexes.keysAsync());
-            await Promise.all(keys.map((secret)=>this.#lastUsedIndexes.delete(secret)));
-        });
-    }
-    // It might seem weird that the following 3 methods are in RecipientTaggingDataProvider and not
-    // in SenderTaggingDataProvider but that is because this data is truly only used for the purposes of syncing logs
-    // as a recipient. When sending logs or when syncing sender tagging indexes we only receive directional app tagging
-    // secret from Aztec.nr via an oracle and we don't need to access sender addresses.
-    async addSenderAddress(address) {
-        if (await this.#addressBook.hasAsync(address.toString())) {
-            return false;
-        }
-        await this.#addressBook.set(address.toString(), true);
-        return true;
-    }
-    async getSenderAddresses() {
-        return (await toArray(this.#addressBook.keysAsync())).map(AztecAddress.fromString);
-    }
-    async removeSenderAddress(address) {
-        if (!await this.#addressBook.hasAsync(address.toString())) {
-            return false;
-        }
-        await this.#addressBook.delete(address.toString());
-        return true;
-    }
-}

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

@@ -1 +0,0 @@
-{"version":3,"file":"sender_tagging_data_provider.d.ts","sourceRoot":"","sources":["../../../src/storage/tagging_data_provider/sender_tagging_data_provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI1C;;;;GAIG;AACH,qBAAa,yBAAyB;;IAkBpC,YAAY,KAAK,EAAE,iBAAiB,EAKnC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,iBAiD1D;IAED;;;;;;;;OAQG;IACG,2BAA2B,CAC/B,MAAM,EAAE,2BAA2B,EACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB;IAED;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtF;IAED;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAYvF;IAED;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAqB1C;IAED;;;OAGG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAqD9C;CACF"}