@diamondslab/diamonds-hardhat-foundry 1.0.2 → 2.1.0

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

@@ -1 +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"}
+{"version":3,"file":"DeploymentManager.d.ts","sourceRoot":"","sources":["../../src/framework/DeploymentManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAKrD,OAAO,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAI/D;;;;;GAKG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,GAAG;IAFvB,OAAO,CAAC,eAAe,CAAmC;gBAEtC,GAAG,EAAE,yBAAyB;IAElD;;;;;;OAMG;IACG,MAAM,CACV,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,KAAK,GAAE,OAAe,EACtB,wBAAwB,GAAE,OAAe,GACxC,OAAO,CAAC,OAAO,CAAC;IAqEnB;;;;;OAKG;IACG,aAAa,CACjB,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAiC1B;;;;;;OAMG;IACG,gBAAgB,CACpB,WAAW,GAAE,MAAyB,EACtC,WAAW,GAAE,MAAkB,EAC/B,KAAK,GAAE,OAAe,EACtB,wBAAwB,GAAE,OAAe,GACxC,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

@@ -1,43 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeploymentManager = void 0;
+const lib_1 = require("@diamondslab/hardhat-diamonds/dist/lib");
+require("@nomicfoundation/hardhat-ethers");
 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.
+ * Uses LocalDiamondDeployer from @diamondslab/hardhat-diamonds peer dependency
+ * for portable, dependency-managed Diamond deployments.
  */
 class DeploymentManager {
     hre;
+    // In-memory cache for ephemeral deployments (when writeDeployedDiamondData: false)
+    deploymentCache = new Map();
     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
+     * @param writeDeployedDiamondData - Whether to write deployment record to file
      */
-    async deploy(diamondName = "ExampleDiamond", networkName = "hardhat", force = false) {
+    async deploy(diamondName = "ExampleDiamond", networkName = "hardhat", force = false, writeDeployedDiamondData = false) {
         logger_1.Logger.section(`Deploying ${diamondName} to ${networkName}`);
         // Get provider and network info
         const provider = this.hre.ethers.provider;
@@ -47,33 +36,49 @@ class DeploymentManager {
         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({
+            try {
+                const deployer = await lib_1.LocalDiamondDeployer.getInstance(this.hre, {
+                    diamondName,
+                    networkName,
+                    provider,
+                    chainId,
+                    writeDeployedDiamondData,
+                });
+                return await deployer.getDiamond();
+            }
+            catch (error) {
+                throw new Error(`Failed to load deployment. Ensure @diamondslab/hardhat-diamonds is installed.\n` +
+                    `Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        logger_1.Logger.step("Initializing LocalDiamondDeployer...");
+        try {
+            const deployer = await lib_1.LocalDiamondDeployer.getInstance(this.hre, {
                 diamondName,
                 networkName,
                 provider,
                 chainId,
-                writeDeployedDiamondData: true,
+                writeDeployedDiamondData,
             });
-            return await deployer.getDiamond();
+            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}`);
+            // Cache deployment if not writing to file
+            if (!writeDeployedDiamondData) {
+                const cacheKey = `${diamondName}-${networkName}-${chainId}`;
+                this.deploymentCache.set(cacheKey, diamond);
+                logger_1.Logger.info("Deployment cached in memory (not persisted to file)");
+            }
+            return diamond;
+        }
+        catch (error) {
+            throw new Error(`Failed to deploy diamond. Ensure @diamondslab/hardhat-diamonds is installed.\n` +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
         }
-        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
@@ -86,12 +91,17 @@ class DeploymentManager {
             const provider = this.hre.ethers.provider;
             const network = await provider.getNetwork();
             const actualChainId = chainId ?? Number(network.chainId);
+            // Check in-memory cache first (for ephemeral deployments)
+            const cacheKey = `${diamondName}-${networkName}-${actualChainId}`;
+            if (this.deploymentCache.has(cacheKey)) {
+                logger_1.Logger.info("Using cached deployment (ephemeral)");
+                return this.deploymentCache.get(cacheKey);
+            }
             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({
+            const deployer = await lib_1.LocalDiamondDeployer.getInstance(this.hre, {
                 diamondName,
                 networkName,
                 provider,
@@ -101,7 +111,7 @@ class DeploymentManager {
             return await deployer.getDiamond();
         }
         catch (error) {
-            logger_1.Logger.error(`Failed to get deployment: ${error}`);
+            logger_1.Logger.error(`Failed to get deployment. Ensure @diamondslab/hardhat-diamonds is installed: ${error}`);
             return null;
         }
     }
@@ -110,8 +120,9 @@ class DeploymentManager {
      * @param diamondName - Name of the Diamond
      * @param networkName - Network name
      * @param force - Force redeployment
+     * @param writeDeployedDiamondData - Whether to write deployment record to file
      */
-    async ensureDeployment(diamondName = "ExampleDiamond", networkName = "hardhat", force = false) {
+    async ensureDeployment(diamondName = "ExampleDiamond", networkName = "hardhat", force = false, writeDeployedDiamondData = false) {
         const provider = this.hre.ethers.provider;
         const network = await provider.getNetwork();
         const chainId = Number(network.chainId);
@@ -122,7 +133,7 @@ class DeploymentManager {
             return existing;
         }
         // Deploy if not exists or force is true
-        return await this.deploy(diamondName, networkName, force);
+        return await this.deploy(diamondName, networkName, force, writeDeployedDiamondData);
     }
     /**
      * Check if deployment record exists

package/dist/framework/DeploymentManager.js.map

@@ -1 +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"]}
+{"version":3,"file":"DeploymentManager.js","sourceRoot":"","sources":["../../src/framework/DeploymentManager.ts"],"names":[],"mappings":";;;AACA,gEAGgD;AAChD,2CAAyC;AACzC,2BAAgC;AAEhC,+BAA4B;AAC5B,4CAAyC;AAEzC;;;;;GAKG;AACH,MAAa,iBAAiB;IAIR;IAHpB,mFAAmF;IAC3E,eAAe,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE1D,YAAoB,GAA8B;QAA9B,QAAG,GAAH,GAAG,CAA2B;IAAG,CAAC;IAEtD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,cAAsB,gBAAgB,EACtC,cAAsB,SAAS,EAC/B,QAAiB,KAAK,EACtB,2BAAoC,KAAK;QAEzC,eAAM,CAAC,OAAO,CAAC,aAAa,WAAW,OAAO,WAAW,EAAE,CAAC,CAAC;QAE7D,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,mDAAmD;QACnD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;YACzE,eAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YACnE,eAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YAEvC,IAAI;gBACF,MAAM,QAAQ,GAAG,MAAM,0BAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE;oBAChE,WAAW;oBACX,WAAW;oBACX,QAAQ;oBACR,OAAO;oBACP,wBAAwB;iBACK,CAAC,CAAC;gBAEjC,OAAO,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;aACpC;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,IAAI,KAAK,CACb,iFAAiF;oBACjF,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;aACH;SACF;QAED,eAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAEpD,IAAI;YACF,MAAM,QAAQ,GAAG,MAAM,0BAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,GAAU,EAAE;gBACvE,WAAW;gBACX,WAAW;gBACX,QAAQ;gBACR,OAAO;gBACP,wBAAwB;aACK,CAAC,CAAC;YAEjC,MAAM,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,uCAAuC;YAEzE,eAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAEpD,MAAM,YAAY,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;YAEtD,eAAM,CAAC,OAAO,CAAC,wBAAwB,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC;YACtE,eAAM,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;YACzD,eAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAEzF,0CAA0C;YAC1C,IAAI,CAAC,wBAAwB,EAAE;gBAC7B,MAAM,QAAQ,GAAG,GAAG,WAAW,IAAI,WAAW,IAAI,OAAO,EAAE,CAAC;gBAC5D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC5C,eAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;aACpE;YAED,OAAO,OAAO,CAAC;SAChB;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAChF,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;SACH;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,cAAsB,gBAAgB,EACtC,cAAsB,SAAS,EAC/B,OAAgB;QAEhB,IAAI;YACF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEzD,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,GAAG,WAAW,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;YAClE,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACtC,eAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;gBACnD,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;aAC5C;YAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE;gBACtE,eAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;gBAC1C,OAAO,IAAI,CAAC;aACb;YAED,MAAM,QAAQ,GAAG,MAAM,0BAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,GAAU,EAAE;gBACvE,WAAW;gBACX,WAAW;gBACX,QAAQ;gBACR,OAAO,EAAE,aAAa;gBACtB,wBAAwB,EAAE,KAAK;aACF,CAAC,CAAC;YAEjC,OAAO,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;SACpC;QAAC,OAAO,KAAK,EAAE;YACd,eAAM,CAAC,KAAK,CAAC,gFAAgF,KAAK,EAAE,CAAC,CAAC;YACtG,OAAO,IAAI,CAAC;SACb;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CACpB,cAAsB,gBAAgB,EACtC,cAAsB,SAAS,EAC/B,QAAiB,KAAK,EACtB,2BAAoC,KAAK;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAE7E,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE;YACtB,eAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,QAAQ,CAAC;SACjB;QAED,wCAAwC;QACxC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC;IACtF,CAAC;IAED;;;OAGG;IACK,mBAAmB,CACzB,WAAmB,EACnB,WAAmB,EACnB,OAAe;QAEf,MAAM,kBAAkB,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,WAAW,EAAE,IAAI,OAAO,OAAO,CAAC;QACvG,MAAM,cAAc,GAAG,IAAA,WAAI,EACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAC1B,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,CACnB,CAAC;QAEF,OAAO,IAAA,eAAU,EAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,WAAmB,EACnB,WAAmB,EACnB,OAAe;QAEf,MAAM,kBAAkB,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,WAAW,EAAE,IAAI,OAAO,OAAO,CAAC;QACvG,OAAO,IAAA,WAAI,EACT,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAC1B,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,CACnB,CAAC;IACJ,CAAC;CACF;AArMD,8CAqMC","sourcesContent":["import { Diamond } from \"@diamondslab/diamonds/core\";\nimport {\n  LocalDiamondDeployer,\n  LocalDiamondDeployerConfig,\n} from \"@diamondslab/hardhat-diamonds/dist/lib\";\nimport \"@nomicfoundation/hardhat-ethers\";\nimport { existsSync } from \"fs\";\nimport type { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { join } from \"path\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * DeploymentManager - Manages Diamond deployment lifecycle for Forge testing\n * \n * Uses LocalDiamondDeployer from @diamondslab/hardhat-diamonds peer dependency\n * for portable, dependency-managed Diamond deployments.\n */\nexport class DeploymentManager {\n  // In-memory cache for ephemeral deployments (when writeDeployedDiamondData: false)\n  private deploymentCache: Map<string, Diamond> = new Map();\n\n  constructor(private hre: HardhatRuntimeEnvironment) {}\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   * @param writeDeployedDiamondData - Whether to write deployment record to file\n   */\n  async deploy(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    force: boolean = false,\n    writeDeployedDiamondData: 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      try {\n        const deployer = await LocalDiamondDeployer.getInstance(this.hre, {\n          diamondName,\n          networkName,\n          provider,\n          chainId,\n          writeDeployedDiamondData,\n        } as LocalDiamondDeployerConfig);\n        \n        return await deployer.getDiamond();\n      } catch (error) {\n        throw new Error(\n          `Failed to load deployment. Ensure @diamondslab/hardhat-diamonds is installed.\\n` +\n          `Error: ${error instanceof Error ? error.message : String(error)}`\n        );\n      }\n    }\n\n    Logger.step(\"Initializing LocalDiamondDeployer...\");\n    \n    try {\n      const deployer = await LocalDiamondDeployer.getInstance(this.hre as any, {\n        diamondName,\n        networkName,\n        provider,\n        chainId,\n        writeDeployedDiamondData,\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      // Cache deployment if not writing to file\n      if (!writeDeployedDiamondData) {\n        const cacheKey = `${diamondName}-${networkName}-${chainId}`;\n        this.deploymentCache.set(cacheKey, diamond);\n        Logger.info(\"Deployment cached in memory (not persisted to file)\");\n      }\n\n      return diamond;\n    } catch (error) {\n      throw new Error(\n        `Failed to deploy diamond. Ensure @diamondslab/hardhat-diamonds is installed.\\n` +\n        `Error: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\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      // Check in-memory cache first (for ephemeral deployments)\n      const cacheKey = `${diamondName}-${networkName}-${actualChainId}`;\n      if (this.deploymentCache.has(cacheKey)) {\n        Logger.info(\"Using cached deployment (ephemeral)\");\n        return this.deploymentCache.get(cacheKey)!;\n      }\n\n      if (!this.hasDeploymentRecord(diamondName, networkName, actualChainId)) {\n        Logger.warn(\"No deployment record found\");\n        return null;\n      }\n\n      const deployer = await LocalDiamondDeployer.getInstance(this.hre as any, {\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. Ensure @diamondslab/hardhat-diamonds is installed: ${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   * @param writeDeployedDiamondData - Whether to write deployment record to file\n   */\n  async ensureDeployment(\n    diamondName: string = \"ExampleDiamond\",\n    networkName: string = \"hardhat\",\n    force: boolean = false,\n    writeDeployedDiamondData: 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, writeDeployedDiamondData);\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

@@ -18,6 +18,10 @@ export interface ForgeTestOptions {
     skipHelpers?: boolean;
     /** Skip deployment (use existing) */
     skipDeployment?: boolean;
+    /** Write deployment data to file (default: false for ephemeral) */
+    writeDeployedDiamondData?: boolean;
+    /** Use EVM snapshots for test isolation */
+    useSnapshot?: boolean;
 }
 /**
  * ForgeFuzzingFramework - Main orchestration class for Forge testing with Diamonds

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

@@ -1 +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"}
+{"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;IACzB,mEAAmE;IACnE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;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;IA8GhE;;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

@@ -35,7 +35,7 @@ class ForgeFuzzingFramework {
      * @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;
+        const { diamondName = "ExampleDiamond", networkName = "hardhat", writeDeployedDiamondData = false, useSnapshot = false, 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)()) {
@@ -46,7 +46,7 @@ class ForgeFuzzingFramework {
             // Step 2: Ensure Diamond deployment
             if (!skipDeployment) {
                 logger_1.Logger.section("Step 1/4: Ensuring Diamond Deployment");
-                await this.deploymentManager.ensureDeployment(diamondName, networkName, force);
+                await this.deploymentManager.ensureDeployment(diamondName, networkName, force, writeDeployedDiamondData);
             }
             else {
                 logger_1.Logger.info("Skipping deployment (using existing)");
@@ -80,11 +80,25 @@ class ForgeFuzzingFramework {
             }
             // Step 5: Run tests
             logger_1.Logger.section("Step 4/4: Running Forge Tests");
+            // Only fork when using persistent networks (localhost, sepolia, mainnet, etc.)
+            // The ephemeral "hardhat" network cannot be forked from
+            let forkUrl;
+            if (networkName !== "hardhat") {
+                const provider = this.hre.ethers.provider;
+                forkUrl = provider._hardhatProvider?._wrapped?.url || "http://127.0.0.1:8545";
+                logger_1.Logger.info(`Forking from ${networkName}: ${forkUrl}`);
+            }
+            else {
+                logger_1.Logger.warn(`⚠️  Using ephemeral "${networkName}" network - tests requiring deployed Diamond will fail`);
+                logger_1.Logger.warn(`💡 For deployed Diamond testing, use: npx hardhat diamonds-forge:test --network localhost`);
+                logger_1.Logger.warn(`💡 Make sure to start Hardhat node first: npx hardhat node`);
+            }
             const testResult = await (0, foundry_1.runForgeTest)({
                 matchTest,
                 matchContract,
                 verbosity,
                 gasReport,
+                forkUrl,
                 cwd: this.hre.config.paths.root,
             });
             return testResult.success;

package/dist/framework/ForgeFuzzingFramework.js.map

@@ -1 +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"]}
+{"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  /** Write deployment data to file (default: false for ephemeral) */\n  writeDeployedDiamondData?: boolean;\n  /** Use EVM snapshots for test isolation */\n  useSnapshot?: 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      writeDeployedDiamondData = false,\n      useSnapshot = false,\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          writeDeployedDiamondData\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      \n      // Only fork when using persistent networks (localhost, sepolia, mainnet, etc.)\n      // The ephemeral \"hardhat\" network cannot be forked from\n      let forkUrl: string | undefined;\n      if (networkName !== \"hardhat\") {\n        const provider = this.hre.ethers.provider;\n        forkUrl = (provider as any)._hardhatProvider?._wrapped?.url || \"http://127.0.0.1:8545\";\n        Logger.info(`Forking from ${networkName}: ${forkUrl}`);\n      } else {\n        Logger.warn(`⚠️  Using ephemeral \"${networkName}\" network - tests requiring deployed Diamond will fail`);\n        Logger.warn(`💡 For deployed Diamond testing, use: npx hardhat diamonds-forge:test --network localhost`);\n        Logger.warn(`💡 Make sure to start Hardhat node first: npx hardhat node`);\n      }\n      \n      const testResult = await runForgeTest({\n        matchTest,\n        matchContract,\n        verbosity,\n        gasReport,\n        forkUrl, // Only set for persistent networks\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.map

@@ -1 +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"}
+{"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;CAgH9B"}

package/dist/framework/HelperGenerator.js

@@ -140,6 +140,10 @@ class HelperGenerator {
         source += `    /// @notice Address of the deployed ${diamondName} contract\n`;
         source += `    /// @dev This is the main Diamond proxy address\n`;
         source += `    address constant DIAMOND_ADDRESS = ${deploymentData.DiamondAddress};\n\n`;
+        // Deployer address
+        source += `    /// @notice Address of the deployer account\n`;
+        source += `    /// @dev Account that deployed the Diamond\n`;
+        source += `    address constant DEPLOYER_ADDRESS = ${deploymentData.DeployerAddress};\n\n`;
         // Facet addresses
         source += "    // ========================================\n";
         source += "    // Facet Addresses\n";
@@ -167,6 +171,13 @@ class HelperGenerator {
         source += "        return DIAMOND_ADDRESS;\n";
         source += "    }\n\n";
         source += "    /**\n";
+        source += "     * @notice Get the deployer address\n";
+        source += "     * @return The address of the deployer account\n";
+        source += "     */\n";
+        source += "    function getDeployerAddress() internal pure returns (address) {\n";
+        source += "        return DEPLOYER_ADDRESS;\n";
+        source += "    }\n\n";
+        source += "    /**\n";
         source += "     * @notice Get facet implementation address by name\n";
         source += "     * @param facetName The name of the facet\n";
         source += "     * @return The address of the facet implementation\n";

package/dist/framework/HelperGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"HelperGenerator.js","sourceRoot":"","sources":["../../src/framework/HelperGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["import { DeployedDiamondData } from \"@diamondslab/diamonds\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { join } from \"path\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * HelperGenerator - Generates Solidity helper files for testing\n */\nexport class HelperGenerator {\n  constructor(private hre: HardhatRuntimeEnvironment) {}\n\n  /**\n   * Scaffold project with initial test structure\n   */\n  async scaffoldProject(outputDir?: string): Promise<void> {\n    const helpersDir = outputDir || this.hre.diamondsFoundry.helpersDir;\n    const basePath = join(this.hre.config.paths.root, helpersDir);\n\n    Logger.section(\"Scaffolding Forge Test Structure\");\n    \n    // Create directories\n    Logger.step(\"Creating directories...\");\n    mkdirSync(basePath, { recursive: true });\n    mkdirSync(join(basePath, \"../unit\"), { recursive: true });\n    mkdirSync(join(basePath, \"../integration\"), { recursive: true });\n    mkdirSync(join(basePath, \"../fuzz\"), { recursive: true });\n\n    Logger.success(`Test structure created at ${basePath}`);\n  }\n\n  /**\n   * Generate DiamondDeployment.sol from deployment record\n   */\n  async generateDeploymentHelpers(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): Promise<string> {\n    Logger.section(\"Generating Diamond Deployment Helper\");\n\n    const helpersDir = this.hre.diamondsFoundry.helpersDir;\n    const outputPath = join(\n      this.hre.config.paths.root,\n      helpersDir,\n      \"DiamondDeployment.sol\"\n    );\n\n    const content = this.generateLibrarySource(\n      diamondName,\n      networkName,\n      chainId,\n      deploymentData\n    );\n\n    // Ensure directory exists\n    mkdirSync(join(this.hre.config.paths.root, helpersDir), {\n      recursive: true,\n    });\n\n    // Write file\n    writeFileSync(outputPath, content, \"utf8\");\n\n    Logger.success(`Generated: ${outputPath}`);\n    return outputPath;\n  }\n\n  /**\n   * Generate example test files\n   */\n  async generateExampleTests(): Promise<string[]> {\n    const generated: string[] = [];\n    const examples = this.hre.diamondsFoundry.exampleTests;\n\n    if (!this.hre.diamondsFoundry.generateExamples) {\n      Logger.info(\"Example generation disabled in config\");\n      return generated;\n    }\n\n    Logger.section(\"Generating Example Tests\");\n\n    const basePath = join(this.hre.config.paths.root, \"test\", \"foundry\");\n    const templatesPath = join(__dirname, \"../templates\");\n\n    for (const type of examples) {\n      let templateFile = \"\";\n      let outputPath = \"\";\n\n      switch (type) {\n        case \"unit\":\n          templateFile = join(templatesPath, \"ExampleUnitTest.t.sol.template\");\n          outputPath = join(basePath, \"unit\", \"ExampleUnit.t.sol\");\n          break;\n        case \"integration\":\n          templateFile = join(templatesPath, \"ExampleIntegrationTest.t.sol.template\");\n          outputPath = join(basePath, \"integration\", \"ExampleIntegration.t.sol\");\n          break;\n        case \"fuzz\":\n          templateFile = join(templatesPath, \"ExampleFuzzTest.t.sol.template\");\n          outputPath = join(basePath, \"fuzz\", \"ExampleFuzz.t.sol\");\n          break;\n        default:\n          Logger.warn(`Unknown example type: ${type}`);\n          continue;\n      }\n\n      try {\n        // Check if template exists\n        if (!existsSync(templateFile)) {\n          Logger.warn(`Template not found: ${templateFile}`);\n          continue;\n        }\n\n        // Read template content\n        const templateContent = readFileSync(templateFile, \"utf8\");\n\n        // Ensure output directory exists\n        mkdirSync(join(basePath, type), { recursive: true });\n\n        // Check if file already exists\n        if (existsSync(outputPath)) {\n          Logger.info(`Skipping ${type} example (already exists): ${outputPath}`);\n          continue;\n        }\n\n        // Write example test file\n        writeFileSync(outputPath, templateContent, \"utf8\");\n        Logger.success(`Generated ${type} example: ${outputPath}`);\n        generated.push(outputPath);\n      } catch (error: any) {\n        Logger.error(`Failed to generate ${type} example: ${error.message}`);\n      }\n    }\n\n    if (generated.length === 0) {\n      Logger.info(\"No new example tests generated (may already exist)\");\n    }\n\n    return generated;\n  }\n\n  /**\n   * Generate Solidity library source from deployment data\n   * @private\n   */\n  private generateLibrarySource(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): string {\n    const timestamp = new Date().toISOString();\n    const networkInfo = `${networkName}-${chainId}`;\n    const deploymentFileName = `${diamondName.toLowerCase()}-${networkInfo}.json`;\n    const deploymentFilePath = `diamonds/${diamondName}/deployments/${deploymentFileName}`;\n\n    let source = \"\";\n\n    // SPDX and pragma\n    source += \"// SPDX-License-Identifier: MIT\\n\";\n    source += \"pragma solidity ^0.8.19;\\n\\n\";\n\n    // Header comments\n    source += \"/**\\n\";\n    source += ` * @title DiamondDeployment\\n`;\n    source += ` * @notice Auto-generated deployment data for ${diamondName}\\n`;\n    source += ` * @dev This library provides constants and helper functions for accessing\\n`;\n    source += ` *      deployment data in Forge tests. It is auto-generated from the deployment\\n`;\n    source += ` *      record and should not be edited manually.\\n`;\n    source += ` *\\n`;\n    source += ` * Generated from: ${deploymentFilePath}\\n`;\n    source += ` * Generated at: ${timestamp}\\n`;\n    source += ` *\\n`;\n    source += ` * To regenerate this file:\\n`;\n    source += ` *   npx hardhat diamonds-forge:generate-helpers --diamond ${diamondName}\\n`;\n    source += ` *\\n`;\n    source += ` * ⚠️  DO NOT EDIT MANUALLY - Changes will be overwritten on next generation\\n`;\n    source += \" */\\n\";\n    source += \"library DiamondDeployment {\\n\";\n\n    // Diamond address\n    source += `    /// @notice Address of the deployed ${diamondName} contract\\n`;\n    source += `    /// @dev This is the main Diamond proxy address\\n`;\n    source += `    address constant DIAMOND_ADDRESS = ${deploymentData.DiamondAddress};\\n\\n`;\n\n    // Facet addresses\n    source += \"    // ========================================\\n\";\n    source += \"    // Facet Addresses\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    const facets = deploymentData.DeployedFacets ?? {};\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      source += `    /// @notice Address of ${facetName} implementation\\n`;\n      source += `    address constant ${constantName} = ${facetData.address};\\n`;\n    }\n    source += \"\\n\";\n\n    // Helper functions\n    source += \"    // ========================================\\n\";\n    source += \"    // Helper Functions\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get the Diamond contract address\\n\";\n    source += \"     * @return The address of the deployed Diamond proxy\\n\";\n    source += \"     */\\n\";\n    source += \"    function getDiamondAddress() internal pure returns (address) {\\n\";\n    source += \"        return DIAMOND_ADDRESS;\\n\";\n    source += \"    }\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get facet implementation address by name\\n\";\n    source += \"     * @param facetName The name of the facet\\n\";\n    source += \"     * @return The address of the facet implementation\\n\";\n    source += \"     */\\n\";\n    source += \"    function getFacetAddress(string memory facetName) internal pure returns (address) {\\n\";\n\n    let firstFacet = true;\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      const condition = firstFacet ? \"if\" : \"else if\";\n      source += `        ${condition} (keccak256(bytes(facetName)) == keccak256(bytes(\"${facetName}\"))) {\\n`;\n      source += `            return ${constantName};\\n`;\n      source += \"        }\\n\";\n      firstFacet = false;\n    }\n    source += \"        return address(0);\\n\";\n    source += \"    }\\n\";\n\n    source += \"}\\n\";\n\n    return source;\n  }\n}\n"]}
+{"version":3,"file":"HelperGenerator.js","sourceRoot":"","sources":["../../src/framework/HelperGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["import { DeployedDiamondData } from \"@diamondslab/diamonds\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { join } from \"path\";\nimport { Logger } from \"../utils/logger\";\n\n/**\n * HelperGenerator - Generates Solidity helper files for testing\n */\nexport class HelperGenerator {\n  constructor(private hre: HardhatRuntimeEnvironment) {}\n\n  /**\n   * Scaffold project with initial test structure\n   */\n  async scaffoldProject(outputDir?: string): Promise<void> {\n    const helpersDir = outputDir || this.hre.diamondsFoundry.helpersDir;\n    const basePath = join(this.hre.config.paths.root, helpersDir);\n\n    Logger.section(\"Scaffolding Forge Test Structure\");\n    \n    // Create directories\n    Logger.step(\"Creating directories...\");\n    mkdirSync(basePath, { recursive: true });\n    mkdirSync(join(basePath, \"../unit\"), { recursive: true });\n    mkdirSync(join(basePath, \"../integration\"), { recursive: true });\n    mkdirSync(join(basePath, \"../fuzz\"), { recursive: true });\n\n    Logger.success(`Test structure created at ${basePath}`);\n  }\n\n  /**\n   * Generate DiamondDeployment.sol from deployment record\n   */\n  async generateDeploymentHelpers(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): Promise<string> {\n    Logger.section(\"Generating Diamond Deployment Helper\");\n\n    const helpersDir = this.hre.diamondsFoundry.helpersDir;\n    const outputPath = join(\n      this.hre.config.paths.root,\n      helpersDir,\n      \"DiamondDeployment.sol\"\n    );\n\n    const content = this.generateLibrarySource(\n      diamondName,\n      networkName,\n      chainId,\n      deploymentData\n    );\n\n    // Ensure directory exists\n    mkdirSync(join(this.hre.config.paths.root, helpersDir), {\n      recursive: true,\n    });\n\n    // Write file\n    writeFileSync(outputPath, content, \"utf8\");\n\n    Logger.success(`Generated: ${outputPath}`);\n    return outputPath;\n  }\n\n  /**\n   * Generate example test files\n   */\n  async generateExampleTests(): Promise<string[]> {\n    const generated: string[] = [];\n    const examples = this.hre.diamondsFoundry.exampleTests;\n\n    if (!this.hre.diamondsFoundry.generateExamples) {\n      Logger.info(\"Example generation disabled in config\");\n      return generated;\n    }\n\n    Logger.section(\"Generating Example Tests\");\n\n    const basePath = join(this.hre.config.paths.root, \"test\", \"foundry\");\n    const templatesPath = join(__dirname, \"../templates\");\n\n    for (const type of examples) {\n      let templateFile = \"\";\n      let outputPath = \"\";\n\n      switch (type) {\n        case \"unit\":\n          templateFile = join(templatesPath, \"ExampleUnitTest.t.sol.template\");\n          outputPath = join(basePath, \"unit\", \"ExampleUnit.t.sol\");\n          break;\n        case \"integration\":\n          templateFile = join(templatesPath, \"ExampleIntegrationTest.t.sol.template\");\n          outputPath = join(basePath, \"integration\", \"ExampleIntegration.t.sol\");\n          break;\n        case \"fuzz\":\n          templateFile = join(templatesPath, \"ExampleFuzzTest.t.sol.template\");\n          outputPath = join(basePath, \"fuzz\", \"ExampleFuzz.t.sol\");\n          break;\n        default:\n          Logger.warn(`Unknown example type: ${type}`);\n          continue;\n      }\n\n      try {\n        // Check if template exists\n        if (!existsSync(templateFile)) {\n          Logger.warn(`Template not found: ${templateFile}`);\n          continue;\n        }\n\n        // Read template content\n        const templateContent = readFileSync(templateFile, \"utf8\");\n\n        // Ensure output directory exists\n        mkdirSync(join(basePath, type), { recursive: true });\n\n        // Check if file already exists\n        if (existsSync(outputPath)) {\n          Logger.info(`Skipping ${type} example (already exists): ${outputPath}`);\n          continue;\n        }\n\n        // Write example test file\n        writeFileSync(outputPath, templateContent, \"utf8\");\n        Logger.success(`Generated ${type} example: ${outputPath}`);\n        generated.push(outputPath);\n      } catch (error: any) {\n        Logger.error(`Failed to generate ${type} example: ${error.message}`);\n      }\n    }\n\n    if (generated.length === 0) {\n      Logger.info(\"No new example tests generated (may already exist)\");\n    }\n\n    return generated;\n  }\n\n  /**\n   * Generate Solidity library source from deployment data\n   * @private\n   */\n  private generateLibrarySource(\n    diamondName: string,\n    networkName: string,\n    chainId: number,\n    deploymentData: DeployedDiamondData\n  ): string {\n    const timestamp = new Date().toISOString();\n    const networkInfo = `${networkName}-${chainId}`;\n    const deploymentFileName = `${diamondName.toLowerCase()}-${networkInfo}.json`;\n    const deploymentFilePath = `diamonds/${diamondName}/deployments/${deploymentFileName}`;\n\n    let source = \"\";\n\n    // SPDX and pragma\n    source += \"// SPDX-License-Identifier: MIT\\n\";\n    source += \"pragma solidity ^0.8.19;\\n\\n\";\n\n    // Header comments\n    source += \"/**\\n\";\n    source += ` * @title DiamondDeployment\\n`;\n    source += ` * @notice Auto-generated deployment data for ${diamondName}\\n`;\n    source += ` * @dev This library provides constants and helper functions for accessing\\n`;\n    source += ` *      deployment data in Forge tests. It is auto-generated from the deployment\\n`;\n    source += ` *      record and should not be edited manually.\\n`;\n    source += ` *\\n`;\n    source += ` * Generated from: ${deploymentFilePath}\\n`;\n    source += ` * Generated at: ${timestamp}\\n`;\n    source += ` *\\n`;\n    source += ` * To regenerate this file:\\n`;\n    source += ` *   npx hardhat diamonds-forge:generate-helpers --diamond ${diamondName}\\n`;\n    source += ` *\\n`;\n    source += ` * ⚠️  DO NOT EDIT MANUALLY - Changes will be overwritten on next generation\\n`;\n    source += \" */\\n\";\n    source += \"library DiamondDeployment {\\n\";\n\n    // Diamond address\n    source += `    /// @notice Address of the deployed ${diamondName} contract\\n`;\n    source += `    /// @dev This is the main Diamond proxy address\\n`;\n    source += `    address constant DIAMOND_ADDRESS = ${deploymentData.DiamondAddress};\\n\\n`;\n\n    // Deployer address\n    source += `    /// @notice Address of the deployer account\\n`;\n    source += `    /// @dev Account that deployed the Diamond\\n`;\n    source += `    address constant DEPLOYER_ADDRESS = ${deploymentData.DeployerAddress};\\n\\n`;\n\n    // Facet addresses\n    source += \"    // ========================================\\n\";\n    source += \"    // Facet Addresses\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    const facets = deploymentData.DeployedFacets ?? {};\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      source += `    /// @notice Address of ${facetName} implementation\\n`;\n      source += `    address constant ${constantName} = ${facetData.address};\\n`;\n    }\n    source += \"\\n\";\n\n    // Helper functions\n    source += \"    // ========================================\\n\";\n    source += \"    // Helper Functions\\n\";\n    source += \"    // ========================================\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get the Diamond contract address\\n\";\n    source += \"     * @return The address of the deployed Diamond proxy\\n\";\n    source += \"     */\\n\";\n    source += \"    function getDiamondAddress() internal pure returns (address) {\\n\";\n    source += \"        return DIAMOND_ADDRESS;\\n\";\n    source += \"    }\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get the deployer address\\n\";\n    source += \"     * @return The address of the deployer account\\n\";\n    source += \"     */\\n\";\n    source += \"    function getDeployerAddress() internal pure returns (address) {\\n\";\n    source += \"        return DEPLOYER_ADDRESS;\\n\";\n    source += \"    }\\n\\n\";\n\n    source += \"    /**\\n\";\n    source += \"     * @notice Get facet implementation address by name\\n\";\n    source += \"     * @param facetName The name of the facet\\n\";\n    source += \"     * @return The address of the facet implementation\\n\";\n    source += \"     */\\n\";\n    source += \"    function getFacetAddress(string memory facetName) internal pure returns (address) {\\n\";\n\n    let firstFacet = true;\n    for (const [facetName, facetData] of Object.entries(facets)) {\n      const constantName = facetName\n        .replace(/Facet$/, \"\")\n        .replace(/([A-Z])/g, \"_$1\")\n        .toUpperCase()\n        .replace(/^_/, \"\") + \"_FACET\";\n\n      const condition = firstFacet ? \"if\" : \"else if\";\n      source += `        ${condition} (keccak256(bytes(facetName)) == keccak256(bytes(\"${facetName}\"))) {\\n`;\n      source += `            return ${constantName};\\n`;\n      source += \"        }\\n\";\n      firstFacet = false;\n    }\n    source += \"        return address(0);\\n\";\n    source += \"    }\\n\";\n\n    source += \"}\\n\";\n\n    return source;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -3,8 +3,5 @@ import "./tasks/generate-helpers";
 import "./tasks/init";
 import "./tasks/test";
 import "./types/hardhat";
-export { DeploymentManager } from "./framework/DeploymentManager";
-export { ForgeFuzzingFramework } from "./framework/ForgeFuzzingFramework";
-export { HelperGenerator } from "./framework/HelperGenerator";
 export * from "./types/config";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AACxB,OAAO,0BAA0B,CAAC;AAClC,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC;AACtB,OAAO,iBAAiB,CAAC;AAmBzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,CAAC;AACxB,OAAO,0BAA0B,CAAC;AAClC,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC;AACtB,OAAO,iBAAiB,CAAC;AAmBzB,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -17,7 +17,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HelperGenerator = exports.ForgeFuzzingFramework = exports.DeploymentManager = void 0;
 const config_1 = require("hardhat/config");
 require("./tasks/deploy");
 require("./tasks/generate-helpers");
@@ -30,13 +29,6 @@ const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const foundry_1 = require("./foundry");
 const validation_1 = require("./utils/validation");
-// Export framework classes for programmatic use
-var DeploymentManager_1 = require("./framework/DeploymentManager");
-Object.defineProperty(exports, "DeploymentManager", { enumerable: true, get: function () { return DeploymentManager_1.DeploymentManager; } });
-var ForgeFuzzingFramework_1 = require("./framework/ForgeFuzzingFramework");
-Object.defineProperty(exports, "ForgeFuzzingFramework", { enumerable: true, get: function () { return ForgeFuzzingFramework_1.ForgeFuzzingFramework; } });
-var HelperGenerator_1 = require("./framework/HelperGenerator");
-Object.defineProperty(exports, "HelperGenerator", { enumerable: true, get: function () { return HelperGenerator_1.HelperGenerator; } });
 // Export types
 __exportStar(require("./types/config"), exports);
 const TASK_INIT_FOUNDRY = "init-foundry";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { extendConfig, extendEnvironment, internalTask, task } from \"hardhat/config\";\nimport \"./tasks/deploy\";\nimport \"./tasks/generate-helpers\";\nimport \"./tasks/init\";\nimport \"./tasks/test\";\nimport \"./types/hardhat\";\n\nimport { existsSync, writeFileSync } from \"fs\";\nimport {\n  TASK_COMPILE_GET_REMAPPINGS,\n  TASK_COMPILE_TRANSFORM_IMPORT_NAME,\n} from \"hardhat/builtin-tasks/task-names\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport path from \"path\";\nimport picocolors from \"picocolors\";\nimport {\n  getForgeConfig,\n  getRemappings,\n  HardhatFoundryError,\n  installDependency,\n} from \"./foundry\";\nimport { validateConfig } from \"./utils/validation\";\n\n// Export framework classes for programmatic use\nexport { DeploymentManager } from \"./framework/DeploymentManager\";\nexport { ForgeFuzzingFramework } from \"./framework/ForgeFuzzingFramework\";\nexport { HelperGenerator } from \"./framework/HelperGenerator\";\n\n// Export types\nexport * from \"./types/config\";\n\nconst TASK_INIT_FOUNDRY = \"init-foundry\";\n\nlet pluginActivated = false;\n\n// Extend config with diamondsFoundry settings\nextendConfig((config, userConfig) => {\n  // Validate and set diamondsFoundry config\n  config.diamondsFoundry = validateConfig(userConfig.diamondsFoundry);\n\n  // Check foundry.toml presence. Don't warn when running foundry initialization task\n  if (!existsSync(path.join(config.paths.root, \"foundry.toml\"))) {\n    if (!process.argv.includes(TASK_INIT_FOUNDRY)) {\n      console.log(\n        picocolors.yellow(\n          `Warning: You are using the diamonds-hardhat-foundry plugin but there isn't a foundry.toml file in your project. Run 'npx hardhat ${TASK_INIT_FOUNDRY}' to create one.`\n        )\n      );\n    }\n    return;\n  }\n\n  // Load foundry config\n  const foundryConfig = getForgeConfig();\n\n  // Ensure required keys exist\n  if (\n    foundryConfig?.src === undefined ||\n    foundryConfig?.cache_path === undefined\n  ) {\n    throw new HardhatFoundryError(\n      \"Couldn't find `src` or `cache_path` config keys after running `forge config --json`\"\n    );\n  }\n\n  // Ensure foundry src path doesn't mismatch user-configured path\n  const userSourcesPath = userConfig.paths?.sources;\n  const foundrySourcesPath = foundryConfig.src;\n\n  if (\n    userSourcesPath !== undefined &&\n    path.resolve(userSourcesPath) !== path.resolve(foundrySourcesPath)\n  ) {\n    throw new HardhatFoundryError(\n      `User-configured sources path (${userSourcesPath}) doesn't match path configured in foundry (${foundrySourcesPath})`\n    );\n  }\n\n  // Set sources path\n  config.paths.sources = path.resolve(config.paths.root, foundrySourcesPath);\n\n  // Change hardhat's cache path if it clashes with foundry's\n  const foundryCachePath = path.resolve(\n    config.paths.root,\n    foundryConfig.cache_path\n  );\n  if (config.paths.cache === foundryCachePath) {\n    config.paths.cache = \"cache_hardhat\";\n  }\n\n  pluginActivated = true;\n});\n\n// Extend environment to add diamondsFoundry config to HRE\nextendEnvironment((hre: HardhatRuntimeEnvironment) => {\n  hre.diamondsFoundry = hre.config.diamondsFoundry;\n});\n\n// This task is in place to detect old hardhat-core versions\ninternalTask(TASK_COMPILE_TRANSFORM_IMPORT_NAME).setAction(\n  async (\n    {\n      importName,\n      deprecationCheck,\n    }: { importName: string; deprecationCheck: boolean },\n    _hre\n  ): Promise<string> => {\n    // When the deprecationCheck param is passed, it means a new enough hardhat-core is being used\n    if (deprecationCheck) {\n      return importName;\n    }\n    throw new HardhatFoundryError(\n      \"This version of diamonds-hardhat-foundry depends on hardhat version >= 2.17.2\"\n    );\n  }\n);\n\ninternalTask(TASK_COMPILE_GET_REMAPPINGS).setAction(\n  async (): Promise<Record<string, string>> => {\n    if (!pluginActivated) {\n      return {};\n    }\n\n    return getRemappings();\n  }\n);\n\ntask(\n  TASK_INIT_FOUNDRY,\n  \"Initialize foundry setup in current hardhat project\",\n  async (_, hre: HardhatRuntimeEnvironment) => {\n    const foundryConfigPath = path.resolve(\n      hre.config.paths.root,\n      \"foundry.toml\"\n    );\n\n    if (existsSync(foundryConfigPath)) {\n      console.warn(\n        picocolors.yellow(`File foundry.toml already exists. Aborting.`)\n      );\n      process.exit(1);\n    }\n\n    console.log(`Creating foundry.toml file...`);\n\n    writeFileSync(\n      foundryConfigPath,\n      [\n        `[profile.default]`,\n        `src = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.sources\n        )}'`,\n        `out = 'out'`,\n        `libs = ['node_modules', 'lib']`,\n        `test = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.tests\n        )}'`,\n        `cache_path  = 'cache_forge'`,\n      ].join(\"\\n\")\n    );\n\n    await installDependency(\"foundry-rs/forge-std\");\n  }\n);\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { extendConfig, extendEnvironment, internalTask, task } from \"hardhat/config\";\nimport \"./tasks/deploy\";\nimport \"./tasks/generate-helpers\";\nimport \"./tasks/init\";\nimport \"./tasks/test\";\nimport \"./types/hardhat\";\n\nimport { existsSync, writeFileSync } from \"fs\";\nimport {\n  TASK_COMPILE_GET_REMAPPINGS,\n  TASK_COMPILE_TRANSFORM_IMPORT_NAME,\n} from \"hardhat/builtin-tasks/task-names\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport path from \"path\";\nimport picocolors from \"picocolors\";\nimport {\n  getForgeConfig,\n  getRemappings,\n  HardhatFoundryError,\n  installDependency,\n} from \"./foundry\";\nimport { validateConfig } from \"./utils/validation\";\n\n// Export types\nexport * from \"./types/config\";\n\nconst TASK_INIT_FOUNDRY = \"init-foundry\";\n\nlet pluginActivated = false;\n\n// Extend config with diamondsFoundry settings\nextendConfig((config, userConfig) => {\n  // Validate and set diamondsFoundry config\n  config.diamondsFoundry = validateConfig(userConfig.diamondsFoundry);\n\n  // Check foundry.toml presence. Don't warn when running foundry initialization task\n  if (!existsSync(path.join(config.paths.root, \"foundry.toml\"))) {\n    if (!process.argv.includes(TASK_INIT_FOUNDRY)) {\n      console.log(\n        picocolors.yellow(\n          `Warning: You are using the diamonds-hardhat-foundry plugin but there isn't a foundry.toml file in your project. Run 'npx hardhat ${TASK_INIT_FOUNDRY}' to create one.`\n        )\n      );\n    }\n    return;\n  }\n\n  // Load foundry config\n  const foundryConfig = getForgeConfig();\n\n  // Ensure required keys exist\n  if (\n    foundryConfig?.src === undefined ||\n    foundryConfig?.cache_path === undefined\n  ) {\n    throw new HardhatFoundryError(\n      \"Couldn't find `src` or `cache_path` config keys after running `forge config --json`\"\n    );\n  }\n\n  // Ensure foundry src path doesn't mismatch user-configured path\n  const userSourcesPath = userConfig.paths?.sources;\n  const foundrySourcesPath = foundryConfig.src;\n\n  if (\n    userSourcesPath !== undefined &&\n    path.resolve(userSourcesPath) !== path.resolve(foundrySourcesPath)\n  ) {\n    throw new HardhatFoundryError(\n      `User-configured sources path (${userSourcesPath}) doesn't match path configured in foundry (${foundrySourcesPath})`\n    );\n  }\n\n  // Set sources path\n  config.paths.sources = path.resolve(config.paths.root, foundrySourcesPath);\n\n  // Change hardhat's cache path if it clashes with foundry's\n  const foundryCachePath = path.resolve(\n    config.paths.root,\n    foundryConfig.cache_path\n  );\n  if (config.paths.cache === foundryCachePath) {\n    config.paths.cache = \"cache_hardhat\";\n  }\n\n  pluginActivated = true;\n});\n\n// Extend environment to add diamondsFoundry config to HRE\nextendEnvironment((hre: HardhatRuntimeEnvironment) => {\n  hre.diamondsFoundry = hre.config.diamondsFoundry;\n});\n\n// This task is in place to detect old hardhat-core versions\ninternalTask(TASK_COMPILE_TRANSFORM_IMPORT_NAME).setAction(\n  async (\n    {\n      importName,\n      deprecationCheck,\n    }: { importName: string; deprecationCheck: boolean },\n    _hre\n  ): Promise<string> => {\n    // When the deprecationCheck param is passed, it means a new enough hardhat-core is being used\n    if (deprecationCheck) {\n      return importName;\n    }\n    throw new HardhatFoundryError(\n      \"This version of diamonds-hardhat-foundry depends on hardhat version >= 2.17.2\"\n    );\n  }\n);\n\ninternalTask(TASK_COMPILE_GET_REMAPPINGS).setAction(\n  async (): Promise<Record<string, string>> => {\n    if (!pluginActivated) {\n      return {};\n    }\n\n    return getRemappings();\n  }\n);\n\ntask(\n  TASK_INIT_FOUNDRY,\n  \"Initialize foundry setup in current hardhat project\",\n  async (_, hre: HardhatRuntimeEnvironment) => {\n    const foundryConfigPath = path.resolve(\n      hre.config.paths.root,\n      \"foundry.toml\"\n    );\n\n    if (existsSync(foundryConfigPath)) {\n      console.warn(\n        picocolors.yellow(`File foundry.toml already exists. Aborting.`)\n      );\n      process.exit(1);\n    }\n\n    console.log(`Creating foundry.toml file...`);\n\n    writeFileSync(\n      foundryConfigPath,\n      [\n        `[profile.default]`,\n        `src = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.sources\n        )}'`,\n        `out = 'out'`,\n        `libs = ['node_modules', 'lib']`,\n        `test = '${path.relative(\n          hre.config.paths.root,\n          hre.config.paths.tests\n        )}'`,\n        `cache_path  = 'cache_forge'`,\n      ].join(\"\\n\")\n    );\n\n    await installDependency(\"foundry-rs/forge-std\");\n  }\n);\n"]}

package/dist/tasks/deploy.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("hardhat/config");
-const DeploymentManager_1 = require("../framework/DeploymentManager");
 const logger_1 = require("../utils/logger");
 const validation_1 = require("../utils/validation");
 /**
@@ -46,7 +45,9 @@ const validation_1 = require("../utils/validation");
     }
     // Step 2: Deploy or reuse Diamond
     logger_1.Logger.step("Deploying Diamond contract...");
-    const deploymentManager = new DeploymentManager_1.DeploymentManager(hre);
+    // Lazy-load DeploymentManager to avoid circular dependency
+    const { DeploymentManager } = await import("../framework/DeploymentManager.js");
+    const deploymentManager = new DeploymentManager(hre);
     try {
         let diamond;
         if (reuse) {

package/dist/tasks/deploy.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tasks/deploy.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { DeploymentManager } from \"../framework/DeploymentManager\";\nimport { Logger } from \"../utils/logger\";\nimport { validateFoundryInstallation } from \"../utils/validation\";\n\n/**\n * Task: diamonds-forge:deploy\n * \n * Deploys a Diamond contract for Forge testing.\n * - Validates Foundry installation\n * - Deploys Diamond using LocalDiamondDeployer\n * - Saves deployment record\n * - Optionally reuses existing deployment\n * \n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:deploy\", \"Deploy Diamond contract for Forge testing\")\n  .addOptionalParam(\n    \"diamondName\",\n    \"Name of the Diamond to deploy\",\n    \"ExampleDiamond\",\n    types.string\n  )\n  .addFlag(\"reuse\", \"Reuse existing deployment if available\")\n  .addFlag(\"force\", \"Force redeployment even if deployment exists\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Deploying Diamond for Forge Testing\");\n\n    // Use Hardhat's built-in network name from HRE\n    const networkName = hre.network.name;\n    const diamondName = taskArgs.diamondName;\n    const reuse = taskArgs.reuse;\n    const force = taskArgs.force;\n\n    // Validate flags\n    if (reuse && force) {\n      Logger.error(\"Cannot use both --reuse and --force flags\");\n      throw new Error(\"Conflicting flags: --reuse and --force\");\n    }\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n    Logger.info(`Mode: ${force ? \"force deploy\" : reuse ? \"reuse if exists\" : \"deploy new\"}`);\n\n    // Step 1: Validate Foundry (optional for deployment, but recommended)\n    Logger.step(\"Checking Foundry installation...\");\n    const foundryInstalled = validateFoundryInstallation();\n    \n    if (!foundryInstalled) {\n      Logger.warn(\"Foundry is not installed\");\n      Logger.warn(\"You'll need it to run tests later\");\n    } else {\n      Logger.success(\"Foundry is installed\");\n    }\n\n    // Step 2: Deploy or reuse Diamond\n    Logger.step(\"Deploying Diamond contract...\");\n    const deploymentManager = new DeploymentManager(hre);\n\n    try {\n      let diamond;\n      \n      if (reuse) {\n        // Try to reuse, deploy if not exists\n        diamond = await deploymentManager.ensureDeployment(\n          diamondName,\n          networkName,\n          false\n        );\n      } else {\n        // Deploy (force if flag is set)\n        diamond = await deploymentManager.deploy(\n          diamondName,\n          networkName,\n          force\n        );\n      }\n\n      // Step 3: Display deployment info\n      const deploymentData = diamond.getDeployedDiamondData();\n      \n      Logger.section(\"Deployment Summary\");\n      Logger.success(`Diamond Address: ${deploymentData.DiamondAddress}`);\n      Logger.info(`Deployer Address: ${deploymentData.DeployerAddress}`);\n      \n      const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;\n      Logger.info(`Facets Deployed: ${facetCount}`);\n      \n      if (facetCount > 0) {\n        Logger.info(\"\\nDeployed Facets:\");\n        for (const [name, facet] of Object.entries(deploymentData.DeployedFacets || {})) {\n          Logger.info(`  - ${name}: ${facet.address}`);\n        }\n      }\n\n      Logger.section(\"Next Steps\");\n      Logger.info(\"Generate helpers: npx hardhat diamonds-forge:generate-helpers\");\n      Logger.info(\"Run tests: npx hardhat diamonds-forge:test\");\n\n    } catch (error: any) {\n      Logger.error(`Deployment failed: ${error.message}`);\n      throw error;\n    }\n  });\n\n\n"]}
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tasks/deploy.ts"],"names":[],"mappings":"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","sourcesContent":["import { task, types } from \"hardhat/config\";\nimport { HardhatRuntimeEnvironment } from \"hardhat/types\";\nimport { Logger } from \"../utils/logger\";\nimport { validateFoundryInstallation } from \"../utils/validation\";\n\n/**\n * Task: diamonds-forge:deploy\n * \n * Deploys a Diamond contract for Forge testing.\n * - Validates Foundry installation\n * - Deploys Diamond using LocalDiamondDeployer\n * - Saves deployment record\n * - Optionally reuses existing deployment\n * \n * Use Hardhat's built-in --network flag to specify the network\n */\ntask(\"diamonds-forge:deploy\", \"Deploy Diamond contract for Forge testing\")\n  .addOptionalParam(\n    \"diamondName\",\n    \"Name of the Diamond to deploy\",\n    \"ExampleDiamond\",\n    types.string\n  )\n  .addFlag(\"reuse\", \"Reuse existing deployment if available\")\n  .addFlag(\"force\", \"Force redeployment even if deployment exists\")\n  .setAction(async (taskArgs, hre: HardhatRuntimeEnvironment) => {\n    Logger.section(\"Deploying Diamond for Forge Testing\");\n\n    // Use Hardhat's built-in network name from HRE\n    const networkName = hre.network.name;\n    const diamondName = taskArgs.diamondName;\n    const reuse = taskArgs.reuse;\n    const force = taskArgs.force;\n\n    // Validate flags\n    if (reuse && force) {\n      Logger.error(\"Cannot use both --reuse and --force flags\");\n      throw new Error(\"Conflicting flags: --reuse and --force\");\n    }\n\n    Logger.info(`Diamond: ${diamondName}`);\n    Logger.info(`Network: ${networkName}`);\n    Logger.info(`Mode: ${force ? \"force deploy\" : reuse ? \"reuse if exists\" : \"deploy new\"}`);\n\n    // Step 1: Validate Foundry (optional for deployment, but recommended)\n    Logger.step(\"Checking Foundry installation...\");\n    const foundryInstalled = validateFoundryInstallation();\n    \n    if (!foundryInstalled) {\n      Logger.warn(\"Foundry is not installed\");\n      Logger.warn(\"You'll need it to run tests later\");\n    } else {\n      Logger.success(\"Foundry is installed\");\n    }\n\n    // Step 2: Deploy or reuse Diamond\n    Logger.step(\"Deploying Diamond contract...\");\n    \n    // Lazy-load DeploymentManager to avoid circular dependency\n    const { DeploymentManager } = await import(\"../framework/DeploymentManager.js\");\n    const deploymentManager = new DeploymentManager(hre);\n\n    try {\n      let diamond;\n      \n      if (reuse) {\n        // Try to reuse, deploy if not exists\n        diamond = await deploymentManager.ensureDeployment(\n          diamondName,\n          networkName,\n          false\n        );\n      } else {\n        // Deploy (force if flag is set)\n        diamond = await deploymentManager.deploy(\n          diamondName,\n          networkName,\n          force\n        );\n      }\n\n      // Step 3: Display deployment info\n      const deploymentData = diamond.getDeployedDiamondData();\n      \n      Logger.section(\"Deployment Summary\");\n      Logger.success(`Diamond Address: ${deploymentData.DiamondAddress}`);\n      Logger.info(`Deployer Address: ${deploymentData.DeployerAddress}`);\n      \n      const facetCount = Object.keys(deploymentData.DeployedFacets || {}).length;\n      Logger.info(`Facets Deployed: ${facetCount}`);\n      \n      if (facetCount > 0) {\n        Logger.info(\"\\nDeployed Facets:\");\n        for (const [name, facet] of Object.entries(deploymentData.DeployedFacets || {})) {\n          Logger.info(`  - ${name}: ${facet.address}`);\n        }\n      }\n\n      Logger.section(\"Next Steps\");\n      Logger.info(\"Generate helpers: npx hardhat diamonds-forge:generate-helpers\");\n      Logger.info(\"Run tests: npx hardhat diamonds-forge:test\");\n\n    } catch (error: any) {\n      Logger.error(`Deployment failed: ${error.message}`);\n      throw error;\n    }\n  });\n\n\n"]}