@latticexyz/cli 2.0.0-alpha.1.131 → 2.0.0-alpha.1.132

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/dist/{chunk-Q6MSATUV.js → chunk-ZL3JKKJB.js} +12 -12
  2. package/dist/chunk-ZL3JKKJB.js.map +1 -0
  3. package/dist/index.js +1 -1
  4. package/dist/mud.js +17 -10
  5. package/dist/mud.js.map +1 -1
  6. package/package.json +12 -10
  7. package/src/commands/deploy.ts +1 -0
  8. package/src/commands/dev-contracts.ts +167 -0
  9. package/src/commands/index.ts +2 -0
  10. package/src/commands/worldgen.ts +21 -17
  11. package/src/mud.ts +7 -0
  12. package/src/utils/deployHandler.ts +3 -2
  13. package/src/utils/index.ts +2 -0
  14. package/src/utils/printMUD.ts +14 -0
  15. package/src/utils/worldtypes.ts +21 -0
  16. package/dist/chunk-Q6MSATUV.js.map +0 -1
package/dist/mud.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/mud.ts","../src/commands/devnode.ts","../src/commands/faucet.ts","../src/commands/gas-report.ts","../src/commands/hello.ts","../src/commands/tablegen.ts","../src/commands/tsgen.ts","../src/utils/errors.ts","../src/commands/deploy.ts","../src/commands/worldgen.ts","../src/commands/set-version.ts","../package.json","../src/commands/test.ts","../src/commands/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport { commands } from \"./commands\";\nimport { logError } from \"./utils/errors\";\n\n// Load .env file into process.env\nimport * as dotenv from \"dotenv\";\ndotenv.config();\n\nyargs(hideBin(process.argv))\n // Explicit name to display in help (by default it's the entry file, which may not be \"mud\" for e.g. ts-node)\n .scriptName(\"mud\")\n // Use the commands directory to scaffold\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- command array overload isn't typed, see https://github.com/yargs/yargs/blob/main/docs/advanced.md#esm-hierarchy\n .command(commands as any)\n // Enable strict mode.\n .strict()\n // Custom error handler\n .fail((msg, err) => {\n console.log(\"\");\n logError(err);\n console.log(\"\");\n\n process.exit(1);\n })\n // Useful aliases.\n .alias({ h: \"help\" }).argv;\n","import { rmSync } from \"fs\";\nimport { homedir } from \"os\";\nimport path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { execa } from \"execa\";\n\ntype Options = {\n blocktime: number;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"devnode\",\n\n describe: \"Start a local Ethereum node for development\",\n\n builder(yargs) {\n return yargs.options({\n blocktime: { type: \"number\", default: 1, decs: \"Interval in which new blocks are produced\" },\n });\n },\n\n async handler({ blocktime }) {\n console.log(\"Clearing devnode history\");\n const userHomeDir = homedir();\n rmSync(path.join(userHomeDir, \".foundry\", \"anvil\", \"tmp\"), { recursive: true, force: true });\n\n const anvilArgs = [\"-b\", String(blocktime), \"--block-base-fee-per-gas\", \"0\"];\n console.log(`Running: anvil ${anvilArgs.join(\" \")}`);\n const child = execa(\"anvil\", anvilArgs, {\n stdio: [\"inherit\", \"inherit\", \"inherit\"],\n });\n\n process.on(\"SIGINT\", () => {\n console.log(\"\\ngracefully shutting down from SIGINT (Crtl-C)\");\n child.kill();\n process.exit();\n });\n await child;\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { FaucetServiceDefinition } from \"@latticexyz/services/faucet\";\nimport { createChannel, createClient } from \"nice-grpc-web\";\nimport chalk from \"chalk\";\nimport { NodeHttpTransport } from \"@improbable-eng/grpc-web-node-http-transport\";\n\ntype Options = {\n dripDev?: boolean;\n faucetUrl: string;\n address: string;\n};\n\n/**\n * Create a FaucetServiceClient\n * @param url FaucetService URL\n * @returns FaucetServiceClient\n */\nfunction createFaucetService(url: string) {\n return createClient(FaucetServiceDefinition, createChannel(url, NodeHttpTransport()));\n}\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"faucet\",\n\n describe: \"Interact with a MUD faucet\",\n\n builder(yargs) {\n return yargs.options({\n dripDev: {\n type: \"boolean\",\n desc: \"Request a drip from the dev endpoint (requires faucet to have dev mode enabled)\",\n default: true,\n },\n faucetUrl: {\n type: \"string\",\n desc: \"URL of the MUD faucet\",\n default: \"https://faucet.testnet-mud-services.linfra.xyz\",\n },\n address: {\n type: \"string\",\n desc: \"Ethereum address to fund\",\n required: true,\n },\n });\n },\n\n async handler({ dripDev, faucetUrl, address }) {\n const faucet = createFaucetService(faucetUrl);\n\n if (dripDev) {\n console.log(chalk.yellow(\"Dripping to\", address));\n await faucet.dripDev({ address });\n console.log(chalk.yellow(\"Success\"));\n }\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { readFileSync, writeFileSync, rmSync } from \"fs\";\nimport { execa } from \"execa\";\nimport chalk from \"chalk\";\nimport { table, getBorderCharacters } from \"table\";\n\n/**\n * Print the gas report to the console, save it to a file and compare it to a previous gas report if provided.\n * Requires forge to be installed, and gas test files including `// !gasreport` comments, like this:\n *\n * ```solidity\n * contract GasTest is DSTestPlus {\n * function testBuffer() public pure {\n * // !gasreport allocate a buffer\n * Buffer buffer = Buffer_.allocate(32);\n *\n * bytes32 value = keccak256(\"some data\");\n *\n * // !gasreport append 32 bytes to a buffer\n * buffer.append(value);\n * }\n * }\n * ```\n */\n\ntype Options = {\n path: string[];\n save?: string;\n compare?: string;\n};\n\ntype GasReportEntry = {\n source: string;\n name: string;\n functionCall: string;\n gasUsed: number;\n prevGasUsed?: number;\n};\n\ntype GasReport = GasReportEntry[];\n\nconst tempFileSuffix = \"MudGasReport\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"gas-report\",\n\n describe: \"Create a gas report\",\n\n builder(yargs) {\n return yargs.options({\n path: { type: \"array\", string: true, default: [\"Gas.t.sol\"], desc: \"File containing the gas tests\" },\n save: { type: \"string\", desc: \"Save the gas report to a file\" },\n compare: { type: \"string\", desc: \"Compare to an existing gas report\" },\n });\n },\n\n async handler({ path: files, save, compare }) {\n const validFiles = files.filter((file) => file.endsWith(\".t.sol\"));\n const tempFiles = await Promise.all(validFiles.map((file) => createGasReport(file)));\n\n process.once(\"SIGINT\", () => {\n console.log(\"caught sigint, deleting temp files\");\n tempFiles.forEach((file) => rmSync(file));\n });\n\n let gasReport: GasReport;\n try {\n gasReport = await runGasReport();\n } catch {\n setTimeout(() => process.exit());\n return;\n } finally {\n // Delete the temporary files\n tempFiles.forEach((file) => rmSync(file));\n }\n\n // If this gas report should be compared to an existing one, load the existing one\n if (compare) {\n try {\n const compareGasReport: GasReport = JSON.parse(readFileSync(compare, \"utf8\"));\n // Merge the previous gas report with the new one\n gasReport = gasReport.map((entry) => {\n const prevEntry = compareGasReport.find(\n (e) => e.name === entry.name && e.functionCall === entry.functionCall\n );\n return { ...entry, prevGasUsed: prevEntry?.gasUsed };\n });\n } catch {\n console.log(chalk.red(`Gas report to compare not found: ${compare}`));\n compare = undefined;\n }\n }\n\n // Print gas report\n printGasReport(gasReport, compare);\n\n // Save gas report to file if requested\n if (save) saveGasReport(gasReport, save);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n\nasync function createGasReport(filename: string): Promise<string> {\n console.log(\"Creating gas report for\", chalk.bold(filename));\n\n // Parse the given test file, and add gas reporting wherever requested by a `// !gasreport` comment\n const fileContents = readFileSync(filename, \"utf8\");\n let newFile = fileContents;\n\n // Use a regex to find first line of each function\n const functionRegex = new RegExp(/function (.*){/g);\n // Insert a line to declare the _gasreport variable at the start of each function\n let functionMatch;\n while ((functionMatch = functionRegex.exec(fileContents)) !== null) {\n const functionSignature = functionMatch[0];\n newFile = newFile.replace(functionSignature, `${functionSignature}\\nuint256 _gasreport;`);\n }\n\n // A gasreport comment has a name (written after the comment) and a function call (written on the next line)\n // Create a regex to extract both the name and the function call\n const regex = new RegExp(/\\/\\/ !gasreport (.*)\\n(.*)/g);\n\n // Apply the regex and loop through the matches,\n // and create a new file with the gasreport comments replaced by the gas report\n let match;\n while ((match = regex.exec(fileContents)) !== null) {\n const name = match[1];\n const functionCall = match[2].trim();\n\n newFile = newFile.replace(\n match[0],\n `\n_gasreport = gasleft();\n${functionCall}\n_gasreport = _gasreport - gasleft();\nconsole.log(\"GAS REPORT(${filename}): ${name} [${functionCall.replaceAll('\"', '\\\\\"')}]:\", _gasreport);`\n );\n }\n\n // Remove all occurrences of `pure` with `view`\n newFile = newFile.replace(/pure/g, \"view\");\n\n // Write the new file to disk (temporarily)\n // Create the temp file by replacing the previous file name with MudGasReport\n const tempFileName = filename.replace(/\\.t\\.sol$/, `${tempFileSuffix}.t.sol`);\n writeFileSync(tempFileName, newFile);\n\n return tempFileName;\n}\n\nasync function runGasReport(): Promise<GasReport> {\n console.log(\"Running gas report\");\n const gasReport: GasReport = [];\n\n // Extract the logs from the child process\n let logs = \"\";\n try {\n // Run the generated file using forge\n const child = execa(\"forge\", [\"test\", \"--match-path\", `*${tempFileSuffix}*`, \"-vvv\"], {\n stdio: [\"inherit\", \"pipe\", \"inherit\"],\n });\n logs = (await child).stdout;\n } catch (error: any) {\n console.log(error.stdout ?? error);\n console.log(chalk.red(\"\\n-----------\\nError while running the gas report (see above)\"));\n throw error;\n }\n\n // Extract the gas reports from the logs\n\n // Create a regex to find all lines starting with `GAS REPORT:` and extract the name, function call and gas used\n const gasReportRegex = new RegExp(/GAS REPORT\\((.*)\\): (.*) \\[(.*)\\]: (.*)/g);\n\n // Loop through the matches and print the gas report\n let gasReportMatch;\n while ((gasReportMatch = gasReportRegex.exec(logs)) !== null) {\n const source = gasReportMatch[1];\n const name = gasReportMatch[2];\n const functionCall = gasReportMatch[3].replace(\";\", \"\");\n const gasUsed = parseInt(gasReportMatch[4]);\n gasReport.push({ source, name, functionCall, gasUsed });\n }\n\n gasReport.sort((a, b) => a.source.localeCompare(b.source));\n\n return gasReport;\n}\n\nfunction printGasReport(gasReport: GasReport, compare?: string) {\n if (compare) console.log(chalk.bold(`Gas report compared to ${compare}`));\n\n const headers = [\n chalk.bold(\"Source\"),\n chalk.bold(\"Name\"),\n chalk.bold(\"Function call\"),\n chalk.bold(\"Gas used\"),\n ...(compare ? [chalk.bold(\"Prev gas used\"), chalk.bold(\"Difference\")] : []),\n ];\n\n const values = gasReport.map((entry) => {\n const diff = entry.prevGasUsed ? entry.gasUsed - entry.prevGasUsed : 0;\n const diffEntry = diff > 0 ? chalk.red(`+${diff}`) : diff < 0 ? chalk.green(`${diff}`) : diff;\n const compareColumns = compare ? [entry.prevGasUsed ?? \"n/a\", diffEntry] : [];\n const gasUsedEntry = diff > 0 ? chalk.red(entry.gasUsed) : diff < 0 ? chalk.green(entry.gasUsed) : entry.gasUsed;\n return [entry.source, entry.name, entry.functionCall, gasUsedEntry, ...compareColumns];\n });\n\n const rows = [headers, ...values];\n\n console.log(table(rows, { border: getBorderCharacters(\"norc\") }));\n}\n\nfunction saveGasReport(gasReport: GasReport, path: string) {\n console.log(chalk.bold(`Saving gas report to ${path}`));\n writeFileSync(path, `${JSON.stringify(gasReport, null, 2)}\\n`);\n}\n","import type { CommandModule } from \"yargs\";\n\ntype Options = {\n name: string;\n upper: boolean | undefined;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"hello <name>\",\n\n describe: \"Greet <name> with Hello\",\n\n builder(yargs) {\n return yargs\n .options({\n upper: { type: \"boolean\" },\n })\n .positional(\"name\", { type: \"string\", demandOption: true });\n },\n\n handler({ name }) {\n const greeting = `Gm, ${name}!`;\n console.log(greeting);\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig, tablegen } from \"@latticexyz/store\";\nimport { getSrcDirectory } from \"@latticexyz/common/foundry\";\n\ntype Options = {\n configPath?: string;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"tablegen\",\n\n describe: \"Autogenerate MUD Store table libraries based on the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n });\n },\n\n async handler({ configPath }) {\n const config = (await loadConfig(configPath)) as StoreConfig;\n const srcDir = await getSrcDirectory();\n\n await tablegen(config, path.join(srcDir, config.codegenDirectory));\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig } from \"@latticexyz/store\";\nimport { tsgen } from \"../render-ts/tsgen\";\n\ntype Options = {\n configPath: string;\n out: string;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"tsgen\",\n\n describe: \"Autogenerate MUD typescript definitions based on the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", demandOption: true, desc: \"Path to the config file\" },\n out: { type: \"string\", demandOption: true, desc: \"Directory to output MUD typescript definition files\" },\n });\n },\n\n async handler(args) {\n const { configPath, out } = args;\n\n const config = (await loadConfig(configPath)) as StoreConfig;\n\n await tsgen(config, out);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import chalk from \"chalk\";\nimport { ZodError } from \"zod\";\nimport { fromZodError, ValidationError } from \"zod-validation-error\";\nimport { NotInsideProjectError } from \"@latticexyz/config\";\nimport { MUDError } from \"@latticexyz/common/errors\";\n\nexport function logError(error: unknown) {\n if (error instanceof ValidationError) {\n console.log(chalk.redBright(error.message));\n } else if (error instanceof ZodError) {\n // TODO currently this error shouldn't happen, use `fromZodErrorCustom`\n // (see https://github.com/latticexyz/mud/issues/438)\n const validationError = fromZodError(error, {\n prefixSeparator: \"\\n- \",\n issueSeparator: \"\\n- \",\n });\n console.log(chalk.redBright(validationError.message));\n } else if (error instanceof NotInsideProjectError) {\n console.log(chalk.red(error.message));\n console.log(\"\");\n // TODO add docs to the website and update the link to the specific page\n // (see https://github.com/latticexyz/mud/issues/445)\n console.log(chalk.blue(`To learn more about MUD's configuration, please go to https://mud.dev/packages/cli/`));\n } else if (error instanceof MUDError) {\n console.log(chalk.red(error));\n } else {\n console.log(error);\n }\n}\n","import type { CommandModule, Options } from \"yargs\";\nimport { logError } from \"../utils/errors\";\nimport { deployHandler, DeployOptions } from \"../utils\";\n\nexport const yDeployOptions = {\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n clean: { type: \"boolean\", desc: \"Remove the build forge artifacts and cache directories before building\" },\n printConfig: { type: \"boolean\", desc: \"Print the resolved config\" },\n profile: { type: \"string\", desc: \"The foundry profile to use\" },\n debug: { type: \"boolean\", desc: \"Print debug logs, like full error messages\" },\n priorityFeeMultiplier: {\n type: \"number\",\n desc: \"Multiply the estimated priority fee by the provided factor\",\n default: 1,\n },\n saveDeployment: { type: \"boolean\", desc: \"Save the deployment info to a file\", default: true },\n rpc: { type: \"string\", desc: \"The RPC URL to use. Defaults to the RPC url from the local foundry.toml\" },\n worldAddress: { type: \"string\", desc: \"Deploy to an existing World at the given address\" },\n srcDir: { type: \"string\", desc: \"Source directory. Defaults to foundry src directory.\" },\n disableTxWait: { type: \"boolean\", desc: \"Disable waiting for transactions to be confirmed.\", default: false },\n pollInterval: {\n type: \"number\",\n desc: \"Interval in miliseconds to use to poll for transaction receipts / block inclusion\",\n default: 1000,\n },\n} satisfies Record<keyof DeployOptions, Options>;\n\nconst commandModule: CommandModule<DeployOptions, DeployOptions> = {\n command: \"deploy\",\n\n describe: \"Deploy MUD contracts\",\n\n builder(yargs) {\n return yargs.options(yDeployOptions);\n },\n\n async handler(args) {\n try {\n await deployHandler(args);\n } catch (error: any) {\n logError(error);\n process.exit(1);\n }\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig } from \"@latticexyz/store\";\nimport { WorldConfig } from \"@latticexyz/world\";\nimport { worldgen } from \"@latticexyz/world/node\";\nimport { getSrcDirectory } from \"@latticexyz/common/foundry\";\nimport glob from \"glob\";\nimport path, { basename } from \"path\";\nimport { rmSync } from \"fs\";\n\ntype Options = {\n configPath?: string;\n clean?: boolean;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"worldgen\",\n\n describe: \"Autogenerate interfaces for Systems and World based on existing contracts and the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n clean: { type: \"boolean\", desc: \"Clear the worldgen directory before generating new interfaces\" },\n });\n },\n\n async handler(args) {\n const { configPath, clean } = args;\n const srcDir = await getSrcDirectory();\n\n // Get a list of all contract names\n const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path) => ({\n path,\n basename: basename(path, \".sol\"),\n }));\n\n // Load the config\n const mudConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;\n\n const outputBaseDirectory = path.join(srcDir, mudConfig.codegenDirectory);\n\n // clear the worldgen directory\n if (clean) rmSync(path.join(outputBaseDirectory, mudConfig.worldgenDirectory), { recursive: true, force: true });\n\n // generate new interfaces\n await worldgen(mudConfig, existingContracts, outputBaseDirectory);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import chalk from \"chalk\";\nimport { existsSync, readFileSync, rmSync, writeFileSync } from \"fs\";\nimport path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { MUDError } from \"@latticexyz/common/errors\";\nimport { logError } from \"../utils/errors\";\nimport localPackageJson from \"../../package.json\" assert { type: \"json\" };\n\ntype Options = {\n backup?: boolean;\n force?: boolean;\n restore?: boolean;\n mudVersion?: string;\n link?: string;\n};\n\nconst BACKUP_FILE = \".mudbackup\";\nconst MUD_PREFIX = \"@latticexyz\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"set-version\",\n\n describe: \"Install a custom MUD version and optionally backup the previously installed version\",\n\n builder(yargs) {\n return yargs.options({\n backup: { type: \"boolean\", description: `Back up the current MUD versions to \"${BACKUP_FILE}\"` },\n force: {\n type: \"boolean\",\n description: `Backup fails if a \"${BACKUP_FILE}\" file is found, unless --force is provided`,\n },\n restore: { type: \"boolean\", description: `Restore the previous MUD versions from \"${BACKUP_FILE}\"` },\n mudVersion: { alias: \"v\", type: \"string\", description: \"The MUD version to install\" },\n link: { alias: \"l\", type: \"string\", description: \"Relative path to the local MUD root directory to link\" },\n });\n },\n\n async handler(options) {\n try {\n if (!options.mudVersion && !options.link && !options.restore) {\n throw new MUDError(\"`--mudVersion` or `--link` is required unless --restore is provided.\");\n }\n\n // `link` and `mudVersion` are mutually exclusive\n if (options.link && options.mudVersion) {\n throw new MUDError(\"Options `--link` and `--mudVersion` are mutually exclusive\");\n }\n\n // Resolve the `canary` version number if needed\n options.mudVersion =\n options.mudVersion === \"canary\" ? await getCanaryVersion(localPackageJson.name) : options.mudVersion;\n\n // Read the current package.json\n const rootPath = \"./package.json\";\n const { workspaces } = updatePackageJson(rootPath, options);\n\n // Load the package.json of each workspace\n if (workspaces) {\n for (const workspace of workspaces) {\n const filePath = path.join(workspace, \"/package.json\");\n updatePackageJson(filePath, options);\n }\n }\n } catch (e) {\n logError(e);\n } finally {\n process.exit(0);\n }\n },\n};\n\nfunction updatePackageJson(filePath: string, options: Options): { workspaces?: string[] } {\n const { restore, force, link } = options;\n let { backup, mudVersion } = options;\n\n const backupFilePath = path.join(path.dirname(filePath), BACKUP_FILE);\n const backupFileExists = existsSync(backupFilePath);\n\n // Create a backup file for previous MUD versions by default if linking to local MUD\n if (link && !backupFileExists) backup = true;\n\n // If `backup` is true and force not set, check if a backup file already exists and throw an error if it does\n if (backup && !force && backupFileExists) {\n throw new MUDError(\n `A backup file already exists at ${backupFilePath}.\\nUse --force to overwrite it or --restore to restore it.`\n );\n }\n\n const packageJson = readPackageJson(filePath);\n\n // Load .mudbackup if `restore` is true\n const backupJson = restore ? readPackageJson(backupFilePath) : undefined;\n\n // Find all MUD dependencies\n const mudDependencies: Record<string, string> = {};\n for (const key in packageJson.dependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n mudDependencies[key] = packageJson.dependencies[key];\n }\n }\n\n // Find all MUD devDependencies\n const mudDevDependencies: Record<string, string> = {};\n for (const key in packageJson.devDependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n mudDevDependencies[key] = packageJson.devDependencies[key];\n }\n }\n\n // Back up the current dependencies if `backup` is true\n if (backup) {\n writeFileSync(\n backupFilePath,\n JSON.stringify({ dependencies: mudDependencies, devDependencies: mudDevDependencies }, null, 2)\n );\n console.log(chalk.green(`Backed up MUD dependencies from ${filePath} to ${backupFilePath}`));\n }\n\n // Update the dependencies\n for (const key in packageJson.dependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n packageJson.dependencies[key] = resolveMudVersion(key, \"dependencies\");\n }\n }\n\n // Update the devDependencies\n for (const key in packageJson.devDependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n packageJson.devDependencies[key] = resolveMudVersion(key, \"devDependencies\");\n }\n }\n\n // Write the updated package.json\n writeFileSync(filePath, JSON.stringify(packageJson, null, 2) + \"\\n\");\n\n console.log(`Updating ${filePath}`);\n logComparison(mudDependencies, packageJson.dependencies);\n logComparison(mudDevDependencies, packageJson.devDependencies);\n\n // Remove the backup file if `restore` is true and `backup` is false\n // because the old backup file is no longer needed\n if (restore && !backup) {\n rmSync(backupFilePath);\n console.log(chalk.green(`Cleaned up ${backupFilePath}`));\n }\n\n return packageJson;\n\n function resolveMudVersion(key: string, type: \"dependencies\" | \"devDependencies\") {\n if (restore && backupJson) return backupJson[type][key];\n if (link) mudVersion = resolveLinkPath(filePath, link, key);\n if (!mudVersion) return packageJson[type][key];\n return mudVersion;\n }\n}\n\nfunction readPackageJson(path: string): {\n workspaces?: string[];\n dependencies: Record<string, string>;\n devDependencies: Record<string, string>;\n} {\n try {\n const jsonString = readFileSync(path, \"utf8\");\n return JSON.parse(jsonString);\n } catch {\n throw new MUDError(\"Could not read JSON at \" + path);\n }\n}\n\nasync function getCanaryVersion(pkg: string) {\n try {\n console.log(chalk.blue(\"fetching MUD canary version...\"));\n const result = await (await fetch(`https://registry.npmjs.org/${pkg}`)).json();\n const canary = result[\"dist-tags\"].canary;\n console.log(chalk.green(\"MUD canary version:\", canary));\n return canary;\n } catch (e) {\n throw new MUDError(`Could not fetch canary version of ${pkg}`);\n }\n}\n\nfunction logComparison(prev: Record<string, string>, curr: Record<string, string>) {\n for (const key in prev) {\n if (prev[key] !== curr[key]) {\n console.log(`${key}: ${chalk.red(prev[key])} -> ${chalk.green(curr[key])}`);\n }\n }\n}\n\n/**\n * Returns path of the package to link, given a path to a local MUD clone and a package\n */\nfunction resolveLinkPath(packageJsonPath: string, mudLinkPath: string, pkg: string) {\n const pkgName = pkg.replace(MUD_PREFIX, \"\");\n const packageJsonToRootPath = path.relative(path.dirname(packageJsonPath), process.cwd());\n const linkPath = path.join(packageJsonToRootPath, mudLinkPath, \"packages\", pkgName);\n return \"link:\" + linkPath;\n}\n\nexport default commandModule;\n","{\n \"name\": \"@latticexyz/cli\",\n \"version\": \"1.42.0\",\n \"description\": \"Command line interface for mud\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/latticexyz/mud.git\",\n \"directory\": \"packages/cli\"\n },\n \"license\": \"MIT\",\n \"type\": \"module\",\n \"exports\": {\n \".\": \"./dist/index.js\"\n },\n \"types\": \"src/index.ts\",\n \"bin\": {\n \"mud\": \"./dist/mud.js\"\n },\n \"scripts\": {\n \"build\": \"pnpm run build:js\",\n \"build:js\": \"tsup && chmod +x ./dist/mud.js\",\n \"clean\": \"pnpm run clean:js\",\n \"clean:js\": \"rimraf dist\",\n \"dev\": \"tsup --watch\",\n \"generate-test-tables\": \"tsx ./scripts/generate-test-tables.ts\",\n \"lint\": \"eslint . --ext .ts\",\n \"test\": \"tsc --noEmit && pnpm run generate-test-tables && forge test\"\n },\n \"dependencies\": {\n \"@ethersproject/abi\": \"^5.7.0\",\n \"@ethersproject/providers\": \"^5.7.2\",\n \"@improbable-eng/grpc-web\": \"^0.15.0\",\n \"@improbable-eng/grpc-web-node-http-transport\": \"^0.15.0\",\n \"@latticexyz/common\": \"workspace:*\",\n \"@latticexyz/config\": \"workspace:*\",\n \"@latticexyz/schema-type\": \"workspace:*\",\n \"@latticexyz/services\": \"workspace:*\",\n \"@latticexyz/solecs\": \"workspace:*\",\n \"@latticexyz/std-contracts\": \"workspace:*\",\n \"@latticexyz/store\": \"workspace:*\",\n \"@latticexyz/world\": \"workspace:*\",\n \"@typechain/ethers-v5\": \"^10.2.0\",\n \"chalk\": \"^5.0.1\",\n \"chokidar\": \"^3.5.3\",\n \"dotenv\": \"^16.0.3\",\n \"ejs\": \"^3.1.8\",\n \"ethers\": \"^5.7.2\",\n \"execa\": \"^7.0.0\",\n \"glob\": \"^8.0.3\",\n \"nice-grpc-web\": \"^2.0.1\",\n \"openurl\": \"^1.1.1\",\n \"path\": \"^0.12.7\",\n \"table\": \"^6.8.1\",\n \"typechain\": \"^8.1.1\",\n \"typescript\": \"^4.9.5\",\n \"yargs\": \"^17.7.1\",\n \"zod\": \"^3.21.4\",\n \"zod-validation-error\": \"^1.3.0\"\n },\n \"devDependencies\": {\n \"@types/ejs\": \"^3.1.1\",\n \"@types/glob\": \"^7.2.0\",\n \"@types/node\": \"^18.15.11\",\n \"@types/openurl\": \"^1.0.0\",\n \"@types/yargs\": \"^17.0.10\",\n \"ds-test\": \"https://github.com/dapphub/ds-test.git#c9ce3f25bde29fc5eb9901842bf02850dfd2d084\",\n \"forge-std\": \"https://github.com/foundry-rs/forge-std.git#b4f121555729b3afb3c5ffccb62ff4b6e2818fd3\",\n \"tsup\": \"^6.7.0\",\n \"tsx\": \"^3.12.6\",\n \"vitest\": \"0.30.1\"\n },\n \"gitHead\": \"914a1e0ae4a573d685841ca2ea921435057deb8f\"\n}\n","import type { CommandModule } from \"yargs\";\nimport { anvil, forge, getRpcUrl } from \"@latticexyz/common/foundry\";\nimport chalk from \"chalk\";\nimport { rmSync, writeFileSync } from \"fs\";\nimport { yDeployOptions } from \"./deploy\";\nimport { deployHandler, DeployOptions } from \"../utils\";\n\ntype Options = DeployOptions & { port?: number; worldAddress?: string; forgeOptions?: string };\n\nconst WORLD_ADDRESS_FILE = \".mudtest\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"test\",\n\n describe: \"Run tests in MUD contracts\",\n\n builder(yargs) {\n return yargs.options({\n ...yDeployOptions,\n port: { type: \"number\", description: \"Port to run internal node for fork testing on\", default: 4242 },\n worldAddress: {\n type: \"string\",\n description:\n \"Address of an existing world contract. If provided, deployment is skipped and the RPC provided in the foundry.toml is used for fork testing.\",\n },\n forgeOptions: { type: \"string\", description: \"Options to pass to forge test\" },\n });\n },\n\n async handler(args) {\n // Start an internal anvil process if no world address is provided\n if (!args.worldAddress) {\n const anvilArgs = [\"--block-base-fee-per-gas\", \"0\", \"--port\", String(args.port)];\n anvil(anvilArgs);\n }\n\n const forkRpc = args.worldAddress ? await getRpcUrl(args.profile) : `http://127.0.0.1:${args.port}`;\n\n const worldAddress =\n args.worldAddress ??\n (\n await deployHandler({\n ...args,\n saveDeployment: false,\n rpc: forkRpc,\n })\n ).worldAddress;\n\n console.log(chalk.blue(\"World address\", worldAddress));\n\n // Create a temporary file to pass the world address to the tests\n writeFileSync(WORLD_ADDRESS_FILE, worldAddress);\n\n const userOptions = args.forgeOptions?.replaceAll(\"\\\\\", \"\").split(\" \") ?? [];\n try {\n const testResult = await forge([\"test\", \"--fork-url\", forkRpc, ...userOptions], {\n profile: args.profile,\n });\n console.log(testResult);\n } catch (e) {\n console.error(e);\n }\n\n rmSync(WORLD_ADDRESS_FILE);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import { CommandModule } from \"yargs\";\n\nimport devnode from \"./devnode\";\nimport faucet from \"./faucet\";\nimport gasReport from \"./gas-report\";\nimport hello from \"./hello\";\nimport tablegen from \"./tablegen\";\nimport tsgen from \"./tsgen\";\nimport deploy from \"./deploy\";\nimport worldgen from \"./worldgen\";\nimport setVersion from \"./set-version\";\nimport test from \"./test\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Each command has different options\nexport const commands: CommandModule<any, any>[] = [\n deploy,\n devnode,\n faucet,\n gasReport,\n hello,\n tablegen,\n tsgen,\n worldgen,\n setVersion,\n test,\n];\n"],"mappings":"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","names":["yargs","hideBin","rmSync","homedir","path","execa","commandModule","yargs","blocktime","userHomeDir","anvilArgs","child","devnode_default","FaucetServiceDefinition","createChannel","createClient","chalk","NodeHttpTransport","createFaucetService","url","commandModule","yargs","dripDev","faucetUrl","address","faucet","faucet_default","readFileSync","writeFileSync","rmSync","execa","chalk","table","getBorderCharacters","tempFileSuffix","commandModule","yargs","files","save","compare","validFiles","file","tempFiles","createGasReport","gasReport","runGasReport","compareGasReport","entry","prevEntry","e","printGasReport","saveGasReport","gas_report_default","filename","fileContents","newFile","functionRegex","functionMatch","functionSignature","regex","match","name","functionCall","tempFileName","logs","error","gasReportRegex","gasReportMatch","source","gasUsed","a","b","headers","values","diff","diffEntry","compareColumns","gasUsedEntry","rows","path","commandModule","yargs","name","greeting","hello_default","path","loadConfig","tablegen","getSrcDirectory","commandModule","yargs","configPath","config","srcDir","tablegen_default","loadConfig","commandModule","yargs","args","configPath","out","config","loadConfig","tsgen","tsgen_default","chalk","ZodError","fromZodError","ValidationError","NotInsideProjectError","MUDError","logError","error","validationError","yDeployOptions","commandModule","yargs","args","deployHandler","error","logError","deploy_default","loadConfig","worldgen","getSrcDirectory","glob","path","basename","rmSync","commandModule","yargs","args","configPath","clean","srcDir","existingContracts","mudConfig","outputBaseDirectory","worldgen_default","chalk","existsSync","readFileSync","rmSync","writeFileSync","path","MUDError","package_default","BACKUP_FILE","MUD_PREFIX","commandModule","yargs","options","MUDError","getCanaryVersion","package_default","rootPath","workspaces","updatePackageJson","workspace","filePath","path","e","logError","restore","force","link","backup","mudVersion","backupFilePath","backupFileExists","existsSync","packageJson","readPackageJson","backupJson","mudDependencies","key","mudDevDependencies","writeFileSync","chalk","resolveMudVersion","logComparison","rmSync","type","resolveLinkPath","jsonString","readFileSync","pkg","canary","prev","curr","packageJsonPath","mudLinkPath","pkgName","packageJsonToRootPath","set_version_default","anvil","forge","getRpcUrl","chalk","rmSync","writeFileSync","WORLD_ADDRESS_FILE","commandModule","yargs","yDeployOptions","args","anvilArgs","anvil","forkRpc","getRpcUrl","worldAddress","deployHandler","chalk","writeFileSync","userOptions","testResult","forge","e","rmSync","test_default","commands","deploy_default","devnode_default","faucet_default","gas_report_default","hello_default","tablegen_default","tsgen_default","worldgen_default","set_version_default","test_default","dotenv","yargs","hideBin","commands","msg","err","logError"]}
1
+ {"version":3,"sources":["../src/mud.ts","../src/commands/devnode.ts","../src/commands/faucet.ts","../src/commands/gas-report.ts","../src/commands/hello.ts","../src/commands/tablegen.ts","../src/commands/tsgen.ts","../src/utils/errors.ts","../src/utils/worldtypes.ts","../src/utils/printMUD.ts","../src/commands/deploy.ts","../src/commands/worldgen.ts","../src/commands/set-version.ts","../package.json","../src/commands/test.ts","../src/commands/dev-contracts.ts","../src/commands/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport { commands } from \"./commands\";\nimport { logError } from \"./utils/errors\";\n\n// Load .env file into process.env\nimport * as dotenv from \"dotenv\";\nimport chalk from \"chalk\";\ndotenv.config();\n\nyargs(hideBin(process.argv))\n // Explicit name to display in help (by default it's the entry file, which may not be \"mud\" for e.g. ts-node)\n .scriptName(\"mud\")\n // Use the commands directory to scaffold\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- command array overload isn't typed, see https://github.com/yargs/yargs/blob/main/docs/advanced.md#esm-hierarchy\n .command(commands as any)\n // Enable strict mode.\n .strict()\n // Custom error handler\n .fail((msg, err) => {\n console.error(chalk.red(msg));\n if (msg.includes(\"Missing required argument\")) {\n console.log(\n chalk.yellow(`Run 'pnpm mud ${process.argv[2]} --help' for a list of available and required arguments.`)\n );\n }\n console.log(\"\");\n logError(err);\n console.log(\"\");\n\n process.exit(1);\n })\n // Useful aliases.\n .alias({ h: \"help\" }).argv;\n","import { rmSync } from \"fs\";\nimport { homedir } from \"os\";\nimport path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { execa } from \"execa\";\n\ntype Options = {\n blocktime: number;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"devnode\",\n\n describe: \"Start a local Ethereum node for development\",\n\n builder(yargs) {\n return yargs.options({\n blocktime: { type: \"number\", default: 1, decs: \"Interval in which new blocks are produced\" },\n });\n },\n\n async handler({ blocktime }) {\n console.log(\"Clearing devnode history\");\n const userHomeDir = homedir();\n rmSync(path.join(userHomeDir, \".foundry\", \"anvil\", \"tmp\"), { recursive: true, force: true });\n\n const anvilArgs = [\"-b\", String(blocktime), \"--block-base-fee-per-gas\", \"0\"];\n console.log(`Running: anvil ${anvilArgs.join(\" \")}`);\n const child = execa(\"anvil\", anvilArgs, {\n stdio: [\"inherit\", \"inherit\", \"inherit\"],\n });\n\n process.on(\"SIGINT\", () => {\n console.log(\"\\ngracefully shutting down from SIGINT (Crtl-C)\");\n child.kill();\n process.exit();\n });\n await child;\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { FaucetServiceDefinition } from \"@latticexyz/services/faucet\";\nimport { createChannel, createClient } from \"nice-grpc-web\";\nimport chalk from \"chalk\";\nimport { NodeHttpTransport } from \"@improbable-eng/grpc-web-node-http-transport\";\n\ntype Options = {\n dripDev?: boolean;\n faucetUrl: string;\n address: string;\n};\n\n/**\n * Create a FaucetServiceClient\n * @param url FaucetService URL\n * @returns FaucetServiceClient\n */\nfunction createFaucetService(url: string) {\n return createClient(FaucetServiceDefinition, createChannel(url, NodeHttpTransport()));\n}\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"faucet\",\n\n describe: \"Interact with a MUD faucet\",\n\n builder(yargs) {\n return yargs.options({\n dripDev: {\n type: \"boolean\",\n desc: \"Request a drip from the dev endpoint (requires faucet to have dev mode enabled)\",\n default: true,\n },\n faucetUrl: {\n type: \"string\",\n desc: \"URL of the MUD faucet\",\n default: \"https://faucet.testnet-mud-services.linfra.xyz\",\n },\n address: {\n type: \"string\",\n desc: \"Ethereum address to fund\",\n required: true,\n },\n });\n },\n\n async handler({ dripDev, faucetUrl, address }) {\n const faucet = createFaucetService(faucetUrl);\n\n if (dripDev) {\n console.log(chalk.yellow(\"Dripping to\", address));\n await faucet.dripDev({ address });\n console.log(chalk.yellow(\"Success\"));\n }\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { readFileSync, writeFileSync, rmSync } from \"fs\";\nimport { execa } from \"execa\";\nimport chalk from \"chalk\";\nimport { table, getBorderCharacters } from \"table\";\n\n/**\n * Print the gas report to the console, save it to a file and compare it to a previous gas report if provided.\n * Requires forge to be installed, and gas test files including `// !gasreport` comments, like this:\n *\n * ```solidity\n * contract GasTest is DSTestPlus {\n * function testBuffer() public pure {\n * // !gasreport allocate a buffer\n * Buffer buffer = Buffer_.allocate(32);\n *\n * bytes32 value = keccak256(\"some data\");\n *\n * // !gasreport append 32 bytes to a buffer\n * buffer.append(value);\n * }\n * }\n * ```\n */\n\ntype Options = {\n path: string[];\n save?: string;\n compare?: string;\n};\n\ntype GasReportEntry = {\n source: string;\n name: string;\n functionCall: string;\n gasUsed: number;\n prevGasUsed?: number;\n};\n\ntype GasReport = GasReportEntry[];\n\nconst tempFileSuffix = \"MudGasReport\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"gas-report\",\n\n describe: \"Create a gas report\",\n\n builder(yargs) {\n return yargs.options({\n path: { type: \"array\", string: true, default: [\"Gas.t.sol\"], desc: \"File containing the gas tests\" },\n save: { type: \"string\", desc: \"Save the gas report to a file\" },\n compare: { type: \"string\", desc: \"Compare to an existing gas report\" },\n });\n },\n\n async handler({ path: files, save, compare }) {\n const validFiles = files.filter((file) => file.endsWith(\".t.sol\"));\n const tempFiles = await Promise.all(validFiles.map((file) => createGasReport(file)));\n\n process.once(\"SIGINT\", () => {\n console.log(\"caught sigint, deleting temp files\");\n tempFiles.forEach((file) => rmSync(file));\n });\n\n let gasReport: GasReport;\n try {\n gasReport = await runGasReport();\n } catch {\n setTimeout(() => process.exit());\n return;\n } finally {\n // Delete the temporary files\n tempFiles.forEach((file) => rmSync(file));\n }\n\n // If this gas report should be compared to an existing one, load the existing one\n if (compare) {\n try {\n const compareGasReport: GasReport = JSON.parse(readFileSync(compare, \"utf8\"));\n // Merge the previous gas report with the new one\n gasReport = gasReport.map((entry) => {\n const prevEntry = compareGasReport.find(\n (e) => e.name === entry.name && e.functionCall === entry.functionCall\n );\n return { ...entry, prevGasUsed: prevEntry?.gasUsed };\n });\n } catch {\n console.log(chalk.red(`Gas report to compare not found: ${compare}`));\n compare = undefined;\n }\n }\n\n // Print gas report\n printGasReport(gasReport, compare);\n\n // Save gas report to file if requested\n if (save) saveGasReport(gasReport, save);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n\nasync function createGasReport(filename: string): Promise<string> {\n console.log(\"Creating gas report for\", chalk.bold(filename));\n\n // Parse the given test file, and add gas reporting wherever requested by a `// !gasreport` comment\n const fileContents = readFileSync(filename, \"utf8\");\n let newFile = fileContents;\n\n // Use a regex to find first line of each function\n const functionRegex = new RegExp(/function (.*){/g);\n // Insert a line to declare the _gasreport variable at the start of each function\n let functionMatch;\n while ((functionMatch = functionRegex.exec(fileContents)) !== null) {\n const functionSignature = functionMatch[0];\n newFile = newFile.replace(functionSignature, `${functionSignature}\\nuint256 _gasreport;`);\n }\n\n // A gasreport comment has a name (written after the comment) and a function call (written on the next line)\n // Create a regex to extract both the name and the function call\n const regex = new RegExp(/\\/\\/ !gasreport (.*)\\n(.*)/g);\n\n // Apply the regex and loop through the matches,\n // and create a new file with the gasreport comments replaced by the gas report\n let match;\n while ((match = regex.exec(fileContents)) !== null) {\n const name = match[1];\n const functionCall = match[2].trim();\n\n newFile = newFile.replace(\n match[0],\n `\n_gasreport = gasleft();\n${functionCall}\n_gasreport = _gasreport - gasleft();\nconsole.log(\"GAS REPORT(${filename}): ${name} [${functionCall.replaceAll('\"', '\\\\\"')}]:\", _gasreport);`\n );\n }\n\n // Remove all occurrences of `pure` with `view`\n newFile = newFile.replace(/pure/g, \"view\");\n\n // Write the new file to disk (temporarily)\n // Create the temp file by replacing the previous file name with MudGasReport\n const tempFileName = filename.replace(/\\.t\\.sol$/, `${tempFileSuffix}.t.sol`);\n writeFileSync(tempFileName, newFile);\n\n return tempFileName;\n}\n\nasync function runGasReport(): Promise<GasReport> {\n console.log(\"Running gas report\");\n const gasReport: GasReport = [];\n\n // Extract the logs from the child process\n let logs = \"\";\n try {\n // Run the generated file using forge\n const child = execa(\"forge\", [\"test\", \"--match-path\", `*${tempFileSuffix}*`, \"-vvv\"], {\n stdio: [\"inherit\", \"pipe\", \"inherit\"],\n });\n logs = (await child).stdout;\n } catch (error: any) {\n console.log(error.stdout ?? error);\n console.log(chalk.red(\"\\n-----------\\nError while running the gas report (see above)\"));\n throw error;\n }\n\n // Extract the gas reports from the logs\n\n // Create a regex to find all lines starting with `GAS REPORT:` and extract the name, function call and gas used\n const gasReportRegex = new RegExp(/GAS REPORT\\((.*)\\): (.*) \\[(.*)\\]: (.*)/g);\n\n // Loop through the matches and print the gas report\n let gasReportMatch;\n while ((gasReportMatch = gasReportRegex.exec(logs)) !== null) {\n const source = gasReportMatch[1];\n const name = gasReportMatch[2];\n const functionCall = gasReportMatch[3].replace(\";\", \"\");\n const gasUsed = parseInt(gasReportMatch[4]);\n gasReport.push({ source, name, functionCall, gasUsed });\n }\n\n gasReport.sort((a, b) => a.source.localeCompare(b.source));\n\n return gasReport;\n}\n\nfunction printGasReport(gasReport: GasReport, compare?: string) {\n if (compare) console.log(chalk.bold(`Gas report compared to ${compare}`));\n\n const headers = [\n chalk.bold(\"Source\"),\n chalk.bold(\"Name\"),\n chalk.bold(\"Function call\"),\n chalk.bold(\"Gas used\"),\n ...(compare ? [chalk.bold(\"Prev gas used\"), chalk.bold(\"Difference\")] : []),\n ];\n\n const values = gasReport.map((entry) => {\n const diff = entry.prevGasUsed ? entry.gasUsed - entry.prevGasUsed : 0;\n const diffEntry = diff > 0 ? chalk.red(`+${diff}`) : diff < 0 ? chalk.green(`${diff}`) : diff;\n const compareColumns = compare ? [entry.prevGasUsed ?? \"n/a\", diffEntry] : [];\n const gasUsedEntry = diff > 0 ? chalk.red(entry.gasUsed) : diff < 0 ? chalk.green(entry.gasUsed) : entry.gasUsed;\n return [entry.source, entry.name, entry.functionCall, gasUsedEntry, ...compareColumns];\n });\n\n const rows = [headers, ...values];\n\n console.log(table(rows, { border: getBorderCharacters(\"norc\") }));\n}\n\nfunction saveGasReport(gasReport: GasReport, path: string) {\n console.log(chalk.bold(`Saving gas report to ${path}`));\n writeFileSync(path, `${JSON.stringify(gasReport, null, 2)}\\n`);\n}\n","import type { CommandModule } from \"yargs\";\n\ntype Options = {\n name: string;\n upper: boolean | undefined;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"hello <name>\",\n\n describe: \"Greet <name> with Hello\",\n\n builder(yargs) {\n return yargs\n .options({\n upper: { type: \"boolean\" },\n })\n .positional(\"name\", { type: \"string\", demandOption: true });\n },\n\n handler({ name }) {\n const greeting = `Gm, ${name}!`;\n console.log(greeting);\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig, tablegen } from \"@latticexyz/store\";\nimport { getSrcDirectory } from \"@latticexyz/common/foundry\";\n\ntype Options = {\n configPath?: string;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"tablegen\",\n\n describe: \"Autogenerate MUD Store table libraries based on the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n });\n },\n\n async handler({ configPath }) {\n const config = (await loadConfig(configPath)) as StoreConfig;\n const srcDir = await getSrcDirectory();\n\n await tablegen(config, path.join(srcDir, config.codegenDirectory));\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig } from \"@latticexyz/store\";\nimport { tsgen } from \"../render-ts/tsgen\";\n\ntype Options = {\n configPath: string;\n out: string;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"tsgen\",\n\n describe: \"Autogenerate MUD typescript definitions based on the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", demandOption: true, desc: \"Path to the config file\" },\n out: { type: \"string\", demandOption: true, desc: \"Directory to output MUD typescript definition files\" },\n });\n },\n\n async handler(args) {\n const { configPath, out } = args;\n\n const config = (await loadConfig(configPath)) as StoreConfig;\n\n await tsgen(config, out);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import chalk from \"chalk\";\nimport { ZodError } from \"zod\";\nimport { fromZodError, ValidationError } from \"zod-validation-error\";\nimport { NotInsideProjectError } from \"@latticexyz/config\";\nimport { MUDError } from \"@latticexyz/common/errors\";\n\nexport function logError(error: unknown) {\n if (error instanceof ValidationError) {\n console.log(chalk.redBright(error.message));\n } else if (error instanceof ZodError) {\n // TODO currently this error shouldn't happen, use `fromZodErrorCustom`\n // (see https://github.com/latticexyz/mud/issues/438)\n const validationError = fromZodError(error, {\n prefixSeparator: \"\\n- \",\n issueSeparator: \"\\n- \",\n });\n console.log(chalk.redBright(validationError.message));\n } else if (error instanceof NotInsideProjectError) {\n console.log(chalk.red(error.message));\n console.log(\"\");\n // TODO add docs to the website and update the link to the specific page\n // (see https://github.com/latticexyz/mud/issues/445)\n console.log(chalk.blue(`To learn more about MUD's configuration, please go to https://mud.dev/packages/cli/`));\n } else if (error instanceof MUDError) {\n console.log(chalk.red(error));\n } else {\n console.log(error);\n }\n}\n","import { getOutDirectory } from \"@latticexyz/common/foundry\";\nimport path from \"path\";\nimport { runTypeChain } from \"typechain\";\n\n/**\n * Generate IWorld typescript bindings\n */\nexport async function worldtypes() {\n const cwd = process.cwd();\n const forgeOurDir = await getOutDirectory();\n const IWorldPath = path.join(process.cwd(), forgeOurDir, \"IWorld.sol/IWorld.json\");\n\n await runTypeChain({\n cwd,\n filesToProcess: [IWorldPath],\n allFiles: [IWorldPath],\n target: \"ethers-v5\",\n });\n\n console.log(\"Typechain generated IWorld interface\");\n}\n","import chalk from \"chalk\";\n\nexport function printMUD() {\n console.log(\n chalk.yellow(`\n.------..------..------.\n|M.--. ||U.--. ||D.--. |\n| (\\\\/) || (\\\\/) || :/\\\\: |\n| :\\\\/: || :\\\\/: || (__) |\n| '--'M|| '--'U|| '--'D|\n'------''------''------'\n`)\n );\n}\n","import type { CommandModule, Options } from \"yargs\";\nimport { logError } from \"../utils/errors\";\nimport { deployHandler, DeployOptions } from \"../utils\";\n\nexport const yDeployOptions = {\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n clean: { type: \"boolean\", desc: \"Remove the build forge artifacts and cache directories before building\" },\n printConfig: { type: \"boolean\", desc: \"Print the resolved config\" },\n profile: { type: \"string\", desc: \"The foundry profile to use\" },\n debug: { type: \"boolean\", desc: \"Print debug logs, like full error messages\" },\n priorityFeeMultiplier: {\n type: \"number\",\n desc: \"Multiply the estimated priority fee by the provided factor\",\n default: 1,\n },\n saveDeployment: { type: \"boolean\", desc: \"Save the deployment info to a file\", default: true },\n rpc: { type: \"string\", desc: \"The RPC URL to use. Defaults to the RPC url from the local foundry.toml\" },\n worldAddress: { type: \"string\", desc: \"Deploy to an existing World at the given address\" },\n srcDir: { type: \"string\", desc: \"Source directory. Defaults to foundry src directory.\" },\n disableTxWait: { type: \"boolean\", desc: \"Disable waiting for transactions to be confirmed.\", default: false },\n pollInterval: {\n type: \"number\",\n desc: \"Interval in miliseconds to use to poll for transaction receipts / block inclusion\",\n default: 1000,\n },\n skipBuild: { type: \"boolean\", desc: \"Skip rebuilding the contracts before deploying\" },\n} satisfies Record<keyof DeployOptions, Options>;\n\nconst commandModule: CommandModule<DeployOptions, DeployOptions> = {\n command: \"deploy\",\n\n describe: \"Deploy MUD contracts\",\n\n builder(yargs) {\n return yargs.options(yDeployOptions);\n },\n\n async handler(args) {\n try {\n await deployHandler(args);\n } catch (error: any) {\n logError(error);\n process.exit(1);\n }\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { loadConfig } from \"@latticexyz/config/node\";\nimport { StoreConfig } from \"@latticexyz/store\";\nimport { WorldConfig } from \"@latticexyz/world\";\nimport { worldgen } from \"@latticexyz/world/node\";\nimport { getSrcDirectory } from \"@latticexyz/common/foundry\";\nimport glob from \"glob\";\nimport path, { basename } from \"path\";\nimport { rmSync } from \"fs\";\n\ntype Options = {\n configPath?: string;\n clean?: boolean;\n srcDir?: string;\n config?: StoreConfig & WorldConfig;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"worldgen\",\n\n describe: \"Autogenerate interfaces for Systems and World based on existing contracts and the config file\",\n\n builder(yargs) {\n return yargs.options({\n configPath: { type: \"string\", desc: \"Path to the config file\" },\n clean: { type: \"boolean\", desc: \"Clear the worldgen directory before generating new interfaces\" },\n });\n },\n\n async handler(args) {\n await worldgenHandler(args);\n process.exit(0);\n },\n};\n\nexport async function worldgenHandler(args: Options) {\n const srcDir = args.srcDir ?? (await getSrcDirectory());\n\n // Get a list of all contract names\n const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path) => ({\n path,\n basename: basename(path, \".sol\"),\n }));\n\n // Load the config\n const mudConfig = args.config ?? ((await loadConfig(args.configPath)) as StoreConfig & WorldConfig);\n\n const outputBaseDirectory = path.join(srcDir, mudConfig.codegenDirectory);\n\n // clear the worldgen directory\n if (args.clean) rmSync(path.join(outputBaseDirectory, mudConfig.worldgenDirectory), { recursive: true, force: true });\n\n // generate new interfaces\n await worldgen(mudConfig, existingContracts, outputBaseDirectory);\n}\n\nexport default commandModule;\n","import chalk from \"chalk\";\nimport { existsSync, readFileSync, rmSync, writeFileSync } from \"fs\";\nimport path from \"path\";\nimport type { CommandModule } from \"yargs\";\nimport { MUDError } from \"@latticexyz/common/errors\";\nimport { logError } from \"../utils/errors\";\nimport localPackageJson from \"../../package.json\" assert { type: \"json\" };\n\ntype Options = {\n backup?: boolean;\n force?: boolean;\n restore?: boolean;\n mudVersion?: string;\n link?: string;\n};\n\nconst BACKUP_FILE = \".mudbackup\";\nconst MUD_PREFIX = \"@latticexyz\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"set-version\",\n\n describe: \"Install a custom MUD version and optionally backup the previously installed version\",\n\n builder(yargs) {\n return yargs.options({\n backup: { type: \"boolean\", description: `Back up the current MUD versions to \"${BACKUP_FILE}\"` },\n force: {\n type: \"boolean\",\n description: `Backup fails if a \"${BACKUP_FILE}\" file is found, unless --force is provided`,\n },\n restore: { type: \"boolean\", description: `Restore the previous MUD versions from \"${BACKUP_FILE}\"` },\n mudVersion: { alias: \"v\", type: \"string\", description: \"The MUD version to install\" },\n link: { alias: \"l\", type: \"string\", description: \"Relative path to the local MUD root directory to link\" },\n });\n },\n\n async handler(options) {\n try {\n if (!options.mudVersion && !options.link && !options.restore) {\n throw new MUDError(\"`--mudVersion` or `--link` is required unless --restore is provided.\");\n }\n\n // `link` and `mudVersion` are mutually exclusive\n if (options.link && options.mudVersion) {\n throw new MUDError(\"Options `--link` and `--mudVersion` are mutually exclusive\");\n }\n\n // Resolve the `canary` version number if needed\n options.mudVersion =\n options.mudVersion === \"canary\" ? await getCanaryVersion(localPackageJson.name) : options.mudVersion;\n\n // Read the current package.json\n const rootPath = \"./package.json\";\n const { workspaces } = updatePackageJson(rootPath, options);\n\n // Load the package.json of each workspace\n if (workspaces) {\n for (const workspace of workspaces) {\n const filePath = path.join(workspace, \"/package.json\");\n updatePackageJson(filePath, options);\n }\n }\n } catch (e) {\n logError(e);\n } finally {\n process.exit(0);\n }\n },\n};\n\nfunction updatePackageJson(filePath: string, options: Options): { workspaces?: string[] } {\n const { restore, force, link } = options;\n let { backup, mudVersion } = options;\n\n const backupFilePath = path.join(path.dirname(filePath), BACKUP_FILE);\n const backupFileExists = existsSync(backupFilePath);\n\n // Create a backup file for previous MUD versions by default if linking to local MUD\n if (link && !backupFileExists) backup = true;\n\n // If `backup` is true and force not set, check if a backup file already exists and throw an error if it does\n if (backup && !force && backupFileExists) {\n throw new MUDError(\n `A backup file already exists at ${backupFilePath}.\\nUse --force to overwrite it or --restore to restore it.`\n );\n }\n\n const packageJson = readPackageJson(filePath);\n\n // Load .mudbackup if `restore` is true\n const backupJson = restore ? readPackageJson(backupFilePath) : undefined;\n\n // Find all MUD dependencies\n const mudDependencies: Record<string, string> = {};\n for (const key in packageJson.dependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n mudDependencies[key] = packageJson.dependencies[key];\n }\n }\n\n // Find all MUD devDependencies\n const mudDevDependencies: Record<string, string> = {};\n for (const key in packageJson.devDependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n mudDevDependencies[key] = packageJson.devDependencies[key];\n }\n }\n\n // Back up the current dependencies if `backup` is true\n if (backup) {\n writeFileSync(\n backupFilePath,\n JSON.stringify({ dependencies: mudDependencies, devDependencies: mudDevDependencies }, null, 2)\n );\n console.log(chalk.green(`Backed up MUD dependencies from ${filePath} to ${backupFilePath}`));\n }\n\n // Update the dependencies\n for (const key in packageJson.dependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n packageJson.dependencies[key] = resolveMudVersion(key, \"dependencies\");\n }\n }\n\n // Update the devDependencies\n for (const key in packageJson.devDependencies) {\n if (key.startsWith(MUD_PREFIX)) {\n packageJson.devDependencies[key] = resolveMudVersion(key, \"devDependencies\");\n }\n }\n\n // Write the updated package.json\n writeFileSync(filePath, JSON.stringify(packageJson, null, 2) + \"\\n\");\n\n console.log(`Updating ${filePath}`);\n logComparison(mudDependencies, packageJson.dependencies);\n logComparison(mudDevDependencies, packageJson.devDependencies);\n\n // Remove the backup file if `restore` is true and `backup` is false\n // because the old backup file is no longer needed\n if (restore && !backup) {\n rmSync(backupFilePath);\n console.log(chalk.green(`Cleaned up ${backupFilePath}`));\n }\n\n return packageJson;\n\n function resolveMudVersion(key: string, type: \"dependencies\" | \"devDependencies\") {\n if (restore && backupJson) return backupJson[type][key];\n if (link) mudVersion = resolveLinkPath(filePath, link, key);\n if (!mudVersion) return packageJson[type][key];\n return mudVersion;\n }\n}\n\nfunction readPackageJson(path: string): {\n workspaces?: string[];\n dependencies: Record<string, string>;\n devDependencies: Record<string, string>;\n} {\n try {\n const jsonString = readFileSync(path, \"utf8\");\n return JSON.parse(jsonString);\n } catch {\n throw new MUDError(\"Could not read JSON at \" + path);\n }\n}\n\nasync function getCanaryVersion(pkg: string) {\n try {\n console.log(chalk.blue(\"fetching MUD canary version...\"));\n const result = await (await fetch(`https://registry.npmjs.org/${pkg}`)).json();\n const canary = result[\"dist-tags\"].canary;\n console.log(chalk.green(\"MUD canary version:\", canary));\n return canary;\n } catch (e) {\n throw new MUDError(`Could not fetch canary version of ${pkg}`);\n }\n}\n\nfunction logComparison(prev: Record<string, string>, curr: Record<string, string>) {\n for (const key in prev) {\n if (prev[key] !== curr[key]) {\n console.log(`${key}: ${chalk.red(prev[key])} -> ${chalk.green(curr[key])}`);\n }\n }\n}\n\n/**\n * Returns path of the package to link, given a path to a local MUD clone and a package\n */\nfunction resolveLinkPath(packageJsonPath: string, mudLinkPath: string, pkg: string) {\n const pkgName = pkg.replace(MUD_PREFIX, \"\");\n const packageJsonToRootPath = path.relative(path.dirname(packageJsonPath), process.cwd());\n const linkPath = path.join(packageJsonToRootPath, mudLinkPath, \"packages\", pkgName);\n return \"link:\" + linkPath;\n}\n\nexport default commandModule;\n","{\n \"name\": \"@latticexyz/cli\",\n \"version\": \"1.42.0\",\n \"description\": \"Command line interface for mud\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/latticexyz/mud.git\",\n \"directory\": \"packages/cli\"\n },\n \"license\": \"MIT\",\n \"type\": \"module\",\n \"exports\": {\n \".\": \"./dist/index.js\"\n },\n \"types\": \"src/index.ts\",\n \"bin\": {\n \"mud\": \"./dist/mud.js\"\n },\n \"scripts\": {\n \"build\": \"pnpm run build:js\",\n \"build:js\": \"tsup && chmod +x ./dist/mud.js\",\n \"clean\": \"pnpm run clean:js\",\n \"clean:js\": \"rimraf dist\",\n \"dev\": \"tsup --watch\",\n \"generate-test-tables\": \"tsx ./scripts/generate-test-tables.ts\",\n \"lint\": \"eslint . --ext .ts\",\n \"test\": \"tsc --noEmit && pnpm run generate-test-tables && forge test\"\n },\n \"dependencies\": {\n \"@ethersproject/abi\": \"^5.7.0\",\n \"@ethersproject/providers\": \"^5.7.2\",\n \"@improbable-eng/grpc-web\": \"^0.15.0\",\n \"@improbable-eng/grpc-web-node-http-transport\": \"^0.15.0\",\n \"@latticexyz/common\": \"workspace:*\",\n \"@latticexyz/config\": \"workspace:*\",\n \"@latticexyz/schema-type\": \"workspace:*\",\n \"@latticexyz/services\": \"workspace:*\",\n \"@latticexyz/solecs\": \"workspace:*\",\n \"@latticexyz/std-contracts\": \"workspace:*\",\n \"@latticexyz/store\": \"workspace:*\",\n \"@latticexyz/world\": \"workspace:*\",\n \"@typechain/ethers-v5\": \"^10.2.0\",\n \"chalk\": \"^5.0.1\",\n \"chokidar\": \"^3.5.3\",\n \"dotenv\": \"^16.0.3\",\n \"ejs\": \"^3.1.8\",\n \"ethers\": \"^5.7.2\",\n \"execa\": \"^7.0.0\",\n \"glob\": \"^8.0.3\",\n \"nice-grpc-web\": \"^2.0.1\",\n \"openurl\": \"^1.1.1\",\n \"path\": \"^0.12.7\",\n \"table\": \"^6.8.1\",\n \"throttle-debounce\": \"^5.0.0\",\n \"typechain\": \"^8.1.1\",\n \"typescript\": \"^4.9.5\",\n \"yargs\": \"^17.7.1\",\n \"zod\": \"^3.21.4\",\n \"zod-validation-error\": \"^1.3.0\"\n },\n \"devDependencies\": {\n \"@types/ejs\": \"^3.1.1\",\n \"@types/glob\": \"^7.2.0\",\n \"@types/node\": \"^18.15.11\",\n \"@types/openurl\": \"^1.0.0\",\n \"@types/throttle-debounce\": \"^5.0.0\",\n \"@types/yargs\": \"^17.0.10\",\n \"ds-test\": \"https://github.com/dapphub/ds-test.git#c9ce3f25bde29fc5eb9901842bf02850dfd2d084\",\n \"forge-std\": \"https://github.com/foundry-rs/forge-std.git#b4f121555729b3afb3c5ffccb62ff4b6e2818fd3\",\n \"tsup\": \"^6.7.0\",\n \"tsx\": \"^3.12.6\",\n \"vitest\": \"0.30.1\"\n },\n \"gitHead\": \"914a1e0ae4a573d685841ca2ea921435057deb8f\"\n}\n","import type { CommandModule } from \"yargs\";\nimport { anvil, forge, getRpcUrl } from \"@latticexyz/common/foundry\";\nimport chalk from \"chalk\";\nimport { rmSync, writeFileSync } from \"fs\";\nimport { yDeployOptions } from \"./deploy\";\nimport { deployHandler, DeployOptions } from \"../utils\";\n\ntype Options = DeployOptions & { port?: number; worldAddress?: string; forgeOptions?: string };\n\nconst WORLD_ADDRESS_FILE = \".mudtest\";\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"test\",\n\n describe: \"Run tests in MUD contracts\",\n\n builder(yargs) {\n return yargs.options({\n ...yDeployOptions,\n port: { type: \"number\", description: \"Port to run internal node for fork testing on\", default: 4242 },\n worldAddress: {\n type: \"string\",\n description:\n \"Address of an existing world contract. If provided, deployment is skipped and the RPC provided in the foundry.toml is used for fork testing.\",\n },\n forgeOptions: { type: \"string\", description: \"Options to pass to forge test\" },\n });\n },\n\n async handler(args) {\n // Start an internal anvil process if no world address is provided\n if (!args.worldAddress) {\n const anvilArgs = [\"--block-base-fee-per-gas\", \"0\", \"--port\", String(args.port)];\n anvil(anvilArgs);\n }\n\n const forkRpc = args.worldAddress ? await getRpcUrl(args.profile) : `http://127.0.0.1:${args.port}`;\n\n const worldAddress =\n args.worldAddress ??\n (\n await deployHandler({\n ...args,\n saveDeployment: false,\n rpc: forkRpc,\n })\n ).worldAddress;\n\n console.log(chalk.blue(\"World address\", worldAddress));\n\n // Create a temporary file to pass the world address to the tests\n writeFileSync(WORLD_ADDRESS_FILE, worldAddress);\n\n const userOptions = args.forgeOptions?.replaceAll(\"\\\\\", \"\").split(\" \") ?? [];\n try {\n const testResult = await forge([\"test\", \"--fork-url\", forkRpc, ...userOptions], {\n profile: args.profile,\n });\n console.log(testResult);\n } catch (e) {\n console.error(e);\n }\n\n rmSync(WORLD_ADDRESS_FILE);\n\n process.exit(0);\n },\n};\n\nexport default commandModule;\n","import type { CommandModule } from \"yargs\";\nimport { anvil, forge, getRpcUrl, getSrcDirectory } from \"@latticexyz/common/foundry\";\nimport chalk from \"chalk\";\nimport chokidar from \"chokidar\";\nimport { loadConfig, resolveConfigPath } from \"@latticexyz/config/node\";\nimport { StoreConfig, tablegen } from \"@latticexyz/store\";\nimport path from \"path\";\nimport { tsgen } from \"../render-ts\";\nimport { debounce } from \"throttle-debounce\";\nimport { worldgenHandler } from \"./worldgen\";\nimport { WorldConfig } from \"@latticexyz/world\";\nimport { deployHandler, printMUD, worldtypes } from \"../utils\";\n\ntype Options = {\n rpc?: string;\n configPath?: string;\n tsgenOutput: string;\n};\n\nconst commandModule: CommandModule<Options, Options> = {\n command: \"dev-contracts\",\n\n describe: \"Start a development server for MUD contracts\",\n\n builder(yargs) {\n return yargs.options({\n rpc: {\n type: \"string\",\n decs: \"RPC endpoint of the development node. If none is provided, an anvil instance is spawned in the background on port 8545.\",\n },\n configPath: {\n type: \"string\",\n decs: \"Path to MUD config\",\n },\n tsgenOutput: { type: \"string\", demandOption: true, desc: \"Directory to output MUD typescript definition files\" },\n });\n },\n\n async handler(args) {\n if (!args.tsgenOutputDir) {\n console.error(\"No output provided\");\n }\n\n // Initial cleanup\n await forge([\"clean\"]);\n\n const rpc = args.rpc ?? (await getRpcUrl());\n const configPath = args.configPath ?? (await resolveConfigPath(args.configPath));\n const srcDirectory = await getSrcDirectory();\n const initialConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;\n\n // Initial run of all codegen steps before starting anvil\n // (so clients can wait for everything to be ready before starting)\n await handleConfigChange(initialConfig);\n await handleContractsChange(initialConfig);\n\n // Start an anvil instance in the background if no RPC url is provided\n if (!args.rpc) {\n const anvilArgs = [\"--block-time\", \"1\", \"--block-base-fee-per-gas\", \"0\"];\n anvil(anvilArgs);\n }\n\n const changedSinceLastHandled = {\n config: false,\n contracts: false,\n };\n\n const changeInProgress = {\n current: false,\n };\n\n // Watch for changes\n const configWatcher = chokidar.watch([configPath, srcDirectory]);\n configWatcher.on(\"all\", async (_, updatePath) => {\n if (updatePath.includes(configPath)) {\n changedSinceLastHandled.config = true;\n // We trigger contract changes if the config changed here instead of\n // listening to changes in the codegen directory to avoid an infinite loop\n changedSinceLastHandled.contracts = true;\n }\n\n if (updatePath.includes(srcDirectory)) {\n // Ignore changes to codegen files to avoid an infinite loop\n if (updatePath.includes(initialConfig.codegenDirectory)) return;\n changedSinceLastHandled.contracts = true;\n }\n\n // Trigger debounced onChange\n handleChange();\n });\n\n const handleChange = debounce(100, async () => {\n // Avoid handling changes multiple times in parallel\n if (changeInProgress.current) return;\n changeInProgress.current = true;\n\n // Load latest config\n const mudConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;\n\n // Reset dirty flags\n const { config, contracts } = changedSinceLastHandled;\n changedSinceLastHandled.config = false;\n changedSinceLastHandled.contracts = false;\n\n // Handle changes\n try {\n if (config) await handleConfigChange(mudConfig);\n if (contracts) await handleContractsChange(mudConfig);\n\n await deploy();\n } catch (error) {\n console.error(\"MUD dev-contracts watcher failed to deploy config or contracts changes\", error);\n }\n\n changeInProgress.current = false;\n if (changedSinceLastHandled.config || changedSinceLastHandled.contracts) {\n console.log(\"Detected change while handling the previous change\");\n handleChange();\n }\n\n printMUD();\n console.log(\"MUD watching for changes...\");\n });\n\n /** Codegen to run if config changes */\n async function handleConfigChange(config: StoreConfig & WorldConfig) {\n console.log(chalk.blue(\"mud.config.ts changed - regenerating tables and recs types\"));\n // Run tablegen to generate tables based on the config\n const outPath = path.join(srcDirectory, config.codegenDirectory);\n await tablegen(config, outPath);\n\n // Run tsgen to regenerate recs types based on the mud config\n await tsgen(config, args.tsgenOutput);\n }\n\n /** Codegen to run if contracts changed */\n async function handleContractsChange(config: StoreConfig & WorldConfig) {\n console.log(chalk.blue(\"contracts changed - regenerating interfaces and contract types\"));\n\n // Run worldgen to generate interfaces based on the systems\n await worldgenHandler({ config, clean: true, srcDir: srcDirectory });\n\n // Build the contracts\n await forge([\"build\"]);\n\n // Run typechain to rebuild typescript types for the contracts\n await worldtypes();\n }\n\n /** Run after codegen if either mud config or contracts changed */\n async function deploy() {\n console.log(chalk.blue(\"redeploying World\"));\n await deployHandler({\n configPath,\n skipBuild: true,\n priorityFeeMultiplier: 1,\n disableTxWait: true,\n pollInterval: 1000,\n saveDeployment: true,\n srcDir: srcDirectory,\n rpc,\n });\n }\n },\n};\n\nexport default commandModule;\n","import { CommandModule } from \"yargs\";\n\nimport devnode from \"./devnode\";\nimport faucet from \"./faucet\";\nimport gasReport from \"./gas-report\";\nimport hello from \"./hello\";\nimport tablegen from \"./tablegen\";\nimport tsgen from \"./tsgen\";\nimport deploy from \"./deploy\";\nimport worldgen from \"./worldgen\";\nimport setVersion from \"./set-version\";\nimport test from \"./test\";\nimport devContracts from \"./dev-contracts\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Each command has different options\nexport const commands: CommandModule<any, any>[] = [\n deploy,\n devnode,\n faucet,\n gasReport,\n hello,\n tablegen,\n tsgen,\n worldgen,\n setVersion,\n test,\n devContracts,\n];\n"],"mappings":"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","names":["yargs","hideBin","rmSync","homedir","path","execa","commandModule","yargs","blocktime","userHomeDir","anvilArgs","child","devnode_default","FaucetServiceDefinition","createChannel","createClient","chalk","NodeHttpTransport","createFaucetService","url","commandModule","yargs","dripDev","faucetUrl","address","faucet","faucet_default","readFileSync","writeFileSync","rmSync","execa","chalk","table","getBorderCharacters","tempFileSuffix","commandModule","yargs","files","save","compare","validFiles","file","tempFiles","createGasReport","gasReport","runGasReport","compareGasReport","entry","prevEntry","e","printGasReport","saveGasReport","gas_report_default","filename","fileContents","newFile","functionRegex","functionMatch","functionSignature","regex","match","name","functionCall","tempFileName","logs","error","gasReportRegex","gasReportMatch","source","gasUsed","a","b","headers","values","diff","diffEntry","compareColumns","gasUsedEntry","rows","path","commandModule","yargs","name","greeting","hello_default","path","loadConfig","tablegen","getSrcDirectory","commandModule","yargs","configPath","config","srcDir","tablegen_default","loadConfig","commandModule","yargs","args","configPath","out","config","loadConfig","tsgen","tsgen_default","chalk","ZodError","fromZodError","ValidationError","NotInsideProjectError","MUDError","logError","error","validationError","getOutDirectory","path","runTypeChain","worldtypes","cwd","forgeOurDir","IWorldPath","chalk","printMUD","yDeployOptions","commandModule","yargs","args","deployHandler","error","logError","deploy_default","loadConfig","worldgen","getSrcDirectory","glob","path","basename","rmSync","commandModule","yargs","args","worldgenHandler","srcDir","existingContracts","mudConfig","outputBaseDirectory","worldgen_default","chalk","existsSync","readFileSync","rmSync","writeFileSync","path","MUDError","package_default","BACKUP_FILE","MUD_PREFIX","commandModule","yargs","options","MUDError","getCanaryVersion","package_default","rootPath","workspaces","updatePackageJson","workspace","filePath","path","e","logError","restore","force","link","backup","mudVersion","backupFilePath","backupFileExists","existsSync","packageJson","readPackageJson","backupJson","mudDependencies","key","mudDevDependencies","writeFileSync","chalk","resolveMudVersion","logComparison","rmSync","type","resolveLinkPath","jsonString","readFileSync","pkg","canary","prev","curr","packageJsonPath","mudLinkPath","pkgName","packageJsonToRootPath","set_version_default","anvil","forge","getRpcUrl","chalk","rmSync","writeFileSync","WORLD_ADDRESS_FILE","commandModule","yargs","yDeployOptions","args","anvilArgs","anvil","forkRpc","getRpcUrl","worldAddress","deployHandler","chalk","writeFileSync","userOptions","testResult","forge","e","rmSync","test_default","anvil","forge","getRpcUrl","getSrcDirectory","chalk","chokidar","loadConfig","resolveConfigPath","tablegen","path","debounce","commandModule","yargs","args","forge","rpc","getRpcUrl","configPath","resolveConfigPath","srcDirectory","getSrcDirectory","initialConfig","loadConfig","handleConfigChange","handleContractsChange","anvil","changedSinceLastHandled","changeInProgress","chokidar","_","updatePath","handleChange","debounce","mudConfig","config","contracts","deploy","error","printMUD","chalk","outPath","path","tablegen","tsgen","worldgenHandler","worldtypes","deployHandler","dev_contracts_default","commands","deploy_default","devnode_default","faucet_default","gas_report_default","hello_default","tablegen_default","tsgen_default","worldgen_default","set_version_default","test_default","dev_contracts_default","dotenv","chalk","yargs","hideBin","commands","msg","err","logError"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@latticexyz/cli",
3
- "version": "2.0.0-alpha.1.131+ba10d78b",
3
+ "version": "2.0.0-alpha.1.132+47ab35d7",
4
4
  "description": "Command line interface for mud",
5
5
  "repository": {
6
6
  "type": "git",
@@ -31,14 +31,14 @@
31
31
  "@ethersproject/providers": "^5.7.2",
32
32
  "@improbable-eng/grpc-web": "^0.15.0",
33
33
  "@improbable-eng/grpc-web-node-http-transport": "^0.15.0",
34
- "@latticexyz/common": "2.0.0-alpha.1.131+ba10d78b",
35
- "@latticexyz/config": "2.0.0-alpha.1.131+ba10d78b",
36
- "@latticexyz/schema-type": "2.0.0-alpha.1.131+ba10d78b",
37
- "@latticexyz/services": "2.0.0-alpha.1.131+ba10d78b",
38
- "@latticexyz/solecs": "2.0.0-alpha.1.131+ba10d78b",
39
- "@latticexyz/std-contracts": "2.0.0-alpha.1.131+ba10d78b",
40
- "@latticexyz/store": "2.0.0-alpha.1.131+ba10d78b",
41
- "@latticexyz/world": "2.0.0-alpha.1.131+ba10d78b",
34
+ "@latticexyz/common": "2.0.0-alpha.1.132+47ab35d7",
35
+ "@latticexyz/config": "2.0.0-alpha.1.132+47ab35d7",
36
+ "@latticexyz/schema-type": "2.0.0-alpha.1.132+47ab35d7",
37
+ "@latticexyz/services": "2.0.0-alpha.1.132+47ab35d7",
38
+ "@latticexyz/solecs": "2.0.0-alpha.1.132+47ab35d7",
39
+ "@latticexyz/std-contracts": "2.0.0-alpha.1.132+47ab35d7",
40
+ "@latticexyz/store": "2.0.0-alpha.1.132+47ab35d7",
41
+ "@latticexyz/world": "2.0.0-alpha.1.132+47ab35d7",
42
42
  "@typechain/ethers-v5": "^10.2.0",
43
43
  "chalk": "^5.0.1",
44
44
  "chokidar": "^3.5.3",
@@ -51,6 +51,7 @@
51
51
  "openurl": "^1.1.1",
52
52
  "path": "^0.12.7",
53
53
  "table": "^6.8.1",
54
+ "throttle-debounce": "^5.0.0",
54
55
  "typechain": "^8.1.1",
55
56
  "typescript": "^4.9.5",
56
57
  "yargs": "^17.7.1",
@@ -62,6 +63,7 @@
62
63
  "@types/glob": "^7.2.0",
63
64
  "@types/node": "^18.15.11",
64
65
  "@types/openurl": "^1.0.0",
66
+ "@types/throttle-debounce": "^5.0.0",
65
67
  "@types/yargs": "^17.0.10",
66
68
  "ds-test": "https://github.com/dapphub/ds-test.git#c9ce3f25bde29fc5eb9901842bf02850dfd2d084",
67
69
  "forge-std": "https://github.com/foundry-rs/forge-std.git#b4f121555729b3afb3c5ffccb62ff4b6e2818fd3",
@@ -69,5 +71,5 @@
69
71
  "tsx": "^3.12.6",
70
72
  "vitest": "0.30.1"
71
73
  },
72
- "gitHead": "ba10d78b5446041678c9ff280087523fb41107b9"
74
+ "gitHead": "47ab35d746b174be806d633699e7ef7570052ce4"
73
75
  }
package/src/commands/deploy.ts CHANGED
@@ -23,6 +23,7 @@ export const yDeployOptions = {
23
23
  desc: "Interval in miliseconds to use to poll for transaction receipts / block inclusion",
24
24
  default: 1000,
25
25
  },
26
+ skipBuild: { type: "boolean", desc: "Skip rebuilding the contracts before deploying" },
26
27
  } satisfies Record<keyof DeployOptions, Options>;
27
28
 
28
29
  const commandModule: CommandModule<DeployOptions, DeployOptions> = {
package/src/commands/dev-contracts.ts ADDED
@@ -0,0 +1,167 @@
1
+ import type { CommandModule } from "yargs";
2
+ import { anvil, forge, getRpcUrl, getSrcDirectory } from "@latticexyz/common/foundry";
3
+ import chalk from "chalk";
4
+ import chokidar from "chokidar";
5
+ import { loadConfig, resolveConfigPath } from "@latticexyz/config/node";
6
+ import { StoreConfig, tablegen } from "@latticexyz/store";
7
+ import path from "path";
8
+ import { tsgen } from "../render-ts";
9
+ import { debounce } from "throttle-debounce";
10
+ import { worldgenHandler } from "./worldgen";
11
+ import { WorldConfig } from "@latticexyz/world";
12
+ import { deployHandler, printMUD, worldtypes } from "../utils";
13
+
14
+ type Options = {
15
+ rpc?: string;
16
+ configPath?: string;
17
+ tsgenOutput: string;
18
+ };
19
+
20
+ const commandModule: CommandModule<Options, Options> = {
21
+ command: "dev-contracts",
22
+
23
+ describe: "Start a development server for MUD contracts",
24
+
25
+ builder(yargs) {
26
+ return yargs.options({
27
+ rpc: {
28
+ type: "string",
29
+ decs: "RPC endpoint of the development node. If none is provided, an anvil instance is spawned in the background on port 8545.",
30
+ },
31
+ configPath: {
32
+ type: "string",
33
+ decs: "Path to MUD config",
34
+ },
35
+ tsgenOutput: { type: "string", demandOption: true, desc: "Directory to output MUD typescript definition files" },
36
+ });
37
+ },
38
+
39
+ async handler(args) {
40
+ if (!args.tsgenOutputDir) {
41
+ console.error("No output provided");
42
+ }
43
+
44
+ // Initial cleanup
45
+ await forge(["clean"]);
46
+
47
+ const rpc = args.rpc ?? (await getRpcUrl());
48
+ const configPath = args.configPath ?? (await resolveConfigPath(args.configPath));
49
+ const srcDirectory = await getSrcDirectory();
50
+ const initialConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;
51
+
52
+ // Initial run of all codegen steps before starting anvil
53
+ // (so clients can wait for everything to be ready before starting)
54
+ await handleConfigChange(initialConfig);
55
+ await handleContractsChange(initialConfig);
56
+
57
+ // Start an anvil instance in the background if no RPC url is provided
58
+ if (!args.rpc) {
59
+ const anvilArgs = ["--block-time", "1", "--block-base-fee-per-gas", "0"];
60
+ anvil(anvilArgs);
61
+ }
62
+
63
+ const changedSinceLastHandled = {
64
+ config: false,
65
+ contracts: false,
66
+ };
67
+
68
+ const changeInProgress = {
69
+ current: false,
70
+ };
71
+
72
+ // Watch for changes
73
+ const configWatcher = chokidar.watch([configPath, srcDirectory]);
74
+ configWatcher.on("all", async (_, updatePath) => {
75
+ if (updatePath.includes(configPath)) {
76
+ changedSinceLastHandled.config = true;
77
+ // We trigger contract changes if the config changed here instead of
78
+ // listening to changes in the codegen directory to avoid an infinite loop
79
+ changedSinceLastHandled.contracts = true;
80
+ }
81
+
82
+ if (updatePath.includes(srcDirectory)) {
83
+ // Ignore changes to codegen files to avoid an infinite loop
84
+ if (updatePath.includes(initialConfig.codegenDirectory)) return;
85
+ changedSinceLastHandled.contracts = true;
86
+ }
87
+
88
+ // Trigger debounced onChange
89
+ handleChange();
90
+ });
91
+
92
+ const handleChange = debounce(100, async () => {
93
+ // Avoid handling changes multiple times in parallel
94
+ if (changeInProgress.current) return;
95
+ changeInProgress.current = true;
96
+
97
+ // Load latest config
98
+ const mudConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;
99
+
100
+ // Reset dirty flags
101
+ const { config, contracts } = changedSinceLastHandled;
102
+ changedSinceLastHandled.config = false;
103
+ changedSinceLastHandled.contracts = false;
104
+
105
+ // Handle changes
106
+ try {
107
+ if (config) await handleConfigChange(mudConfig);
108
+ if (contracts) await handleContractsChange(mudConfig);
109
+
110
+ await deploy();
111
+ } catch (error) {
112
+ console.error("MUD dev-contracts watcher failed to deploy config or contracts changes", error);
113
+ }
114
+
115
+ changeInProgress.current = false;
116
+ if (changedSinceLastHandled.config || changedSinceLastHandled.contracts) {
117
+ console.log("Detected change while handling the previous change");
118
+ handleChange();
119
+ }
120
+
121
+ printMUD();
122
+ console.log("MUD watching for changes...");
123
+ });
124
+
125
+ /** Codegen to run if config changes */
126
+ async function handleConfigChange(config: StoreConfig & WorldConfig) {
127
+ console.log(chalk.blue("mud.config.ts changed - regenerating tables and recs types"));
128
+ // Run tablegen to generate tables based on the config
129
+ const outPath = path.join(srcDirectory, config.codegenDirectory);
130
+ await tablegen(config, outPath);
131
+
132
+ // Run tsgen to regenerate recs types based on the mud config
133
+ await tsgen(config, args.tsgenOutput);
134
+ }
135
+
136
+ /** Codegen to run if contracts changed */
137
+ async function handleContractsChange(config: StoreConfig & WorldConfig) {
138
+ console.log(chalk.blue("contracts changed - regenerating interfaces and contract types"));
139
+
140
+ // Run worldgen to generate interfaces based on the systems
141
+ await worldgenHandler({ config, clean: true, srcDir: srcDirectory });
142
+
143
+ // Build the contracts
144
+ await forge(["build"]);
145
+
146
+ // Run typechain to rebuild typescript types for the contracts
147
+ await worldtypes();
148
+ }
149
+
150
+ /** Run after codegen if either mud config or contracts changed */
151
+ async function deploy() {
152
+ console.log(chalk.blue("redeploying World"));
153
+ await deployHandler({
154
+ configPath,
155
+ skipBuild: true,
156
+ priorityFeeMultiplier: 1,
157
+ disableTxWait: true,
158
+ pollInterval: 1000,
159
+ saveDeployment: true,
160
+ srcDir: srcDirectory,
161
+ rpc,
162
+ });
163
+ }
164
+ },
165
+ };
166
+
167
+ export default commandModule;
package/src/commands/index.ts CHANGED
@@ -10,6 +10,7 @@ import deploy from "./deploy";
10
10
  import worldgen from "./worldgen";
11
11
  import setVersion from "./set-version";
12
12
  import test from "./test";
13
+ import devContracts from "./dev-contracts";
13
14
 
14
15
  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Each command has different options
15
16
  export const commands: CommandModule<any, any>[] = [
@@ -23,4 +24,5 @@ export const commands: CommandModule<any, any>[] = [
23
24
  worldgen,
24
25
  setVersion,
25
26
  test,
27
+ devContracts,
26
28
  ];
package/src/commands/worldgen.ts CHANGED
@@ -11,6 +11,8 @@ import { rmSync } from "fs";
11
11
  type Options = {
12
12
  configPath?: string;
13
13
  clean?: boolean;
14
+ srcDir?: string;
15
+ config?: StoreConfig & WorldConfig;
14
16
  };
15
17
 
16
18
  const commandModule: CommandModule<Options, Options> = {
@@ -26,28 +28,30 @@ const commandModule: CommandModule<Options, Options> = {
26
28
  },
27
29
 
28
30
  async handler(args) {
29
- const { configPath, clean } = args;
30
- const srcDir = await getSrcDirectory();
31
+ await worldgenHandler(args);
32
+ process.exit(0);
33
+ },
34
+ };
31
35
 
32
- // Get a list of all contract names
33
- const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path) => ({
34
- path,
35
- basename: basename(path, ".sol"),
36
- }));
36
+ export async function worldgenHandler(args: Options) {
37
+ const srcDir = args.srcDir ?? (await getSrcDirectory());
37
38
 
38
- // Load the config
39
- const mudConfig = (await loadConfig(configPath)) as StoreConfig & WorldConfig;
39
+ // Get a list of all contract names
40
+ const existingContracts = glob.sync(`${srcDir}/**/*.sol`).map((path) => ({
41
+ path,
42
+ basename: basename(path, ".sol"),
43
+ }));
40
44
 
41
- const outputBaseDirectory = path.join(srcDir, mudConfig.codegenDirectory);
45
+ // Load the config
46
+ const mudConfig = args.config ?? ((await loadConfig(args.configPath)) as StoreConfig & WorldConfig);
42
47
 
43
- // clear the worldgen directory
44
- if (clean) rmSync(path.join(outputBaseDirectory, mudConfig.worldgenDirectory), { recursive: true, force: true });
48
+ const outputBaseDirectory = path.join(srcDir, mudConfig.codegenDirectory);
45
49
 
46
- // generate new interfaces
47
- await worldgen(mudConfig, existingContracts, outputBaseDirectory);
50
+ // clear the worldgen directory
51
+ if (args.clean) rmSync(path.join(outputBaseDirectory, mudConfig.worldgenDirectory), { recursive: true, force: true });
48
52
 
49
- process.exit(0);
50
- },
51
- };
53
+ // generate new interfaces
54
+ await worldgen(mudConfig, existingContracts, outputBaseDirectory);
55
+ }
52
56
 
53
57
  export default commandModule;
package/src/mud.ts CHANGED
@@ -7,6 +7,7 @@ import { logError } from "./utils/errors";
7
7
 
8
8
  // Load .env file into process.env
9
9
  import * as dotenv from "dotenv";
10
+ import chalk from "chalk";
10
11
  dotenv.config();
11
12
 
12
13
  yargs(hideBin(process.argv))
@@ -19,6 +20,12 @@ yargs(hideBin(process.argv))
19
20
  .strict()
20
21
  // Custom error handler
21
22
  .fail((msg, err) => {
23
+ console.error(chalk.red(msg));
24
+ if (msg.includes("Missing required argument")) {
25
+ console.log(
26
+ chalk.yellow(`Run 'pnpm mud ${process.argv[2]} --help' for a list of available and required arguments.`)
27
+ );
28
+ }
22
29
  console.log("");
23
30
  logError(err);
24
31
  console.log("");