ysk-server-core 1.0.0 → 1.1.0

package/dist/hosting/validators/manager.js

@@ -0,0 +1,447 @@
+/**
+ * Validator instance orchestrator: create / start / stop / restart / clear.
+ */
+import { chmodSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { isSafeValidatorDataPath, isSafeValidatorLimitCpus, isSafeValidatorLimitMemory, isValidatorChainId, isValidatorInstanceId, isValidatorProfileId, isValidatorUpgradePolicy, tl, } from 'ysk-server-shared';
+import { collectValidatorDisk } from './disk.js';
+import { appliedValidatorOp, blockedValidatorOp, failedValidatorOp, writtenValidatorOp, } from './honesty.js';
+import { composeDown, composeFilePath, composeLogs, composeProjectName, composePsRunning, composeUp, probeDockerCompose, writeComposeFile, } from './compose-runner.js';
+import { getValidatorChain, getValidatorNetwork, minFreeBytesFor, resolveValidatorClients, } from './registry.js';
+import { buildValidatorInstance, deleteValidatorInstance, getValidatorInstance, instanceDir, upsertValidatorInstance, } from './store.js';
+import { planInstallFor } from './adapters/index.js';
+import { probeEthStatus } from './adapters/eth.js';
+import { probeAvaxStatus } from './adapters/avax.js';
+import { probeNearStatus } from './adapters/near.js';
+import { probeAdaStatus } from './adapters/ada.js';
+import { probeAptosStatus, probeBtcStatus, probeCosmosStatus, probeDotStatus, probeSolStatus, probeSuiStatus, } from './adapters/phase2.js';
+import { allocateValidatorPorts, usedValidatorPorts } from './ports.js';
+import { syncServiceExposure } from '../service-exposure/sync.js';
+import { applyValidatorUpgrade, detectUpgradeForInstance } from './upgrade.js';
+import { loadRemoteClientTags } from './releases.js';
+export async function createValidatorInstance(input) {
+    if (!isValidatorChainId(input.chain)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    if (!isValidatorProfileId(input.profile)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    const chain = input.chain;
+    const profile = input.profile;
+    const net = getValidatorNetwork(chain, input.network);
+    if (!net || !getValidatorChain(chain)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    const disk = await collectValidatorDisk({ dataDir: input.dataDir, host: input.host });
+    const need = minFreeBytesFor(chain, input.network, profile);
+    if (need && disk.availBytes != null && disk.availBytes < need) {
+        return blockedValidatorOp({
+            reason: 'validation',
+            notes: [
+                tl('validators.errors.diskLow'),
+                `need>=${need}`,
+                `avail=${disk.availBytes}`,
+            ],
+        });
+    }
+    if (net.kind === 'mainnet' && disk.availBytes == null) {
+        return blockedValidatorOp({
+            reason: 'validation',
+            notes: [tl('validators.errors.diskUnknownMainnet')],
+        });
+    }
+    const customPath = input.dataPath?.trim();
+    if (customPath && !isSafeValidatorDataPath(customPath)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.badDataPath')] });
+    }
+    if (input.memory && !isSafeValidatorLimitMemory(input.memory)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    if (input.cpus && !isSafeValidatorLimitCpus(input.cpus)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    const clients = resolveValidatorClients(chain, {
+        el: input.el,
+        cl: input.cl,
+    });
+    const ports = allocateValidatorPorts(input.dataDir, chain);
+    if (input.rpcPort != null && Number.isFinite(input.rpcPort)) {
+        const n = Number(input.rpcPort);
+        if (!Number.isInteger(n) || n <= 1024 || n > 65535) {
+            return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+        }
+        if (usedValidatorPorts(input.dataDir).has(n)) {
+            return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.portInUse')] });
+        }
+        ports.rpc = n;
+    }
+    const limits = input.memory || input.cpus
+        ? { memory: input.memory, cpus: input.cpus }
+        : undefined;
+    let inst;
+    try {
+        inst = buildValidatorInstance({
+            dataDir: input.dataDir,
+            chain,
+            network: input.network,
+            profile,
+            slug: input.slug,
+            clients,
+            ports,
+            dataPath: input.dataPath,
+            limits,
+        });
+    }
+    catch {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    const dir = instanceDir(input.dataDir, inst.id);
+    mkdirSync(dir, { recursive: true });
+    mkdirSync(inst.dataPath, { recursive: true });
+    const plan = planInstallFor(inst);
+    if (plan.jwtPath) {
+        writeFileSync(plan.jwtPath, randomBytes(32).toString('hex') + '\n', { mode: 0o600 });
+        try {
+            chmodSync(plan.jwtPath, 0o600);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    const composePath = composeFilePath(dir);
+    writeComposeFile(composePath, plan.composeYaml, inst.id, inst.limits);
+    upsertValidatorInstance(input.dataDir, inst);
+    const written = [join(dir, '..', 'instances.json'), composePath, inst.dataPath];
+    if (!input.execute || !input.host.executeEnabled()) {
+        return writtenValidatorOp({
+            instanceId: inst.id,
+            written,
+            notes: [tl('validators.notes.dryCreate'), tl('validators.notes.beta')],
+        });
+    }
+    const docker = await probeDockerCompose(input.host);
+    if (!docker.ok) {
+        return blockedValidatorOp({
+            reason: 'missing_binary',
+            instanceId: inst.id,
+            written,
+            notes: [tl('validators.errors.needDocker'), ...docker.notes],
+        });
+    }
+    const up = await composeUp({
+        host: input.host,
+        file: composePath,
+        project: composeProjectName(inst.id),
+        execute: true,
+    });
+    if (!up.ok) {
+        return failedValidatorOp({
+            instanceId: inst.id,
+            written,
+            notes: [tl('validators.errors.composeFailed'), up.stderr || up.stdout],
+        });
+    }
+    upsertValidatorInstance(input.dataDir, { ...inst, desiredState: 'running' });
+    await maybeSyncExposure(input, inst, 'start');
+    const notes = [tl('validators.notes.created')];
+    if (input.mithril && inst.chain === 'ada') {
+        const { restoreAdaMithril } = await import('./mithril.js');
+        const m = await restoreAdaMithril({
+            dataDir: input.dataDir,
+            host: input.host,
+            execute: true,
+            id: inst.id,
+            confirm: inst.id,
+        });
+        notes.push(...(m.notes ?? []));
+    }
+    return appliedValidatorOp({
+        instanceId: inst.id,
+        written,
+        notes,
+    });
+}
+async function withInstance(input, fn) {
+    if (!isValidatorInstanceId(input.id)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.invalidId')] });
+    }
+    const inst = getValidatorInstance(input.dataDir, input.id);
+    if (!inst) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.notFound')] });
+    }
+    const composePath = composeFilePath(instanceDir(input.dataDir, inst.id));
+    return fn(inst, composePath);
+}
+export async function startValidatorInstance(input) {
+    return withInstance(input, async (inst, composePath) => {
+        if (!input.execute || !input.host.executeEnabled()) {
+            return blockedValidatorOp({
+                reason: 'no_execute',
+                instanceId: inst.id,
+                notes: [tl('validators.notes.dryStart')],
+            });
+        }
+        const docker = await probeDockerCompose(input.host);
+        if (!docker.ok) {
+            return blockedValidatorOp({
+                reason: 'missing_binary',
+                instanceId: inst.id,
+                notes: [tl('validators.errors.needDocker'), ...docker.notes],
+            });
+        }
+        const plan = planInstallFor(inst);
+        writeComposeFile(composePath, plan.composeYaml, inst.id, inst.limits);
+        const up = await composeUp({
+            host: input.host,
+            file: composePath,
+            project: composeProjectName(inst.id),
+            execute: true,
+            onLog: input.onLog,
+            signal: input.signal,
+        });
+        if (!up.ok) {
+            return failedValidatorOp({
+                instanceId: inst.id,
+                notes: [tl('validators.errors.composeFailed'), up.stderr || up.stdout],
+            });
+        }
+        upsertValidatorInstance(input.dataDir, { ...inst, desiredState: 'running' });
+        await maybeSyncExposure(input, inst, 'start');
+        return appliedValidatorOp({ instanceId: inst.id, notes: [tl('validators.notes.started')] });
+    });
+}
+export async function stopValidatorInstance(input) {
+    return withInstance(input, async (inst, composePath) => {
+        if (!input.execute || !input.host.executeEnabled()) {
+            return blockedValidatorOp({
+                reason: 'no_execute',
+                instanceId: inst.id,
+                notes: [tl('validators.notes.dryStop')],
+            });
+        }
+        const down = await composeDown({
+            host: input.host,
+            file: composePath,
+            project: composeProjectName(inst.id),
+            execute: true,
+            onLog: input.onLog,
+            signal: input.signal,
+        });
+        if (!down.ok) {
+            return failedValidatorOp({
+                instanceId: inst.id,
+                notes: [tl('validators.errors.composeFailed'), down.stderr || down.stdout],
+            });
+        }
+        upsertValidatorInstance(input.dataDir, { ...inst, desiredState: 'stopped' });
+        await maybeSyncExposure(input, inst, 'stop');
+        return appliedValidatorOp({ instanceId: inst.id, notes: [tl('validators.notes.stopped')] });
+    });
+}
+export async function restartValidatorInstance(input) {
+    const stopped = await stopValidatorInstance(input);
+    if (!stopped.ok)
+        return stopped;
+    return startValidatorInstance(input);
+}
+export function isClearConfirm(id, confirm) {
+    const c = String(confirm ?? '').trim();
+    return c === id || c.toUpperCase() === 'CLEAR';
+}
+export async function clearValidatorInstance(input) {
+    return withInstance(input, async (inst, composePath) => {
+        if (!isClearConfirm(inst.id, input.confirm)) {
+            return blockedValidatorOp({
+                reason: 'validation',
+                instanceId: inst.id,
+                notes: [tl('validators.errors.needConfirm')],
+            });
+        }
+        if (!input.execute || !input.host.executeEnabled()) {
+            return blockedValidatorOp({
+                reason: 'no_execute',
+                instanceId: inst.id,
+                notes: [input.removeUnit ? tl('validators.notes.dryDelete') : tl('validators.notes.dryClear')],
+            });
+        }
+        await composeDown({
+            host: input.host,
+            file: composePath,
+            project: composeProjectName(inst.id),
+            execute: true,
+        });
+        try {
+            rmSync(inst.dataPath, { recursive: true, force: true });
+        }
+        catch {
+            /* continue */
+        }
+        if (input.restoreSnapshot && inst.chain === 'ada') {
+            const { restoreAdaMithril } = await import('./mithril.js');
+            await restoreAdaMithril({
+                dataDir: input.dataDir,
+                host: input.host,
+                execute: true,
+                id: inst.id,
+                confirm: inst.id,
+            });
+        }
+        if (input.removeUnit) {
+            deleteValidatorInstance(input.dataDir, inst.id);
+            try {
+                rmSync(instanceDir(input.dataDir, inst.id), { recursive: true, force: true });
+            }
+            catch {
+                /* continue */
+            }
+            return appliedValidatorOp({ instanceId: inst.id, notes: [tl('validators.notes.deleted')] });
+        }
+        mkdirSync(inst.dataPath, { recursive: true });
+        upsertValidatorInstance(input.dataDir, { ...inst, desiredState: 'stopped' });
+        return appliedValidatorOp({ instanceId: inst.id, notes: [tl('validators.notes.cleared')] });
+    });
+}
+export async function removeValidatorInstance(input) {
+    return clearValidatorInstance({ ...input, removeUnit: true, restoreSnapshot: false });
+}
+async function maybeSyncExposure(input, inst, reason) {
+    const p2p = inst.ports.p2p;
+    if (!p2p)
+        return;
+    try {
+        await syncServiceExposure({
+            host: input.host,
+            dataDir: input.dataDir,
+            serviceId: `val-${inst.id}`.slice(0, 48),
+            ports: [{ role: 'p2p', port: String(p2p), proto: 'tcp' }],
+            reason,
+            requireDecision: false,
+        });
+    }
+    catch {
+        /* non-fatal */
+    }
+}
+export async function statusValidatorInstance(input) {
+    const inst = getValidatorInstance(input.dataDir, input.id);
+    if (!inst) {
+        return {
+            status: 'unknown',
+            running: false,
+            syncProgress: null,
+            peers: null,
+            version: null,
+            diskUsedBytes: null,
+            lastError: tl('validators.errors.notFound'),
+            notes: [],
+        };
+    }
+    const running = await composePsRunning({
+        host: input.host,
+        file: composeFilePath(instanceDir(input.dataDir, inst.id)),
+        project: composeProjectName(inst.id),
+    });
+    let extra = {
+        syncProgress: null,
+        peers: null,
+        version: null,
+        lastError: null,
+    };
+    if (running && inst.chain === 'eth')
+        extra = await probeEthStatus(inst);
+    else if (running && inst.chain === 'avax')
+        extra = await probeAvaxStatus(inst);
+    else if (running && inst.chain === 'near')
+        extra = await probeNearStatus(inst);
+    else if (running && inst.chain === 'ada')
+        extra = await probeAdaStatus(inst);
+    else if (running && inst.chain === 'btc')
+        extra = await probeBtcStatus(inst);
+    else if (running && inst.chain === 'cosmos')
+        extra = await probeCosmosStatus(inst);
+    else if (running && inst.chain === 'sui')
+        extra = await probeSuiStatus(inst);
+    else if (running && inst.chain === 'aptos')
+        extra = await probeAptosStatus(inst);
+    else if (running && inst.chain === 'dot')
+        extra = await probeDotStatus(inst);
+    else if (running && inst.chain === 'sol')
+        extra = await probeSolStatus(inst);
+    const status = !running
+        ? 'stopped'
+        : extra.syncProgress != null && extra.syncProgress < 1
+            ? 'syncing'
+            : extra.lastError
+                ? 'error'
+                : 'running';
+    return {
+        status,
+        running,
+        diskUsedBytes: null,
+        notes: [],
+        instance: inst,
+        upgrade: detectUpgradeForInstance(inst, loadRemoteClientTags(input.dataDir)),
+        ...extra,
+    };
+}
+export async function logsValidatorInstance(input) {
+    const inst = getValidatorInstance(input.dataDir, input.id);
+    if (!inst)
+        return { lines: [], notes: [tl('validators.errors.notFound')] };
+    return composeLogs({
+        host: input.host,
+        file: composeFilePath(instanceDir(input.dataDir, inst.id)),
+        project: composeProjectName(inst.id),
+        tail: input.tail,
+    });
+}
+export function setValidatorPolicy(dataDir, id, policy) {
+    if (!isValidatorUpgradePolicy(policy)) {
+        return { ok: false, notes: [tl('validators.errors.invalidId')] };
+    }
+    const inst = getValidatorInstance(dataDir, id);
+    if (!inst)
+        return { ok: false, notes: [tl('validators.errors.notFound')] };
+    const next = upsertValidatorInstance(dataDir, { ...inst, upgradePolicy: policy });
+    return { ok: true, instance: next, notes: [] };
+}
+export async function upgradeValidatorInstance(input) {
+    return withInstance(input, async (inst) => {
+        if (!input.execute || !input.host.executeEnabled()) {
+            const dry = await applyValidatorUpgrade({
+                dataDir: input.dataDir,
+                host: input.host,
+                spec: inst,
+                execute: false,
+            });
+            return writtenValidatorOp({
+                instanceId: inst.id,
+                written: [],
+                notes: dry.notes,
+            });
+        }
+        const r = await applyValidatorUpgrade({
+            dataDir: input.dataDir,
+            host: input.host,
+            spec: inst,
+            execute: true,
+            onLog: input.onLog,
+            signal: input.signal,
+        });
+        if (!r.ok)
+            return failedValidatorOp({ instanceId: inst.id, notes: r.notes });
+        return appliedValidatorOp({ instanceId: inst.id, notes: r.notes });
+    });
+}
+export async function validatorInstanceRunning(input) {
+    const inst = getValidatorInstance(input.dataDir, input.id);
+    if (!inst)
+        return false;
+    return composePsRunning({
+        host: input.host,
+        file: composeFilePath(instanceDir(input.dataDir, inst.id)),
+        project: composeProjectName(inst.id),
+    });
+}
+//# sourceMappingURL=manager.js.map

package/dist/hosting/validators/manager.js.map

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

package/dist/hosting/validators/mithril.d.ts

@@ -0,0 +1,30 @@
+import type { HostExecutor } from '../../host/executor.js';
+import { type ValidatorOpsResult } from './honesty.js';
+import { type OpsLogFn } from '../ops-log.js';
+export declare const MITHRIL_CLIENT_IMAGE = "ghcr.io/input-output-hk/mithril-client:2537.1";
+export declare const MITHRIL_NETWORKS: Record<string, {
+    aggregator: string;
+    genesisKeyUrl: string;
+}>;
+export declare function mithrilConfigFor(network: string): {
+    aggregator: string;
+    genesisKeyUrl: string;
+};
+export declare function buildMithrilRunArgv(input: {
+    instanceId: string;
+    dataPath: string;
+    aggregator: string;
+    genesisKey: string;
+}): string[];
+export declare function isMithrilConfirm(id: string, confirm: string | undefined): boolean;
+export declare function restoreAdaMithril(input: {
+    dataDir: string;
+    host: HostExecutor;
+    execute: boolean;
+    id: string;
+    confirm?: string;
+    fetchFn?: typeof fetch;
+    onLog?: OpsLogFn;
+    signal?: AbortSignal;
+}): Promise<ValidatorOpsResult>;
+//# sourceMappingURL=mithril.d.ts.map

package/dist/hosting/validators/mithril.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mithril.d.ts","sourceRoot":"","sources":["../../../src/hosting/validators/mithril.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAItB,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEvD,eAAO,MAAM,oBAAoB,kDAAkD,CAAC;AAEpF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,MAAM,EACN;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAiB9C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM;gBAnBhC,MAAM;mBAAiB,MAAM;EAqB5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,EAAE,CAmBX;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGjF;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8F9B"}

package/dist/hosting/validators/mithril.js

@@ -0,0 +1,146 @@
+/**
+ * Cardano Mithril one-click snapshot restore (no block-producer keys).
+ */
+import { classifyDockerArgv } from '../docker/argv.js';
+import { tl } from 'ysk-server-shared';
+import { appliedValidatorOp, blockedValidatorOp, failedValidatorOp, writtenValidatorOp, } from './honesty.js';
+import { composeProjectName, composeFilePath, composeDown, composeUp } from './compose-runner.js';
+import { getValidatorInstance, instanceDir, upsertValidatorInstance } from './store.js';
+import { probeDockerCompose } from './compose-runner.js';
+import { runOpts } from '../ops-log.js';
+export const MITHRIL_CLIENT_IMAGE = 'ghcr.io/input-output-hk/mithril-client:2537.1';
+export const MITHRIL_NETWORKS = {
+    preview: {
+        aggregator: 'https://aggregator.pre-release-preview.api.mithril.network/aggregator',
+        genesisKeyUrl: 'https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/pre-release-preview/genesis.vkey',
+    },
+    preprod: {
+        aggregator: 'https://aggregator.release-preprod.api.mithril.network/aggregator',
+        genesisKeyUrl: 'https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-preprod/genesis.vkey',
+    },
+    mainnet: {
+        aggregator: 'https://aggregator.release-mainnet.api.mithril.network/aggregator',
+        genesisKeyUrl: 'https://raw.githubusercontent.com/IntersectMBO/mithril/main/mithril-infra/configuration/release-mainnet/genesis.vkey',
+    },
+};
+export function mithrilConfigFor(network) {
+    return MITHRIL_NETWORKS[network] ?? MITHRIL_NETWORKS.preview;
+}
+export function buildMithrilRunArgv(input) {
+    return [
+        'run',
+        '--rm',
+        '--name',
+        `ysk-mithril-${input.instanceId}`.slice(0, 60),
+        '-e',
+        `AGGREGATOR_ENDPOINT=${input.aggregator}`,
+        '-e',
+        `GENESIS_VERIFICATION_KEY=${input.genesisKey}`,
+        '-v',
+        `${input.dataPath}:/data`,
+        MITHRIL_CLIENT_IMAGE,
+        'cardano-db',
+        'download',
+        'latest',
+        '--download-dir',
+        '/data',
+    ];
+}
+export function isMithrilConfirm(id, confirm) {
+    const c = String(confirm ?? '').trim();
+    return c === id || c.toUpperCase() === 'MITHRIL';
+}
+export async function restoreAdaMithril(input) {
+    const inst = getValidatorInstance(input.dataDir, input.id);
+    if (!inst) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.notFound')] });
+    }
+    if (inst.chain !== 'ada') {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.mithrilAdaOnly')] });
+    }
+    if (!isMithrilConfirm(inst.id, input.confirm)) {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.needMithrilConfirm')] });
+    }
+    const cfg = mithrilConfigFor(inst.network);
+    const argv = buildMithrilRunArgv({
+        instanceId: inst.id,
+        dataPath: inst.dataPath,
+        aggregator: cfg.aggregator,
+        genesisKey: 'PENDING',
+    });
+    if (classifyDockerArgv(['docker', ...argv]) === 'blocked') {
+        return blockedValidatorOp({ reason: 'validation', notes: [tl('validators.errors.mithrilBlocked')] });
+    }
+    if (!input.execute || !input.host.executeEnabled()) {
+        return writtenValidatorOp({
+            instanceId: inst.id,
+            written: [],
+            notes: [tl('validators.notes.dryMithril'), cfg.aggregator],
+        });
+    }
+    const docker = await probeDockerCompose(input.host);
+    if (!docker.ok) {
+        return blockedValidatorOp({
+            reason: 'missing_binary',
+            instanceId: inst.id,
+            notes: [tl('validators.errors.needDocker'), ...docker.notes],
+        });
+    }
+    const fetchFn = input.fetchFn ?? fetch;
+    let genesisKey = '';
+    try {
+        const res = await fetchFn(cfg.genesisKeyUrl);
+        genesisKey = (await res.text()).trim();
+    }
+    catch (e) {
+        return failedValidatorOp({
+            instanceId: inst.id,
+            notes: [tl('validators.errors.mithrilKey'), e instanceof Error ? e.message : 'fetch failed'],
+        });
+    }
+    if (!genesisKey || genesisKey.length < 32) {
+        return failedValidatorOp({ instanceId: inst.id, notes: [tl('validators.errors.mithrilKey')] });
+    }
+    const composePath = composeFilePath(instanceDir(input.dataDir, inst.id));
+    const project = composeProjectName(inst.id);
+    await composeDown({
+        host: input.host,
+        file: composePath,
+        project,
+        execute: true,
+        onLog: input.onLog,
+        signal: input.signal,
+    });
+    const runArgv = buildMithrilRunArgv({
+        instanceId: inst.id,
+        dataPath: inst.dataPath,
+        aggregator: cfg.aggregator,
+        genesisKey,
+    });
+    const run = await input.host.runCommand(['docker', ...runArgv], {
+        ...runOpts({ execute: true, timeoutMs: 3_600_000, onLog: input.onLog, signal: input.signal }),
+    });
+    if (run.exitCode !== 0) {
+        return failedValidatorOp({
+            instanceId: inst.id,
+            notes: [tl('validators.errors.mithrilFailed'), run.stderr || run.stdout],
+        });
+    }
+    await composeUp({
+        host: input.host,
+        file: composePath,
+        project,
+        execute: true,
+        onLog: input.onLog,
+        signal: input.signal,
+    });
+    const next = {
+        ...inst,
+        lastMithril: { at: new Date().toISOString(), network: inst.network },
+        desiredState: 'running',
+        updatedAt: new Date().toISOString(),
+    };
+    upsertValidatorInstance(input.dataDir, next);
+    return appliedValidatorOp({ instanceId: inst.id, notes: [tl('validators.notes.mithril')] });
+}
+//# sourceMappingURL=mithril.js.map