ysk-server-core 1.0.0 → 1.1.9

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

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

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

package/dist/hosting/validators/native-prune.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Client-native prune after compose image prune. Allowlisted docker run/exec only.
+ */
+import type { ValidatorInstanceDto } from 'ysk-server-shared';
+export type NativePrunePlan = {
+    argv: string[];
+    notes: string[];
+};
+/** Infer a one-shot prune command. Node must already be stopped for geth state prune. */
+export declare function nativePrunePlan(spec: ValidatorInstanceDto): NativePrunePlan | null;
+export declare function nativePruneArgvOk(argv: string[]): boolean;
+//# sourceMappingURL=native-prune.d.ts.map

package/dist/hosting/validators/native-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-prune.d.ts","sourceRoot":"","sources":["../../../src/hosting/validators/native-prune.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,eAAe,GAAG,IAAI,CA+BlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAGzD"}

package/dist/hosting/validators/native-prune.js

@@ -0,0 +1,40 @@
+import { classifyDockerArgv } from '../docker/argv.js';
+/** Infer a one-shot prune command. Node must already be stopped for geth state prune. */
+export function nativePrunePlan(spec) {
+    if (spec.chain === 'eth') {
+        const el = spec.clients.el;
+        if (el?.id === 'geth') {
+            const image = `${el.image}:${el.tag}`;
+            return {
+                argv: [
+                    'run',
+                    '--rm',
+                    '--entrypoint',
+                    'geth',
+                    '-v',
+                    `${spec.dataPath}/geth:/data/geth`,
+                    image,
+                    'snapshot',
+                    'prune-state',
+                    '--datadir',
+                    '/data/geth',
+                ],
+                notes: ['geth snapshot prune-state'],
+            };
+        }
+        return {
+            argv: [],
+            notes: [`${el?.id ?? 'el'} prune is compose-profile (no one-shot CLI)`],
+        };
+    }
+    if (spec.chain === 'btc') {
+        return { argv: [], notes: ['bitcoind already uses -prune= in compose'] };
+    }
+    return { argv: [], notes: [] };
+}
+export function nativePruneArgvOk(argv) {
+    if (!argv.length)
+        return true;
+    return classifyDockerArgv(['docker', ...argv]) !== 'blocked';
+}
+//# sourceMappingURL=native-prune.js.map

package/dist/hosting/validators/native-prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-prune.js","sourceRoot":"","sources":["../../../src/hosting/validators/native-prune.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOvD,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,IAAI,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;YACtC,OAAO;gBACL,IAAI,EAAE;oBACJ,KAAK;oBACL,MAAM;oBACN,cAAc;oBACd,MAAM;oBACN,IAAI;oBACJ,GAAG,IAAI,CAAC,QAAQ,kBAAkB;oBAClC,KAAK;oBACL,UAAU;oBACV,aAAa;oBACb,WAAW;oBACX,YAAY;iBACb;gBACD,KAAK,EAAE,CAAC,2BAA2B,CAAC;aACrC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,6CAA6C,CAAC;SACxE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,0CAA0C,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,kBAAkB,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Allocate host ports for a new validator instance.
+ */
+import type { ValidatorChainId } from 'ysk-server-shared';
+export declare function usedValidatorPorts(dataDir: string): Set<number>;
+export declare function allocateValidatorPorts(dataDir: string, chain: ValidatorChainId): Record<string, number>;
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/hosting/validators/ports.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAc1D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ/D;AASD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CxB"}

package/dist/hosting/validators/ports.js

@@ -0,0 +1,75 @@
+import { listValidatorInstances } from './store.js';
+const ETH_BASE = { rpc: 8545, engine: 8551, p2p: 30303, p2pCl: 9000, beacon: 5052 };
+const AVAX_BASE = { rpc: 9650, p2p: 9651 };
+const NEAR_BASE = { rpc: 3030, p2p: 24567 };
+const ADA_BASE = { p2p: 3001, metrics: 12798 };
+const BTC_BASE = { rpc: 8332, p2p: 8333 };
+const COSMOS_BASE = { rpc: 26657, p2p: 26656 };
+const SUI_BASE = { rpc: 9002 };
+const APTOS_BASE = { rpc: 8080, p2p: 6180 };
+const DOT_BASE = { rpc: 9933, p2p: 30333 };
+const SOL_BASE = { rpc: 8899 };
+export function usedValidatorPorts(dataDir) {
+    const used = new Set();
+    for (const inst of listValidatorInstances(dataDir)) {
+        for (const n of Object.values(inst.ports ?? {})) {
+            if (Number.isInteger(n))
+                used.add(n);
+        }
+    }
+    return used;
+}
+function nextFree(used, start) {
+    let n = start;
+    while (used.has(n) || n < 1024 || n > 65535)
+        n += 1;
+    used.add(n);
+    return n;
+}
+export function allocateValidatorPorts(dataDir, chain) {
+    const used = usedValidatorPorts(dataDir);
+    if (chain === 'avax') {
+        return {
+            rpc: nextFree(used, AVAX_BASE.rpc),
+            p2p: nextFree(used, AVAX_BASE.p2p),
+        };
+    }
+    if (chain === 'near') {
+        return {
+            rpc: nextFree(used, NEAR_BASE.rpc),
+            p2p: nextFree(used, NEAR_BASE.p2p),
+        };
+    }
+    if (chain === 'ada') {
+        return {
+            p2p: nextFree(used, ADA_BASE.p2p),
+            metrics: nextFree(used, ADA_BASE.metrics),
+        };
+    }
+    if (chain === 'btc') {
+        return { rpc: nextFree(used, BTC_BASE.rpc), p2p: nextFree(used, BTC_BASE.p2p) };
+    }
+    if (chain === 'cosmos') {
+        return { rpc: nextFree(used, COSMOS_BASE.rpc), p2p: nextFree(used, COSMOS_BASE.p2p) };
+    }
+    if (chain === 'sui') {
+        return { rpc: nextFree(used, SUI_BASE.rpc) };
+    }
+    if (chain === 'aptos') {
+        return { rpc: nextFree(used, APTOS_BASE.rpc), p2p: nextFree(used, APTOS_BASE.p2p) };
+    }
+    if (chain === 'dot') {
+        return { rpc: nextFree(used, DOT_BASE.rpc), p2p: nextFree(used, DOT_BASE.p2p) };
+    }
+    if (chain === 'sol') {
+        return { rpc: nextFree(used, SOL_BASE.rpc) };
+    }
+    return {
+        rpc: nextFree(used, ETH_BASE.rpc),
+        engine: nextFree(used, ETH_BASE.engine),
+        p2p: nextFree(used, ETH_BASE.p2p),
+        p2pCl: nextFree(used, ETH_BASE.p2pCl),
+        beacon: nextFree(used, ETH_BASE.beacon),
+    };
+}
+//# sourceMappingURL=ports.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Static chain catalog for the validators feature.
+ * Adapter implementations live beside this file; this is metadata only.
+ */
+import type { ValidatorChainSpec, ValidatorProfileId } from 'ysk-server-shared';
+export declare const VALIDATOR_CHAIN_CATALOG: readonly ValidatorChainSpec[];
+export declare function listValidatorChains(): ValidatorChainSpec[];
+export declare function getValidatorChain(id: string): ValidatorChainSpec | undefined;
+export declare function getValidatorNetwork(chainId: string, networkId: string): import("ysk-server-shared").ValidatorNetworkSpec | undefined;
+export declare function minFreeBytesFor(chainId: string, networkId: string, profile: ValidatorProfileId): number | undefined;
+export declare function defaultValidatorNetwork(chainId: string): string | undefined;
+export declare function v1ValidatorClients(chainId: string): import("ysk-server-shared").ValidatorClientSpec[];
+export declare function resolveValidatorClients(chainId: string, want?: {
+    el?: string;
+    cl?: string;
+    node?: string;
+}): Record<string, {
+    id: string;
+    image: string;
+    tag: string;
+}>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/hosting/validators/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,uBAAuB,EAAE,SAAS,kBAAkB,EAgQhE,CAAC;AAIF,wBAAgB,mBAAmB,IAAI,kBAAkB,EAAE,CAQ1D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE5E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gEAGrE;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,qDAEjD;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;QAGlB,MAAM;WAAS,MAAM;SAAO,MAAM;GAanE"}

package/dist/hosting/validators/registry.js

@@ -0,0 +1,311 @@
+const GiB = 1024 ** 3;
+export const VALIDATOR_CHAIN_CATALOG = [
+    {
+        id: 'eth',
+        title: 'Ethereum',
+        v1: true,
+        networks: [
+            { id: 'hoodi', kind: 'testnet', recommended: true, v1: true },
+            { id: 'sepolia', kind: 'testnet', v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'reth', role: 'el', image: 'ghcr.io/paradigmxyz/reth', tag: 'v1.4.8', v1: true },
+            { id: 'geth', role: 'el', image: 'ethereum/client-go', tag: 'v1.15.11', v1: true },
+            { id: 'nethermind', role: 'el', image: 'nethermind/nethermind', tag: '1.31.11', v1: true },
+            { id: 'lighthouse', role: 'cl', image: 'sigp/lighthouse', tag: 'v7.1.0', v1: true },
+            {
+                id: 'prysm',
+                role: 'cl',
+                image: 'gcr.io/prysmaticlabs/prysm/beacon-chain',
+                tag: 'v6.0.4',
+                v1: true,
+            },
+            { id: 'teku', role: 'cl', image: 'consensys/teku', tag: '25.4.1', v1: true },
+            { id: 'nimbus', role: 'cl', image: 'statusim/nimbus-eth2', tag: 'multiarch-v25.4.1', v1: true },
+        ],
+        minFreeBytes: {
+            hoodi: {
+                minimal: 40 * GiB,
+                pruned: 60 * GiB,
+                'validator-ready': 80 * GiB,
+                rpc: 40 * GiB,
+            },
+            sepolia: {
+                minimal: 40 * GiB,
+                pruned: 60 * GiB,
+                'validator-ready': 80 * GiB,
+                rpc: 40 * GiB,
+            },
+            mainnet: {
+                minimal: 800 * GiB,
+                pruned: 900 * GiB,
+                'validator-ready': 1200 * GiB,
+                rpc: 800 * GiB,
+            },
+        },
+    },
+    {
+        id: 'avax',
+        title: 'Avalanche',
+        v1: true,
+        networks: [
+            { id: 'fuji', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            {
+                id: 'avalanchego',
+                role: 'node',
+                image: 'avaplatform/avalanchego',
+                tag: 'v1.13.5',
+                v1: true,
+            },
+        ],
+        minFreeBytes: {
+            fuji: {
+                minimal: 20 * GiB,
+                pruned: 30 * GiB,
+                'validator-ready': 40 * GiB,
+                rpc: 20 * GiB,
+            },
+            mainnet: {
+                minimal: 200 * GiB,
+                pruned: 250 * GiB,
+                'validator-ready': 400 * GiB,
+                rpc: 200 * GiB,
+            },
+        },
+    },
+    {
+        id: 'near',
+        title: 'NEAR',
+        v1: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            {
+                id: 'neard',
+                role: 'node',
+                image: 'nearprotocol/nearcore',
+                tag: '2.5.0',
+                v1: true,
+            },
+        ],
+        minFreeBytes: {
+            testnet: {
+                minimal: 50 * GiB,
+                pruned: 80 * GiB,
+                'validator-ready': 100 * GiB,
+                rpc: 50 * GiB,
+            },
+            mainnet: {
+                minimal: 400 * GiB,
+                pruned: 500 * GiB,
+                'validator-ready': 700 * GiB,
+                rpc: 400 * GiB,
+            },
+        },
+    },
+    {
+        id: 'ada',
+        title: 'Cardano',
+        v1: true,
+        networks: [
+            { id: 'preview', kind: 'testnet', recommended: true, v1: true },
+            { id: 'preprod', kind: 'testnet', v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            {
+                id: 'cardano-node',
+                role: 'node',
+                image: 'inputoutput/cardano-node',
+                tag: '10.1.4',
+                v1: true,
+            },
+        ],
+        minFreeBytes: {
+            preview: {
+                minimal: 20 * GiB,
+                pruned: 30 * GiB,
+                'validator-ready': 40 * GiB,
+                rpc: 20 * GiB,
+            },
+            preprod: {
+                minimal: 30 * GiB,
+                pruned: 40 * GiB,
+                'validator-ready': 50 * GiB,
+                rpc: 30 * GiB,
+            },
+            mainnet: {
+                minimal: 150 * GiB,
+                pruned: 200 * GiB,
+                'validator-ready': 250 * GiB,
+                rpc: 150 * GiB,
+            },
+        },
+    },
+    {
+        id: 'btc',
+        title: 'Bitcoin',
+        v1: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'bitcoind', role: 'node', image: 'lncm/bitcoind', tag: 'v28.0', v1: true },
+        ],
+        minFreeBytes: {
+            testnet: { minimal: 10 * GiB, pruned: 15 * GiB, 'validator-ready': 20 * GiB, rpc: 10 * GiB },
+            mainnet: { minimal: 20 * GiB, pruned: 30 * GiB, 'validator-ready': 40 * GiB, rpc: 20 * GiB },
+        },
+    },
+    {
+        id: 'cosmos',
+        title: 'Cosmos Hub',
+        v1: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'gaiad', role: 'node', image: 'ghcr.io/cosmos/gaia', tag: 'v23.3.0', v1: true },
+        ],
+        minFreeBytes: {
+            testnet: { minimal: 20 * GiB, pruned: 30 * GiB, 'validator-ready': 40 * GiB, rpc: 20 * GiB },
+            mainnet: { minimal: 200 * GiB, pruned: 300 * GiB, 'validator-ready': 400 * GiB, rpc: 200 * GiB },
+        },
+    },
+    {
+        id: 'sui',
+        title: 'Sui',
+        v1: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'sui-node', role: 'node', image: 'mysten/sui-node', tag: 'mainnet-v1.44.2', v1: true },
+        ],
+        minFreeBytes: {
+            testnet: { minimal: 40 * GiB, pruned: 60 * GiB, 'validator-ready': 80 * GiB, rpc: 40 * GiB },
+            mainnet: { minimal: 400 * GiB, pruned: 500 * GiB, 'validator-ready': 700 * GiB, rpc: 400 * GiB },
+        },
+    },
+    {
+        id: 'aptos',
+        title: 'Aptos',
+        v1: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'aptos-node', role: 'node', image: 'aptoslabs/validator', tag: 'aptos-node-v1.27.2', v1: true },
+        ],
+        minFreeBytes: {
+            testnet: { minimal: 40 * GiB, pruned: 60 * GiB, 'validator-ready': 80 * GiB, rpc: 40 * GiB },
+            mainnet: { minimal: 400 * GiB, pruned: 500 * GiB, 'validator-ready': 700 * GiB, rpc: 400 * GiB },
+        },
+    },
+    {
+        id: 'dot',
+        title: 'Polkadot',
+        v1: true,
+        networks: [
+            { id: 'westend', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'polkadot', role: 'node', image: 'parity/polkadot', tag: 'v1.16.1', v1: true },
+        ],
+        minFreeBytes: {
+            westend: { minimal: 30 * GiB, pruned: 40 * GiB, 'validator-ready': 50 * GiB, rpc: 30 * GiB },
+            mainnet: { minimal: 200 * GiB, pruned: 300 * GiB, 'validator-ready': 400 * GiB, rpc: 200 * GiB },
+        },
+    },
+    {
+        id: 'sol',
+        title: 'Solana',
+        v1: true,
+        heavy: true,
+        networks: [
+            { id: 'testnet', kind: 'testnet', recommended: true, v1: true },
+            { id: 'mainnet', kind: 'mainnet', v1: true },
+        ],
+        profiles: ['minimal', 'pruned', 'validator-ready', 'rpc'],
+        clients: [
+            { id: 'agave', role: 'node', image: 'solanalabs/solana', tag: 'v2.1.11', v1: true },
+        ],
+        minFreeBytes: {
+            testnet: { minimal: 200 * GiB, pruned: 300 * GiB, 'validator-ready': 400 * GiB, rpc: 200 * GiB },
+            mainnet: { minimal: 2000 * GiB, pruned: 2200 * GiB, 'validator-ready': 2500 * GiB, rpc: 2000 * GiB },
+        },
+    },
+];
+const BY_ID = new Map(VALIDATOR_CHAIN_CATALOG.map((c) => [c.id, c]));
+export function listValidatorChains() {
+    return VALIDATOR_CHAIN_CATALOG.map((c) => ({
+        ...c,
+        networks: c.networks.map((n) => ({ ...n })),
+        profiles: [...c.profiles],
+        clients: c.clients.map((cl) => ({ ...cl })),
+        minFreeBytes: { ...c.minFreeBytes },
+    }));
+}
+export function getValidatorChain(id) {
+    return BY_ID.get(id);
+}
+export function getValidatorNetwork(chainId, networkId) {
+    const chain = getValidatorChain(chainId);
+    return chain?.networks.find((n) => n.id === networkId);
+}
+export function minFreeBytesFor(chainId, networkId, profile) {
+    const chain = getValidatorChain(chainId);
+    const byNet = chain?.minFreeBytes[networkId];
+    if (!byNet)
+        return undefined;
+    return byNet[profile] ?? byNet.minimal ?? byNet.pruned;
+}
+export function defaultValidatorNetwork(chainId) {
+    const chain = getValidatorChain(chainId);
+    if (!chain)
+        return undefined;
+    return chain.networks.find((n) => n.recommended)?.id ?? chain.networks[0]?.id;
+}
+export function v1ValidatorClients(chainId) {
+    return (getValidatorChain(chainId)?.clients ?? []).filter((c) => c.v1);
+}
+export function resolveValidatorClients(chainId, want) {
+    const all = v1ValidatorClients(chainId);
+    const out = {};
+    if (chainId === 'eth') {
+        const els = all.filter((c) => c.role === 'el');
+        const cls = all.filter((c) => c.role === 'cl');
+        const el = els.find((c) => c.id === want?.el) ?? els.find((c) => c.id === 'reth') ?? els[0];
+        const cl = cls.find((c) => c.id === want?.cl) ?? cls.find((c) => c.id === 'lighthouse') ?? cls[0];
+        if (el)
+            out.el = { id: el.id, image: el.image, tag: el.tag };
+        if (cl)
+            out.cl = { id: cl.id, image: cl.image, tag: cl.tag };
+        return out;
+    }
+    const node = all.find((c) => !want?.node || c.id === want.node) ?? all[0];
+    if (node)
+        out[node.role] = { id: node.id, image: node.image, tag: node.tag };
+    return out;
+}
+//# sourceMappingURL=registry.js.map