@aztec/pxe 0.8.6

package/dest/note_processor/note_processor.d.ts

@@ -0,0 +1,78 @@
+import { AztecNode, KeyStore, L2BlockContext, L2BlockL2Logs, PublicKey } from '@aztec/types';
+import { Database } from '../database/index.js';
+/**
+ * NoteProcessor is responsible for decrypting logs and converting them to notes via their originating contracts
+ * before storing them against their owner.
+ */
+export declare class NoteProcessor {
+    /**
+     * The public counterpart to the private key to be used in note decryption.
+     */
+    readonly publicKey: PublicKey;
+    private keyStore;
+    private db;
+    private node;
+    private simulator;
+    private log;
+    /**
+     * The latest L2 block number that the note processor has synchronized to.
+     */
+    private syncedToBlock;
+    constructor(
+    /**
+     * The public counterpart to the private key to be used in note decryption.
+     */
+    publicKey: PublicKey, keyStore: KeyStore, db: Database, node: AztecNode, simulator?: import("@aztec/acir-simulator").AcirSimulator, log?: import("@aztec/foundation/log").DebugLogger);
+    /**
+     * Check if the NoteProcessor is synchronized with the remote block number.
+     * The function queries the remote block number from the AztecNode and compares it with the syncedToBlock value in the NoteProcessor.
+     * If the values are equal, then the NoteProcessor is considered to be synchronized, otherwise not.
+     *
+     * @returns A boolean indicating whether the NoteProcessor is synchronized with the remote block number or not.
+     */
+    isSynchronized(): Promise<boolean>;
+    /**
+     * Returns synchronisation status (ie up to which block has been synced ) for this note processor.
+     */
+    get status(): {
+        syncedToBlock: number;
+    };
+    /**
+     * Process the given L2 block contexts and encrypted logs to update the note processor.
+     * It synchronizes the user's account by decrypting the encrypted logs and processing
+     * the transactions and auxiliary data associated with them.
+     * Throws an error if the number of block contexts and encrypted logs do not match.
+     *
+     * @param l2BlockContexts - An array of L2 block contexts to be processed.
+     * @param encryptedL2BlockLogs - An array of encrypted logs associated with the L2 block contexts.
+     * @returns A promise that resolves once the processing is completed.
+     */
+    process(l2BlockContexts: L2BlockContext[], encryptedL2BlockLogs: L2BlockL2Logs[]): Promise<void>;
+    /**
+     * Find the index of the note in the private data tree by computing the note hash with different nonce and see which
+     * commitment for the current tx matches this value.
+     * Compute the nullifier for a given transaction auxiliary data.
+     * The nullifier is calculated using the private key of the account,
+     * contract address, and note preimage associated with the noteSpendingInfo.
+     * This method assists in identifying spent commitments in the private state.
+     * @param commitments - Commitments in the tx. One of them should be the note's commitment.
+     * @param firstNullifier - First nullifier in the tx.
+     * @param noteSpendingInfo - An instance of NoteSpendingInfo containing transaction details.
+     * @param excludedIndices - Indices that have been assigned a note in the same tx. Notes in a tx can have the same
+     * NoteSpendingInfo. We need to find a different index for each replicate.
+     * @returns Information for a decrypted note, including the index of its commitment, nonce, inner note
+     * hash, and the siloed nullifier. Throw if cannot find the nonce for the note.
+     */
+    private findNoteIndexAndNullifier;
+    /**
+     * Process the given blocks and their associated transaction auxiliary data.
+     * This function updates the database with information about new transactions,
+     * user-pertaining transaction indices, and auxiliary data. It also removes nullified
+     * transaction auxiliary data from the database. This function keeps track of new nullifiers
+     * and ensures all other transactions are updated with newly settled block information.
+     *
+     * @param blocksAndNoteSpendingInfo - Array of objects containing L2BlockContexts, user-pertaining transaction indices, and NoteSpendingInfoDaos.
+     */
+    private processBlocksAndNoteSpendingInfo;
+}
+//# sourceMappingURL=note_processor.d.ts.map

package/dest/note_processor/note_processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note_processor.d.ts","sourceRoot":"","sources":["../../src/note_processor/note_processor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/G,OAAO,EAAE,QAAQ,EAAuB,MAAM,sBAAsB,CAAC;AAiBrE;;;GAGG;AACH,qBAAa,aAAa;IAOtB;;OAEG;aACa,SAAS,EAAE,SAAS;IACpC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,GAAG;IAdb;;OAEG;IACH,OAAO,CAAC,aAAa,CAAK;;IAGxB;;OAEG;IACa,SAAS,EAAE,SAAS,EAC5B,QAAQ,EAAE,QAAQ,EAClB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,SAAS,EACf,SAAS,gDAAuC,EAChD,GAAG,8CAAkD;IAG/D;;;;;;OAMG;IACU,cAAc;IAK3B;;OAEG;IACH,IAAW,MAAM;;MAEhB;IAED;;;;;;;;;OASG;IACU,OAAO,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,oBAAoB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF7G;;;;;;;;;;;;;;OAcG;YACW,yBAAyB;IA+DvC;;;;;;;;OAQG;YACW,gCAAgC;CAuB/C"}

package/dest/note_processor/note_processor.js

@@ -0,0 +1,206 @@
+import { CircuitsWasm, MAX_NEW_COMMITMENTS_PER_TX, MAX_NEW_NULLIFIERS_PER_TX } from '@aztec/circuits.js';
+import { computeCommitmentNonce, siloNullifier } from '@aztec/circuits.js/abis';
+import { Grumpkin } from '@aztec/circuits.js/barretenberg';
+import { Fr } from '@aztec/foundation/fields';
+import { createDebugLogger } from '@aztec/foundation/log';
+import { NoteSpendingInfo } from '@aztec/types';
+import { getAcirSimulator } from '../simulator/index.js';
+/**
+ * NoteProcessor is responsible for decrypting logs and converting them to notes via their originating contracts
+ * before storing them against their owner.
+ */
+export class NoteProcessor {
+    constructor(
+    /**
+     * The public counterpart to the private key to be used in note decryption.
+     */
+    publicKey, keyStore, db, node, simulator = getAcirSimulator(db, node, keyStore), log = createDebugLogger('aztec:aztec_note_processor')) {
+        this.publicKey = publicKey;
+        this.keyStore = keyStore;
+        this.db = db;
+        this.node = node;
+        this.simulator = simulator;
+        this.log = log;
+        /**
+         * The latest L2 block number that the note processor has synchronized to.
+         */
+        this.syncedToBlock = 0;
+    }
+    /**
+     * Check if the NoteProcessor is synchronized with the remote block number.
+     * The function queries the remote block number from the AztecNode and compares it with the syncedToBlock value in the NoteProcessor.
+     * If the values are equal, then the NoteProcessor is considered to be synchronized, otherwise not.
+     *
+     * @returns A boolean indicating whether the NoteProcessor is synchronized with the remote block number or not.
+     */
+    async isSynchronized() {
+        const remoteBlockNumber = await this.node.getBlockNumber();
+        return this.syncedToBlock === remoteBlockNumber;
+    }
+    /**
+     * Returns synchronisation status (ie up to which block has been synced ) for this note processor.
+     */
+    get status() {
+        return { syncedToBlock: this.syncedToBlock };
+    }
+    /**
+     * Process the given L2 block contexts and encrypted logs to update the note processor.
+     * It synchronizes the user's account by decrypting the encrypted logs and processing
+     * the transactions and auxiliary data associated with them.
+     * Throws an error if the number of block contexts and encrypted logs do not match.
+     *
+     * @param l2BlockContexts - An array of L2 block contexts to be processed.
+     * @param encryptedL2BlockLogs - An array of encrypted logs associated with the L2 block contexts.
+     * @returns A promise that resolves once the processing is completed.
+     */
+    async process(l2BlockContexts, encryptedL2BlockLogs) {
+        if (l2BlockContexts.length !== encryptedL2BlockLogs.length) {
+            throw new Error(`Number of blocks and EncryptedLogs is not equal. Received ${l2BlockContexts.length} blocks, ${encryptedL2BlockLogs.length} encrypted logs.`);
+        }
+        if (!l2BlockContexts.length) {
+            return;
+        }
+        const blocksAndNoteSpendingInfo = [];
+        const curve = await Grumpkin.new();
+        // Iterate over both blocks and encrypted logs.
+        for (let blockIndex = 0; blockIndex < encryptedL2BlockLogs.length; ++blockIndex) {
+            const { txLogs } = encryptedL2BlockLogs[blockIndex];
+            const block = l2BlockContexts[blockIndex].block;
+            const dataStartIndexForBlock = block.startPrivateDataTreeSnapshot.nextAvailableLeafIndex;
+            // We are using set for `userPertainingTxIndices` to avoid duplicates. This would happen in case there were
+            // multiple encrypted logs in a tx pertaining to a user.
+            const noteSpendingInfoDaos = [];
+            const privateKey = await this.keyStore.getAccountPrivateKey(this.publicKey);
+            // Iterate over all the encrypted logs and try decrypting them. If successful, store the note spending info.
+            for (let indexOfTxInABlock = 0; indexOfTxInABlock < txLogs.length; ++indexOfTxInABlock) {
+                const dataStartIndexForTx = dataStartIndexForBlock + indexOfTxInABlock * MAX_NEW_COMMITMENTS_PER_TX;
+                const newCommitments = block.newCommitments.slice(indexOfTxInABlock * MAX_NEW_COMMITMENTS_PER_TX, (indexOfTxInABlock + 1) * MAX_NEW_COMMITMENTS_PER_TX);
+                const newNullifiers = block.newNullifiers.slice(indexOfTxInABlock * MAX_NEW_NULLIFIERS_PER_TX, (indexOfTxInABlock + 1) * MAX_NEW_NULLIFIERS_PER_TX);
+                // Note: Each tx generates a `TxL2Logs` object and for this reason we can rely on its index corresponding
+                //       to the index of a tx in a block.
+                const txFunctionLogs = txLogs[indexOfTxInABlock].functionLogs;
+                const excludedIndices = new Set();
+                for (const functionLogs of txFunctionLogs) {
+                    for (const logs of functionLogs.logs) {
+                        const noteSpendingInfo = NoteSpendingInfo.fromEncryptedBuffer(logs, privateKey, curve);
+                        if (noteSpendingInfo) {
+                            // We have successfully decrypted the data.
+                            try {
+                                const { commitmentIndex, nonce, innerNoteHash, siloedNullifier } = await this.findNoteIndexAndNullifier(newCommitments, newNullifiers[0], noteSpendingInfo, excludedIndices);
+                                const index = BigInt(dataStartIndexForTx + commitmentIndex);
+                                excludedIndices.add(commitmentIndex);
+                                noteSpendingInfoDaos.push({
+                                    ...noteSpendingInfo,
+                                    nonce,
+                                    innerNoteHash,
+                                    siloedNullifier,
+                                    index,
+                                    publicKey: this.publicKey,
+                                });
+                            }
+                            catch (e) {
+                                this.log.warn(`Could not process note because of "${e}". Skipping note...`);
+                            }
+                        }
+                    }
+                }
+            }
+            blocksAndNoteSpendingInfo.push({
+                blockContext: l2BlockContexts[blockIndex],
+                noteSpendingInfoDaos,
+            });
+        }
+        await this.processBlocksAndNoteSpendingInfo(blocksAndNoteSpendingInfo);
+        this.syncedToBlock = l2BlockContexts[l2BlockContexts.length - 1].block.number;
+        this.log(`Synched block ${this.syncedToBlock}`);
+    }
+    /**
+     * Find the index of the note in the private data tree by computing the note hash with different nonce and see which
+     * commitment for the current tx matches this value.
+     * Compute the nullifier for a given transaction auxiliary data.
+     * The nullifier is calculated using the private key of the account,
+     * contract address, and note preimage associated with the noteSpendingInfo.
+     * This method assists in identifying spent commitments in the private state.
+     * @param commitments - Commitments in the tx. One of them should be the note's commitment.
+     * @param firstNullifier - First nullifier in the tx.
+     * @param noteSpendingInfo - An instance of NoteSpendingInfo containing transaction details.
+     * @param excludedIndices - Indices that have been assigned a note in the same tx. Notes in a tx can have the same
+     * NoteSpendingInfo. We need to find a different index for each replicate.
+     * @returns Information for a decrypted note, including the index of its commitment, nonce, inner note
+     * hash, and the siloed nullifier. Throw if cannot find the nonce for the note.
+     */
+    async findNoteIndexAndNullifier(commitments, firstNullifier, { contractAddress, storageSlot, notePreimage }, excludedIndices) {
+        const wasm = await CircuitsWasm.get();
+        let commitmentIndex = 0;
+        let nonce;
+        let innerNoteHash;
+        let siloedNoteHash;
+        let uniqueSiloedNoteHash;
+        let innerNullifier;
+        for (; commitmentIndex < commitments.length; ++commitmentIndex) {
+            if (excludedIndices.has(commitmentIndex))
+                continue;
+            const commitment = commitments[commitmentIndex];
+            if (commitment.equals(Fr.ZERO))
+                break;
+            const expectedNonce = computeCommitmentNonce(wasm, firstNullifier, commitmentIndex);
+            ({ innerNoteHash, siloedNoteHash, uniqueSiloedNoteHash, innerNullifier } =
+                await this.simulator.computeNoteHashAndNullifier(contractAddress, expectedNonce, storageSlot, notePreimage.items));
+            if (commitment.equals(uniqueSiloedNoteHash)) {
+                nonce = expectedNonce;
+                break;
+            }
+        }
+        if (!nonce) {
+            let errorString;
+            if (siloedNoteHash == undefined) {
+                errorString = 'Cannot find a matching commitment for the note.';
+            }
+            else {
+                errorString = `We decrypted a log, but couldn't find a corresponding note in the tree.
+This might be because the note was nullified in the same tx which created it.
+In that case, everything is fine. To check whether this is the case, look back through
+the logs for a notification
+'important: chopped commitment for siloed inner hash note
+${siloedNoteHash.toString()}'.
+If you can see that notification. Everything's fine.
+If that's not the case, and you can't find such a notification, something has gone wrong.
+There could be a problem with the way you've defined a custom note, or with the way you're
+serialising / deserialising / hashing / encrypting / decrypting that note.
+Please see the following github issue to track an improvement that we're working on:
+https://github.com/AztecProtocol/aztec-packages/issues/1641`;
+            }
+            throw new Error(errorString);
+        }
+        return {
+            commitmentIndex,
+            nonce,
+            innerNoteHash: innerNoteHash,
+            siloedNullifier: siloNullifier(wasm, contractAddress, innerNullifier),
+        };
+    }
+    /**
+     * Process the given blocks and their associated transaction auxiliary data.
+     * This function updates the database with information about new transactions,
+     * user-pertaining transaction indices, and auxiliary data. It also removes nullified
+     * transaction auxiliary data from the database. This function keeps track of new nullifiers
+     * and ensures all other transactions are updated with newly settled block information.
+     *
+     * @param blocksAndNoteSpendingInfo - Array of objects containing L2BlockContexts, user-pertaining transaction indices, and NoteSpendingInfoDaos.
+     */
+    async processBlocksAndNoteSpendingInfo(blocksAndNoteSpendingInfo) {
+        const noteSpendingInfoDaosBatch = blocksAndNoteSpendingInfo.flatMap(b => b.noteSpendingInfoDaos);
+        if (noteSpendingInfoDaosBatch.length) {
+            await this.db.addNoteSpendingInfoBatch(noteSpendingInfoDaosBatch);
+            noteSpendingInfoDaosBatch.forEach(noteSpendingInfo => {
+                this.log(`Added note spending info for contract ${noteSpendingInfo.contractAddress} at slot ${noteSpendingInfo.storageSlot} with nullifier ${noteSpendingInfo.siloedNullifier.toString()}`);
+            });
+        }
+        const newNullifiers = blocksAndNoteSpendingInfo.flatMap(b => b.blockContext.block.newNullifiers);
+        const removedNoteSpendingInfo = await this.db.removeNullifiedNoteSpendingInfo(newNullifiers, this.publicKey);
+        removedNoteSpendingInfo.forEach(noteSpendingInfo => {
+            this.log(`Removed note spending info for contract ${noteSpendingInfo.contractAddress} at slot ${noteSpendingInfo.storageSlot} with nullifier ${noteSpendingInfo.siloedNullifier.toString()}`);
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm90ZV9wcm9jZXNzb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbm90ZV9wcm9jZXNzb3Ivbm90ZV9wcm9jZXNzb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFlBQVksRUFBRSwwQkFBMEIsRUFBRSx5QkFBeUIsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ3pHLE9BQU8sRUFBRSxzQkFBc0IsRUFBRSxhQUFhLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNoRixPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDM0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzFELE9BQU8sRUFBc0QsZ0JBQWdCLEVBQWEsTUFBTSxjQUFjLENBQUM7QUFHL0csT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFnQnpEOzs7R0FHRztBQUNILE1BQU0sT0FBTyxhQUFhO0lBTXhCO0lBQ0U7O09BRUc7SUFDYSxTQUFvQixFQUM1QixRQUFrQixFQUNsQixFQUFZLEVBQ1osSUFBZSxFQUNmLFlBQVksZ0JBQWdCLENBQUMsRUFBRSxFQUFFLElBQUksRUFBRSxRQUFRLENBQUMsRUFDaEQsTUFBTSxpQkFBaUIsQ0FBQyw0QkFBNEIsQ0FBQztRQUw3QyxjQUFTLEdBQVQsU0FBUyxDQUFXO1FBQzVCLGFBQVEsR0FBUixRQUFRLENBQVU7UUFDbEIsT0FBRSxHQUFGLEVBQUUsQ0FBVTtRQUNaLFNBQUksR0FBSixJQUFJLENBQVc7UUFDZixjQUFTLEdBQVQsU0FBUyxDQUF1QztRQUNoRCxRQUFHLEdBQUgsR0FBRyxDQUFrRDtRQWQvRDs7V0FFRztRQUNLLGtCQUFhLEdBQUcsQ0FBQyxDQUFDO0lBWXZCLENBQUM7SUFFSjs7Ozs7O09BTUc7SUFDSSxLQUFLLENBQUMsY0FBYztRQUN6QixNQUFNLGlCQUFpQixHQUFHLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQyxjQUFjLEVBQUUsQ0FBQztRQUMzRCxPQUFPLElBQUksQ0FBQyxhQUFhLEtBQUssaUJBQWlCLENBQUM7SUFDbEQsQ0FBQztJQUVEOztPQUVHO0lBQ0gsSUFBVyxNQUFNO1FBQ2YsT0FBTyxFQUFFLGFBQWEsRUFBRSxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7SUFDL0MsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNJLEtBQUssQ0FBQyxPQUFPLENBQUMsZUFBaUMsRUFBRSxvQkFBcUM7UUFDM0YsSUFBSSxlQUFlLENBQUMsTUFBTSxLQUFLLG9CQUFvQixDQUFDLE1BQU0sRUFBRTtZQUMxRCxNQUFNLElBQUksS0FBSyxDQUNiLDZEQUE2RCxlQUFlLENBQUMsTUFBTSxZQUFZLG9CQUFvQixDQUFDLE1BQU0sa0JBQWtCLENBQzdJLENBQUM7U0FDSDtRQUNELElBQUksQ0FBQyxlQUFlLENBQUMsTUFBTSxFQUFFO1lBQzNCLE9BQU87U0FDUjtRQUVELE1BQU0seUJBQXlCLEdBQW9CLEVBQUUsQ0FBQztRQUN0RCxNQUFNLEtBQUssR0FBRyxNQUFNLFFBQVEsQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUVuQywrQ0FBK0M7UUFDL0MsS0FBSyxJQUFJLFVBQVUsR0FBRyxDQUFDLEVBQUUsVUFBVSxHQUFHLG9CQUFvQixDQUFDLE1BQU0sRUFBRSxFQUFFLFVBQVUsRUFBRTtZQUMvRSxNQUFNLEVBQUUsTUFBTSxFQUFFLEdBQUcsb0JBQW9CLENBQUMsVUFBVSxDQUFDLENBQUM7WUFDcEQsTUFBTSxLQUFLLEdBQUcsZUFBZSxDQUFDLFVBQVUsQ0FBQyxDQUFDLEtBQUssQ0FBQztZQUNoRCxNQUFNLHNCQUFzQixHQUFHLEtBQUssQ0FBQyw0QkFBNEIsQ0FBQyxzQkFBc0IsQ0FBQztZQUV6RiwyR0FBMkc7WUFDM0csd0RBQXdEO1lBQ3hELE1BQU0sb0JBQW9CLEdBQTBCLEVBQUUsQ0FBQztZQUN2RCxNQUFNLFVBQVUsR0FBRyxNQUFNLElBQUksQ0FBQyxRQUFRLENBQUMsb0JBQW9CLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1lBRTVFLDRHQUE0RztZQUM1RyxLQUFLLElBQUksaUJBQWlCLEdBQUcsQ0FBQyxFQUFFLGlCQUFpQixHQUFHLE1BQU0sQ0FBQyxNQUFNLEVBQUUsRUFBRSxpQkFBaUIsRUFBRTtnQkFDdEYsTUFBTSxtQkFBbUIsR0FBRyxzQkFBc0IsR0FBRyxpQkFBaUIsR0FBRywwQkFBMEIsQ0FBQztnQkFDcEcsTUFBTSxjQUFjLEdBQUcsS0FBSyxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQy9DLGlCQUFpQixHQUFHLDBCQUEwQixFQUM5QyxDQUFDLGlCQUFpQixHQUFHLENBQUMsQ0FBQyxHQUFHLDBCQUEwQixDQUNyRCxDQUFDO2dCQUNGLE1BQU0sYUFBYSxHQUFHLEtBQUssQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUM3QyxpQkFBaUIsR0FBRyx5QkFBeUIsRUFDN0MsQ0FBQyxpQkFBaUIsR0FBRyxDQUFDLENBQUMsR0FBRyx5QkFBeUIsQ0FDcEQsQ0FBQztnQkFDRix5R0FBeUc7Z0JBQ3pHLHlDQUF5QztnQkFDekMsTUFBTSxjQUFjLEdBQUcsTUFBTSxDQUFDLGlCQUFpQixDQUFDLENBQUMsWUFBWSxDQUFDO2dCQUM5RCxNQUFNLGVBQWUsR0FBZ0IsSUFBSSxHQUFHLEVBQUUsQ0FBQztnQkFDL0MsS0FBSyxNQUFNLFlBQVksSUFBSSxjQUFjLEVBQUU7b0JBQ3pDLEtBQUssTUFBTSxJQUFJLElBQUksWUFBWSxDQUFDLElBQUksRUFBRTt3QkFDcEMsTUFBTSxnQkFBZ0IsR0FBRyxnQkFBZ0IsQ0FBQyxtQkFBbUIsQ0FBQyxJQUFJLEVBQUUsVUFBVSxFQUFFLEtBQUssQ0FBQyxDQUFDO3dCQUN2RixJQUFJLGdCQUFnQixFQUFFOzRCQUNwQiwyQ0FBMkM7NEJBQzNDLElBQUk7Z0NBQ0YsTUFBTSxFQUFFLGVBQWUsRUFBRSxLQUFLLEVBQUUsYUFBYSxFQUFFLGVBQWUsRUFBRSxHQUFHLE1BQU0sSUFBSSxDQUFDLHlCQUF5QixDQUNyRyxjQUFjLEVBQ2QsYUFBYSxDQUFDLENBQUMsQ0FBQyxFQUNoQixnQkFBZ0IsRUFDaEIsZUFBZSxDQUNoQixDQUFDO2dDQUNGLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxtQkFBbUIsR0FBRyxlQUFlLENBQUMsQ0FBQztnQ0FDNUQsZUFBZSxDQUFDLEdBQUcsQ0FBQyxlQUFlLENBQUMsQ0FBQztnQ0FDckMsb0JBQW9CLENBQUMsSUFBSSxDQUFDO29DQUN4QixHQUFHLGdCQUFnQjtvQ0FDbkIsS0FBSztvQ0FDTCxhQUFhO29DQUNiLGVBQWU7b0NBQ2YsS0FBSztvQ0FDTCxTQUFTLEVBQUUsSUFBSSxDQUFDLFNBQVM7aUNBQzFCLENBQUMsQ0FBQzs2QkFDSjs0QkFBQyxPQUFPLENBQUMsRUFBRTtnQ0FDVixJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxzQ0FBc0MsQ0FBQyxxQkFBcUIsQ0FBQyxDQUFDOzZCQUM3RTt5QkFDRjtxQkFDRjtpQkFDRjthQUNGO1lBRUQseUJBQXlCLENBQUMsSUFBSSxDQUFDO2dCQUM3QixZQUFZLEVBQUUsZUFBZSxDQUFDLFVBQVUsQ0FBQztnQkFDekMsb0JBQW9CO2FBQ3JCLENBQUMsQ0FBQztTQUNKO1FBRUQsTUFBTSxJQUFJLENBQUMsZ0NBQWdDLENBQUMseUJBQXlCLENBQUMsQ0FBQztRQUV2RSxJQUFJLENBQUMsYUFBYSxHQUFHLGVBQWUsQ0FBQyxlQUFlLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUM7UUFDOUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsSUFBSSxDQUFDLGFBQWEsRUFBRSxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7OztPQWNHO0lBQ0ssS0FBSyxDQUFDLHlCQUF5QixDQUNyQyxXQUFpQixFQUNqQixjQUFrQixFQUNsQixFQUFFLGVBQWUsRUFBRSxXQUFXLEVBQUUsWUFBWSxFQUFvQixFQUNoRSxlQUE0QjtRQUU1QixNQUFNLElBQUksR0FBRyxNQUFNLFlBQVksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUN0QyxJQUFJLGVBQWUsR0FBRyxDQUFDLENBQUM7UUFDeEIsSUFBSSxLQUFxQixDQUFDO1FBQzFCLElBQUksYUFBNkIsQ0FBQztRQUNsQyxJQUFJLGNBQThCLENBQUM7UUFDbkMsSUFBSSxvQkFBb0MsQ0FBQztRQUN6QyxJQUFJLGNBQThCLENBQUM7UUFDbkMsT0FBTyxlQUFlLEdBQUcsV0FBVyxDQUFDLE1BQU0sRUFBRSxFQUFFLGVBQWUsRUFBRTtZQUM5RCxJQUFJLGVBQWUsQ0FBQyxHQUFHLENBQUMsZUFBZSxDQUFDO2dCQUFFLFNBQVM7WUFFbkQsTUFBTSxVQUFVLEdBQUcsV0FBVyxDQUFDLGVBQWUsQ0FBQyxDQUFDO1lBQ2hELElBQUksVUFBVSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDO2dCQUFFLE1BQU07WUFFdEMsTUFBTSxhQUFhLEdBQUcsc0JBQXNCLENBQUMsSUFBSSxFQUFFLGNBQWMsRUFBRSxlQUFlLENBQUMsQ0FBQztZQUNwRixDQUFDLEVBQUUsYUFBYSxFQUFFLGNBQWMsRUFBRSxvQkFBb0IsRUFBRSxjQUFjLEVBQUU7Z0JBQ3RFLE1BQU0sSUFBSSxDQUFDLFNBQVMsQ0FBQywyQkFBMkIsQ0FDOUMsZUFBZSxFQUNmLGFBQWEsRUFDYixXQUFXLEVBQ1gsWUFBWSxDQUFDLEtBQUssQ0FDbkIsQ0FBQyxDQUFDO1lBQ0wsSUFBSSxVQUFVLENBQUMsTUFBTSxDQUFDLG9CQUFvQixDQUFDLEVBQUU7Z0JBQzNDLEtBQUssR0FBRyxhQUFhLENBQUM7Z0JBQ3RCLE1BQU07YUFDUDtTQUNGO1FBRUQsSUFBSSxDQUFDLEtBQUssRUFBRTtZQUNWLElBQUksV0FBVyxDQUFDO1lBQ2hCLElBQUksY0FBYyxJQUFJLFNBQVMsRUFBRTtnQkFDL0IsV0FBVyxHQUFHLGlEQUFpRCxDQUFDO2FBQ2pFO2lCQUFNO2dCQUNMLFdBQVcsR0FBRzs7Ozs7RUFLcEIsY0FBYyxDQUFDLFFBQVEsRUFBRTs7Ozs7OzREQU1pQyxDQUFDO2FBQ3REO1lBRUQsTUFBTSxJQUFJLEtBQUssQ0FBQyxXQUFXLENBQUMsQ0FBQztTQUM5QjtRQUVELE9BQU87WUFDTCxlQUFlO1lBQ2YsS0FBSztZQUNMLGFBQWEsRUFBRSxhQUFjO1lBQzdCLGVBQWUsRUFBRSxhQUFhLENBQUMsSUFBSSxFQUFFLGVBQWUsRUFBRSxjQUFlLENBQUM7U0FDdkUsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNLLEtBQUssQ0FBQyxnQ0FBZ0MsQ0FBQyx5QkFBMEM7UUFDdkYsTUFBTSx5QkFBeUIsR0FBRyx5QkFBeUIsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsb0JBQW9CLENBQUMsQ0FBQztRQUNqRyxJQUFJLHlCQUF5QixDQUFDLE1BQU0sRUFBRTtZQUNwQyxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsd0JBQXdCLENBQUMseUJBQXlCLENBQUMsQ0FBQztZQUNsRSx5QkFBeUIsQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsRUFBRTtnQkFDbkQsSUFBSSxDQUFDLEdBQUcsQ0FDTix5Q0FBeUMsZ0JBQWdCLENBQUMsZUFBZSxZQUN2RSxnQkFBZ0IsQ0FBQyxXQUNuQixtQkFBbUIsZ0JBQWdCLENBQUMsZUFBZSxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQ2pFLENBQUM7WUFDSixDQUFDLENBQUMsQ0FBQztTQUNKO1FBRUQsTUFBTSxhQUFhLEdBQVMseUJBQXlCLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQUMsYUFBYSxDQUFDLENBQUM7UUFDdkcsTUFBTSx1QkFBdUIsR0FBRyxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUMsK0JBQStCLENBQUMsYUFBYSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUM3Ryx1QkFBdUIsQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLENBQUMsRUFBRTtZQUNqRCxJQUFJLENBQUMsR0FBRyxDQUNOLDJDQUEyQyxnQkFBZ0IsQ0FBQyxlQUFlLFlBQ3pFLGdCQUFnQixDQUFDLFdBQ25CLG1CQUFtQixnQkFBZ0IsQ0FBQyxlQUFlLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FDakUsQ0FBQztRQUNKLENBQUMsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztDQUNGIn0=

package/dest/pxe_http/index.d.ts

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

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

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

package/dest/pxe_http/index.js

@@ -0,0 +1,2 @@
+export * from './pxe_http_server.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHhlX2h0dHAvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxzQkFBc0IsQ0FBQyJ9

package/dest/pxe_http/pxe_http_server.d.ts

@@ -0,0 +1,40 @@
+/// <reference types="node" resolution-mode="require"/>
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+import { PXE } from '@aztec/types';
+import http from 'http';
+export declare const localAnvil: {
+    readonly id: 31337;
+    readonly name: "Foundry";
+    readonly network: "foundry";
+    readonly nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+    };
+    readonly rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["http://127.0.0.1:8545"];
+            readonly webSocket: readonly ["ws://127.0.0.1:8545"];
+        };
+        readonly public: {
+            readonly http: readonly ["http://127.0.0.1:8545"];
+            readonly webSocket: readonly ["ws://127.0.0.1:8545"];
+        };
+    };
+} & {
+    formatters: import("viem").Formatters | undefined;
+    serializers: import("viem").Serializers<import("viem").Formatters> | undefined;
+};
+/**
+ * Wraps an instance of Private eXecution Environment (PXE) implementation to a JSON RPC HTTP interface.
+ * @returns A new instance of the HTTP server.
+ */
+export declare function createPXERpcServer(pxeService: PXE): JsonRpcServer;
+/**
+ * Creates an http server that forwards calls to the PXE and starts it on the given port.
+ * @param pxeService - PXE that answers queries to the created HTTP server.
+ * @param port - Port to listen in.
+ * @returns A running http server.
+ */
+export declare function startPXEHttpServer(pxeService: PXE, port: string | number): http.Server;
+//# sourceMappingURL=pxe_http_server.d.ts.map

package/dest/pxe_http/pxe_http_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pxe_http_server.d.ts","sourceRoot":"","sources":["../../src/pxe_http/pxe_http_server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EASL,GAAG,EAKJ,MAAM,cAAc,CAAC;AAEtB,OAAO,IAAI,MAAM,MAAM,CAAC;AAKxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;CAAU,CAAC;AAElC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG,aAAa,CAuBjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,CAQtF"}

package/dest/pxe_http/pxe_http_server.js

@@ -0,0 +1,44 @@
+import { AztecAddress } from '@aztec/foundation/aztec-address';
+import { Fr, GrumpkinScalar, Point } from '@aztec/foundation/fields';
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+import { AuthWitness, CompleteAddress, ContractData, ExtendedContractData, L2Block, L2BlockL2Logs, L2Tx, NotePreimage, Tx, TxExecutionRequest, TxHash, TxReceipt, } from '@aztec/types';
+import http from 'http';
+import { foundry } from 'viem/chains';
+import { EthAddress } from '../index.js';
+export const localAnvil = foundry;
+/**
+ * Wraps an instance of Private eXecution Environment (PXE) implementation to a JSON RPC HTTP interface.
+ * @returns A new instance of the HTTP server.
+ */
+export function createPXERpcServer(pxeService) {
+    return new JsonRpcServer(pxeService, {
+        CompleteAddress,
+        AztecAddress,
+        TxExecutionRequest,
+        ContractData,
+        ExtendedContractData,
+        TxHash,
+        EthAddress,
+        Point,
+        Fr,
+        GrumpkinScalar,
+        NotePreimage,
+        AuthWitness,
+        L2Block,
+        L2Tx,
+    }, { Tx, TxReceipt, L2BlockL2Logs }, false, ['start', 'stop']);
+}
+/**
+ * Creates an http server that forwards calls to the PXE and starts it on the given port.
+ * @param pxeService - PXE that answers queries to the created HTTP server.
+ * @param port - Port to listen in.
+ * @returns A running http server.
+ */
+export function startPXEHttpServer(pxeService, port) {
+    const rpcServer = createPXERpcServer(pxeService);
+    const app = rpcServer.getApp();
+    const httpServer = http.createServer(app.callback());
+    httpServer.listen(port);
+    return httpServer;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHhlX2h0dHBfc2VydmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3B4ZV9odHRwL3B4ZV9odHRwX3NlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDL0QsT0FBTyxFQUFFLEVBQUUsRUFBRSxjQUFjLEVBQUUsS0FBSyxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDckUsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLG1DQUFtQyxDQUFDO0FBQ2xFLE9BQU8sRUFDTCxXQUFXLEVBQ1gsZUFBZSxFQUNmLFlBQVksRUFDWixvQkFBb0IsRUFDcEIsT0FBTyxFQUNQLGFBQWEsRUFDYixJQUFJLEVBQ0osWUFBWSxFQUVaLEVBQUUsRUFDRixrQkFBa0IsRUFDbEIsTUFBTSxFQUNOLFNBQVMsR0FDVixNQUFNLGNBQWMsQ0FBQztBQUV0QixPQUFPLElBQUksTUFBTSxNQUFNLENBQUM7QUFDeEIsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUV0QyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRXpDLE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRyxPQUFPLENBQUM7QUFFbEM7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLGtCQUFrQixDQUFDLFVBQWU7SUFDaEQsT0FBTyxJQUFJLGFBQWEsQ0FDdEIsVUFBVSxFQUNWO1FBQ0UsZUFBZTtRQUNmLFlBQVk7UUFDWixrQkFBa0I7UUFDbEIsWUFBWTtRQUNaLG9CQUFvQjtRQUNwQixNQUFNO1FBQ04sVUFBVTtRQUNWLEtBQUs7UUFDTCxFQUFFO1FBQ0YsY0FBYztRQUNkLFlBQVk7UUFDWixXQUFXO1FBQ1gsT0FBTztRQUNQLElBQUk7S0FDTCxFQUNELEVBQUUsRUFBRSxFQUFFLFNBQVMsRUFBRSxhQUFhLEVBQUUsRUFDaEMsS0FBSyxFQUNMLENBQUMsT0FBTyxFQUFFLE1BQU0sQ0FBQyxDQUNsQixDQUFDO0FBQ0osQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLGtCQUFrQixDQUFDLFVBQWUsRUFBRSxJQUFxQjtJQUN2RSxNQUFNLFNBQVMsR0FBRyxrQkFBa0IsQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUVqRCxNQUFNLEdBQUcsR0FBRyxTQUFTLENBQUMsTUFBTSxFQUFFLENBQUM7SUFDL0IsTUFBTSxVQUFVLEdBQUcsSUFBSSxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQztJQUNyRCxVQUFVLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRXhCLE9BQU8sVUFBVSxDQUFDO0FBQ3BCLENBQUMifQ==

package/dest/pxe_service/create_pxe_service.d.ts

@@ -0,0 +1,30 @@
+import { AztecNode, KeyStore } from '@aztec/types';
+import { PXEServiceConfig } from '../config/index.js';
+import { Database } from '../database/index.js';
+import { PXEService } from './pxe_service.js';
+/**
+ * Optional information for creating an PXEService.
+ */
+interface CreatePXEServiceOptions {
+    /**
+     * A secure storage for cryptographic keys.
+     */
+    keyStore?: KeyStore;
+    /**
+     * Storage for the PXE.
+     */
+    db?: Database;
+}
+/**
+ * Create and start an PXEService instance with the given AztecNode.
+ * If no keyStore or database is provided, it will use TestKeyStore and MemoryDB as default values.
+ * Returns a Promise that resolves to the started PXEService instance.
+ *
+ * @param aztecNode - The AztecNode instance to be used by the server.
+ * @param config - The PXE Service Config to use
+ * @param options - (Optional) Optional information for creating an PXEService.
+ * @returns A Promise that resolves to the started PXEService instance.
+ */
+export declare function createPXEService(aztecNode: AztecNode, config: PXEServiceConfig, { keyStore, db }?: CreatePXEServiceOptions, useLogSuffix?: string | boolean | undefined): Promise<PXEService>;
+export {};
+//# sourceMappingURL=create_pxe_service.d.ts.map

package/dest/pxe_service/create_pxe_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_pxe_service.d.ts","sourceRoot":"","sources":["../../src/pxe_service/create_pxe_service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAY,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,UAAU,uBAAuB;IAC/B;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,gBAAgB,EACxB,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAE,uBAA4B,EAC9C,YAAY,GAAE,MAAM,GAAG,OAAO,GAAG,SAAqB,uBAevD"}

package/dest/pxe_service/create_pxe_service.js

@@ -0,0 +1,27 @@
+import { Grumpkin } from '@aztec/circuits.js/barretenberg';
+import { TestKeyStore } from '@aztec/key-store';
+import { MemoryDB } from '../database/index.js';
+import { PXEService } from './pxe_service.js';
+/**
+ * Create and start an PXEService instance with the given AztecNode.
+ * If no keyStore or database is provided, it will use TestKeyStore and MemoryDB as default values.
+ * Returns a Promise that resolves to the started PXEService instance.
+ *
+ * @param aztecNode - The AztecNode instance to be used by the server.
+ * @param config - The PXE Service Config to use
+ * @param options - (Optional) Optional information for creating an PXEService.
+ * @returns A Promise that resolves to the started PXEService instance.
+ */
+export async function createPXEService(aztecNode, config, { keyStore, db } = {}, useLogSuffix = undefined) {
+    const logSuffix = typeof useLogSuffix === 'boolean'
+        ? useLogSuffix
+            ? Math.random().toString(16).slice(2, 8)
+            : undefined
+        : useLogSuffix;
+    keyStore = keyStore || new TestKeyStore(await Grumpkin.new());
+    db = db || new MemoryDB(logSuffix);
+    const server = new PXEService(keyStore, aztecNode, db, config, logSuffix);
+    await server.start();
+    return server;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlX3B4ZV9zZXJ2aWNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3B4ZV9zZXJ2aWNlL2NyZWF0ZV9weGVfc2VydmljZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDM0QsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBSWhELE9BQU8sRUFBWSxRQUFRLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUMxRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFnQjlDOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsZ0JBQWdCLENBQ3BDLFNBQW9CLEVBQ3BCLE1BQXdCLEVBQ3hCLEVBQUUsUUFBUSxFQUFFLEVBQUUsS0FBOEIsRUFBRSxFQUM5QyxlQUE2QyxTQUFTO0lBRXRELE1BQU0sU0FBUyxHQUNiLE9BQU8sWUFBWSxLQUFLLFNBQVM7UUFDL0IsQ0FBQyxDQUFDLFlBQVk7WUFDWixDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUN4QyxDQUFDLENBQUMsU0FBUztRQUNiLENBQUMsQ0FBQyxZQUFZLENBQUM7SUFFbkIsUUFBUSxHQUFHLFFBQVEsSUFBSSxJQUFJLFlBQVksQ0FBQyxNQUFNLFFBQVEsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDO0lBQzlELEVBQUUsR0FBRyxFQUFFLElBQUksSUFBSSxRQUFRLENBQUMsU0FBUyxDQUFDLENBQUM7SUFFbkMsTUFBTSxNQUFNLEdBQUcsSUFBSSxVQUFVLENBQUMsUUFBUSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUUsTUFBTSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0lBQzFFLE1BQU0sTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQ3JCLE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMifQ==

package/dest/pxe_service/index.d.ts

@@ -0,0 +1,4 @@
+export * from './pxe_service.js';
+export * from './create_pxe_service.js';
+export { pxeTestSuite } from './test/pxe_test_suite.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pxe_service/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dest/pxe_service/index.js

@@ -0,0 +1,4 @@
+export * from './pxe_service.js';
+export * from './create_pxe_service.js';
+export { pxeTestSuite } from './test/pxe_test_suite.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcHhlX3NlcnZpY2UvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQyJ9

package/dest/pxe_service/pxe_service.d.ts

@@ -0,0 +1,70 @@
+/// <reference types="node" resolution-mode="require"/>
+import { AztecAddress, CompleteAddress, GrumpkinPrivateKey, PartialAddress } from '@aztec/circuits.js';
+import { Fr } from '@aztec/foundation/fields';
+import { AuthWitness, AztecNode, ContractData, DeployedContract, ExtendedContractData, KeyStore, L2Block, L2BlockL2Logs, L2Tx, NodeInfo, NotePreimage, PXE, Tx, TxExecutionRequest, TxHash, TxReceipt } from '@aztec/types';
+import { PXEServiceConfig } from '../config/index.js';
+import { Database } from '../database/index.js';
+/**
+ * A Private eXecution Environment (PXE) implementation.
+ */
+export declare class PXEService implements PXE {
+    #private;
+    private keyStore;
+    private node;
+    private db;
+    private config;
+    private synchronizer;
+    private contractDataOracle;
+    private simulator;
+    private log;
+    private sandboxVersion;
+    constructor(keyStore: KeyStore, node: AztecNode, db: Database, config: PXEServiceConfig, logSuffix?: string);
+    /**
+     * Starts the PXE Service by beginning the synchronisation process between the Aztec node and the database.
+     *
+     * @returns A promise that resolves when the server has started successfully.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the PXE Service, halting processing of new transactions and shutting down the synchronizer.
+     * This function ensures that all ongoing tasks are completed before stopping the server.
+     * It is useful for gracefully shutting down the server during maintenance or restarts.
+     *
+     * @returns A Promise resolving once the server has been stopped successfully.
+     */
+    stop(): Promise<void>;
+    addAuthWitness(witness: AuthWitness): Promise<void>;
+    registerAccount(privKey: GrumpkinPrivateKey, partialAddress: PartialAddress): Promise<void>;
+    getRegisteredAccounts(): Promise<CompleteAddress[]>;
+    getRegisteredAccount(address: AztecAddress): Promise<CompleteAddress | undefined>;
+    registerRecipient(recipient: CompleteAddress): Promise<void>;
+    getRecipients(): Promise<CompleteAddress[]>;
+    getRecipient(address: AztecAddress): Promise<CompleteAddress | undefined>;
+    addContracts(contracts: DeployedContract[]): Promise<void>;
+    getContracts(): Promise<AztecAddress[]>;
+    getPublicStorageAt(contract: AztecAddress, storageSlot: Fr): Promise<Buffer | undefined>;
+    getPrivateStorageAt(owner: AztecAddress, contract: AztecAddress, storageSlot: Fr): Promise<NotePreimage[]>;
+    addNote(account: AztecAddress, contractAddress: AztecAddress, storageSlot: Fr, preimage: NotePreimage, txHash: TxHash, nonce?: Fr): Promise<void>;
+    getNoteNonces(contractAddress: AztecAddress, storageSlot: Fr, preimage: NotePreimage, txHash: TxHash): Promise<Fr[]>;
+    getBlock(blockNumber: number): Promise<L2Block | undefined>;
+    simulateTx(txRequest: TxExecutionRequest, simulatePublic: boolean): Promise<Tx>;
+    sendTx(tx: Tx): Promise<TxHash>;
+    viewTx(functionName: string, args: any[], to: AztecAddress, _from?: AztecAddress): Promise<import("@aztec/foundation/abi").DecodedReturn>;
+    getTxReceipt(txHash: TxHash): Promise<TxReceipt>;
+    getTx(txHash: TxHash): Promise<L2Tx | undefined>;
+    getBlockNumber(): Promise<number>;
+    getExtendedContractData(contractAddress: AztecAddress): Promise<ExtendedContractData | undefined>;
+    getContractData(contractAddress: AztecAddress): Promise<ContractData | undefined>;
+    getUnencryptedLogs(from: number, limit: number): Promise<L2BlockL2Logs[]>;
+    getNodeInfo(): Promise<NodeInfo>;
+    private patchPublicCallStackOrdering;
+    isGlobalStateSynchronized(): Promise<boolean>;
+    isAccountStateSynchronized(account: AztecAddress): Promise<boolean>;
+    getSyncStatus(): Promise<{
+        blocks: number;
+        notes: {
+            [k: string]: number;
+        };
+    }>;
+}
+//# sourceMappingURL=pxe_service.d.ts.map

package/dest/pxe_service/pxe_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pxe_service.d.ts","sourceRoot":"","sources":["../../src/pxe_service/pxe_service.ts"],"names":[],"mappings":"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"}