hardhat-external-artifacts 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ronan Sandford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,228 @@
+# hardhat-external-artifacts
+
+A Hardhat 3 plugin that allows users to provide external contract artifacts (ABIs) to Hardhat's EDR provider for decoding events, errors, and function calls in console output.
+
+This is useful when interacting with contracts that were not compiled by the current Hardhat project (e.g., external protocols, deployed contracts from other projects).
+
+## Installation
+
+```bash
+npm install hardhat-external-artifacts
+# or
+pnpm add hardhat-external-artifacts
+# or
+yarn add hardhat-external-artifacts
+```
+
+## Usage
+
+Import the plugin in your Hardhat configuration file:
+
+```typescript
+// hardhat.config.ts
+import type {HardhatUserConfig} from 'hardhat/config';
+import 'hardhat-external-artifacts';
+
+const config: HardhatUserConfig = {
+	solidity: '0.8.20',
+	externalArtifacts: {
+		// Load specific artifact files
+		paths: [
+			'./external-artifacts/WETH.json',
+			'./external-artifacts/Uniswap/', // Loads all .json in directory
+		],
+		// Optional: specify solc version for synthetic compilations
+		solcVersion: '0.8.20',
+		// Optional: disable warnings for invalid artifacts
+		warnOnInvalidArtifacts: true,
+	},
+};
+
+export default config;
+```
+
+### Using a Resolver Function
+
+For more dynamic artifact loading, you can use a resolver function:
+
+```typescript
+// hardhat.config.ts
+import type {HardhatUserConfig} from 'hardhat/config';
+import 'hardhat-external-artifacts';
+
+const config: HardhatUserConfig = {
+	solidity: '0.8.20',
+	externalArtifacts: {
+		resolver: async () => {
+			// Fetch from API, database, or any source
+			return [
+				{
+					contractName: 'ERC20',
+					sourceName: 'openzeppelin/ERC20.sol',
+					abi: [
+						/* ... */
+					],
+					bytecode: '0x...',
+					deployedBytecode: '0x...',
+				},
+			];
+		},
+		solcVersion: '0.8.20',
+	},
+};
+
+export default config;
+```
+
+### Combined Approach
+
+You can use both paths and resolver together:
+
+```typescript
+// hardhat.config.ts
+import type {HardhatUserConfig} from 'hardhat/config';
+import 'hardhat-external-artifacts';
+import {loadDefiProtocolArtifacts} from './scripts/load-defi';
+
+const config: HardhatUserConfig = {
+	solidity: '0.8.20',
+	externalArtifacts: {
+		// Load from local directory
+		paths: ['./vendor-artifacts/'],
+
+		// Also fetch dynamically
+		resolver: async () => loadDefiProtocolArtifacts(),
+
+		// Use specific solc version for method ID computation
+		solcVersion: '0.8.19',
+
+		// Silence warnings for experimental use
+		warnOnInvalidArtifacts: false,
+	},
+};
+
+export default config;
+```
+
+## Configuration Options
+
+| Option                   | Type                                | Default     | Description                                     |
+| ------------------------ | ----------------------------------- | ----------- | ----------------------------------------------- |
+| `paths`                  | `string[]`                          | `[]`        | Paths to artifact files or directories          |
+| `resolver`               | `() => Promise<ExternalArtifact[]>` | `undefined` | Function that returns artifacts dynamically     |
+| `solcVersion`            | `string`                            | `"0.8.20"`  | Solc version for synthetic compilations         |
+| `warnOnInvalidArtifacts` | `boolean`                           | `true`      | Whether to log warnings for malformed artifacts |
+| `debug`                  | `boolean`                           | `false`     | Enable debug logging for troubleshooting        |
+
+## Artifact Format
+
+### Simple Artifact
+
+The minimum required format for an external artifact:
+
+```json
+{
+  "contractName": "MyContract",
+  "sourceName": "contracts/MyContract.sol",
+  "abi": [...],
+  "bytecode": "0x...",
+  "deployedBytecode": "0x..."
+}
+```
+
+### Rich Artifact
+
+For better fidelity, you can provide a rich artifact with embedded compilation data:
+
+```json
+{
+  "contractName": "MyContract",
+  "sourceName": "contracts/MyContract.sol",
+  "abi": [...],
+  "bytecode": "0x...",
+  "deployedBytecode": "0x...",
+  "solcInput": "{\"language\":\"Solidity\",...}",
+  "metadata": "{\"compiler\":{\"version\":\"0.8.20+commit...\"},...}",
+  "evm": {
+    "bytecode": { "object": "...", "sourceMap": "...", ... },
+    "deployedBytecode": { "object": "...", "sourceMap": "...", ... },
+    "methodIdentifiers": { "transfer(address,uint256)": "a9059cbb" }
+  }
+}
+```
+
+Rich artifacts are typically produced by tools like `hardhat-deploy` that preserve full compilation output.
+
+## How It Works
+
+1. When a network connection is established (specifically for EDR/Hardhat Network), the plugin loads the configured external artifacts.
+
+2. Simple artifacts are grouped into a synthetic compilation with computed method identifiers.
+
+3. Rich artifacts (with embedded `solcInput`) get their own individual compilations for maximum fidelity.
+
+4. The compilations are added to the EDR provider using `addCompilationResult()`, enabling:
+   - Event decoding in transaction logs
+   - Error decoding for reverts
+   - Function call decoding in stack traces
+
+## Troubleshooting
+
+### Contract still shows as `<UnrecognizedContract>`
+
+If you see logs like:
+```
+eth_call
+  Contract call:             <UnrecognizedContract>
+  From:                      0x...
+  To:                        0x...
+```
+
+This means EDR couldn't match the contract's bytecode. EDR identifies contracts by matching the **deployed bytecode** at the target address with bytecode from compilation results.
+
+**Possible causes:**
+
+1. **Bytecode mismatch**: The `deployedBytecode` in your artifact doesn't match what's actually deployed. This can happen due to:
+   - Different compiler versions or optimizer settings
+   - Metadata hash differences (appended to bytecode by default)
+   - Constructor arguments that set immutable values
+
+2. **Missing bytecode**: Your artifact has an empty or missing `deployedBytecode` field.
+
+**Debugging steps:**
+
+1. Enable debug logging:
+   ```typescript
+   externalArtifacts: {
+     paths: ['./artifacts/'],
+     debug: true,  // Enable debug output
+   }
+   ```
+
+2. Verify bytecode exists and has reasonable length in the debug output.
+
+3. Compare your artifact's `deployedBytecode` with the actual bytecode at the address:
+   ```typescript
+   // In your test/script
+   const actualCode = await connection.provider.request({
+     method: 'eth_getCode',
+     params: [contractAddress, 'latest'],
+   });
+   console.log('Actual bytecode length:', actualCode.length);
+   console.log('Artifact bytecode length:', artifact.deployedBytecode.length);
+   ```
+
+4. For forked networks, ensure you have the exact artifact that was used to deploy the contract on mainnet. Minor differences (like metadata hash) will prevent matching.
+
+### Rich artifacts vs Simple artifacts
+
+Rich artifacts (with `solcInput`) provide better matching because they include the complete compilation data. If you have access to the original compilation output (e.g., from `hardhat-deploy`), prefer using rich artifacts.
+
+## Requirements
+
+- Hardhat 3.x
+- Node.js 22+
+
+## License
+
+MIT

package/dist/artifacts/converter.d.ts

@@ -0,0 +1,62 @@
+import type { ExternalArtifact, LinkReferences } from './types.js';
+export interface SyntheticCompilation {
+    solcVersion: string;
+    compilerInput: CompilerInput;
+    compilerOutput: CompilerOutput;
+}
+interface CompilerInput {
+    language: string;
+    sources: Record<string, {
+        content: string;
+    }>;
+    settings: {
+        optimizer: {
+            enabled: boolean;
+            runs?: number;
+        };
+        outputSelection: Record<string, Record<string, string[]>>;
+        remappings?: string[];
+        metadata?: {
+            useLiteralContent?: boolean;
+            bytecodeHash?: string;
+        };
+    };
+}
+interface CompilerOutput {
+    sources: Record<string, {
+        id: number;
+        ast: object;
+    }>;
+    contracts: Record<string, Record<string, {
+        abi: readonly any[];
+        evm: {
+            bytecode: BytecodeOutput;
+            deployedBytecode: BytecodeOutput;
+            methodIdentifiers: Record<string, string>;
+        };
+        metadata?: string;
+        devdoc?: any;
+        userdoc?: any;
+        storageLayout?: any;
+    }>>;
+}
+interface BytecodeOutput {
+    object: string;
+    opcodes: string;
+    sourceMap: string;
+    linkReferences: LinkReferences;
+    immutableReferences?: Record<string, Array<{
+        start: number;
+        length: number;
+    }>>;
+    generatedSources?: any[];
+    functionDebugData?: Record<string, any>;
+}
+/**
+ * Convert artifacts to compilation format.
+ * If artifacts are "rich" (have solcInput), use the embedded data.
+ * Otherwise, synthesize a minimal compilation.
+ */
+export declare function artifactsToCompilations(artifacts: ExternalArtifact[], defaultSolcVersion: string): SyntheticCompilation[];
+export {};
+//# sourceMappingURL=converter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/artifacts/converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAgB,cAAc,EAAC,MAAM,YAAY,CAAC;AAG/E,MAAM,WAAW,oBAAoB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;CAC/B;AAED,UAAU,aAAa;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE;QACT,SAAS,EAAE;YAAC,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAC,CAAC;QAC7C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,EAAE;YAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,CAAA;SAAC,CAAC;KAChE,CAAC;CACF;AAED,UAAU,cAAc;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACnD,SAAS,EAAE,MAAM,CAChB,MAAM,EACN,MAAM,CACL,MAAM,EACN;QACC,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC;QACpB,GAAG,EAAE;YACJ,QAAQ,EAAE,cAAc,CAAC;YACzB,gBAAgB,EAAE,cAAc,CAAC;YACjC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SAC1C,CAAC;QACF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,aAAa,CAAC,EAAE,GAAG,CAAC;KACpB,CACD,CACD,CAAC;CACF;AAED,UAAU,cAAc;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC,CAAC;IAC7E,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxC;AA2CD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,kBAAkB,EAAE,MAAM,GACxB,oBAAoB,EAAE,CAuBxB"}

package/dist/artifacts/converter.js

@@ -0,0 +1,241 @@
+import { isRichArtifact } from './types.js';
+/**
+ * Creates a minimal valid AST for a source file.
+ * This is needed because Hardhat's contract decoder expects a valid AST structure.
+ */
+function createMinimalAst(sourceName, sourceId, contracts) {
+    const nodes = [];
+    const exportedSymbols = {};
+    // Add contract definition nodes if provided
+    if (contracts) {
+        for (const contract of contracts) {
+            nodes.push({
+                nodeType: 'ContractDefinition',
+                id: contract.nodeId,
+                src: `0:0:${sourceId}`,
+                name: contract.name,
+                contractKind: 'contract',
+                abstract: false,
+                fullyImplemented: true,
+                linearizedBaseContracts: [contract.nodeId],
+                nodes: [],
+                scope: sourceId,
+            });
+            exportedSymbols[contract.name] = [contract.nodeId];
+        }
+    }
+    return {
+        nodeType: 'SourceUnit',
+        src: `0:0:${sourceId}`,
+        id: sourceId,
+        absolutePath: sourceName,
+        exportedSymbols,
+        nodes,
+    };
+}
+/**
+ * Convert artifacts to compilation format.
+ * If artifacts are "rich" (have solcInput), use the embedded data.
+ * Otherwise, synthesize a minimal compilation.
+ */
+export function artifactsToCompilations(artifacts, defaultSolcVersion) {
+    // Group artifacts by whether they have solcInput
+    const richArtifacts = artifacts.filter(isRichArtifact);
+    const simpleArtifacts = artifacts.filter((a) => !isRichArtifact(a));
+    const compilations = [];
+    // Process rich artifacts - these have embedded solcInput
+    for (const artifact of richArtifacts) {
+        const compilation = richArtifactToCompilation(artifact);
+        if (compilation) {
+            compilations.push(compilation);
+        }
+    }
+    // Process simple artifacts - synthesize compilation
+    if (simpleArtifacts.length > 0) {
+        compilations.push(synthesizeCompilation(simpleArtifacts, defaultSolcVersion));
+    }
+    return compilations;
+}
+/**
+ * Convert a rich artifact (with embedded solcInput) to a compilation.
+ * Uses the embedded solcInput directly for maximum fidelity.
+ */
+function richArtifactToCompilation(artifact) {
+    if (!artifact.solcInput) {
+        return null;
+    }
+    // Parse the embedded solcInput
+    const compilerInput = JSON.parse(artifact.solcInput);
+    // Extract solc version from metadata
+    let solcVersion = '0.8.20'; // Default
+    if (artifact.metadata) {
+        try {
+            const metadata = JSON.parse(artifact.metadata);
+            if (metadata.compiler?.version) {
+                // Format: "0.8.10+commit.fc410830" -> extract "0.8.10"
+                solcVersion = metadata.compiler.version.split('+')[0];
+            }
+        }
+        catch {
+            // Ignore parsing errors, use default
+        }
+    }
+    // Build compiler output from the artifact
+    // Only include sources that we have contract data for
+    // Including empty sources/contracts can cause EDR selector fixup issues
+    const compilerOutput = {
+        sources: {},
+        contracts: {},
+    };
+    const sourceName = artifact.sourceName;
+    // Track source IDs for all input sources (needed for consistent source indexing)
+    let sourceId = 0;
+    const sourceIds = {};
+    for (const srcName of Object.keys(compilerInput.sources)) {
+        sourceIds[srcName] = sourceId++;
+    }
+    // Only include the source that contains our contract
+    const contractSourceId = sourceIds[sourceName] ?? sourceId++;
+    const contractNodeId = contractSourceId + 1000; // Use an offset to avoid ID conflicts
+    compilerOutput.sources[sourceName] = {
+        id: contractSourceId,
+        ast: createMinimalAst(sourceName, contractSourceId, [
+            { name: artifact.contractName, nodeId: contractNodeId },
+        ]),
+    };
+    compilerOutput.contracts[sourceName] = {};
+    // Ensure the source is in compilerInput as well
+    if (!compilerInput.sources[sourceName]) {
+        compilerInput.sources[sourceName] = { content: '' };
+    }
+    // Build bytecode output, ensuring proper format
+    // Standard solc output has bytecode.object without 0x prefix
+    const bytecode = {
+        object: stripHexPrefix(artifact.evm?.bytecode?.object ?? artifact.bytecode ?? '0x'),
+        opcodes: artifact.evm?.bytecode?.opcodes ?? '',
+        sourceMap: artifact.evm?.bytecode?.sourceMap ?? '',
+        linkReferences: artifact.evm?.bytecode?.linkReferences ?? artifact.linkReferences ?? {},
+        generatedSources: artifact.evm?.bytecode?.generatedSources,
+        functionDebugData: artifact.evm?.bytecode?.functionDebugData,
+    };
+    const deployedBytecode = {
+        object: stripHexPrefix(artifact.evm?.deployedBytecode?.object ??
+            artifact.deployedBytecode ??
+            '0x'),
+        opcodes: artifact.evm?.deployedBytecode?.opcodes ?? '',
+        sourceMap: artifact.evm?.deployedBytecode?.sourceMap ?? '',
+        linkReferences: artifact.evm?.deployedBytecode?.linkReferences ??
+            artifact.deployedLinkReferences ??
+            {},
+        immutableReferences: artifact.evm?.deployedBytecode?.immutableReferences ?? {},
+        generatedSources: artifact.evm?.deployedBytecode?.generatedSources,
+        functionDebugData: artifact.evm?.deployedBytecode?.functionDebugData,
+    };
+    // IMPORTANT: Do NOT provide method identifiers - let EDR compute them
+    // EDR has internal "selector fixup" logic for function overloading that can fail
+    // if we provide method identifiers that it then tries to reconcile with AST info.
+    // The error "Failed to fix up the selector for ... #supportsInterface" happens
+    // when EDR can't match provided selectors with overloaded functions.
+    // By providing an empty object, EDR will compute selectors from the ABI directly.
+    const methodIdentifiers = {};
+    compilerOutput.contracts[sourceName][artifact.contractName] = {
+        abi: artifact.abi,
+        evm: {
+            bytecode,
+            deployedBytecode,
+            methodIdentifiers,
+        },
+        metadata: artifact.metadata,
+        devdoc: artifact.devdoc,
+        userdoc: artifact.userdoc,
+        storageLayout: artifact.storageLayout,
+    };
+    return {
+        solcVersion,
+        compilerInput,
+        compilerOutput,
+    };
+}
+/**
+ * Synthesize a minimal compilation from simple artifacts.
+ * Used when artifacts don't have embedded solcInput.
+ */
+function synthesizeCompilation(artifacts, solcVersion) {
+    const sources = {};
+    const outputSources = {};
+    const contracts = {};
+    // First, group artifacts by source
+    const contractsBySource = {};
+    for (const artifact of artifacts) {
+        if (!contractsBySource[artifact.sourceName]) {
+            contractsBySource[artifact.sourceName] = [];
+        }
+        contractsBySource[artifact.sourceName].push({
+            name: artifact.contractName,
+            artifact,
+        });
+    }
+    // Track IDs for AST nodes
+    let nextId = 0;
+    // Create sources with contract definitions in AST
+    for (const [sourceName, sourceContracts] of Object.entries(contractsBySource)) {
+        const sourceId = nextId++;
+        sources[sourceName] = { content: '' };
+        contracts[sourceName] = {};
+        // Create contract nodes for AST
+        const contractNodes = [];
+        for (const { name } of sourceContracts) {
+            const nodeId = nextId++;
+            contractNodes.push({ name, nodeId });
+        }
+        outputSources[sourceName] = {
+            id: sourceId,
+            ast: createMinimalAst(sourceName, sourceId, contractNodes),
+        };
+        // Add contract outputs
+        for (const { name, artifact } of sourceContracts) {
+            contracts[sourceName][name] = {
+                abi: artifact.abi,
+                evm: {
+                    bytecode: {
+                        object: stripHexPrefix(artifact.bytecode),
+                        opcodes: '',
+                        sourceMap: '',
+                        linkReferences: artifact.linkReferences ?? {},
+                    },
+                    deployedBytecode: {
+                        object: stripHexPrefix(artifact.deployedBytecode),
+                        opcodes: '',
+                        sourceMap: '',
+                        linkReferences: artifact.deployedLinkReferences ?? {},
+                        immutableReferences: {},
+                    },
+                    // Empty object - let EDR compute selectors to avoid selector fixup issues
+                    // with overloaded functions (consistent with richArtifactToCompilation)
+                    methodIdentifiers: {},
+                },
+            };
+        }
+    }
+    return {
+        solcVersion,
+        compilerInput: {
+            language: 'Solidity',
+            sources,
+            settings: {
+                optimizer: { enabled: false },
+                outputSelection: {
+                    '*': { '*': ['abi', 'evm.bytecode', 'evm.deployedBytecode'] },
+                },
+            },
+        },
+        compilerOutput: {
+            sources: outputSources,
+            contracts,
+        },
+    };
+}
+function stripHexPrefix(hex) {
+    return hex.startsWith('0x') ? hex.slice(2) : hex;
+}
+//# sourceMappingURL=converter.js.map

package/dist/artifacts/converter.js.map

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

package/dist/artifacts/loader.d.ts

@@ -0,0 +1,7 @@
+import type { ExternalArtifact, ExternalArtifactsConfig } from './types.js';
+export declare class ArtifactLoader {
+    #private;
+    constructor(config: ExternalArtifactsConfig, projectRoot: string);
+    loadAll(): Promise<ExternalArtifact[]>;
+}
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/artifacts/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAEhB,uBAAuB,EACvB,MAAM,YAAY,CAAC;AAQpB,qBAAa,cAAc;;gBAId,MAAM,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM;IAK1D,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA8H5C"}