@lionden/plugin-deploy 0.1.0

package/dist/leo-sources.js

@@ -0,0 +1,31 @@
+/**
+ * Utility for reading Leo source files from a directory.
+ * Extracted to avoid circular dependencies between deploy-task and upgrade-task.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Read all .leo source files from an absolute source directory.
+ * Uses the discovered sourceDir (from discoverUnits) rather than
+ * deriving the path from the program ID.
+ */
+export function readLeoSourcesFromDir(sourceDir) {
+    if (!fs.existsSync(sourceDir))
+        return "";
+    const sources = [];
+    collectLeoFiles(sourceDir, sources);
+    return sources.join("\n");
+}
+function collectLeoFiles(dir, results) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            collectLeoFiles(fullPath, results);
+        }
+        else if (entry.name.endsWith(".leo")) {
+            results.push(fs.readFileSync(fullPath, "utf-8"));
+        }
+    }
+}
+//# sourceMappingURL=leo-sources.js.map

package/dist/leo-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-sources.js","sourceRoot":"","sources":["../src/leo-sources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,eAAe,CAAC,GAAW,EAAE,OAAiB;IACrD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/leo-version.d.ts

@@ -0,0 +1,2 @@
+export declare function supportsLeoProgramRename(leoVersion: string): boolean;
+//# sourceMappingURL=leo-version.d.ts.map

package/dist/leo-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-version.d.ts","sourceRoot":"","sources":["../src/leo-version.ts"],"names":[],"mappings":"AAEA,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAMpE"}

package/dist/leo-version.js

@@ -0,0 +1,10 @@
+const STABLE_LEO_VERSION_RE = /^(\d+)\.(\d+)\.(\d+)$/;
+export function supportsLeoProgramRename(leoVersion) {
+    const match = STABLE_LEO_VERSION_RE.exec(leoVersion);
+    if (!match)
+        return false;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major > 4 || (major === 4 && minor >= 3);
+}
+//# sourceMappingURL=leo-version.js.map

package/dist/leo-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-version.js","sourceRoot":"","sources":["../src/leo-version.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/on-chain-check.d.ts

@@ -0,0 +1,34 @@
+/**
+ * On-chain program existence checks.
+ *
+ * Used by DeploymentManager for devnode session validation and by the
+ * pre-flight pipeline to detect already-deployed programs.
+ */
+import type { NetworkConnection } from "@lionden/network";
+import type { DegradedDeploymentRecord } from "./deployment-types.js";
+export type OnChainCheckResult = {
+    readonly exists: true;
+    readonly source: string;
+    readonly edition: number | null;
+} | {
+    readonly exists: false;
+    readonly source: null;
+};
+/**
+ * Check whether a program is deployed on-chain.
+ * Returns source when found, null when not.
+ */
+export declare function checkProgramOnChain(connection: NetworkConnection, programId: string): Promise<OnChainCheckResult>;
+export declare function getRequiredProgramEdition(connection: NetworkConnection, programId: string, actionDescription: string): Promise<number>;
+export declare function waitForProgramEditionAdvance(connection: NetworkConnection, programId: string, previousEdition: number, timeoutMs: number): Promise<number>;
+/**
+ * Build a DegradedDeploymentRecord from an on-chain program source.
+ * Used when a program is discovered on-chain with no local provenance.
+ */
+export declare function createDegradedRecord(programId: string, network: string, endpoint: string, source: string, edition: number, historyCount?: number): DegradedDeploymentRecord;
+/**
+ * Batch-fetch compiled Aleo sources for a list of program IDs.
+ * Missing programs are omitted from the result map.
+ */
+export declare function fetchImportSources(connection: NetworkConnection, importIds: string[]): Promise<Map<string, string>>;
+//# sourceMappingURL=on-chain-check.d.ts.map

package/dist/on-chain-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-chain-check.d.ts","sourceRoot":"","sources":["../src/on-chain-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAMtE,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;CACvB,CAAC;AAEN;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAO7B;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,SAAI,GACf,wBAAwB,CAgB1B;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAc9B"}

package/dist/on-chain-check.js

@@ -0,0 +1,84 @@
+/**
+ * On-chain program existence checks.
+ *
+ * Used by DeploymentManager for devnode session validation and by the
+ * pre-flight pipeline to detect already-deployed programs.
+ */
+/**
+ * Check whether a program is deployed on-chain.
+ * Returns source when found, null when not.
+ */
+export async function checkProgramOnChain(connection, programId) {
+    const source = await connection.getProgramSource(programId);
+    if (source === null) {
+        return { exists: false, source: null };
+    }
+    const edition = await connection.getProgramEdition(programId);
+    return { exists: true, source, edition };
+}
+export async function getRequiredProgramEdition(connection, programId, actionDescription) {
+    const edition = await connection.getProgramEdition(programId);
+    if (typeof edition === "number" && Number.isInteger(edition) && edition >= 0) {
+        return edition;
+    }
+    throw new Error(`Unable to ${actionDescription} for "${programId}": on-chain program edition could not be observed.`);
+}
+export async function waitForProgramEditionAdvance(connection, programId, previousEdition, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+        const edition = await connection.getProgramEdition(programId);
+        if (typeof edition === "number" && Number.isInteger(edition) && edition > previousEdition) {
+            return edition;
+        }
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, Math.min(500, remaining)));
+    }
+    throw new Error(`Timed out waiting for "${programId}" on-chain edition to advance beyond ${previousEdition}.`);
+}
+// ---------------------------------------------------------------------------
+// createDegradedRecord
+// ---------------------------------------------------------------------------
+/**
+ * Build a DegradedDeploymentRecord from an on-chain program source.
+ * Used when a program is discovered on-chain with no local provenance.
+ */
+export function createDegradedRecord(programId, network, endpoint, source, edition, historyCount = 0) {
+    void source; // source kept in the signature for callers; not stored on the record
+    return {
+        status: "degraded",
+        programId,
+        network,
+        endpoint,
+        updatedAt: new Date().toISOString(),
+        edition,
+        historyCount,
+        txId: null,
+        blockHeight: null,
+        deployerAddress: null,
+        deployedAt: null,
+        feePaid: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// fetchImportSources
+// ---------------------------------------------------------------------------
+/**
+ * Batch-fetch compiled Aleo sources for a list of program IDs.
+ * Missing programs are omitted from the result map.
+ */
+export async function fetchImportSources(connection, importIds) {
+    const results = await Promise.all(importIds.map(async (id) => {
+        const source = await connection.getProgramSource(id);
+        return [id, source];
+    }));
+    const map = new Map();
+    for (const [id, source] of results) {
+        if (source !== null) {
+            map.set(id, source);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=on-chain-check.js.map

package/dist/on-chain-check.js.map

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

package/dist/preflight.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Pre-flight validation pipeline.
+ *
+ * Pure validation — never writes state. Returns structured results with
+ * per-program outcomes for deploy.
+ */
+import type { LionDenResolvedConfig, ResolvedNetworkConfig, ResolvedSdkKeyCacheConfig, SdkLogLevel } from "@lionden/config";
+import type { DependencyGraph } from "@lionden/leo-compiler";
+import type { NetworkConnection } from "@lionden/network";
+import type { DeploymentRecord } from "./deployment-types.js";
+export interface PreflightWarning {
+    readonly code: string;
+    readonly message: string;
+}
+export interface PreflightError {
+    readonly code: string;
+    readonly message: string;
+    readonly recoverable: boolean;
+}
+export interface ProgramPreflightOutcome {
+    readonly programId: string;
+    readonly action: "deploy" | "skip";
+    readonly reason?: "already-deployed" | "already-in-state";
+    readonly record?: DeploymentRecord;
+    readonly feeEstimate?: bigint;
+}
+export interface DeployPreflightResult {
+    readonly passed: boolean;
+    readonly warnings: PreflightWarning[];
+    readonly errors: PreflightError[];
+    readonly programs: ProgramPreflightOutcome[];
+    readonly totalFeeEstimate?: bigint;
+}
+/**
+ * Check whether a program is already deployed on-chain.
+ *
+ * - If on-chain and skipDeployed=true → action: "skip"
+ * - If on-chain and skipDeployed=false → fatal error
+ * - If not on-chain → action: "deploy"
+ */
+export declare function checkAlreadyDeployed(connection: NetworkConnection, programId: string, existingRecord: DeploymentRecord | null, skipDeployed: boolean): Promise<{
+    outcome: ProgramPreflightOutcome;
+    error: PreflightError | null;
+}>;
+/**
+ * Check that all imports of a program are available — either already on-chain
+ * or scheduled for deployment earlier in the same run.
+ *
+ * HTTP only (devnode skips — imports are guaranteed by local compilation).
+ */
+export declare function checkImportsAvailable(connection: NetworkConnection, graph: DependencyGraph, programId: string, deployTargets: Set<string>, localSources: Map<string, string>): Promise<PreflightError[]>;
+/**
+ * Estimate the deployment fee for a program.
+ * Returns the estimate in microcredits, or undefined if estimation fails.
+ * HTTP only (devnode skips proof generation so fee estimation is not meaningful).
+ */
+export declare function checkFeeEstimate(connection: NetworkConnection, programId: string, aleoSource: string, importSources: Map<string, string>, signerPrivateKey?: string, keyCache?: ResolvedSdkKeyCacheConfig, logLevel?: SdkLogLevel): Promise<{
+    estimate: bigint | undefined;
+    warning: PreflightWarning | null;
+}>;
+/**
+ * Check that the deployer's balance is sufficient to cover estimated fees.
+ * Warns if balance < 1.5x total estimate, errors if < 1x.
+ * HTTP only.
+ */
+export declare function checkBalanceSufficient(connection: NetworkConnection, totalEstimate: bigint, signerAddress?: string): Promise<{
+    warning: PreflightWarning | null;
+    error: PreflightError | null;
+}>;
+export interface RunDeployPreflightOptions {
+    programs: Array<{
+        programId: string;
+        aleoSource: string | undefined;
+        existingRecord: DeploymentRecord | null;
+    }>;
+    connection: NetworkConnection;
+    networkConfig: ResolvedNetworkConfig;
+    config: LionDenResolvedConfig;
+    skipDeployed: boolean;
+    /** All program IDs being deployed in this run (for import availability checks) */
+    deployTargets: Set<string>;
+    /** Compiled Aleo sources for local deps not yet on-chain (programId → source) */
+    localSources: Map<string, string>;
+    /** Dependency graph for import checks */
+    graph: DependencyGraph;
+    /** Override signing key for fee estimation and balance checks. When set, overrides connection.privateKey. */
+    signerPrivateKey?: string;
+}
+/**
+ * Run pre-flight validation for a set of programs to be deployed.
+ * Pure — never writes state.
+ */
+export declare function runDeployPreflight(opts: RunDeployPreflightOptions): Promise<DeployPreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

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

package/dist/preflight.js

@@ -0,0 +1,288 @@
+/**
+ * Pre-flight validation pipeline.
+ *
+ * Pure validation — never writes state. Returns structured results with
+ * per-program outcomes for deploy.
+ */
+import { checkProgramOnChain, fetchImportSources } from "./on-chain-check.js";
+// ---------------------------------------------------------------------------
+// Individual checks — deploy
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a program is already deployed on-chain.
+ *
+ * - If on-chain and skipDeployed=true → action: "skip"
+ * - If on-chain and skipDeployed=false → fatal error
+ * - If not on-chain → action: "deploy"
+ */
+export async function checkAlreadyDeployed(connection, programId, existingRecord, skipDeployed) {
+    // For devnode: always validate via getProgramSource (memory-first policy)
+    // For HTTP: also check on-chain existence
+    const { exists } = await checkProgramOnChain(connection, programId);
+    if (!exists) {
+        return {
+            outcome: { programId, action: "deploy" },
+            error: null,
+        };
+    }
+    // Program exists on-chain
+    if (!skipDeployed) {
+        return {
+            outcome: {
+                programId,
+                action: "skip",
+                reason: "already-deployed",
+                record: existingRecord ?? undefined,
+            },
+            error: {
+                code: "ALREADY_DEPLOYED",
+                message: `Program "${programId}" is already deployed on-chain and ` +
+                    `--no-skip-deployed was specified. Remove the flag to skip it.`,
+                recoverable: false,
+            },
+        };
+    }
+    return {
+        outcome: {
+            programId,
+            action: "skip",
+            reason: existingRecord ? "already-in-state" : "already-deployed",
+            record: existingRecord ?? undefined,
+        },
+        error: null,
+    };
+}
+/**
+ * Check that all imports of a program are available — either already on-chain
+ * or scheduled for deployment earlier in the same run.
+ *
+ * HTTP only (devnode skips — imports are guaranteed by local compilation).
+ */
+export async function checkImportsAvailable(connection, graph, programId, deployTargets, localSources) {
+    const errors = [];
+    const imports = graph.imports.get(programId) ?? [];
+    for (const importId of imports) {
+        // Check if scheduled for deployment earlier in this run
+        if (deployTargets.has(importId))
+            continue;
+        // Check if we have the source locally (local dep not yet on-chain in this batch)
+        if (localSources.has(importId))
+            continue;
+        // Check if on-chain
+        const { exists } = await checkProgramOnChain(connection, importId);
+        if (!exists) {
+            errors.push({
+                code: "MISSING_IMPORT",
+                message: `Program "${programId}" imports "${importId}" which is not deployed on-chain ` +
+                    `and not scheduled for deployment in this run.`,
+                recoverable: false,
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Estimate the deployment fee for a program.
+ * Returns the estimate in microcredits, or undefined if estimation fails.
+ * HTTP only (devnode skips proof generation so fee estimation is not meaningful).
+ */
+export async function checkFeeEstimate(connection, programId, aleoSource, importSources, signerPrivateKey, keyCache, logLevel) {
+    try {
+        const { createSdkObjects, withSuppressedSdkConsoleNoise } = await import("@lionden/network");
+        const sdk = await createSdkObjects({
+            network: connection.networkId,
+            endpoint: connection.endpoint,
+            privateKey: signerPrivateKey ?? connection.privateKey,
+            apiKey: connection.apiKey,
+            egressPolicy: connection.egressPolicy,
+            keyCache,
+            logLevel,
+        });
+        const pm = sdk.programManager;
+        if (typeof pm.estimateDeploymentFee !== "function") {
+            return {
+                estimate: undefined,
+                warning: {
+                    code: "FEE_ESTIMATION_UNAVAILABLE",
+                    message: `Fee estimation not available in this SDK version. Cannot estimate deployment cost for "${programId}".`,
+                },
+            };
+        }
+        // Build imports object for SDK
+        const importsObj = {};
+        for (const [id, src] of importSources) {
+            importsObj[id] = src;
+        }
+        const estimatedFee = await withSuppressedSdkConsoleNoise(() => pm.estimateDeploymentFee(aleoSource, Object.keys(importsObj).length > 0 ? importsObj : undefined));
+        return {
+            estimate: BigInt(estimatedFee),
+            warning: null,
+        };
+    }
+    catch (err) {
+        return {
+            estimate: undefined,
+            warning: {
+                code: "FEE_ESTIMATION_FAILED",
+                message: `Failed to estimate deployment fee for "${programId}": ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+}
+/**
+ * Check that the deployer's balance is sufficient to cover estimated fees.
+ * Warns if balance < 1.5x total estimate, errors if < 1x.
+ * HTTP only.
+ */
+export async function checkBalanceSufficient(connection, totalEstimate, signerAddress) {
+    if (totalEstimate === 0n) {
+        return { warning: null, error: null };
+    }
+    const balance = await connection.getBalance(signerAddress);
+    const bufferThreshold = (totalEstimate * 3n) / 2n; // 1.5x
+    if (balance < totalEstimate) {
+        return {
+            warning: null,
+            error: {
+                code: "INSUFFICIENT_BALANCE",
+                message: `Deployer balance (${balance} microcredits) is less than the estimated total fee ` +
+                    `(${totalEstimate} microcredits). Deployment will likely fail.`,
+                recoverable: false,
+            },
+        };
+    }
+    if (balance < bufferThreshold) {
+        return {
+            warning: {
+                code: "LOW_BALANCE",
+                message: `Deployer balance (${balance} microcredits) is less than 1.5x the estimated total fee ` +
+                    `(${totalEstimate} microcredits). Consider adding more credits to cover fees.`,
+            },
+            error: null,
+        };
+    }
+    return { warning: null, error: null };
+}
+/**
+ * Run pre-flight validation for a set of programs to be deployed.
+ * Pure — never writes state.
+ */
+export async function runDeployPreflight(opts) {
+    const { programs, connection, networkConfig, skipDeployed, deployTargets, localSources, graph, signerPrivateKey, } = opts;
+    const isDevnode = networkConfig.type === "devnode";
+    const warnings = [];
+    const errors = [];
+    const outcomes = [];
+    // Track which programs in this batch are confirmed to deploy
+    // (used as "known to deploy" for import checks of later programs)
+    const confirmedDeployTargets = new Set(deployTargets);
+    let totalFeeEstimate;
+    for (const prog of programs) {
+        const { programId, aleoSource, existingRecord } = prog;
+        // 1. Check if already deployed
+        const { outcome: deployedOutcome, error: deployedErr } = await checkAlreadyDeployed(connection, programId, existingRecord, skipDeployed);
+        if (deployedErr) {
+            errors.push(deployedErr);
+            outcomes.push(deployedOutcome);
+            continue;
+        }
+        if (deployedOutcome.action === "skip") {
+            outcomes.push(deployedOutcome);
+            // Do NOT add to confirmedDeployTargets — it's being skipped
+            confirmedDeployTargets.delete(programId);
+            continue;
+        }
+        // This program will be deployed — run HTTP-only checks
+        if (!isDevnode) {
+            // 2. Check compiled artifacts present (HTTP only — needed for import/fee checks)
+            if (aleoSource === undefined) {
+                errors.push({
+                    code: "MISSING_ARTIFACTS",
+                    message: `No compiled .aleo source found for "${programId}". ` +
+                        `Run \`lionden compile\` before running preflight.`,
+                    recoverable: false,
+                });
+                outcomes.push({ programId, action: "deploy" });
+                continue;
+            }
+            // 3. Check imports available
+            const importErrors = await checkImportsAvailable(connection, graph, programId, confirmedDeployTargets, localSources);
+            errors.push(...importErrors);
+            if (importErrors.length > 0) {
+                outcomes.push({ programId, action: "deploy" });
+                continue;
+            }
+            // 4. Fee estimation
+            // Collect import sources for fee estimation.
+            // Local sources (deps in this batch) are known; all other imports (including
+            // credits.aleo and other external programs) are fetched from on-chain.
+            const importIds = graph.imports.get(programId) ?? [];
+            const importSourcesForFee = new Map();
+            const onChainImportIds = [];
+            for (const id of importIds) {
+                const local = localSources.get(id);
+                if (local) {
+                    importSourcesForFee.set(id, local);
+                }
+                else {
+                    onChainImportIds.push(id);
+                }
+            }
+            if (onChainImportIds.length > 0) {
+                const fetched = await fetchImportSources(connection, onChainImportIds);
+                for (const [id, src] of fetched) {
+                    importSourcesForFee.set(id, src);
+                }
+            }
+            const { estimate, warning: feeWarning } = await checkFeeEstimate(connection, programId, aleoSource, importSourcesForFee, signerPrivateKey, opts.config.sdk.keyCache, opts.config.sdk.logLevel);
+            if (feeWarning)
+                warnings.push(feeWarning);
+            if (estimate !== undefined) {
+                totalFeeEstimate = (totalFeeEstimate ?? 0n) + estimate;
+            }
+            outcomes.push({ programId, action: "deploy", feeEstimate: estimate });
+        }
+        else {
+            outcomes.push({ programId, action: "deploy" });
+        }
+    }
+    // 5. Balance check (HTTP only, batch)
+    if (!isDevnode && totalFeeEstimate !== undefined && totalFeeEstimate > 0n) {
+        // Derive signer address if a signer key override is provided
+        let signerAddress;
+        if (signerPrivateKey) {
+            try {
+                const { createSdkObjects } = await import("@lionden/network");
+                const sdk = await createSdkObjects({
+                    network: connection.networkId,
+                    endpoint: connection.endpoint,
+                    privateKey: signerPrivateKey,
+                    apiKey: connection.apiKey,
+                    egressPolicy: connection.egressPolicy,
+                    logLevel: opts.config.sdk.logLevel,
+                });
+                const account = sdk.account;
+                signerAddress =
+                    typeof account.address === "function"
+                        ? account.address().to_string()
+                        : String(account.address ?? account);
+            }
+            catch {
+                // Best-effort; fall back to connection default
+            }
+        }
+        const { warning: balanceWarning, error: balanceError } = await checkBalanceSufficient(connection, totalFeeEstimate, signerAddress);
+        if (balanceWarning)
+            warnings.push(balanceWarning);
+        if (balanceError)
+            errors.push(balanceError);
+    }
+    return {
+        passed: errors.length === 0,
+        warnings,
+        errors,
+        programs: outcomes,
+        totalFeeEstimate,
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/prove.d.ts

@@ -0,0 +1,11 @@
+import type { LionDenRuntimeEnvironment } from "@lionden/core";
+/**
+ * Resolve whether to build standard/proven transactions, shared by the deploy
+ * and upgrade actions. Precedence: an explicit per-call/task arg wins; then an
+ * explicit `--prove[=true|false]` global (so `--prove=false` disables proving
+ * even when LIONDEN_PROVE is set); then a truthy LIONDEN_PROVE env var; else
+ * false. The env is parsed permissively (e.g. `1`/`yes`/`on`); silent here —
+ * a worker-side reader must not warn per call (Finding 3).
+ */
+export declare function resolveProveOption(args: Record<string, unknown>, lre: LionDenRuntimeEnvironment): boolean;
+//# sourceMappingURL=prove.d.ts.map

package/dist/prove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prove.d.ts","sourceRoot":"","sources":["../src/prove.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,yBAAyB,GAC7B,OAAO,CAMT"}

package/dist/prove.js

@@ -0,0 +1,19 @@
+import { parseBooleanEnv } from "@lionden/config";
+/**
+ * Resolve whether to build standard/proven transactions, shared by the deploy
+ * and upgrade actions. Precedence: an explicit per-call/task arg wins; then an
+ * explicit `--prove[=true|false]` global (so `--prove=false` disables proving
+ * even when LIONDEN_PROVE is set); then a truthy LIONDEN_PROVE env var; else
+ * false. The env is parsed permissively (e.g. `1`/`yes`/`on`); silent here —
+ * a worker-side reader must not warn per call (Finding 3).
+ */
+export function resolveProveOption(args, lre) {
+    const explicit = args["prove"];
+    if (typeof explicit === "boolean")
+        return explicit;
+    const global = lre.globalOptions["prove"];
+    if (typeof global === "boolean")
+        return global; // I5: honor explicit false, not just === true
+    return parseBooleanEnv(process.env["LIONDEN_PROVE"], false);
+}
+//# sourceMappingURL=prove.js.map

package/dist/prove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prove.js","sourceRoot":"","sources":["../src/prove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAA6B,EAC7B,GAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,OAAO,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,8CAA8C;IAC9F,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/dist/recipe-task.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Recipe task — run a deployment recipe from the CLI.
+ *
+ * A recipe is a user-defined async function exported from a TypeScript/JS file.
+ * The task compiles the project once, creates a DeploymentContext, then calls
+ * the recipe function.
+ *
+ * Usage:
+ *   lionden recipe --file ./recipes/setup.ts
+ *   lionden recipe --file ./recipes/setup.ts --export setupToken
+ *   lionden recipe --file ./recipes/setup.ts --network testnet
+ */
+import type { LionDenRuntimeEnvironment } from "@lionden/core";
+import type { NetworkConnection } from "@lionden/network";
+import type { DeploymentContext } from "./recipe-types.js";
+export declare function recipeAction(args: Record<string, unknown>, lre: LionDenRuntimeEnvironment): Promise<unknown>;
+export declare function createCliDeploymentContext(lre: LionDenRuntimeEnvironment, connection: NetworkConnection, networkName: string, resolvedProve?: boolean): DeploymentContext;
+//# sourceMappingURL=recipe-task.d.ts.map