@vtechcom/hexcore 2.0.0-beta.1

package/node_modules/@hexcore/shared/dist/esm/hydra-versions.js

@@ -0,0 +1,441 @@
+/**
+ * Per-version hydra-node argv profiles.
+ *
+ * hydra-node's flag set moves between releases: 0.22.x has `--blockfrost` and
+ * `--network` but neither `--unsynced-period` nor the Blockfrost timeout knobs,
+ * which arrived in the 2.x line. An unknown flag aborts hydra-node during
+ * option parsing, so the container dies instantly and the head reports a
+ * generic "node never became ready" that points nowhere near the real cause.
+ *
+ * This table is the declared answer for the versions we ship support for: which
+ * flags exist, and what values to pass when the operator has not overridden
+ * them. Adding a hydra-node release is deliberately a code change — a new entry
+ * here plus a bump of HYDRA_NODE_IMAGE — so a version's argv is reviewed and
+ * tested rather than guessed at runtime.
+ *
+ * Images that match no entry (a fork, a `master` tag, a release newer than this
+ * build) are not rejected: the control-plane falls back to probing
+ * `hydra-node --help`. See capabilities.ts.
+ *
+ * Lives in shared because the UI lists the same versions in the create form
+ * that the control-plane accepts.
+ */
+/** Every platform this table distinguishes, for entries that apply to all. */
+export const HOST_PLATFORMS = [
+    'darwin-arm64',
+    'darwin-x64',
+    'linux-arm64',
+    'linux-x64',
+    'unknown',
+];
+/** True on a platform whose Docker cannot run an amd64 image natively. */
+export function isArm64(platform) {
+    return platform === 'darwin-arm64' || platform === 'linux-arm64';
+}
+/**
+ * Defects worth warning about, newest first.
+ *
+ * Add an entry when upstream confirms one that changes whether a version is
+ * safe to pin — with the issue link, so the claim is checkable and can be
+ * retired when it is fixed.
+ */
+export const HYDRA_KNOWN_ISSUES = [
+    {
+        // No upstream issue: this is how the images are built, not a bug in the
+        // node. Our own record carries the source references and the timings.
+        url: 'https://github.com/Vtechcom/hexcore-v2/issues/7',
+        title: 'The official image is amd64-only and will not run on an arm64 host',
+        impact: 'Every image cardano-scaling publishes is built for amd64 alone. On Apple Silicon it ' +
+            'runs under Rosetta, and from 2.2.0 the node forces the whole KZG trusted setup into ' +
+            'memory before it installs a tracer or opens its API socket — under Rosetta blst loses ' +
+            'the CPU paths that make that fast, so the node stalls there printing nothing at all ' +
+            'and the head fails as a plain readiness timeout with no clue in the log. On arm64 ' +
+            'Linux the daemon simply refuses the image unless qemu is installed. Measured: the ' +
+            'warm-up takes 0.47s on an arm64 rebuild of the same source and was never observed to ' +
+            'finish under Rosetta. Use hydra-node 2.3.x (arm64) instead — same code, architecture ' +
+            'fixed — or 2.1.x, which predates the warm-up but carries a double-spend defect.',
+        severity: 'blocker',
+        /**
+         * Keyed on the image and the host, not on the version range, and both
+         * halves matter. `aniadev9/hydra-node:2.3.0-arm64` parses as 2.3.0, so a
+         * version-range entry would put a blocker on the one image that fixes
+         * this; and on an amd64 host there is nothing wrong at all.
+         *
+         * Both arm64 platforms, even though only one of them fails silently —
+         * an image that cannot run is worth saying before someone pins it for
+         * the life of a head.
+         */
+        imagePattern: /(^|\/)cardano-scaling\/hydra-node(:|$)/,
+        hostPlatforms: ['darwin-arm64', 'linux-arm64'],
+        // The warm-up landed in 8ded45de4 / 016ec6ee2 (2026-05-27), tagged into
+        // 2.2.0. 2.1.0 predates it and boots under Rosetta.
+        affectedFrom: '2.2.0',
+    },
+    {
+        id: 2629,
+        url: 'https://github.com/cardano-scaling/hydra/issues/2629',
+        title: 'The same UTxO can end up spendable on both L1 and L2',
+        impact: 'After recovering an incremental-commit deposit and side-loading a snapshot, the recovered ' +
+            'UTxO reappears in the L2 ledger while it is also back on L1 — spendable twice. Reported ' +
+            'against 2.1.0 on preprod. Only reachable through incremental commit plus recover, but the ' +
+            'consequence is a double spend, so treat a head that has done both as suspect.',
+        severity: 'blocker',
+        // Reported against 2.1.0. Incremental commit plus side-load has a
+        // different shape before 2.0, so the 0.22 line is not claimed here.
+        affectedFrom: '2.0.0',
+        fixedIn: '2.2.0',
+    },
+    {
+        id: 2642,
+        url: 'https://github.com/cardano-scaling/hydra/issues/2642',
+        title: 'Log rotation silently drops pending deposits',
+        impact: 'Rotation writes a checkpoint and discards the events behind it, but the replay path drops ' +
+            '`pendingDeposits` — so a deposit recorded before a rotation is unrecoverable after a restart ' +
+            'except by hand. This one bites here in particular: every head hexcore creates sets ' +
+            '--persistence-rotate-after, so rotation is not a rare event.',
+        severity: 'blocker',
+        // The `Checkpoint` event and `aggregateNodeState` the issue points at
+        // are 2.x head logic.
+        affectedFrom: '2.0.0',
+        fixedIn: '2.3.0',
+    },
+    {
+        id: 2477,
+        url: 'https://github.com/cardano-scaling/hydra/issues/2477',
+        title: 'hydra-node crashes when Blockfrost rate-limits or resets the connection',
+        impact: 'A 403 from Blockfrost — which is what its rate limit returns — or a dropped connection ' +
+            'kills the node outright. It does not retry and does not come back, so the head stays down ' +
+            'until someone restarts it. Nodes sharing one project id hit the rate limit soonest.',
+        severity: 'blocker',
+        // Fixed by PR #2729, merged 2026-07-07; 2.3.0 was cut on 2026-07-15 and
+        // is the first release carrying it.
+        fixedIn: '2.3.0',
+        backends: ['blockfrost'],
+    },
+    {
+        id: 2697,
+        url: 'https://github.com/cardano-scaling/hydra/issues/2697',
+        title: 'Increment and Decrement validators omit `mustNotMintOrBurn`',
+        impact: 'Every other head transition guards against minting or burning; these two did not. Upstream ' +
+            'found no exploit — a burn should still fail indirectly through the value check — but called ' +
+            'that chain of reasoning fragile. Defence in depth rather than a known hole.',
+        severity: 'warning',
+        // Hydra.Contract.Head as it stands in the 2.x scripts; 0.22 ships
+        // different validators entirely.
+        affectedFrom: '2.0.0',
+        fixedIn: '2.2.0',
+    },
+];
+/**
+ * Numeric version from an image tag, or null when it is not a release tag
+ * (`master`, a fork, a digest). Pre-release suffixes are ignored: `2.3.0-rc1`
+ * is treated as 2.3.0, which is the right call for "does this carry the fix".
+ */
+export function parseVersionTag(tag) {
+    const match = /^v?(\d+)\.(\d+)(?:\.(\d+))?/.exec(tag);
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3] ?? 0)];
+}
+/** True when `tag` names a release strictly older than `other`. */
+export function isVersionBefore(tag, other) {
+    const a = parseVersionTag(tag);
+    const b = parseVersionTag(other);
+    if (!a || !b)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] < b[i];
+    }
+    return false;
+}
+/**
+ * Known issues that apply to an image, optionally narrowed to one backend.
+ *
+ * An unparseable tag yields nothing rather than everything: we genuinely do not
+ * know what a `master` build contains, and warning about every open issue on a
+ * version that may well have the fix is noise that trains people to ignore it.
+ */
+export function knownIssuesFor(image, backend, platform = 'unknown') {
+    const tag = imageTag(image);
+    if (!tag || !parseVersionTag(tag))
+        return [];
+    return HYDRA_KNOWN_ISSUES.filter(issue => {
+        if (issue.fixedIn && !isVersionBefore(tag, issue.fixedIn))
+            return false;
+        if (issue.affectedFrom && isVersionBefore(tag, issue.affectedFrom))
+            return false;
+        if (backend && issue.backends && !issue.backends.includes(backend))
+            return false;
+        if (issue.imagePattern && !issue.imagePattern.test(image))
+            return false;
+        /**
+         * A platform-specific issue is hidden only when the host is known to be
+         * one it does not affect. `unknown` still shows it: a warning someone
+         * does not need is a smaller failure than a head that never boots and
+         * says nothing about why.
+         */
+        if (issue.hostPlatforms && platform !== 'unknown' && !issue.hostPlatforms.includes(platform))
+            return false;
+        return true;
+    });
+}
+/**
+ * Newest first — `findVersionProfile` returns the first match, so a more
+ * specific pattern must come before a broader one.
+ */
+export const HYDRA_VERSION_PROFILES = [
+    /**
+     * 2.3.0 rebuilt for arm64 — the same source, the architecture fixed.
+     *
+     * First in the list because `findVersionProfile` takes the first match and
+     * `2.3.0-arm64` also satisfies the 2.3 pattern below.
+     *
+     * It exists because upstream publishes amd64 only, and from 2.2.0 the node
+     * forces the KZG trusted setup into memory before it installs a tracer —
+     * under Rosetta that never finishes and prints nothing while failing. Native
+     * on arm64 the same warm-up takes 0.47s. See Vtechcom/hexcore-v2#7 for the
+     * measurements and docs/FIELD_NOTES.md for how they were taken.
+     *
+     * The flags are 2.3.0's because the code IS 2.3.0; nothing here was probed
+     * separately, and nothing needs to be.
+     *
+     * **This is a personal Docker Hub account, not one this project controls**,
+     * and recommending it makes that a supply-chain dependency for whoever takes
+     * the recommendation. It is offered anyway because the alternative on Apple
+     * Silicon is a version with a known double spend, and because it is
+     * reproducible: `tagPattern` matches the TAG, so anyone who rebuilds 2.3.0
+     * themselves and pushes `you/hydra-node:2.3.0-arm64` lands on this exact
+     * profile. Replace it the moment an image we own, or a multi-arch upstream
+     * one, exists.
+     */
+    {
+        id: '2.3-arm64',
+        label: 'hydra-node 2.3.x (arm64)',
+        image: 'aniadev9/hydra-node:2.3.0-arm64',
+        tagPattern: /^2\.3(\.\d+)?-arm64$/,
+        flags: {
+            unsyncedPeriod: true,
+            blockfrostTimeouts: true,
+            network: true,
+            blockfrost: true,
+            offline: true,
+        },
+        args: {
+            unsyncedPeriod: 180,
+            blockfrostQueryTimeout: 30,
+            blockfrostRetryTimeout: 300,
+            extraArgs: [],
+        },
+        summary: '2.3.0 rebuilt for arm64. Identical code and flags, but it boots natively on Apple ' +
+            'Silicon instead of stalling under Rosetta. Community-built image.',
+        /**
+         * macOS on Apple Silicon only, and not arm64 Linux — which the image
+         * would also run on.
+         *
+         * The narrowing is about what happens when we say nothing. On Docker
+         * Desktop the amd64 image *starts* and then stalls in silence, so an
+         * operator with no recommendation is left with a head that failed for
+         * no visible reason: that is worth spending a third-party image on. On
+         * arm64 Linux the daemon rejects the image immediately and says exactly
+         * why, so the operator can see the problem and choose — including by
+         * rebuilding it themselves, which the known-issue text points at.
+         *
+         * Pointing people at an account this project does not own is a cost.
+         * It is paid where it buys the most and nowhere else.
+         */
+        recommendedOn: ['darwin-arm64'],
+    },
+    {
+        id: '2.3',
+        label: 'hydra-node 2.3.x',
+        image: 'ghcr.io/cardano-scaling/hydra-node:2.3.0',
+        tagPattern: /^2\.3(\.|-|$)/,
+        flags: {
+            unsyncedPeriod: true,
+            blockfrostTimeouts: true,
+            network: true,
+            blockfrost: true,
+            offline: true,
+        },
+        args: {
+            // 180s is upstream's tested value: it clears Blockfrost's 50-80s tip
+            // drift while still catching a genuinely stalled node. See argv.ts
+            // for why the node's own default (half the contestation period) is
+            // too tight on this backend.
+            unsyncedPeriod: 180,
+            blockfrostQueryTimeout: 30,
+            blockfrostRetryTimeout: 300,
+            extraArgs: [],
+        },
+        summary: 'Full Blockfrost drift tolerance. No commit phase (ADR-33), SQLite event store.',
+        /**
+         * Upstream's own build, and the default everywhere except macOS on
+         * Apple Silicon. `unknown` gets it too: when we cannot tell what the
+         * machine is, the image published by the project is more defensible
+         * than one rebuilt by an individual.
+         *
+         * `linux-arm64` is in this list knowingly. The image will not run there
+         * either — but the daemon says so immediately and by name, and that is
+         * a better place to leave someone than pointed at a personal registry.
+         * The known-issue entry still fires and names the alternative.
+         */
+        recommendedOn: ['darwin-x64', 'linux-x64', 'linux-arm64', 'unknown'],
+    },
+    /**
+     * 2.1 is the one concession to machines that cannot run 2.3.0's image.
+     *
+     * Every hydra-node image is amd64-only, and from 2.2.0 on the node forces
+     * the entire KZG trusted setup into memory before it opens a socket or
+     * installs a tracer — under Rosetta that outlasts the readiness budget
+     * without printing a single line, so the node simply never greets. 2.1.0
+     * predates the warm-up and is the only version measured to boot on Apple
+     * Silicon. See docs/FIELD_NOTES.md for how that was established.
+     *
+     * 2.2 is deliberately NOT offered. It carries the same warm-up, so it
+     * solves nothing 2.3 does not, while still carrying two blockers 2.3 fixed
+     * — an option whose only distinguishing feature is being worse. Pinning it
+     * by hand still works, and HYDRA_KNOWN_ISSUES still warns, because that
+     * matches by version range rather than by profile.
+     *
+     * The real answer for arm64 is a rebuilt 2.3 image, which the create form
+     * takes as a custom reference. `tagPattern` matches the TAG, so a private
+     * `you/hydra-node:2.3.0` resolves to the 2.3 profile with no probe needed.
+     *
+     * Flags below were read from `hydra-node --help` on the actual image, not
+     * inferred from the version line: 2.1.0 accepts everything 2.3.0 does,
+     * including the offline branch and the Blockfrost timeouts.
+     */
+    {
+        id: '2.1',
+        label: 'hydra-node 2.1.x',
+        image: 'ghcr.io/cardano-scaling/hydra-node:2.1.0',
+        tagPattern: /^2\.1(\.|-|$)/,
+        flags: {
+            unsyncedPeriod: true,
+            blockfrostTimeouts: true,
+            network: true,
+            blockfrost: true,
+            offline: true,
+        },
+        args: {
+            unsyncedPeriod: 180,
+            blockfrostQueryTimeout: 30,
+            blockfrostRetryTimeout: 300,
+            extraArgs: [],
+        },
+        summary: 'Oldest 2.x with the full flag set. Carries a double-spend defect fixed in 2.2.0 — use it ' +
+            'for testing where 2.3.0 will not run, not for a head holding anything real.',
+    },
+    {
+        id: '0.22',
+        label: 'hydra-node 0.22.x',
+        image: 'ghcr.io/cardano-scaling/hydra-node:0.22.3',
+        tagPattern: /^0\.22(\.|-|$)/,
+        flags: {
+            // Neither the unsynced period nor the Blockfrost timeouts exist on
+            // this line; passing them kills the container at startup.
+            unsyncedPeriod: false,
+            blockfrostTimeouts: false,
+            network: true,
+            blockfrost: true,
+            // Offline mode predates both lines, so it is the one advanced
+            // capability 0.22.x shares with 2.x.
+            offline: true,
+        },
+        args: {
+            // Carried for completeness — the flags above gate them out of argv.
+            unsyncedPeriod: 180,
+            blockfrostQueryTimeout: 30,
+            blockfrostRetryTimeout: 300,
+            extraArgs: [],
+        },
+        summary: 'Legacy protocol (commit phase, older scripts). Runs with a 60s unsynced budget ' +
+            'inside Blockfrost’s 50-80s drift band — prefer 2.3.x on Blockfrost.',
+    },
+];
+/**
+ * Values used when an image matches no profile, so an unrecognised image still
+ * boots with the same tuning the 2.x line gets. Whether the flags are actually
+ * passed is decided separately, by probing the image.
+ */
+export const FALLBACK_HYDRA_ARGS = {
+    unsyncedPeriod: 180,
+    blockfrostQueryTimeout: 30,
+    blockfrostRetryTimeout: 300,
+    extraArgs: [],
+};
+/**
+ * The tag part of an image reference.
+ *
+ * Written by hand rather than with a split(':') because both `localhost:5000/x`
+ * (registry port, no tag) and `x@sha256:…` (digest, no tag) would otherwise
+ * report a tag that does not exist and match the wrong profile.
+ */
+export function imageTag(image) {
+    const at = image.indexOf('@');
+    const ref = at === -1 ? image : image.slice(0, at);
+    const colon = ref.indexOf(':', ref.lastIndexOf('/') + 1);
+    return colon === -1 ? '' : ref.slice(colon + 1);
+}
+/** The profile claiming this image, or undefined when it must be probed. */
+export function findVersionProfile(image) {
+    const tag = imageTag(image);
+    if (!tag)
+        return undefined;
+    return HYDRA_VERSION_PROFILES.find(p => p.tagPattern.test(tag));
+}
+/**
+ * Merge, in order: explicit operator override, then the version's own default,
+ * then the fallback. An override is deliberately allowed to win over the
+ * profile — someone who set HYDRA_UNSYNCED_PERIOD for a reason should not have
+ * it silently reverted by a version bump.
+ */
+export function resolveHydraArgs(profile, overrides = {}) {
+    const base = profile?.args ?? FALLBACK_HYDRA_ARGS;
+    return {
+        unsyncedPeriod: overrides.unsyncedPeriod ?? base.unsyncedPeriod,
+        blockfrostQueryTimeout: overrides.blockfrostQueryTimeout ?? base.blockfrostQueryTimeout,
+        blockfrostRetryTimeout: overrides.blockfrostRetryTimeout ?? base.blockfrostRetryTimeout,
+        extraArgs: [...base.extraArgs],
+    };
+}
+export function toVersionInfo(profile, platform = 'unknown') {
+    return {
+        id: profile.id,
+        label: profile.label,
+        image: profile.image,
+        summary: profile.summary,
+        recommended: profile.recommendedOn?.includes(platform) ?? false,
+        flags: { ...profile.flags },
+        args: { ...profile.args, extraArgs: [...profile.args.extraArgs] },
+        // `imagePattern` is a RegExp and would cross the wire as `{}` — the same
+        // trap `tagPattern` sets on the profile. It has done its job by the time
+        // an issue is in this list, so it is dropped rather than shipped broken.
+        knownIssues: knownIssuesFor(profile.image, undefined, platform).map(stripPatterns),
+    };
+}
+function stripPatterns(issue) {
+    const { imagePattern: _dropped, ...rest } = issue;
+    return rest;
+}
+/**
+ * Map Node's `process.platform` and `process.arch` onto the platforms this
+ * table distinguishes.
+ *
+ * Anything outside the four becomes `unknown` rather than being carried
+ * through: the table only holds evidence about those, and a claim about a
+ * FreeBSD s390x host is one nobody has checked.
+ */
+export function toHostPlatform(os, arch) {
+    if (os === 'darwin' && arch === 'arm64')
+        return 'darwin-arm64';
+    if (os === 'darwin' && arch === 'x64')
+        return 'darwin-x64';
+    if (os === 'linux' && arch === 'arm64')
+        return 'linux-arm64';
+    if (os === 'linux' && arch === 'x64')
+        return 'linux-x64';
+    return 'unknown';
+}
+//# sourceMappingURL=hydra-versions.js.map

package/node_modules/@hexcore/shared/dist/esm/hydra-versions.js.map

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

package/node_modules/@hexcore/shared/dist/esm/index.js

@@ -0,0 +1,7 @@
+export * from './domain.js';
+export * from './api.js';
+export * from './naming.js';
+export * from './hydra-versions.js';
+export * from './offline.js';
+export * from './protocol-params.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@hexcore/shared/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

package/node_modules/@hexcore/shared/dist/esm/naming.js

@@ -0,0 +1,95 @@
+/**
+ * Deterministic naming + path conventions.
+ *
+ * v1 derived container names from the DB primary key of the node, which meant
+ * you could not tell which head a container belonged to without a DB lookup,
+ * and recreating a head produced unpredictable names. v2 names everything from
+ * (headId, nodeIndex) so the whole layout is reproducible and greppable.
+ */
+export const CONTAINER_PREFIX = 'hexcore';
+export const DOCKER_NETWORK = 'hexcore-net';
+export const LABEL_MANAGED = 'io.hexcore.managed';
+export const LABEL_HEAD_ID = 'io.hexcore.head-id';
+export const LABEL_NODE_ID = 'io.hexcore.node-id';
+export const LABEL_NODE_INDEX = 'io.hexcore.node-index';
+/**
+ * Which Hexcore installation owns this container.
+ *
+ * `LABEL_MANAGED` says "Hexcore made this" and nothing more, so it cannot tell
+ * two installations apart — and more than one is normal: a developer running
+ * the repo has one state dir, an `npm i -g hexcore` on the same machine has
+ * another, and both talk to the same Docker daemon. A bulk operation matched on
+ * `LABEL_MANAGED` alone therefore reaches across installations, which is how
+ * `hexcore clean` destroyed the containers of a head it had never heard of.
+ *
+ * The value is a random id kept in the state dir, so it identifies the state
+ * dir rather than the machine, the user or the checkout.
+ */
+export const LABEL_INSTALL = 'io.hexcore.install';
+/** e.g. head 3, index 0 -> `hexcore-h3-n0` (also the Hydra --node-id and DNS name). */
+export function nodeContainerName(headId, nodeIndex) {
+    return `${CONTAINER_PREFIX}-h${headId}-n${nodeIndex}`;
+}
+export function headDirName(headId) {
+    return `head-${headId}`;
+}
+/** Layout under the state dir: heads/head-1/{keys,persistence,...} */
+export const headPaths = (stateDir, headId) => {
+    const root = `${trimSlash(stateDir)}/heads/${headDirName(headId)}`;
+    return {
+        root,
+        keys: `${root}/keys`,
+        persistence: `${root}/persistence`,
+        protocolParameters: `${root}/protocol-parameters.json`,
+        /**
+         * Offline mode only. `--initial-utxo` is the L2 ledger's entire
+         * starting state and `--ledger-genesis` the simulated L1's block-time
+         * parameters; both are written at start, next to everything else the
+         * head owns, so deleting the head takes them with it.
+         */
+        initialUtxo: `${root}/initial-utxo.json`,
+        ledgerGenesis: `${root}/shelley-genesis.json`,
+        /**
+         * Written by v2 up to the per-node keys change, and still removed on
+         * every start so a stale project id does not sit on disk unused.
+         */
+        legacyBlockfrostToken: `${root}/blockfrost.txt`,
+        /**
+         * One token file per node: hydra-node takes `--blockfrost FILE`, so a
+         * per-node key can only be expressed as a per-node file. Nodes sharing
+         * a key simply get the same contents written to each of theirs.
+         */
+        nodeBlockfrostToken: (nodeIndex) => `${root}/blockfrost-n${nodeIndex}.txt`,
+        nodePersistence: (nodeIndex) => `${root}/persistence/n${nodeIndex}`,
+        nodeKeys: (nodeIndex) => ({
+            hydraSk: `${root}/keys/n${nodeIndex}.hydra.sk`,
+            hydraVk: `${root}/keys/n${nodeIndex}.hydra.vk`,
+            cardanoSk: `${root}/keys/n${nodeIndex}.cardano.sk`,
+            cardanoVk: `${root}/keys/n${nodeIndex}.cardano.vk`,
+        }),
+    };
+};
+/**
+ * Same layout as seen from inside the container, where the state dir is always
+ * bind-mounted at /data. Keeping the two in lockstep avoids the class of bug
+ * where a host path leaks into a container argument.
+ */
+export const CONTAINER_DATA_DIR = '/data';
+export const containerHeadPaths = (headId) => headPaths(CONTAINER_DATA_DIR, headId);
+function trimSlash(p) {
+    return p.replace(/\/+$/, '');
+}
+/**
+ * Port allocation. Each node gets a contiguous triple so a head of N nodes
+ * occupies a predictable, non-overlapping range:
+ *   api        = base + slot*10
+ *   p2p        = base + slot*10 + 1
+ *   monitoring = base + slot*10 + 2
+ */
+export const PORT_BASE = 14000;
+export const PORTS_PER_NODE = 10;
+export function portsForSlot(slot, base = PORT_BASE) {
+    const start = base + slot * PORTS_PER_NODE;
+    return { api: start, p2p: start + 1, monitoring: start + 2 };
+}
+//# sourceMappingURL=naming.js.map

package/node_modules/@hexcore/shared/dist/esm/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACxD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAElD,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,SAAiB;IAC/D,OAAO,GAAG,gBAAgB,KAAK,MAAM,KAAK,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACtC,OAAO,QAAQ,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAE,EAAE;IAC1D,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACnE,OAAO;QACH,IAAI;QACJ,IAAI,EAAE,GAAG,IAAI,OAAO;QACpB,WAAW,EAAE,GAAG,IAAI,cAAc;QAClC,kBAAkB,EAAE,GAAG,IAAI,2BAA2B;QACtD;;;;;WAKG;QACH,WAAW,EAAE,GAAG,IAAI,oBAAoB;QACxC,aAAa,EAAE,GAAG,IAAI,uBAAuB;QAC7C;;;WAGG;QACH,qBAAqB,EAAE,GAAG,IAAI,iBAAiB;QAC/C;;;;WAIG;QACH,mBAAmB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,IAAI,gBAAgB,SAAS,MAAM;QAClF,eAAe,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,IAAI,iBAAiB,SAAS,EAAE;QAC3E,QAAQ,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC;YAC9B,OAAO,EAAE,GAAG,IAAI,UAAU,SAAS,WAAW;YAC9C,OAAO,EAAE,GAAG,IAAI,UAAU,SAAS,WAAW;YAC9C,SAAS,EAAE,GAAG,IAAI,UAAU,SAAS,aAAa;YAClD,SAAS,EAAE,GAAG,IAAI,UAAU,SAAS,aAAa;SACrD,CAAC;KACL,CAAC;AACN,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAE5F,SAAS,SAAS,CAAC,CAAS;IACxB,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAQjC,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAI,GAAG,SAAS;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,cAAc,CAAC;IAC3C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/node_modules/@hexcore/shared/dist/esm/offline.js

@@ -0,0 +1,75 @@
+/**
+ * Offline mode.
+ *
+ * hydra-node can run with its layer-1 interface disabled entirely: no chain to
+ * observe, no scripts to publish, no funds to commit. The head opens
+ * immediately with a UTxO set handed to it on disk, which makes it the fastest
+ * way to develop against the Hydra API — and the only way to run one without a
+ * Blockfrost key or a cardano-node socket.
+ *
+ * The flags are mutually exclusive with the online ones (`--offline-head-seed`
+ * is a different branch of hydra-node's option parser than
+ * `--mainnet`/`--node-socket`/`--blockfrost`), so an offline head is a distinct
+ * chain backend here rather than a checkbox on an online one. Passing an online
+ * flag alongside `--offline-head-seed` aborts option parsing and the container
+ * dies before it logs anything useful.
+ *
+ * Reference layout this mirrors: infra/preprod-offline in the graveyard repo —
+ * `--offline-head-seed` + `--initial-utxo` + `--ledger-genesis`, no
+ * contestation or deposit period, single node.
+ */
+/** `--offline-head-seed` takes 32 bytes as hex. */
+export const OFFLINE_HEAD_SEED_BYTES = 32;
+/**
+ * How many nodes an offline head may run.
+ *
+ * Offline mode is multi-party: `--peer` and `--hydra-verification-key` sit
+ * outside hydra-node's chain-config group, so the nodes form a Head over the
+ * same network layer an online head uses. Only the Cardano key options are
+ * online-only, and offline peers authorise nothing on chain, so they are simply
+ * not passed.
+ *
+ * The cap is lower than an online head's ten because every node runs on this
+ * one machine with no L1 to spread the load over, and each brings an embedded
+ * etcd. Five is enough for the multi-party flows worth rehearsing offline
+ * without turning a laptop into the bottleneck under test.
+ */
+export const MAX_OFFLINE_NODES = 5;
+/** Lovelace seeded to each node's own address when no UTxO file is supplied. */
+export const DEFAULT_OFFLINE_SEED_LOVELACE = 20_000_000_000;
+/** A hex seed is exactly 32 bytes, lowercase or upper. */
+export const offlineHeadSeedPattern = /^[0-9a-fA-F]{64}$/;
+/**
+ * Seed derived from the head id when the operator names none.
+ *
+ * It only has to be stable and unique per head: hydra-node derives the offline
+ * head id from it, and every node of the same head must agree. Deriving it from
+ * the row id gives both properties for free and keeps two offline heads on one
+ * machine from colliding — which they would if everyone kept the `…0001` from
+ * the reference config.
+ */
+export function defaultOfflineHeadSeed(headId) {
+    return headId.toString(16).padStart(OFFLINE_HEAD_SEED_BYTES * 2, '0');
+}
+/**
+ * The `--initial-utxo` file: the L2 ledger's entire starting state.
+ *
+ * Keys are TxIn references that no L1 transaction produced — offline mode never
+ * checks them against a chain. A zero tx id with one output index per node is
+ * what the reference config uses, and it keeps the file readable.
+ *
+ * Addresses are the nodes' own generated (or imported) Cardano addresses, so
+ * the operator already holds the signing keys for everything in the head.
+ */
+export function buildInitialUtxo(entries) {
+    const txId = '0'.repeat(64);
+    const utxo = {};
+    entries.forEach((entry, index) => {
+        utxo[`${txId}#${index}`] = {
+            address: entry.address,
+            value: { lovelace: entry.lovelace },
+        };
+    });
+    return utxo;
+}
+//# sourceMappingURL=offline.js.map

package/node_modules/@hexcore/shared/dist/esm/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","sourceRoot":"","sources":["../../src/offline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,gFAAgF;AAChF,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAE5D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1E,CAAC;AAaD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7B,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,GAAG;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;SACtC,CAAC;IACN,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/node_modules/@hexcore/shared/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}