@aztec/pxe 0.0.1-commit.b655e406 → 0.0.1-commit.d1f2d6c

package/dest/storage/tagging_data_provider/tagging_data_provider.js

@@ -1,89 +0,0 @@
-import { toArray } from '@aztec/foundation/iterable';
-import { AztecAddress } from '@aztec/stdlib/aztec-address';
-export class TaggingDataProvider {
-    #store;
-    #addressBook;
-    // 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.#lastUsedIndexesAsSenders = this.#store.openMap('last_used_indexes_as_senders');
-        this.#lastUsedIndexesAsRecipients = this.#store.openMap('last_used_indexes_as_recipients');
-    }
-    /**
-   * 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)));
-    }
-    /**
-   * 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)));
-    }
-    // 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}`);
-        }
-    }
-    /**
-   * 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());
-    }
-    /**
-   * 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 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) {
-        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;
-    }
-    async getSize() {
-        const addressesCount = (await toArray(this.#addressBook.keysAsync())).length;
-        // All keys are addresses
-        return 3 * addressesCount * AztecAddress.SIZE_IN_BYTES;
-    }
-}

package/dest/synchronizer/index.d.ts

@@ -1,2 +0,0 @@
-export * from './synchronizer.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/synchronizer/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dest/synchronizer/index.js

@@ -1 +0,0 @@
-export * from './synchronizer.js';

package/dest/synchronizer/synchronizer.d.ts

@@ -1,35 +0,0 @@
-import { type Logger } from '@aztec/foundation/log';
-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';
-import type { NoteDataProvider } from '../storage/note_data_provider/note_data_provider.js';
-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 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;
-    private syncDataProvider;
-    private noteDataProvider;
-    private taggingDataProvider;
-    private l2TipsStore;
-    private log;
-    private isSyncing;
-    protected readonly blockStream: 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 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

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

@@ -1 +0,0 @@
-{"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;gBAGpC,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;IASlC,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAShF,iDAAiD;IACpC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7E;;;OAGG;IACU,IAAI;YAiBH,MAAM;IAeb,qBAAqB;CAG7B"}

package/dest/synchronizer/synchronizer.js

@@ -1,101 +0,0 @@
-import { createLogger } from '@aztec/foundation/log';
-import { L2BlockStream } from '@aztec/stdlib/block';
-/**
- * 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;
-    log;
-    isSyncing;
-    blockStream;
-    constructor(node, syncDataProvider, noteDataProvider, taggingDataProvider, l2TipsStore, config = {}, loggerOrSuffix){
-        this.node = node;
-        this.syncDataProvider = syncDataProvider;
-        this.noteDataProvider = noteDataProvider;
-        this.taggingDataProvider = taggingDataProvider;
-        this.l2TipsStore = l2TipsStore;
-        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'), {
-            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) {
-        await this.l2TipsStore.handleBlockStreamEvent(event);
-        switch(event.type){
-            case 'blocks-added':
-                {
-                    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.getBlockHeader());
-                    break;
-                }
-            case 'chain-pruned':
-                {
-                    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.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.block.number);
-                    if (!newHeader) {
-                        this.log.error(`Block header not found for block number ${event.block.number} during chain prune`);
-                    } else {
-                        await this.syncDataProvider.setHeader(newHeader);
-                    }
-                    break;
-                }
-        }
-    }
-    /**
-   * 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) {
-            this.log.debug(`Waiting for the ongoing sync to finish`);
-            await this.isSyncing;
-            return;
-        }
-        this.log.debug(`Syncing PXE with the node`);
-        const isSyncing = this.doSync();
-        this.isSyncing = isSyncing;
-        try {
-            await isSyncing;
-        } finally{
-            this.isSyncing = undefined;
-        }
-    }
-    async doSync() {
-        let currentHeader;
-        try {
-            currentHeader = await this.syncDataProvider.getBlockHeader();
-        } catch  {
-            this.log.debug('Header is not set, requesting from the node');
-        }
-        if (!currentHeader) {
-            // REFACTOR: We should know the header of the genesis block without having to request it from the node.
-            await this.syncDataProvider.setHeader(await this.node.getBlockHeader(0));
-        }
-        await this.blockStream.sync();
-    }
-    getSynchedBlockNumber() {
-        return this.syncDataProvider.getBlockNumber();
-    }
-}

package/dest/tagging/siloed_tag.d.ts

@@ -1,14 +0,0 @@
-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=siloed_tag.d.ts.map

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

@@ -1 +0,0 @@
-{"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;WAEM,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAKrE,QAAQ,IAAI,MAAM;CAGnB"}

package/dest/tagging/siloed_tag.js

@@ -1,20 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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=tag.d.ts.map

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

@@ -1 +0,0 @@
-{"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;WAEM,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAInD"}

package/dest/tagging/tag.js

@@ -1,17 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-// 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;
-}