@aztec/pxe 0.0.1-commit.321f6a9 → 0.0.1-commit.330febf

package/dest/contract_function_simulator/benchmarked_node.js

@@ -1,77 +0,0 @@
-import { Timer } from '@aztec/foundation/timer';
-export class BenchmarkedNodeFactory {
-    static create(node) {
-        // Per-method call stats
-        const perMethod = {};
-        // Round trip tracking
-        let inFlightCount = 0;
-        let currentRoundTripTimer = null;
-        let currentRoundTripMethods = [];
-        const roundTrips = {
-            roundTrips: 0,
-            totalBlockingTime: 0,
-            roundTripDurations: [],
-            roundTripMethods: []
-        };
-        return new Proxy(node, {
-            get (target, prop) {
-                if (prop === 'getStats') {
-                    return ()=>{
-                        return {
-                            perMethod,
-                            roundTrips
-                        };
-                    };
-                } else {
-                    return function(...args) {
-                        // Track per-method stats
-                        if (!perMethod[prop]) {
-                            perMethod[prop] = {
-                                times: []
-                            };
-                        }
-                        // Start of a new round trip batch?
-                        if (inFlightCount === 0) {
-                            roundTrips.roundTrips++;
-                            currentRoundTripTimer = new Timer();
-                            currentRoundTripMethods = [];
-                        }
-                        inFlightCount++;
-                        currentRoundTripMethods.push(prop);
-                        const callTimer = new Timer();
-                        const result = target[prop].apply(target, args);
-                        // Handle completion - called when the call finishes (after Promise resolves)
-                        const handleCompletion = ()=>{
-                            const callTime = callTimer.ms();
-                            perMethod[prop].times.push(callTime);
-                            inFlightCount--;
-                            // End of round trip batch - all concurrent calls completed
-                            if (inFlightCount === 0 && currentRoundTripTimer) {
-                                const roundTripTime = currentRoundTripTimer.ms();
-                                roundTrips.totalBlockingTime += roundTripTime;
-                                roundTrips.roundTripDurations.push(roundTripTime);
-                                roundTrips.roundTripMethods.push(currentRoundTripMethods);
-                                currentRoundTripTimer = null;
-                                currentRoundTripMethods = [];
-                            }
-                        };
-                        // If the result is a Promise, chain the completion handler
-                        if (result && typeof result.then === 'function') {
-                            return result.then((value)=>{
-                                handleCompletion();
-                                return value;
-                            }, (error)=>{
-                                handleCompletion();
-                                throw error;
-                            });
-                        } else {
-                            // Synchronous method - handle completion immediately
-                            handleCompletion();
-                            return result;
-                        }
-                    };
-                }
-            }
-        });
-    }
-}

package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts

@@ -1,17 +0,0 @@
-import type { AztecNode } from '@aztec/stdlib/interfaces/server';
-import { TxHash } from '@aztec/stdlib/tx';
-/** Classification of a batch of pending tx hashes by the status change implied by their receipts. */
-export type StatusChange = {
-    txHashesToFinalize: TxHash[];
-    txHashesToDrop: TxHash[];
-    txHashesWithExecutionReverted: TxHash[];
-};
-export declare const EMPTY_STATUS_CHANGE: StatusChange;
-/** Concatenates two status changes field-by-field. */
-export declare function mergeStatusChanges(a: StatusChange, b: StatusChange): StatusChange;
-/**
- * Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized,
- * dropped, or execution-reverted (but mined).
- */
-export declare function getStatusChangeOfPending(pending: TxHash[], aztecNode: AztecNode): Promise<StatusChange>;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0X3N0YXR1c19jaGFuZ2Vfb2ZfcGVuZGluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3RhZ2dpbmcvc2VuZGVyX3N5bmMvdXRpbHMvZ2V0X3N0YXR1c19jaGFuZ2Vfb2ZfcGVuZGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUNqRSxPQUFPLEVBQUUsTUFBTSxFQUFZLE1BQU0sa0JBQWtCLENBQUM7QUFFcEQscUdBQXFHO0FBQ3JHLE1BQU0sTUFBTSxZQUFZLEdBQUc7SUFDekIsa0JBQWtCLEVBQUUsTUFBTSxFQUFFLENBQUM7SUFDN0IsY0FBYyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQ3pCLDZCQUE2QixFQUFFLE1BQU0sRUFBRSxDQUFDO0NBQ3pDLENBQUM7QUFFRixlQUFPLE1BQU0sbUJBQW1CLEVBQUUsWUFJakMsQ0FBQztBQUVGLHNEQUFzRDtBQUN0RCx3QkFBZ0Isa0JBQWtCLENBQUMsQ0FBQyxFQUFFLFlBQVksRUFBRSxDQUFDLEVBQUUsWUFBWSxHQUFHLFlBQVksQ0FNakY7QUFFRDs7O0dBR0c7QUFDSCx3QkFBc0Isd0JBQXdCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFLFNBQVMsRUFBRSxTQUFTLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQW9DN0cifQ==

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

@@ -1 +0,0 @@
-{"version":3,"file":"get_status_change_of_pending.d.ts","sourceRoot":"","sources":["../../../../src/tagging/sender_sync/utils/get_status_change_of_pending.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAY,MAAM,kBAAkB,CAAC;AAEpD,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6BAA6B,EAAE,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAMjF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC7G"}

package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js

@@ -1,60 +0,0 @@
-import { TxStatus } from '@aztec/stdlib/tx';
-export const EMPTY_STATUS_CHANGE = {
-    txHashesToFinalize: [],
-    txHashesToDrop: [],
-    txHashesWithExecutionReverted: []
-};
-/** Concatenates two status changes field-by-field. */ export function mergeStatusChanges(a, b) {
-    return {
-        txHashesToFinalize: [
-            ...a.txHashesToFinalize,
-            ...b.txHashesToFinalize
-        ],
-        txHashesToDrop: [
-            ...a.txHashesToDrop,
-            ...b.txHashesToDrop
-        ],
-        txHashesWithExecutionReverted: [
-            ...a.txHashesWithExecutionReverted,
-            ...b.txHashesWithExecutionReverted
-        ]
-    };
-}
-/**
- * Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized,
- * dropped, or execution-reverted (but mined).
- */ export async function getStatusChangeOfPending(pending, aztecNode) {
-    // Get receipts for all pending tx hashes.
-    const receipts = await Promise.all(pending.map((pendingTxHash)=>aztecNode.getTxReceipt(pendingTxHash)));
-    const txHashesToFinalize = [];
-    const txHashesToDrop = [];
-    const txHashesWithExecutionReverted = [];
-    for(let i = 0; i < receipts.length; i++){
-        const receipt = receipts[i];
-        const txHash = pending[i];
-        if (receipt.status === TxStatus.FINALIZED) {
-            // Tx has been included in a block and the corresponding block is finalized
-            if (receipt.hasExecutionSucceeded()) {
-                // No part of execution reverted - we just finalize all the indexes.
-                txHashesToFinalize.push(txHash);
-            } else if (receipt.hasExecutionReverted()) {
-                // Tx was mined but execution reverted (app logic, teardown, or both). Some logs from the non-revertible
-                // phase may still be onchain. We check which tags made it onchain and finalize those; drop the rest.
-                txHashesWithExecutionReverted.push(txHash);
-            } else {
-                // Defensive check - this branch should never be triggered
-                throw new Error('Both hasExecutionSucceeded and hasExecutionReverted on the receipt returned false. This should never happen and it implies a bug. Please open an issue.');
-            }
-        } else if (receipt.isDropped()) {
-            // Tx was dropped from the mempool --> we drop the corresponding pending indexes.
-            txHashesToDrop.push(txHash);
-        } else {
-        // Tx is still pending, not yet finalized, or was mined successfully but not yet finalized --> we don't do anything.
-        }
-    }
-    return {
-        txHashesToFinalize,
-        txHashesToDrop,
-        txHashesWithExecutionReverted
-    };
-}

package/src/contract_function_simulator/aztec_node_read_cache.ts

@@ -1,89 +0,0 @@
-import { Fr } from '@aztec/foundation/curves/bn254';
-import type { AztecAddress } from '@aztec/stdlib/aztec-address';
-import type { BlockHash, BlockParameter } from '@aztec/stdlib/block';
-import type { AztecNode } from '@aztec/stdlib/interfaces/server';
-import type { TxHash } from '@aztec/stdlib/tx';
-
-/**
- * Per-execution cache for immutable Aztec node reads.
- */
-export class AztecNodeReadCache {
-  private readonly cache = new Map<string, Promise<unknown>>();
-
-  constructor(private readonly aztecNode: AztecNode) {}
-
-  /** Fetches a block without reissuing the same node request. */
-  public getBlock(block: BlockParameter) {
-    return this.#cachedRead(`block:${this.#keyPart(block)}`, () => this.aztecNode.getBlock(block));
-  }
-
-  /** Fetches a transaction receipt with its effect attached. */
-  public getTxReceiptWithEffect(txHash: TxHash) {
-    return this.#cachedRead(`tx-receipt-with-effect:${txHash.toString()}`, () =>
-      this.aztecNode.getTxReceipt(txHash, { includeTxEffect: true } as const),
-    );
-  }
-
-  /** Fetches an archive-tree witness for a block hash. */
-  public getBlockHashMembershipWitness(referenceBlock: BlockParameter, blockHash: BlockHash) {
-    return this.#cachedRead(
-      `block-hash-membership-witness:${this.#keyPart(referenceBlock)}:${blockHash.toString()}`,
-      () => this.aztecNode.getBlockHashMembershipWitness(referenceBlock, blockHash),
-    );
-  }
-
-  /** Fetches a public-data-tree witness for a leaf slot. */
-  public getPublicDataWitness(referenceBlock: BlockParameter, leafSlot: Fr) {
-    return this.#cachedRead(`public-data-witness:${this.#keyPart(referenceBlock)}:${leafSlot.toString()}`, () =>
-      this.aztecNode.getPublicDataWitness(referenceBlock, leafSlot),
-    );
-  }
-
-  /** Fetches public storage for a single slot. */
-  public getPublicStorageAt(referenceBlock: BlockParameter, contractAddress: AztecAddress, storageSlot: Fr) {
-    return this.#cachedRead(
-      `public-storage:${this.#keyPart(referenceBlock)}:${contractAddress.toString()}:${storageSlot.toString()}`,
-      () => this.aztecNode.getPublicStorageAt(referenceBlock, contractAddress, storageSlot),
-    );
-  }
-
-  /** Fetches a contiguous public storage range, reusing cached reads for overlapping slots. */
-  public getPublicStorageRange(
-    referenceBlock: BlockParameter,
-    contractAddress: AztecAddress,
-    startStorageSlot: Fr,
-    numberOfElements: number,
-  ) {
-    const slots = Array(numberOfElements)
-      .fill(0)
-      .map((_, i) => new Fr(startStorageSlot.value + BigInt(i)));
-
-    return Promise.all(slots.map(storageSlot => this.getPublicStorageAt(referenceBlock, contractAddress, storageSlot)));
-  }
-
-  #cachedRead<T>(key: string, fetch: () => Promise<T>): Promise<T> {
-    const cached = this.cache.get(key);
-    if (cached) {
-      return cached as Promise<T>;
-    }
-
-    const promise = fetch();
-    promise.catch(() => this.cache.delete(key));
-    this.cache.set(key, promise);
-    return promise;
-  }
-
-  #keyPart(value: unknown): string {
-    if (['string', 'number', 'bigint', 'boolean'].includes(typeof value)) {
-      return String(value);
-    }
-    if (value && typeof value === 'object') {
-      const toString = (value as { toString?: () => string }).toString;
-      if (toString && toString !== Object.prototype.toString) {
-        return toString.call(value);
-      }
-      return JSON.stringify(value, (_key, nested) => (typeof nested === 'bigint' ? nested.toString() : nested));
-    }
-    return String(value);
-  }
-}

package/src/contract_function_simulator/benchmarked_node.ts

@@ -1,103 +0,0 @@
-import { Timer } from '@aztec/foundation/timer';
-import type { AztecNode } from '@aztec/stdlib/interfaces/client';
-import type { NodeStats, RoundTripStats } from '@aztec/stdlib/tx';
-
-/*
- * Proxy generator for an AztecNode that tracks the time taken for each RPC call and the number of round trips (actual
- * blocking waits for node responses).
- *
- * A round trip is counted when we transition from 0 to 1 in-flight calls, and ends when all concurrent calls complete.
- * This means parallel calls in Promise.all count as a single round trip.
- *
- * Note that batching of RPC calls in `safe_json_rpc_client.ts` could affect the round trip counts but in places we
- * currently use this information we do not even use HTTP as we have direct access to the Aztec Node instance in TS
- * (i.e. not running against external node) so this is not a problem for now.
- *
- * If you want to use this against external node and the info gets skewed by batching you can set the `maxBatchSize`
- * value in `safe_json_rpc_client.ts` to 1 (the main motivation for batching was to get around parallel http requests
- * limits in web browsers which is not a problem when debugging in node.js).
- */
-export type BenchmarkedNode = AztecNode & { getStats(): NodeStats };
-
-export class BenchmarkedNodeFactory {
-  static create(node: AztecNode): BenchmarkedNode {
-    // Per-method call stats
-    const perMethod: Partial<Record<keyof AztecNode, { times: number[] }>> = {};
-
-    // Round trip tracking
-    let inFlightCount = 0;
-    let currentRoundTripTimer: Timer | null = null;
-    let currentRoundTripMethods: string[] = [];
-    const roundTrips: RoundTripStats = {
-      roundTrips: 0,
-      totalBlockingTime: 0,
-      roundTripDurations: [],
-      roundTripMethods: [],
-    };
-
-    return new Proxy(node, {
-      get(target, prop: keyof BenchmarkedNode) {
-        if (prop === 'getStats') {
-          return (): NodeStats => {
-            return { perMethod, roundTrips };
-          };
-        } else {
-          return function (...args: any[]) {
-            // Track per-method stats
-            if (!perMethod[prop]) {
-              perMethod[prop] = { times: [] };
-            }
-
-            // Start of a new round trip batch?
-            if (inFlightCount === 0) {
-              roundTrips.roundTrips++;
-              currentRoundTripTimer = new Timer();
-              currentRoundTripMethods = [];
-            }
-            inFlightCount++;
-            currentRoundTripMethods.push(prop);
-
-            const callTimer = new Timer();
-            const result = (target[prop] as any).apply(target, args);
-
-            // Handle completion - called when the call finishes (after Promise resolves)
-            const handleCompletion = () => {
-              const callTime = callTimer.ms();
-              perMethod[prop]!.times.push(callTime);
-
-              inFlightCount--;
-
-              // End of round trip batch - all concurrent calls completed
-              if (inFlightCount === 0 && currentRoundTripTimer) {
-                const roundTripTime = currentRoundTripTimer.ms();
-                roundTrips.totalBlockingTime += roundTripTime;
-                roundTrips.roundTripDurations.push(roundTripTime);
-                roundTrips.roundTripMethods.push(currentRoundTripMethods);
-                currentRoundTripTimer = null;
-                currentRoundTripMethods = [];
-              }
-            };
-
-            // If the result is a Promise, chain the completion handler
-            if (result && typeof result.then === 'function') {
-              return result.then(
-                (value: any) => {
-                  handleCompletion();
-                  return value;
-                },
-                (error: any) => {
-                  handleCompletion();
-                  throw error;
-                },
-              );
-            } else {
-              // Synchronous method - handle completion immediately
-              handleCompletion();
-              return result;
-            }
-          };
-        }
-      },
-    }) as BenchmarkedNode;
-  }
-}

package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts

@@ -1,66 +0,0 @@
-import type { AztecNode } from '@aztec/stdlib/interfaces/server';
-import { TxHash, TxStatus } from '@aztec/stdlib/tx';
-
-/** Classification of a batch of pending tx hashes by the status change implied by their receipts. */
-export type StatusChange = {
-  txHashesToFinalize: TxHash[];
-  txHashesToDrop: TxHash[];
-  txHashesWithExecutionReverted: TxHash[];
-};
-
-export const EMPTY_STATUS_CHANGE: StatusChange = {
-  txHashesToFinalize: [],
-  txHashesToDrop: [],
-  txHashesWithExecutionReverted: [],
-};
-
-/** Concatenates two status changes field-by-field. */
-export function mergeStatusChanges(a: StatusChange, b: StatusChange): StatusChange {
-  return {
-    txHashesToFinalize: [...a.txHashesToFinalize, ...b.txHashesToFinalize],
-    txHashesToDrop: [...a.txHashesToDrop, ...b.txHashesToDrop],
-    txHashesWithExecutionReverted: [...a.txHashesWithExecutionReverted, ...b.txHashesWithExecutionReverted],
-  };
-}
-
-/**
- * Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized,
- * dropped, or execution-reverted (but mined).
- */
-export async function getStatusChangeOfPending(pending: TxHash[], aztecNode: AztecNode): Promise<StatusChange> {
-  // Get receipts for all pending tx hashes.
-  const receipts = await Promise.all(pending.map(pendingTxHash => aztecNode.getTxReceipt(pendingTxHash)));
-
-  const txHashesToFinalize: TxHash[] = [];
-  const txHashesToDrop: TxHash[] = [];
-  const txHashesWithExecutionReverted: TxHash[] = [];
-
-  for (let i = 0; i < receipts.length; i++) {
-    const receipt = receipts[i];
-    const txHash = pending[i];
-
-    if (receipt.status === TxStatus.FINALIZED) {
-      // Tx has been included in a block and the corresponding block is finalized
-      if (receipt.hasExecutionSucceeded()) {
-        // No part of execution reverted - we just finalize all the indexes.
-        txHashesToFinalize.push(txHash);
-      } else if (receipt.hasExecutionReverted()) {
-        // Tx was mined but execution reverted (app logic, teardown, or both). Some logs from the non-revertible
-        // phase may still be onchain. We check which tags made it onchain and finalize those; drop the rest.
-        txHashesWithExecutionReverted.push(txHash);
-      } else {
-        // Defensive check - this branch should never be triggered
-        throw new Error(
-          'Both hasExecutionSucceeded and hasExecutionReverted on the receipt returned false. This should never happen and it implies a bug. Please open an issue.',
-        );
-      }
-    } else if (receipt.isDropped()) {
-      // Tx was dropped from the mempool --> we drop the corresponding pending indexes.
-      txHashesToDrop.push(txHash);
-    } else {
-      // Tx is still pending, not yet finalized, or was mined successfully but not yet finalized --> we don't do anything.
-    }
-  }
-
-  return { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted };
-}