@lionden/network 0.1.0

package/dist/devnode-manager.js

@@ -0,0 +1,546 @@
+/**
+ * DevnodeManager — manages the lifecycle of a `leo devnode start` process.
+ *
+ * Handles spawning, health-checking, and graceful shutdown.
+ */
+import { spawn } from "node:child_process";
+const DEFAULT_STANDALONE_BINARY = "aleo-devnode";
+const DEFAULT_SOCKET_ADDR = "127.0.0.1:3030";
+const DEFAULT_PRIVATE_KEY = "APrivateKey1zkp8CZNn3yeCseEtxuVPbDCwSyhGW6yZKUYKfgXmcpoGPWH";
+const HEALTH_CHECK_INTERVAL_MS = 200;
+const HEALTH_CHECK_TIMEOUT_MS = 30_000;
+const SHUTDOWN_TIMEOUT_MS = 5_000;
+const EXIT_DRAIN_GRACE_MS = 1_000;
+const LOG_BUFFER_BYTES = 64 * 1024;
+const LOG_TAIL_RENDER_BYTES = 4 * 1024;
+/**
+ * Whether `leo devnode start` for the given `leoVersion` still accepts the
+ * `--consensus-heights` / `--network` flags. Leo 4.3 removed both from the
+ * `devnode start` subcommand, so they are only emitted for Leo < 4.3. An
+ * unparseable/unset version is treated as modern (>= 4.3) and omits both —
+ * emitting a removed flag is a hard `devnode start` failure, whereas omitting
+ * one on an older line only drops the (now-obsolete) explicit heights/network.
+ * Mirrors `emitsLegacyBuildFlags` in leo-compiler.
+ */
+function devnodeEmitsLegacyFlags(leoVersion) {
+    if (!leoVersion)
+        return false;
+    const match = /^(\d+)\.(\d+)\./.exec(leoVersion);
+    if (!match)
+        return false;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major < 4 || (major === 4 && minor < 3);
+}
+/**
+ * Bounded byte ring buffer backed by a list of chunks. Trims the oldest bytes
+ * (slicing the head chunk if needed) until total bytes ≤ `maxBytes`.
+ */
+class RingBuffer {
+    maxBytes;
+    chunks = [];
+    byteLength = 0;
+    constructor(maxBytes) {
+        this.maxBytes = maxBytes;
+    }
+    append(chunk) {
+        if (chunk.length === 0)
+            return;
+        this.chunks.push(chunk);
+        this.byteLength += chunk.length;
+        while (this.byteLength > this.maxBytes && this.chunks.length > 0) {
+            const head = this.chunks[0];
+            const overflow = this.byteLength - this.maxBytes;
+            if (head.length <= overflow) {
+                this.chunks.shift();
+                this.byteLength -= head.length;
+            }
+            else {
+                this.chunks[0] = head.subarray(overflow);
+                this.byteLength -= overflow;
+            }
+        }
+    }
+    toString() {
+        if (this.chunks.length === 0)
+            return "";
+        return Buffer.concat(this.chunks, this.byteLength).toString("utf8");
+    }
+}
+/** Map a `DevnodeLogMode` to the corresponding `spawn` stdio array. */
+export function stdioConfigForMode(logMode) {
+    if (logMode === "inherit")
+        return ["ignore", "inherit", "inherit"];
+    return ["ignore", "pipe", "pipe"];
+}
+/**
+ * Attach drain listeners to the child's piped streams per `logMode`. Owns the
+ * internal ring buffers; returns a handle whose `getTail()` produces the
+ * current buffered tail (≤ 64 KiB per stream). For `logMode: "inherit"`
+ * returns an empty-tail handle without touching the streams.
+ */
+export function setupChildLogging(proc, logMode, callbacks) {
+    if (logMode === "inherit") {
+        return { getTail: () => ({ stdout: "", stderr: "" }) };
+    }
+    const stdoutBuf = new RingBuffer(LOG_BUFFER_BYTES);
+    const stderrBuf = new RingBuffer(LOG_BUFFER_BYTES);
+    proc.stdout?.on("data", (chunk) => {
+        stdoutBuf.append(chunk);
+        if (logMode === "forward")
+            callbacks?.onStdout?.(chunk);
+    });
+    proc.stderr?.on("data", (chunk) => {
+        stderrBuf.append(chunk);
+        if (logMode === "forward")
+            callbacks?.onStderr?.(chunk);
+    });
+    return {
+        getTail: () => ({
+            stdout: stdoutBuf.toString(),
+            stderr: stderrBuf.toString(),
+        }),
+    };
+}
+function formatExit(code, signal) {
+    if (signal !== null && code !== null)
+        return `code ${code} signal ${signal}`;
+    if (signal !== null)
+        return `signal ${signal}`;
+    return `code ${code ?? "null"}`;
+}
+function resolveLogMode(opts) {
+    if (opts.logMode !== undefined) {
+        return {
+            mode: opts.logMode,
+            callbacks: opts.onStdout || opts.onStderr
+                ? { onStdout: opts.onStdout, onStderr: opts.onStderr }
+                : undefined,
+        };
+    }
+    const env = process.env["LIONDEN_DEVNODE_LOGS"];
+    if (env === "1" || env === "inherit")
+        return { mode: "inherit" };
+    if (env === "forward") {
+        const def = (chunk) => process.stderr.write(`[devnode] ${chunk.toString("utf8")}`);
+        return { mode: "forward", callbacks: { onStdout: def, onStderr: def } };
+    }
+    return { mode: "quiet-buffered" };
+}
+export class DevnodeManager {
+    process = null;
+    _endpoint = "";
+    _logMode = "quiet-buffered";
+    _logging;
+    _exitPromise;
+    _exitResolve;
+    _terminal = false;
+    _exitInfo;
+    _exitDrainTimer;
+    _shutdownInitiated = false;
+    _startResolved = false;
+    _diagnosticEmitted = false;
+    _spawnErrorMessage;
+    _provider = "leo";
+    _network = "testnet";
+    _storagePath;
+    _lastStartOptions;
+    /** REST API endpoint URL (e.g., "http://127.0.0.1:3030") */
+    get endpoint() {
+        return this._endpoint;
+    }
+    /** The resolved backend driving this devnode. */
+    get provider() {
+        return this._provider;
+    }
+    /**
+     * Whether this devnode can snapshot/restore. Requires the standalone backend
+     * AND a configured `storagePath` (in-memory devnodes cannot snapshot).
+     */
+    get capabilities() {
+        return { snapshot: this._provider === "standalone" && this._storagePath !== undefined };
+    }
+    /** Whether the devnode process is currently running. */
+    isRunning() {
+        return this.process !== null;
+    }
+    /** Snapshot of buffered child output. Empty strings for `inherit` mode. */
+    getLogTail() {
+        return this._logging?.getTail() ?? { stdout: "", stderr: "" };
+    }
+    /**
+     * Resolves with the child's terminal exit info. Resolves on `close` (or a
+     * bounded fallback after `exit` if the child never closes), or — if the child
+     * fires `error` without ever closing — with `{ code: null, signal: null }`.
+     * Throws synchronously if called before `start()`. Idempotent: every call
+     * after termination receives the same info.
+     */
+    waitForExit() {
+        if (!this._exitPromise) {
+            throw new Error("DevnodeManager has not been started");
+        }
+        return this._exitPromise;
+    }
+    /**
+     * Start a devnode process with the given options.
+     * Waits for the REST API to become healthy before returning.
+     */
+    async start(options = {}) {
+        if (this.isRunning()) {
+            throw new Error("Devnode is already running. Call stop() first.");
+        }
+        this.resetPerProcessState();
+        const { mode, callbacks } = resolveLogMode(options);
+        this._logMode = mode;
+        const socketAddr = options.socketAddr ?? DEFAULT_SOCKET_ADDR;
+        const endpoint = `http://${socketAddr}`;
+        const provider = options.provider ?? "leo";
+        // Standalone is TestnetV0-only with consensus heights compiled in. Reject
+        // unsupported inputs here too, so a caller using DevnodeManager directly
+        // (bypassing resolveDevnodeBackend) gets a clear error instead of silently
+        // querying a testnet devnode or dropping consensus heights.
+        if (provider === "standalone") {
+            if (options.network !== undefined && options.network !== "testnet") {
+                throw new Error(`The standalone aleo-devnode backend only supports the "testnet" network, but ` +
+                    `network "${options.network}" was requested. Use network: "testnet" or provider: "leo".`);
+            }
+            if (options.consensusHeights !== undefined) {
+                throw new Error(`consensusHeights is not supported on the standalone aleo-devnode backend ` +
+                    `(consensus heights are compiled in). Remove consensusHeights or use provider: "leo".`);
+            }
+            if (options.clearStorage === true && options.storagePath === undefined) {
+                throw new Error(`clearStorage requires storagePath on the standalone aleo-devnode backend.`);
+            }
+        }
+        const network = provider === "standalone" ? "testnet" : (options.network ?? "testnet");
+        const { command, argv } = this.buildSpawn(provider, options);
+        const proc = spawn(command, argv, { stdio: stdioConfigForMode(mode) });
+        this.process = proc;
+        this._logging = setupChildLogging(proc, mode, callbacks);
+        proc.once("exit", (code, signal) => {
+            this._exitInfo = { code: code ?? null, signal: signal ?? null };
+            // `close` normally follows `exit` once stdio drains. Bound the wait so a
+            // grandchild holding a pipe open can't hang stop()/waitForExit() forever.
+            this._exitDrainTimer = setTimeout(() => {
+                if (!this._terminal) {
+                    this.markTerminal(this._exitInfo.code, this._exitInfo.signal);
+                }
+            }, EXIT_DRAIN_GRACE_MS);
+            this._exitDrainTimer.unref?.();
+        });
+        proc.once("close", (code, signal) => {
+            const exitInfo = this._exitInfo ?? { code: code ?? null, signal: signal ?? null };
+            this.markTerminal(exitInfo.code, exitInfo.signal);
+        });
+        proc.once("error", (err) => {
+            const hint = provider === "standalone"
+                ? `Ensure the standalone aleo-devnode binary ("${command}") is installed and accessible.`
+                : `Ensure the Leo CLI ("${command}") is installed and accessible.`;
+            this._spawnErrorMessage = `Failed to start devnode: ${err.message}. ${hint}`;
+            if (!this._terminal)
+                this.markTerminal(null, null);
+        });
+        // `earlyExitSignal` resolves (never rejects) when the child reaches its
+        // terminal state. Used by the start-time race to detect a pre-health-check
+        // death. Designed to never reject so a later exit from a normal `stop()`
+        // can't surface as an unhandled rejection.
+        const earlyExitSignal = this._exitPromise.then(() => undefined);
+        const healthCheck = this.waitForHealthy(endpoint, network);
+        try {
+            await Promise.race([healthCheck, earlyExitSignal]);
+        }
+        catch (err) {
+            // healthCheck rejected (e.g., timeout).
+            await this.stop();
+            throw err;
+        }
+        const exitInfo = this._exitInfo;
+        if (exitInfo) {
+            if (this._shutdownInitiated) {
+                // Caller invoked stop() while start() was still racing. Honor the
+                // abort silently — they've already signaled they don't care about
+                // start's outcome.
+                return;
+            }
+            if (this._spawnErrorMessage) {
+                throw new Error(this._spawnErrorMessage);
+            }
+            throw new Error(this.renderExitError(exitInfo.code, exitInfo.signal));
+        }
+        this._startResolved = true;
+        this._provider = provider;
+        this._storagePath = options.storagePath;
+        this._lastStartOptions = options;
+        this._network = network;
+        this._endpoint = endpoint;
+    }
+    /**
+     * Stop the devnode process gracefully.
+     * Sends SIGTERM, then SIGKILL after a timeout. Awaits the terminal exit
+     * (resolved on `close`, or a bounded fallback after `exit` if the child never
+     * closes) before returning so `markTerminal` is the sole writer of
+     * `this.process`.
+     */
+    async stop() {
+        if (!this.process)
+            return;
+        this._shutdownInitiated = true;
+        const proc = this.process;
+        const exitP = this._exitPromise;
+        const killTimer = setTimeout(() => {
+            proc.kill("SIGKILL");
+        }, SHUTDOWN_TIMEOUT_MS);
+        proc.kill("SIGTERM");
+        await exitP;
+        clearTimeout(killTimer);
+    }
+    /** Reset all per-process state so a stop/start cycle is clean. */
+    resetPerProcessState() {
+        this.clearStartDerivedState();
+        this._terminal = false;
+        this._exitInfo = undefined;
+        clearTimeout(this._exitDrainTimer);
+        this._exitDrainTimer = undefined;
+        this._shutdownInitiated = false;
+        this._startResolved = false;
+        this._diagnosticEmitted = false;
+        this._spawnErrorMessage = undefined;
+        this._logging = undefined;
+        this._exitPromise = new Promise((resolve) => {
+            this._exitResolve = resolve;
+        });
+    }
+    /** Idempotent: collapse exit/error events into a single terminal state. */
+    markTerminal(code, signal) {
+        if (this._terminal)
+            return;
+        this._terminal = true;
+        if (this._exitDrainTimer) {
+            clearTimeout(this._exitDrainTimer);
+            this._exitDrainTimer = undefined;
+        }
+        this._exitInfo = { code, signal };
+        this.process = null;
+        this._exitResolve?.({ code, signal });
+        if (this._startResolved && !this._shutdownInitiated && !this._diagnosticEmitted) {
+            this._diagnosticEmitted = true;
+            this.emitUnexpectedExitDiagnostic(code, signal);
+        }
+    }
+    clearStartDerivedState() {
+        this._provider = "leo";
+        this._storagePath = undefined;
+        this._lastStartOptions = undefined;
+        this._network = "testnet";
+        this._endpoint = "";
+    }
+    emitUnexpectedExitDiagnostic(code, signal) {
+        const exitFormatted = formatExit(code, signal);
+        if (this._logMode === "inherit") {
+            process.stderr.write(`Devnode exited unexpectedly (${exitFormatted}) — see terminal logs above\n`);
+            return;
+        }
+        const tail = this.getLogTail().stderr.slice(-LOG_TAIL_RENDER_BYTES);
+        const suffix = tail.length > 0 ? (tail.endsWith("\n") ? tail : `${tail}\n`) : "";
+        process.stderr.write(`Devnode exited unexpectedly (${exitFormatted}):\n${suffix}`);
+    }
+    renderExitError(code, signal) {
+        const exitFormatted = formatExit(code, signal);
+        if (this._logMode === "inherit") {
+            return `Devnode exited (${exitFormatted}). (logs were inherited to terminal)`;
+        }
+        const tail = this.getLogTail().stderr.slice(-LOG_TAIL_RENDER_BYTES);
+        return tail.length > 0
+            ? `Devnode exited (${exitFormatted}).\n${tail}`
+            : `Devnode exited (${exitFormatted}).`;
+    }
+    /** Resolve the binary and argv for the given backend. */
+    buildSpawn(provider, options) {
+        if (provider === "standalone") {
+            return {
+                command: options.devnodeBinary ?? DEFAULT_STANDALONE_BINARY,
+                argv: ["start", ...this.buildStandaloneArgs(options)],
+            };
+        }
+        return {
+            command: options.leoBinary ?? "leo",
+            argv: ["--disable-update-check", "devnode", "start", ...this.buildLeoArgs(options)],
+        };
+    }
+    /** Build CLI arguments for `leo devnode start`. */
+    buildLeoArgs(options) {
+        const args = [];
+        const socketAddr = options.socketAddr ?? DEFAULT_SOCKET_ADDR;
+        if (socketAddr !== DEFAULT_SOCKET_ADDR) {
+            args.push("--socket-addr", socketAddr);
+        }
+        if (options.autoBlock === false) {
+            args.push("--manual-block-creation");
+        }
+        if (options.verbosity !== undefined && options.verbosity > 0) {
+            args.push("--verbosity", String(options.verbosity));
+        }
+        if (options.genesisPath) {
+            args.push("--genesis-path", options.genesisPath);
+        }
+        // `--network` and `--consensus-heights` were removed from `leo devnode start`
+        // in Leo 4.3 (the devnode is TestnetV0-only and auto-activates the latest
+        // consensus version, incl. V16/V17). Emitting either on 4.3+ is a hard clap
+        // "unexpected argument" error, so gate them to the older 4.1/4.0/3.5 lines.
+        const legacyFlags = devnodeEmitsLegacyFlags(options.leoVersion);
+        if (legacyFlags && options.network && options.network !== "testnet") {
+            args.push("--network", options.network);
+        }
+        args.push("--private-key", options.privateKey ?? DEFAULT_PRIVATE_KEY);
+        if (legacyFlags && options.consensusHeights) {
+            args.push("--consensus-heights", options.consensusHeights);
+        }
+        return args;
+    }
+    /**
+     * Build CLI arguments for `aleo-devnode start`. Unlike the Leo backend,
+     * `--verbosity` is always emitted (the standalone CLI defaults to trace=2,
+     * while Lionden's default is 0). `--network` / `--consensus-heights` are
+     * never passed — they are unsupported on standalone and rejected upstream.
+     */
+    buildStandaloneArgs(options) {
+        const args = [];
+        const socketAddr = options.socketAddr ?? DEFAULT_SOCKET_ADDR;
+        if (socketAddr !== DEFAULT_SOCKET_ADDR) {
+            args.push("--socket-addr", socketAddr);
+        }
+        if (options.autoBlock === false) {
+            args.push("--manual-block-creation");
+        }
+        args.push("--verbosity", String(options.verbosity ?? 0));
+        if (options.genesisPath) {
+            args.push("--genesis-path", options.genesisPath);
+        }
+        args.push("--private-key", options.privateKey ?? DEFAULT_PRIVATE_KEY);
+        if (options.storagePath) {
+            args.push("--storage", options.storagePath);
+        }
+        if (options.clearStorage) {
+            args.push("--clear-storage");
+        }
+        return args;
+    }
+    assertSnapshotCapable(op) {
+        if (this._provider !== "standalone") {
+            throw new Error(`${op}() requires the standalone aleo-devnode backend (provider: "standalone").`);
+        }
+        if (this._storagePath === undefined) {
+            throw new Error(`${op}() requires persistent storage. Set storagePath (devnode --storage) to enable snapshots.`);
+        }
+    }
+    /**
+     * Create a snapshot of the current ledger. Requires the standalone backend
+     * with `storagePath` set. Returns the snapshot name and the height it captured.
+     */
+    async snapshot(name) {
+        this.assertSnapshotCapable("snapshot");
+        const url = `${this._endpoint}/${this._network}/snapshot`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            // Always send a JSON body — the route uses a `Json` extractor, so an
+            // empty/absent body is a deserialization error.
+            body: JSON.stringify(name !== undefined ? { name } : {}),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Snapshot failed (HTTP ${res.status}): ${text}`);
+        }
+        return (await res.json());
+    }
+    /** List the names of available snapshots. Standalone + storage only. */
+    async listSnapshots() {
+        this.assertSnapshotCapable("listSnapshots");
+        const url = `${this._endpoint}/${this._network}/snapshots`;
+        const res = await fetch(url);
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`listSnapshots failed (HTTP ${res.status}): ${text}`);
+        }
+        return (await res.json());
+    }
+    /**
+     * Restore the ledger to a previously taken snapshot. This is an offline
+     * operation: the running devnode is stopped, `aleo-devnode restore` rewrites
+     * the storage dir, then the devnode is restarted with the original start
+     * options — except `clearStorage`, which is forced off so the restart can't
+     * wipe the ledger the restore just rebuilt. Restores chain state only —
+     * callers managing a deployment cache must invalidate it separately.
+     */
+    async restore(name) {
+        const options = this._lastStartOptions;
+        if (!options) {
+            throw new Error("Cannot restore: devnode was never started.");
+        }
+        this.assertSnapshotCapable("restore");
+        const binary = options.devnodeBinary ?? DEFAULT_STANDALONE_BINARY;
+        const storagePath = this._storagePath;
+        // Match the key start() used (it defaults to DEFAULT_PRIVATE_KEY) so the
+        // restored devnode restarts with the same validator identity.
+        const privateKey = options.privateKey ?? DEFAULT_PRIVATE_KEY;
+        await this.stop();
+        await this.runRestoreCommand(binary, name, storagePath, privateKey);
+        // Never clear storage on the post-restore restart — runRestoreCommand just
+        // rebuilt the ledger from the snapshot; --clear-storage would wipe it.
+        await this.start({ ...options, clearStorage: false });
+    }
+    runRestoreCommand(binary, name, storagePath, privateKey) {
+        return new Promise((resolve, reject) => {
+            const env = { ...process.env };
+            // Forward the key via env, never argv (keeps it off the process list).
+            if (privateKey)
+                env["PRIVATE_KEY"] = privateKey;
+            const proc = spawn(binary, ["restore", "--snapshot", name, "--storage", storagePath], {
+                stdio: ["ignore", "ignore", "pipe"],
+                env,
+            });
+            let stderr = "";
+            proc.stderr?.on("data", (chunk) => {
+                stderr += chunk.toString("utf8");
+            });
+            proc.once("error", (err) => {
+                reject(new Error(`Failed to run aleo-devnode restore: ${err.message}`));
+            });
+            proc.once("exit", (code, signal) => {
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                const tail = stderr.slice(-LOG_TAIL_RENDER_BYTES);
+                reject(new Error(`aleo-devnode restore failed (${formatExit(code ?? null, signal ?? null)})` +
+                    (tail ? `:\n${tail}` : ".")));
+            });
+        });
+    }
+    /** Poll the REST API until it responds or timeout. */
+    async waitForHealthy(endpoint, network) {
+        const url = `${endpoint}/${network}/block/height/latest`;
+        const deadline = Date.now() + HEALTH_CHECK_TIMEOUT_MS;
+        while (Date.now() < deadline) {
+            try {
+                const response = await fetch(url, {
+                    signal: AbortSignal.timeout(2_000),
+                });
+                if (response.ok)
+                    return;
+            }
+            catch {
+                // Not ready yet
+            }
+            await sleep(HEALTH_CHECK_INTERVAL_MS);
+        }
+        const tail = this.getLogTail().stderr.slice(-LOG_TAIL_RENDER_BYTES);
+        const suffix = tail.length > 0 ? `\n${tail}` : "";
+        throw new Error(`Devnode health check timed out after ${HEALTH_CHECK_TIMEOUT_MS}ms. ` +
+            `Expected REST API at ${url}${suffix}`);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=devnode-manager.js.map

package/dist/devnode-manager.js.map

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

package/dist/execution-key-cache.d.ts

@@ -0,0 +1,71 @@
+import type { AleoNetwork, RuntimeImportRef } from "@lionden/config";
+import { type KeyArtifactsMetadata, type RuntimeKeyCacheDiagnostics, type RuntimeKeyIdentity } from "@lionden/core";
+export interface ProgramExecutionArtifacts {
+    readonly source: string;
+    readonly sourceOrigin: "artifact" | "network";
+    readonly sourceHash: string;
+    readonly imports?: Record<string, string>;
+    readonly importsHash: string;
+    readonly artifactDir?: string;
+    readonly sidecar?: KeyArtifactsMetadata;
+}
+export interface RuntimeKeyCacheHit {
+    readonly source: "sidecar" | "runtime";
+    readonly provingKeyBytes: Uint8Array;
+    readonly verifyingKeyBytes: Uint8Array;
+}
+export interface RuntimeKeyCacheWrite {
+    readonly identity: RuntimeKeyIdentity;
+    readonly provingKeyBytes: Uint8Array;
+    readonly verifyingKeyBytes: Uint8Array;
+    readonly diagnostics?: RuntimeKeyCacheDiagnostics;
+}
+export declare function resolveProgramExecutionArtifacts(options: {
+    artifactsDir?: string;
+    programId: string;
+    networkClient: {
+        getProgram(id: string): Promise<string>;
+    };
+    includeSidecar?: boolean;
+    /**
+     * Pre-normalized runtime-import refs. Seeded into the import resolution
+     * graph before the static-import walk, so dynamic-dispatch targets and
+     * their transitive deps are bundled into the resulting `imports` map.
+     */
+    runtimeImports?: readonly RuntimeImportRef[];
+}): Promise<ProgramExecutionArtifacts>;
+/**
+ * Whether `transition` declares any record-typed input — `{ Record: ... }`
+ * (local or external) or the first-class `"DynamicRecord"` — per the program's
+ * `abi.json` (a sibling of `main.aleo` in `artifactDir`).
+ *
+ * Record-consuming transitions need an on-chain inclusion proof. The eager
+ * key-synthesis path (`synthesizeKeyPair`) has no query parameter, so it can
+ * bypass LionDen's egress-guarded transport. Production execution now skips
+ * eager synthesis on every cache miss; this classifier is retained for ABI
+ * diagnostics and tests around record-shape recognition.
+ *
+ * Returns `undefined` when the ABI can't be located, parsed, or trusted to
+ * prove the transition is record-free: network-sourced program (no
+ * `artifactDir`), missing/garbled `abi.json`, unknown transition, OR any input
+ * whose `ty` shape is unrecognized (e.g. a stale/corrupt entry missing `ty`, or
+ * a future ABI variant). `false` is returned only when EVERY input is a
+ * recognized record-free shape.
+ */
+export declare function transitionHasRecordInput(artifacts: ProgramExecutionArtifacts, transition: string): boolean | undefined;
+export declare function findCachedExecutionKeys(options: {
+    cachePath: string;
+    identity: RuntimeKeyIdentity;
+    artifacts?: ProgramExecutionArtifacts;
+}): RuntimeKeyCacheHit | undefined;
+export declare function writeCachedExecutionKeys(write: RuntimeKeyCacheWrite, cachePath: string): void;
+export declare function buildRuntimeKeyIdentity(options: {
+    network: AleoNetwork;
+    programId: string;
+    transition: string;
+    edition?: number;
+    sourceHash: string;
+    importsHash: string;
+    wasmHash: string;
+}): RuntimeKeyIdentity;
+//# sourceMappingURL=execution-key-cache.d.ts.map

package/dist/execution-key-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-key-cache.d.ts","sourceRoot":"","sources":["../src/execution-key-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EAQxB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,0BAA0B,CAAC;CACnD;AAED,wBAAsB,gCAAgC,CAAC,OAAO,EAAE;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE;QAAE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA0BrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,yBAAyB,EACpC,UAAU,EAAE,MAAM,GACjB,OAAO,GAAG,SAAS,CAoCrB;AAiBD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC,GAAG,kBAAkB,GAAG,SAAS,CA4BjC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAa7F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,kBAAkB,CAUrB"}