glamsterdam-compat-lab 0.2.2

package/dist/cli.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { Command } from "commander";
+import { combineReports, defaultClientMatrixPath, defaultThresholdsPath, loadEipRegistry, renderJsonReport, renderMarkdownReport, scanBytecode, scanIndexer, scanTraceFile, scanValidatorConfig, validateCompatibilityReport, fetchAndScanTransactionTrace, writeFetchedTrace } from "./index.js";
+import { TOOL_VERSION } from "./reports/reportTypes.js";
+import { parseDebugTraceMode } from "./scanners/rpcTraceScanner.js";
+const program = new Command();
+program
+    .name("glamsterdam")
+    .description("Glamsterdam Compatibility Lab CLI")
+    .version(TOOL_VERSION);
+program
+    .command("scan-bytecode")
+    .argument("<path-or-hex>", "EVM bytecode file path or inline hex string")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .option("--thresholds <path>", "Path to detector thresholds JSON", defaultThresholdsPath())
+    .description("Analyze EVM bytecode for conservative Glamsterdam compatibility prompts")
+    .action((pathOrHex, options) => {
+    const report = scanBytecode(pathOrHex, { registryPath: options.registry, thresholdsPath: options.thresholds });
+    writeReport(report, parseFormat(options.format));
+});
+program
+    .command("scan-traces")
+    .argument("<trace-json-file>", "Trace JSON file")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .option("--thresholds <path>", "Path to detector thresholds JSON", defaultThresholdsPath())
+    .description("Analyze transaction traces for state-heavy, creation-heavy, calldata, log, and call patterns")
+    .action((traceFile, options) => {
+    const report = scanTraceFile(traceFile, { registryPath: options.registry, thresholdsPath: options.thresholds });
+    writeReport(report, parseFormat(options.format));
+});
+program
+    .command("scan-tx")
+    .requiredOption("--tx <hash>", "Transaction hash to fetch with debug_traceTransaction")
+    .option("--rpc-url <url>", "Execution RPC URL. Defaults to ETH_RPC_URL when omitted")
+    .option("--tracer <mode>", "Trace mode: structLogs or callTracer", "structLogs")
+    .option("--trace-timeout <duration>", "Execution client trace timeout hint", "30s")
+    .option("--rpc-timeout-ms <ms>", "HTTP RPC timeout in milliseconds", "30000")
+    .option("--trace-out <path>", "Write the fetched JSON-RPC trace response to a file")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .option("--thresholds <path>", "Path to detector thresholds JSON", defaultThresholdsPath())
+    .description("Fetch debug_traceTransaction from an RPC endpoint and scan the returned trace")
+    .action(async (options) => {
+    const rpcUrl = options.rpcUrl ?? process.env.ETH_RPC_URL;
+    if (!rpcUrl) {
+        throw new Error("Provide --rpc-url or set ETH_RPC_URL.");
+    }
+    const result = await fetchAndScanTransactionTrace({
+        rpcUrl,
+        txHash: options.tx,
+        tracer: parseDebugTraceMode(options.tracer),
+        traceTimeout: options.traceTimeout,
+        rpcTimeoutMs: parsePositiveInteger(options.rpcTimeoutMs, "--rpc-timeout-ms"),
+        registryPath: options.registry,
+        thresholdsPath: options.thresholds
+    });
+    if (options.traceOut) {
+        writeFetchedTrace(result.trace, options.traceOut);
+    }
+    writeReport(result.report, parseFormat(options.format));
+});
+program
+    .command("scan-indexer")
+    .argument("<path>", "Indexer, explorer, or subgraph config path")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .option("--thresholds <path>", "Path to detector thresholds JSON", defaultThresholdsPath())
+    .description("Analyze JSON/YAML indexer configuration with heuristic compatibility checks")
+    .action((path, options) => {
+    const report = scanIndexer(path, { registryPath: options.registry, thresholdsPath: options.thresholds });
+    writeReport(report, parseFormat(options.format));
+});
+program
+    .command("scan-validator")
+    .requiredOption("--config <path>", "Validator/operator config JSON or YAML")
+    .option("--client-matrix <path>", "Client compatibility matrix JSON", defaultClientMatrixPath())
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .option("--thresholds <path>", "Path to detector thresholds JSON", defaultThresholdsPath())
+    .description("Analyze validator/operator readiness from local config and user-editable compatibility data")
+    .action((options) => {
+    const report = scanValidatorConfig(options.config, {
+        registryPath: options.registry,
+        thresholdsPath: options.thresholds,
+        clientMatrixPath: options.clientMatrix
+    });
+    writeReport(report, parseFormat(options.format));
+});
+program
+    .command("eips")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .option("--registry <path>", "Path to Glamsterdam EIP registry JSON")
+    .description("Print the loaded Glamsterdam EIP registry")
+    .action((options) => {
+    const registry = loadEipRegistry(options.registry);
+    const format = parseFormat(options.format);
+    process.stdout.write(format === "json" ? `${JSON.stringify(registry, null, 2)}\n` : renderEipRegistry(registry));
+});
+program
+    .command("report")
+    .argument("[reports...]", "JSON report files generated with --format json")
+    .option("--format <format>", "Output format: markdown or json", "markdown")
+    .description("Combine multiple saved JSON scan reports into one report")
+    .action((reports, options) => {
+    if (reports.length === 0) {
+        throw new Error("Provide at least one JSON report file to combine.");
+    }
+    const parsedReports = reports.map((path) => validateCompatibilityReport(JSON.parse(readFileSync(path, "utf8"))));
+    writeReport(combineReports(parsedReports), parseFormat(options.format));
+});
+program.parseAsync(process.argv).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`Error: ${message}\n`);
+    process.exitCode = 1;
+});
+function writeReport(report, format) {
+    process.stdout.write(format === "json" ? renderJsonReport(report) : renderMarkdownReport(report));
+}
+function parseFormat(format) {
+    if (format === "markdown" || format === "json") {
+        return format;
+    }
+    throw new Error(`Unsupported format "${format}". Use "markdown" or "json".`);
+}
+function parsePositiveInteger(value, name) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive integer.`);
+    }
+    return parsed;
+}
+function renderEipRegistry(registry) {
+    const lines = [];
+    lines.push("# Glamsterdam EIP Registry");
+    lines.push("");
+    lines.push(`Fork: ${registry.fork}`);
+    lines.push(`Last updated: ${registry.lastUpdated}`);
+    lines.push("");
+    lines.push("## Sources");
+    lines.push("");
+    for (const source of registry.sources) {
+        lines.push(`- ${source}`);
+    }
+    lines.push("");
+    lines.push("## Entries");
+    lines.push("");
+    for (const entry of registry.eips) {
+        lines.push(`### ${entry.id}: ${entry.name}`);
+        lines.push("");
+        lines.push(`Status: ${entry.status}`);
+        lines.push(`Domain: ${entry.domain.join(", ")}`);
+        lines.push(`Detector modules: ${entry.detectors.length > 0 ? entry.detectors.join(", ") : "none"}`);
+        if (entry.notes) {
+            lines.push(`Notes: ${entry.notes}`);
+        }
+        lines.push("");
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/detectors/balDetectors.d.ts

@@ -0,0 +1,3 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export declare function detectMissingBalIndexerPlan(configText: string, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/balDetectors.js

@@ -0,0 +1,26 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+export function detectMissingBalIndexerPlan(configText, context) {
+    const lower = configText.toLowerCase();
+    const mentionsBal = lower.includes("block-level access")
+        || lower.includes("block level access")
+        || lower.includes("blocklevelaccess")
+        || lower.includes("eip-7928")
+        || /\bbals?\b/.test(lower);
+    if (mentionsBal) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "indexer.missing-bal-readiness-metadata",
+            title: "No explicit Block-Level Access List readiness metadata found",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("indexer", "monitoring"),
+            relatedEips: relatedEipsForDetector(context.registry, "balDetectors", ["EIP-7928"]),
+            description: "The configuration does not mention BALs or EIP-7928. Static config cannot prove whether the indexer is incompatible, but explorer and indexer teams should explicitly track BAL ingestion and monitoring assumptions.",
+            evidence: ["No BAL/EIP-7928 marker found in configuration text."],
+            recommendation: "Add fork-readiness metadata documenting whether BAL-related block data is ignored, stored, displayed, monitored, or replay-tested."
+        })
+    ];
+}
+//# sourceMappingURL=balDetectors.js.map

package/dist/detectors/balDetectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balDetectors.js","sourceRoot":"","sources":["../../src/detectors/balDetectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAGhG,MAAM,UAAU,2BAA2B,CAAC,UAAkB,EAAE,OAAwB;IACtF,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC;WACnD,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC;WACpC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;WAClC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;WAC1B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,WAAW,CAAC;YACV,EAAE,EAAE,wCAAwC;YAC5C,KAAK,EAAE,8DAA8D;YACrE,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;YACxC,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;YACnF,WAAW,EACT,uNAAuN;YACzN,QAAQ,EAAE,CAAC,qDAAqD,CAAC;YACjE,cAAc,EACZ,oIAAoI;SACvI,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/detectors/contractSizeDetectors.d.ts

@@ -0,0 +1,3 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export declare function detectContractSize(byteLength: number, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/contractSizeDetectors.js

@@ -0,0 +1,37 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+export function detectContractSize(byteLength, context) {
+    const relatedEips = relatedEipsForDetector(context.registry, "contractSizeDetectors", ["EIP-7954"]);
+    const { currentRuntimeLimitBytes, nearCurrentLimitBytes } = context.thresholds.bytecode.contractSize;
+    if (byteLength > currentRuntimeLimitBytes) {
+        return [
+            makeFinding({
+                id: "bytecode.contract-size-over-current-limit",
+                title: "Bytecode exceeds the current deployed contract size limit",
+                severity: "high",
+                confidence: "high",
+                domain: domains("contracts", "execution"),
+                relatedEips,
+                description: "The bytecode is larger than the current EIP-170 deployed runtime size limit. Glamsterdam includes considered work around contract-size limits, but this scanner does not assume a final new limit.",
+                evidence: [{ byteLength, currentRuntimeLimitBytes }],
+                recommendation: "Confirm whether this input is runtime bytecode or init code. Track the registry entry for contract-size changes and test deployment/runtime behavior against a Glamsterdam devnet or fork configuration when available."
+            })
+        ];
+    }
+    if (byteLength >= nearCurrentLimitBytes) {
+        return [
+            makeFinding({
+                id: "bytecode.contract-size-near-current-limit",
+                title: "Bytecode is near the current deployed contract size limit",
+                severity: "medium",
+                confidence: "high",
+                domain: domains("contracts", "execution"),
+                relatedEips,
+                description: "The bytecode is close to today's deployed runtime size limit. Contract-size proposals may change what is possible, but large bytecode still deserves deployment and tooling review.",
+                evidence: [{ byteLength, currentRuntimeLimitBytes }],
+                recommendation: "Add this contract to fork-readiness tests and verify deployment, verification, explorer, and build-pipeline behavior under any Glamsterdam devnet configuration."
+            })
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=contractSizeDetectors.js.map

package/dist/detectors/contractSizeDetectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractSizeDetectors.js","sourceRoot":"","sources":["../../src/detectors/contractSizeDetectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAGhG,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,OAAwB;IAC7E,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,uBAAuB,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACpG,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;IAErG,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC1C,OAAO;YACL,WAAW,CAAC;gBACV,EAAE,EAAE,2CAA2C;gBAC/C,KAAK,EAAE,2DAA2D;gBAClE,QAAQ,EAAE,MAAM;gBAChB,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;gBACzC,WAAW;gBACX,WAAW,EACT,oMAAoM;gBACtM,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,wBAAwB,EAAE,CAAC;gBACpD,cAAc,EACZ,yNAAyN;aAC5N,CAAC;SACH,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,IAAI,qBAAqB,EAAE,CAAC;QACxC,OAAO;YACL,WAAW,CAAC;gBACV,EAAE,EAAE,2CAA2C;gBAC/C,KAAK,EAAE,2DAA2D;gBAClE,QAAQ,EAAE,QAAQ;gBAClB,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;gBACzC,WAAW;gBACX,WAAW,EACT,qLAAqL;gBACvL,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,wBAAwB,EAAE,CAAC;gBACpD,cAAc,EACZ,kKAAkK;aACrK,CAAC;SACH,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/detectors/epbsDetectors.d.ts

@@ -0,0 +1,7 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export interface BuilderConfigEvidence {
+    builderEnabled?: unknown;
+    builderEndpoint?: unknown;
+}
+export declare function detectEpbsBuilderReadiness(evidence: BuilderConfigEvidence, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/epbsDetectors.js

@@ -0,0 +1,33 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+export function detectEpbsBuilderReadiness(evidence, context) {
+    const findings = [];
+    const relatedEips = relatedEipsForDetector(context.registry, "epbsDetectors", ["EIP-7732"]);
+    if (evidence.builderEnabled === undefined) {
+        findings.push(makeFinding({
+            id: "validator.missing-builder-metadata",
+            title: "Builder/API configuration metadata is missing",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("validator", "builder", "consensus"),
+            relatedEips,
+            description: "The operator config does not say whether builder/API functionality is enabled. ePBS readiness requires operators to know which builder-related settings are intentional.",
+            evidence,
+            recommendation: "Record whether builder integration is enabled, disabled, or intentionally not applicable, and include the endpoint metadata used in staging/testnet environments."
+        }));
+    }
+    if (evidence.builderEnabled === true && !evidence.builderEndpoint) {
+        findings.push(makeFinding({
+            id: "validator.builder-enabled-without-endpoint",
+            title: "Builder integration is enabled but no endpoint is configured",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("validator", "builder", "consensus"),
+            relatedEips,
+            description: "The config marks builder integration as enabled but does not include an endpoint. This may simply mean the local config is incomplete, so the scanner treats it as a readiness checklist item.",
+            evidence,
+            recommendation: "Add the intended builder endpoint or document why endpoint configuration is managed elsewhere."
+        }));
+    }
+    return findings;
+}
+//# sourceMappingURL=epbsDetectors.js.map

package/dist/detectors/epbsDetectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epbsDetectors.js","sourceRoot":"","sources":["../../src/detectors/epbsDetectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAQhG,MAAM,UAAU,0BAA0B,CACxC,QAA+B,EAC/B,OAAwB;IAExB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAE5F,IAAI,QAAQ,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC;YACV,EAAE,EAAE,oCAAoC;YACxC,KAAK,EAAE,+CAA+C;YACtD,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC;YACpD,WAAW;YACX,WAAW,EACT,0KAA0K;YAC5K,QAAQ;YACR,cAAc,EACZ,mKAAmK;SACtK,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC;YACV,EAAE,EAAE,4CAA4C;YAChD,KAAK,EAAE,8DAA8D;YACrE,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC;YACpD,WAAW;YACX,WAAW,EACT,gMAAgM;YAClM,QAAQ;YACR,cAAc,EACZ,gGAAgG;SACnG,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/detectors/gasRepricingDetectors.d.ts

@@ -0,0 +1,4 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export declare function detectBytecodeGasRepricingExposure(opcodeCounts: Record<string, number>, context: DetectorContext): CompatibilityFinding[];
+export declare function detectTraceGasRepricingExposure(opcodeCounts: Record<string, number>, calldataBytes: number, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/gasRepricingDetectors.js

@@ -0,0 +1,135 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+import { opcodeCount } from "../utils/bytecode.js";
+const stateAndAccountOpcodes = [
+    "SLOAD",
+    "SSTORE",
+    "BALANCE",
+    "EXTCODESIZE",
+    "EXTCODECOPY",
+    "EXTCODEHASH",
+    "SELFBALANCE",
+    "SHA3"
+];
+export function detectBytecodeGasRepricingExposure(opcodeCounts, context) {
+    const sensitiveCount = opcodeCount(opcodeCounts, stateAndAccountOpcodes);
+    const calldataCopyCount = opcodeCounts.CALLDATACOPY ?? 0;
+    const thresholds = context.thresholds.bytecode.stateAccountOpcodeExposure;
+    const findings = [];
+    const relatedEips = relatedEipsForDetector(context.registry, "gasRepricingDetectors", [
+        "GAS-REPRICING",
+        "EIP-7904",
+        "EIP-8038"
+    ]);
+    if (sensitiveCount >= thresholds.mediumSensitiveOpcodeCount) {
+        findings.push(makeFinding({
+            id: "bytecode.state-account-opcode-exposure",
+            title: "State and account access opcodes are prominent in bytecode",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("contracts", "execution"),
+            relatedEips,
+            description: "This bytecode contains multiple storage, account, or hashing opcodes. Glamsterdam gas repricing candidates may change the cost profile of state-heavy execution, but static bytecode does not prove those paths are hot.",
+            evidence: { sensitiveOpcodeCount: sensitiveCount, opcodeCounts: pick(opcodeCounts, stateAndAccountOpcodes) },
+            recommendation: "Replay representative transactions and benchmark hot paths once a Glamsterdam client/devnet or local fork configuration is available."
+        }));
+    }
+    else if (sensitiveCount >= thresholds.lowSensitiveOpcodeCount) {
+        findings.push(makeFinding({
+            id: "bytecode.state-account-opcode-presence",
+            title: "State and account access opcodes are present",
+            severity: "low",
+            confidence: "medium",
+            domain: domains("contracts", "execution"),
+            relatedEips,
+            description: "This bytecode contains some opcodes that are commonly involved in gas repricing discussions. The scan cannot determine execution frequency.",
+            evidence: { sensitiveOpcodeCount: sensitiveCount, opcodeCounts: pick(opcodeCounts, stateAndAccountOpcodes) },
+            recommendation: "Include transactions that exercise these paths in fork-readiness tests."
+        }));
+    }
+    if (calldataCopyCount > 0) {
+        findings.push(makeFinding({
+            id: "bytecode.calldata-copy-exposure",
+            title: "Calldata copy opcode is present",
+            severity: "low",
+            confidence: "medium",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "gasRepricingDetectors", [
+                "GAS-REPRICING",
+                "EIP-7976"
+            ]),
+            description: "CALLDATACOPY appears in the bytecode. Calldata-related repricing candidates should be tested if this contract processes large calldata in production.",
+            evidence: { CALLDATACOPY: calldataCopyCount },
+            recommendation: "Add large-calldata cases to benchmarks and trace replay when final Glamsterdam parameters are known."
+        }));
+    }
+    return findings;
+}
+export function detectTraceGasRepricingExposure(opcodeCounts, calldataBytes, context) {
+    const storageOps = opcodeCount(opcodeCounts, ["SLOAD", "SSTORE"]);
+    const sensitiveCount = opcodeCount(opcodeCounts, stateAndAccountOpcodes);
+    const stateThresholds = context.thresholds.trace.stateHeavyExecution;
+    const calldataThresholds = context.thresholds.trace.calldataHeavy;
+    const findings = [];
+    if (storageOps >= stateThresholds.highStorageOps
+        || sensitiveCount >= stateThresholds.highSensitiveOpcodeCount) {
+        findings.push(makeFinding({
+            id: "trace.state-heavy-execution-high",
+            title: "Trace shows high state-heavy execution",
+            severity: "high",
+            confidence: "high",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "gasRepricingDetectors", [
+                "GAS-REPRICING",
+                "EIP-7904",
+                "EIP-8038"
+            ]),
+            description: "The executed trace contains many storage or state/account access operations. This is direct execution evidence and should be prioritized for fork-readiness benchmarking.",
+            evidence: { storageOps, sensitiveOpcodeCount: sensitiveCount, opcodeCounts: pick(opcodeCounts, stateAndAccountOpcodes) },
+            recommendation: "Replay this transaction class against a Glamsterdam devnet or fork configuration and compare gas, latency, and failure behavior with current mainnet rules."
+        }));
+    }
+    else if (storageOps >= stateThresholds.mediumStorageOps
+        || sensitiveCount >= stateThresholds.mediumSensitiveOpcodeCount) {
+        findings.push(makeFinding({
+            id: "trace.state-heavy-execution-medium",
+            title: "Trace shows state-heavy execution",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "gasRepricingDetectors", [
+                "GAS-REPRICING",
+                "EIP-7904",
+                "EIP-8038"
+            ]),
+            description: "The executed trace includes repeated storage or state/account access operations. Glamsterdam repricing candidates may affect this cost profile, depending on final fork scope.",
+            evidence: { storageOps, sensitiveOpcodeCount: sensitiveCount, opcodeCounts: pick(opcodeCounts, stateAndAccountOpcodes) },
+            recommendation: "Keep this trace as a regression fixture and replay it when final Glamsterdam client configurations are available."
+        }));
+    }
+    if ((opcodeCounts.CALLDATACOPY ?? 0) > 0 || calldataBytes >= calldataThresholds.mediumCalldataBytes) {
+        findings.push(makeFinding({
+            id: "trace.calldata-heavy-execution",
+            title: "Trace includes visible calldata-heavy execution",
+            severity: calldataBytes >= calldataThresholds.mediumCalldataBytes ? "medium" : "low",
+            confidence: calldataBytes > 0 ? "high" : "medium",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "gasRepricingDetectors", [
+                "GAS-REPRICING",
+                "EIP-7976"
+            ]),
+            description: "The trace includes CALLDATACOPY or explicit calldata byte counts. Calldata repricing candidates are considered registry items, so large input paths should be tested.",
+            evidence: { CALLDATACOPY: opcodeCounts.CALLDATACOPY ?? 0, calldataBytes },
+            recommendation: "Replay large-input transactions and compare gas envelopes once a Glamsterdam configuration is available."
+        }));
+    }
+    return findings;
+}
+function pick(record, keys) {
+    return keys.reduce((selected, key) => {
+        if (record[key] !== undefined) {
+            selected[key] = record[key];
+        }
+        return selected;
+    }, {});
+}
+//# sourceMappingURL=gasRepricingDetectors.js.map

package/dist/detectors/gasRepricingDetectors.js.map

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

package/dist/detectors/nativeEthTransferLogDetectors.d.ts

@@ -0,0 +1,8 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export interface IndexerHandlerSummary {
+    eventHandlers: number;
+    callHandlers: number;
+    blockHandlers: number;
+}
+export declare function detectNativeEthTransferLogReadiness(summary: IndexerHandlerSummary, configText: string, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/nativeEthTransferLogDetectors.js

@@ -0,0 +1,54 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+export function detectNativeEthTransferLogReadiness(summary, configText, context) {
+    const lower = configText.toLowerCase();
+    const mentionsBalanceDiff = lower.includes("balance diff")
+        || lower.includes("balance-diff")
+        || lower.includes("balancediff");
+    const mentionsNativeTransfers = lower.includes("native eth")
+        || lower.includes("eth transfer")
+        || lower.includes("eip-7708")
+        || mentionsBalanceDiff;
+    const findings = [];
+    const relatedEips = relatedEipsForDetector(context.registry, "nativeEthTransferLogDetectors", ["EIP-7708"]);
+    if (summary.eventHandlers > 0 && summary.callHandlers === 0 && summary.blockHandlers === 0) {
+        findings.push(makeFinding({
+            id: "indexer.event-only-assumption",
+            title: "Indexer appears to rely on event-only handlers",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("indexer"),
+            relatedEips,
+            description: "This looks like an event-only indexer configuration. Event-only pipelines should be reviewed for native ETH transfer visibility, balance-diff assumptions, and fork-specific log semantics if related EIPs remain active or considered.",
+            evidence: summary,
+            recommendation: "Document how native ETH transfers are represented today, how they would be represented if transfer-log proposals are included, and how historical replay would be validated."
+        }));
+    }
+    if (mentionsBalanceDiff) {
+        findings.push(makeFinding({
+            id: "indexer.balance-diff-native-transfer-assumption",
+            title: "Indexer mentions balance-diff based native transfer handling",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("indexer", "monitoring"),
+            relatedEips,
+            description: "The configuration mentions balance-diff based transfer handling. That can be a valid design, but it should be reviewed if native ETH transfer log proposals remain active or considered.",
+            evidence: ["Balance-diff marker found in configuration text."],
+            recommendation: "Document whether native ETH transfers come from logs, balance diffs, traces, receipts, or a combined pipeline, and add replay tests for representative transfer cases."
+        }));
+    }
+    if (!mentionsNativeTransfers) {
+        findings.push(makeFinding({
+            id: "indexer.native-eth-transfer-review-missing",
+            title: "No native ETH transfer handling metadata found",
+            severity: "unknown",
+            confidence: "low",
+            domain: domains("indexer", "monitoring"),
+            relatedEips,
+            description: "The configuration does not mention native ETH transfers, balance diffs, or EIP-7708. Static config cannot determine whether the runtime indexer already handles this elsewhere.",
+            evidence: ["No native-transfer marker found in configuration text."],
+            recommendation: "Add an explicit compatibility note or test plan for native ETH transfers, especially if dashboards or alerts currently infer transfers from balance diffs."
+        }));
+    }
+    return findings;
+}
+//# sourceMappingURL=nativeEthTransferLogDetectors.js.map

package/dist/detectors/nativeEthTransferLogDetectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeEthTransferLogDetectors.js","sourceRoot":"","sources":["../../src/detectors/nativeEthTransferLogDetectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAShG,MAAM,UAAU,mCAAmC,CACjD,OAA8B,EAC9B,UAAkB,EAClB,OAAwB;IAExB,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,mBAAmB,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;WACrD,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;WAC9B,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACnC,MAAM,uBAAuB,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;WACvD,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;WAC9B,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;WAC1B,mBAAmB,CAAC;IAEzB,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAE5G,IAAI,OAAO,CAAC,aAAa,GAAG,CAAC,IAAI,OAAO,CAAC,YAAY,KAAK,CAAC,IAAI,OAAO,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC3F,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC;YACV,EAAE,EAAE,+BAA+B;YACnC,KAAK,EAAE,gDAAgD;YACvD,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;YAC1B,WAAW;YACX,WAAW,EACT,yOAAyO;YAC3O,QAAQ,EAAE,OAAO;YACjB,cAAc,EACZ,8KAA8K;SACjL,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,mBAAmB,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC;YACV,EAAE,EAAE,iDAAiD;YACrD,KAAK,EAAE,8DAA8D;YACrE,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;YACxC,WAAW;YACX,WAAW,EACT,0LAA0L;YAC5L,QAAQ,EAAE,CAAC,kDAAkD,CAAC;YAC9D,cAAc,EACZ,wKAAwK;SAC3K,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CACX,WAAW,CAAC;YACV,EAAE,EAAE,4CAA4C;YAChD,KAAK,EAAE,gDAAgD;YACvD,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;YACxC,WAAW;YACX,WAAW,EACT,iLAAiL;YACnL,QAAQ,EAAE,CAAC,wDAAwD,CAAC;YACpE,cAAc,EACZ,4JAA4J;SAC/J,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/detectors/stateCreationDetectors.d.ts

@@ -0,0 +1,4 @@
+import { type DetectorContext } from "./types.js";
+import type { CompatibilityFinding } from "../reports/reportTypes.js";
+export declare function detectBytecodeStateCreation(opcodeCounts: Record<string, number>, context: DetectorContext): CompatibilityFinding[];
+export declare function detectTraceStateCreation(opcodeCounts: Record<string, number>, context: DetectorContext): CompatibilityFinding[];

package/dist/detectors/stateCreationDetectors.js

@@ -0,0 +1,46 @@
+import { domains, makeFinding, relatedEipsForDetector } from "./types.js";
+export function detectBytecodeStateCreation(opcodeCounts, context) {
+    const createCount = (opcodeCounts.CREATE ?? 0) + (opcodeCounts.CREATE2 ?? 0);
+    if (createCount === 0) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "bytecode.contract-creation-opcodes",
+            title: "Contract creation opcodes are present",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "stateCreationDetectors", [
+                "GAS-REPRICING",
+                "EIP-8037"
+            ]),
+            description: "CREATE or CREATE2 appears in the bytecode. State-creation repricing candidates may affect factory, clone, deployment, or account-creation-heavy paths depending on final Glamsterdam scope.",
+            evidence: { CREATE: opcodeCounts.CREATE ?? 0, CREATE2: opcodeCounts.CREATE2 ?? 0 },
+            recommendation: "Identify representative deployment/factory transactions and add them to fork-readiness replay tests."
+        })
+    ];
+}
+export function detectTraceStateCreation(opcodeCounts, context) {
+    const createCount = (opcodeCounts.CREATE ?? 0) + (opcodeCounts.CREATE2 ?? 0);
+    if (createCount === 0) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "trace.contract-creation-executed",
+            title: "Trace executed contract creation",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("contracts", "execution"),
+            relatedEips: relatedEipsForDetector(context.registry, "stateCreationDetectors", [
+                "GAS-REPRICING",
+                "EIP-8037"
+            ]),
+            description: "The trace executed CREATE or CREATE2. This is direct evidence that this transaction class exercises state creation.",
+            evidence: { CREATE: opcodeCounts.CREATE ?? 0, CREATE2: opcodeCounts.CREATE2 ?? 0 },
+            recommendation: "Replay creation-heavy flows against Glamsterdam test environments and verify gas budgeting, relayer assumptions, and deployment automation."
+        })
+    ];
+}
+//# sourceMappingURL=stateCreationDetectors.js.map

package/dist/detectors/stateCreationDetectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateCreationDetectors.js","sourceRoot":"","sources":["../../src/detectors/stateCreationDetectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAwB,MAAM,YAAY,CAAC;AAGhG,MAAM,UAAU,2BAA2B,CACzC,YAAoC,EACpC,OAAwB;IAExB,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAE7E,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,WAAW,CAAC;YACV,EAAE,EAAE,oCAAoC;YACxC,KAAK,EAAE,uCAAuC;YAC9C,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;YACzC,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,EAAE;gBAC9E,eAAe;gBACf,UAAU;aACX,CAAC;YACF,WAAW,EACT,6LAA6L;YAC/L,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,CAAC,EAAE;YAClF,cAAc,EACZ,sGAAsG;SACzG,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,YAAoC,EACpC,OAAwB;IAExB,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAE7E,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,WAAW,CAAC;YACV,EAAE,EAAE,kCAAkC;YACtC,KAAK,EAAE,kCAAkC;YACzC,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;YACzC,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,EAAE;gBAC9E,eAAe;gBACf,UAAU;aACX,CAAC;YACF,WAAW,EACT,qHAAqH;YACvH,QAAQ,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,CAAC,EAAE;YAClF,cAAc,EACZ,6IAA6I;SAChJ,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/detectors/thresholds.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export declare const detectorThresholdsSchema: z.ZodObject<{
+    schemaVersion: z.ZodNumber;
+    profile: z.ZodOptional<z.ZodString>;
+    lastUpdated: z.ZodString;
+    notes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    bytecode: z.ZodObject<{
+        contractSize: z.ZodObject<{
+            currentRuntimeLimitBytes: z.ZodNumber;
+            nearCurrentLimitBytes: z.ZodNumber;
+        }, z.core.$strip>;
+        stateAccountOpcodeExposure: z.ZodObject<{
+            mediumSensitiveOpcodeCount: z.ZodNumber;
+            lowSensitiveOpcodeCount: z.ZodNumber;
+        }, z.core.$strip>;
+        storagePattern: z.ZodObject<{
+            mediumStorageOpcodeCount: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    trace: z.ZodObject<{
+        stateHeavyExecution: z.ZodObject<{
+            highStorageOps: z.ZodNumber;
+            highSensitiveOpcodeCount: z.ZodNumber;
+            mediumStorageOps: z.ZodNumber;
+            mediumSensitiveOpcodeCount: z.ZodNumber;
+        }, z.core.$strip>;
+        calldataHeavy: z.ZodObject<{
+            mediumCalldataBytes: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DetectorThresholds = z.infer<typeof detectorThresholdsSchema>;
+export declare function defaultThresholdsPath(): string;
+export declare function loadDetectorThresholds(thresholdsPath?: string): DetectorThresholds;