glamsterdam-compat-lab 0.2.2

package/dist/reports/reportTypes.js.map

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

package/dist/scanners/bytecodeScanner.d.ts

@@ -0,0 +1,11 @@
+import { type DetectorThresholds } from "../detectors/thresholds.js";
+import type { EipRegistry } from "../registry/schemas.js";
+import { type CompatibilityReport } from "../reports/reportTypes.js";
+export interface BytecodeScanOptions {
+    registry?: EipRegistry;
+    registryPath?: string;
+    thresholds?: DetectorThresholds;
+    thresholdsPath?: string;
+    targetName?: string;
+}
+export declare function scanBytecode(pathOrHex: string, options?: BytecodeScanOptions): CompatibilityReport;

package/dist/scanners/bytecodeScanner.js

@@ -0,0 +1,107 @@
+import { detectContractSize } from "../detectors/contractSizeDetectors.js";
+import { detectBytecodeGasRepricingExposure } from "../detectors/gasRepricingDetectors.js";
+import { detectBytecodeStateCreation } 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 { byteLength, countOpcodeNames, disassembleBytecode, normalizeBytecode, opcodeCount } from "../utils/bytecode.js";
+import { readPathOrValue } from "../utils/files.js";
+export function scanBytecode(pathOrHex, options = {}) {
+    const registry = options.registry ?? loadEipRegistry(options.registryPath);
+    const thresholds = options.thresholds ?? loadDetectorThresholds(options.thresholdsPath);
+    const source = readPathOrValue(pathOrHex);
+    const normalized = normalizeBytecode(source.text);
+    const opcodes = disassembleBytecode(normalized);
+    const opcodeCounts = countOpcodeNames(opcodes);
+    const sizeBytes = byteLength(normalized);
+    const context = {
+        registry,
+        thresholds,
+        targetName: options.targetName ?? source.name
+    };
+    const findings = [
+        ...detectContractSize(sizeBytes, context),
+        ...detectBytecodeGasRepricingExposure(opcodeCounts, context),
+        ...detectBytecodeStateCreation(opcodeCounts, context),
+        ...detectStoragePattern(opcodeCounts, thresholds),
+        ...detectLogPattern(opcodeCounts),
+        makeManualReviewFinding(sizeBytes, opcodeCounts)
+    ];
+    return makeReport({
+        fork: registry.fork,
+        target: {
+            kind: "bytecode",
+            name: options.targetName ?? source.name
+        },
+        findings,
+        assumptions: [
+            "Input was interpreted as EVM bytecode after removing whitespace and an optional 0x prefix.",
+            `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: [
+            "Static bytecode scanning cannot determine which branches are executed in production.",
+            "Opcode counts are not gas estimates and do not include dynamic call targets, storage keys, calldata sizes, or transaction context.",
+            "Findings are compatibility prompts, not predictions that a contract will fail."
+        ]
+    });
+}
+function detectStoragePattern(opcodeCounts, thresholds) {
+    const storageOps = opcodeCount(opcodeCounts, ["SLOAD", "SSTORE"]);
+    if (storageOps >= thresholds.bytecode.storagePattern.mediumStorageOpcodeCount) {
+        return [
+            makeFinding({
+                id: "bytecode.storage-heavy-pattern",
+                title: "Storage-related opcodes appear frequently",
+                severity: "medium",
+                confidence: "medium",
+                domain: domains("contracts", "execution"),
+                relatedEips: ["GAS-REPRICING", "EIP-8038"],
+                description: "This bytecode contains many storage-related opcodes. Glamsterdam gas repricing candidates may change the cost profile of storage-heavy execution.",
+                evidence: { SLOAD: opcodeCounts.SLOAD ?? 0, SSTORE: opcodeCounts.SSTORE ?? 0, storageOps },
+                recommendation: "Replay representative storage-heavy transactions against a Glamsterdam devnet or fork configuration when available."
+            })
+        ];
+    }
+    return [];
+}
+function detectLogPattern(opcodeCounts) {
+    const logOps = opcodeCount(opcodeCounts, ["LOG0", "LOG1", "LOG2", "LOG3", "LOG4"]);
+    if (logOps === 0) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "bytecode.log-opcodes-present",
+            title: "Log opcodes are present",
+            severity: "low",
+            confidence: "medium",
+            domain: domains("contracts", "indexer", "monitoring"),
+            relatedEips: ["EIP-7708"],
+            description: "The bytecode can emit logs. Indexers and monitoring systems should include representative log-emitting transactions when testing Glamsterdam-era assumptions.",
+            evidence: {
+                LOG0: opcodeCounts.LOG0 ?? 0,
+                LOG1: opcodeCounts.LOG1 ?? 0,
+                LOG2: opcodeCounts.LOG2 ?? 0,
+                LOG3: opcodeCounts.LOG3 ?? 0,
+                LOG4: opcodeCounts.LOG4 ?? 0
+            },
+            recommendation: "Include log-emitting paths in trace replay and indexer regression tests, especially where native ETH transfer visibility matters."
+        })
+    ];
+}
+function makeManualReviewFinding(sizeBytes, opcodeCounts) {
+    return makeFinding({
+        id: "bytecode.manual-review-required",
+        title: "Manual review is still required for runtime behavior",
+        severity: "unknown",
+        confidence: "low",
+        domain: domains("contracts", "execution"),
+        relatedEips: ["GAS-REPRICING"],
+        description: "The scanner found static opcode evidence, but exact fork impact depends on executed paths, calldata, storage warmness, account state, compiler output, and final Glamsterdam parameters.",
+        evidence: { byteLength: sizeBytes, opcodeKinds: Object.keys(opcodeCounts).length },
+        recommendation: "Use this report to choose transactions for trace replay and benchmark them under current and Glamsterdam configurations."
+    });
+}
+//# sourceMappingURL=bytecodeScanner.js.map

package/dist/scanners/bytecodeScanner.js.map

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

package/dist/scanners/indexerScanner.d.ts

@@ -0,0 +1,13 @@
+import { type IndexerHandlerSummary } from "../detectors/nativeEthTransferLogDetectors.js";
+import { type DetectorThresholds } from "../detectors/thresholds.js";
+import type { EipRegistry } from "../registry/schemas.js";
+import { type CompatibilityReport } from "../reports/reportTypes.js";
+export interface IndexerScanOptions {
+    registry?: EipRegistry;
+    registryPath?: string;
+    thresholds?: DetectorThresholds;
+    thresholdsPath?: string;
+    targetName?: string;
+}
+export declare function scanIndexer(indexerPath: string, options?: IndexerScanOptions): CompatibilityReport;
+export declare function summarizeHandlers(config: unknown): IndexerHandlerSummary;

package/dist/scanners/indexerScanner.js

@@ -0,0 +1,129 @@
+import { detectMissingBalIndexerPlan } from "../detectors/balDetectors.js";
+import { detectNativeEthTransferLogReadiness } from "../detectors/nativeEthTransferLogDetectors.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, readTextFile } from "../utils/files.js";
+export function scanIndexer(indexerPath, options = {}) {
+    const registry = options.registry ?? loadEipRegistry(options.registryPath);
+    const thresholds = options.thresholds ?? loadDetectorThresholds(options.thresholdsPath);
+    const rawText = readTextFile(indexerPath);
+    const parsed = loadStructuredFile(indexerPath);
+    const handlerSummary = summarizeHandlers(parsed);
+    const context = {
+        registry,
+        thresholds,
+        targetName: options.targetName ?? indexerPath
+    };
+    const findings = [
+        ...detectNativeEthTransferLogReadiness(handlerSummary, rawText, context),
+        ...detectMissingBalIndexerPlan(rawText, context),
+        ...detectMissingCompatibilityMetadata(rawText),
+        ...detectMissingReplayPlan(rawText)
+    ];
+    return makeReport({
+        fork: registry.fork,
+        target: {
+            kind: "indexer",
+            name: options.targetName ?? indexerPath
+        },
+        findings,
+        assumptions: [
+            "JSON and YAML configs were parsed statically; subgraph-style handler fields were summarized when present.",
+            `The loaded registry is dated ${registry.lastUpdated}. Glamsterdam scope and gas parameters may change.`
+        ],
+        limitations: [
+            "Static indexer configuration cannot prove runtime indexing behavior.",
+            "Heuristics may miss compatibility logic implemented in code, environment variables, infrastructure manifests, or downstream pipelines.",
+            "Findings marked heuristic should be treated as review prompts."
+        ]
+    });
+}
+export function summarizeHandlers(config) {
+    const dataSources = findArraysByKey(config, "dataSources").flat();
+    const templates = findArraysByKey(config, "templates").flat();
+    const sources = [...dataSources, ...templates].filter(isRecord);
+    if (sources.length === 0) {
+        return {
+            eventHandlers: countArraysByKey(config, "eventHandlers"),
+            callHandlers: countArraysByKey(config, "callHandlers"),
+            blockHandlers: countArraysByKey(config, "blockHandlers")
+        };
+    }
+    return sources.reduce((summary, source) => {
+        const mapping = isRecord(source.mapping) ? source.mapping : source;
+        summary.eventHandlers += arrayLength(mapping.eventHandlers);
+        summary.callHandlers += arrayLength(mapping.callHandlers);
+        summary.blockHandlers += arrayLength(mapping.blockHandlers);
+        return summary;
+    }, { eventHandlers: 0, callHandlers: 0, blockHandlers: 0 });
+}
+function detectMissingCompatibilityMetadata(rawText) {
+    const lower = rawText.toLowerCase();
+    const hasMetadata = lower.includes("glamsterdam")
+        || lower.includes("eip")
+        || lower.includes("fork")
+        || lower.includes("compatibility");
+    if (hasMetadata) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "indexer.missing-fork-compatibility-metadata",
+            title: "No explicit fork or EIP compatibility metadata found",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("indexer", "tooling"),
+            relatedEips: ["EIP-7928", "EIP-7708"],
+            description: "The config does not include explicit Glamsterdam, fork, or EIP compatibility metadata. That may be fine for older configs, but it makes readiness tracking harder.",
+            evidence: ["No Glamsterdam/fork/EIP/compatibility marker found in configuration text."],
+            recommendation: "Add a small compatibility section that records reviewed EIPs, replay status, testnet/devnet coverage, and owner notes."
+        })
+    ];
+}
+function detectMissingReplayPlan(rawText) {
+    const lower = rawText.toLowerCase();
+    const hasReplayPlan = lower.includes("replay")
+        || lower.includes("testnet")
+        || lower.includes("devnet")
+        || lower.includes("fork test")
+        || lower.includes("fork-test");
+    if (hasReplayPlan) {
+        return [];
+    }
+    return [
+        makeFinding({
+            id: "indexer.missing-replay-plan",
+            title: "No replay, testnet, or devnet plan found",
+            severity: "medium",
+            confidence: "medium",
+            domain: domains("indexer", "monitoring"),
+            relatedEips: ["EIP-7928", "EIP-7708", "GAS-REPRICING"],
+            description: "The config does not mention a replay or testnet/devnet plan. Indexer compatibility is usually validated by replaying representative data rather than by static config alone.",
+            evidence: ["No replay/testnet/devnet marker found in configuration text."],
+            recommendation: "Add a replay plan that covers historical sync, recent blocks, expected reorg behavior, native ETH transfer handling, and BAL-related block data."
+        })
+    ];
+}
+function countArraysByKey(value, key) {
+    return findArraysByKey(value, key).reduce((total, array) => total + array.length, 0);
+}
+function findArraysByKey(value, key) {
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => findArraysByKey(item, key));
+    }
+    if (!isRecord(value)) {
+        return [];
+    }
+    const own = Array.isArray(value[key]) ? [value[key]] : [];
+    const nested = Object.values(value).flatMap((child) => findArraysByKey(child, key));
+    return [...own, ...nested];
+}
+function arrayLength(value) {
+    return Array.isArray(value) ? value.length : 0;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=indexerScanner.js.map

package/dist/scanners/indexerScanner.js.map

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

package/dist/scanners/rpcTraceScanner.d.ts

@@ -0,0 +1,40 @@
+import { type TraceScanOptions } from "./traceScanner.js";
+import type { CompatibilityReport } from "../reports/reportTypes.js";
+export type DebugTraceMode = "structLogs" | "callTracer";
+export type RpcFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface FetchDebugTraceOptions {
+    rpcUrl: string;
+    txHash: string;
+    tracer?: DebugTraceMode;
+    traceTimeout?: string;
+    rpcTimeoutMs?: number;
+    fetch?: RpcFetch;
+}
+export interface ScanTransactionTraceOptions extends TraceScanOptions, FetchDebugTraceOptions {
+}
+interface JsonRpcError {
+    code?: number;
+    message?: string;
+    data?: unknown;
+}
+interface JsonRpcEnvelope {
+    jsonrpc?: string;
+    id?: unknown;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+export declare function scanTransactionTrace(options: ScanTransactionTraceOptions): Promise<CompatibilityReport>;
+export interface ScannedTransactionTrace {
+    trace: JsonRpcEnvelope;
+    report: CompatibilityReport;
+}
+export declare function fetchAndScanTransactionTrace(options: ScanTransactionTraceOptions): Promise<ScannedTransactionTrace>;
+export declare function scanFetchedTransactionTrace(traceEnvelope: unknown, options: TraceScanOptions & {
+    txHash: string;
+    tracer?: DebugTraceMode;
+}): CompatibilityReport;
+export declare function writeFetchedTrace(traceEnvelope: unknown, traceOutPath: string): string;
+export declare function fetchDebugTraceTransaction(options: FetchDebugTraceOptions): Promise<JsonRpcEnvelope>;
+export declare function normalizeTxHash(txHash: string): string;
+export declare function parseDebugTraceMode(value: string): DebugTraceMode;
+export {};

package/dist/scanners/rpcTraceScanner.js

@@ -0,0 +1,121 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { scanTrace } from "./traceScanner.js";
+const defaultTraceTimeout = "30s";
+const defaultRpcTimeoutMs = 30_000;
+export async function scanTransactionTrace(options) {
+    const { report } = await fetchAndScanTransactionTrace(options);
+    return report;
+}
+export async function fetchAndScanTransactionTrace(options) {
+    const traceEnvelope = await fetchDebugTraceTransaction(options);
+    return {
+        trace: traceEnvelope,
+        report: scanFetchedTransactionTrace(traceEnvelope, options)
+    };
+}
+export function scanFetchedTransactionTrace(traceEnvelope, options) {
+    const tracer = options.tracer ?? "structLogs";
+    const report = scanTrace(traceEnvelope, {
+        ...options,
+        targetName: options.targetName ?? `tx ${options.txHash}`
+    });
+    return {
+        ...report,
+        assumptions: [
+            `Trace was fetched with debug_traceTransaction using ${tracer} mode.`,
+            ...report.assumptions
+        ],
+        limitations: [
+            ...report.limitations,
+            "RPC trace availability, tracer names, and returned fields vary by execution client and node configuration.",
+            "The RPC URL is intentionally not included in the report target or evidence."
+        ]
+    };
+}
+export function writeFetchedTrace(traceEnvelope, traceOutPath) {
+    const resolvedPath = resolve(process.cwd(), traceOutPath);
+    mkdirSync(dirname(resolvedPath), { recursive: true });
+    writeFileSync(resolvedPath, `${JSON.stringify(traceEnvelope, null, 2)}\n`, "utf8");
+    return resolvedPath;
+}
+export async function fetchDebugTraceTransaction(options) {
+    const txHash = normalizeTxHash(options.txHash);
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+        throw new Error("No fetch implementation is available. Use Node.js 20+ or provide a fetch implementation.");
+    }
+    const controller = new AbortController();
+    const timeoutMs = options.rpcTimeoutMs ?? defaultRpcTimeoutMs;
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchImpl(options.rpcUrl, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json"
+            },
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: 1,
+                method: "debug_traceTransaction",
+                params: [txHash, traceConfig(options.tracer ?? "structLogs", options.traceTimeout ?? defaultTraceTimeout)]
+            }),
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            throw new Error(`RPC request failed with HTTP ${response.status}.`);
+        }
+        const payload = await response.json();
+        if (payload.error) {
+            const code = typeof payload.error.code === "number" ? ` ${payload.error.code}` : "";
+            const message = payload.error.message ?? "Unknown JSON-RPC error";
+            throw new Error(`RPC debug_traceTransaction failed${code}: ${message}`);
+        }
+        if (!("result" in payload) || payload.result === null || payload.result === undefined) {
+            throw new Error("RPC debug_traceTransaction returned no trace result.");
+        }
+        return {
+            jsonrpc: payload.jsonrpc ?? "2.0",
+            id: payload.id ?? 1,
+            result: payload.result
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new Error(`RPC request timed out after ${timeoutMs}ms.`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function normalizeTxHash(txHash) {
+    const normalized = txHash.trim();
+    if (!/^0x[0-9a-fA-F]{64}$/.test(normalized)) {
+        throw new Error("Transaction hash must be a 0x-prefixed 32-byte hex string.");
+    }
+    return normalized;
+}
+export function parseDebugTraceMode(value) {
+    if (value === "structLogs" || value === "callTracer") {
+        return value;
+    }
+    throw new Error(`Unsupported trace mode "${value}". Use "structLogs" or "callTracer".`);
+}
+function traceConfig(tracer, timeout) {
+    if (tracer === "callTracer") {
+        return {
+            tracer: "callTracer",
+            timeout
+        };
+    }
+    return {
+        disableStack: true,
+        disableStorage: true,
+        enableMemory: false,
+        enableReturnData: false,
+        timeout
+    };
+}
+//# sourceMappingURL=rpcTraceScanner.js.map

package/dist/scanners/rpcTraceScanner.js.map

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

package/dist/scanners/traceScanner.d.ts

@@ -0,0 +1,24 @@
+import { type DetectorThresholds } from "../detectors/thresholds.js";
+import type { EipRegistry } from "../registry/schemas.js";
+import { type CompatibilityReport } from "../reports/reportTypes.js";
+export interface NormalizedTraceStep {
+    op: string;
+    depth?: number;
+    gas?: number;
+    gasCost?: number;
+    calldataBytes?: number;
+    logs?: number;
+}
+export interface TraceScanOptions {
+    registry?: EipRegistry;
+    registryPath?: string;
+    thresholds?: DetectorThresholds;
+    thresholdsPath?: string;
+    targetName?: string;
+}
+export declare function scanTraceFile(traceFile: string, options?: TraceScanOptions): CompatibilityReport;
+export declare function scanTrace(input: unknown, options?: TraceScanOptions): CompatibilityReport;
+export declare function normalizeTrace(input: unknown): {
+    steps: NormalizedTraceStep[];
+    warnings: string[];
+};