gate-evm-tools 1.0.28 → 1.0.31

package/dist-runtime/miner/binary.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCreate2MinerBinary = resolveCreate2MinerBinary;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// These trusted pins are compiled into the runtime. A mutable manifest alone is not a trust anchor.
+const bundled = {
+    "darwin-arm64": { sha256: "9611c1ca900c24f9b14924a144b7a3ab431111b855e676f2e145e7ab8c05f954", bytes: 1297616 },
+    "darwin-x64": { sha256: "a38279143658a8849db484e248c62af6ae2db78de4251021f195efd9bf987d82", bytes: 1306112 },
+};
+function executable(file) {
+    try {
+        if (!(0, node_fs_1.statSync)(file).isFile())
+            throw new Error("not a regular file");
+        (0, node_fs_1.accessSync)(file, node_fs_1.constants.X_OK);
+        if (process.platform !== "win32" && ((0, node_fs_1.statSync)(file).mode & 0o111) === 0)
+            throw new Error("missing executable permission");
+    }
+    catch (cause) {
+        throw new Error(`CREATE2 miner is not an executable file: ${file}`, { cause });
+    }
+}
+function resolveCreate2MinerBinary(options = {}) {
+    const override = options.binaryPath !== undefined ? options.binaryPath : process.env.GATE_TOOL_CREATE2_MINER_BIN;
+    if (override !== undefined) {
+        if (typeof override !== "string" || override.trim().length === 0)
+            throw new Error("CREATE2 miner binaryPath override must be a non-empty path");
+        const file = (0, node_path_1.resolve)(override);
+        executable(file);
+        return file;
+    }
+    const host = `${process.platform}-${process.arch}`;
+    const pin = bundled[host];
+    if (!pin)
+        throw new Error(`No bundled CREATE2 miner for ${host}. Build a compatible smartflow_miner and set GATE_TOOL_CREATE2_MINER_BIN or binaryPath to its executable path.`);
+    const directory = (0, node_path_1.resolve)(__dirname, "../../resources/create2");
+    const file = (0, node_path_1.resolve)(directory, host, "smartflow_miner");
+    executable(file);
+    const bytes = (0, node_fs_1.readFileSync)(file);
+    if (bytes.length !== pin.bytes || (0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex") !== pin.sha256)
+        throw new Error(`Bundled CREATE2 miner SHA-256 mismatch: ${file}; reinstall the package or supply a trusted binaryPath`);
+    let entry;
+    try {
+        entry = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.resolve)(directory, "manifest.json"), "utf8")).binaries?.[host];
+    }
+    catch (cause) {
+        throw new Error("Bundled CREATE2 miner manifest is invalid", { cause });
+    }
+    if (!entry || entry.sha256 !== pin.sha256 || entry.bytes !== pin.bytes)
+        throw new Error(`Bundled CREATE2 miner manifest mismatch for ${host}`);
+    return file;
+}
+//# sourceMappingURL=binary.js.map

package/dist-runtime/miner/binary.js.map

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

package/dist-runtime/miner/cli.d.ts

@@ -0,0 +1 @@
+export declare function runCreate2MinerCli(args?: string[]): Promise<void>;

package/dist-runtime/miner/cli.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCreate2MinerCli = runCreate2MinerCli;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const runner_1 = require("./runner");
+const request_1 = require("./request");
+const help = `Usage: gate-tool miner --request request.json [--output result.json] [--binary /absolute/path] [--timeout-ms N]
+
+Prepare and verify CREATE2 salts locally; no RPC, signing or deployment.
+  --request <path>     Request JSON file, or - to read stdin (required)
+  --output <path>      Atomically save verified result JSON after success
+  --binary <path>      Trusted native executable override
+  --timeout-ms <N>     Positive integer milliseconds (default: 300000)
+  -h, --help          Show this help
+
+Requires ethers v6. See docs/create2-miner.md for schemes and backend limits.
+`;
+async function sameFile(input, output) {
+    if ((0, node_path_1.resolve)(input) === (0, node_path_1.resolve)(output))
+        return true;
+    try {
+        const [a, b] = await Promise.all([(0, promises_1.stat)(input), (0, promises_1.stat)(output)]);
+        return a.dev === b.dev && a.ino === b.ino;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        return false;
+    }
+}
+async function stdinJson(signal) {
+    return new Promise((resolveInput, reject) => {
+        const chunks = [];
+        let size = 0;
+        const cleanup = () => { process.stdin.off("data", data); process.stdin.off("end", end); process.stdin.off("error", fail); signal.removeEventListener("abort", abort); process.stdin.pause(); };
+        const fail = (error) => { cleanup(); reject(error); };
+        const abort = () => fail(new Error("CREATE2 mining aborted while reading stdin"));
+        const data = (chunk) => { size += chunk.length; if (size > 1024 * 1024)
+            fail(new Error("request stdin exceeds 1 MiB limit"));
+        else
+            chunks.push(chunk); };
+        const end = () => { cleanup(); resolveInput(Buffer.concat(chunks).toString("utf8")); };
+        process.stdin.on("data", data);
+        process.stdin.once("end", end);
+        process.stdin.once("error", fail);
+        signal.addEventListener("abort", abort, { once: true });
+        if (signal.aborted)
+            abort();
+    });
+}
+function checkCancellation(signal) {
+    if (signal.aborted)
+        throw new Error("CREATE2 mining aborted");
+}
+async function atomicOutput(file, content, signal) {
+    // Resolve the parent, not the target: rename replaces a symlink rather than following it.
+    const parent = await (0, promises_1.realpath)((0, node_path_1.dirname)((0, node_path_1.resolve)(file)));
+    const target = (0, node_path_1.join)(parent, (0, node_path_1.basename)(file));
+    const temporary = (0, node_path_1.join)(parent, `.${(0, node_path_1.basename)(file)}.${(0, node_crypto_1.randomUUID)()}.tmp`);
+    try {
+        checkCancellation(signal);
+        await (0, promises_1.writeFile)(temporary, content, { flag: "wx", mode: 0o600, signal });
+        checkCancellation(signal);
+        await (0, promises_1.rename)(temporary, target);
+        // A signal during rename cannot undo its atomic commit, but must suppress success reporting.
+        checkCancellation(signal);
+    }
+    finally {
+        await (0, promises_1.unlink)(temporary).catch(error => { if (error.code !== "ENOENT")
+            throw error; });
+    }
+}
+async function runCreate2MinerCli(args = process.argv.slice(3)) {
+    const controller = new AbortController();
+    const interrupt = () => { controller.abort(); };
+    process.on("SIGINT", interrupt);
+    process.on("SIGTERM", interrupt);
+    try {
+        if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+            process.stdout.write(help);
+            return;
+        }
+        const values = {};
+        for (let index = 0; index < args.length; index += 2) {
+            const flag = args[index];
+            const value = args[index + 1];
+            if (!["--request", "--output", "--binary", "--timeout-ms"].includes(flag))
+                throw new Error(`Unknown miner option ${flag}; use miner --help`);
+            if (flag in values)
+                throw new Error(`Duplicate miner option ${flag}`);
+            if (!value || value.startsWith("--"))
+                throw new Error(`${flag} requires a value`);
+            values[flag] = value;
+        }
+        if (!values["--request"])
+            throw new Error("--request is required; use miner --help");
+        const input = values["--request"];
+        const output = values["--output"];
+        if (input !== "-" && output && await sameFile(input, output))
+            throw new Error("--output must not be the request file");
+        const timeout = values["--timeout-ms"];
+        if (timeout !== undefined && !/^[0-9]+$/.test(timeout))
+            throw new Error("--timeout-ms must be a positive integer");
+        const content = input === "-" ? await stdinJson(controller.signal) : await (0, promises_1.readFile)(input, { encoding: "utf8", signal: controller.signal });
+        let request;
+        try {
+            request = JSON.parse(content);
+        }
+        catch (cause) {
+            throw new Error("Request is not valid JSON", { cause });
+        }
+        const result = await (0, runner_1.mineCreate2)((0, request_1.normalizeCreate2MinerRequest)(request), { binaryPath: values["--binary"], timeoutMs: timeout === undefined ? undefined : Number(timeout), signal: controller.signal });
+        const json = JSON.stringify(result, null, 2) + "\n";
+        checkCancellation(controller.signal);
+        if (output)
+            await atomicOutput(output, json, controller.signal);
+        checkCancellation(controller.signal);
+        process.stdout.write(json);
+    }
+    catch (error) {
+        process.stderr.write(`CREATE2 miner: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    }
+    finally {
+        process.off("SIGINT", interrupt);
+        process.off("SIGTERM", interrupt);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist-runtime/miner/cli.js.map

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

package/dist-runtime/miner/index.d.ts

@@ -0,0 +1,5 @@
+export type * from "./types";
+export { normalizeCreate2MinerRequest, create2MinerRequestFromArtifact } from "./request";
+export { verifyCreate2MinerResponse } from "./verify";
+export { resolveCreate2MinerBinary } from "./binary";
+export { mineCreate2 } from "./runner";

package/dist-runtime/miner/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mineCreate2 = exports.resolveCreate2MinerBinary = exports.verifyCreate2MinerResponse = exports.create2MinerRequestFromArtifact = exports.normalizeCreate2MinerRequest = void 0;
+var request_1 = require("./request");
+Object.defineProperty(exports, "normalizeCreate2MinerRequest", { enumerable: true, get: function () { return request_1.normalizeCreate2MinerRequest; } });
+Object.defineProperty(exports, "create2MinerRequestFromArtifact", { enumerable: true, get: function () { return request_1.create2MinerRequestFromArtifact; } });
+var verify_1 = require("./verify");
+Object.defineProperty(exports, "verifyCreate2MinerResponse", { enumerable: true, get: function () { return verify_1.verifyCreate2MinerResponse; } });
+var binary_1 = require("./binary");
+Object.defineProperty(exports, "resolveCreate2MinerBinary", { enumerable: true, get: function () { return binary_1.resolveCreate2MinerBinary; } });
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "mineCreate2", { enumerable: true, get: function () { return runner_1.mineCreate2; } });
+//# sourceMappingURL=index.js.map

package/dist-runtime/miner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../runtime/miner/index.ts"],"names":[],"mappings":";;;AACA,qCAA0F;AAAjF,uHAAA,4BAA4B,OAAA;AAAE,0HAAA,+BAA+B,OAAA;AACtE,mCAAsD;AAA7C,oHAAA,0BAA0B,OAAA;AACnC,mCAAqD;AAA5C,mHAAA,yBAAyB,OAAA;AAClC,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

package/dist-runtime/miner/request.d.ts

@@ -0,0 +1,7 @@
+import type { Create2MinerActualBackend, Create2MinerArtifactInput, Create2MinerBackend, NormalizedCreate2MinerRequest } from "./types";
+export declare function record(value: unknown, label: string): Record<string, unknown>;
+export declare function onlyKeys(value: Record<string, unknown>, keys: readonly string[], label: string): void;
+export declare function fixedHex(value: unknown, bytes: number, label: string): string;
+export declare function actualBackend(backend: Create2MinerBackend): Create2MinerActualBackend;
+export declare function normalizeCreate2MinerRequest(input: unknown): NormalizedCreate2MinerRequest;
+export declare function create2MinerRequestFromArtifact(input: Create2MinerArtifactInput): NormalizedCreate2MinerRequest;

package/dist-runtime/miner/request.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.record = record;
+exports.onlyKeys = onlyKeys;
+exports.fixedHex = fixedHex;
+exports.actualBackend = actualBackend;
+exports.normalizeCreate2MinerRequest = normalizeCreate2MinerRequest;
+exports.create2MinerRequestFromArtifact = create2MinerRequestFromArtifact;
+const create2Hashes_1 = require("../workflow/lib/create2Hashes");
+function record(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${label} must be an object`);
+    return value;
+}
+function onlyKeys(value, keys, label) {
+    for (const key of Object.keys(value))
+        if (!keys.includes(key))
+            throw new Error(`${label}: unsupported field ${key}`);
+}
+function fixedHex(value, bytes, label) {
+    if (typeof value !== "string" || !new RegExp(`^0x[0-9a-fA-F]{${bytes * 2}}$`).test(value))
+        throw new Error(`${label} must be a 0x-prefixed ${bytes}-byte hex value`);
+    return value.toLowerCase();
+}
+function integer(value, fallback, min, max, label) {
+    const number = value === undefined ? fallback : value;
+    if (typeof number !== "number" || !Number.isInteger(number) || number < min || number > max)
+        throw new Error(`${label} must be an integer from ${min} to ${max}`);
+    return number;
+}
+function actualBackend(backend) {
+    return backend === "auto" || backend === "gpu" ? (process.platform === "darwin" ? "metal" : "opencl") : backend;
+}
+const controls = ["factory", "caller", "leadingZeroBytes", "leadingPattern", "targetCount", "backend"];
+function normalizeCreate2MinerRequest(input) {
+    const value = record(input, "request");
+    const scheme = value.scheme === undefined ? "evm" : value.scheme;
+    if (scheme !== "evm" && scheme !== "zksync-eravm")
+        throw new Error("scheme must be evm or zksync-eravm");
+    onlyKeys(value, [...controls, "scheme", ...(scheme === "evm" ? ["initCodeHash"] : ["bytecodeHash", "constructorInputHash"])], "request");
+    const backend = value.backend === undefined ? "auto" : value.backend;
+    if (backend !== "auto" && backend !== "cpu" && backend !== "gpu" && backend !== "metal" && backend !== "opencl")
+        throw new Error("backend must be auto, cpu, gpu, metal or opencl");
+    const leadingPattern = integer(value.leadingPattern, 0, 0, 255, "leadingPattern");
+    if (backend !== "cpu" && (leadingPattern & 15) !== (leadingPattern >> 4))
+        throw new Error("GPU leadingPattern requires a repeated-nibble byte (0x00, 0x11, …, 0xff); use backend cpu for other patterns");
+    if (backend === "metal" && process.platform !== "darwin")
+        throw new Error("Metal backend requires macOS; use cpu or opencl on this platform");
+    const common = {
+        factory: fixedHex(value.factory, 20, "factory"), caller: fixedHex(value.caller, 20, "caller"),
+        leadingZeroBytes: integer(value.leadingZeroBytes, 0, 0, 20, "leadingZeroBytes"), leadingPattern,
+        targetCount: integer(value.targetCount, 1, 1, 100, "targetCount"), backend: backend,
+    };
+    return scheme === "evm"
+        ? { ...common, scheme, initCodeHash: fixedHex(value.initCodeHash, 32, "initCodeHash") }
+        : { ...common, scheme, bytecodeHash: fixedHex(value.bytecodeHash, 32, "bytecodeHash"), constructorInputHash: fixedHex(value.constructorInputHash, 32, "constructorInputHash") };
+}
+function create2MinerRequestFromArtifact(input) {
+    const value = record(input, "artifact request");
+    onlyKeys(value, [...controls, "scheme", "artifact", "args"], "artifact request");
+    const artifact = record(value.artifact, "artifact");
+    if (typeof artifact.bytecode !== "string" || !/^0x(?:[0-9a-fA-F]{2})+$/.test(artifact.bytecode))
+        throw new Error("artifact bytecode must be non-empty, linked, byte-aligned hex");
+    if (!Array.isArray(value.args))
+        throw new Error("artifact args must be an array");
+    // Validate format and hash constructor arguments through the workflow's canonical implementation.
+    if (value.scheme !== undefined && value.scheme !== "evm" && value.scheme !== "zksync-eravm")
+        throw new Error("scheme must be evm or zksync-eravm");
+    const { artifact: _artifact, args: _args, scheme: _scheme, ...rest } = value;
+    const hashes = (0, create2Hashes_1.canonicalCreate2Hashes)(input);
+    return normalizeCreate2MinerRequest({ ...rest, ...hashes });
+}
+//# sourceMappingURL=request.js.map

package/dist-runtime/miner/request.js.map

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

package/dist-runtime/miner/runner.d.ts

@@ -0,0 +1,2 @@
+import type { Create2MinerOptions, Create2MinerRequest, Create2MinerResponse } from "./types";
+export declare function mineCreate2(input: Create2MinerRequest, options?: Create2MinerOptions): Promise<Create2MinerResponse>;

package/dist-runtime/miner/runner.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mineCreate2 = mineCreate2;
+const node_child_process_1 = require("node:child_process");
+const node_perf_hooks_1 = require("node:perf_hooks");
+const binary_1 = require("./binary");
+const request_1 = require("./request");
+const verify_1 = require("./verify");
+const STDOUT_LIMIT = 1024 * 1024;
+const STDERR_LIMIT = 64 * 1024;
+const DEFAULT_TIMEOUT_MS = 300_000;
+const KILL_GRACE_MS = 250;
+function aborted() { const error = new Error("CREATE2 mining aborted"); error.name = "AbortError"; return error; }
+async function mineCreate2(input, options = {}) {
+    // Snapshot normalized inputs before any asynchronous work so callers cannot change verification intent.
+    const request = (0, request_1.normalizeCreate2MinerRequest)(input);
+    const timeoutMs = options.timeoutMs === undefined ? DEFAULT_TIMEOUT_MS : options.timeoutMs;
+    if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 2_147_483_647)
+        throw new Error("timeoutMs must be a positive integer at most 2147483647");
+    const { signal, onProgress } = options;
+    if (signal !== undefined && !(signal instanceof AbortSignal))
+        throw new Error("signal must be an AbortSignal");
+    if (onProgress !== undefined && typeof onProgress !== "function")
+        throw new Error("onProgress must be a function");
+    if (signal?.aborted)
+        throw aborted();
+    const binary = (0, binary_1.resolveCreate2MinerBinary)(options);
+    return new Promise((resolve, reject) => {
+        const started = node_perf_hooks_1.performance.now();
+        const child = (0, node_child_process_1.spawn)(binary, [], { shell: false, windowsHide: true, stdio: ["pipe", "pipe", "pipe"] });
+        let failure;
+        let closed = false;
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        const stdout = [];
+        const stderr = [];
+        let killTimer;
+        let progressTimer;
+        const stop = (error) => {
+            if (closed || failure)
+                return;
+            failure = error;
+            clearTimeout(timeoutTimer);
+            clearInterval(progressTimer);
+            child.kill("SIGTERM");
+            killTimer = setTimeout(() => { if (!closed)
+                child.kill("SIGKILL"); }, KILL_GRACE_MS);
+        };
+        const onAbort = () => stop(aborted());
+        const onError = (cause) => stop(new Error(`Could not spawn CREATE2 miner ${binary}: ${cause.message}`, { cause }));
+        const onStdinError = (cause) => stop(new Error(`CREATE2 miner stdin failed: ${cause.message}`, { cause }));
+        const onStdout = (chunk) => {
+            if (failure)
+                return;
+            stdoutBytes += chunk.length;
+            if (stdoutBytes > STDOUT_LIMIT)
+                stop(new Error(`CREATE2 miner stdout exceeded ${STDOUT_LIMIT}-byte limit`));
+            else
+                stdout.push(chunk);
+        };
+        const onStderr = (chunk) => {
+            if (failure)
+                return;
+            stderrBytes += chunk.length;
+            if (stderrBytes > STDERR_LIMIT)
+                stop(new Error(`CREATE2 miner stderr exceeded ${STDERR_LIMIT}-byte limit`));
+            else
+                stderr.push(chunk);
+        };
+        const timeoutTimer = setTimeout(() => stop(new Error(`CREATE2 mining timed out after ${timeoutMs} ms`)), timeoutMs);
+        child.on("error", onError);
+        child.stdin.on("error", onStdinError);
+        child.stdout.on("data", onStdout);
+        child.stderr.on("data", onStderr);
+        child.once("close", (code, terminationSignal) => {
+            closed = true;
+            clearTimeout(timeoutTimer);
+            clearTimeout(killTimer);
+            clearInterval(progressTimer);
+            signal?.removeEventListener("abort", onAbort);
+            child.removeListener("error", onError);
+            child.stdin.removeListener("error", onStdinError);
+            child.stdout.removeListener("data", onStdout);
+            child.stderr.removeListener("data", onStderr);
+            // Settle only after close, which follows exit and closure of stdio: cancellation reaps the child.
+            if (failure) {
+                reject(failure);
+                return;
+            }
+            const text = Buffer.concat(stdout).toString("utf8");
+            if (code !== 0) {
+                const diagnostic = (Buffer.concat(stderr).toString("utf8") || text).trim().slice(0, 4096);
+                reject(new Error(`CREATE2 miner exited with ${terminationSignal ? `signal ${terminationSignal}` : `code ${code}`}${diagnostic ? `: ${diagnostic}` : ""}`));
+                return;
+            }
+            let response;
+            try {
+                response = JSON.parse(text);
+            }
+            catch (cause) {
+                reject(new Error("CREATE2 miner returned malformed JSON", { cause }));
+                return;
+            }
+            try {
+                resolve((0, verify_1.verifyCreate2MinerResponse)(request, response));
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        signal?.addEventListener("abort", onAbort, { once: true });
+        if (signal?.aborted) {
+            onAbort();
+            return;
+        }
+        if (onProgress)
+            progressTimer = setInterval(() => {
+                if (closed || failure)
+                    return;
+                try {
+                    // Also consume accidental async callback rejections without leaking an unhandled rejection.
+                    Promise.resolve(onProgress({ status: "running", elapsedMs: Math.max(0, node_perf_hooks_1.performance.now() - started) })).catch(cause => stop(cause instanceof Error ? cause : new Error(String(cause))));
+                }
+                catch (cause) {
+                    stop(cause instanceof Error ? cause : new Error(String(cause)));
+                }
+            }, 250);
+        child.stdin.end(JSON.stringify(request));
+    });
+}
+//# sourceMappingURL=runner.js.map

package/dist-runtime/miner/runner.js.map

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

package/dist-runtime/miner/types.d.ts

@@ -0,0 +1,89 @@
+import type { Create2HashArtifact } from "../workflow/lib/create2Hashes";
+export type Create2MinerScheme = "evm" | "zksync-eravm";
+export type Create2MinerBackend = "auto" | "cpu" | "gpu" | "metal" | "opencl";
+export type Create2MinerActualBackend = "cpu" | "metal" | "opencl";
+export type Create2MinerHashes = {
+    scheme: "evm";
+    initCodeHash: string;
+    bytecodeHash?: never;
+    constructorInputHash?: never;
+} | {
+    scheme: "zksync-eravm";
+    bytecodeHash: string;
+    constructorInputHash: string;
+    initCodeHash?: never;
+};
+export interface Create2MinerIdentity {
+    factory: string;
+    /** First 20 bytes of the salt; this is not necessarily the transaction sender. */
+    caller: string;
+    /** Number of leading address bytes that must equal leadingPattern. */
+    leadingZeroBytes: number;
+    leadingPattern: number;
+}
+export type NormalizedCreate2MinerRequest = Create2MinerHashes & Create2MinerIdentity & {
+    targetCount: number;
+    backend: Create2MinerBackend;
+};
+/** Caller input: omitted controls receive documented defaults. */
+export type Create2MinerRequest = ({
+    scheme?: "evm";
+    initCodeHash: string;
+    bytecodeHash?: never;
+    constructorInputHash?: never;
+} | {
+    scheme: "zksync-eravm";
+    bytecodeHash: string;
+    constructorInputHash: string;
+    initCodeHash?: never;
+}) & Pick<Create2MinerIdentity, "factory" | "caller"> & Partial<Pick<Create2MinerIdentity, "leadingZeroBytes" | "leadingPattern">> & {
+    targetCount?: number;
+    backend?: Create2MinerBackend;
+};
+export interface Create2MinerArtifactInput {
+    scheme?: Create2MinerScheme;
+    artifact: Create2HashArtifact;
+    args: unknown[];
+    factory: string;
+    caller: string;
+    leadingZeroBytes?: number;
+    leadingPattern?: number;
+    targetCount?: number;
+    backend?: Create2MinerBackend;
+}
+export interface Create2MinerTelemetry {
+    /** Native telemetry only; GPU zero means unavailable, not zero work. */
+    attempts: number;
+    durationMs: number;
+    hashRate: number;
+}
+export type Create2MinerResult = Create2MinerHashes & Create2MinerIdentity & Create2MinerTelemetry & {
+    status: "found";
+    salt: string;
+    address: string;
+    nonce: string;
+    randomPrefix: string;
+};
+export type Create2MinerResponse = Create2MinerHashes & Create2MinerIdentity & Create2MinerTelemetry & {
+    status: "found";
+    backend: Create2MinerActualBackend;
+    targetCount: number;
+    startedAtUnixMs: number;
+    endedAtUnixMs: number;
+    results: Create2MinerResult[];
+};
+/** Alias for the verified result of a complete mining run. */
+export type Create2MinerRunResult = Create2MinerResponse;
+export interface Create2MinerProgress {
+    status: "running";
+    elapsedMs: number;
+}
+export interface Create2MinerBinaryOptions {
+    binaryPath?: string;
+}
+export interface Create2MinerOptions extends Create2MinerBinaryOptions {
+    signal?: AbortSignal;
+    /** Positive integer milliseconds; defaults to 300000 (5 minutes). */
+    timeoutMs?: number;
+    onProgress?: (progress: Create2MinerProgress) => void;
+}

package/dist-runtime/miner/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-runtime/miner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../runtime/miner/types.ts"],"names":[],"mappings":""}

package/dist-runtime/miner/verify.d.ts

@@ -0,0 +1,2 @@
+import type { Create2MinerResponse } from "./types";
+export declare function verifyCreate2MinerResponse(input: unknown, response: unknown): Create2MinerResponse;