@aztec/ethereum 0.0.0-test.1 → 0.0.1-commit.b655e406

package/dest/{eth_cheat_codes.d.ts → test/eth_cheat_codes.d.ts}

@@ -1,5 +1,7 @@
-import type { EthAddress } from '@aztec/foundation/eth-address';
-import { type Hex } from 'viem';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import type { DateProvider, TestDateProvider } from '@aztec/foundation/timer';
+import { type Hex, type Transaction } from 'viem';
+import type { ViemPublicClient } from '../types.js';
 /**
  * A class that provides utility functions for interacting with ethereum (L1).
  */
@@ -8,21 +10,30 @@ export declare class EthCheatCodes {
      * The RPC URL to use for interacting with the chain
      */
     rpcUrls: string[];
+    /**
+     * The date provider to use for time operations
+     */
+    dateProvider: DateProvider | TestDateProvider;
     /**
      * The logger to use for the eth cheatcodes
      */
     logger: import("@aztec/foundation/log").Logger;
-    private publicClient;
+    readonly publicClient: ViemPublicClient;
     constructor(
     /**
      * The RPC URL to use for interacting with the chain
      */
     rpcUrls: string[], 
+    /**
+     * The date provider to use for time operations
+     */
+    dateProvider: DateProvider | TestDateProvider, 
     /**
      * The logger to use for the eth cheatcodes
      */
     logger?: import("@aztec/foundation/log").Logger);
     rpcCall(method: string, params: any[]): Promise<any>;
+    private doRpcCall;
     /**
      * Get the auto mine status of the underlying chain
      * @returns True if automine is on, false otherwise
@@ -47,7 +58,7 @@ export declare class EthCheatCodes {
      * Advance the chain by a number of blocks
      * @param numberOfBlocks - The number of blocks to mine
      */
-    mine(numberOfBlocks?: number): Promise<void>;
+    mine(numberOfBlocks?: number | bigint): Promise<void>;
     private doMine;
     /**
      * Mines a single block with evm_mine
@@ -58,9 +69,10 @@ export declare class EthCheatCodes {
      * @param account - The account to set the balance for
      * @param balance - The balance to set
      */
-    setBalance(account: EthAddress, balance: bigint): Promise<void>;
+    setBalance(account: EthAddress | Hex, balance: bigint): Promise<void>;
+    getBalance(account: EthAddress | Hex): Promise<bigint>;
     /**
-     * Set the interval between blocks (block time)
+     * Set the interval between successive blocks (block time). This does NOT enable interval mining.
      * @param interval - The interval to use between blocks
      */
     setBlockInterval(interval: number): Promise<void>;
@@ -70,15 +82,24 @@ export declare class EthCheatCodes {
      */
     setNextBlockBaseFeePerGas(baseFee: bigint | number): Promise<void>;
     /**
-     * Set the interval between blocks (block time)
+     * Get interval mining if set.
      * @param seconds - The interval to use between blocks
      */
-    setIntervalMining(seconds: number): Promise<void>;
+    getIntervalMining(): Promise<number | null>;
+    /**
+     * Enable interval mining at the given interval (block time)
+     * @param seconds - The interval to use between blocks
+     */
+    setIntervalMining(seconds: number, opts?: {
+        silent?: boolean;
+    }): Promise<void>;
     /**
      * Set the automine status of the underlying anvil chain
      * @param automine - The automine status to set
      */
-    setAutomine(automine: boolean): Promise<void>;
+    setAutomine(automine: boolean, opts?: {
+        silent?: boolean;
+    }): Promise<void>;
     /**
      * Drop a transaction from the mempool
      * @param txHash - The transaction hash
@@ -88,12 +109,17 @@ export declare class EthCheatCodes {
      * Set the next block timestamp
      * @param timestamp - The timestamp to set the next block to
      */
-    setNextBlockTimestamp(timestamp: number): Promise<void>;
+    setNextBlockTimestamp(timestamp: number | Date): Promise<void>;
     /**
-     * Set the next block timestamp and mines the block
+     * Set the next block timestamp and mines the block.
+     * Optionally resets interval mining so the next block is mined in `blockInterval` seconds from now.
+     * Always updates the injected date provider to follow L1 time.
      * @param timestamp - The timestamp to set the next block to
      */
-    warp(timestamp: number | bigint, silent?: boolean): Promise<void>;
+    warp(timestamp: number | bigint, opts?: {
+        silent?: boolean;
+        resetBlockInterval?: boolean;
+    }): Promise<void>;
     /**
      * Load the value at a storage slot of a contract address on eth
      * @param contract - The contract address
@@ -107,7 +133,9 @@ export declare class EthCheatCodes {
      * @param slot - The storage slot
      * @param value - The value to set the storage slot to
      */
-    store(contract: EthAddress, slot: bigint, value: bigint): Promise<void>;
+    store(contract: EthAddress, slot: bigint, value: bigint, opts?: {
+        silent?: boolean;
+    }): Promise<void>;
     /**
      * Computes the slot value for a given map and key.
      * @param baseSlot - The base slot of the map (specified in Aztec.nr contract)
@@ -143,5 +171,51 @@ export declare class EthCheatCodes {
      * @returns The raw transaction
      */
     getRawTransaction(txHash: Hex): Promise<`0x${string}`>;
+    /**
+     * Get the trace for a given transaction hash
+     * @param txHash - The transaction hash
+     * @returns The trace
+     */
+    debugTraceTransaction(txHash: Hex): Promise<any>;
+    /**
+     * Triggers a reorg of the given depth, removing those blocks from the chain.
+     * @param depth - The depth of the reorg
+     */
+    reorg(depth: number): Promise<void>;
+    /**
+     * Causes Anvil to reorg until the given block number is the new tip
+     * @param blockNumber - The block number that's going to be the new tip
+     */
+    reorgTo(blockNumber: number): Promise<void>;
+    /**
+     * Triggers a reorg of the given depth, optionally replacing it with new blocks.
+     * The resulting block height will be the same as the original chain.
+     * @param depth - The depth of the reorg
+     * @param newBlocks - The blocks to replace the old ones with, each represented as a list of txs.
+     */
+    reorgWithReplacement(depth: number, newBlocks?: (Hex | {
+        to: EthAddress | Hex;
+        input?: Hex;
+        from?: EthAddress | Hex;
+        value?: number | bigint;
+    })[][]): Promise<void>;
+    traceTransaction(txHash: Hex): Promise<any>;
+    getTxPoolStatus(): Promise<{
+        pending: number;
+        queued: number;
+    }>;
+    getTxPoolContents(): Promise<TxPoolTransaction[]>;
+    /**
+     * Mines an empty block by temporarily removing all pending transactions from the mempool,
+     * mining a block, and then re-adding the transactions back to the pool.
+     */
+    mineEmptyBlock(blockCount?: number): Promise<void>;
+    execWithPausedAnvil<T>(fn: () => Promise<T>): Promise<T>;
+    syncDateProvider(): Promise<void>;
 }
+type TxPoolState = 'pending' | 'queued';
+export type TxPoolTransaction = Transaction & {
+    poolState: TxPoolState;
+};
+export {};
 //# sourceMappingURL=eth_cheat_codes.d.ts.map

package/dest/test/eth_cheat_codes.d.ts.map

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