gate-evm-tools 1.0.26 → 1.0.27

package/dist-runtime/workflow/lib/registryCommit.js

@@ -0,0 +1,319 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitVerifiedContractInfo = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("./config");
+const contractInfoCandidates_1 = require("./contractInfoCandidates");
+const deployments_1 = require("./deployments");
+const deploymentInfo_1 = require("./deploymentInfo");
+const deploymentRecords_1 = require("./deploymentRecords");
+const executionPlan_1 = require("./executionPlan");
+const operatorExecution_1 = require("./operatorExecution");
+const lock_1 = require("./lock");
+const release_1 = require("./release");
+const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/;
+const safeId = (value, label) => {
+    if (!SAFE_ID.test(value))
+        throw new Error(`${label} is invalid`);
+    return value;
+};
+const projectRelative = (root, filePath) => {
+    const relative = path_1.default.relative(path_1.default.resolve(root), path_1.default.resolve(filePath));
+    if (!relative || relative.startsWith("..") || path_1.default.isAbsolute(relative)) {
+        throw new Error("Registry evidence path escapes the project root");
+    }
+    return relative.split(path_1.default.sep).join("/");
+};
+const writeExclusiveJson = (filePath, value) => {
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+    try {
+        fs_1.default.writeFileSync(filePath, JSON.stringify(value, null, 2) + "\n", {
+            flag: "wx",
+            mode: 0o600,
+        });
+    }
+    catch (error) {
+        if (error
+            && typeof error === "object"
+            && "code" in error
+            && String(error.code) === "EEXIST") {
+            throw new Error(`Registry evidence already exists: ${filePath}`);
+        }
+        throw error;
+    }
+};
+const loadContractInfoBackup = (filePath) => ((0, deployments_1.validateContractInfo)((0, config_1.readJsonFile)(filePath)));
+const candidatePath = (root, executionId) => path_1.default.join(root, `contractInfo.pending.${safeId(executionId, "selection executionId")}.json`);
+const verificationPath = (taskDir, selection) => path_1.default.join(taskDir, "results", selection.network, selection.executionId, "verify", "verification.json");
+const assertBusinessVerification = (taskDir, taskId, selection) => {
+    let verification;
+    try {
+        verification = (0, config_1.readJsonFile)(verificationPath(taskDir, selection));
+    }
+    catch {
+        throw new Error(`Business verification is missing for ${selection.network}`);
+    }
+    if (verification.taskId !== taskId
+        || verification.target !== selection.network
+        || verification.executionId !== selection.executionId
+        || verification.mode !== "verify"
+        || !Array.isArray(verification.steps)
+        || verification.steps.length === 0) {
+        throw new Error(`Business verification is missing for ${selection.network}`);
+    }
+    for (const [index, rawStep] of verification.steps.entries()) {
+        if (!rawStep || typeof rawStep !== "object" || Array.isArray(rawStep)) {
+            throw new Error(`Business verification step ${index} is invalid`);
+        }
+        const step = rawStep;
+        if (!step.results || typeof step.results !== "object" || Array.isArray(step.results)) {
+            throw new Error(`Business verification step ${index} has no results`);
+        }
+        for (const result of Object.values(step.results)) {
+            if (!result || typeof result !== "object" || Array.isArray(result)) {
+                throw new Error(`Business verification step ${index} result is invalid`);
+            }
+            const comparison = result;
+            if (String(comparison.actual) !== String(comparison.expected)) {
+                throw new Error(`Business verification step ${index} did not match expected state`);
+            }
+        }
+    }
+    const status = (0, config_1.readJsonFile)(path_1.default.join(taskDir, "status.json"));
+    const networkStatus = status.networks && typeof status.networks === "object"
+        ? status.networks[selection.network]
+        : undefined;
+    if (networkStatus?.lastExecutionId !== selection.executionId
+        || networkStatus.lastExecutionMode !== "verify"
+        || networkStatus.verifyStatus !== "verified") {
+        throw new Error(`Verify status is stale for ${selection.network}`);
+    }
+};
+const readRecord = (taskDir, taskId, selection) => {
+    const filePath = (0, deploymentRecords_1.deploymentRecordPath)(taskDir, selection.network, selection.executionId);
+    const record = (0, config_1.readJsonFile)(filePath);
+    if (record.taskId !== taskId
+        || record.network !== selection.network
+        || record.executionId !== selection.executionId) {
+        throw new Error(`Deployment record identity mismatch for ${selection.network}`);
+    }
+    if (record.status !== "waiting_code_check" && record.status !== "applied") {
+        throw new Error(`Deployment record ${selection.network} is ${record.status}, expected waiting_code_check`);
+    }
+    return { record, filePath };
+};
+const readCandidate = (root, taskId, selection, allowPromoted) => {
+    const filePath = candidatePath(root, selection.executionId);
+    if (!fs_1.default.existsSync(filePath))
+        return undefined;
+    const candidate = (0, contractInfoCandidates_1.validateContractInfoCandidate)((0, config_1.readJsonFile)(filePath));
+    if (candidate.deploymentId !== taskId
+        || candidate.executionId !== selection.executionId
+        || candidate.network !== selection.network) {
+        throw new Error(`ContractInfo candidate identity mismatch for ${selection.network}`);
+    }
+    if (candidate.status === "promoted" && !allowPromoted) {
+        throw new Error(`ContractInfo candidate was already committed for ${selection.network}`);
+    }
+    return { candidate, filePath };
+};
+const reconciliationPath = (taskDir, selection) => path_1.default.join(taskDir, "results", selection.network, selection.executionId, "external-reconciliation.json");
+const assertExecutionEvidence = (input) => {
+    const plan = (0, executionPlan_1.loadReleaseExecutionPlan)({
+        root: input.root,
+        taskDir: input.taskDir,
+        target: input.selection.network,
+        executionId: input.selection.executionId,
+    });
+    if (plan.taskId !== input.taskId)
+        throw new Error("Execution plan taskId mismatch");
+    const operatorExecutionPath = path_1.default.join(input.taskDir, "results", plan.target, plan.executionId, "operator-execution.json");
+    if (plan.transactions.some((transaction) => transaction.route === "operator")
+        || fs_1.default.existsSync(operatorExecutionPath)) {
+        (0, operatorExecution_1.loadOperatorExecutionResult)({ taskDir: input.taskDir, plan });
+    }
+    if (plan.releaseKind === "development") {
+        if (plan.transactions.some((transaction) => transaction.route !== "operator")) {
+            throw new Error("Development registry commit cannot contain external transactions");
+        }
+        return;
+    }
+    const lock = (0, lock_1.readParameterLockExecution)(input.taskDir, input.selection.executionId);
+    if (lock.finalSimulation.status !== "succeeded") {
+        throw new Error(`Final simulation is incomplete for ${input.selection.network}`);
+    }
+    if (lock.finalSimulation.executionPlanHash !== plan.planHash) {
+        throw new Error(`Final simulation execution plan is stale for ${input.selection.network}`);
+    }
+    const report = (0, config_1.readJsonFile)(reconciliationPath(input.taskDir, input.selection));
+    if (report.version !== 1
+        || report.taskId !== input.taskId
+        || report.target !== input.selection.network
+        || report.executionId !== input.selection.executionId
+        || report.executionPlanHash !== plan.planHash
+        || (report.status !== "not_required" && report.status !== "reconciled")
+        || !Array.isArray(report.matches)
+        || report.matches.length !== plan.transactions.length
+        || report.matches.some((match) => (!match
+            || typeof match !== "object"
+            || match.finalized !== true
+            || match.receiptStatus !== 1))) {
+        throw new Error(`Admin external reconciliation is incomplete for ${input.selection.network}`);
+    }
+};
+const updateCommittedStatus = (taskDir, selections) => {
+    const filePath = path_1.default.join(taskDir, "status.json");
+    const current = (0, config_1.readJsonFile)(filePath);
+    const currentNetworks = current.networks && typeof current.networks === "object"
+        ? current.networks
+        : {};
+    const networks = { ...currentNetworks };
+    const now = new Date().toISOString();
+    for (const selection of selections) {
+        networks[selection.network] = {
+            ...(networks[selection.network] || {}),
+            deployStatus: "deployed_pending_code_audit",
+            registryExecutionId: selection.executionId,
+            updatedAt: now,
+        };
+    }
+    (0, config_1.writeJsonFile)(filePath, {
+        ...current,
+        status: "deployed_pending_code_audit",
+        networks,
+        updatedAt: now,
+    });
+};
+const markDeploymentRecordsCommitted = (root, recordPaths) => {
+    const now = new Date().toISOString();
+    for (const recordPath of recordPaths) {
+        const filePath = path_1.default.join(root, ...recordPath.split("/"));
+        const record = (0, config_1.readJsonFile)(filePath);
+        const changes = record.changes.map((change) => (change.status === "waiting_code_check"
+            ? { ...change, status: "applied" }
+            : change));
+        if (changes.some((change) => change.status !== "applied")) {
+            throw new Error(`Deployment record is not ready to commit: ${recordPath}`);
+        }
+        (0, config_1.writeJsonFile)(filePath, {
+            ...record,
+            status: "applied",
+            changes,
+            updatedAt: now,
+        });
+    }
+};
+const validateSelections = (selections) => {
+    if (selections.length === 0)
+        throw new Error("Registry commit requires at least one selection");
+    const normalized = selections.map((selection) => ({
+        network: safeId(selection.network, "selection network"),
+        executionId: safeId(selection.executionId, "selection executionId"),
+    })).sort((left, right) => left.network.localeCompare(right.network));
+    if (new Set(normalized.map((selection) => selection.network)).size !== normalized.length) {
+        throw new Error("Registry commit selections contain a duplicate network");
+    }
+    return normalized;
+};
+const loadExistingReport = (filePath, taskId, commitId, selections) => {
+    if (!fs_1.default.existsSync(filePath))
+        return undefined;
+    const report = (0, config_1.readJsonFile)(filePath);
+    if (report.version !== 1
+        || report.status !== "committed"
+        || report.taskId !== taskId
+        || report.commitId !== commitId
+        || JSON.stringify(report.selections) !== JSON.stringify(selections)) {
+        throw new Error("Registry commitId already exists with different content");
+    }
+    return report;
+};
+const commitVerifiedContractInfo = (input) => {
+    const taskId = safeId(input.taskId, "registry taskId");
+    const commitId = safeId(input.commitId, "registry commitId");
+    const selections = validateSelections(input.selections);
+    const taskDir = path_1.default.join(input.root, "scripts", "tasks", taskId);
+    const registryDir = path_1.default.join(taskDir, "results", "registry");
+    const reportFile = path_1.default.join(registryDir, `${commitId}.json`);
+    const backupFile = path_1.default.join(registryDir, `${commitId}.contractInfo.before.json`);
+    const recoveringCommit = fs_1.default.existsSync(backupFile);
+    const existingReport = loadExistingReport(reportFile, taskId, commitId, selections);
+    if (existingReport) {
+        const config = (0, config_1.loadConfig)(input.root);
+        if ((0, release_1.hashValue)((0, deployments_1.loadContractInfo)(input.root, config)) !== existingReport.afterHash) {
+            throw new Error("Committed contractInfo hash no longer matches the registry report");
+        }
+        if ((0, release_1.hashValue)((0, deploymentInfo_1.loadDeploymentInfo)(input.root)) !== existingReport.deploymentInfoHash) {
+            throw new Error("Committed deploymentInfo hash no longer matches the registry report");
+        }
+        return existingReport;
+    }
+    const records = [];
+    const candidates = [];
+    for (const selection of selections) {
+        assertExecutionEvidence({ root: input.root, taskDir, taskId, selection });
+        assertBusinessVerification(taskDir, taskId, selection);
+        const record = readRecord(taskDir, taskId, selection);
+        records.push(projectRelative(input.root, record.filePath));
+        const candidate = readCandidate(input.root, taskId, selection, recoveringCommit);
+        if (candidate)
+            candidates.push(candidate);
+    }
+    const config = (0, config_1.loadConfig)(input.root);
+    const current = (0, deployments_1.loadContractInfo)(input.root, config);
+    const before = recoveringCommit
+        ? loadContractInfoBackup(backupFile)
+        : current;
+    const beforeHash = (0, release_1.hashValue)(before);
+    let afterHash = beforeHash;
+    let changedEntries = [];
+    let deploymentInfoHash = (0, release_1.hashValue)((0, deploymentInfo_1.loadDeploymentInfo)(input.root));
+    let backupPath;
+    if (candidates.length > 0) {
+        if (!recoveringCommit) {
+            writeExclusiveJson(backupFile, before);
+        }
+        backupPath = projectRelative(input.root, backupFile);
+        const promoted = (0, contractInfoCandidates_1.promoteContractInfoCandidates)({
+            root: input.root,
+            config,
+            candidatePaths: candidates.map((candidate) => projectRelative(input.root, candidate.filePath)),
+        });
+        afterHash = promoted.afterHash;
+        changedEntries = promoted.changedEntries;
+    }
+    const deploymentInfo = (0, deploymentInfo_1.updateDeploymentInfoFromRecords)({
+        root: input.root,
+        records: records.map((recordPath) => ({ recordPath })),
+        expectedContractInfo: (0, deployments_1.loadContractInfo)(input.root, config),
+    });
+    deploymentInfoHash = (0, release_1.hashValue)(deploymentInfo);
+    markDeploymentRecordsCommitted(input.root, records);
+    updateCommittedStatus(taskDir, selections);
+    const report = {
+        version: 1,
+        status: "committed",
+        taskId,
+        commitId,
+        selections,
+        beforeHash,
+        afterHash,
+        changedEntries: [...changedEntries].sort((left, right) => (`${left.network}.${left.instanceId}`.localeCompare(`${right.network}.${right.instanceId}`))),
+        candidatePaths: candidates
+            .map((candidate) => projectRelative(input.root, candidate.filePath))
+            .sort(),
+        sourceRecordPaths: [...records].sort(),
+        backupPath,
+        deploymentInfoPath: "deploymentInfo.json",
+        deploymentInfoHash,
+        completedAt: new Date().toISOString(),
+    };
+    writeExclusiveJson(reportFile, report);
+    return report;
+};
+exports.commitVerifiedContractInfo = commitVerifiedContractInfo;
+//# sourceMappingURL=registryCommit.js.map

package/dist-runtime/workflow/lib/registryCommit.js.map

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

package/dist-runtime/workflow/lib/release.d.ts

@@ -0,0 +1,57 @@
+export declare const normalizeCreate2Scheme: (value: unknown) => "evm" | "zksync-eravm";
+export interface ReleaseFingerprint {
+    manifestHash: string;
+    artifactHash: string;
+    parametersHash: string;
+    configHash: string;
+}
+export interface ArtifactFingerprintInput {
+    contract: string;
+    bytecode: string;
+    deployedBytecode: string;
+    linkReferences: unknown;
+    deployedLinkReferences: unknown;
+    solcVersion: string;
+    optimizer: unknown;
+    evmVersion?: string;
+}
+export interface ReleaseFingerprintInput {
+    manifest: string;
+    artifacts: ArtifactFingerprintInput[];
+    parameters: Record<string, unknown>;
+    network: string;
+    chainId?: number;
+    target: Record<string, unknown>;
+}
+export interface ReleaseNetwork extends Partial<ReleaseFingerprint> {
+    status: string;
+    simulationResult: string;
+    simulatedAt: string;
+    simulationCallerNetworkHash?: string;
+}
+export interface DeploymentRelease {
+    version: 1;
+    sourceSuperTaskId: string;
+    developmentNetwork: string;
+    manifestHash: string;
+    artifactHash: string;
+    networks: Record<string, ReleaseNetwork>;
+}
+export interface ReleaseTargetSimulationRecordInput {
+    taskDir: string;
+    network: string;
+    executionId: string;
+    simulationResult: string;
+    simulatedAt: string;
+    simulationCallerNetworkHash: string;
+    fingerprint: ReleaseFingerprint;
+}
+export declare const stableJson: (value: unknown) => string;
+export declare const hashValue: (value: unknown) => string;
+export declare const hashArtifactInputs: (artifacts: ArtifactFingerprintInput[]) => string;
+export declare const hashTargetConfig: (network: string, chainId: number | undefined, target: Record<string, unknown>) => string;
+export declare const buildReleaseFingerprint: (input: ReleaseFingerprintInput) => ReleaseFingerprint;
+export declare const validateRelease: (value: unknown) => DeploymentRelease;
+export declare const loadRelease: (taskDir: string) => DeploymentRelease;
+export declare const recordReleaseTargetSimulationSucceeded: (input: ReleaseTargetSimulationRecordInput) => DeploymentRelease;
+export declare const assertReleaseNetworkReady: (release: DeploymentRelease, network: string, currentFingerprint: ReleaseFingerprint) => ReleaseNetwork;

package/dist-runtime/workflow/lib/release.js

@@ -0,0 +1,256 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertReleaseNetworkReady = exports.recordReleaseTargetSimulationSucceeded = exports.loadRelease = exports.validateRelease = exports.buildReleaseFingerprint = exports.hashTargetConfig = exports.hashArtifactInputs = exports.hashValue = exports.stableJson = exports.normalizeCreate2Scheme = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const normalizeCreate2Scheme = (value) => {
+    if (value === undefined || value === null || value === "" || value === "evm") {
+        return "evm";
+    }
+    if (value === "zksync-eravm")
+        return value;
+    throw new Error("CREATE2 scheme must be evm or zksync-eravm");
+};
+exports.normalizeCreate2Scheme = normalizeCreate2Scheme;
+const asObject = (value, label) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(label + " must be an object");
+    }
+    return value;
+};
+const requiredString = (source, key, label) => {
+    const value = source[key];
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(label + "." + key + " must be a non-empty string");
+    }
+    return value.trim();
+};
+const normalizeForJson = (value) => {
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeForJson(item));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .filter((key) => value[key] !== undefined)
+            .map((key) => [key, normalizeForJson(value[key])]));
+    }
+    return value;
+};
+const stableJson = (value) => {
+    return JSON.stringify(normalizeForJson(value));
+};
+exports.stableJson = stableJson;
+const hashValue = (value) => {
+    return crypto_1.default.createHash("sha256").update((0, exports.stableJson)(value)).digest("hex");
+};
+exports.hashValue = hashValue;
+const hashText = (value) => {
+    return crypto_1.default.createHash("sha256").update(value).digest("hex");
+};
+const optionalObject = (value) => {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+};
+const normalizedAddress = (value) => {
+    return typeof value === "string" ? value.toLowerCase() : value;
+};
+const hashArtifactInputs = (artifacts) => {
+    const normalized = artifacts
+        .map((artifact) => ({
+        contract: artifact.contract,
+        bytecode: artifact.bytecode,
+        deployedBytecode: artifact.deployedBytecode,
+        linkReferences: artifact.linkReferences,
+        deployedLinkReferences: artifact.deployedLinkReferences,
+        solcVersion: artifact.solcVersion,
+        optimizer: artifact.optimizer,
+        evmVersion: artifact.evmVersion || null,
+    }))
+        .sort((left, right) => left.contract.localeCompare(right.contract));
+    return (0, exports.hashValue)(normalized);
+};
+exports.hashArtifactInputs = hashArtifactInputs;
+const hashTargetConfig = (network, chainId, target) => {
+    const create2 = optionalObject(target.create2);
+    const multicall = optionalObject(target.multicall);
+    const uups = optionalObject(target.uups);
+    return (0, exports.hashValue)({
+        network,
+        chainId: chainId ?? null,
+        create2: {
+            scheme: (0, exports.normalizeCreate2Scheme)(create2.scheme),
+            factory: normalizedAddress(create2.factory),
+            caller: normalizedAddress(create2.caller),
+            leadingZeroBytes: create2.leadingZeroBytes,
+        },
+        controlledMulticall: normalizedAddress(multicall.controlledMulticall),
+        uupsPlaceholderImplementation: normalizedAddress(uups.placeholderImplementation),
+    });
+};
+exports.hashTargetConfig = hashTargetConfig;
+const buildReleaseFingerprint = (input) => {
+    return {
+        manifestHash: hashText(input.manifest),
+        artifactHash: (0, exports.hashArtifactInputs)(input.artifacts),
+        parametersHash: (0, exports.hashValue)(input.parameters),
+        configHash: (0, exports.hashTargetConfig)(input.network, input.chainId, input.target),
+    };
+};
+exports.buildReleaseFingerprint = buildReleaseFingerprint;
+const validateRelease = (value) => {
+    const release = asObject(value, "release.json");
+    if (release.version !== 1) {
+        throw new Error("release.json.version must be 1");
+    }
+    const networksValue = asObject(release.networks, "release.json.networks");
+    const networks = {};
+    for (const [network, networkValue] of Object.entries(networksValue)) {
+        const entry = asObject(networkValue, "release.json.networks." + network);
+        const parsed = {
+            status: requiredString(entry, "status", "release.json.networks." + network),
+            simulationResult: requiredString(entry, "simulationResult", "release.json.networks." + network),
+            simulatedAt: requiredString(entry, "simulatedAt", "release.json.networks." + network),
+        };
+        for (const key of ["manifestHash", "artifactHash", "parametersHash", "configHash"]) {
+            if (entry[key] !== undefined) {
+                parsed[key] = requiredString(entry, key, "release.json.networks." + network);
+            }
+        }
+        if (entry.simulationCallerNetworkHash !== undefined) {
+            parsed.simulationCallerNetworkHash = requiredString(entry, "simulationCallerNetworkHash", "release.json.networks." + network);
+        }
+        networks[network] = parsed;
+    }
+    return {
+        version: 1,
+        sourceSuperTaskId: requiredString(release, "sourceSuperTaskId", "release.json"),
+        developmentNetwork: requiredString(release, "developmentNetwork", "release.json"),
+        manifestHash: requiredString(release, "manifestHash", "release.json"),
+        artifactHash: requiredString(release, "artifactHash", "release.json"),
+        networks,
+    };
+};
+exports.validateRelease = validateRelease;
+const loadRelease = (taskDir) => {
+    const filePath = path_1.default.join(taskDir, "release.json");
+    if (!fs_1.default.existsSync(filePath)) {
+        throw new Error("Missing release.json in deployment task");
+    }
+    try {
+        return (0, exports.validateRelease)(JSON.parse(fs_1.default.readFileSync(filePath, "utf8")));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new Error("release.json must contain valid JSON: " + error.message);
+        }
+        throw error;
+    }
+};
+exports.loadRelease = loadRelease;
+const safeResultPathSegment = (value, label) => {
+    if (!value
+        || value === "."
+        || value === ".."
+        || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value)) {
+        throw new Error(label + " must be a safe path segment");
+    }
+    return value;
+};
+const writeReleaseAtomically = (filePath, value) => {
+    const contents = `${JSON.stringify(value, null, 2)}\n`;
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`;
+    let descriptor;
+    try {
+        descriptor = fs_1.default.openSync(tempPath, "wx");
+        fs_1.default.writeFileSync(descriptor, contents);
+        fs_1.default.fsyncSync(descriptor);
+        fs_1.default.closeSync(descriptor);
+        descriptor = undefined;
+        fs_1.default.renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        if (descriptor !== undefined)
+            fs_1.default.closeSync(descriptor);
+        if (fs_1.default.existsSync(tempPath))
+            fs_1.default.unlinkSync(tempPath);
+        throw error;
+    }
+};
+const recordReleaseTargetSimulationSucceeded = (input) => {
+    const network = safeResultPathSegment(input.network, "release network");
+    const executionId = safeResultPathSegment(input.executionId, "simulation executionId");
+    const expectedResult = `results/${network}/${executionId}/simulation/execution.json`;
+    if (input.simulationResult !== expectedResult) {
+        throw new Error("Release target requires a canonical simulation result path");
+    }
+    if (!Number.isFinite(Date.parse(input.simulatedAt))) {
+        throw new Error("Release target simulatedAt is invalid");
+    }
+    if (!/^[0-9a-f]{64}$/.test(input.simulationCallerNetworkHash)) {
+        throw new Error("Release target simulation caller network hash is invalid");
+    }
+    const release = (0, exports.loadRelease)(input.taskDir);
+    const current = release.networks[network];
+    if (!current)
+        throw new Error("Release target is not present in release.json");
+    const recordedFingerprint = {
+        manifestHash: current.manifestHash || release.manifestHash,
+        artifactHash: current.artifactHash || release.artifactHash,
+        parametersHash: current.parametersHash || "",
+        configHash: current.configHash || "",
+    };
+    for (const key of ["manifestHash", "artifactHash", "parametersHash", "configHash"]) {
+        if (!input.fingerprint[key] || recordedFingerprint[key] !== input.fingerprint[key]) {
+            throw new Error("Release target fingerprint changed: " + key);
+        }
+    }
+    const next = (0, exports.validateRelease)({
+        ...release,
+        networks: {
+            ...release.networks,
+            [network]: {
+                ...current,
+                status: "simulated",
+                ...input.fingerprint,
+                simulationCallerNetworkHash: input.simulationCallerNetworkHash,
+                simulationResult: expectedResult,
+                simulatedAt: input.simulatedAt,
+            },
+        },
+    });
+    writeReleaseAtomically(path_1.default.join(input.taskDir, "release.json"), next);
+    return next;
+};
+exports.recordReleaseTargetSimulationSucceeded = recordReleaseTargetSimulationSucceeded;
+const assertReleaseNetworkReady = (release, network, currentFingerprint) => {
+    const entry = release.networks[network];
+    if (!entry) {
+        throw new Error("Network " + network + " is not present in release.json");
+    }
+    if (entry.status !== "ready") {
+        throw new Error("Network " + network + " is not release-ready");
+    }
+    if (!entry.simulationCallerNetworkHash || !/^[0-9a-f]{64}$/.test(entry.simulationCallerNetworkHash)) {
+        throw new Error("Network " + network + " release caller network hash is missing or invalid");
+    }
+    const expected = {
+        manifestHash: entry.manifestHash || release.manifestHash,
+        artifactHash: entry.artifactHash || release.artifactHash,
+        parametersHash: entry.parametersHash || "",
+        configHash: entry.configHash || "",
+    };
+    for (const key of ["manifestHash", "artifactHash", "parametersHash", "configHash"]) {
+        if (!expected[key] || expected[key] !== currentFingerprint[key]) {
+            throw new Error("Network " + network + " release fingerprint changed: " + key);
+        }
+    }
+    return entry;
+};
+exports.assertReleaseNetworkReady = assertReleaseNetworkReady;
+//# sourceMappingURL=release.js.map