hardhat-external-artifacts 0.0.1

package/dist/artifacts/loader.js

@@ -0,0 +1,113 @@
+import { readJsonFile, getAllFilesMatching, } from '@nomicfoundation/hardhat-utils/fs';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+export class ArtifactLoader {
+    #config;
+    #projectRoot;
+    constructor(config, projectRoot) {
+        this.#config = config;
+        this.#projectRoot = projectRoot;
+    }
+    async loadAll() {
+        const artifacts = [];
+        // Load from paths
+        if (this.#config.paths) {
+            for (const pathOrGlob of this.#config.paths) {
+                const absolutePath = path.resolve(this.#projectRoot, pathOrGlob);
+                artifacts.push(...(await this.#loadFromPath(absolutePath)));
+            }
+        }
+        // Load from resolver function
+        if (this.#config.resolver) {
+            const resolvedArtifacts = await this.#config.resolver();
+            artifacts.push(...resolvedArtifacts);
+        }
+        return artifacts;
+    }
+    async #loadFromPath(absolutePath) {
+        let stat;
+        try {
+            stat = await fs.stat(absolutePath);
+        }
+        catch {
+            // Path doesn't exist, return empty array
+            if (this.#config.warnOnInvalidArtifacts !== false) {
+                console.warn(`[hardhat-external-artifacts] Path not found: ${absolutePath}`);
+            }
+            return [];
+        }
+        if (stat.isFile()) {
+            try {
+                return [await this.#loadArtifactFile(absolutePath)];
+            }
+            catch (error) {
+                if (this.#config.warnOnInvalidArtifacts !== false) {
+                    console.warn(`[hardhat-external-artifacts] Failed to load artifact: ${absolutePath}`, error);
+                }
+                return [];
+            }
+        }
+        if (stat.isDirectory()) {
+            // Support both .json and .ts artifact files
+            const files = await getAllFilesMatching(absolutePath, (p) => p.endsWith('.json'));
+            const loadedArtifacts = [];
+            for (const file of files) {
+                try {
+                    loadedArtifacts.push(await this.#loadArtifactFile(file));
+                }
+                catch (error) {
+                    if (this.#config.warnOnInvalidArtifacts !== false) {
+                        console.warn(`[hardhat-external-artifacts] Failed to load artifact: ${file}`, error);
+                    }
+                }
+            }
+            return loadedArtifacts;
+        }
+        return [];
+    }
+    async #loadArtifactFile(filePath) {
+        const content = await readJsonFile(filePath);
+        return this.#normalizeArtifact(content, filePath);
+    }
+    #normalizeArtifact(raw, source) {
+        // Validate required fields - only ABI is truly required
+        if (!raw.abi || !Array.isArray(raw.abi)) {
+            throw new Error(`Artifact from ${source} is missing required field 'abi' or it's not an array`);
+        }
+        // Infer contractName from filename if not provided
+        // e.g., "/path/to/EIP173Proxy.json" -> "EIP173Proxy"
+        let contractName = raw.contractName;
+        if (!contractName || typeof contractName !== 'string') {
+            const filename = path.basename(source, '.json');
+            contractName = filename;
+        }
+        // Infer sourceName from filename if not provided
+        // e.g., "EIP173Proxy" -> "external/EIP173Proxy.sol"
+        let sourceName = raw.sourceName;
+        if (!sourceName || typeof sourceName !== 'string') {
+            sourceName = `external/${contractName}.sol`;
+        }
+        // Base artifact fields - required
+        const artifact = {
+            contractName,
+            sourceName,
+            abi: raw.abi,
+            bytecode: raw.bytecode ?? '0x',
+            deployedBytecode: raw.deployedBytecode ?? '0x',
+            linkReferences: raw.linkReferences ?? {},
+            deployedLinkReferences: raw.deployedLinkReferences ?? {},
+        };
+        // Check if this is a "rich" artifact with embedded solcInput
+        if (raw.solcInput) {
+            // Rich artifact - has full compilation data
+            artifact.solcInput = raw.solcInput;
+            artifact.metadata = raw.metadata;
+            artifact.evm = raw.evm;
+            artifact.devdoc = raw.devdoc;
+            artifact.userdoc = raw.userdoc;
+            artifact.storageLayout = raw.storageLayout;
+        }
+        return artifact;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/artifacts/loader.js.map

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

package/dist/artifacts/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * A minimal artifact format that can be provided externally.
+ * Supports both Hardhat v2 and v3 formats.
+ */
+export interface ExternalArtifact {
+    /** Contract name */
+    contractName: string;
+    /** Source file path/identifier */
+    sourceName: string;
+    /** Contract ABI */
+    abi: readonly any[];
+    /** Deployment bytecode (0x-prefixed) */
+    bytecode: string;
+    /** Deployed/runtime bytecode (0x-prefixed) */
+    deployedBytecode: string;
+    /** Library link references for deployment bytecode */
+    linkReferences?: LinkReferences;
+    /** Library link references for deployed bytecode */
+    deployedLinkReferences?: LinkReferences;
+}
+/**
+ * A rich artifact that includes embedded solcInput and full compilation data.
+ * This is the format from hardhat-deploy or other tools that preserve
+ * the full compilation output.
+ */
+export interface RichArtifact extends ExternalArtifact {
+    /** The full solc compiler input JSON (stringified) */
+    solcInput?: string;
+    /** Contract metadata JSON (contains solc version, settings, etc.) */
+    metadata?: string;
+    /** Full EVM output including generated sources, source maps, etc. */
+    evm?: {
+        bytecode: {
+            object: string;
+            opcodes: string;
+            sourceMap: string;
+            linkReferences: LinkReferences;
+            generatedSources?: any[];
+            functionDebugData?: Record<string, any>;
+        };
+        deployedBytecode: {
+            object: string;
+            opcodes: string;
+            sourceMap: string;
+            linkReferences: LinkReferences;
+            immutableReferences?: Record<string, Array<{
+                start: number;
+                length: number;
+            }>>;
+            generatedSources?: any[];
+            functionDebugData?: Record<string, any>;
+        };
+        methodIdentifiers?: Record<string, string>;
+        gasEstimates?: any;
+    };
+    /** Developer documentation */
+    devdoc?: any;
+    /** User documentation */
+    userdoc?: any;
+    /** Storage layout */
+    storageLayout?: any;
+}
+export interface LinkReferences {
+    [sourceName: string]: {
+        [libraryName: string]: Array<{
+            start: number;
+            length: number;
+        }>;
+    };
+}
+/**
+ * Type guard to check if an artifact is a rich artifact
+ */
+export declare function isRichArtifact(artifact: ExternalArtifact): artifact is RichArtifact;
+/**
+ * Function type for dynamically resolving artifacts
+ */
+export type ArtifactResolver = () => Promise<ExternalArtifact[]> | ExternalArtifact[];
+/**
+ * Configuration for external artifacts
+ */
+export interface ExternalArtifactsConfig {
+    /**
+     * Paths to artifact files or directories
+     * - File path: loads single artifact JSON
+     * - Directory path: loads all .json files recursively
+     */
+    paths?: string[];
+    /**
+     * Function that resolves and returns artifacts dynamically
+     * Useful for loading from APIs, databases, or complex logic
+     */
+    resolver?: ArtifactResolver;
+    /**
+     * Solc version to use when creating synthetic compilations
+     * @default "0.8.20"
+     */
+    solcVersion?: string;
+    /**
+     * Whether to log warnings for malformed artifacts
+     * @default true
+     */
+    warnOnInvalidArtifacts?: boolean;
+    /**
+     * Enable debug logging to diagnose issues
+     * @default false
+     */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/artifacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB;IACnB,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;IAEpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,cAAc,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qEAAqE;IACrE,GAAG,CAAC,EAAE;QACL,QAAQ,EAAE;YACT,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,gBAAgB,EAAE;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,cAAc,CAAC;YAC/B,mBAAmB,CAAC,EAAE,MAAM,CAC3B,MAAM,EACN,KAAK,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAC,CAAC,CACtC,CAAC;YACF,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;YACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACxC,CAAC;QACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,YAAY,CAAC,EAAE,GAAG,CAAC;KACnB,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,yBAAyB;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd,qBAAqB;IACrB,aAAa,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,UAAU,EAAE,MAAM,GAAG;QACrB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAC,CAAC,CAAC;KAC9D,CAAC;CACF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,gBAAgB,GACxB,QAAQ,IAAI,YAAY,CAE1B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,GAC3B,gBAAgB,EAAE,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/artifacts/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type guard to check if an artifact is a rich artifact
+ */
+export function isRichArtifact(artifact) {
+    return 'solcInput' in artifact && artifact.solcInput !== undefined;
+}
+//# sourceMappingURL=types.js.map

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAiFA;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,QAA0B;IAE1B,OAAO,WAAW,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC;AACpE,CAAC"}

package/dist/hooks/config.d.ts

@@ -0,0 +1,4 @@
+import type { ConfigHooks } from 'hardhat/types/hooks';
+declare const _default: () => Promise<Partial<ConfigHooks>>;
+export default _default;
+//# sourceMappingURL=config.d.ts.map

package/dist/hooks/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,qBAAqB,CAAC;8BAG5B,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAAtD,wBAuCE"}

package/dist/hooks/config.js

@@ -0,0 +1,23 @@
+export default async () => {
+    const handlers = {
+        resolveUserConfig: async (userConfig, resolveConfigurationVariable, next) => {
+            const resolvedConfig = await next(userConfig, resolveConfigurationVariable);
+            // Get user's external artifacts config
+            const externalArtifactsUserConfig = userConfig.externalArtifacts;
+            // Apply defaults
+            const externalArtifacts = {
+                paths: externalArtifactsUserConfig?.paths ?? [],
+                resolver: externalArtifactsUserConfig?.resolver,
+                solcVersion: externalArtifactsUserConfig?.solcVersion ?? '0.8.20',
+                warnOnInvalidArtifacts: externalArtifactsUserConfig?.warnOnInvalidArtifacts ?? true,
+                debug: externalArtifactsUserConfig?.debug ?? false,
+            };
+            return {
+                ...resolvedConfig,
+                externalArtifacts,
+            };
+        },
+    };
+    return handlers;
+};
+//# sourceMappingURL=config.js.map

package/dist/hooks/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAGA,eAAe,KAAK,IAAmC,EAAE;IACxD,MAAM,QAAQ,GAAyB;QACtC,iBAAiB,EAAE,KAAK,EACvB,UAAU,EACV,4BAA4B,EAC5B,IAAI,EACH,EAAE;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAChC,UAAU,EACV,4BAA4B,CAC5B,CAAC;YAEF,uCAAuC;YACvC,MAAM,2BAA2B,GAAG,UAAU,CAAC,iBAEnC,CAAC;YAEb,iBAAiB;YACjB,MAAM,iBAAiB,GAInB;gBACH,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,EAAE;gBAC/C,QAAQ,EAAE,2BAA2B,EAAE,QAAQ;gBAC/C,WAAW,EAAE,2BAA2B,EAAE,WAAW,IAAI,QAAQ;gBACjE,sBAAsB,EACrB,2BAA2B,EAAE,sBAAsB,IAAI,IAAI;gBAC5D,KAAK,EAAE,2BAA2B,EAAE,KAAK,IAAI,KAAK;aAClD,CAAC;YAEF,OAAO;gBACN,GAAG,cAAc;gBACjB,iBAAiB;aACjB,CAAC;QACH,CAAC;KACD,CAAC;IAEF,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC"}

package/dist/hooks/network.d.ts

@@ -0,0 +1,4 @@
+import type { NetworkHooks } from 'hardhat/types/hooks';
+declare const _default: () => Promise<Partial<NetworkHooks>>;
+export default _default;
+//# sourceMappingURL=network.d.ts.map

package/dist/hooks/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAc,MAAM,qBAAqB,CAAC;8BAS1C,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAAvD,wBAsHE"}

package/dist/hooks/network.js

@@ -0,0 +1,87 @@
+import { ArtifactLoader } from '../artifacts/loader.js';
+import { artifactsToCompilations, } from '../artifacts/converter.js';
+import { isRichArtifact } from '../artifacts/types.js';
+export default async () => {
+    const handlers = {
+        newConnection: async (context, next) => {
+            // Call the default behavior first to create the connection
+            const connection = await next(context);
+            // Only inject artifacts for EDR networks (hardhat network)
+            if (connection.networkConfig.type !== 'edr-simulated') {
+                return connection;
+            }
+            const config = context.config.externalArtifacts;
+            // Check if config exists and there's anything to load
+            if (!config || (!config.paths?.length && !config.resolver)) {
+                return connection;
+            }
+            const debug = config.debug ?? false;
+            const log = debug ? console.log.bind(console) : () => { };
+            try {
+                // Load external artifacts
+                const loader = new ArtifactLoader(config, context.config.paths.root);
+                const artifacts = await loader.loadAll();
+                if (artifacts.length === 0) {
+                    log('[hardhat-external-artifacts] No artifacts found');
+                    return connection;
+                }
+                log(`[hardhat-external-artifacts] Loaded ${artifacts.length} artifact(s):`);
+                for (const artifact of artifacts) {
+                    const isRich = isRichArtifact(artifact);
+                    const deployedBytecodeLength = artifact.deployedBytecode?.length || 0;
+                    log(`  - ${artifact.sourceName}:${artifact.contractName} (${isRich ? 'rich' : 'simple'}, deployedBytecode: ${deployedBytecodeLength} chars)`);
+                }
+                // Convert to compilation format(s)
+                // Rich artifacts with solcInput get their own compilations
+                // Simple artifacts get grouped into a synthetic compilation
+                const compilations = artifactsToCompilations(artifacts, config.solcVersion);
+                log(`[hardhat-external-artifacts] Created ${compilations.length} compilation(s)`);
+                // Add to the EDR provider - use type assertion since addCompilationResult is an internal method
+                const provider = connection.provider;
+                if (typeof provider.addCompilationResult === 'function') {
+                    for (const compilation of compilations) {
+                        logCompilation(compilation, log);
+                        // Ensure clean JSON serialization for the native EDR binding
+                        // by round-tripping through JSON stringify/parse
+                        const cleanInput = JSON.parse(JSON.stringify(compilation.compilerInput));
+                        const cleanOutput = JSON.parse(JSON.stringify(compilation.compilerOutput));
+                        log(`[hardhat-external-artifacts] Calling addCompilationResult with solcVersion: ${compilation.solcVersion}`);
+                        await provider.addCompilationResult(compilation.solcVersion, cleanInput, cleanOutput);
+                        log(`[hardhat-external-artifacts] Successfully added compilation to EDR provider`);
+                    }
+                    console.log(`[hardhat-external-artifacts] Loaded ${artifacts.length} external artifact(s) in ${compilations.length} compilation(s)`);
+                }
+                else {
+                    console.warn(`[hardhat-external-artifacts] Warning: provider.addCompilationResult is not available. ` +
+                        `This might indicate an incompatible Hardhat version.`);
+                }
+            }
+            catch (error) {
+                if (config.warnOnInvalidArtifacts !== false) {
+                    console.warn(`[hardhat-external-artifacts] Warning: Failed to load external artifacts:`, error);
+                }
+            }
+            return connection;
+        },
+    };
+    return handlers;
+};
+function logCompilation(compilation, log) {
+    log(`[hardhat-external-artifacts] Compilation details:`);
+    log(`  solcVersion: ${compilation.solcVersion}`);
+    log(`  sources in compilerInput: ${Object.keys(compilation.compilerInput.sources).join(', ')}`);
+    log(`  sources in compilerOutput: ${Object.keys(compilation.compilerOutput.sources).join(', ')}`);
+    for (const [sourceName, contracts] of Object.entries(compilation.compilerOutput.contracts || {})) {
+        for (const [contractName, contract] of Object.entries(contracts)) {
+            const deployedBytecodeLength = contract.evm?.deployedBytecode?.object?.length || 0;
+            const methodCount = Object.keys(contract.evm?.methodIdentifiers || {}).length;
+            log(`  ${sourceName}:${contractName} - deployedBytecode: ${deployedBytecodeLength} chars (${Math.floor(deployedBytecodeLength / 2)} bytes), methods: ${methodCount}`);
+            // Log first 100 chars of bytecode for verification
+            if (deployedBytecodeLength > 0) {
+                const preview = contract.evm.deployedBytecode.object.substring(0, 100);
+                log(`    bytecode preview: ${preview}...`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/hooks/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/hooks/network.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACN,uBAAuB,GAEvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAErD,eAAe,KAAK,IAAoC,EAAE;IACzD,MAAM,QAAQ,GAA0B;QACvC,aAAa,EAAE,KAAK,EACnB,OAAoB,EACpB,IAE2C,EACF,EAAE;YAC3C,2DAA2D;YAC3D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvC,2DAA2D;YAC3D,IAAI,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACvD,OAAO,UAAU,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;YAEhD,sDAAsD;YACtD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5D,OAAO,UAAU,CAAC;YACnB,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;YACpC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YAEzD,IAAI,CAAC;gBACJ,0BAA0B;gBAC1B,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrE,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBAEzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC5B,GAAG,CAAC,iDAAiD,CAAC,CAAC;oBACvD,OAAO,UAAU,CAAC;gBACnB,CAAC;gBAED,GAAG,CACF,uCAAuC,SAAS,CAAC,MAAM,eAAe,CACtE,CAAC;gBACF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBAClC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;oBACxC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC,CAAC;oBACtE,GAAG,CACF,OAAO,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,uBAAuB,sBAAsB,SAAS,CACxI,CAAC;gBACH,CAAC;gBAEA,mCAAmC;gBACnC,2DAA2D;gBAC3D,4DAA4D;gBAC5D,MAAM,YAAY,GAAG,uBAAuB,CAC3C,SAAS,EACT,MAAM,CAAC,WAAW,CAClB,CAAC;gBAEH,GAAG,CACF,wCAAwC,YAAY,CAAC,MAAM,iBAAiB,CAC5E,CAAC;gBAEF,gGAAgG;gBAChG,MAAM,QAAQ,GAAG,UAAU,CAAC,QAM3B,CAAC;gBAEF,IAAI,OAAO,QAAQ,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;oBACzD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;wBACxC,cAAc,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;wBAEjC,6DAA6D;wBAC7D,iDAAiD;wBACjD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC5B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CACzC,CAAC;wBACF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC7B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,CAAC,CAC1C,CAAC;wBAEF,GAAG,CACF,+EAA+E,WAAW,CAAC,WAAW,EAAE,CACxG,CAAC;wBAEF,MAAM,QAAQ,CAAC,oBAAoB,CAClC,WAAW,CAAC,WAAW,EACvB,UAAU,EACV,WAAW,CACX,CAAC;wBACF,GAAG,CACF,6EAA6E,CAC7E,CAAC;oBACH,CAAC;oBAED,OAAO,CAAC,GAAG,CACV,uCAAuC,SAAS,CAAC,MAAM,4BAA4B,YAAY,CAAC,MAAM,iBAAiB,CACvH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CACX,wFAAwF;wBACvF,sDAAsD,CACvD,CAAC;gBACH,CAAC;YACF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,IAAI,MAAM,CAAC,sBAAsB,KAAK,KAAK,EAAE,CAAC;oBAC7C,OAAO,CAAC,IAAI,CACX,0EAA0E,EAC1E,KAAK,CACL,CAAC;gBACH,CAAC;YACF,CAAC;YAED,OAAO,UAAU,CAAC;QACnB,CAAC;KACD,CAAC;IAEF,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC;AAEF,SAAS,cAAc,CACtB,WAAiC,EACjC,GAA6B;IAE7B,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACzD,GAAG,CAAC,kBAAkB,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,GAAG,CACF,+BAA+B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1F,CAAC;IACF,GAAG,CACF,gCAAgC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;IAEF,KAAK,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CACnD,WAAW,CAAC,cAAc,CAAC,SAAS,IAAI,EAAE,CAC1C,EAAE,CAAC;QACH,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CACpD,SAAgC,CAChC,EAAE,CAAC;YACH,MAAM,sBAAsB,GAC3B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;YACrD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAC9B,QAAQ,CAAC,GAAG,EAAE,iBAAiB,IAAI,EAAE,CACrC,CAAC,MAAM,CAAC;YACT,GAAG,CACF,KAAK,UAAU,IAAI,YAAY,wBAAwB,sBAAsB,WAAW,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC,qBAAqB,WAAW,EAAE,CAChK,CAAC;YACF,mDAAmD;YACnD,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACvE,GAAG,CAAC,yBAAyB,OAAO,KAAK,CAAC,CAAC;YAC5C,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { HardhatPlugin } from 'hardhat/types/plugins';
+import './type-extensions.js';
+declare const hardhatExternalArtifactsPlugin: HardhatPlugin;
+export default hardhatExternalArtifactsPlugin;
+export * from './artifacts/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAGzD,OAAO,sBAAsB,CAAC;AAE9B,QAAA,MAAM,8BAA8B,EAAE,aAMrC,CAAC;AAEF,eAAe,8BAA8B,CAAC;AAC9C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Import type extensions
+import './type-extensions.js';
+const hardhatExternalArtifactsPlugin = {
+    id: 'hardhat-external-artifacts',
+    hookHandlers: {
+        config: () => import('./hooks/config.js'),
+        network: () => import('./hooks/network.js'),
+    },
+};
+export default hardhatExternalArtifactsPlugin;
+export * from './artifacts/types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,yBAAyB;AACzB,OAAO,sBAAsB,CAAC;AAE9B,MAAM,8BAA8B,GAAkB;IACrD,EAAE,EAAE,4BAA4B;IAChC,YAAY,EAAE;QACb,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;KAC3C;CACD,CAAC;AAEF,eAAe,8BAA8B,CAAC;AAC9C,cAAc,sBAAsB,CAAC"}

package/dist/type-extensions.d.ts

@@ -0,0 +1,17 @@
+import "hardhat/types/config";
+import type { ExternalArtifactsConfig } from "./artifacts/types.js";
+/**
+ * Resolved external artifacts configuration with defaults applied.
+ */
+export type ResolvedExternalArtifactsConfig = Required<Omit<ExternalArtifactsConfig, "resolver">> & {
+    resolver?: ExternalArtifactsConfig["resolver"];
+};
+declare module "hardhat/types/config" {
+    interface HardhatUserConfig {
+        externalArtifacts?: ExternalArtifactsConfig;
+    }
+    interface HardhatConfig {
+        externalArtifacts?: ResolvedExternalArtifactsConfig;
+    }
+}
+//# sourceMappingURL=type-extensions.d.ts.map

package/dist/type-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extensions.d.ts","sourceRoot":"","sources":["../src/type-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC,GAAG;IAClG,QAAQ,CAAC,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;CAChD,CAAC;AAEF,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;KAC7C;IAED,UAAU,aAAa;QACrB,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;KACrD;CACF"}

package/dist/type-extensions.js

@@ -0,0 +1,2 @@
+import "hardhat/types/config";
+//# sourceMappingURL=type-extensions.js.map

package/dist/type-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-extensions.js","sourceRoot":"","sources":["../src/type-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "hardhat-external-artifacts",
+  "version": "0.0.1",
+  "description": "Hardhat plugin that allow hardhat to know about them",
+  "keywords": [
+    "hardhat",
+    "ethereum",
+    "solidity"
+  ],
+  "author": "Ronan Sandford",
+  "license": "MIT",
+  "homepage": "https://github.com/wighawag/hardhat-external-artifacts#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wighawag/hardhat-external-artifacts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wighawag/hardhat-external-artifacts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@rocketh/node": "^0.19.3",
+    "@types/node": "^25.2.3",
+    "as-soon": "^0.1.5",
+    "hardhat": "3.1.8",
+    "prettier": "^3.8.1",
+    "rimraf": "^6.1.3",
+    "set-defaults": "^0.0.5",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "hardhat": "^3.1.8"
+  },
+  "dependencies": {
+    "@nomicfoundation/hardhat-utils": "^4.0.0",
+    "named-logs": "^0.4.1",
+    "viem": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "as-soon -w src pnpm build"
+  }
+}