glamsterdam-compat-lab 0.2.2

package/dist/scanners/traceScanner.js

@@ -0,0 +1,272 @@
+import { detectTraceGasRepricingExposure } from "../detectors/gasRepricingDetectors.js";
+import { detectTraceStateCreation } from "../detectors/stateCreationDetectors.js";
+import { domains, makeFinding } from "../detectors/types.js";
+import { loadDetectorThresholds } from "../detectors/thresholds.js";
+import { loadEipRegistry } from "../registry/eipRegistry.js";
+import { makeReport } from "../reports/reportTypes.js";
+import { loadStructuredFile } from "../utils/files.js";
+export function scanTraceFile(traceFile, options = {}) {
+    const input = loadStructuredFile(traceFile);
+    return scanTrace(input, {
+        ...options,
+        targetName: options.targetName ?? traceFile
+    });
+}
+export function scanTrace(input, options = {}) {
+    const registry = options.registry ?? loadEipRegistry(options.registryPath);
+    const thresholds = options.thresholds ?? loadDetectorThresholds(options.thresholdsPath);
+    const normalized = normalizeTrace(input);
+    const opcodeCounts = countOps(normalized.steps);
+    const calldataBytes = normalized.steps.reduce((total, step) => total + (step.calldataBytes ?? 0), 0);
+    const explicitLogEntries = normalized.steps.reduce((total, step) => total + (step.logs ?? 0), 0);
+    const maxDepth = normalized.steps.reduce((max, step) => Math.max(max, step.depth ?? 0), 0);
+    const logOps = ["LOG0", "LOG1", "LOG2", "LOG3", "LOG4"].reduce((total, op) => total + (opcodeCounts[op] ?? 0), 0);
+    const callOps = ["CALL", "CALLCODE", "DELEGATECALL", "STATICCALL"].reduce((total, op) => total + (opcodeCounts[op] ?? 0), 0);
+    const context = {
+        registry,
+        thresholds,
+        targetName: options.targetName ?? "trace"
+    };
+    const findings = [
+        ...detectTraceGasRepricingExposure(opcodeCounts, calldataBytes, context),
+        ...detectTraceStateCreation(opcodeCounts, context),
+        ...detectTraceLogAndCallPattern(logOps, explicitLogEntries, callOps, maxDepth),
+        ...detectTraceIncompleteness(normalized)
+    ];
+    return makeReport({
+        fork: registry.fork,
+        target: {
+            kind: "trace",
+            name: options.targetName ?? "trace"
+        },
+        findings,
+        assumptions: [
+            "Trace input was normalized from an array of steps, a JSON-RPC result wrapper, a structLogs object, this project's normalized format, an action trace array, or a call-tracer-like calls tree.",
+            `The loaded registry is dated ${registry.lastUpdated}. Glamsterdam scope and gas parameters may change.`,
+            `Detector thresholds are dated ${thresholds.lastUpdated} and are MVP heuristics, not protocol gas parameters.`
+        ],
+        limitations: [
+            "Trace coverage is only as good as the transaction samples provided.",
+            "Foundry and Hardhat can emit multiple trace shapes depending on command, plugin, and verbosity; this scanner supports representative JSON-like exports, not every console rendering.",
+            "Some trace formats omit calldata sizes, storage keys, gas costs, logs, or call details.",
+            "Findings are compatibility prompts and should be validated through replay or benchmarking."
+        ]
+    });
+}
+export function normalizeTrace(input) {
+    const warnings = [];
+    if (Array.isArray(input)) {
+        return { steps: normalizeTraceSequence(input), warnings };
+    }
+    if (!isRecord(input)) {
+        return {
+            steps: [],
+            warnings: ["Trace input is not an object or array."]
+        };
+    }
+    if (isRecord(input.result)) {
+        const normalized = normalizeTrace(input.result);
+        return {
+            steps: normalized.steps,
+            warnings: ["Unwrapped JSON-RPC result object.", ...normalized.warnings]
+        };
+    }
+    if (Array.isArray(input.steps)) {
+        return { steps: input.steps.map(stepFromUnknown).filter(isStep), warnings };
+    }
+    if (Array.isArray(input.structLogs)) {
+        return { steps: input.structLogs.map(stepFromUnknown).filter(isStep), warnings };
+    }
+    if (Array.isArray(input.trace)) {
+        return { steps: normalizeTraceSequence(input.trace), warnings };
+    }
+    if (isRecord(input.trace)) {
+        const normalized = normalizeTrace(input.trace);
+        return {
+            steps: normalized.steps,
+            warnings: ["Unwrapped nested trace object.", ...normalized.warnings]
+        };
+    }
+    if (Array.isArray(input.traces)) {
+        return { steps: normalizeTraceSequence(input.traces), warnings };
+    }
+    if (Array.isArray(input.calls)
+        || Array.isArray(input.children)
+        || typeof input.type === "string"
+        || typeof input.kind === "string") {
+        const steps = flattenCallTree(input);
+        if (steps.length === 0) {
+            warnings.push("Call tree did not contain recognizable call frames.");
+        }
+        return { steps, warnings };
+    }
+    return {
+        steps: [],
+        warnings: ["No recognized trace steps were found."]
+    };
+}
+function detectTraceLogAndCallPattern(logOps, explicitLogEntries, callOps, maxDepth) {
+    const findings = [];
+    if (logOps > 0 || explicitLogEntries > 0 || callOps > 0) {
+        findings.push(makeFinding({
+            id: "trace.logs-calls-visible",
+            title: "Trace includes logs or external calls",
+            severity: "low",
+            confidence: "high",
+            domain: domains("contracts", "indexer", "monitoring"),
+            relatedEips: ["EIP-7708", "EIP-7928"],
+            description: "The trace includes log or call activity that may be relevant to indexer, explorer, and monitoring assumptions under Glamsterdam-era changes.",
+            evidence: { logOps, explicitLogEntries, callOps, maxDepth },
+            recommendation: "Use traces like this to test indexer replay, alerting, and explorer display paths alongside contract gas behavior."
+        }));
+    }
+    return findings;
+}
+function detectTraceIncompleteness(normalized) {
+    const findings = [];
+    const hasCalldataEvidence = normalized.steps.some((step) => typeof step.calldataBytes === "number");
+    const hasGasCostEvidence = normalized.steps.some((step) => typeof step.gasCost === "number");
+    if (normalized.steps.length === 0) {
+        findings.push(makeFinding({
+            id: "trace.no-recognized-steps",
+            title: "Trace contains no recognized execution steps",
+            severity: "unknown",
+            confidence: "high",
+            domain: domains("contracts", "execution"),
+            relatedEips: ["GAS-REPRICING"],
+            description: "The scanner could not normalize execution steps from this trace input, so it cannot infer opcode-level compatibility risks.",
+            evidence: normalized.warnings,
+            recommendation: "Provide a trace with a `steps`, `structLogs`, `trace`, JSON-RPC `result`, action trace array, or call-tracer-like `calls` shape."
+        }));
+    }
+    else if (!hasCalldataEvidence || !hasGasCostEvidence) {
+        findings.push(makeFinding({
+            id: "trace.partial-evidence",
+            title: "Trace omits some useful compatibility evidence",
+            severity: "unknown",
+            confidence: "low",
+            domain: domains("contracts", "execution"),
+            relatedEips: ["GAS-REPRICING", "EIP-7976"],
+            description: "The trace was usable, but some formats omit calldata byte counts or per-op gas costs. The scanner reports what it can see and avoids inferring missing data.",
+            evidence: { hasCalldataEvidence, hasGasCostEvidence, warnings: normalized.warnings },
+            recommendation: "Prefer traces that include executed opcodes, depth, calldata/input sizes, and gas costs when comparing current and Glamsterdam behavior."
+        }));
+    }
+    return findings;
+}
+function countOps(steps) {
+    return steps.reduce((counts, step) => {
+        counts[step.op] = (counts[step.op] ?? 0) + 1;
+        return counts;
+    }, {});
+}
+function normalizeTraceSequence(items) {
+    return items.flatMap((item) => {
+        if (isRecord(item) && (Array.isArray(item.calls) || Array.isArray(item.children))) {
+            return flattenCallTree(item);
+        }
+        const step = stepFromUnknown(item);
+        return step ? [step] : [];
+    });
+}
+function stepFromUnknown(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const action = isRecord(value.action) ? value.action : undefined;
+    const opcode = isRecord(value.opcode) ? value.opcode.name : value.opcode;
+    const opRaw = value.op
+        ?? opcode
+        ?? value.opName
+        ?? value.instruction
+        ?? action?.callType
+        ?? value.callType
+        ?? value.call_type
+        ?? value.type
+        ?? value.kind
+        ?? value.actionType;
+    if (typeof opRaw !== "string") {
+        return undefined;
+    }
+    const input = value.input ?? value.calldata ?? value.data ?? action?.input ?? action?.init;
+    return {
+        op: normalizeTraceOp(opRaw),
+        depth: numberValue(value.depth) ?? depthFromTraceAddress(value.traceAddress),
+        gas: numberValue(value.gas),
+        gasCost: numberValue(value.gasCost ?? value.cost),
+        calldataBytes: numberValue(value.calldataBytes ?? value.inputBytes ?? byteLengthFromHex(input)),
+        logs: Array.isArray(value.logs) ? value.logs.length : numberValue(value.logs)
+    };
+}
+function flattenCallTree(frame, depth = 0) {
+    if (!isRecord(frame)) {
+        return [];
+    }
+    const type = typeof frame.type === "string"
+        ? frame.type
+        : typeof frame.kind === "string"
+            ? frame.kind
+            : "CALL";
+    const current = stepFromUnknown({
+        ...frame,
+        op: type,
+        depth,
+        calldataBytes: byteLengthFromHex(frame.input ?? frame.calldata ?? frame.data)
+    });
+    const callChildren = Array.isArray(frame.calls) ? frame.calls : [];
+    const genericChildren = Array.isArray(frame.children) ? frame.children : [];
+    const childFrames = [...callChildren, ...genericChildren];
+    const children = childFrames.flatMap((child) => flattenCallTree(child, depth + 1));
+    return current ? [current, ...children] : children;
+}
+function isStep(value) {
+    return value !== undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function numberValue(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
+        return Number(value);
+    }
+    return undefined;
+}
+function normalizeTraceOp(opRaw) {
+    const op = opRaw.toUpperCase().replace(/[^A-Z0-9]/g, "");
+    if (op === "CALL" || op === "CALLCODE" || op === "DELEGATECALL" || op === "STATICCALL") {
+        return op;
+    }
+    if (op === "CREATE" || op === "CREATE2") {
+        return op;
+    }
+    if (op === "CALLTRACE" || op === "CALLFRAME" || op === "EXTERNALCALL") {
+        return "CALL";
+    }
+    if (op === "STATICCALLTRACE") {
+        return "STATICCALL";
+    }
+    if (op === "DELEGATECALLTRACE") {
+        return "DELEGATECALL";
+    }
+    if (op === "SUICIDE") {
+        return "SELFDESTRUCT";
+    }
+    return op;
+}
+function depthFromTraceAddress(value) {
+    return Array.isArray(value) ? value.length + 1 : undefined;
+}
+function byteLengthFromHex(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const hex = value.startsWith("0x") ? value.slice(2) : value;
+    if (!/^[0-9a-fA-F]*$/.test(hex)) {
+        return undefined;
+    }
+    return Math.ceil(hex.length / 2);
+}
+//# sourceMappingURL=traceScanner.js.map

package/dist/scanners/traceScanner.js.map

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

package/dist/scanners/validatorScanner.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { type DetectorThresholds } from "../detectors/thresholds.js";
+import type { EipRegistry } from "../registry/schemas.js";
+import { type CompatibilityReport } from "../reports/reportTypes.js";
+declare const clientMatrixSchema: z.ZodObject<{
+    fork: z.ZodString;
+    lastUpdated: z.ZodString;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    clients: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodEnum<{
+            execution: "execution";
+            consensus: "consensus";
+            validator: "validator";
+        }>;
+        versions: z.ZodArray<z.ZodObject<{
+            version: z.ZodString;
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                compatible: "compatible";
+                incompatible: "incompatible";
+                partial: "partial";
+            }>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type ClientMatrix = z.infer<typeof clientMatrixSchema>;
+export interface ValidatorScanOptions {
+    registry?: EipRegistry;
+    registryPath?: string;
+    thresholds?: DetectorThresholds;
+    thresholdsPath?: string;
+    clientMatrixPath?: string;
+    targetName?: string;
+}
+export declare function defaultClientMatrixPath(): string;
+export declare function scanValidatorConfig(configPath: string, options?: ValidatorScanOptions): CompatibilityReport;
+export declare function loadClientMatrix(matrixPath: string): ClientMatrix;
+export {};

package/dist/scanners/validatorScanner.js

@@ -0,0 +1,210 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { detectEpbsBuilderReadiness } from "../detectors/epbsDetectors.js";
+import { domains, makeFinding } from "../detectors/types.js";
+import { loadDetectorThresholds } from "../detectors/thresholds.js";
+import { loadEipRegistry } from "../registry/eipRegistry.js";
+import { makeReport } from "../reports/reportTypes.js";
+import { loadStructuredFile } from "../utils/files.js";
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const clientVersionSchema = z.object({
+    version: z.string(),
+    status: z.enum(["compatible", "incompatible", "partial", "unknown"]),
+    notes: z.string().optional()
+});
+const clientEntrySchema = z.object({
+    name: z.string(),
+    role: z.enum(["execution", "consensus", "validator"]),
+    versions: z.array(clientVersionSchema)
+});
+const clientMatrixSchema = z.object({
+    fork: z.string(),
+    lastUpdated: z.string(),
+    sources: z.array(z.string()).default([]),
+    clients: z.array(clientEntrySchema).default([])
+});
+export function defaultClientMatrixPath() {
+    return resolve(moduleDir, "../../data/client-compat/clients.example.json");
+}
+export function scanValidatorConfig(configPath, options = {}) {
+    const registry = options.registry ?? loadEipRegistry(options.registryPath);
+    const thresholds = options.thresholds ?? loadDetectorThresholds(options.thresholdsPath);
+    const config = loadStructuredFile(configPath);
+    const matrix = loadClientMatrix(options.clientMatrixPath ?? defaultClientMatrixPath());
+    const context = {
+        registry,
+        thresholds,
+        targetName: options.targetName ?? configPath
+    };
+    const findings = [
+        ...detectClientMetadata(config, matrix),
+        ...detectEpbsBuilderReadiness({
+            builderEnabled: getPath(config, ["builder", "enabled"]),
+            builderEndpoint: getPath(config, ["builder", "endpoint"])
+        }, context),
+        ...detectMonitoringMetadata(config),
+        ...detectTestnetMetadata(config)
+    ];
+    return makeReport({
+        fork: registry.fork,
+        target: {
+            kind: "validator",
+            name: options.targetName ?? configPath
+        },
+        findings,
+        assumptions: [
+            "Validator/operator readiness was checked from a local JSON/YAML config only.",
+            `Client compatibility was compared against ${options.clientMatrixPath ?? defaultClientMatrixPath()}. Unknown entries are reported without guessing.`,
+            `The loaded registry is dated ${registry.lastUpdated}. Glamsterdam scope and gas parameters may change.`
+        ],
+        limitations: [
+            "This scanner does not verify live node state, command-line flags, environment variables, firewall rules, or remote service health.",
+            "Client compatibility must come from a maintained matrix with explicit source links.",
+            "A clean report does not replace devnet/testnet participation or operational drills."
+        ]
+    });
+}
+export function loadClientMatrix(matrixPath) {
+    const raw = readFileSync(matrixPath, "utf8");
+    return clientMatrixSchema.parse(JSON.parse(raw));
+}
+function detectClientMetadata(config, matrix) {
+    const findings = [];
+    const clients = [
+        { role: "execution", path: ["executionClient"], label: "execution client" },
+        { role: "consensus", path: ["consensusClient"], label: "consensus client" },
+        { role: "validator", path: ["validatorClient"], label: "validator client" }
+    ];
+    for (const client of clients) {
+        const value = getPath(config, client.path);
+        const name = getPath(config, [...client.path, "name"]);
+        const version = getPath(config, [...client.path, "version"]);
+        if (!isRecord(value) || typeof name !== "string" || name.trim() === "") {
+            findings.push(makeFinding({
+                id: `validator.missing-${client.role}-client-name`,
+                title: `Missing ${client.label} metadata`,
+                severity: "medium",
+                confidence: "high",
+                domain: domains("validator"),
+                relatedEips: ["EIP-7732"],
+                description: `The config does not include a ${client.label} name. Operator readiness reports need explicit client metadata so compatibility can be tracked without guessing.`,
+                evidence: { path: client.path.join(".") },
+                recommendation: `Add ${client.path.join(".")}.name and ${client.path.join(".")}.version to the operator config or document where this metadata is managed.`
+            }));
+            continue;
+        }
+        if (typeof version !== "string" || version.trim() === "") {
+            findings.push(makeFinding({
+                id: `validator.missing-${client.role}-client-version`,
+                title: `Missing ${client.label} version`,
+                severity: "medium",
+                confidence: "high",
+                domain: domains("validator"),
+                relatedEips: ["EIP-7732"],
+                description: `The config names ${name} as the ${client.label}, but does not include a version. Compatibility cannot be assessed without explicit version metadata.`,
+                evidence: { name, version },
+                recommendation: `Add ${client.path.join(".")}.version and keep it updated from deployment automation or release inventory.`
+            }));
+            continue;
+        }
+        const matrixEntry = findClientMatrixEntry(matrix, client.role, name, version);
+        if (!matrixEntry) {
+            findings.push(makeFinding({
+                id: `validator.unknown-${client.role}-client-compatibility`,
+                title: `Unknown Glamsterdam compatibility for ${client.label}`,
+                severity: "unknown",
+                confidence: "high",
+                domain: domains("validator"),
+                relatedEips: ["EIP-7732"],
+                description: `The compatibility matrix does not contain a sourced status for ${name} ${version} as a ${client.label}. The scanner will not infer compatibility from client name alone.`,
+                evidence: { role: client.role, name, version, matrixLastUpdated: matrix.lastUpdated },
+                recommendation: "Update the client compatibility matrix with sourced release/devnet information, or treat this as a manual-readiness checklist item."
+            }));
+            continue;
+        }
+        if (matrixEntry.status !== "compatible") {
+            findings.push(makeFinding({
+                id: `validator.${client.role}-client-status-${matrixEntry.status}`,
+                title: `${client.label} compatibility is ${matrixEntry.status}`,
+                severity: matrixEntry.status === "incompatible" ? "high" : "unknown",
+                confidence: "high",
+                domain: domains("validator"),
+                relatedEips: ["EIP-7732"],
+                description: `The compatibility matrix reports ${matrixEntry.status} for ${name} ${version}. The scanner reports the matrix value without trying to override it.`,
+                evidence: { role: client.role, name, version, matrixEntry },
+                recommendation: "Review the matrix source notes, update the client, or validate the status through testnet/devnet participation."
+            }));
+        }
+    }
+    return findings;
+}
+function detectMonitoringMetadata(config) {
+    const prometheus = getPath(config, ["monitoring", "prometheus"]);
+    const grafana = getPath(config, ["monitoring", "grafana"]);
+    if (truthyString(prometheus) && truthyString(grafana)) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "validator.missing-monitoring-endpoints",
+            title: "Monitoring endpoint metadata is incomplete",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("validator", "monitoring"),
+            relatedEips: ["EIP-7732", "EIP-7928"],
+            description: "The config does not include both Prometheus and Grafana monitoring metadata. Glamsterdam readiness should include observable EL, CL, validator, builder, and fork-specific metrics.",
+            evidence: { prometheus, grafana },
+            recommendation: "Record monitoring endpoints or dashboards and add alert coverage for devnet/testnet participation, missed duties, builder/API health, and sync status."
+        })
+    ];
+}
+function detectTestnetMetadata(config) {
+    const participation = getPath(config, ["networks", "testnetParticipation"]);
+    const hasParticipation = Array.isArray(participation)
+        ? participation.length > 0
+        : truthyString(participation);
+    if (hasParticipation) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "validator.missing-testnet-participation",
+            title: "No testnet or devnet participation metadata found",
+            severity: "medium",
+            confidence: "high",
+            domain: domains("validator", "monitoring"),
+            relatedEips: ["EIP-7732", "EIP-7928"],
+            description: "The config does not list Glamsterdam-oriented testnet or devnet participation. Operator readiness should be validated before mainnet activation timing is final.",
+            evidence: { testnetParticipation: participation },
+            recommendation: "Add planned or completed testnet/devnet participation, including client versions, dates, observed issues, and rollback notes."
+        })
+    ];
+}
+function findClientMatrixEntry(matrix, role, name, version) {
+    const normalizedName = name.toLowerCase();
+    const client = matrix.clients.find((entry) => entry.role === role && entry.name.toLowerCase() === normalizedName);
+    if (!client) {
+        return undefined;
+    }
+    return client.versions.find((entry) => entry.version === version)
+        ?? client.versions.find((entry) => entry.version === "*");
+}
+function getPath(value, path) {
+    let current = value;
+    for (const segment of path) {
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function truthyString(value) {
+    return typeof value === "string" ? value.trim().length > 0 : Boolean(value);
+}
+//# sourceMappingURL=validatorScanner.js.map

package/dist/scanners/validatorScanner.js.map

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

package/dist/utils/bytecode.d.ts

@@ -0,0 +1,11 @@
+export interface Opcode {
+    pc: number;
+    code: number;
+    name: string;
+    pushData?: string;
+}
+export declare function normalizeBytecode(input: string): string;
+export declare function byteLength(bytecode: string): number;
+export declare function disassembleBytecode(bytecode: string): Opcode[];
+export declare function countOpcodeNames(opcodes: Opcode[]): Record<string, number>;
+export declare function opcodeCount(counts: Record<string, number>, names: string[]): number;