@latticexyz/cli 2.0.0-alpha.49 → 2.0.0-alpha.50

package/dist/{chunk-Q7D3SKYJ.js → chunk-5SNB3NQM.js}

@@ -7,7 +7,7 @@ import {
   forge,
   getOutDirectory,
   getScriptDirectory
-} from "./chunk-ATAWDHWC.js";
+} from "./chunk-FPG73MVN.js";
 import {
   resolveAbiOrUserType
 } from "./chunk-5NC2OON2.js";

package/dist/{chunk-SLIMIO4Z.js → chunk-FFY7VTYB.js}

@@ -1,7 +1,7 @@
 import {
   getOutDirectory,
   getSrcDirectory
-} from "./chunk-ATAWDHWC.js";
+} from "./chunk-FPG73MVN.js";
 import {
   __commonJS,
   __require,

package/dist/{chunk-ATAWDHWC.js → chunk-FPG73MVN.js}

@@ -54,6 +54,9 @@ async function cast(args, options) {
     env: { FOUNDRY_PROFILE: options?.profile }
   });
 }
+async function anvil(args) {
+  return execLog("anvil", args);
+}
 
 export {
   getForgeConfig,
@@ -63,5 +66,6 @@ export {
   getOutDirectory,
   getRpcUrl,
   forge,
-  cast
+  cast,
+  anvil
 };

package/dist/mud.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S TS_NODE_COMPILER_OPTIONS={\"module\":\"esnext\"} node --loader=ts-node/esm --no-warnings
 import {
   deploy
-} from "./chunk-Q7D3SKYJ.js";
+} from "./chunk-5SNB3NQM.js";
 import {
   MUDError,
   loadStoreConfig,
@@ -21,13 +21,14 @@ import {
   keccak256,
   resetLibDeploy,
   systemsDir
-} from "./chunk-SLIMIO4Z.js";
+} from "./chunk-FFY7VTYB.js";
 import {
+  anvil,
   forge,
   getRpcUrl,
   getSrcDirectory,
   getTestDirectory
-} from "./chunk-ATAWDHWC.js";
+} from "./chunk-FPG73MVN.js";
 import {
   renderArguments,
   renderImports,
@@ -11451,49 +11452,47 @@ async function getChainId(rpc) {
 }
 
 // src/commands/deploy-v2.ts
-var commandModule15 = {
-  command: "deploy-v2",
-  describe: "Deploy MUD v2 contracts",
-  builder(yargs2) {
-    return yargs2.options({
-      configPath: { type: "string", desc: "Path to the config file" },
-      clean: { type: "boolean", desc: "Remove the build forge artifacts and cache directories before building" },
-      printConfig: { type: "boolean", desc: "Print the resolved config" },
-      profile: { type: "string", desc: "The foundry profile to use" },
-      debug: { type: "boolean", desc: "Print debug logs, like full error messages" },
-      priorityFeeMultiplier: {
-        type: "number",
-        desc: "Multiply the estimated priority fee by the provided factor",
-        default: 1
-      }
-    });
+var yDeployOptions = {
+  configPath: { type: "string", desc: "Path to the config file" },
+  clean: { type: "boolean", desc: "Remove the build forge artifacts and cache directories before building" },
+  printConfig: { type: "boolean", desc: "Print the resolved config" },
+  profile: { type: "string", desc: "The foundry profile to use" },
+  debug: { type: "boolean", desc: "Print debug logs, like full error messages" },
+  priorityFeeMultiplier: {
+    type: "number",
+    desc: "Multiply the estimated priority fee by the provided factor",
+    default: 1
   },
-  async handler(args) {
-    args.profile = args.profile ?? process.env.FOUNDRY_PROFILE;
-    const { configPath, printConfig, profile, clean } = args;
-    const rpc = await getRpcUrl(profile);
-    console.log(
-      chalk4.bgBlue(
-        chalk4.whiteBright(`
+  saveDeployment: { type: "boolean", desc: "Save the deployment info to a file", default: true },
+  rpc: { type: "string", desc: "The RPC URL to use. Defaults to the RPC url from the local foundry.toml" }
+};
+async function deployHandler(args) {
+  args.profile = args.profile ?? process.env.FOUNDRY_PROFILE;
+  const { configPath, printConfig, profile, clean } = args;
+  const rpc = args.rpc ?? await getRpcUrl(profile);
+  console.log(
+    chalk4.bgBlue(
+      chalk4.whiteBright(`
  Deploying MUD v2 contracts${profile ? " with profile " + profile : ""} to RPC ${rpc} 
 `)
-      )
-    );
-    if (clean)
-      await forge(["clean"], { profile });
-    await forge(["build"], { profile });
-    const srcDir = await getSrcDirectory();
-    const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path9) => basename(path9, ".sol"));
-    const worldConfig = await loadWorldConfig(configPath, existingContracts);
-    const storeConfig = await loadStoreConfig(configPath);
-    const mudConfig = { ...worldConfig, ...storeConfig };
-    if (printConfig)
-      console.log(chalk4.green("\nResolved config:\n"), JSON.stringify(mudConfig, null, 2));
-    try {
-      const privateKey = process.env.PRIVATE_KEY;
-      if (!privateKey)
-        throw new MUDError("Missing PRIVATE_KEY environment variable");
-      const deploymentInfo = await deploy(mudConfig, { ...args, rpc, privateKey });
+    )
+  );
+  if (clean)
+    await forge(["clean"], { profile });
+  await forge(["build"], { profile });
+  const srcDir = await getSrcDirectory();
+  const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path9) => basename(path9, ".sol"));
+  const worldConfig = await loadWorldConfig(configPath, existingContracts);
+  const storeConfig = await loadStoreConfig(configPath);
+  const mudConfig = { ...worldConfig, ...storeConfig };
+  if (printConfig)
+    console.log(chalk4.green("\nResolved config:\n"), JSON.stringify(mudConfig, null, 2));
+  try {
+    const privateKey = process.env.PRIVATE_KEY;
+    if (!privateKey)
+      throw new MUDError("Missing PRIVATE_KEY environment variable");
+    const deploymentInfo = await deploy(mudConfig, { ...args, rpc, privateKey });
+    if (args.saveDeployment) {
       const chainId = await getChainId(rpc);
       const outputDir = path5.join(mudConfig.deploysDirectory, chainId.toString());
       mkdirSync(outputDir, { recursive: true });
@@ -11502,11 +11501,22 @@ var commandModule15 = {
       console.log(chalk4.bgGreen(chalk4.whiteBright(`
  Deployment result (written to ${outputDir}): 
 `)));
-      console.log(deploymentInfo);
-    } catch (error) {
-      logError(error);
-      process.exit(1);
     }
+    console.log(deploymentInfo);
+    return deploymentInfo;
+  } catch (error) {
+    logError(error);
+    process.exit(1);
+  }
+}
+var commandModule15 = {
+  command: "deploy-v2",
+  describe: "Deploy MUD v2 contracts",
+  builder(yargs2) {
+    return yargs2.options(yDeployOptions);
+  },
+  async handler(args) {
+    await deployHandler(args);
     process.exit(0);
   }
 };
@@ -11749,7 +11759,7 @@ import path8 from "path";
 // package.json
 var package_default = {
   name: "@latticexyz/cli",
-  version: "2.0.0-alpha.49+7d06c1b5",
+  version: "2.0.0-alpha.50+d6be8b08",
   description: "Command line interface for mud",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -11776,7 +11786,7 @@ var package_default = {
     release: "npm publish --access=public"
   },
   devDependencies: {
-    "@latticexyz/store": "^2.0.0-alpha.49+7d06c1b5",
+    "@latticexyz/store": "^2.0.0-alpha.50+d6be8b08",
     "@types/ejs": "^3.1.1",
     "@types/glob": "^7.2.0",
     "@types/node": "^17.0.34",
@@ -11789,10 +11799,10 @@ var package_default = {
   dependencies: {
     "@improbable-eng/grpc-web": "^0.15.0",
     "@improbable-eng/grpc-web-node-http-transport": "^0.15.0",
-    "@latticexyz/schema-type": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/services": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/solecs": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/std-contracts": "^2.0.0-alpha.49+7d06c1b5",
+    "@latticexyz/schema-type": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/services": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/solecs": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/std-contracts": "^2.0.0-alpha.50+d6be8b08",
     "@solidity-parser/parser": "^0.16.0",
     "@typechain/ethers-v5": "^10.1.1",
     chalk: "^5.0.1",
@@ -11819,7 +11829,7 @@ var package_default = {
     zod: "^3.21.4",
     "zod-validation-error": "^1.0.1"
   },
-  gitHead: "7d06c1b5cf00df627000c907e78f60d3cd2415cd"
+  gitHead: "d6be8b08d0eeae3b10eb9e7bffb6d4dd2fc58aa0"
 };
 
 // src/commands/set-version.ts
@@ -11938,6 +11948,52 @@ function logComparison(prev, curr) {
 }
 var set_version_default = commandModule17;
 
+// src/commands/test-v2.ts
+import chalk6 from "chalk";
+import { rmSync as rmSync5, writeFileSync as writeFileSync4 } from "fs";
+var WORLD_ADDRESS_FILE = ".mudtest";
+var commandModule18 = {
+  command: "test-v2",
+  describe: "Run tests in MUD v2 contracts",
+  builder(yargs2) {
+    return yargs2.options({
+      ...yDeployOptions,
+      port: { type: "number", description: "Port to run internal node for fork testing on", default: 4242 },
+      worldAddress: {
+        type: "string",
+        description: "Address of an existing world contract. If provided, deployment is skipped and the RPC provided in the foundry.toml is used for fork testing."
+      },
+      forgeOptions: { type: "string", description: "Options to pass to forge test" }
+    });
+  },
+  async handler(args) {
+    if (!args.worldAddress) {
+      const anvilArgs = ["--block-base-fee-per-gas", "0", "--port", String(args.port)];
+      anvil(anvilArgs);
+    }
+    const forkRpc = args.worldAddress ? await getRpcUrl(args.profile) : `http://127.0.0.1:${args.port}`;
+    const worldAddress = args.worldAddress ?? (await deployHandler({
+      ...args,
+      saveDeployment: false,
+      rpc: forkRpc
+    })).worldAddress;
+    console.log(chalk6.blue("World address", worldAddress));
+    writeFileSync4(WORLD_ADDRESS_FILE, worldAddress);
+    const userOptions = args.forgeOptions?.replaceAll("\\", "").split(" ") ?? [];
+    try {
+      const testResult = await forge(["test", "--fork-url", forkRpc, ...userOptions], {
+        profile: args.profile
+      });
+      console.log(testResult);
+    } catch (e) {
+      console.error(e);
+    }
+    rmSync5(WORLD_ADDRESS_FILE);
+    process.exit(0);
+  }
+};
+var test_v2_default = commandModule18;
+
 // src/commands/index.ts
 var commands = [
   bulkupload_default,
@@ -11956,7 +12012,8 @@ var commands = [
   trace_default,
   types_default,
   worldgen_default,
-  set_version_default
+  set_version_default,
+  test_v2_default
 ];
 
 // src/mud.ts

package/dist/utils/deprecated/index.js

@@ -14,8 +14,8 @@ import {
   hsr,
   keccak256,
   resetLibDeploy
-} from "../../chunk-SLIMIO4Z.js";
-import "../../chunk-ATAWDHWC.js";
+} from "../../chunk-FFY7VTYB.js";
+import "../../chunk-FPG73MVN.js";
 import "../../chunk-O6HOO6WA.js";
 export {
   IDregex,

package/dist/utils/index.d.ts

@@ -75,6 +75,12 @@ declare function forge(args: string[], options?: {
 declare function cast(args: string[], options?: {
     profile?: string;
 }): Promise<string>;
+/**
+ * Start an anvil chain
+ * @param args The arguments to pass to anvil
+ * @returns Stdout of the command
+ */
+declare function anvil(args: string[]): Promise<string>;
 
 declare function formatSolidity(content: string, prettierConfigPath?: string): Promise<string>;
 declare function formatTypescript(content: string): Promise<string>;
@@ -95,4 +101,4 @@ interface DeploymentInfo {
 }
 declare function deploy(mudConfig: MUDConfig, deployConfig: DeployConfig): Promise<DeploymentInfo>;
 
-export { DeployConfig, DeploymentInfo, ForgeConfig, MUDError, NotESMConfigError, NotInsideProjectError, UnrecognizedSystemErrorFactory, cast, deploy, forge, formatAndWriteSolidity, formatAndWriteTypescript, formatSolidity, formatTypescript, fromZodErrorCustom, getForgeConfig, getOutDirectory, getRpcUrl, getScriptDirectory, getSrcDirectory, getTestDirectory, logError };
+export { DeployConfig, DeploymentInfo, ForgeConfig, MUDError, NotESMConfigError, NotInsideProjectError, UnrecognizedSystemErrorFactory, anvil, cast, deploy, forge, formatAndWriteSolidity, formatAndWriteTypescript, formatSolidity, formatTypescript, fromZodErrorCustom, getForgeConfig, getOutDirectory, getRpcUrl, getScriptDirectory, getSrcDirectory, getTestDirectory, logError };

package/dist/utils/index.js

@@ -1,6 +1,6 @@
 import {
   deploy
-} from "../chunk-Q7D3SKYJ.js";
+} from "../chunk-5SNB3NQM.js";
 import {
   MUDError,
   NotESMConfigError,
@@ -10,6 +10,7 @@ import {
   logError
 } from "../chunk-LPWKZQUI.js";
 import {
+  anvil,
   cast,
   forge,
   getForgeConfig,
@@ -18,7 +19,7 @@ import {
   getScriptDirectory,
   getSrcDirectory,
   getTestDirectory
-} from "../chunk-ATAWDHWC.js";
+} from "../chunk-FPG73MVN.js";
 import {
   formatAndWriteSolidity,
   formatAndWriteTypescript,
@@ -32,6 +33,7 @@ export {
   NotESMConfigError,
   NotInsideProjectError,
   UnrecognizedSystemErrorFactory,
+  anvil,
   cast,
   deploy,
   forge,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@latticexyz/cli",
-  "version": "2.0.0-alpha.49+7d06c1b5",
+  "version": "2.0.0-alpha.50+d6be8b08",
   "description": "Command line interface for mud",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +27,7 @@
     "release": "npm publish --access=public"
   },
   "devDependencies": {
-    "@latticexyz/store": "^2.0.0-alpha.49+7d06c1b5",
+    "@latticexyz/store": "^2.0.0-alpha.50+d6be8b08",
     "@types/ejs": "^3.1.1",
     "@types/glob": "^7.2.0",
     "@types/node": "^17.0.34",
@@ -40,10 +40,10 @@
   "dependencies": {
     "@improbable-eng/grpc-web": "^0.15.0",
     "@improbable-eng/grpc-web-node-http-transport": "^0.15.0",
-    "@latticexyz/schema-type": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/services": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/solecs": "^2.0.0-alpha.49+7d06c1b5",
-    "@latticexyz/std-contracts": "^2.0.0-alpha.49+7d06c1b5",
+    "@latticexyz/schema-type": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/services": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/solecs": "^2.0.0-alpha.50+d6be8b08",
+    "@latticexyz/std-contracts": "^2.0.0-alpha.50+d6be8b08",
     "@solidity-parser/parser": "^0.16.0",
     "@typechain/ethers-v5": "^10.1.1",
     "chalk": "^5.0.1",
@@ -70,5 +70,5 @@
     "zod": "^3.21.4",
     "zod-validation-error": "^1.0.1"
   },
-  "gitHead": "7d06c1b5cf00df627000c907e78f60d3cd2415cd"
+  "gitHead": "d6be8b08d0eeae3b10eb9e7bffb6d4dd2fc58aa0"
 }

package/src/commands/deploy-v2.ts

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 import glob from "glob";
 import path, { basename } from "path";
-import type { CommandModule } from "yargs";
+import type { CommandModule, Options } from "yargs";
 import { loadWorldConfig } from "../config/world/index.js";
 import { deploy } from "../utils/deploy-v2.js";
 import { logError, MUDError } from "../utils/errors.js";
@@ -10,71 +10,68 @@ import { mkdirSync, writeFileSync } from "fs";
 import { loadStoreConfig } from "../config/loadStoreConfig.js";
 import { getChainId } from "../utils/getChainId.js";
 
-type Options = {
+export type DeployOptions = {
   configPath?: string;
   printConfig?: boolean;
   profile?: string;
-  privateKey: string;
   priorityFeeMultiplier: number;
   clean?: boolean;
   debug?: boolean;
+  saveDeployment?: boolean;
+  rpc?: string;
 };
 
-const commandModule: CommandModule<Options, Options> = {
-  command: "deploy-v2",
-
-  describe: "Deploy MUD v2 contracts",
-
-  builder(yargs) {
-    return yargs.options({
-      configPath: { type: "string", desc: "Path to the config file" },
-      clean: { type: "boolean", desc: "Remove the build forge artifacts and cache directories before building" },
-      printConfig: { type: "boolean", desc: "Print the resolved config" },
-      profile: { type: "string", desc: "The foundry profile to use" },
-      debug: { type: "boolean", desc: "Print debug logs, like full error messages" },
-      priorityFeeMultiplier: {
-        type: "number",
-        desc: "Multiply the estimated priority fee by the provided factor",
-        default: 1,
-      },
-    });
+export const yDeployOptions = {
+  configPath: { type: "string", desc: "Path to the config file" },
+  clean: { type: "boolean", desc: "Remove the build forge artifacts and cache directories before building" },
+  printConfig: { type: "boolean", desc: "Print the resolved config" },
+  profile: { type: "string", desc: "The foundry profile to use" },
+  debug: { type: "boolean", desc: "Print debug logs, like full error messages" },
+  priorityFeeMultiplier: {
+    type: "number",
+    desc: "Multiply the estimated priority fee by the provided factor",
+    default: 1,
   },
-
-  async handler(args) {
-    args.profile = args.profile ?? process.env.FOUNDRY_PROFILE;
-    const { configPath, printConfig, profile, clean } = args;
-
-    const rpc = await getRpcUrl(profile);
-    console.log(
-      chalk.bgBlue(
-        chalk.whiteBright(`\n Deploying MUD v2 contracts${profile ? " with profile " + profile : ""} to RPC ${rpc} \n`)
-      )
-    );
-
-    if (clean) await forge(["clean"], { profile });
-
-    // Run forge build
-    await forge(["build"], { profile });
-
-    // Get a list of all contract names
-    const srcDir = await getSrcDirectory();
-    const existingContracts = glob
-      .sync(`${srcDir}/**/*.sol`)
-      // Get the basename of the file
-      .map((path) => basename(path, ".sol"));
-
-    // Load and resolve the config
-    const worldConfig = await loadWorldConfig(configPath, existingContracts);
-    const storeConfig = await loadStoreConfig(configPath);
-    const mudConfig = { ...worldConfig, ...storeConfig };
-
-    if (printConfig) console.log(chalk.green("\nResolved config:\n"), JSON.stringify(mudConfig, null, 2));
-
-    try {
-      const privateKey = process.env.PRIVATE_KEY;
-      if (!privateKey) throw new MUDError("Missing PRIVATE_KEY environment variable");
-      const deploymentInfo = await deploy(mudConfig, { ...args, rpc, privateKey });
-
+  saveDeployment: { type: "boolean", desc: "Save the deployment info to a file", default: true },
+  rpc: { type: "string", desc: "The RPC URL to use. Defaults to the RPC url from the local foundry.toml" },
+} satisfies Record<keyof DeployOptions, Options>;
+
+export async function deployHandler(args: Parameters<(typeof commandModule)["handler"]>[0]) {
+  args.profile = args.profile ?? process.env.FOUNDRY_PROFILE;
+  const { configPath, printConfig, profile, clean } = args;
+
+  const rpc = args.rpc ?? (await getRpcUrl(profile));
+  console.log(
+    chalk.bgBlue(
+      chalk.whiteBright(`\n Deploying MUD v2 contracts${profile ? " with profile " + profile : ""} to RPC ${rpc} \n`)
+    )
+  );
+
+  if (clean) await forge(["clean"], { profile });
+
+  // Run forge build
+  await forge(["build"], { profile });
+
+  // Get a list of all contract names
+  const srcDir = await getSrcDirectory();
+  const existingContracts = glob
+    .sync(`${srcDir}/**/*.sol`)
+    // Get the basename of the file
+    .map((path) => basename(path, ".sol"));
+
+  // Load and resolve the config
+  const worldConfig = await loadWorldConfig(configPath, existingContracts);
+  const storeConfig = await loadStoreConfig(configPath);
+  const mudConfig = { ...worldConfig, ...storeConfig };
+
+  if (printConfig) console.log(chalk.green("\nResolved config:\n"), JSON.stringify(mudConfig, null, 2));
+
+  try {
+    const privateKey = process.env.PRIVATE_KEY;
+    if (!privateKey) throw new MUDError("Missing PRIVATE_KEY environment variable");
+    const deploymentInfo = await deploy(mudConfig, { ...args, rpc, privateKey });
+
+    if (args.saveDeployment) {
       // Write deployment result to file (latest and timestamp)
       const chainId = await getChainId(rpc);
       const outputDir = path.join(mudConfig.deploysDirectory, chainId.toString());
@@ -83,12 +80,27 @@ const commandModule: CommandModule<Options, Options> = {
       writeFileSync(path.join(outputDir, Date.now() + ".json"), JSON.stringify(deploymentInfo, null, 2));
 
       console.log(chalk.bgGreen(chalk.whiteBright(`\n Deployment result (written to ${outputDir}): \n`)));
-      console.log(deploymentInfo);
-    } catch (error: any) {
-      logError(error);
-      process.exit(1);
     }
 
+    console.log(deploymentInfo);
+    return deploymentInfo;
+  } catch (error: any) {
+    logError(error);
+    process.exit(1);
+  }
+}
+
+const commandModule: CommandModule<DeployOptions, DeployOptions> = {
+  command: "deploy-v2",
+
+  describe: "Deploy MUD v2 contracts",
+
+  builder(yargs) {
+    return yargs.options(yDeployOptions);
+  },
+
+  async handler(args) {
+    await deployHandler(args);
     process.exit(0);
   },
 };

package/src/commands/index.ts

@@ -18,6 +18,7 @@ import tsgen from "./tsgen.js";
 import deployV2 from "./deploy-v2.js";
 import worldgen from "./worldgen.js";
 import setVersion from "./set-version.js";
+import testV2 from "./test-v2.js";
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Each command has different options
 export const commands: CommandModule<any, any>[] = [
@@ -38,4 +39,5 @@ export const commands: CommandModule<any, any>[] = [
   types,
   worldgen,
   setVersion,
+  testV2,
 ];

package/src/commands/test-v2.ts

@@ -0,0 +1,71 @@
+import type { CommandModule } from "yargs";
+import { deployHandler, DeployOptions } from "./deploy-v2.js";
+import { yDeployOptions } from "./deploy-v2.js";
+import { anvil, forge, getRpcUrl, getTestDirectory } from "../utils/foundry.js";
+import chalk from "chalk";
+import { rmSync, writeFileSync } from "fs";
+import path from "path";
+
+type Options = DeployOptions & { port?: number; worldAddress?: string; forgeOptions?: string };
+
+const WORLD_ADDRESS_FILE = ".mudtest";
+
+const commandModule: CommandModule<Options, Options> = {
+  command: "test-v2",
+
+  describe: "Run tests in MUD v2 contracts",
+
+  builder(yargs) {
+    return yargs.options({
+      ...yDeployOptions,
+      port: { type: "number", description: "Port to run internal node for fork testing on", default: 4242 },
+      worldAddress: {
+        type: "string",
+        description:
+          "Address of an existing world contract. If provided, deployment is skipped and the RPC provided in the foundry.toml is used for fork testing.",
+      },
+      forgeOptions: { type: "string", description: "Options to pass to forge test" },
+    });
+  },
+
+  async handler(args) {
+    // Start an internal anvil process if no world address is provided
+    if (!args.worldAddress) {
+      const anvilArgs = ["--block-base-fee-per-gas", "0", "--port", String(args.port)];
+      anvil(anvilArgs);
+    }
+
+    const forkRpc = args.worldAddress ? await getRpcUrl(args.profile) : `http://127.0.0.1:${args.port}`;
+
+    const worldAddress =
+      args.worldAddress ??
+      (
+        await deployHandler({
+          ...args,
+          saveDeployment: false,
+          rpc: forkRpc,
+        })
+      ).worldAddress;
+
+    console.log(chalk.blue("World address", worldAddress));
+
+    // Create a temporary file to pass the world address to the tests
+    writeFileSync(WORLD_ADDRESS_FILE, worldAddress);
+
+    const userOptions = args.forgeOptions?.replaceAll("\\", "").split(" ") ?? [];
+    try {
+      const testResult = await forge(["test", "--fork-url", forkRpc, ...userOptions], {
+        profile: args.profile,
+      });
+      console.log(testResult);
+    } catch (e) {
+      console.error(e);
+    }
+
+    rmSync(WORLD_ADDRESS_FILE);
+
+    process.exit(0);
+  },
+};
+
+export default commandModule;

package/src/utils/foundry.ts

@@ -92,3 +92,12 @@ export async function cast(args: string[], options?: { profile?: string }): Prom
     env: { FOUNDRY_PROFILE: options?.profile },
   });
 }
+
+/**
+ * Start an anvil chain
+ * @param args The arguments to pass to anvil
+ * @returns Stdout of the command
+ */
+export async function anvil(args: string[]): Promise<string> {
+  return execLog("anvil", args);
+}