feat: Add CLI command to advance epoch

yarn-project/aztec.js/src/utils/cheat_codes.ts

@@ -42,6 +42,11 @@ export class CheatCodes {
     );
     return new CheatCodes(ethCheatCodes, aztecCheatCodes, rollupCheatCodes);
   }
+
+  static createRollup(rpcUrl: string, addresses: Pick<L1ContractAddresses, 'rollupAddress'>): RollupCheatCodes {
+    const ethCheatCodes = new EthCheatCodes(rpcUrl);
+    return new RollupCheatCodes(ethCheatCodes, addresses);
+  }
 }
 
 /**

yarn-project/cli/src/cmds/l1/advance_epoch.ts

@@ -0,0 +1,12 @@
+import { CheatCodes, createPXEClient, makeFetch } from '@aztec/aztec.js';
+import { type LogFn } from '@aztec/foundation/log';
+
+export async function advanceEpoch(l1RpcUrl: string, rpcUrl: string, log: LogFn) {
+  const pxe = createPXEClient(rpcUrl, makeFetch([], true));
+  const rollupAddress = await pxe.getNodeInfo().then(i => i.l1ContractAddresses.rollupAddress);
+
+  const cheat = CheatCodes.createRollup(l1RpcUrl, { rollupAddress });
+
+  await cheat.advanceToNextEpoch();
+  log(`Warped time to advance to next epoch`);
+}

yarn-project/cli/src/cmds/l1/index.ts

@@ -277,6 +277,20 @@ export function injectCommands(program: Command, log: LogFn, debugLogger: DebugL
       );
     });
 
+  program
+    .command('advance-epoch')
+    .description('Use L1 cheat codes to warp time until the next epoch.')
+    .requiredOption(
+      '--l1-rpc-url <string>',
+      'Url of the ethereum host. Chain identifiers localhost and testnet can be used',
+      ETHEREUM_HOST,
+    )
+    .addOption(pxeOption)
+    .action(async options => {
+      const { advanceEpoch } = await import('./advance_epoch.js');
+      await advanceEpoch(options.l1RpcUrl, options.rpcUrl, log);
+    });
+
   program
     .command('prover-stats', { hidden: true })
     .requiredOption(