hardhat-deploy 2.0.0-next.67 → 2.0.0-next.68

package/README.md

@@ -110,3 +110,11 @@ Get started quickly with the [template-ethereum-contracts](https://github.com/wi
 ## License
 
 MIT
+
+## Sponsor
+
+If you find this project useful, please consider sponsoring it! Your support helps me continue developing and maintaining this tool.
+
+<a href="https://github.com/sponsors/wighawag">
+  <img src="https://img.shields.io/badge/Sponsor-GitHub-181717?style=for-the-badge&logo=github&logoColor=white" alt="Sponsor on GitHub" />
+</a>

package/dist/postinstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":""}

package/dist/postinstall.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+// Attempt to detect if user is in a v1 environment
+// This script should be lightweight and fail gracefully
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const MIGRATION_URL = 'https://rocketh.dev/hardhat-deploy/documentation/how-to/migration-from-v1';
+const V1_INSTALL_CMD = 'npm install hardhat-deploy@1';
+const MARKER_FILE = '.hardhat-deploy-v2-notice';
+async function checkEnvironment() {
+    const projectRoot = process.cwd();
+    let v1Detected = false;
+    let reasons = [];
+    // Check for hardhat version in node_modules
+    try {
+        const require = createRequire(import.meta.url);
+        const hardhatPkgPath = require.resolve('hardhat/package.json', { paths: [projectRoot] });
+        const hardhatPkg = JSON.parse(readFileSync(hardhatPkgPath, 'utf-8'));
+        const hardhatVersion = hardhatPkg.version;
+        if (hardhatVersion.startsWith('2.')) {
+            v1Detected = true;
+            reasons.push(`hardhat ${hardhatVersion} detected (v2 requires hardhat 3.x)`);
+        }
+    }
+    catch (e) {
+        // Hardhat not installed yet - that's fine
+    }
+    // Check for v1-style config patterns
+    try {
+        const configFiles = ['hardhat.config.js', 'hardhat.config.ts'];
+        for (const configFile of configFiles) {
+            const configPath = join(projectRoot, configFile);
+            if (existsSync(configPath)) {
+                const content = readFileSync(configPath, 'utf-8');
+                if (content.includes('namedAccounts')) {
+                    v1Detected = true;
+                    reasons.push(`'namedAccounts' found in ${configFile}`);
+                }
+                if (content.includes("require('hardhat-deploy')") || content.includes('require("hardhat-deploy")')) {
+                    v1Detected = true;
+                    reasons.push(`require('hardhat-deploy') found in ${configFile}`);
+                }
+                if (content.includes('module.exports')) {
+                    v1Detected = true;
+                    reasons.push(`CommonJS 'module.exports' found in ${configFile}`);
+                }
+            }
+        }
+    }
+    catch (e) {
+        // Config check failed - continue silently
+    }
+    if (v1Detected) {
+        printV1Warning(reasons);
+        createMarkerFile(projectRoot, reasons);
+    }
+    else {
+        printWelcome();
+    }
+}
+function createMarkerFile(projectRoot, reasons) {
+    const markerPath = join(projectRoot, MARKER_FILE);
+    const content = `HARDHAT-DEPLOY V2 - V1 PATTERNS DETECTED
+
+This file was created because hardhat-deploy v2 detected v1 patterns in your project.
+You can delete this file after reading.
+
+Detected issues:
+${reasons.map((r) => `  - ${r}`).join('\n')}
+
+To resolve this, either:
+
+1. Install hardhat-deploy v1 instead:
+   npm uninstall hardhat-deploy
+   ${V1_INSTALL_CMD}
+
+2. Migrate your project to v2:
+   ${MIGRATION_URL}
+
+For more information, see the migration guide.
+`;
+    try {
+        writeFileSync(markerPath, content, 'utf-8');
+    }
+    catch (e) {
+        // Failed to write marker file - continue anyway
+    }
+}
+function printV1Warning(reasons) {
+    const reasonsList = reasons.map((r) => `  • ${r}`).join('\n');
+    console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║  ⚠️  HARDHAT-DEPLOY V2 - V1 PATTERNS DETECTED                                ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+Your project appears to be using hardhat-deploy v1 patterns:
+
+${reasonsList}
+
+hardhat-deploy v2 has MAJOR breaking changes and requires hardhat 3.x.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+OPTION 1: Install v1 instead (recommended for existing v1 projects)
+
+  npm uninstall hardhat-deploy
+  ${V1_INSTALL_CMD}
+
+OPTION 2: Migrate to v2
+
+  See: ${MIGRATION_URL}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+A marker file '${MARKER_FILE}' has been created in your project root.
+`);
+}
+function printWelcome() {
+    console.log(`
+✓ hardhat-deploy v2 installed successfully!
+  Documentation: https://rocketh.dev/hardhat-deploy/
+`);
+}
+checkEnvironment().catch(() => { });
+//# sourceMappingURL=postinstall.js.map

package/dist/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"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"}

package/dist/v1-detection.d.ts

@@ -0,0 +1,12 @@
+export declare const MIGRATION_URL = "https://rocketh.dev/hardhat-deploy/migration-from-v1";
+export declare const V1_INSTALL_CMD = "npm install hardhat-deploy@1";
+export interface V1DetectionResult {
+    isV1Environment: boolean;
+    reasons: string[];
+}
+export declare function detectV1Patterns(projectRoot?: string): V1DetectionResult;
+export declare class V1PatternError extends Error {
+    constructor(reasons: string[]);
+}
+export declare function throwV1MigrationError(reasons: string[]): never;
+//# sourceMappingURL=v1-detection.d.ts.map

package/dist/v1-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-detection.d.ts","sourceRoot":"","sources":["../src/v1-detection.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,yDAAyD,CAAC;AACpF,eAAO,MAAM,cAAc,iCAAiC,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,GAAE,MAAsB,GAAG,iBAAiB,CAevF;AA4FD,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE;CA8B9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAE9D"}

package/dist/v1-detection.js

@@ -0,0 +1,118 @@
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+export const MIGRATION_URL = 'https://rocketh.dev/hardhat-deploy/migration-from-v1';
+export const V1_INSTALL_CMD = 'npm install hardhat-deploy@1';
+export function detectV1Patterns(projectRoot = process.cwd()) {
+    const reasons = [];
+    // Check hardhat.config for v1 patterns
+    const configPatterns = checkConfigPatterns(projectRoot);
+    reasons.push(...configPatterns);
+    // Check deploy scripts for v1 patterns
+    const deployPatterns = checkDeployScripts(projectRoot);
+    reasons.push(...deployPatterns);
+    return {
+        isV1Environment: reasons.length > 0,
+        reasons,
+    };
+}
+function checkConfigPatterns(projectRoot) {
+    const reasons = [];
+    const configFiles = ['hardhat.config.js', 'hardhat.config.ts'];
+    for (const configFile of configFiles) {
+        const configPath = join(projectRoot, configFile);
+        if (existsSync(configPath)) {
+            try {
+                const content = readFileSync(configPath, 'utf-8');
+                if (content.includes('namedAccounts')) {
+                    reasons.push(`Found 'namedAccounts' in ${configFile} - this is a v1 pattern. In v2, use rocketh/config.ts`);
+                }
+                if (content.includes("require('hardhat-deploy')") || content.includes('require("hardhat-deploy")')) {
+                    reasons.push(`Found require('hardhat-deploy') in ${configFile} - v2 uses ESM: import HardhatDeploy from 'hardhat-deploy'`);
+                }
+                if (content.includes('module.exports')) {
+                    reasons.push(`Found 'module.exports' in ${configFile} - v2 uses ESM: export default defineConfig({...})`);
+                }
+                // Check for old solidity config (non-profile based)
+                if (content.match(/solidity:\s*['"][0-9]/) || content.match(/solidity:\s*\{\s*version:/)) {
+                    reasons.push(`Found old-style solidity config in ${configFile} - v2 uses profiles: solidity: { profiles: { default: { version: '...' } } }`);
+                }
+            }
+            catch (e) {
+                // Failed to read config - continue
+            }
+        }
+    }
+    return reasons;
+}
+function checkDeployScripts(projectRoot) {
+    const reasons = [];
+    const deployDir = join(projectRoot, 'deploy');
+    if (!existsSync(deployDir)) {
+        return reasons;
+    }
+    try {
+        const files = readdirSync(deployDir);
+        for (const file of files) {
+            if (file.endsWith('.js') || file.endsWith('.ts')) {
+                const filePath = join(deployDir, file);
+                try {
+                    const content = readFileSync(filePath, 'utf-8');
+                    if (content.includes('module.exports') && content.includes('getNamedAccounts')) {
+                        reasons.push(`Found v1-style deploy script: deploy/${file} - v2 uses: export default deployScript(async ({deploy, namedAccounts}) => {...})`);
+                        break; // One example is enough
+                    }
+                    if (content.includes('deployments.deploy')) {
+                        reasons.push(`Found 'deployments.deploy()' in deploy/${file} - v2 uses 'deploy()' directly with artifact parameter`);
+                        break;
+                    }
+                    if (content.includes('from:') && !content.includes('account:')) {
+                        reasons.push(`Found 'from:' parameter in deploy/${file} - v2 uses 'account:' instead`);
+                        break;
+                    }
+                }
+                catch (e) {
+                    // Failed to read file - continue
+                }
+            }
+        }
+    }
+    catch (e) {
+        // Deploy folder scan failed - continue silently
+    }
+    return reasons;
+}
+export class V1PatternError extends Error {
+    constructor(reasons) {
+        const reasonsList = reasons.map((r) => `  • ${r}`).join('\n');
+        super(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  HARDHAT-DEPLOY V2 - V1 PATTERNS DETECTED                                    ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+Your project uses hardhat-deploy v1 patterns that are incompatible with v2:
+
+${reasonsList}
+
+hardhat-deploy v2 has MAJOR breaking changes and requires hardhat 3.x with a
+different configuration structure.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+OPTION 1: Install v1 instead (recommended for existing v1 projects)
+
+  npm uninstall hardhat-deploy
+  ${V1_INSTALL_CMD}
+
+OPTION 2: Migrate your project to v2
+
+  Migration guide: ${MIGRATION_URL}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+        this.name = 'V1PatternError';
+    }
+}
+export function throwV1MigrationError(reasons) {
+    throw new V1PatternError(reasons);
+}
+//# sourceMappingURL=v1-detection.js.map

package/dist/v1-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-detection.js","sourceRoot":"","sources":["../src/v1-detection.ts"],"names":[],"mappings":"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"}

package/dist/v1-entry.cjs

@@ -0,0 +1,92 @@
+// This file serves as a CommonJS entry point for hardhat v2
+// It detects v1 users and shows them a migration message
+
+const MIGRATION_URL = 'https://rocketh.dev/hardhat-deploy/migration-from-v1';
+const V1_INSTALL_CMD = 'npm install hardhat-deploy@1';
+
+function getHardhatVersion() {
+	try {
+		const {execSync} = require('child_process');
+		// Run hardhat --version to get the version
+		const output = execSync('hardhat --version', {encoding: 'utf-8', stdio: 'pipe'});
+		return output.trim();
+	} catch (e) {
+		console.error(e);
+		return 'unknown';
+	}
+}
+
+function detectV1Patterns() {
+	const fs = require('fs');
+	const path = require('path');
+	const reasons = [];
+
+	// Check hardhat.config for v1 patterns
+	const configFiles = ['hardhat.config.js', 'hardhat.config.cjs', 'hardhat.config.ts'];
+
+	for (const configFile of configFiles) {
+		const configPath = path.join(process.cwd(), configFile);
+		if (fs.existsSync(configPath)) {
+			try {
+				const content = fs.readFileSync(configPath, 'utf-8');
+
+				if (content.includes('namedAccounts')) {
+					reasons.push(`Found 'namedAccounts' in ${configFile} - this is a v1 pattern`);
+				}
+
+				if (content.includes("require('hardhat-deploy')") || content.includes('require("hardhat-deploy")')) {
+					reasons.push(
+						`Found require('hardhat-deploy') in ${configFile} - v2 uses ESM: import HardhatDeploy from 'hardhat-deploy'`,
+					);
+				}
+
+				if (content.includes('module.exports')) {
+					reasons.push(`Found 'module.exports' in ${configFile} - v2 uses ESM: export default defineConfig({...})`);
+				}
+			} catch (e) {
+				// Failed to read config - continue
+			}
+		}
+	}
+
+	return reasons;
+}
+
+function throwV1Error() {
+	const hardhatVersion = getHardhatVersion();
+	const reasons = detectV1Patterns();
+
+	let reasonsList = '';
+	if (reasons.length > 0) {
+		reasonsList = '\nYour project uses hardhat-deploy v1 patterns:\n\n' + reasons.map((r) => `  • ${r}`).join('\n');
+	}
+
+	throw new Error(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  HARDHAT-DEPLOY V2 - INCOMPATIBLE WITH HARDHAT V2                            ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+hardhat-deploy v2 requires hardhat 3.x, but you are using hardhat ${hardhatVersion}.${reasonsList}
+
+hardhat-deploy v2 has MAJOR breaking changes and uses ESM modules.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+OPTION 1: Install hardhat-deploy v1 (recommended for hardhat v2 projects)
+
+  npm uninstall hardhat-deploy
+  ${V1_INSTALL_CMD}
+
+OPTION 2: Upgrade to hardhat 3.x and hardhat-deploy v2
+
+  Migration guide: ${MIGRATION_URL}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+}
+
+// Throw error immediately when loaded by hardhat v2
+throwV1Error();
+
+// Export a dummy function to satisfy hardhat's plugin loading
+module.exports = function () {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hardhat-deploy",
-  "version": "2.0.0-next.67",
+  "version": "2.0.0-next.68",
   "description": "Hardhat plugin for replicable smart contract deployments and easy testing across multiple EVM chains, with support for proxies, diamonds, named accounts, and deployment fixtures",
   "keywords": [
     "hardhat",
@@ -32,7 +32,8 @@
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
-      }
+      },
+      "require": "./dist/v1-entry.cjs"
     },
     "./helpers": {
       "import": {
@@ -78,7 +79,8 @@
     "zod": "^4.3.6"
   },
   "scripts": {
-    "build": "tsc --project tsconfig.json",
-    "dev": "as-soon -w src pnpm build"
+    "build": "tsc --project tsconfig.json && cp src/v1-entry.cjs dist/",
+    "dev": "as-soon -w src pnpm build",
+    "postinstall": "node ./dist/postinstall.js"
   }
 }

package/src/postinstall.ts

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+
+// Attempt to detect if user is in a v1 environment
+// This script should be lightweight and fail gracefully
+
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const MIGRATION_URL = 'https://rocketh.dev/hardhat-deploy/documentation/how-to/migration-from-v1';
+const V1_INSTALL_CMD = 'npm install hardhat-deploy@1';
+const MARKER_FILE = '.hardhat-deploy-v2-notice';
+
+async function checkEnvironment() {
+  const projectRoot = process.cwd();
+  let v1Detected = false;
+  let reasons: string[] = [];
+
+  // Check for hardhat version in node_modules
+  try {
+    const require = createRequire(import.meta.url);
+    const hardhatPkgPath = require.resolve('hardhat/package.json', { paths: [projectRoot] });
+    const hardhatPkg = JSON.parse(readFileSync(hardhatPkgPath, 'utf-8'));
+    const hardhatVersion = hardhatPkg.version;
+
+    if (hardhatVersion.startsWith('2.')) {
+      v1Detected = true;
+      reasons.push(`hardhat ${hardhatVersion} detected (v2 requires hardhat 3.x)`);
+    }
+  } catch (e) {
+    // Hardhat not installed yet - that's fine
+  }
+
+  // Check for v1-style config patterns
+  try {
+    const configFiles = ['hardhat.config.js', 'hardhat.config.ts'];
+
+    for (const configFile of configFiles) {
+      const configPath = join(projectRoot, configFile);
+      if (existsSync(configPath)) {
+        const content = readFileSync(configPath, 'utf-8');
+
+        if (content.includes('namedAccounts')) {
+          v1Detected = true;
+          reasons.push(`'namedAccounts' found in ${configFile}`);
+        }
+
+        if (content.includes("require('hardhat-deploy')") || content.includes('require("hardhat-deploy")')) {
+          v1Detected = true;
+          reasons.push(`require('hardhat-deploy') found in ${configFile}`);
+        }
+
+        if (content.includes('module.exports')) {
+          v1Detected = true;
+          reasons.push(`CommonJS 'module.exports' found in ${configFile}`);
+        }
+      }
+    }
+  } catch (e) {
+    // Config check failed - continue silently
+  }
+
+  if (v1Detected) {
+    printV1Warning(reasons);
+    createMarkerFile(projectRoot, reasons);
+  } else {
+    printWelcome();
+  }
+}
+
+function createMarkerFile(projectRoot: string, reasons: string[]) {
+  const markerPath = join(projectRoot, MARKER_FILE);
+  const content = `HARDHAT-DEPLOY V2 - V1 PATTERNS DETECTED
+
+This file was created because hardhat-deploy v2 detected v1 patterns in your project.
+You can delete this file after reading.
+
+Detected issues:
+${reasons.map((r) => `  - ${r}`).join('\n')}
+
+To resolve this, either:
+
+1. Install hardhat-deploy v1 instead:
+   npm uninstall hardhat-deploy
+   ${V1_INSTALL_CMD}
+
+2. Migrate your project to v2:
+   ${MIGRATION_URL}
+
+For more information, see the migration guide.
+`;
+
+  try {
+    writeFileSync(markerPath, content, 'utf-8');
+  } catch (e) {
+    // Failed to write marker file - continue anyway
+  }
+}
+
+function printV1Warning(reasons: string[]) {
+  const reasonsList = reasons.map((r) => `  • ${r}`).join('\n');
+
+  console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                                                                              ║
+║  ⚠️  HARDHAT-DEPLOY V2 - V1 PATTERNS DETECTED                                ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+Your project appears to be using hardhat-deploy v1 patterns:
+
+${reasonsList}
+
+hardhat-deploy v2 has MAJOR breaking changes and requires hardhat 3.x.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+OPTION 1: Install v1 instead (recommended for existing v1 projects)
+
+  npm uninstall hardhat-deploy
+  ${V1_INSTALL_CMD}
+
+OPTION 2: Migrate to v2
+
+  See: ${MIGRATION_URL}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+A marker file '${MARKER_FILE}' has been created in your project root.
+`);
+}
+
+function printWelcome() {
+  console.log(`
+✓ hardhat-deploy v2 installed successfully!
+  Documentation: https://rocketh.dev/hardhat-deploy/
+`);
+}
+
+checkEnvironment().catch(() => {});

package/src/v1-entry.cjs

@@ -0,0 +1,92 @@
+// This file serves as a CommonJS entry point for hardhat v2
+// It detects v1 users and shows them a migration message
+
+const MIGRATION_URL = 'https://rocketh.dev/hardhat-deploy/migration-from-v1';
+const V1_INSTALL_CMD = 'npm install hardhat-deploy@1';
+
+function getHardhatVersion() {
+	try {
+		const {execSync} = require('child_process');
+		// Run hardhat --version to get the version
+		const output = execSync('hardhat --version', {encoding: 'utf-8', stdio: 'pipe'});
+		return output.trim();
+	} catch (e) {
+		console.error(e);
+		return 'unknown';
+	}
+}
+
+function detectV1Patterns() {
+	const fs = require('fs');
+	const path = require('path');
+	const reasons = [];
+
+	// Check hardhat.config for v1 patterns
+	const configFiles = ['hardhat.config.js', 'hardhat.config.cjs', 'hardhat.config.ts'];
+
+	for (const configFile of configFiles) {
+		const configPath = path.join(process.cwd(), configFile);
+		if (fs.existsSync(configPath)) {
+			try {
+				const content = fs.readFileSync(configPath, 'utf-8');
+
+				if (content.includes('namedAccounts')) {
+					reasons.push(`Found 'namedAccounts' in ${configFile} - this is a v1 pattern`);
+				}
+
+				if (content.includes("require('hardhat-deploy')") || content.includes('require("hardhat-deploy")')) {
+					reasons.push(
+						`Found require('hardhat-deploy') in ${configFile} - v2 uses ESM: import HardhatDeploy from 'hardhat-deploy'`,
+					);
+				}
+
+				if (content.includes('module.exports')) {
+					reasons.push(`Found 'module.exports' in ${configFile} - v2 uses ESM: export default defineConfig({...})`);
+				}
+			} catch (e) {
+				// Failed to read config - continue
+			}
+		}
+	}
+
+	return reasons;
+}
+
+function throwV1Error() {
+	const hardhatVersion = getHardhatVersion();
+	const reasons = detectV1Patterns();
+
+	let reasonsList = '';
+	if (reasons.length > 0) {
+		reasonsList = '\nYour project uses hardhat-deploy v1 patterns:\n\n' + reasons.map((r) => `  • ${r}`).join('\n');
+	}
+
+	throw new Error(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  HARDHAT-DEPLOY V2 - INCOMPATIBLE WITH HARDHAT V2                            ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+hardhat-deploy v2 requires hardhat 3.x, but you are using hardhat ${hardhatVersion}.${reasonsList}
+
+hardhat-deploy v2 has MAJOR breaking changes and uses ESM modules.
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+OPTION 1: Install hardhat-deploy v1 (recommended for hardhat v2 projects)
+
+  npm uninstall hardhat-deploy
+  ${V1_INSTALL_CMD}
+
+OPTION 2: Upgrade to hardhat 3.x and hardhat-deploy v2
+
+  Migration guide: ${MIGRATION_URL}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+}
+
+// Throw error immediately when loaded by hardhat v2
+throwV1Error();
+
+// Export a dummy function to satisfy hardhat's plugin loading
+module.exports = function () {};