@diamondslab/diamonds 1.0.0

package/dist/utils/diamondAbiGenerator.js

@@ -0,0 +1,415 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiamondAbiGenerator = void 0;
+exports.generateDiamondAbi = generateDiamondAbi;
+exports.previewDiamondAbi = previewDiamondAbi;
+const chalk_1 = __importDefault(require("chalk"));
+const ethers_1 = require("ethers");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const types_1 = require("../types");
+const contractMapping_1 = require("../utils/contractMapping");
+/**
+ * Comprehensive Diamond ABI Generator
+ *
+ * This class generates a complete ABI for a diamond contract based on:
+ * - Current deployment state (deployed facets)
+ * - Planned diamond cuts (upgrades, additions, removals)
+ * - Function selector registry
+ * - Deployment configuration
+ */
+class DiamondAbiGenerator {
+    diamond;
+    options;
+    seenSelectors = new Set();
+    selectorToFacet = {};
+    combinedAbi = [];
+    stats = {
+        totalFunctions: 0,
+        totalEvents: 0,
+        totalErrors: 0,
+        facetCount: 0,
+        duplicateSelectorsSkipped: 0
+    };
+    constructor(options) {
+        this.diamond = options.diamond;
+        this.options = {
+            outputDir: options.outputDir || this.diamond.getDiamondAbiPath(),
+            includeSourceInfo: true,
+            validateSelectors: true,
+            verbose: false,
+            ...options
+        };
+    }
+    /**
+     * Generate the complete diamond ABI
+     */
+    async generateAbi() {
+        if (this.options.verbose) {
+            console.log(chalk_1.default.blue('🔧 Generating Diamond ABI...'));
+        }
+        // Reset state
+        this.seenSelectors.clear();
+        this.selectorToFacet = {};
+        this.combinedAbi = [];
+        this.stats = {
+            totalFunctions: 0,
+            totalEvents: 0,
+            totalErrors: 0,
+            facetCount: 0,
+            duplicateSelectorsSkipped: 0
+        };
+        // Get facets to include in ABI
+        const facetsToInclude = await this.getFacetsToInclude();
+        // Process each facet
+        for (const [facetName, facetInfo] of Object.entries(facetsToInclude)) {
+            await this.processFacet(facetName, facetInfo);
+        }
+        // Add DiamondLoupe functions if not already included
+        await this.ensureDiamondLoupeFunctions();
+        // Sort ABI for consistency
+        this.sortAbi();
+        // Generate output
+        const result = await this.generateOutput();
+        if (this.options.verbose) {
+            this.logStats();
+        }
+        return result;
+    }
+    /**
+     * Get all facets that should be included in the ABI
+     */
+    async getFacetsToInclude() {
+        const facetsToInclude = {};
+        // 1. Get currently deployed facets
+        const deployedData = this.diamond.getDeployedDiamondData();
+        if (deployedData.DeployedFacets) {
+            for (const [facetName, facetData] of Object.entries(deployedData.DeployedFacets)) {
+                if (facetData.address && facetData.funcSelectors) {
+                    facetsToInclude[facetName] = {
+                        address: facetData.address,
+                        selectors: facetData.funcSelectors,
+                        action: types_1.RegistryFacetCutAction.Deployed,
+                        source: 'deployed'
+                    };
+                }
+            }
+        }
+        // 2. Get planned cuts from function selector registry
+        const registry = this.diamond.functionSelectorRegistry;
+        for (const [selector, entry] of registry.entries()) {
+            if (entry.action === types_1.RegistryFacetCutAction.Add || entry.action === types_1.RegistryFacetCutAction.Replace) {
+                const facetName = entry.facetName;
+                if (!facetsToInclude[facetName]) {
+                    facetsToInclude[facetName] = {
+                        address: entry.address,
+                        selectors: [],
+                        action: entry.action,
+                        source: 'registry'
+                    };
+                }
+                facetsToInclude[facetName].selectors.push(selector);
+            }
+            else if (entry.action === types_1.RegistryFacetCutAction.Remove) {
+                // Remove selector from existing facet
+                const facetName = entry.facetName;
+                if (facetsToInclude[facetName]) {
+                    facetsToInclude[facetName].selectors = facetsToInclude[facetName].selectors.filter(s => s !== selector);
+                }
+            }
+        }
+        // 3. Apply custom facet cuts if provided
+        if (this.options.customFacetCuts) {
+            for (const cut of this.options.customFacetCuts) {
+                const facetName = cut.name;
+                if (cut.action === 0) { // Add
+                    if (!facetsToInclude[facetName]) {
+                        facetsToInclude[facetName] = {
+                            address: cut.facetAddress,
+                            selectors: [],
+                            action: types_1.RegistryFacetCutAction.Add,
+                            source: 'custom'
+                        };
+                    }
+                    facetsToInclude[facetName].selectors.push(...cut.functionSelectors);
+                }
+                else if (cut.action === 2) { // Remove
+                    if (facetsToInclude[facetName]) {
+                        facetsToInclude[facetName].selectors = facetsToInclude[facetName].selectors.filter(s => !cut.functionSelectors.includes(s));
+                    }
+                }
+            }
+        }
+        // Remove facets with no selectors
+        for (const [facetName, facetInfo] of Object.entries(facetsToInclude)) {
+            if (facetInfo.selectors.length === 0) {
+                delete facetsToInclude[facetName];
+            }
+        }
+        return facetsToInclude;
+    }
+    /**
+     * Process a single facet and add its ABI items
+     */
+    async processFacet(facetName, facetInfo) {
+        try {
+            if (this.options.verbose) {
+                console.log(chalk_1.default.cyan(`📄 Processing ${facetName}...`));
+            }
+            // Get the contract artifact
+            let artifact;
+            try {
+                artifact = await (0, contractMapping_1.getContractArtifact)(facetName, this.diamond);
+            }
+            catch (artifactError) {
+                if (this.options.verbose) {
+                    console.log(chalk_1.default.yellow(`⚠️  Artifact loading failed for ${facetName}: ${artifactError}`));
+                }
+                artifact = null;
+            }
+            if (!artifact || !artifact.abi) {
+                if (this.options.verbose) {
+                    console.log(chalk_1.default.yellow(`⚠️  No ABI found for ${facetName}`));
+                }
+                // Still add selectors to mapping even if artifact can't be loaded
+                // This handles cases where selectors are in the registry but no artifact exists
+                for (const selector of facetInfo.selectors) {
+                    if (!this.seenSelectors.has(selector)) {
+                        this.selectorToFacet[selector] = facetName;
+                        this.seenSelectors.add(selector);
+                    }
+                }
+                return;
+            }
+            // Create interface for selector calculation
+            const iface = new ethers_1.Interface(artifact.abi);
+            // Process each ABI item
+            for (const abiItem of artifact.abi) {
+                await this.processAbiItem(abiItem, facetName, facetInfo, iface);
+            }
+            // For facets from the registry, add any selectors that weren't found in the ABI
+            // This handles cases where selectors are manually registered but don't have corresponding ABI items
+            if (facetInfo.source === 'registry') {
+                for (const selector of facetInfo.selectors) {
+                    if (!this.seenSelectors.has(selector)) {
+                        this.selectorToFacet[selector] = facetName;
+                        this.seenSelectors.add(selector);
+                    }
+                }
+            }
+            this.stats.facetCount++;
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(`❌ Error processing ${facetName}:`), error);
+            // Still add selectors to mapping even if there was an error
+            for (const selector of facetInfo.selectors) {
+                if (!this.seenSelectors.has(selector)) {
+                    this.selectorToFacet[selector] = facetName;
+                    this.seenSelectors.add(selector);
+                }
+            }
+        }
+    }
+    /**
+     * Process a single ABI item
+     */
+    async processAbiItem(abiItem, facetName, facetInfo, iface) {
+        // Skip constructors for diamond
+        if (abiItem.type === 'constructor') {
+            return;
+        }
+        // Handle functions
+        if (abiItem.type === 'function') {
+            const selector = iface.getFunction(abiItem.name)?.selector;
+            if (!selector) {
+                if (this.options.verbose) {
+                    console.log(chalk_1.default.yellow(`⚠️  Could not calculate selector for ${abiItem.name}`));
+                }
+                return;
+            }
+            // Check if this function should be included
+            if (facetInfo.selectors.length > 0 && !facetInfo.selectors.includes(selector)) {
+                return; // Function not in the deployment
+            }
+            // Check for duplicates
+            if (this.seenSelectors.has(selector)) {
+                if (this.options.verbose) {
+                    console.log(chalk_1.default.yellow(`⚠️  Skipping duplicate function: ${abiItem.name} (${selector})`));
+                }
+                this.stats.duplicateSelectorsSkipped++;
+                return;
+            }
+            this.seenSelectors.add(selector);
+            this.selectorToFacet[selector] = facetName;
+            // Add source information if requested
+            if (this.options.includeSourceInfo) {
+                abiItem._diamondFacet = facetName;
+                abiItem._diamondSelector = selector;
+            }
+            this.combinedAbi.push(abiItem);
+            this.stats.totalFunctions++;
+        }
+        // Handle events
+        else if (abiItem.type === 'event') {
+            // Events are global to the diamond, so include all of them
+            this.combinedAbi.push(abiItem);
+            this.stats.totalEvents++;
+        }
+        // Handle errors
+        else if (abiItem.type === 'error') {
+            // Errors are global to the diamond, so include all of them
+            this.combinedAbi.push(abiItem);
+            this.stats.totalErrors++;
+        }
+    }
+    /**
+     * Ensure DiamondLoupe functions are included
+     */
+    async ensureDiamondLoupeFunctions() {
+        const loupeSelectors = ['0xcdffacc6', '0x52ef6b2c', '0xadfca15e', '0x7a0ed627']; // facets(), facetFunctionSelectors(), facetAddresses(), facetAddress()
+        // Check if any loupe selectors are already included
+        for (const selector of loupeSelectors) {
+            if (!this.seenSelectors.has(selector)) {
+                try {
+                    await this.processFacet('DiamondLoupeFacet', {
+                        address: '0x0000000000000000000000000000000000000000',
+                        selectors: [selector],
+                        action: types_1.RegistryFacetCutAction.Deployed,
+                        source: 'loupe'
+                    });
+                }
+                catch (error) {
+                    // DiamondLoupeFacet might not be available, continue
+                }
+            }
+        }
+    }
+    /**
+     * Sort the ABI for consistency
+     */
+    sortAbi() {
+        this.combinedAbi.sort((a, b) => {
+            // Sort by type first (functions, events, errors)
+            if (a.type !== b.type) {
+                const typeOrder = { 'function': 0, 'event': 1, 'error': 2 };
+                return (typeOrder[a.type] || 99) - (typeOrder[b.type] || 99);
+            }
+            // Then by name
+            return (a.name || '').localeCompare(b.name || '');
+        });
+    }
+    /**
+     * Generate the output files and result
+     */
+    async generateOutput() {
+        const result = {
+            abi: this.combinedAbi,
+            selectorMap: this.selectorToFacet,
+            facetAddresses: [...new Set(Object.values(this.selectorToFacet))],
+            stats: { ...this.stats }
+        };
+        // Create output directory if specified
+        if (this.options.outputDir) {
+            (0, fs_1.mkdirSync)(this.options.outputDir, { recursive: true });
+            // Generate the diamond artifact
+            const diamondArtifact = {
+                "_format": "hh-sol-artifact-1",
+                "contractName": this.diamond.diamondName,
+                "sourceName": "diamond-abi/DiamondABI.sol",
+                "abi": this.combinedAbi,
+                "bytecode": "",
+                "deployedBytecode": "",
+                "linkReferences": {},
+                "deployedLinkReferences": {},
+                "_diamondMetadata": {
+                    "generatedAt": new Date().toISOString(),
+                    "diamondName": this.diamond.diamondName,
+                    "networkName": this.diamond.networkName,
+                    "chainId": this.diamond.chainId,
+                    "selectorMap": this.selectorToFacet,
+                    "stats": this.stats
+                }
+            };
+            // Write the combined artifact
+            const outputPath = (0, path_1.join)(this.options.outputDir, `${this.diamond.getDiamondAbiFileName()}.json`);
+            (0, fs_1.writeFileSync)(outputPath, JSON.stringify(diamondArtifact, null, 2));
+            // Write a TypeScript interface file
+            const interfacePath = (0, path_1.join)(this.options.outputDir, `${this.diamond.getDiamondAbiFileName()}.d.ts`);
+            this.generateTypeScriptInterface(interfacePath);
+            result.outputPath = outputPath;
+            if (this.options.verbose) {
+                console.log(chalk_1.default.green(`✅ Diamond ABI artifact created at: ${outputPath}`));
+            }
+        }
+        return result;
+    }
+    /**
+     * Generate TypeScript interface for the diamond
+     */
+    generateTypeScriptInterface(outputPath) {
+        const interfaceContent = `
+// Auto-generated Diamond ABI interface
+// Generated at: ${new Date().toISOString()}
+// Diamond: ${this.diamond.diamondName}
+// Network: ${this.diamond.networkName}
+
+export interface ${this.diamond.diamondName}Interface {
+  // Function selectors to facet mapping
+  readonly selectorMap: {
+${Object.entries(this.selectorToFacet).map(([selector, facet]) => `    "${selector}": "${facet}";`).join('\n')}
+  };
+  
+  // Facet addresses
+  readonly facetAddresses: string[];
+  
+  // ABI for ethers.js Contract instantiation
+  readonly abi: AbiItem[];
+}
+
+export const ${this.diamond.diamondName}ABI: ${this.diamond.diamondName}Interface;
+`;
+        (0, fs_1.writeFileSync)(outputPath, interfaceContent);
+    }
+    /**
+     * Log generation statistics
+     */
+    logStats() {
+        console.log(chalk_1.default.blue('\n📊 Diamond ABI Generation Statistics:'));
+        console.log(chalk_1.default.cyan(`  Functions: ${this.stats.totalFunctions}`));
+        console.log(chalk_1.default.cyan(`  Events: ${this.stats.totalEvents}`));
+        console.log(chalk_1.default.cyan(`  Errors: ${this.stats.totalErrors}`));
+        console.log(chalk_1.default.cyan(`  Facets: ${this.stats.facetCount}`));
+        console.log(chalk_1.default.cyan(`  Unique selectors: ${this.seenSelectors.size}`));
+        if (this.stats.duplicateSelectorsSkipped > 0) {
+            console.log(chalk_1.default.yellow(`  Duplicate selectors skipped: ${this.stats.duplicateSelectorsSkipped}`));
+        }
+    }
+    /**
+     * Static method to generate ABI for a diamond
+     */
+    static async generate(options) {
+        const generator = new DiamondAbiGenerator(options);
+        return generator.generateAbi();
+    }
+}
+exports.DiamondAbiGenerator = DiamondAbiGenerator;
+/**
+ * Generate ABI for a diamond (convenience function)
+ */
+async function generateDiamondAbi(diamond, options = {}) {
+    return DiamondAbiGenerator.generate({ diamond, ...options });
+}
+/**
+ * Preview what the ABI would look like after planned cuts
+ */
+async function previewDiamondAbi(diamond, plannedCuts, options = {}) {
+    return DiamondAbiGenerator.generate({
+        diamond,
+        customFacetCuts: plannedCuts,
+        ...options
+    });
+}
+//# sourceMappingURL=diamondAbiGenerator.js.map

package/dist/utils/diamondAbiGenerator.js.map

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

package/dist/utils/diffDeployedFacets.d.ts

@@ -0,0 +1,26 @@
+import { Fragment, JsonFragment } from "@ethersproject/abi";
+import { Signer } from "@ethersproject/abstract-signer";
+import { JsonRpcProvider } from "ethers";
+import { DeployedDiamondData } from "../schemas";
+export declare function diffDeployedFacets(deployedDiamondData: DeployedDiamondData, signerOrProvider: Signer | JsonRpcProvider, verboseGetDeployedFacets?: boolean): Promise<boolean>;
+export declare function printFacetSelectorFunctions(abi: readonly (string | Fragment | JsonFragment)[], selectors: string[]): void;
+export declare function isProtocolInitRegistered(deployedDiamondData: DeployedDiamondData, protocolInitFacet: string, initializerSig: string): Promise<boolean>;
+/**
+ * Compares facet selectors from on-chain DiamondLoupe with local DeployedDiamondData
+ *
+ * @param deployedFacetData - local metadata (facetName -> { address, funcSelectors[] })
+ * @param onChainFacets - list of { facetAddress, functionSelectors[] } from DiamondLoupe
+ * @returns map of facetName -> { extraOnChain[], missingOnChain[], matched[] }
+ */
+export declare function compareFacetSelectors(deployedFacetData: Record<string, {
+    address?: string;
+    funcSelectors?: string[];
+}>, onChainFacets: {
+    facetAddress: string;
+    functionSelectors: string[];
+}[]): Record<string, {
+    extraOnChain: string[];
+    missingOnChain: string[];
+    matched: string[];
+}>;
+//# sourceMappingURL=diffDeployedFacets.d.ts.map

package/dist/utils/diffDeployedFacets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffDeployedFacets.d.ts","sourceRoot":"","sources":["../../src/utils/diffDeployedFacets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,wBAAsB,kBAAkB,CACtC,mBAAmB,EAAE,mBAAmB,EACxC,gBAAgB,EAAE,MAAM,GAAG,eAAe,EAC1C,wBAAwB,CAAC,EAAE,OAAO,GACjC,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAUlH;AAED,wBAAsB,wBAAwB,CAC5C,mBAAmB,EAAE,mBAAmB,EACxC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACjF,aAAa,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE;kBAGtD,MAAM,EAAE;oBACN,MAAM,EAAE;aACf,MAAM,EAAE;GAuBpB"}

package/dist/utils/diffDeployedFacets.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffDeployedFacets = diffDeployedFacets;
+exports.printFacetSelectorFunctions = printFacetSelectorFunctions;
+exports.isProtocolInitRegistered = isProtocolInitRegistered;
+exports.compareFacetSelectors = compareFacetSelectors;
+const abi_1 = require("@ethersproject/abi");
+const chalk_1 = __importDefault(require("chalk"));
+const loupe_1 = require("./loupe");
+async function diffDeployedFacets(deployedDiamondData, signerOrProvider, verboseGetDeployedFacets) {
+    const diamondAddress = deployedDiamondData.DiamondAddress;
+    const onChainFacets = await (0, loupe_1.getDeployedFacets)(diamondAddress, signerOrProvider, undefined, verboseGetDeployedFacets);
+    const localFacets = deployedDiamondData.DeployedFacets ?? {};
+    const seen = new Set();
+    let pass = true;
+    console.log(chalk_1.default.magentaBright("\n🔍 Diffing on-chain facets against deployment metadata:\n"));
+    for (const facet of onChainFacets) {
+        const match = Object.entries(localFacets).find(([_, meta]) => meta.address?.toLowerCase() === facet.facetAddress.toLowerCase());
+        if (!match) {
+            console.log(chalk_1.default.red(`  ❌ On-chain facet ${facet.facetAddress} not found in deployment record.`));
+            continue;
+        }
+        const [name, meta] = match;
+        seen.add(name);
+        const expected = meta.funcSelectors ?? [];
+        const actual = facet.functionSelectors;
+        const added = actual.filter((sel) => !expected.includes(sel));
+        const removed = expected.filter(sel => !actual.includes(sel));
+        if (added.length ?? removed.length) {
+            console.log(chalk_1.default.yellow(`  ⚠️ Mismatch in selectors for facet ${name} (${facet.facetAddress})`));
+            if (added.length)
+                console.log(chalk_1.default.green(`    + Added: ${added.join(", ")}`));
+            if (removed.length)
+                console.log(chalk_1.default.red(`    - Missing: ${removed.join(", ")}`));
+        }
+        else {
+            console.log(chalk_1.default.green(`  ✅ ${name} matches.`));
+        }
+    }
+    for (const localFacetName of Object.keys(localFacets)) {
+        if (pass && !seen.has(localFacetName)) {
+            console.log(chalk_1.default.red(`  ❌ Deployed facet ${localFacetName} missing from on-chain state.`));
+            pass = false;
+        }
+    }
+    if (pass) {
+        console.log(chalk_1.default.bgGreenBright("  ✅ All facets exist in deplyoment metadata!"));
+    }
+    else {
+        console.log(chalk_1.default.bgRed("  ❌ Some facets do not match!"));
+    }
+    return pass;
+}
+function printFacetSelectorFunctions(abi, selectors) {
+    const iface = new abi_1.Interface(abi);
+    console.log(chalk_1.default.cyan("\n🔎 Matching selectors to functions:"));
+    for (const selector of selectors) {
+        const fragment = Object.values(iface.functions).find(fn => iface.getSighash(fn) === selector);
+        console.log(`  ${selector} → ${fragment ? fragment.format() : chalk_1.default.gray("unknown")}`);
+    }
+}
+async function isProtocolInitRegistered(deployedDiamondData, protocolInitFacet, initializerSig) {
+    const facet = deployedDiamondData.DeployedFacets?.[protocolInitFacet];
+    console.log(`Checking if ${protocolInitFacet} is registered with ${initializerSig}...`);
+    if (!facet || !facet.funcSelectors)
+        return false;
+    if (!initializerSig) {
+        console.warn(chalk_1.default.yellow(`  ❌ No initializer signature provided for ${protocolInitFacet}.`));
+        return false;
+    }
+    const iface = new abi_1.Interface([`function ${initializerSig}`]);
+    const selector = iface.getSighash(initializerSig);
+    console.log(`  Found selector: ${selector}`);
+    return facet.funcSelectors.includes(selector);
+}
+/**
+ * Compares facet selectors from on-chain DiamondLoupe with local DeployedDiamondData
+ *
+ * @param deployedFacetData - local metadata (facetName -> { address, funcSelectors[] })
+ * @param onChainFacets - list of { facetAddress, functionSelectors[] } from DiamondLoupe
+ * @returns map of facetName -> { extraOnChain[], missingOnChain[], matched[] }
+ */
+function compareFacetSelectors(deployedFacetData, onChainFacets) {
+    const result = {};
+    const addressToName = Object.entries(deployedFacetData).reduce((acc, [name, meta]) => {
+        if (meta.address)
+            acc[meta.address.toLowerCase()] = name;
+        return acc;
+    }, {});
+    for (const { facetAddress, functionSelectors } of onChainFacets) {
+        const lowerAddr = facetAddress.toLowerCase();
+        const name = addressToName[lowerAddr] ?? "unknown";
+        const expected = new Set(deployedFacetData[name]?.funcSelectors ?? []);
+        const actual = new Set(functionSelectors);
+        result[name] = {
+            extraOnChain: [...actual].filter(sel => !expected.has(sel)).sort(),
+            missingOnChain: [...expected].filter(sel => !actual.has(sel)).sort(),
+            matched: [...actual].filter(sel => expected.has(sel)).sort(),
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=diffDeployedFacets.js.map

package/dist/utils/diffDeployedFacets.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,16 @@
+export * from '../repositories/jsonFileHandler';
+export { FileDeploymentRepository } from '../repositories/FileDeploymentRepository';
+export { DeploymentRepository } from '../repositories/DeploymentRepository';
+export * from './common';
+export * from './signer';
+export * from './txlogging';
+export * from './diffDeployedFacets';
+export * from './loupe';
+export * from './defenderStore';
+export * from './defenderClients';
+export * from './contractMapping';
+export * from './configurationResolver';
+export * from './workspaceSetup';
+export * from './diamondAbiGenerator';
+export * from './rpcStore';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentRepository = exports.FileDeploymentRepository = void 0;
+__exportStar(require("../repositories/jsonFileHandler"), exports);
+var FileDeploymentRepository_1 = require("../repositories/FileDeploymentRepository");
+Object.defineProperty(exports, "FileDeploymentRepository", { enumerable: true, get: function () { return FileDeploymentRepository_1.FileDeploymentRepository; } });
+var DeploymentRepository_1 = require("../repositories/DeploymentRepository");
+Object.defineProperty(exports, "DeploymentRepository", { enumerable: true, get: function () { return DeploymentRepository_1.DeploymentRepository; } });
+__exportStar(require("./common"), exports);
+__exportStar(require("./signer"), exports);
+__exportStar(require("./txlogging"), exports);
+__exportStar(require("./diffDeployedFacets"), exports);
+__exportStar(require("./loupe"), exports);
+__exportStar(require("./defenderStore"), exports);
+__exportStar(require("./defenderClients"), exports);
+__exportStar(require("./contractMapping"), exports);
+__exportStar(require("./configurationResolver"), exports);
+__exportStar(require("./workspaceSetup"), exports);
+__exportStar(require("./diamondAbiGenerator"), exports);
+__exportStar(require("./rpcStore"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,qFAAoF;AAA3E,oIAAA,wBAAwB,OAAA;AACjC,6EAA4E;AAAnE,4HAAA,oBAAoB,OAAA;AAC7B,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B;AAC5B,uDAAqC;AACrC,0CAAwB;AACxB,kDAAgC;AAChC,oDAAkC;AAClC,oDAAkC;AAClC,0DAAwC;AACxC,mDAAiC;AACjC,wDAAsC;AACtC,6CAA2B"}