@diamondslab/diamonds 1.0.0

package/dist/utils/loupe.d.ts

@@ -0,0 +1,44 @@
+import '@nomicfoundation/hardhat-ethers';
+import { ContractTransactionResponse, Interface, InterfaceAbi, Provider, Signer, TransactionReceipt } from "ethers";
+/** Optional convenience type for TS consumers (no TypeChain) */
+export interface FacetStruct {
+    facetAddress: string;
+    functionSelectors: string[];
+}
+/**
+ * logDiamondLoupe
+ * • pretty‑prints the transaction receipt
+ * • decodes the logs emitted by the DiamondLoupeFacet
+ * • decodes the logs emitted by the facets that were passed in
+ *  (e.g. the facets that were added/removed)
+ * • prints the decoded events to the console
+ * • returns the transaction receipt
+ * @param tx               The awaited transaction object (e.g. from `contract.fn()`)
+ * @param diamondLoupe     Address of the diamond proxy
+ * @param facetABIs        One or more `ethers.Interface` (or plain ABIs) used to decode
+ *                         the `receipt.logs`.  Pass the primary contract interface first;
+ *                         additional ABIs (e.g. library or facet events) can follow.
+ *                         Pass an empty array if you don’t want to decode any facet events.
+ *                         (e.g. `[]`)
+ *                        (NB: this is not the same as the diamondLoupe address)
+ * @returns              The transaction receipt
+ */
+export declare function logDiamondLoupe(tx: ContractTransactionResponse, diamondLoupe: string, facetABIs?: readonly (InterfaceAbi | Interface)[]): Promise<TransactionReceipt>;
+/**
+ * Fetch the list of deployed facets from a diamond without relying on
+ * TypeChain’s IDiamondLoupe typings.
+ * getDeployedFacets – convenience wrapper around DiamondLoupe.facets()
+ * • fetches the facet list
+ * • pretty‑prints it
+ * • (optionally) calls logDiamondLoupe if you pass a receipt
+ *
+ * @param diamondAddress   Address of the diamond proxy
+ * @param signerOrProvider Signer (for tx) or provider (for read‑only)
+ * @param receiptToDecode  Optional transaction receipt to decode
+ *                         (e.g. from a diamondCut() transaction)
+ * @returns              Array of FacetStruct objects
+ *                       (address + functionSelectors)
+ *                       (see DiamondLoupeFacet.sol)
+ */
+export declare function getDeployedFacets(diamondAddress: string, signerOrProvider?: Signer | Provider, receiptToDecode?: TransactionReceipt, logDeployedFacets?: boolean): Promise<FacetStruct[]>;
+//# sourceMappingURL=loupe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loupe.d.ts","sourceRoot":"","sources":["../../src/utils/loupe.ts"],"names":[],"mappings":"AAAA,OAAO,iCAAiC,CAAC;AAEzC,OAAO,EAAY,2BAA2B,EAAE,SAAS,EAAE,YAAY,EAAuB,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAcnJ,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAKD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,2BAA2B,EAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,EAAO,GACpD,OAAO,CAAC,kBAAkB,CAAC,CAoD7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,gBAAgB,GAAE,MAAM,GAAG,QAA8B,EACzD,eAAe,CAAC,EAAE,kBAAkB,EACpC,iBAAiB,CAAC,EAAE,OAAO,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAoCxB"}

package/dist/utils/loupe.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logDiamondLoupe = logDiamondLoupe;
+exports.getDeployedFacets = getDeployedFacets;
+require("@nomicfoundation/hardhat-ethers");
+const chalk_1 = __importDefault(require("chalk"));
+const ethers_1 = require("ethers");
+const hardhat_1 = __importDefault(require("hardhat"));
+const txlogging_1 = require("./txlogging");
+/** ----------------------------------------------------------------
+ *  Minimal ABI for DiamondLoupeFacet.facets()
+ *  (tuple[] is encoded exactly the same as the struct array returned
+ *   by the real contract, so we can decode it safely.)
+ *  ----------------------------------------------------------------
+ */
+const DIAMOND_LOUPE_ABI = new ethers_1.Interface([
+    "function facets() view returns (tuple(address facetAddress, bytes4[] functionSelectors)[])"
+]);
+// -----------------------------------------------------------------------------
+// logDiamondLoupe ­– decodes *events* that were emitted during a diamondCut()
+// -----------------------------------------------------------------------------
+/**
+ * logDiamondLoupe
+ * • pretty‑prints the transaction receipt
+ * • decodes the logs emitted by the DiamondLoupeFacet
+ * • decodes the logs emitted by the facets that were passed in
+ *  (e.g. the facets that were added/removed)
+ * • prints the decoded events to the console
+ * • returns the transaction receipt
+ * @param tx               The awaited transaction object (e.g. from `contract.fn()`)
+ * @param diamondLoupe     Address of the diamond proxy
+ * @param facetABIs        One or more `ethers.Interface` (or plain ABIs) used to decode
+ *                         the `receipt.logs`.  Pass the primary contract interface first;
+ *                         additional ABIs (e.g. library or facet events) can follow.
+ *                         Pass an empty array if you don’t want to decode any facet events.
+ *                         (e.g. `[]`)
+ *                        (NB: this is not the same as the diamondLoupe address)
+ * @returns              The transaction receipt
+ */
+async function logDiamondLoupe(tx, diamondLoupe, facetABIs = []) {
+    const receipt = await (0, txlogging_1.logTx)(tx, `DiamondLoupe (${diamondLoupe})`, facetABIs.map(abi => abi instanceof ethers_1.Interface ? abi : new ethers_1.Interface(abi)));
+    const iface = Array.isArray(facetABIs) && facetABIs.length
+        ? new ethers_1.Interface(facetABIs.map(i => (i instanceof ethers_1.Interface ? i.fragments : i)).reduce((acc, val) => acc.concat(val), []))
+        : undefined;
+    console.log(chalk_1.default.cyan("\n📜 Decoded Loupe logs:"));
+    if (receipt && receipt.logs) {
+        receipt.logs.forEach((log, idx) => {
+            if (!iface) {
+                console.log(chalk_1.default.dim(`  Event[${idx}] – no ABI supplied`));
+                return;
+            }
+            let parsed;
+            try {
+                const result = iface.parseLog(log);
+                if (result !== null) {
+                    parsed = result;
+                }
+            }
+            catch {
+                /* swallow – this log wasn’t emitted by any of the supplied facets */
+            }
+            if (parsed) {
+                const argsPretty = parsed.args
+                    .map((arg, i) => `${parsed?.fragment.inputs[i].name}: ${arg}`)
+                    .join(", ");
+                console.log(chalk_1.default.yellowBright(`  Event[${idx}]`) +
+                    chalk_1.default.bold(` ${parsed.name}`) +
+                    `  →  ${argsPretty}`);
+            }
+            else {
+                console.log(chalk_1.default.dim(`  Event[${idx}]`) + ` – unable to decode (topic0 = ${log.topics[0]})`);
+            }
+        });
+        return receipt;
+    }
+    // Always return the receipt, even if logs are missing
+    if (!receipt) {
+        throw new Error("Transaction receipt is null");
+    }
+    return receipt;
+}
+/**
+ * Fetch the list of deployed facets from a diamond without relying on
+ * TypeChain’s IDiamondLoupe typings.
+ * getDeployedFacets – convenience wrapper around DiamondLoupe.facets()
+ * • fetches the facet list
+ * • pretty‑prints it
+ * • (optionally) calls logDiamondLoupe if you pass a receipt
+ *
+ * @param diamondAddress   Address of the diamond proxy
+ * @param signerOrProvider Signer (for tx) or provider (for read‑only)
+ * @param receiptToDecode  Optional transaction receipt to decode
+ *                         (e.g. from a diamondCut() transaction)
+ * @returns              Array of FacetStruct objects
+ *                       (address + functionSelectors)
+ *                       (see DiamondLoupeFacet.sol)
+ */
+async function getDeployedFacets(diamondAddress, signerOrProvider = hardhat_1.default.ethers.provider, receiptToDecode, logDeployedFacets) {
+    // Generic ethers.Contract instance built only from the tiny ABI above
+    const loupe = new ethers_1.Contract(diamondAddress, DIAMOND_LOUPE_ABI, signerOrProvider);
+    // NB: cast is just to help TS‑users downstream; at runtime this is the raw array
+    const facets = (await loupe.facets());
+    if (logDeployedFacets === true) {
+        console.log(chalk_1.default.magentaBright("\n🔍 Currently deployed facets (via DiamondLoupe):"));
+        facets.forEach((f, i) => {
+            console.log(chalk_1.default.blueBright(`  [${i.toString().padStart(2, "0")}]  ${chalk_1.default.bold(f.facetAddress)}  –  ${f.functionSelectors.length} selector${f.functionSelectors.length === 1 ? "" : "s"}`));
+            f.functionSelectors.forEach((s, j) => {
+                console.log(`    ${j.toString().padStart(2, "0")}:  ${s}`);
+            });
+            console.log();
+        });
+    }
+    // If the caller supplied a receipt from a recent diamondCut, decode it too
+    if (receiptToDecode) {
+        await logDiamondLoupe(
+        // fabricate a ContractTransaction‑like object so logDiamondLoupe
+        // can stay reception‑agnostic
+        {
+            ...receiptToDecode,
+            wait: async () => receiptToDecode,
+        }, diamondAddress, [loupe.interface]);
+    }
+    return facets;
+}
+//# sourceMappingURL=loupe.js.map

package/dist/utils/loupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loupe.js","sourceRoot":"","sources":["../../src/utils/loupe.ts"],"names":[],"mappings":";;;;;AA2CA,0CAwDC;AAkBD,8CAyCC;AA9JD,2CAAyC;AACzC,kDAA0B;AAC1B,mCAAmJ;AACnJ,sDAA0B;AAC1B,2CAAoC;AAEpC;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,IAAI,kBAAS,CAAC;IACtC,4FAA4F;CAC7F,CAAC,CAAC;AAQH,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF;;;;;;;;;;;;;;;;;GAiBG;AACI,KAAK,UAAU,eAAe,CACnC,EAA+B,EAC/B,YAAoB,EACpB,YAAmD,EAAE;IAErD,MAAM,OAAO,GAAG,MAAM,IAAA,iBAAK,EAAC,EAAE,EAAE,iBAAiB,YAAY,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,kBAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,kBAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE7I,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM;QACxD,CAAC,CAAC,IAAI,kBAAS,CACb,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,kBAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CACzG;QACD,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACpD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,GAAW,EAAE,EAAE;YAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,WAAW,GAAG,qBAAqB,CAAC,CAAC,CAAC;gBAC5D,OAAO;YACT,CAAC;YAED,IAAI,MAAkC,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACnC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,MAAM,GAAG,MAAM,CAAC;gBAClB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI;qBAC3B,GAAG,CAAC,CAAC,GAAY,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;qBAC9E,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,YAAY,CAAC,WAAW,GAAG,GAAG,CAAC;oBACrC,eAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC7B,QAAQ,UAAU,EAAE,CACrB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,iCAAiC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CACjF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,iBAAiB,CACrC,cAAsB,EACtB,mBAAsC,iBAAG,CAAC,MAAM,CAAC,QAAQ,EACzD,eAAoC,EACpC,iBAA2B;IAE3B,sEAAsE;IACtE,MAAM,KAAK,GAAG,IAAI,iBAAQ,CAAC,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IAEhF,iFAAiF;IACjF,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAkB,CAAC;IAEvD,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,aAAa,CAAC,oDAAoD,CAAC,CAAC,CAAC;QACvF,MAAM,CAAC,OAAO,CAAC,CAAC,CAAwD,EAAE,CAAS,EAAE,EAAE;YACrF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,UAAU,CAC1B,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,eAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,MAC/F,YAAY,CAAC,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAC1D,CAAC,CAAC;YACH,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE;gBACnD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7D,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,eAAe;QACnB,iEAAiE;QACjE,8BAA8B;QAC9B;YACE,GAAG,eAAe;YAClB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,eAAe;SACQ,EAC3C,cAAc,EACd,CAAC,KAAK,CAAC,SAAS,CAAC,CAClB,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/rpcStore.d.ts

@@ -0,0 +1,36 @@
+import { RPCDeploymentRegistry, RPCStepStatus, RPCStepRecord } from '../types/rpc';
+/**
+ * Step-by-step deployment store for RPC-based deployments
+ * Similar to DefenderDeploymentStore but for RPC deployments
+ */
+export declare class RPCDeploymentStore {
+    private readonly filePath;
+    private readonly diamondName;
+    private readonly deploymentId;
+    constructor(diamondName: string, deploymentId: string, baseDir?: string);
+    private loadRegistry;
+    private saveRegistry;
+    initializeDeployment(network: string, chainId: number, rpcUrl: string, deployerAddress: string): void;
+    saveStep(step: RPCStepRecord): void;
+    getStep(stepName: string): RPCStepRecord | undefined;
+    updateStatus(stepName: string, status: RPCStepStatus, txHash?: string, contractAddress?: string, error?: string): void;
+    list(): RPCStepRecord[];
+    getRegistry(): RPCDeploymentRegistry;
+    isStepCompleted(stepName: string): boolean;
+    isStepFailed(stepName: string): boolean;
+    getCompletedSteps(): RPCStepRecord[];
+    getFailedSteps(): RPCStepRecord[];
+    getPendingSteps(): RPCStepRecord[];
+    markDeploymentComplete(): void;
+    markDeploymentFailed(error: string): void;
+    clearFailedSteps(): void;
+    getDeploymentSummary(): {
+        total: number;
+        completed: number;
+        failed: number;
+        pending: number;
+        isComplete: boolean;
+        hasFailed: boolean;
+    };
+}
+//# sourceMappingURL=rpcStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpcStore.d.ts","sourceRoot":"","sources":["../../src/utils/rpcStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnF;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAmB;IAQnF,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAKb,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IASrG,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAWnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAatH,IAAI,IAAI,aAAa,EAAE;IAIvB,WAAW,IAAI,qBAAqB;IAIpC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK1C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKvC,iBAAiB,IAAI,aAAa,EAAE;IAIpC,cAAc,IAAI,aAAa,EAAE;IAIjC,eAAe,IAAI,aAAa,EAAE;IAIlC,sBAAsB,IAAI,IAAI;IAM9B,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzC,gBAAgB,IAAI,IAAI;IAMxB,oBAAoB,IAAI;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB;CAeF"}

package/dist/utils/rpcStore.js

@@ -0,0 +1,166 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPCDeploymentStore = void 0;
+const path_1 = require("path");
+const fs = __importStar(require("fs-extra"));
+/**
+ * Step-by-step deployment store for RPC-based deployments
+ * Similar to DefenderDeploymentStore but for RPC deployments
+ */
+class RPCDeploymentStore {
+    filePath;
+    diamondName;
+    deploymentId;
+    constructor(diamondName, deploymentId, baseDir = 'diamonds') {
+        this.diamondName = diamondName;
+        this.deploymentId = deploymentId;
+        const registryDir = (0, path_1.join)(baseDir, diamondName, 'deployments', 'rpc');
+        fs.ensureDirSync(registryDir);
+        this.filePath = (0, path_1.join)(registryDir, `${deploymentId}.json`);
+    }
+    loadRegistry() {
+        if (!fs.existsSync(this.filePath)) {
+            return {
+                diamondName: this.diamondName,
+                deploymentId: this.deploymentId,
+                network: '',
+                chainId: 0,
+                rpcUrl: '',
+                deployerAddress: '',
+                steps: [],
+                startedAt: Date.now(),
+                lastUpdated: Date.now()
+            };
+        }
+        return fs.readJSONSync(this.filePath);
+    }
+    saveRegistry(registry) {
+        registry.lastUpdated = Date.now();
+        fs.writeJSONSync(this.filePath, registry, { spaces: 2 });
+    }
+    initializeDeployment(network, chainId, rpcUrl, deployerAddress) {
+        const registry = this.loadRegistry();
+        registry.network = network;
+        registry.chainId = chainId;
+        registry.rpcUrl = rpcUrl;
+        registry.deployerAddress = deployerAddress;
+        this.saveRegistry(registry);
+    }
+    saveStep(step) {
+        const registry = this.loadRegistry();
+        const existing = registry.steps.find(s => s.stepName === step.stepName);
+        if (existing) {
+            Object.assign(existing, step);
+        }
+        else {
+            registry.steps.push(step);
+        }
+        this.saveRegistry(registry);
+    }
+    getStep(stepName) {
+        return this.loadRegistry().steps.find(s => s.stepName === stepName);
+    }
+    updateStatus(stepName, status, txHash, contractAddress, error) {
+        const registry = this.loadRegistry();
+        const step = registry.steps.find(s => s.stepName === stepName);
+        if (step) {
+            step.status = status;
+            step.timestamp = Date.now();
+            if (txHash)
+                step.txHash = txHash;
+            if (contractAddress)
+                step.contractAddress = contractAddress;
+            if (error)
+                step.error = error;
+            this.saveRegistry(registry);
+        }
+    }
+    list() {
+        return this.loadRegistry().steps;
+    }
+    getRegistry() {
+        return this.loadRegistry();
+    }
+    isStepCompleted(stepName) {
+        const step = this.getStep(stepName);
+        return step?.status === 'completed';
+    }
+    isStepFailed(stepName) {
+        const step = this.getStep(stepName);
+        return step?.status === 'failed';
+    }
+    getCompletedSteps() {
+        return this.list().filter(s => s.status === 'completed');
+    }
+    getFailedSteps() {
+        return this.list().filter(s => s.status === 'failed');
+    }
+    getPendingSteps() {
+        return this.list().filter(s => s.status === 'pending' || s.status === 'in_progress');
+    }
+    markDeploymentComplete() {
+        const registry = this.loadRegistry();
+        registry.completedAt = Date.now();
+        this.saveRegistry(registry);
+    }
+    markDeploymentFailed(error) {
+        const registry = this.loadRegistry();
+        registry.failedAt = Date.now();
+        registry.lastError = error;
+        this.saveRegistry(registry);
+    }
+    clearFailedSteps() {
+        const registry = this.loadRegistry();
+        registry.steps = registry.steps.filter(s => s.status !== 'failed');
+        this.saveRegistry(registry);
+    }
+    getDeploymentSummary() {
+        const steps = this.list();
+        const completed = steps.filter(s => s.status === 'completed').length;
+        const failed = steps.filter(s => s.status === 'failed').length;
+        const pending = steps.filter(s => s.status === 'pending' || s.status === 'in_progress').length;
+        return {
+            total: steps.length,
+            completed,
+            failed,
+            pending,
+            isComplete: failed === 0 && pending === 0 && completed > 0,
+            hasFailed: failed > 0
+        };
+    }
+}
+exports.RPCDeploymentStore = RPCDeploymentStore;
+//# sourceMappingURL=rpcStore.js.map

package/dist/utils/rpcStore.js.map

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

package/dist/utils/signer.d.ts

@@ -0,0 +1,36 @@
+import { JsonRpcProvider, Signer } from 'ethers';
+import '@nomicfoundation/hardhat-ethers';
+import { HardhatEthersProvider } from '@nomicfoundation/hardhat-ethers/internal/hardhat-ethers-provider';
+/**
+ * Impersonates a signer account. This is primarily used in Hardhat's testing environment
+ * to simulate actions from accounts that are not part of the default test accounts.
+ *
+ * @param signerAddress - The address of the account to impersonate.
+ * @returns The impersonated signer object.
+ */
+export declare function impersonateSigner(signerAddress: string, provider: JsonRpcProvider): Promise<Signer>;
+/**
+ * Sets the Ether balance for a specified address in the Hardhat testing environment.
+ * This is useful for ensuring test accounts have sufficient funds for transactions.
+ *
+ * @param address - The address to set the Ether balance for.
+ * @param amount - The desired balance as a `BigNumber`.
+ */
+export declare function setEtherBalance(address: string, amount: bigint, provider: JsonRpcProvider): Promise<void>;
+/**
+ * Impersonates the deployer account and funds it to a balance that is rounded to the next highest 100 ETH.
+ *
+ * @param provider - The ethers provider instance.
+ * @param deployerAddress - The address of the deployer account.
+ * @param balance - The balance to set for the deployer account (in hex format).
+ */
+export declare function impersonateAndFundSigner(deployerAddress: string, provider: JsonRpcProvider | HardhatEthersProvider): Promise<Signer>;
+/**
+ * Updates the owner of the contract at the specified root address for testing purposes.
+ * This involves transferring ownership from the current owner to the default signer in the Hardhat environment.
+ *
+ * @param rootAddress - The address of the root contract (e.g., GeniusOwnershipFacet).
+ * @returns The address of the old owner.
+ */
+export declare const updateOwnerForTest: (rootAddress: string, provider: JsonRpcProvider) => Promise<any>;
+//# sourceMappingURL=signer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/utils/signer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,iCAAiC,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kEAAkE,CAAC;AAEzG;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzG;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,iBAK/F;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB1I;AAGD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAU,aAAa,MAAM,EAAE,UAAU,eAAe,iBA0BtF,CAAC"}

package/dist/utils/signer.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateOwnerForTest = void 0;
+exports.impersonateSigner = impersonateSigner;
+exports.setEtherBalance = setEtherBalance;
+exports.impersonateAndFundSigner = impersonateAndFundSigner;
+const hardhat_1 = __importDefault(require("hardhat"));
+const common_1 = require("./common");
+require("@nomicfoundation/hardhat-ethers");
+/**
+ * Impersonates a signer account. This is primarily used in Hardhat's testing environment
+ * to simulate actions from accounts that are not part of the default test accounts.
+ *
+ * @param signerAddress - The address of the account to impersonate.
+ * @returns The impersonated signer object.
+ */
+async function impersonateSigner(signerAddress, provider) {
+    // Request Hardhat to impersonate the account at the specified address
+    await provider.send("hardhat_impersonateAccount", [signerAddress]);
+    return provider.getSigner(signerAddress); // Return the impersonated signer
+}
+/**
+ * Sets the Ether balance for a specified address in the Hardhat testing environment.
+ * This is useful for ensuring test accounts have sufficient funds for transactions.
+ *
+ * @param address - The address to set the Ether balance for.
+ * @param amount - The desired balance as a `BigNumber`.
+ */
+async function setEtherBalance(address, amount, provider) {
+    await provider.send('hardhat_setBalance', [
+        address, // Address to modify the balance of
+        '0x' + amount.toString(16), // Amount to set, formatted as a hex string
+    ]);
+}
+/**
+ * Impersonates the deployer account and funds it to a balance that is rounded to the next highest 100 ETH.
+ *
+ * @param provider - The ethers provider instance.
+ * @param deployerAddress - The address of the deployer account.
+ * @param balance - The balance to set for the deployer account (in hex format).
+ */
+async function impersonateAndFundSigner(deployerAddress, provider) {
+    try {
+        await provider.send('hardhat_impersonateAccount', [deployerAddress]);
+        const signer = provider.getSigner(deployerAddress);
+        // Fund the account
+        await provider.send('hardhat_setBalance', [deployerAddress, '0x56BC75E2D63100000']);
+        return signer;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Impersonation and funding failed for ${deployerAddress}: ${error.message}`);
+        }
+        else {
+            console.error(`Impersonation and funding failed for ${deployerAddress}: ${String(error)}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Updates the owner of the contract at the specified root address for testing purposes.
+ * This involves transferring ownership from the current owner to the default signer in the Hardhat environment.
+ *
+ * @param rootAddress - The address of the root contract (e.g., GeniusOwnershipFacet).
+ * @returns The address of the old owner.
+ */
+const updateOwnerForTest = async (rootAddress, provider) => {
+    // Retrieve the current signer in the Hardhat environment
+    const curOwner = (await hardhat_1.default.ethers.getSigners())[0];
+    // Get a reference to the GeniusOwnershipFacet contract at the specified root address
+    const ownership = await hardhat_1.default.ethers.getContractAt('GeniusOwnershipFacet', rootAddress);
+    // Retrieve the current owner of the contract
+    const oldOwnerAddress = await ownership.owner();
+    // Impersonate the old owner
+    const oldOwner = await impersonateSigner(oldOwnerAddress, provider);
+    // If the old owner is not the current signer, transfer ownership to the current signer
+    if (oldOwnerAddress !== curOwner.address) {
+        debuglog(`Transferring ownership from ${oldOwnerAddress}`);
+        // Ensure the old owner has enough Ether to perform the ownership transfer
+        await setEtherBalance(oldOwnerAddress, (0, common_1.toWei)(10), provider);
+        await ownership.connect(await oldOwner).transferOwnership(curOwner.address);
+        await ownership.connect(oldOwner).transferOwnership(curOwner.address);
+    }
+    // Return the address of the old owner
+    return oldOwnerAddress;
+};
+exports.updateOwnerForTest = updateOwnerForTest;
+//# sourceMappingURL=signer.js.map

package/dist/utils/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../src/utils/signer.ts"],"names":[],"mappings":";;;;;;AAaA,8CAIC;AASD,0CAKC;AASD,4DAgBC;AAxDD,sDAA0B;AAC1B,qCAAiC;AAEjC,2CAAyC;AAGzC;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,QAAyB;IACtF,sEAAsE;IACtE,MAAM,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,iCAAiC;AAC7E,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,eAAe,CAAC,OAAe,EAAE,MAAc,EAAE,QAAyB;IAC9F,MAAM,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE;QACxC,OAAO,EAAE,mCAAmC;QAC5C,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,2CAA2C;KACxE,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,wBAAwB,CAAC,eAAuB,EAAE,QAAiD;IACvH,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAEnD,mBAAmB;QACnB,MAAM,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,wCAAwC,eAAe,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,wCAAwC,eAAe,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAGD;;;;;;GAMG;AACI,MAAM,kBAAkB,GAAG,KAAK,EAAE,WAAmB,EAAE,QAAyB,EAAE,EAAE;IACzF,yDAAyD;IACzD,MAAM,QAAQ,GAAG,CAAC,MAAM,iBAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,qFAAqF;IACrF,MAAM,SAAS,GAAG,MAAM,iBAAG,CAAC,MAAM,CAAC,aAAa,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;IAEtF,6CAA6C;IAC7C,MAAM,eAAe,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAEhD,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAEpE,uFAAuF;IACvF,IAAI,eAAe,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QACzC,QAAQ,CAAC,+BAA+B,eAAe,EAAE,CAAC,CAAC;QAE3D,0EAA0E;QAC1E,MAAM,eAAe,CAAC,eAAe,EAAE,IAAA,cAAK,EAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QAE5D,MAAO,SAAiB,CAAC,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrF,MAAO,SAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,sCAAsC;IACtC,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AA1BW,QAAA,kBAAkB,sBA0B7B"}

package/dist/utils/txlogging.d.ts

@@ -0,0 +1,13 @@
+import "@nomicfoundation/hardhat-ethers";
+import { ContractTransactionResponse, Interface, InterfaceAbi, TransactionReceipt } from "ethers";
+/**
+ * Pretty‑prints a transaction receipt **and** decodes its logs.
+ *
+ * @param tx               The awaited transaction object (e.g. from `contract.fn()`)
+ * @param description      Optional label that will be shown in the console header.
+ * @param interfaces       One or more `ethers.Interface` (or plain ABIs) used to decode
+ *                         the `receipt.logs`.  Pass the primary contract interface first;
+ *                         additional ABIs (e.g. library or facet events) can follow.
+ */
+export declare function logTx(tx: ContractTransactionResponse, description?: string, interfaces?: (Interface | InterfaceAbi)[]): Promise<TransactionReceipt>;
+//# sourceMappingURL=txlogging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"txlogging.d.ts","sourceRoot":"","sources":["../../src/utils/txlogging.ts"],"names":[],"mappings":"AAIA,OAAO,iCAAiC,CAAC;AAEzC,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,YAAY,EAAuB,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAIvH;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CACzB,EAAE,EAAE,2BAA2B,EAC/B,WAAW,SAAK,EAChB,UAAU,GAAE,CAAC,SAAS,GAAG,YAAY,CAAC,EAAO,GAE5C,OAAO,CAAC,kBAAkB,CAAC,CAwE7B"}

package/dist/utils/txlogging.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logTx = logTx;
+// ──────────────────────────────────────────────────────────────────────────────
+//  txLogging.ts
+//  Extra helpers for inspecting diamond‑cut transactions
+// ──────────────────────────────────────────────────────────────────────────────
+require("@nomicfoundation/hardhat-ethers");
+const chalk_1 = __importDefault(require("chalk"));
+const ethers_1 = require("ethers");
+const hardhat_1 = __importDefault(require("hardhat"));
+/**
+ * Pretty‑prints a transaction receipt **and** decodes its logs.
+ *
+ * @param tx               The awaited transaction object (e.g. from `contract.fn()`)
+ * @param description      Optional label that will be shown in the console header.
+ * @param interfaces       One or more `ethers.Interface` (or plain ABIs) used to decode
+ *                         the `receipt.logs`.  Pass the primary contract interface first;
+ *                         additional ABIs (e.g. library or facet events) can follow.
+ */
+async function logTx(tx, description = "", interfaces = []) {
+    // normalise incoming interfaces => ethers.Interface
+    const decoders = interfaces.map((i) => i instanceof ethers_1.Interface ? i : new ethers_1.Interface(i));
+    const receipt = await tx.wait();
+    if (!receipt) {
+        throw new Error("Transaction receipt is null");
+    }
+    /* --------------------------- basic tx statistics -------------------------- */
+    console.log(chalk_1.default.green(`\n⛓️  Transaction Details${description ? ` – ${description}` : ""}`));
+    console.table({
+        Hash: tx.hash,
+        Status: receipt.status === 1 ? "Success" : "Failed",
+        Block: receipt.blockNumber,
+        From: receipt.from,
+        To: receipt.to,
+        "Tx Index": receipt.transactionIndex ?? receipt.index ?? "N/A",
+        "Gas Used": receipt.gasUsed.toString(),
+        "Cumulative Gas": receipt.cumulativeGasUsed.toString(),
+        "Gas Price": receipt.gasPrice?.toString() ?? "N/A",
+        "Block Hash": receipt.blockHash,
+        "Confirmations": receipt.confirmations,
+        "Timestamp": receipt.blockNumber
+            ? new Date(((await tx.wait().then(() => hardhat_1.default.ethers.provider.getBlock(receipt.blockNumber))) ?? { timestamp: 0 }).timestamp * 1000).toLocaleString()
+            : "N/A",
+        "Created Contract": receipt.contractAddress ?? "N/A",
+        "Created By": receipt.from,
+        Events: receipt.logs.length,
+    });
+    /* ----------------------------- decode events ------------------------------ */
+    if (receipt.logs.length === 0)
+        return receipt;
+    console.log(chalk_1.default.cyan("\n📜 Decoded events:"));
+    receipt.logs.forEach((log, idx) => {
+        let parsed;
+        for (const iface of decoders) {
+            try {
+                const result = iface.parseLog(log);
+                if (result !== null) {
+                    parsed = result;
+                    break; // stop at first successful decoder
+                }
+            }
+            catch (_) {
+                /* ignore and try next */
+            }
+        }
+        if (parsed) {
+            const argsPretty = parsed.args
+                .map((arg, i) => {
+                const key = parsed?.fragment.inputs[i].name;
+                return `${key ? key + ": " : ""}${arg}`;
+            })
+                .join(", ");
+            console.log(chalk_1.default.yellowBright(`  Event[${idx}]`) +
+                chalk_1.default.bold(` ${parsed.name}`) +
+                `  →  ${argsPretty}`);
+        }
+        else {
+            console.log(chalk_1.default.dim(`  Event[${idx}]`) + ` – unable to decode (topic0 = ${log.topics[0]})`);
+        }
+    });
+    return receipt;
+}
+//# sourceMappingURL=txlogging.js.map