@aztec/aztec 0.0.1-commit.2f68f620 → 0.0.1-commit.321f6a9

package/src/testing/cheat_codes.ts

@@ -1,132 +1,48 @@
 import { EthCheatCodes, RollupCheatCodes } from '@aztec/ethereum/test';
-import { SlotNumber } from '@aztec/foundation/branded-types';
-import { createLogger } from '@aztec/foundation/log';
 import type { DateProvider } from '@aztec/foundation/timer';
-import type { AutomineSequencer } from '@aztec/sequencer-client';
 import type { AztecNode, AztecNodeDebug } from '@aztec/stdlib/interfaces/client';
 
 /**
- * A class that provides utility functions for interacting with the chain.
- * @deprecated There used to be 3 kinds of cheat codes: eth, rollup and aztec. We have nuked the Aztec ones because
- * they became unused (we now have better testing tools). If you are introducing a new functionality to the cheat
- * codes, please consider whether it makes sense to just introduce new utils in your tests instead.
+ * Wrapper for Aztec Debug API.
+ * @deprecated use the AztecNode debug API directly.
  */
 export class CheatCodes {
-  private logger = createLogger('aztecjs:cheat_codes');
-
   constructor(
     /** Cheat codes for L1.*/
     public eth: EthCheatCodes,
     /** Cheat codes for the Aztec Rollup contract on L1. */
     public rollup: RollupCheatCodes,
-    /** When wired, redirects time-warps through the AutomineSequencer queue (test-only). */
-    private automine?: AutomineSequencer,
   ) {}
 
-  static async create(
-    rpcUrls: string[],
-    node: AztecNode,
-    dateProvider: DateProvider,
-    automine?: AutomineSequencer,
-  ): Promise<CheatCodes> {
+  static async create(rpcUrls: string[], node: AztecNode, dateProvider: DateProvider): Promise<CheatCodes> {
     const ethCheatCodes = new EthCheatCodes(rpcUrls, dateProvider);
     const rollupCheatCodes = new RollupCheatCodes(
       ethCheatCodes,
       await node.getNodeInfo().then(n => n.l1ContractAddresses),
     );
-    return new CheatCodes(ethCheatCodes, rollupCheatCodes, automine);
+    return new CheatCodes(ethCheatCodes, rollupCheatCodes);
   }
 
   /**
-   * Warps the L1 timestamp to a target timestamp and mines an L2 block that advances the L2 timestamp to at least
-   * the target timestamp. If the target timestamp falls within the current L2 slot (which already has a block),
-   * the timestamp is automatically adjusted forward to the start of the next slot so that `mineBlock()` succeeds.
-   * @param node - The Aztec node used to force an empty block to be mined.
-   * @param targetTimestamp - The target timestamp to warp to (in seconds)
+   * Warps the L1 timestamp to at least `targetTimestamp` and mines an L2 block advancing the L2 timestamp to at least
+   * the target. Forwards to the node's debug API, which serializes the warp through the automine sequencer queue.
+   * @param node - The Aztec node whose debug API performs the warp. Must run an automine sequencer.
+   * @param targetTimestamp - The target timestamp to warp to (in seconds).
+   * @deprecated Call `node.warpL2TimeAtLeastTo(targetTimestamp)` on the node debug API directly.
    */
-  async warpL2TimeAtLeastTo(node: AztecNode & AztecNodeDebug, targetTimestamp: bigint | number) {
-    const targetBigInt = BigInt(targetTimestamp);
-    const currentTimestamp = BigInt(await this.eth.lastBlockTimestamp());
-
-    if (targetBigInt <= currentTimestamp) {
-      throw new Error(
-        `warpL2TimeAtLeastTo: target timestamp ${targetBigInt} is not in the future (current L1 timestamp is ${currentTimestamp}).`,
-      );
-    }
-
-    // AutomineSequencer owns time control through its serial queue — delegate to keep warps atomic
-    // with respect to any in-flight build, and avoid the mineBlock-loop hack below.
-    // `warpTo` internally builds an empty L2 checkpoint, which auto-mines exactly one L1 block at
-    // the target slot boundary, so no separate `node.mineBlock()` is needed here.
-    if (this.automine) {
-      await this.automine.warpTo(Number(targetBigInt));
-      return;
-    }
-
-    const currentSlot = await this.rollup.getSlot();
-    const targetSlot = await this.rollup.getSlotAt(targetBigInt);
-
-    let effectiveTimestamp = targetBigInt;
-    let effectiveTargetSlot = targetSlot;
-
-    if (targetSlot <= currentSlot) {
-      // Target lands in the same (or earlier) slot — auto-adjust to the next slot's start.
-      const nextSlot = SlotNumber(currentSlot + 1);
-      const nextSlotTimestamp = await this.rollup.getTimestampForSlot(nextSlot);
-      this.logger.warn(
-        `warpL2TimeAtLeastTo: target timestamp ${targetBigInt} falls in current slot ${currentSlot}. ` +
-          `Auto-adjusting to start of slot ${nextSlot} at timestamp ${nextSlotTimestamp}.`,
-      );
-      effectiveTimestamp = nextSlotTimestamp;
-      effectiveTargetSlot = nextSlot;
-    }
-
-    await this.eth.warp(effectiveTimestamp, { resetBlockInterval: true });
-
-    // The sequencer's polling loop may have a `work()` cycle in flight that captured pre-warp slot/timestamp values
-    // just before our warp landed. That cycle would mine an L2 block at the stale slot — the L1 sync prunes such a
-    // block from the canonical chain, but it lingers in local world state and the PXE will use it as the anchor for
-    // subsequent txs, leading to `expiration_timestamp` values that are already in the past relative to L1. Mine
-    // until we observe an L2 block at (or past) the post-warp slot, ensuring the next tx anchors to a fresh block.
-    const maxAttempts = 5;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-      await node.mineBlock();
-      const blockData = await node.getBlockData('latest');
-      const blockSlot = blockData?.header.globalVariables.slotNumber;
-      if (blockSlot !== undefined && BigInt(blockSlot) >= BigInt(effectiveTargetSlot)) {
-        return;
-      }
-      this.logger.warn(
-        `warpL2TimeAtLeastTo: mined L2 block at slot ${blockSlot}, expected at least ${effectiveTargetSlot}. ` +
-          `Retrying mineBlock (attempt ${attempt}/${maxAttempts}).`,
-      );
-    }
-    throw new Error(
-      `warpL2TimeAtLeastTo: failed to mine an L2 block at or past slot ${effectiveTargetSlot} after ${maxAttempts} attempts.`,
-    );
+  warpL2TimeAtLeastTo(node: AztecNode & AztecNodeDebug, targetTimestamp: bigint | number): Promise<void> {
+    return node.warpL2TimeAtLeastTo(Number(targetTimestamp));
   }
 
   /**
-   * Warps the L1 timestamp forward by a specified duration and mines an L2 block that advances the L2 timestamp at
-   * least by the duration. If the duration is too short to cross an L2 slot boundary, the warp is automatically
-   * extended to the start of the next slot so that `mineBlock()` succeeds.
-   * @param node - The Aztec node used to force an empty block to be mined.
-   * @param duration - The duration to advance time by (in seconds)
+   * Warps the L1 timestamp forward by at least `duration` seconds and mines an L2 block advancing the L2 timestamp at
+   * least by the duration. Forwards to the node's debug API, which serializes the warp through the automine sequencer
+   * queue.
+   * @param node - The Aztec node whose debug API performs the warp. Must run an automine sequencer.
+   * @param duration - The duration to advance time by (in seconds).
+   * @deprecated Call `node.warpL2TimeAtLeastBy(duration)` on the node debug API directly.
    */
-  async warpL2TimeAtLeastBy(node: AztecNode & AztecNodeDebug, duration: bigint | number) {
-    if (BigInt(duration) <= 0n) {
-      throw new Error(`warpL2TimeAtLeastBy: duration must be positive, got ${duration} seconds.`);
-    }
-
-    // Advance relative to whichever clock leads. A live sequencer mines L2 blocks at slot boundaries that can run
-    // ahead of anvil's L1 timestamp, so basing the target on L1 alone would advance the L2 timestamp by less than
-    // `duration`. Anchoring to the latest L2 block timestamp when it leads guarantees the post-warp L2 block is at
-    // least `duration` ahead of the current one.
-    const currentL1Timestamp = BigInt(await this.eth.lastBlockTimestamp());
-    const latestBlockData = await node.getBlockData('latest');
-    const latestL2Timestamp = latestBlockData ? BigInt(latestBlockData.header.globalVariables.timestamp) : 0n;
-    const baseTimestamp = latestL2Timestamp > currentL1Timestamp ? latestL2Timestamp : currentL1Timestamp;
-    const targetTimestamp = baseTimestamp + BigInt(duration);
-    await this.warpL2TimeAtLeastTo(node, targetTimestamp);
+  warpL2TimeAtLeastBy(node: AztecNode & AztecNodeDebug, duration: bigint | number): Promise<void> {
+    return node.warpL2TimeAtLeastBy(Number(duration));
   }
 }

package/src/testing/epoch_test_settler.ts

@@ -1,10 +1,9 @@
-import { Fr } from '@aztec/aztec.js/fields';
 import { type EthCheatCodes, RollupCheatCodes } from '@aztec/ethereum/test';
-import { type EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import type { EpochNumber } from '@aztec/foundation/branded-types';
 import type { Logger } from '@aztec/foundation/log';
+import { settleEpochOutbox } from '@aztec/prover-client/test';
 import { EpochMonitor } from '@aztec/prover-node';
 import type { EthAddress, L2BlockSource } from '@aztec/stdlib/block';
-import { computeEpochOutHash } from '@aztec/stdlib/messaging';
 
 export class EpochTestSettler {
   private rollupCheatCodes: RollupCheatCodes;
@@ -31,33 +30,12 @@ export class EpochTestSettler {
   }
 
   async handleEpochReadyToProve(epoch: EpochNumber): Promise<boolean> {
-    const blocks = await this.l2BlockSource.getBlocks({ epoch, onlyCheckpointed: true });
-    this.log.info(
-      `Settling epoch ${epoch} with blocks ${blocks[0]?.header.getBlockNumber()} to ${blocks.at(-1)?.header.getBlockNumber()}`,
-      { blocks: blocks.map(b => b.toBlockInfo()) },
-    );
-    const messagesInEpoch: Fr[][][][] = [];
-    let previousSlotNumber = SlotNumber.ZERO;
-    let checkpointIndex = -1;
-
-    for (const block of blocks) {
-      const slotNumber = block.header.globalVariables.slotNumber;
-      if (slotNumber !== previousSlotNumber) {
-        checkpointIndex++;
-        messagesInEpoch[checkpointIndex] = [];
-        previousSlotNumber = slotNumber;
-      }
-      messagesInEpoch[checkpointIndex].push(block.body.txEffects.map(txEffect => txEffect.l2ToL1Msgs));
-    }
-
-    const outHash = computeEpochOutHash(messagesInEpoch);
-    if (!outHash.isZero()) {
-      await this.rollupCheatCodes.insertOutbox(epoch, messagesInEpoch.length, outHash.toBigInt());
-    } else {
-      this.log.info(`No L2 to L1 messages in epoch ${epoch}`);
-    }
-
-    const lastCheckpoint = blocks.at(-1)?.checkpointNumber;
+    const lastCheckpoint = await settleEpochOutbox({
+      rollupCheatCodes: this.rollupCheatCodes,
+      l2BlockSource: this.l2BlockSource,
+      epoch,
+      log: this.log,
+    });
     if (lastCheckpoint !== undefined) {
       await this.rollupCheatCodes.markAsProven(lastCheckpoint);
     } else {

package/src/testing/index.ts

@@ -1,5 +1,5 @@
-export { AnvilTestWatcher, type AnvilTestWatcherOpts } from './anvil_test_watcher.js';
 export { EthCheatCodes, RollupCheatCodes } from '@aztec/ethereum/test';
 export { CheatCodes } from './cheat_codes.js';
 export { EpochTestSettler } from './epoch_test_settler.js';
+export { setupLocalNetwork, TEST_FEE_PADDING, type LocalNetwork, type LocalNetworkOptions } from './local-network.js';
 export { getTokenAllowedSetupFunctions } from './token_allowed_setup.js';

package/src/testing/local-network.ts

@@ -0,0 +1,97 @@
+import type { AztecNodeService } from '@aztec/aztec-node';
+import type { AztecNodeConfig } from '@aztec/aztec-node/config';
+import type { Fr } from '@aztec/aztec.js/fields';
+import { startAnvil } from '@aztec/ethereum/test';
+import type { AztecAddress } from '@aztec/stdlib/aztec-address';
+
+import { foundry } from 'viem/chains';
+
+import { createLocalNetwork } from '../local-network/local-network.js';
+
+/** A running in-process local network: an inline Aztec node backed by its own anvil L1. */
+export interface LocalNetwork extends AsyncDisposable {
+  /** Fully-synced Aztec node, ready to serve client requests. */
+  node: AztecNodeService;
+  /** RPC URL of the spawned anvil instance. */
+  l1RpcUrl: string;
+  /** Chain id used on L1 (foundry's default 31337). */
+  l1ChainId: number;
+  /** Stops every process started by the fixture: node and anvil. Also invoked by `await using`. */
+  stop: () => Promise<void>;
+}
+
+/** Options for {@link setupLocalNetwork}. */
+export interface LocalNetworkOptions {
+  /**
+   * Addresses that should hold fee juice at genesis. Saves each of these the round-trip of bridging
+   * + claiming fee juice before they can pay for gas.
+   */
+  fundedAddresses?: AztecAddress[];
+  /** Override the default per-address genesis fee juice granted to {@link fundedAddresses}. */
+  initialAccountFeeJuice?: Fr;
+  /** Node config overrides, e.g. `realProofs`, `aztecEpochDuration`, `p2pEnabled`. */
+  config?: Partial<AztecNodeConfig>;
+}
+
+/**
+ * Spin up an in-process local network with the given addresses pre-funded.
+ *
+ * Each call spawns its own anvil on an OS-assigned random port and runs the Aztec node inline via
+ * the same {@link createLocalNetwork} codepath that backs `aztec start --local-network` (with the
+ * sandbox account/FPC/token setup skipped). Distinct ports let independent suites run in parallel.
+ * The caller must `await result.stop()` in its teardown (or hold the result with `await using`).
+ *
+ * Requires a Foundry toolchain (`anvil`/`forge`), installed via `aztec-up` or `foundryup`. Binaries
+ * are located in the standard install directories or on `PATH`; set `$ANVIL_BIN` / `$FORGE_BIN` to
+ * pin specific ones.
+ */
+export async function setupLocalNetwork(opts: LocalNetworkOptions = {}): Promise<LocalNetwork> {
+  // `--port 0` → anvil binds an ephemeral port that `startAnvil` reads back, so parallel suites
+  // never collide on a fixed port.
+  const { rpcUrl, stop: stopAnvil } = await startAnvil({ port: 0 });
+
+  try {
+    const { node, stop: stopNode } = await createLocalNetwork(
+      {
+        ...opts.config,
+        l1RpcUrls: [rpcUrl],
+        testAccounts: false,
+        prefundAddresses: (opts.fundedAddresses ?? []).map(a => a.toString()),
+        initialAccountFeeJuice: opts.initialAccountFeeJuice,
+      },
+      () => {},
+    );
+
+    // Stop the node before anvil (its teardown still talks to L1); the finally guarantees anvil is
+    // reaped even if node shutdown throws.
+    const stop = async () => {
+      try {
+        await stopNode();
+      } finally {
+        await stopAnvil();
+      }
+    };
+
+    return {
+      node,
+      l1RpcUrl: rpcUrl,
+      l1ChainId: foundry.id,
+      stop,
+      [Symbol.asyncDispose]: stop,
+    };
+  } catch (err) {
+    await stopAnvil();
+    throw err;
+  }
+}
+
+/**
+ * Min-fee padding multiplier for test wallets whose txs may mine well after their fee estimate.
+ * The automine sequencer builds one block per tx and advances L1 time in big jumps, and proposer
+ * pipelining evolves the fee-asset price across the build/publish gap (~20x observed in CI), so the
+ * network's congestion base fee can swing sharply between the wallet's fee estimate and the block
+ * the tx actually lands in. The default wallet padding isn't enough and trips
+ * `maxFeesPerGas.feePerL2Gas must be >= gasFees.feePerL2Gas`. Apply via
+ * `wallet.setMinFeePadding(TEST_FEE_PADDING)` on every test wallet that sends txs.
+ */
+export const TEST_FEE_PADDING = 30;

package/src/testing/token_allowed_setup.ts

@@ -1,19 +1,26 @@
 import { TokenContractArtifact } from '@aztec/noir-contracts.js/Token';
 import { buildAllowedElement } from '@aztec/p2p/msg_validators';
+import type { ContractArtifact } from '@aztec/stdlib/abi';
 import { getContractClassFromArtifact } from '@aztec/stdlib/contract';
 import type { AllowedElement } from '@aztec/stdlib/interfaces/server';
 
 /**
- * Returns Token-specific allowlist entries needed for FPC-based fee payments.
- * These are test-only: FPC-based fee payment with custom tokens won't work on mainnet alpha.
+ * Returns the allowlist entries needed for FPC-based fee payments, keyed by the contract class of
+ * the `artifact` actually deployed as the fee token (defaults to canonical Token). The setup-phase
+ * validator matches these entries by class id, so a test deploying the codegen'd TestToken as its
+ * fee vehicle must pass `TestTokenContract.artifact` here -- otherwise the FPC fee calls are matched
+ * against the wrong class and rejected. Test-only: FPC fee payment with custom tokens won't work on
+ * mainnet alpha.
  */
-export async function getTokenAllowedSetupFunctions(): Promise<AllowedElement[]> {
-  const tokenClassId = (await getContractClassFromArtifact(TokenContractArtifact)).id;
+export async function getTokenAllowedSetupFunctions(
+  artifact: ContractArtifact = TokenContractArtifact,
+): Promise<AllowedElement[]> {
+  const tokenClassId = (await getContractClassFromArtifact(artifact)).id;
   const target = { classId: tokenClassId };
   return Promise.all([
-    // Token: needed for private transfers via FPC (transfer_to_public enqueues this)
-    buildAllowedElement(TokenContractArtifact, target, '_increase_public_balance', { onlySelf: true }),
-    // Token: needed for public transfers via FPC (fee_entrypoint_public enqueues this)
-    buildAllowedElement(TokenContractArtifact, target, 'transfer_in_public'),
+    // needed for private transfers via FPC (transfer_to_public enqueues this)
+    buildAllowedElement(artifact, target, '_increase_public_balance', { onlySelf: true }),
+    // needed for public transfers via FPC (fee_entrypoint_public enqueues this)
+    buildAllowedElement(artifact, target, 'transfer_in_public'),
   ]);
 }

package/dest/testing/anvil_test_watcher.d.ts

@@ -1,54 +0,0 @@
-import { EthCheatCodes } from '@aztec/ethereum/test';
-import type { ViemClient } from '@aztec/ethereum/types';
-import type { EthAddress } from '@aztec/foundation/eth-address';
-import type { TestDateProvider } from '@aztec/foundation/timer';
-export type AnvilTestWatcherOpts = {
-    isLocalNetwork?: boolean;
-    isMarkingAsProven?: boolean;
-};
-/**
- * Represents a watcher for a rollup contract.
- *
- * It started on a network like anvil where time traveling is allowed, and auto-mine is turned on
- * it will periodically check if the current slot have already been filled, e.g., there was an L2
- * block within the slot. And if so, it will time travel into the next slot.
- */
-export declare class AnvilTestWatcher {
-    private cheatcodes;
-    private dateProvider?;
-    private isLocalNetwork;
-    private isMarkingAsProven;
-    private rollup;
-    private rollupCheatCodes;
-    private l2SlotDuration;
-    private filledRunningPromise?;
-    private syncDateProviderPromise?;
-    private markingAsProvenRunningPromise?;
-    private logger;
-    private getPendingTxCount?;
-    private isSequencerBuilding?;
-    private unfilledSlotFirstSeen?;
-    private proposedTargetSlot?;
-    constructor(cheatcodes: EthCheatCodes, rollupAddress: EthAddress, l1Client: ViemClient, dateProvider?: TestDateProvider | undefined, opts?: AnvilTestWatcherOpts);
-    setIsMarkingAsProven(isMarkingAsProven: boolean): void;
-    setisLocalNetwork(isLocalNetwork: boolean): void;
-    /** Sets a callback to check for pending txs, used to skip unfilled slots faster when txs are waiting. */
-    setGetPendingTxCount(fn: () => Promise<number>): void;
-    /** Sets a callback to check if the sequencer is actively building, to avoid warping while it works. */
-    setIsSequencerBuilding(fn: () => boolean): void;
-    /**
-     * Records the target slot for which the proposer has built a block destined for L1. Used by
-     * the local-network watcher to fast-forward L1 (and the injected date provider) ahead of the
-     * pipelined publisher's `sendRequestsAt` sleep so it ends promptly instead of waiting a full
-     * wall-clock slot. Only ratchets up — late warps for stale slots are no-ops.
-     */
-    setProposedTargetSlot(slot: number): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    trigger(): Promise<void>;
-    markAsProven(): Promise<void>;
-    syncDateProviderToL1IfBehind(): Promise<void>;
-    warpTimeIfNeeded(): Promise<void>;
-    private warpToTimestamp;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYW52aWxfdGVzdF93YXRjaGVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVzdGluZy9hbnZpbF90ZXN0X3dhdGNoZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBb0IsTUFBTSxzQkFBc0IsQ0FBQztBQUN2RSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUV4RCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUdoRSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBS2hFLE1BQU0sTUFBTSxvQkFBb0IsR0FBRztJQUNqQyxjQUFjLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDekIsaUJBQWlCLENBQUMsRUFBRSxPQUFPLENBQUM7Q0FDN0IsQ0FBQztBQUVGOzs7Ozs7R0FNRztBQUNILHFCQUFhLGdCQUFnQjtJQThCekIsT0FBTyxDQUFDLFVBQVU7SUFHbEIsT0FBTyxDQUFDLFlBQVksQ0FBQztJQWhDdkIsT0FBTyxDQUFDLGNBQWMsQ0FBQztJQUN2QixPQUFPLENBQUMsaUJBQWlCLENBQUM7SUFFMUIsT0FBTyxDQUFDLE1BQU0sQ0FBc0Q7SUFDcEUsT0FBTyxDQUFDLGdCQUFnQixDQUFtQjtJQUMzQyxPQUFPLENBQUMsY0FBYyxDQUFVO0lBRWhDLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQUFpQjtJQUM5QyxPQUFPLENBQUMsdUJBQXVCLENBQUMsQ0FBaUI7SUFDakQsT0FBTyxDQUFDLDZCQUE2QixDQUFDLENBQWlCO0lBRXZELE9BQU8sQ0FBQyxNQUFNLENBQWlEO0lBRy9ELE9BQU8sQ0FBQyxpQkFBaUIsQ0FBQyxDQUF3QjtJQUdsRCxPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0FBZ0I7SUFHNUMsT0FBTyxDQUFDLHFCQUFxQixDQUFDLENBQXFDO0lBTW5FLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFTO0lBRXBDLFlBQ1UsVUFBVSxFQUFFLGFBQWEsRUFDakMsYUFBYSxFQUFFLFVBQVUsRUFDekIsUUFBUSxFQUFFLFVBQVUsRUFDWixZQUFZLENBQUMsOEJBQWtCLEVBQ3ZDLElBQUksR0FBRSxvQkFBeUIsRUFnQmhDO0lBRUQsb0JBQW9CLENBQUMsaUJBQWlCLEVBQUUsT0FBTyxRQUc5QztJQUVELGlCQUFpQixDQUFDLGNBQWMsRUFBRSxPQUFPLFFBRXhDO0lBRUQseUdBQXlHO0lBQ3pHLG9CQUFvQixDQUFDLEVBQUUsRUFBRSxNQUFNLE9BQU8sQ0FBQyxNQUFNLENBQUMsUUFFN0M7SUFFRCx1R0FBdUc7SUFDdkcsc0JBQXNCLENBQUMsRUFBRSxFQUFFLE1BQU0sT0FBTyxRQUV2QztJQUVEOzs7OztPQUtHO0lBQ0gscUJBQXFCLENBQUMsSUFBSSxFQUFFLE1BQU0sUUFJakM7SUFFSyxLQUFLLGtCQXlCVjtJQUVLLElBQUksa0JBSVQ7SUFFSyxPQUFPLGtCQUlaO0lBRUssWUFBWSxrQkFLakI7SUFFSyw0QkFBNEIsa0JBc0JqQztJQUVLLGdCQUFnQixrQkEwRXJCO1lBTWEsZUFBZTtDQWdCOUIifQ==

package/dest/testing/anvil_test_watcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"anvil_test_watcher.d.ts","sourceRoot":"","sources":["../../src/testing/anvil_test_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,gBAAgB;IA8BzB,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,YAAY,CAAC;IAhCvB,OAAO,CAAC,cAAc,CAAC;IACvB,OAAO,CAAC,iBAAiB,CAAC;IAE1B,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAU;IAEhC,OAAO,CAAC,oBAAoB,CAAC,CAAiB;IAC9C,OAAO,CAAC,uBAAuB,CAAC,CAAiB;IACjD,OAAO,CAAC,6BAA6B,CAAC,CAAiB;IAEvD,OAAO,CAAC,MAAM,CAAiD;IAG/D,OAAO,CAAC,iBAAiB,CAAC,CAAwB;IAGlD,OAAO,CAAC,mBAAmB,CAAC,CAAgB;IAG5C,OAAO,CAAC,qBAAqB,CAAC,CAAqC;IAMnE,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,YACU,UAAU,EAAE,aAAa,EACjC,aAAa,EAAE,UAAU,EACzB,QAAQ,EAAE,UAAU,EACZ,YAAY,CAAC,8BAAkB,EACvC,IAAI,GAAE,oBAAyB,EAgBhC;IAED,oBAAoB,CAAC,iBAAiB,EAAE,OAAO,QAG9C;IAED,iBAAiB,CAAC,cAAc,EAAE,OAAO,QAExC;IAED,yGAAyG;IACzG,oBAAoB,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,QAE7C;IAED,uGAAuG;IACvG,sBAAsB,CAAC,EAAE,EAAE,MAAM,OAAO,QAEvC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,QAIjC;IAEK,KAAK,kBAyBV;IAEK,IAAI,kBAIT;IAEK,OAAO,kBAIZ;IAEK,YAAY,kBAKjB;IAEK,4BAA4B,kBAsBjC;IAEK,gBAAgB,kBA0ErB;YAMa,eAAe;CAgB9B"}

package/dest/testing/anvil_test_watcher.js

@@ -1,235 +0,0 @@
-import { RollupCheatCodes } from '@aztec/ethereum/test';
-import { SlotNumber } from '@aztec/foundation/branded-types';
-import { createLogger } from '@aztec/foundation/log';
-import { RunningPromise } from '@aztec/foundation/running-promise';
-import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
-import { getAddress, getContract } from 'viem';
-/**
- * Represents a watcher for a rollup contract.
- *
- * It started on a network like anvil where time traveling is allowed, and auto-mine is turned on
- * it will periodically check if the current slot have already been filled, e.g., there was an L2
- * block within the slot. And if so, it will time travel into the next slot.
- */ export class AnvilTestWatcher {
-    cheatcodes;
-    dateProvider;
-    isLocalNetwork;
-    isMarkingAsProven;
-    rollup;
-    rollupCheatCodes;
-    l2SlotDuration;
-    filledRunningPromise;
-    syncDateProviderPromise;
-    markingAsProvenRunningPromise;
-    logger;
-    // Optional callback to check if there are pending txs in the mempool.
-    getPendingTxCount;
-    // Optional callback to check if the sequencer is actively building a block.
-    isSequencerBuilding;
-    // Tracks when we first observed the current unfilled slot with pending txs (real wall time).
-    unfilledSlotFirstSeen;
-    // Latest target slot for which the proposer has built a block destined for L1 but which has
-    // not yet been committed. Set by the proposer-pipelining hook from `block-proposed` events so
-    // the watcher can advance L1 (and the injected date provider) to the target slot ahead of the
-    // publisher's `sendRequestsAt` sleep, instead of waiting a full wall-clock slot.
-    proposedTargetSlot;
-    constructor(cheatcodes, rollupAddress, l1Client, dateProvider, opts = {}){
-        this.cheatcodes = cheatcodes;
-        this.dateProvider = dateProvider;
-        this.logger = createLogger(`aztecjs:utils:watcher`);
-        this.rollup = getContract({
-            address: getAddress(rollupAddress.toString()),
-            abi: RollupAbi,
-            client: l1Client
-        });
-        this.rollupCheatCodes = new RollupCheatCodes(this.cheatcodes, {
-            rollupAddress
-        });
-        this.isLocalNetwork = opts.isLocalNetwork ?? false;
-        this.isMarkingAsProven = opts.isMarkingAsProven ?? true;
-        this.logger.debug(`Watcher created for rollup at ${rollupAddress}`);
-    }
-    setIsMarkingAsProven(isMarkingAsProven) {
-        this.logger.warn(`Watcher is now ${isMarkingAsProven ? 'marking' : 'not marking'} blocks as proven`);
-        this.isMarkingAsProven = isMarkingAsProven;
-    }
-    setisLocalNetwork(isLocalNetwork) {
-        this.isLocalNetwork = isLocalNetwork;
-    }
-    /** Sets a callback to check for pending txs, used to skip unfilled slots faster when txs are waiting. */ setGetPendingTxCount(fn) {
-        this.getPendingTxCount = fn;
-    }
-    /** Sets a callback to check if the sequencer is actively building, to avoid warping while it works. */ setIsSequencerBuilding(fn) {
-        this.isSequencerBuilding = fn;
-    }
-    /**
-   * Records the target slot for which the proposer has built a block destined for L1. Used by
-   * the local-network watcher to fast-forward L1 (and the injected date provider) ahead of the
-   * pipelined publisher's `sendRequestsAt` sleep so it ends promptly instead of waiting a full
-   * wall-clock slot. Only ratchets up — late warps for stale slots are no-ops.
-   */ setProposedTargetSlot(slot) {
-        if (this.proposedTargetSlot === undefined || slot > this.proposedTargetSlot) {
-            this.proposedTargetSlot = slot;
-        }
-    }
-    async start() {
-        if (this.filledRunningPromise) {
-            throw new Error('Watcher already watching for filled slot');
-        }
-        const config = await this.rollupCheatCodes.getConfig();
-        this.l2SlotDuration = config.slotDuration;
-        // If auto mining is not supported (e.g., we are on a real network), then we
-        // will simple do nothing. But if on an anvil or the like, this make sure that
-        // the local network and tests don't break because time is frozen and we never get to
-        // the next slot.
-        const isAutoMining = await this.cheatcodes.isAutoMining();
-        if (isAutoMining) {
-            this.filledRunningPromise = new RunningPromise(()=>this.warpTimeIfNeeded(), this.logger, 200);
-            this.filledRunningPromise.start();
-            this.syncDateProviderPromise = new RunningPromise(()=>this.syncDateProviderToL1IfBehind(), this.logger, 200);
-            this.syncDateProviderPromise.start();
-            this.markingAsProvenRunningPromise = new RunningPromise(()=>this.markAsProven(), this.logger, 200);
-            this.markingAsProvenRunningPromise.start();
-            this.logger.info(`Watcher started for rollup at ${this.rollup.address}`);
-        } else {
-            this.logger.info(`Watcher not started because not auto mining`);
-        }
-    }
-    async stop() {
-        await this.filledRunningPromise?.stop();
-        await this.syncDateProviderPromise?.stop();
-        await this.markingAsProvenRunningPromise?.stop();
-    }
-    async trigger() {
-        await this.filledRunningPromise?.trigger();
-        await this.syncDateProviderPromise?.trigger();
-        await this.markingAsProvenRunningPromise?.trigger();
-    }
-    async markAsProven() {
-        if (!this.isMarkingAsProven) {
-            return;
-        }
-        await this.rollupCheatCodes.markAsProven();
-    }
-    async syncDateProviderToL1IfBehind() {
-        // this doesn't apply to the local network, because we don't have a date provider in the local network
-        if (!this.dateProvider) {
-            return;
-        }
-        const l1Time = await this.cheatcodes.lastBlockTimestamp() * 1000;
-        const wallTime = this.dateProvider.now();
-        if (l1Time > wallTime) {
-            this.logger.warn(`L1 is ahead of wall time. Syncing wall time to L1 time`);
-            this.dateProvider.setTime(l1Time);
-        } else if (l1Time + Number(this.l2SlotDuration) * 1000 < wallTime) {
-            // Warp L1 to the slot boundary at-or-before wall time. Rounding to a slot boundary (rather than
-            // `ceil(wallTime / 1000)`) keeps this loop's target aligned with `warpTimeIfNeeded`'s
-            // `nextSlotTimestamp` target, avoiding a race where the two loops pick timestamps a fraction of
-            // a second apart and one of them is then rejected by anvil as non-monotonic.
-            const wallSec = Math.floor(wallTime / 1000);
-            const targetSlot = await this.rollup.read.getSlotAt([
-                BigInt(wallSec)
-            ]);
-            const targetTimestamp = Number(await this.rollup.read.getTimestampForSlot([
-                targetSlot
-            ]));
-            this.logger.warn(`L1 is more than 1 L2 slot behind wall time. Warping to slot ${targetSlot} boundary`);
-            await this.warpToTimestamp(targetTimestamp);
-        }
-    }
-    async warpTimeIfNeeded() {
-        try {
-            const currentSlot = SlotNumber.fromBigInt(await this.rollup.read.getCurrentSlot());
-            const pendingCheckpointNumber = await this.rollup.read.getPendingCheckpointNumber();
-            const checkpointLog = await this.rollup.read.getCheckpoint([
-                pendingCheckpointNumber
-            ]);
-            const nextSlot = SlotNumber(currentSlot + 1);
-            const nextSlotTimestamp = Number(await this.rollup.read.getTimestampForSlot([
-                BigInt(nextSlot)
-            ]));
-            if (BigInt(currentSlot) === checkpointLog.slotNumber) {
-                // The current slot has been filled, we should jump to the next slot.
-                if (await this.warpToTimestamp(nextSlotTimestamp)) {
-                    this.logger.info(`Slot ${currentSlot} was filled, jumped to next slot`);
-                }
-                return;
-            }
-            // If we are not in local network, we don't need to warp time
-            if (!this.isLocalNetwork) {
-                return;
-            }
-            // Pipelined-publish shortcut: if the proposer has built a block destined for a slot
-            // beyond the current L1 slot, fast-forward L1 to that slot's timestamp so the publisher's
-            // `sendRequestsAt(targetSlot)` sleep ends and the multicall mines inside the target slot.
-            // Without this, the publisher waits up to a full real-time slot for wall clock to catch up.
-            if (this.proposedTargetSlot !== undefined && this.proposedTargetSlot > currentSlot) {
-                const targetSlotTimestamp = Number(await this.rollup.read.getTimestampForSlot([
-                    BigInt(this.proposedTargetSlot)
-                ]));
-                if (await this.warpToTimestamp(targetSlotTimestamp)) {
-                    this.logger.info(`Warped L1 to target slot ${this.proposedTargetSlot} for pipelined publish`);
-                }
-                return;
-            }
-            // If there are pending txs and the sequencer missed them, warp quickly (after a 2s real-time debounce) so the
-            // sequencer can retry in the next slot. Without this, we'd have to wait a full real-time slot duration (~36s) for
-            // the dateProvider to catch up to the next slot timestamp. We skip the warp if the sequencer is actively building
-            // to avoid invalidating its in-progress work.
-            if (this.getPendingTxCount) {
-                const pendingTxs = await this.getPendingTxCount();
-                if (pendingTxs > 0) {
-                    if (this.isSequencerBuilding?.()) {
-                        this.unfilledSlotFirstSeen = undefined;
-                        return;
-                    }
-                    const realNow = Date.now();
-                    if (!this.unfilledSlotFirstSeen || this.unfilledSlotFirstSeen.slot !== currentSlot) {
-                        this.unfilledSlotFirstSeen = {
-                            slot: currentSlot,
-                            realTime: realNow
-                        };
-                        return;
-                    }
-                    if (realNow - this.unfilledSlotFirstSeen.realTime > 2000) {
-                        if (await this.warpToTimestamp(nextSlotTimestamp)) {
-                            this.logger.info(`Slot ${currentSlot} was missed with pending txs, jumped to next slot`);
-                        }
-                        this.unfilledSlotFirstSeen = undefined;
-                    }
-                    return;
-                }
-            }
-            // Fallback: warp when the dateProvider time has passed the next slot timestamp.
-            const currentTimestamp = this.dateProvider?.now() ?? Date.now();
-            if (currentTimestamp > nextSlotTimestamp * 1000) {
-                if (await this.warpToTimestamp(nextSlotTimestamp)) {
-                    this.logger.info(`Slot ${currentSlot} was missed, jumped to next slot`);
-                }
-            }
-        } catch  {
-            this.logger.error('mineIfSlotFilled failed');
-        }
-    }
-    /**
-   * Warps L1 to `timestamp`, unless L1 is already at or past it. Returns true when a warp actually
-   * happened, false when skipped or on error. Callers use the return value to gate success logs.
-   */ async warpToTimestamp(timestamp) {
-        try {
-            // Anvil rejects evm_setNextBlockTimestamp values <= the current block's timestamp. The two
-            // watcher loops can race and pick targets a fraction of a second apart; skip here rather than
-            // letting the second one error out noisily.
-            const lastTimestamp = await this.cheatcodes.lastBlockTimestamp();
-            if (timestamp <= lastTimestamp) {
-                return false;
-            }
-            await this.cheatcodes.warp(timestamp, {
-                resetBlockInterval: true
-            });
-            return true;
-        } catch (e) {
-            this.logger.error(`Failed to warp to timestamp ${timestamp}: ${e}`);
-            return false;
-        }
-    }
-}