@diamondslab/diamonds-hardhat-foundry 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.4] - 2025-12-16
+
+### Fixed
+- Templates from `src/templates/` are now properly copied to `dist/templates/` during build
+- Added `copy-templates` script to ensure all `.template` files are included in the published package
+
 ## [1.0.0] - 2025-12-15
 
 Initial public release of `@diamondslab/diamonds-hardhat-foundry`.

package/dist/foundry.d.ts

@@ -0,0 +1,11 @@
+import { NomicLabsHardhatPluginError } from "hardhat/internal/core/errors";
+type Remappings = Record<string, string>;
+export declare class HardhatFoundryError extends NomicLabsHardhatPluginError {
+    constructor(message: string, parent?: Error);
+}
+export declare function getForgeConfig(): any;
+export declare function parseRemappings(remappingsTxt: string): Remappings;
+export declare function getRemappings(): Promise<Remappings>;
+export declare function installDependency(dependency: string): Promise<void>;
+export {};
+//# sourceMappingURL=foundry.d.ts.map

package/dist/foundry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry.d.ts","sourceRoot":"","sources":["../src/foundry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAM3E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIzC,qBAAa,mBAAoB,SAAQ,2BAA2B;gBACtD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK;CAG5C;AAcD,wBAAgB,cAAc,QAE7B;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CA+BjE;AAED,wBAAsB,aAAa,wBAOlC;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,iBAgBzD"}

package/dist/foundry.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependency = exports.getRemappings = exports.parseRemappings = exports.getForgeConfig = exports.HardhatFoundryError = void 0;
+const child_process_1 = require("child_process");
+const errors_1 = require("hardhat/internal/core/errors");
+const picocolors_1 = __importDefault(require("picocolors"));
+const util_1 = require("util");
+const exec = (0, util_1.promisify)(child_process_1.exec);
+let cachedRemappings;
+class HardhatFoundryError extends errors_1.NomicLabsHardhatPluginError {
+    constructor(message, parent) {
+        super("diamonds-hardhat-foundry", message, parent);
+    }
+}
+exports.HardhatFoundryError = HardhatFoundryError;
+class ForgeInstallError extends HardhatFoundryError {
+    constructor(dependency, parent) {
+        super(`Couldn't install '${dependency}', please install it manually.
+
+${parent.message}
+`, parent);
+    }
+}
+function getForgeConfig() {
+    return JSON.parse(runCmdSync("forge config --json"));
+}
+exports.getForgeConfig = getForgeConfig;
+function parseRemappings(remappingsTxt) {
+    const remappings = {};
+    const remappingLines = remappingsTxt.split(/\r\n|\r|\n/);
+    for (const remappingLine of remappingLines) {
+        if (remappingLine.trim() === "") {
+            continue;
+        }
+        if (remappingLine.includes(":")) {
+            throw new HardhatFoundryError(`Invalid remapping '${remappingLine}', remapping contexts are not allowed`);
+        }
+        if (!remappingLine.includes("=")) {
+            throw new HardhatFoundryError(`Invalid remapping '${remappingLine}', remappings without a target are not allowed`);
+        }
+        const fromTo = remappingLine.split("=");
+        // if the remapping already exists, we ignore it because the first one wins
+        if (remappings[fromTo[0]] !== undefined) {
+            continue;
+        }
+        remappings[fromTo[0]] = fromTo[1];
+    }
+    return remappings;
+}
+exports.parseRemappings = parseRemappings;
+async function getRemappings() {
+    // Get remappings only once
+    if (cachedRemappings === undefined) {
+        cachedRemappings = runCmd("forge remappings").then(parseRemappings);
+    }
+    return cachedRemappings;
+}
+exports.getRemappings = getRemappings;
+async function installDependency(dependency) {
+    // Check if --no-commit flag is supported. Best way is checking the help text
+    const helpText = await runCmd("forge install --help");
+    const useNoCommitFlag = helpText.includes("--no-commit");
+    const cmd = `forge install ${useNoCommitFlag ? "--no-commit" : ""} ${dependency}`;
+    console.log(`Running '${picocolors_1.default.blue(cmd)}'`);
+    try {
+        await exec(cmd);
+    }
+    catch (error) {
+        throw new ForgeInstallError(dependency, error);
+    }
+}
+exports.installDependency = installDependency;
+function runCmdSync(cmd) {
+    try {
+        return (0, child_process_1.execSync)(cmd, { stdio: "pipe" }).toString();
+    }
+    catch (error) {
+        const pluginError = buildForgeExecutionError(error.status, error.stderr.toString());
+        throw pluginError;
+    }
+}
+async function runCmd(cmd) {
+    try {
+        const { stdout } = await exec(cmd);
+        return stdout;
+    }
+    catch (error) {
+        throw buildForgeExecutionError(error.code, error.message);
+    }
+}
+function buildForgeExecutionError(exitCode, message) {
+    switch (exitCode) {
+        case 127:
+            return new HardhatFoundryError("Couldn't run `forge`. Please check that your foundry installation is correct.");
+        case 134:
+            return new HardhatFoundryError("Running `forge` failed. Please check that your foundry.toml file is correct.");
+        default:
+            return new HardhatFoundryError(`Unexpected error while running \`forge\`: ${message}`);
+    }
+}
+//# sourceMappingURL=foundry.js.map

package/dist/foundry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundry.js","sourceRoot":"","sources":["../src/foundry.ts"],"names":[],"mappings":"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","sourcesContent":["import { exec as execCallback, execSync } from \"child_process\";\nimport { NomicLabsHardhatPluginError } from \"hardhat/internal/core/errors\";\nimport picocolors from \"picocolors\";\nimport { promisify } from \"util\";\n\nconst exec = promisify(execCallback);\n\ntype Remappings = Record<string, string>;\n\nlet cachedRemappings: Promise<Remappings> | undefined;\n\nexport class HardhatFoundryError extends NomicLabsHardhatPluginError {\n  constructor(message: string, parent?: Error) {\n    super(\"diamonds-hardhat-foundry\", message, parent);\n  }\n}\n\nclass ForgeInstallError extends HardhatFoundryError {\n  constructor(dependency: string, parent: Error) {\n    super(\n      `Couldn't install '${dependency}', please install it manually.\n\n${parent.message}\n`,\n      parent\n    );\n  }\n}\n\nexport function getForgeConfig() {\n  return JSON.parse(runCmdSync(\"forge config --json\"));\n}\n\nexport function parseRemappings(remappingsTxt: string): Remappings {\n  const remappings: Remappings = {};\n  const remappingLines = remappingsTxt.split(/\\r\\n|\\r|\\n/);\n  for (const remappingLine of remappingLines) {\n    if (remappingLine.trim() === \"\") {\n      continue;\n    }\n\n    if (remappingLine.includes(\":\")) {\n      throw new HardhatFoundryError(\n        `Invalid remapping '${remappingLine}', remapping contexts are not allowed`\n      );\n    }\n\n    if (!remappingLine.includes(\"=\")) {\n      throw new HardhatFoundryError(\n        `Invalid remapping '${remappingLine}', remappings without a target are not allowed`\n      );\n    }\n\n    const fromTo = remappingLine.split(\"=\");\n\n    // if the remapping already exists, we ignore it because the first one wins\n    if (remappings[fromTo[0]] !== undefined) {\n      continue;\n    }\n\n    remappings[fromTo[0]] = fromTo[1];\n  }\n\n  return remappings;\n}\n\nexport async function getRemappings() {\n  // Get remappings only once\n  if (cachedRemappings === undefined) {\n    cachedRemappings = runCmd(\"forge remappings\").then(parseRemappings);\n  }\n\n  return cachedRemappings;\n}\n\nexport async function installDependency(dependency: string) {\n  // Check if --no-commit flag is supported. Best way is checking the help text\n  const helpText = await runCmd(\"forge install --help\");\n  const useNoCommitFlag = helpText.includes(\"--no-commit\");\n\n  const cmd = `forge install ${\n    useNoCommitFlag ? \"--no-commit\" : \"\"\n  } ${dependency}`;\n\n  console.log(`Running '${picocolors.blue(cmd)}'`);\n\n  try {\n    await exec(cmd);\n  } catch (error: any) {\n    throw new ForgeInstallError(dependency, error);\n  }\n}\n\nfunction runCmdSync(cmd: string): string {\n  try {\n    return execSync(cmd, { stdio: \"pipe\" }).toString();\n  } catch (error: any) {\n    const pluginError = buildForgeExecutionError(\n      error.status,\n      error.stderr.toString()\n    );\n\n    throw pluginError;\n  }\n}\n\nasync function runCmd(cmd: string): Promise<string> {\n  try {\n    const { stdout } = await exec(cmd);\n    return stdout;\n  } catch (error: any) {\n    throw buildForgeExecutionError(error.code, error.message);\n  }\n}\n\nfunction buildForgeExecutionError(\n  exitCode: number | undefined,\n  message: string\n) {\n  switch (exitCode) {\n    case 127:\n      return new HardhatFoundryError(\n        \"Couldn't run `forge`. Please check that your foundry installation is correct.\"\n      );\n    case 134:\n      return new HardhatFoundryError(\n        \"Running `forge` failed. Please check that your foundry.toml file is correct.\"\n      );\n    default:\n      return new HardhatFoundryError(\n        `Unexpected error while running \\`forge\\`: ${message}`\n      );\n  }\n}\n"]}

package/dist/framework/DeploymentManager.d.ts

@@ -0,0 +1,48 @@
+import { Diamond } from "@diamondslab/diamonds";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+/**
+ * DeploymentManager - Manages Diamond deployment lifecycle for Forge testing
+ *
+ * Note: This class dynamically requires LocalDiamondDeployer from the workspace
+ * to avoid module resolution issues in the published package.
+ */
+export declare class DeploymentManager {
+    private hre;
+    constructor(hre: HardhatRuntimeEnvironment);
+    /**
+     * Get LocalDiamondDeployer class
+     * @private
+     */
+    private getDeployerClass;
+    /**
+     * Deploy a Diamond using LocalDiamondDeployer
+     * @param diamondName - Name of the Diamond to deploy
+     * @param networkName - Target network (hardhat, localhost, anvil)
+     * @param force - Force redeployment even if exists
+     */
+    deploy(diamondName?: string, networkName?: string, force?: boolean): Promise<Diamond>;
+    /**
+     * Get existing deployment record
+     * @param diamondName - Name of the Diamond
+     * @param networkName - Network name
+     * @param chainId - Chain ID
+     */
+    getDeployment(diamondName?: string, networkName?: string, chainId?: number): Promise<Diamond | null>;
+    /**
+     * Ensure deployment exists, deploy if needed
+     * @param diamondName - Name of the Diamond
+     * @param networkName - Network name
+     * @param force - Force redeployment
+     */
+    ensureDeployment(diamondName?: string, networkName?: string, force?: boolean): Promise<Diamond>;
+    /**
+     * Check if deployment record exists
+     * @private
+     */
+    private hasDeploymentRecord;
+    /**
+     * Get deployment file path
+     */
+    getDeploymentPath(diamondName: string, networkName: string, chainId: number): string;
+}
+//# sourceMappingURL=DeploymentManager.d.ts.map

package/dist/framework/DeploymentManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeploymentManager.d.ts","sourceRoot":"","sources":["../../src/framework/DeploymentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAa1D;;;;;GAKG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,yBAAyB;IAElD;;;OAGG;YACW,gBAAgB;IAkB9B;;;;;OAKG;IACG,MAAM,CACV,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC;IAmDnB;;;;;OAKG;IACG,aAAa,CACjB,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IA2B1B;;;;;OAKG;IACG,gBAAgB,CACpB,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC;IAiBnB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM;CAUV"}

package/dist/framework/DeploymentManager.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+/**
+ * DeploymentManager - Manages Diamond deployment lifecycle for Forge testing
+ *
+ * Note: This class dynamically requires LocalDiamondDeployer from the workspace
+ * to avoid module resolution issues in the published package.
+ */
+class DeploymentManager {
+    hre;
+    constructor(hre) {
+        this.hre = hre;
+    }
+    /**
+     * Get LocalDiamondDeployer class
+     * @private
+     */
+    async getDeployerClass() {
+        // LocalDiamondDeployer is in the workspace scripts, not exported from the module
+        // This will need to be available in user projects
+        const localDeployerPath = (0, path_1.join)(this.hre.config.paths.root, "scripts/setup/LocalDiamondDeployer");
+        try {
+            const deployer = await import(localDeployerPath);
+            return deployer.LocalDiamondDeployer;
+        }
+        catch {
+            throw new Error("LocalDiamondDeployer not found. Make sure your project has scripts/setup/LocalDiamondDeployer.ts");
+        }
+    }
+    /**
+     * Deploy a Diamond using LocalDiamondDeployer
+     * @param diamondName - Name of the Diamond to deploy
+     * @param networkName - Target network (hardhat, localhost, anvil)
+     * @param force - Force redeployment even if exists
+     */
+    async deploy(diamondName = "ExampleDiamond", networkName = "hardhat", force = false) {
+        logger_1.Logger.section(`Deploying ${diamondName} to ${networkName}`);
+        // Get provider and network info
+        const provider = this.hre.ethers.provider;
+        const network = await provider.getNetwork();
+        const chainId = Number(network.chainId);
+        // Check if deployment exists and handle force flag
+        if (!force && this.hasDeploymentRecord(diamondName, networkName, chainId)) {
+            logger_1.Logger.info("Deployment record exists, using existing deployment");
+            logger_1.Logger.info("Use --force to redeploy");
+            const LocalDiamondDeployer = await this.getDeployerClass();
+            const deployer = await LocalDiamondDeployer.getInstance({
+                diamondName,
+                networkName,
+                provider,
+                chainId,
+                writeDeployedDiamondData: true,
+            });
+            return await deployer.getDiamond();
+        }
+        logger_1.Logger.step("Initializing LocalDiamondDeployer...");
+        const LocalDiamondDeployer = await this.getDeployerClass();
+        const deployer = await LocalDiamondDeployer.getInstance({
+            diamondName,
+            networkName,
+            provider,
+            chainId,
+            writeDeployedDiamondData: true,
+        });
+        await deployer.setVerbose(false); // Reduce noise, use our logger instead
+        logger_1.Logger.step("Deploying Diamond contract...");
+        const diamond = await deployer.getDiamondDeployed();
+        const deployedData = diamond.getDeployedDiamondData();
+        logger_1.Logger.success(`Diamond deployed at: ${deployedData.DiamondAddress}`);
+        logger_1.Logger.info(`Deployer: ${deployedData.DeployerAddress}`);
+        logger_1.Logger.info(`Facets deployed: ${Object.keys(deployedData.DeployedFacets || {}).length}`);
+        return diamond;
+    }
+    /**
+     * Get existing deployment record
+     * @param diamondName - Name of the Diamond
+     * @param networkName - Network name
+     * @param chainId - Chain ID
+     */
+    async getDeployment(diamondName = "ExampleDiamond", networkName = "hardhat", chainId) {
+        try {
+            const provider = this.hre.ethers.provider;
+            const network = await provider.getNetwork();
+            const actualChainId = chainId ?? Number(network.chainId);
+            if (!this.hasDeploymentRecord(diamondName, networkName, actualChainId)) {
+                logger_1.Logger.warn("No deployment record found");
+                return null;
+            }
+            const LocalDiamondDeployer = await this.getDeployerClass();
+            const deployer = await LocalDiamondDeployer.getInstance({
+                diamondName,
+                networkName,
+                provider,
+                chainId: actualChainId,
+                writeDeployedDiamondData: false,
+            });
+            return await deployer.getDiamond();
+        }
+        catch (error) {
+            logger_1.Logger.error(`Failed to get deployment: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Ensure deployment exists, deploy if needed
+     * @param diamondName - Name of the Diamond
+     * @param networkName - Network name
+     * @param force - Force redeployment
+     */
+    async ensureDeployment(diamondName = "ExampleDiamond", networkName = "hardhat", force = false) {
+        const provider = this.hre.ethers.provider;
+        const network = await provider.getNetwork();
+        const chainId = Number(network.chainId);
+        // Check if deployment exists
+        const existing = await this.getDeployment(diamondName, networkName, chainId);
+        if (existing && !force) {
+            logger_1.Logger.info("Using existing deployment");
+            return existing;
+        }
+        // Deploy if not exists or force is true
+        return await this.deploy(diamondName, networkName, force);
+    }
+    /**
+     * Check if deployment record exists
+     * @private
+     */
+    hasDeploymentRecord(diamondName, networkName, chainId) {
+        const deploymentFileName = `${diamondName.toLowerCase()}-${networkName.toLowerCase()}-${chainId}.json`;
+        const deploymentPath = (0, path_1.join)(this.hre.config.paths.root, "diamonds", diamondName, "deployments", deploymentFileName);
+        return (0, fs_1.existsSync)(deploymentPath);
+    }
+    /**
+     * Get deployment file path
+     */
+    getDeploymentPath(diamondName, networkName, chainId) {
+        const deploymentFileName = `${diamondName.toLowerCase()}-${networkName.toLowerCase()}-${chainId}.json`;
+        return (0, path_1.join)(this.hre.config.paths.root, "diamonds", diamondName, "deployments", deploymentFileName);
+    }
+}
+exports.DeploymentManager = DeploymentManager;
+//# sourceMappingURL=DeploymentManager.js.map

package/dist/framework/DeploymentManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeploymentManager.js","sourceRoot":"","sources":["../../src/framework/DeploymentManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { Diamond } from \"@diamondslab/diamonds\";\nimport { existsSync } from \"fs\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { join } from \"path\";\nimport { Logger } from \"../utils/logger\";\n\n// Type for LocalDiamondDeployer (avoiding import issues)\ntype LocalDiamondDeployerConfig = {\n  diamondName: string;\n  networkName: string;\n  provider: any;\n  chainId: number;\n  writeDeployedDiamondData: boolean;\n};\n\n/**\n * DeploymentManager - Manages Diamond deployment lifecycle for Forge testing\n * \n * Note: This class dynamically requires LocalDiamondDeployer from the workspace\n * to avoid module resolution issues in the published package.\n */\nexport class DeploymentManager {\n  constructor(private hre: HardhatRuntimeEnvironment) {}\n\n  /**\n   * Get LocalDiamondDeployer class\n   * @private\n   */\n  private async getDeployerClass(): Promise<any> {\n    // LocalDiamondDeployer is in the workspace scripts, not exported from the module\n    // This will need to be available in user projects\n    const localDeployerPath = join(\n      this.hre.config.paths.root,\n      \"scripts/setup/LocalDiamondDeployer\"\n    );\n    \n    try {\n      const deployer = await import(localDeployerPath);\n      return deployer.LocalDiamondDeployer;\n    } catch {\n      throw new Error(\n        \"LocalDiamondDeployer not found. Make sure your project has scripts/setup/LocalDiamondDeployer.ts\"\n      );\n    }\n  }\n\n  /**\n   * Deploy a Diamond using LocalDiamondDeployer\n   * @param diamondName - Name of the Diamond to deploy\n   * @param networkName - Target network (hardhat, localhost, anvil)\n   * @param force - Force redeployment even if exists\n   */\n  async deploy(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    force: boolean = false\n  ): Promise<Diamond> {\n    Logger.section(`Deploying ${diamondName} to ${networkName}`);\n\n    // Get provider and network info\n    const provider = this.hre.ethers.provider;\n    const network = await provider.getNetwork();\n    const chainId = Number(network.chainId);\n\n    // Check if deployment exists and handle force flag\n    if (!force && this.hasDeploymentRecord(diamondName, networkName, chainId)) {\n      Logger.info(\"Deployment record exists, using existing deployment\");\n      Logger.info(\"Use --force to redeploy\");\n      \n      const LocalDiamondDeployer = await this.getDeployerClass();\n      const deployer = await LocalDiamondDeployer.getInstance({\n        diamondName,\n        networkName,\n        provider,\n        chainId,\n        writeDeployedDiamondData: true,\n      } as LocalDiamondDeployerConfig);\n      \n      return await deployer.getDiamond();\n    }\n\n    Logger.step(\"Initializing LocalDiamondDeployer...\");\n    \n    const LocalDiamondDeployer = await this.getDeployerClass();\n    \n    const deployer = await LocalDiamondDeployer.getInstance({\n      diamondName,\n      networkName,\n      provider,\n      chainId,\n      writeDeployedDiamondData: true,\n    } as LocalDiamondDeployerConfig);\n\n    await deployer.setVerbose(false); // Reduce noise, use our logger instead\n\n    Logger.step(\"Deploying Diamond contract...\");\n    const diamond = await deployer.getDiamondDeployed();\n    \n    const deployedData = diamond.getDeployedDiamondData();\n    \n    Logger.success(`Diamond deployed at: ${deployedData.DiamondAddress}`);\n    Logger.info(`Deployer: ${deployedData.DeployerAddress}`);\n    Logger.info(`Facets deployed: ${Object.keys(deployedData.DeployedFacets || {}).length}`);\n\n    return diamond;\n  }\n\n  /**\n   * Get existing deployment record\n   * @param diamondName - Name of the Diamond\n   * @param networkName - Network name\n   * @param chainId - Chain ID\n   */\n  async getDeployment(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    chainId?: number\n  ): Promise<Diamond | null> {\n    try {\n      const provider = this.hre.ethers.provider;\n      const network = await provider.getNetwork();\n      const actualChainId = chainId ?? Number(network.chainId);\n\n      if (!this.hasDeploymentRecord(diamondName, networkName, actualChainId)) {\n        Logger.warn(\"No deployment record found\");\n        return null;\n      }\n\n      const LocalDiamondDeployer = await this.getDeployerClass();\n      const deployer = await LocalDiamondDeployer.getInstance({\n        diamondName,\n        networkName,\n        provider,\n        chainId: actualChainId,\n        writeDeployedDiamondData: false,\n      } as LocalDiamondDeployerConfig);\n\n      return await deployer.getDiamond();\n    } catch (error) {\n      Logger.error(`Failed to get deployment: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * Ensure deployment exists, deploy if needed\n   * @param diamondName - Name of the Diamond\n   * @param networkName - Network name\n   * @param force - Force redeployment\n   */\n  async ensureDeployment(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    force: boolean = false\n  ): Promise<Diamond> {\n    const provider = this.hre.ethers.provider;\n    const network = await provider.getNetwork();\n    const chainId = Number(network.chainId);\n\n    // Check if deployment exists\n    const existing = await this.getDeployment(diamondName, networkName, chainId);\n    \n    if (existing && !force) {\n      Logger.info(\"Using existing deployment\");\n      return existing;\n    }\n\n    // Deploy if not exists or force is true\n    return await this.deploy(diamondName, networkName, force);\n  }\n\n  /**\n   * Check if deployment record exists\n   * @private\n   */\n  private hasDeploymentRecord(\n    diamondName: string,\n    networkName: string,\n    chainId: number\n  ): boolean {\n    const deploymentFileName = `${diamondName.toLowerCase()}-${networkName.toLowerCase()}-${chainId}.json`;\n    const deploymentPath = join(\n      this.hre.config.paths.root,\n      \"diamonds\",\n      diamondName,\n      \"deployments\",\n      deploymentFileName\n    );\n\n    return existsSync(deploymentPath);\n  }\n\n  /**\n   * Get deployment file path\n   */\n  getDeploymentPath(\n    diamondName: string,\n    networkName: string,\n    chainId: number\n  ): string {\n    const deploymentFileName = `${diamondName.toLowerCase()}-${networkName.toLowerCase()}-${chainId}.json`;\n    return join(\n      this.hre.config.paths.root,\n      \"diamonds\",\n      diamondName,\n      \"deployments\",\n      deploymentFileName\n    );\n  }\n}\n"]}

package/dist/framework/ForgeFuzzingFramework.d.ts

@@ -0,0 +1,57 @@
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+export interface ForgeTestOptions {
+    /** Name of the Diamond to deploy */
+    diamondName?: string;
+    /** Network to deploy on */
+    networkName?: string;
+    /** Force redeployment */
+    force?: boolean;
+    /** Match test pattern */
+    matchTest?: string;
+    /** Match contract pattern */
+    matchContract?: string;
+    /** Verbosity level (1-5) */
+    verbosity?: number;
+    /** Show gas report */
+    gasReport?: boolean;
+    /** Skip helper generation */
+    skipHelpers?: boolean;
+    /** Skip deployment (use existing) */
+    skipDeployment?: boolean;
+}
+/**
+ * ForgeFuzzingFramework - Main orchestration class for Forge testing with Diamonds
+ *
+ * Coordinates:
+ * 1. Diamond deployment via DeploymentManager
+ * 2. Helper generation via HelperGenerator
+ * 3. Forge test execution
+ */
+export declare class ForgeFuzzingFramework {
+    private hre;
+    private deploymentManager;
+    private helperGenerator;
+    constructor(hre: HardhatRuntimeEnvironment);
+    /**
+     * Run complete Forge testing workflow
+     *
+     * Workflow:
+     * 1. Validate Foundry installation
+     * 2. Deploy or reuse Diamond
+     * 3. Generate Solidity helpers
+     * 4. Compile Forge contracts
+     * 5. Run Forge tests
+     *
+     * @param options - Test execution options
+     */
+    runTests(options?: ForgeTestOptions): Promise<boolean>;
+    /**
+     * Deploy Diamond only (no testing)
+     */
+    deployOnly(diamondName?: string, networkName?: string, force?: boolean): Promise<import("@diamondslab/diamonds").Diamond>;
+    /**
+     * Generate helpers only (no deployment or testing)
+     */
+    generateHelpersOnly(diamondName?: string, networkName?: string): Promise<string>;
+}
+//# sourceMappingURL=ForgeFuzzingFramework.d.ts.map

package/dist/framework/ForgeFuzzingFramework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeFuzzingFramework.d.ts","sourceRoot":"","sources":["../../src/framework/ForgeFuzzingFramework.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAM1D,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAIpB,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,eAAe,CAAkB;gBAErB,GAAG,EAAE,yBAAyB;IAKlD;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4FhE;;OAEG;IACG,UAAU,CACd,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,KAAK,GAAE,OAAe;IASxB;;OAEG;IACG,mBAAmB,CACvB,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB;CAwBlC"}

package/dist/framework/ForgeFuzzingFramework.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForgeFuzzingFramework = void 0;
+const foundry_1 = require("../utils/foundry");
+const logger_1 = require("../utils/logger");
+const DeploymentManager_1 = require("./DeploymentManager");
+const HelperGenerator_1 = require("./HelperGenerator");
+/**
+ * ForgeFuzzingFramework - Main orchestration class for Forge testing with Diamonds
+ *
+ * Coordinates:
+ * 1. Diamond deployment via DeploymentManager
+ * 2. Helper generation via HelperGenerator
+ * 3. Forge test execution
+ */
+class ForgeFuzzingFramework {
+    hre;
+    deploymentManager;
+    helperGenerator;
+    constructor(hre) {
+        this.hre = hre;
+        this.deploymentManager = new DeploymentManager_1.DeploymentManager(hre);
+        this.helperGenerator = new HelperGenerator_1.HelperGenerator(hre);
+    }
+    /**
+     * Run complete Forge testing workflow
+     *
+     * Workflow:
+     * 1. Validate Foundry installation
+     * 2. Deploy or reuse Diamond
+     * 3. Generate Solidity helpers
+     * 4. Compile Forge contracts
+     * 5. Run Forge tests
+     *
+     * @param options - Test execution options
+     */
+    async runTests(options = {}) {
+        const { diamondName = "ExampleDiamond", networkName = "hardhat", force = false, matchTest, matchContract, verbosity = 2, gasReport = false, skipHelpers = false, skipDeployment = false, } = options;
+        logger_1.Logger.section("Forge Fuzzing Framework - Test Execution");
+        // Step 1: Validate Foundry
+        if (!(0, foundry_1.isFoundryInstalled)()) {
+            logger_1.Logger.error("Foundry is not installed. Please install it: https://book.getfoundry.sh/getting-started/installation");
+            return false;
+        }
+        try {
+            // Step 2: Ensure Diamond deployment
+            if (!skipDeployment) {
+                logger_1.Logger.section("Step 1/4: Ensuring Diamond Deployment");
+                await this.deploymentManager.ensureDeployment(diamondName, networkName, force);
+            }
+            else {
+                logger_1.Logger.info("Skipping deployment (using existing)");
+            }
+            // Step 3: Generate helpers
+            if (!skipHelpers) {
+                logger_1.Logger.section("Step 2/4: Generating Solidity Helpers");
+                const deployment = await this.deploymentManager.getDeployment(diamondName, networkName);
+                if (!deployment) {
+                    logger_1.Logger.error("No deployment found. Cannot generate helpers.");
+                    return false;
+                }
+                const provider = this.hre.ethers.provider;
+                const network = await provider.getNetwork();
+                const chainId = Number(network.chainId);
+                const deploymentData = deployment.getDeployedDiamondData();
+                await this.helperGenerator.generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData);
+            }
+            else {
+                logger_1.Logger.info("Skipping helper generation");
+            }
+            // Step 4: Compile Forge contracts
+            logger_1.Logger.section("Step 3/4: Compiling Forge Contracts");
+            const compileResult = await (0, foundry_1.compileForge)({
+                cwd: this.hre.config.paths.root,
+                verbose: verbosity >= 3,
+            });
+            if (!compileResult.success) {
+                logger_1.Logger.error("Forge compilation failed");
+                return false;
+            }
+            // Step 5: Run tests
+            logger_1.Logger.section("Step 4/4: Running Forge Tests");
+            const testResult = await (0, foundry_1.runForgeTest)({
+                matchTest,
+                matchContract,
+                verbosity,
+                gasReport,
+                cwd: this.hre.config.paths.root,
+            });
+            return testResult.success;
+        }
+        catch (error) {
+            logger_1.Logger.error(`Test execution failed: ${error.message}`);
+            return false;
+        }
+    }
+    /**
+     * Deploy Diamond only (no testing)
+     */
+    async deployOnly(diamondName = "ExampleDiamond", networkName = "hardhat", force = false) {
+        return await this.deploymentManager.ensureDeployment(diamondName, networkName, force);
+    }
+    /**
+     * Generate helpers only (no deployment or testing)
+     */
+    async generateHelpersOnly(diamondName = "ExampleDiamond", networkName = "hardhat") {
+        const deployment = await this.deploymentManager.getDeployment(diamondName, networkName);
+        if (!deployment) {
+            throw new Error("No deployment found. Deploy first using deployOnly()");
+        }
+        const provider = this.hre.ethers.provider;
+        const network = await provider.getNetwork();
+        const chainId = Number(network.chainId);
+        const deploymentData = deployment.getDeployedDiamondData();
+        return await this.helperGenerator.generateDeploymentHelpers(diamondName, networkName, chainId, deploymentData);
+    }
+}
+exports.ForgeFuzzingFramework = ForgeFuzzingFramework;
+//# sourceMappingURL=ForgeFuzzingFramework.js.map

package/dist/framework/ForgeFuzzingFramework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeFuzzingFramework.js","sourceRoot":"","sources":["../../src/framework/ForgeFuzzingFramework.ts"],"names":[],"mappings":"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","sourcesContent":["import { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { compileForge, isFoundryInstalled, runForgeTest } from \"../utils/foundry\";\nimport { Logger } from \"../utils/logger\";\nimport { DeploymentManager } from \"./DeploymentManager\";\nimport { HelperGenerator } from \"./HelperGenerator\";\n\nexport interface ForgeTestOptions {\n  /** Name of the Diamond to deploy */\n  diamondName?: string;\n  /** Network to deploy on */\n  networkName?: string;\n  /** Force redeployment */\n  force?: boolean;\n  /** Match test pattern */\n  matchTest?: string;\n  /** Match contract pattern */\n  matchContract?: string;\n  /** Verbosity level (1-5) */\n  verbosity?: number;\n  /** Show gas report */\n  gasReport?: boolean;\n  /** Skip helper generation */\n  skipHelpers?: boolean;\n  /** Skip deployment (use existing) */\n  skipDeployment?: boolean;\n}\n\n/**\n * ForgeFuzzingFramework - Main orchestration class for Forge testing with Diamonds\n * \n * Coordinates:\n * 1. Diamond deployment via DeploymentManager\n * 2. Helper generation via HelperGenerator\n * 3. Forge test execution\n */\nexport class ForgeFuzzingFramework {\n  private deploymentManager: DeploymentManager;\n  private helperGenerator: HelperGenerator;\n\n  constructor(private hre: HardhatRuntimeEnvironment) {\n    this.deploymentManager = new DeploymentManager(hre);\n    this.helperGenerator = new HelperGenerator(hre);\n  }\n\n  /**\n   * Run complete Forge testing workflow\n   * \n   * Workflow:\n   * 1. Validate Foundry installation\n   * 2. Deploy or reuse Diamond\n   * 3. Generate Solidity helpers\n   * 4. Compile Forge contracts\n   * 5. Run Forge tests\n   * \n   * @param options - Test execution options\n   */\n  async runTests(options: ForgeTestOptions = {}): Promise<boolean> {\n    const {\n      diamondName = \"ExampleDiamond\",\n      networkName = \"hardhat\",\n      force = false,\n      matchTest,\n      matchContract,\n      verbosity = 2,\n      gasReport = false,\n      skipHelpers = false,\n      skipDeployment = false,\n    } = options;\n\n    Logger.section(\"Forge Fuzzing Framework - Test Execution\");\n\n    // Step 1: Validate Foundry\n    if (!isFoundryInstalled()) {\n      Logger.error(\"Foundry is not installed. Please install it: https://book.getfoundry.sh/getting-started/installation\");\n      return false;\n    }\n\n    try {\n      // Step 2: Ensure Diamond deployment\n      if (!skipDeployment) {\n        Logger.section(\"Step 1/4: Ensuring Diamond Deployment\");\n        await this.deploymentManager.ensureDeployment(\n          diamondName,\n          networkName,\n          force\n        );\n      } else {\n        Logger.info(\"Skipping deployment (using existing)\");\n      }\n\n      // Step 3: Generate helpers\n      if (!skipHelpers) {\n        Logger.section(\"Step 2/4: Generating Solidity Helpers\");\n        const deployment = await this.deploymentManager.getDeployment(\n          diamondName,\n          networkName\n        );\n\n        if (!deployment) {\n          Logger.error(\"No deployment found. Cannot generate helpers.\");\n          return false;\n        }\n\n        const provider = this.hre.ethers.provider;\n        const network = await provider.getNetwork();\n        const chainId = Number(network.chainId);\n\n        const deploymentData = deployment.getDeployedDiamondData();\n        \n        await this.helperGenerator.generateDeploymentHelpers(\n          diamondName,\n          networkName,\n          chainId,\n          deploymentData\n        );\n      } else {\n        Logger.info(\"Skipping helper generation\");\n      }\n\n      // Step 4: Compile Forge contracts\n      Logger.section(\"Step 3/4: Compiling Forge Contracts\");\n      const compileResult = await compileForge({\n        cwd: this.hre.config.paths.root,\n        verbose: verbosity >= 3,\n      });\n\n      if (!compileResult.success) {\n        Logger.error(\"Forge compilation failed\");\n        return false;\n      }\n\n      // Step 5: Run tests\n      Logger.section(\"Step 4/4: Running Forge Tests\");\n      const testResult = await runForgeTest({\n        matchTest,\n        matchContract,\n        verbosity,\n        gasReport,\n        cwd: this.hre.config.paths.root,\n      });\n\n      return testResult.success;\n    } catch (error: any) {\n      Logger.error(`Test execution failed: ${error.message}`);\n      return false;\n    }\n  }\n\n  /**\n   * Deploy Diamond only (no testing)\n   */\n  async deployOnly(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    force: boolean = false\n  ) {\n    return await this.deploymentManager.ensureDeployment(\n      diamondName,\n      networkName,\n      force\n    );\n  }\n\n  /**\n   * Generate helpers only (no deployment or testing)\n   */\n  async generateHelpersOnly(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\"\n  ) {\n    const deployment = await this.deploymentManager.getDeployment(\n      diamondName,\n      networkName\n    );\n\n    if (!deployment) {\n      throw new Error(\"No deployment found. Deploy first using deployOnly()\");\n    }\n\n    const provider = this.hre.ethers.provider;\n    const network = await provider.getNetwork();\n    const chainId = Number(network.chainId);\n\n    const deploymentData = deployment.getDeployedDiamondData();\n\n    return await this.helperGenerator.generateDeploymentHelpers(\n      diamondName,\n      networkName,\n      chainId,\n      deploymentData\n    );\n  }\n}\n\n"]}

package/dist/framework/HelperGenerator.d.ts

@@ -0,0 +1,27 @@
+import { DeployedDiamondData } from "@diamondslab/diamonds";
+import { HardhatRuntimeEnvironment } from "hardhat/types";
+/**
+ * HelperGenerator - Generates Solidity helper files for testing
+ */
+export declare class HelperGenerator {
+    private hre;
+    constructor(hre: HardhatRuntimeEnvironment);
+    /**
+     * Scaffold project with initial test structure
+     */
+    scaffoldProject(outputDir?: string): Promise<void>;
+    /**
+     * Generate DiamondDeployment.sol from deployment record
+     */
+    generateDeploymentHelpers(diamondName: string, networkName: string, chainId: number, deploymentData: DeployedDiamondData): Promise<string>;
+    /**
+     * Generate example test files
+     */
+    generateExampleTests(): Promise<string[]>;
+    /**
+     * Generate Solidity library source from deployment data
+     * @private
+     */
+    private generateLibrarySource;
+}
+//# sourceMappingURL=HelperGenerator.d.ts.map

package/dist/framework/HelperGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperGenerator.d.ts","sourceRoot":"","sources":["../../src/framework/HelperGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAI1D;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,yBAAyB;IAElD;;OAEG;IACG,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD;;OAEG;IACG,yBAAyB,CAC7B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,mBAAmB,GAClC,OAAO,CAAC,MAAM,CAAC;IA6BlB;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAuE/C;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAmG9B"}