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

package/dest/test/eth_cheat_codes.js

@@ -0,0 +1,552 @@
+import { toBigIntBE, toHex } from '@aztec/foundation/bigint-buffer';
+import { keccak256 } from '@aztec/foundation/crypto';
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+import { createLogger } from '@aztec/foundation/log';
+import { pluralize } from '@aztec/foundation/string';
+import { createPublicClient, fallback, hexToNumber, http } from 'viem';
+/**
+ * A class that provides utility functions for interacting with ethereum (L1).
+ */ export class EthCheatCodes {
+    rpcUrls;
+    dateProvider;
+    logger;
+    publicClient;
+    constructor(/**
+     * The RPC URL to use for interacting with the chain
+     */ rpcUrls, /**
+     * The date provider to use for time operations
+     */ dateProvider, /**
+     * The logger to use for the eth cheatcodes
+     */ logger = createLogger('ethereum:cheat_codes')){
+        this.rpcUrls = rpcUrls;
+        this.dateProvider = dateProvider;
+        this.logger = logger;
+        this.publicClient = createPublicClient({
+            transport: fallback(this.rpcUrls.map((url)=>http(url)))
+        });
+    }
+    rpcCall(method, params) {
+        this.logger.debug(`Calling ${method} with params: ${jsonStringify(params)} on ${this.rpcUrls.join(', ')}`);
+        return this.doRpcCall(method, params);
+    }
+    async doRpcCall(method, params) {
+        return await this.publicClient.transport.request({
+            method,
+            params
+        });
+    }
+    /**
+   * Get the auto mine status of the underlying chain
+   * @returns True if automine is on, false otherwise
+   */ async isAutoMining() {
+        try {
+            const res = await this.doRpcCall('anvil_getAutomine', []);
+            return res;
+        } catch (err) {
+            this.logger.error(`Calling "anvil_getAutomine" failed with:`, err);
+        }
+        return false;
+    }
+    /**
+   * Get the current blocknumber
+   * @returns The current block number
+   */ async blockNumber() {
+        const res = await this.doRpcCall('eth_blockNumber', []);
+        return parseInt(res, 16);
+    }
+    /**
+   * Get the current chainId
+   * @returns The current chainId
+   */ async chainId() {
+        const res = await this.doRpcCall('eth_chainId', []);
+        return parseInt(res, 16);
+    }
+    /**
+   * Get the current timestamp
+   * @returns The current timestamp
+   */ async timestamp() {
+        const res = await this.doRpcCall('eth_getBlockByNumber', [
+            'latest',
+            true
+        ]);
+        return parseInt(res.timestamp, 16);
+    }
+    /**
+   * Advance the chain by a number of blocks
+   * @param numberOfBlocks - The number of blocks to mine
+   */ async mine(numberOfBlocks = 1) {
+        await this.doMine(Number(numberOfBlocks));
+        this.logger.warn(`Mined ${numberOfBlocks} L1 blocks`);
+    }
+    async doMine(numberOfBlocks = 1) {
+        try {
+            await this.doRpcCall('hardhat_mine', [
+                numberOfBlocks
+            ]);
+        } catch (err) {
+            throw new Error(`Error mining: ${err}`);
+        }
+    }
+    /**
+   * Mines a single block with evm_mine
+   */ async evmMine() {
+        try {
+            await this.doRpcCall('evm_mine', []);
+            this.logger.warn(`Mined 1 L1 block with evm_mine`);
+        } catch (err) {
+            throw new Error(`Error mining: ${err}`);
+        }
+    }
+    /**
+   * Set the balance of an account
+   * @param account - The account to set the balance for
+   * @param balance - The balance to set
+   */ async setBalance(account, balance) {
+        try {
+            await this.rpcCall('anvil_setBalance', [
+                account.toString(),
+                toHex(balance)
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting balance for ${account}: ${err}`);
+        }
+        this.logger.warn(`Set balance for ${account} to ${balance}`);
+    }
+    async getBalance(account) {
+        const res = await this.doRpcCall('eth_getBalance', [
+            account.toString(),
+            'latest'
+        ]);
+        return BigInt(res);
+    }
+    /**
+   * Set the interval between successive blocks (block time). This does NOT enable interval mining.
+   * @param interval - The interval to use between blocks
+   */ async setBlockInterval(interval) {
+        try {
+            await this.rpcCall('anvil_setBlockTimestampInterval', [
+                interval
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting block interval: ${err}`);
+        }
+        this.logger.warn(`Set L1 block interval to ${interval}`);
+    }
+    /**
+   * Set the next block base fee per gas
+   * @param baseFee - The base fee to set
+   */ async setNextBlockBaseFeePerGas(baseFee) {
+        try {
+            await this.rpcCall('anvil_setNextBlockBaseFeePerGas', [
+                baseFee.toString()
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting next block base fee per gas: ${err}`);
+        }
+        this.logger.warn(`Set L1 next block base fee per gas to ${baseFee}`);
+    }
+    /**
+   * Get interval mining if set.
+   * @param seconds - The interval to use between blocks
+   */ getIntervalMining() {
+        try {
+            return this.doRpcCall('anvil_getIntervalMining', []);
+        } catch (err) {
+            throw new Error(`Error getting interval mining: ${err}`);
+        }
+    }
+    /**
+   * Enable interval mining at the given interval (block time)
+   * @param seconds - The interval to use between blocks
+   */ async setIntervalMining(seconds, opts = {}) {
+        try {
+            await this.rpcCall('anvil_setIntervalMining', [
+                seconds
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting interval mining: ${err}`);
+        }
+        if (!opts.silent) {
+            this.logger.warn(`Set L1 interval mining to ${seconds} seconds`);
+        }
+    }
+    /**
+   * Set the automine status of the underlying anvil chain
+   * @param automine - The automine status to set
+   */ async setAutomine(automine, opts = {}) {
+        try {
+            await this.rpcCall('anvil_setAutomine', [
+                automine
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting automine: ${err}`);
+        }
+        if (!opts.silent) {
+            this.logger.warn(`Set L1 automine to ${automine}`);
+        }
+    }
+    /**
+   * Drop a transaction from the mempool
+   * @param txHash - The transaction hash
+   */ async dropTransaction(txHash) {
+        try {
+            await this.rpcCall('anvil_dropTransaction', [
+                txHash
+            ]);
+        } catch (err) {
+            throw new Error(`Error dropping transaction: ${err}`);
+        }
+        this.logger.warn(`Dropped transaction ${txHash}`);
+    }
+    /**
+   * Set the next block timestamp
+   * @param timestamp - The timestamp to set the next block to
+   */ async setNextBlockTimestamp(timestamp) {
+        try {
+            await this.rpcCall('evm_setNextBlockTimestamp', [
+                timestamp instanceof Date ? Math.floor(timestamp.getTime() / 1000) : timestamp
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting next block timestamp: ${err.message}`);
+        }
+        this.logger.warn(`Set L1 next block timestamp to ${timestamp}`);
+    }
+    /**
+   * 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
+   */ async warp(timestamp, opts = {}) {
+        let blockInterval = null;
+        try {
+            // Load current block interval and disable it
+            if (opts.resetBlockInterval) {
+                blockInterval = await this.getIntervalMining();
+                if (blockInterval !== null) {
+                    await this.setIntervalMining(0, {
+                        silent: true
+                    });
+                }
+            }
+            // Set the timestamp of the next block to be mined
+            await this.rpcCall('evm_setNextBlockTimestamp', [
+                Number(timestamp)
+            ]);
+            // And mine a block so the timestamp goes into effect now
+            await this.doMine();
+            // Update the injected date provider so it follows L1 time
+            if ('setTime' in this.dateProvider) {
+                this.dateProvider.setTime(Number(timestamp) * 1000);
+            }
+        } catch (err) {
+            throw new Error(`Error warping: ${err}`);
+        } finally{
+            // Restore interval mining so the next block is mined in `blockInterval` seconds from this one
+            if (opts.resetBlockInterval && blockInterval !== null && blockInterval > 0) {
+                await this.setIntervalMining(blockInterval, {
+                    silent: true
+                });
+            }
+        }
+        if (!opts.silent) {
+            this.logger.warn(`Warped L1 timestamp to ${timestamp}`);
+        }
+    }
+    /**
+   * Load the value at a storage slot of a contract address on eth
+   * @param contract - The contract address
+   * @param slot - The storage slot
+   * @returns - The value at the storage slot
+   */ async load(contract, slot) {
+        const res = await this.rpcCall('eth_getStorageAt', [
+            contract.toString(),
+            toHex(slot),
+            'latest'
+        ]);
+        return BigInt(res);
+    }
+    /**
+   * Set the value at a storage slot of a contract address on eth
+   * @param contract - The contract address
+   * @param slot - The storage slot
+   * @param value - The value to set the storage slot to
+   */ async store(contract, slot, value, opts = {}) {
+        // for the rpc call, we need to change value to be a 32 byte hex string.
+        try {
+            await this.rpcCall('hardhat_setStorageAt', [
+                contract.toString(),
+                toHex(slot),
+                toHex(value, true)
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting storage for contract ${contract} at ${slot}: ${err}`);
+        }
+        if (!opts.silent) {
+            this.logger.warn(`Set L1 storage for contract ${contract} at ${slot} to ${value}`);
+        }
+    }
+    /**
+   * Computes the slot value for a given map and key.
+   * @param baseSlot - The base slot of the map (specified in Aztec.nr contract)
+   * @param key - The key to lookup in the map
+   * @returns The storage slot of the value in the map
+   */ keccak256(baseSlot, key) {
+        // abi encode (removing the 0x) - concat key and baseSlot (both padded to 32 bytes)
+        const abiEncoded = toHex(key, true).substring(2) + toHex(baseSlot, true).substring(2);
+        return toBigIntBE(keccak256(Buffer.from(abiEncoded, 'hex')));
+    }
+    /**
+   * Send transactions impersonating an externally owned account or contract.
+   * @param who - The address to impersonate
+   */ async startImpersonating(who) {
+        try {
+            // Since the `who` impersonated will sometimes be a contract without funds, we fund it if needed.
+            if (await this.getBalance(who) === 0n) {
+                await this.setBalance(who, 10n * 10n ** 18n);
+            }
+            await this.rpcCall('hardhat_impersonateAccount', [
+                who.toString()
+            ]);
+        } catch (err) {
+            throw new Error(`Error impersonating ${who}: ${err}`);
+        }
+        this.logger.warn(`Impersonating ${who}`);
+    }
+    /**
+   * Stop impersonating an account that you are currently impersonating.
+   * @param who - The address to stop impersonating
+   */ async stopImpersonating(who) {
+        try {
+            await this.rpcCall('hardhat_stopImpersonatingAccount', [
+                who.toString()
+            ]);
+        } catch (err) {
+            throw new Error(`Error when stopping the impersonation of ${who}: ${err}`);
+        }
+        this.logger.warn(`Stopped impersonating ${who}`);
+    }
+    /**
+   * Set the bytecode for a contract
+   * @param contract - The contract address
+   * @param bytecode - The bytecode to set
+   */ async etch(contract, bytecode) {
+        try {
+            await this.rpcCall('hardhat_setCode', [
+                contract.toString(),
+                bytecode
+            ]);
+        } catch (err) {
+            throw new Error(`Error setting bytecode for ${contract}: ${err}`);
+        }
+        this.logger.warn(`Set bytecode for ${contract} to ${bytecode}`);
+    }
+    /**
+   * Get the bytecode for a contract
+   * @param contract - The contract address
+   * @returns The bytecode for the contract
+   */ async getBytecode(contract) {
+        return await this.doRpcCall('eth_getCode', [
+            contract.toString(),
+            'latest'
+        ]);
+    }
+    /**
+   * Get the raw transaction object for a given transaction hash
+   * @param txHash - The transaction hash
+   * @returns The raw transaction
+   */ async getRawTransaction(txHash) {
+        return await this.doRpcCall('debug_getRawTransaction', [
+            txHash
+        ]);
+    }
+    /**
+   * Get the trace for a given transaction hash
+   * @param txHash - The transaction hash
+   * @returns The trace
+   */ async debugTraceTransaction(txHash) {
+        return await this.doRpcCall('debug_traceTransaction', [
+            txHash
+        ]);
+    }
+    /**
+   * Triggers a reorg of the given depth, removing those blocks from the chain.
+   * @param depth - The depth of the reorg
+   */ reorg(depth) {
+        return this.execWithPausedAnvil(()=>{
+            return this.rpcCall('anvil_rollback', [
+                depth
+            ]);
+        });
+    }
+    /**
+   * 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) {
+        if (blockNumber <= 0) {
+            throw new Error(`Can't reorg to block before genesis: ${blockNumber}`);
+        }
+        return this.execWithPausedAnvil(async ()=>{
+            const currentTip = await this.publicClient.getBlockNumber();
+            if (currentTip < BigInt(blockNumber)) {
+                this.logger.warn(`Can't call anvil_rollback, chain tip is behind target block: ${currentTip} < ${BigInt(blockNumber)}`);
+                return;
+            }
+            const depth = Number(currentTip - BigInt(blockNumber) + 1n);
+            await this.rpcCall('anvil_rollback', [
+                depth
+            ]);
+            this.logger.warn(`Reorged L1 chain to block number ${blockNumber} (depth ${depth})`);
+        });
+    }
+    /**
+   * 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.
+   */ async reorgWithReplacement(depth, newBlocks = []) {
+        this.logger.verbose(`Preparing L1 reorg with depth ${depth}`);
+        try {
+            await this.rpcCall('anvil_reorg', [
+                depth,
+                newBlocks.flatMap((txs, index)=>txs.map((tx)=>[
+                            typeof tx === 'string' ? tx : {
+                                value: 0,
+                                ...tx
+                            },
+                            index
+                        ]))
+            ]);
+        } catch (err) {
+            throw new Error(`Error reorging: ${err}`);
+        }
+        this.logger.warn(`Reorged L1 chain with depth ${depth} and ${newBlocks.length} new blocks`, {
+            depth,
+            newBlocks
+        });
+    }
+    traceTransaction(txHash) {
+        return this.doRpcCall('trace_transaction', [
+            txHash
+        ]);
+    }
+    async getTxPoolStatus() {
+        const { pending, queued } = await this.doRpcCall('txpool_status', []);
+        return {
+            pending: hexToNumber(pending),
+            queued: hexToNumber(queued)
+        };
+    }
+    async getTxPoolContents() {
+        const txpoolContent = await this.doRpcCall('txpool_content', []);
+        return mapTxPoolContent(txpoolContent);
+    }
+    /**
+   * 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.
+   */ async mineEmptyBlock(blockCount = 1) {
+        await this.execWithPausedAnvil(async ()=>{
+            // Get all pending and queued transactions from the pool
+            const txs = await this.getTxPoolContents();
+            this.logger.debug(`Found ${txs.length} transactions in pool`);
+            // Get raw transactions before dropping them
+            const rawTxs = [];
+            for (const tx of txs){
+                try {
+                    const rawTx = await this.doRpcCall('debug_getRawTransaction', [
+                        tx.hash
+                    ]);
+                    if (rawTx) {
+                        rawTxs.push(rawTx);
+                        this.logger.debug(`Got raw tx for ${tx.hash}`);
+                    } else {
+                        this.logger.warn(`No raw tx found for ${tx.hash}`);
+                    }
+                } catch  {
+                    this.logger.warn(`Failed to get raw transaction for ${tx.hash}`);
+                }
+            }
+            this.logger.debug(`Retrieved ${rawTxs.length} raw transactions`);
+            // Drop all transactions from the mempool
+            await this.doRpcCall('anvil_dropAllTransactions', []);
+            // Mine an empty block
+            await this.doMine(blockCount);
+            // Re-add the transactions to the pool
+            for (const rawTx of rawTxs){
+                try {
+                    const txHash = await this.doRpcCall('eth_sendRawTransaction', [
+                        rawTx
+                    ]);
+                    this.logger.debug(`Re-added transaction ${txHash}`);
+                } catch (err) {
+                    this.logger.warn(`Failed to re-add transaction: ${err}`);
+                }
+            }
+            if (rawTxs.length !== txs.length) {
+                this.logger.warn(`Failed to add all txs back: had ${txs.length} but re-added ${rawTxs.length}`);
+            }
+        });
+        this.logger.warn(`Mined ${blockCount} empty L1 ${pluralize('block', blockCount)}`);
+    }
+    async execWithPausedAnvil(fn) {
+        const [blockInterval, wasAutoMining] = await Promise.all([
+            this.getIntervalMining(),
+            this.isAutoMining()
+        ]);
+        try {
+            if (blockInterval !== null) {
+                await this.setIntervalMining(0, {
+                    silent: true
+                });
+            }
+            if (wasAutoMining) {
+                await this.setAutomine(false, {
+                    silent: true
+                });
+            }
+            return await fn();
+        } finally{
+            try {
+                // restore automine if necessary
+                if (wasAutoMining) {
+                    await this.setAutomine(true, {
+                        silent: true
+                    });
+                }
+            } catch (err) {
+                this.logger.warn(`Failed to reenable automining: ${err}`);
+            }
+            try {
+                // restore automine if necessary
+                if (blockInterval !== null) {
+                    await this.setIntervalMining(blockInterval, {
+                        silent: true
+                    });
+                }
+            } catch (err) {
+                this.logger.warn(`Failed to reenable interval mining: ${err}`);
+            }
+        }
+    }
+    async syncDateProvider() {
+        const timestamp = await this.timestamp();
+        if ('setTime' in this.dateProvider) {
+            this.dateProvider.setTime(timestamp * 1000);
+        }
+    }
+}
+function mapTxPoolContent(content) {
+    const result = [];
+    const processPool = (pool, poolState)=>{
+        for (const txsByNonce of Object.values(pool)){
+            for (const tx of Object.values(txsByNonce)){
+                result.push({
+                    ...tx,
+                    poolState
+                });
+            }
+        }
+    };
+    processPool(content.pending, 'pending');
+    processPool(content.queued, 'queued');
+    return result;
+}

package/dest/test/eth_cheat_codes_with_state.d.ts

@@ -1,4 +1,4 @@
-import { EthCheatCodes } from '../eth_cheat_codes.js';
+import { EthCheatCodes } from './eth_cheat_codes.js';
 /**
  * A class that provides utility functions for interacting with ethereum (L1) dumping/loading state to/from a file.
  * It is separated to avoid importing fs in the main EthCheatCodes class, which might be used in the browser.

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

@@ -1 +1 @@
-{"version":3,"file":"eth_cheat_codes_with_state.d.ts","sourceRoot":"","sources":["../../src/test/eth_cheat_codes_with_state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7D"}
+{"version":3,"file":"eth_cheat_codes_with_state.d.ts","sourceRoot":"","sources":["../../src/test/eth_cheat_codes_with_state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7D"}

package/dest/test/eth_cheat_codes_with_state.js

@@ -1,5 +1,5 @@
 import fs from 'fs';
-import { EthCheatCodes } from '../eth_cheat_codes.js';
+import { EthCheatCodes } from './eth_cheat_codes.js';
 /**
  * A class that provides utility functions for interacting with ethereum (L1) dumping/loading state to/from a file.
  * It is separated to avoid importing fs in the main EthCheatCodes class, which might be used in the browser.

package/dest/test/index.d.ts

@@ -1,6 +1,9 @@
 export * from './delayed_tx_utils.js';
+export * from './eth_cheat_codes.js';
 export * from './eth_cheat_codes_with_state.js';
 export * from './start_anvil.js';
 export * from './tx_delayer.js';
 export * from './upgrade_utils.js';
+export * from './chain_monitor.js';
+export * from './rollup_cheat_codes.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dest/test/index.js

@@ -1,5 +1,8 @@
 export * from './delayed_tx_utils.js';
+export * from './eth_cheat_codes.js';
 export * from './eth_cheat_codes_with_state.js';
 export * from './start_anvil.js';
 export * from './tx_delayer.js';
 export * from './upgrade_utils.js';
+export * from './chain_monitor.js';
+export * from './rollup_cheat_codes.js';

package/dest/test/rollup_cheat_codes.d.ts

@@ -0,0 +1,86 @@
+import { type ViemPublicClient } from '@aztec/ethereum';
+import type { L1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
+import type { DateProvider } from '@aztec/foundation/timer';
+import { RollupAbi } from '@aztec/l1-artifacts/RollupAbi';
+import { type GetContractReturnType, type Hex } from 'viem';
+import { EthCheatCodes } from './eth_cheat_codes.js';
+/** Cheat codes for the L1 rollup contract. */
+export declare class RollupCheatCodes {
+    private ethCheatCodes;
+    private client;
+    private rollup;
+    private logger;
+    constructor(ethCheatCodes: EthCheatCodes, addresses: Pick<L1ContractAddresses, 'rollupAddress'>);
+    static create(rpcUrls: string[], addresses: Pick<L1ContractAddresses, 'rollupAddress'>, dateProvider: DateProvider): RollupCheatCodes;
+    /** Returns the current slot */
+    getSlot(): Promise<bigint>;
+    /** Returns the current epoch */
+    getEpoch(): Promise<bigint>;
+    /**
+     * Returns the pending and proven chain tips
+     * @returns The pending and proven chain tips
+     */
+    getTips(): Promise<{
+        /** The pending chain tip */ pending: bigint;
+        /** The proven chain tip */ proven: bigint;
+    }>;
+    /**
+     * Logs the current state of the rollup contract.
+     */
+    debugRollup(): Promise<void>;
+    /** Fetches the epoch and slot duration config from the rollup contract */
+    getConfig(): Promise<{
+        /** Epoch duration */ epochDuration: bigint;
+        /** Slot duration */ slotDuration: bigint;
+    }>;
+    /**
+     * Advances time to the beginning of the given epoch
+     * @param epoch - The epoch to advance to
+     * @param opts - Options
+     */
+    advanceToEpoch(epoch: bigint | number, opts?: {
+        /** Offset in seconds */
+        offset?: number;
+    }): Promise<bigint>;
+    /** Warps time in L1 until the next epoch */
+    advanceToNextEpoch(): Promise<void>;
+    /** Warps time in L1 until the beginning of the next slot. */
+    advanceToNextSlot(): Promise<bigint[]>;
+    /**
+     * Warps time in L1 equivalent to however many slots.
+     * @param howMany - The number of slots to advance.
+     */
+    advanceSlots(howMany: number): Promise<void>;
+    /**
+     * Marks the specified block (or latest if none) as proven
+     * @param maybeBlockNumber - The block number to mark as proven (defaults to latest pending)
+     */
+    markAsProven(maybeBlockNumber?: number | bigint): Promise<void>;
+    /**
+     * Overrides the inProgress field of the Inbox contract state
+     * @param howMuch - How many blocks to move it forward
+     */
+    advanceInboxInProgress(howMuch: number | bigint): Promise<bigint>;
+    /**
+     * Executes an action impersonated as the owner of the Rollup contract.
+     * @param action - The action to execute
+     */
+    asOwner(action: (owner: Hex, rollup: GetContractReturnType<typeof RollupAbi, ViemPublicClient>) => Promise<void>): Promise<void>;
+    /**
+     * Sets up the epoch.
+     */
+    setupEpoch(): Promise<void>;
+    /** Directly calls the L1 gas fee oracle. */
+    updateL1GasFeeOracle(): Promise<void>;
+    /**
+     * Bumps proving cost per mana.
+     * @param bumper - Callback to calculate the new proving cost per mana based on current value.
+     */
+    bumpProvingCostPerMana(bumper: (before: bigint) => bigint): Promise<void>;
+    /**
+     * Directly updates proving cost per mana.
+     * @param ethValue - The new proving cost per mana in ETH
+     */
+    setProvingCostPerMana(ethValue: bigint): Promise<void>;
+}
+//# sourceMappingURL=rollup_cheat_codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rollup_cheat_codes.d.ts","sourceRoot":"","sources":["../../src/test/rollup_cheat_codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,GAAG,EAMT,MAAM,MAAM,CAAC;AAGd,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,8CAA8C;AAC9C,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,aAAa;IANvB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAA4D;IAE1E,OAAO,CAAC,MAAM,CAAuC;gBAG3C,aAAa,EAAE,aAAa,EACpC,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC;IAavD,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,CAAC,EACrD,YAAY,EAAE,YAAY,GACzB,gBAAgB;IAKnB,+BAA+B;IAClB,OAAO;IAKpB,gCAAgC;IACnB,QAAQ;IAKrB;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC;QAC9B,4BAA4B,CAAC,OAAO,EAAE,MAAM,CAAC;QAC7C,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC;KAC5C,CAAC;IAQF;;OAEG;IACU,WAAW;IAmBxB,0EAA0E;IAC7D,SAAS,IAAI,OAAO,CAAC;QAChC,qBAAqB,CAAC,aAAa,EAAE,MAAM,CAAC;QAC5C,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC;KAC3C,CAAC;IAQF;;;;OAIG;IACU,cAAc,CACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,IAAI,GAAE;QACJ,wBAAwB;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAcR,4CAA4C;IAC/B,kBAAkB;IAa/B,6DAA6D;IAChD,iBAAiB;IAQ9B;;;OAGG;IACU,YAAY,CAAC,OAAO,EAAE,MAAM;IASzC;;;OAGG;IACI,YAAY,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAiCtD;;;OAGG;IACI,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCxE;;;OAGG;IACU,OAAO,CAClB,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,SAAS,EAAE,gBAAgB,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;IAQ1G;;OAEG;IACU,UAAU;IASvB,4CAA4C;IAC/B,oBAAoB;IAQjC;;;OAGG;IACU,sBAAsB,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM;IAMtE;;;OAGG;IACU,qBAAqB,CAAC,QAAQ,EAAE,MAAM;CAWpD"}