feat(cli): add --anvil-arg option to run command

.changeset/anvil-extra-args.md

@@ -0,0 +1,5 @@
+---
+"@cartesi/cli": minor
+---
+
+add `--anvil-arg` option to `cartesi run` to pass extra arguments to anvil

apps/cli/src/commands/run.ts

@@ -309,6 +309,12 @@ export const createRunCommand = () => {
                 "deploy application with PRT consensus",
             ).default(false),
         )
+        .option(
+            "--anvil-arg <arg>",
+            "extra argument passed verbatim to anvil, can be repeated (e.g. --anvil-arg=--slots-in-an-epoch=1)",
+            (value, prev: string[]) => prev.concat([value]),
+            [] as string[],
+        )
         .addOption(
             new Option(
                 "--block-time <number>",
@@ -394,6 +400,7 @@ export const createRunCommand = () => {
         .option("-v, --verbose", "verbose output", false)
         .action(async (options, program) => {
             const {
+                anvilArg: anvilArgs,
                 prt,
                 blockTime,
                 cpus,
@@ -456,6 +463,7 @@ export const createRunCommand = () => {
 
             // run compose environment (detached)
             const { cmd, config } = await startEnvironment({
+                anvilArgs,
                 blockTime,
                 cpus,
                 defaultBlock,

apps/cli/src/compose/anvil.ts

@@ -6,16 +6,18 @@ type ServiceOptions = {
     imageTag?: string;
     blockTime?: number;
     forkConfig?: ForkConfig;
+    extraArgs?: string[];
 };
 
 // Anvil service
 const service = (options?: ServiceOptions): Service => {
     const blockTime = options?.blockTime ?? 2;
     const imageTag = options?.imageTag ?? "latest";
     const forkConfig = options?.forkConfig;
+    const extraArgs = options?.extraArgs ?? [];
 
     // command for fork and command for load-state local (non-fork)
-    const command = forkConfig
+    const baseCommand = forkConfig
         ? [
               "anvil",
               "--chain-id",
@@ -30,6 +32,9 @@ const service = (options?: ServiceOptions): Service => {
           ]
         : ["devnet", "--block-time", blockTime.toString()];
 
+    // extra arguments passed verbatim to anvil
+    const command = [...baseCommand, ...extraArgs];
+
     // in case of forked network service is ready only when it responds with target block number
     const test = forkConfig?.blockNumber
         ? ["CMD", "eth_isready", forkConfig.blockNumber?.toString()]

apps/cli/src/exec/rollups.ts

@@ -314,6 +314,7 @@ const serviceMonitorTask = (options: {
 };
 
 export const startEnvironment = async (options: {
+    anvilArgs?: string[];
     blockTime: number;
     cpus?: number;
     defaultBlock: "latest" | "safe" | "pending" | "finalized";
@@ -343,6 +344,7 @@ export const startEnvironment = async (options: {
         services,
         verbose,
     } = options;
+    const anvilArgs = options.anvilArgs ?? [];
 
     // setup the environment variable used in docker compose
     const env: NodeJS.ProcessEnv = {
@@ -360,6 +362,7 @@ export const startEnvironment = async (options: {
     const files = [
         anvil({
             blockTime,
+            extraArgs: anvilArgs,
             forkConfig,
             imageTag: runtimeVersion,
         }),

apps/cli/tests/integration/builder/docker.test.ts

@@ -5,6 +5,7 @@ import {
     describe,
     expect,
     it,
+    setDefaultTimeout,
 } from "bun:test";
 import fs from "fs-extra";
 import path from "node:path";
@@ -14,6 +15,9 @@ import type { DockerDriveConfig } from "../../../src/config.js";
 import { setupIntegrationTests, TEST_SDK } from "../config.js";
 import { cleanupTempDir, createTempDir } from "./tmpdirTest.js";
 
+// building pulls the base image on a cold docker cache, which can exceed the default 5s timeout
+setDefaultTimeout(60000);
+
 beforeAll(
     async () => {
         tmp.setGracefulCleanup();

apps/cli/tests/unit/compose/anvil.test.ts

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "bun:test";
+import anvil from "../../../src/compose/anvil.js";
+
+describe("compose anvil", () => {
+    it("should run devnet with block time by default", () => {
+        const { services } = anvil();
+        expect(services?.anvil?.command).toEqual([
+            "devnet",
+            "--block-time",
+            "2",
+        ]);
+    });
+
+    it("should append extra args to devnet command", () => {
+        const { services } = anvil({
+            blockTime: 5,
+            extraArgs: ["--slots-in-an-epoch=1", "--gas-limit", "60000000"],
+        });
+        expect(services?.anvil?.command).toEqual([
+            "devnet",
+            "--block-time",
+            "5",
+            "--slots-in-an-epoch=1",
+            "--gas-limit",
+            "60000000",
+        ]);
+    });
+
+    it("should append extra args to fork command", () => {
+        const { services } = anvil({
+            forkConfig: {
+                url: "http://localhost:8545",
+                blockNumber: 10n,
+                chainId: 1,
+            },
+            extraArgs: ["--slots-in-an-epoch=1"],
+        });
+        expect(services?.anvil?.command).toEqual([
+            "anvil",
+            "--chain-id",
+            "31337",
+            "--block-time",
+            "2",
+            "--fork-url",
+            "http://localhost:8545",
+            "--fork-block-number",
+            "10",
+            "--slots-in-an-epoch=1",
+        ]);
+    });
+});