@vtechcom/hexcore 2.0.0-beta.1

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

@@ -0,0 +1,453 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_HYDRA_ARGS = exports.HYDRA_VERSION_PROFILES = exports.HYDRA_KNOWN_ISSUES = exports.HOST_PLATFORMS = void 0;
+exports.isArm64 = isArm64;
+exports.parseVersionTag = parseVersionTag;
+exports.isVersionBefore = isVersionBefore;
+exports.knownIssuesFor = knownIssuesFor;
+exports.imageTag = imageTag;
+exports.findVersionProfile = findVersionProfile;
+exports.resolveHydraArgs = resolveHydraArgs;
+exports.toVersionInfo = toVersionInfo;
+exports.toHostPlatform = toHostPlatform;
+/** Every platform this table distinguishes, for entries that apply to all. */
+exports.HOST_PLATFORMS = [
+    'darwin-arm64',
+    'darwin-x64',
+    'linux-arm64',
+    'linux-x64',
+    'unknown',
+];
+/** True on a platform whose Docker cannot run an amd64 image natively. */
+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.
+ */
+exports.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".
+ */
+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`. */
+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.
+ */
+function knownIssuesFor(image, backend, platform = 'unknown') {
+    const tag = imageTag(image);
+    if (!tag || !parseVersionTag(tag))
+        return [];
+    return exports.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.
+ */
+exports.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.
+ */
+exports.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.
+ */
+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. */
+function findVersionProfile(image) {
+    const tag = imageTag(image);
+    if (!tag)
+        return undefined;
+    return exports.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.
+ */
+function resolveHydraArgs(profile, overrides = {}) {
+    const base = profile?.args ?? exports.FALLBACK_HYDRA_ARGS;
+    return {
+        unsyncedPeriod: overrides.unsyncedPeriod ?? base.unsyncedPeriod,
+        blockfrostQueryTimeout: overrides.blockfrostQueryTimeout ?? base.blockfrostQueryTimeout,
+        blockfrostRetryTimeout: overrides.blockfrostRetryTimeout ?? base.blockfrostRetryTimeout,
+        extraArgs: [...base.extraArgs],
+    };
+}
+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.
+ */
+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/cjs/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/cjs/index.d.ts

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

package/node_modules/@hexcore/shared/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/cjs/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./domain"), exports);
+__exportStar(require("./api"), exports);
+__exportStar(require("./naming"), exports);
+__exportStar(require("./hydra-versions"), exports);
+__exportStar(require("./offline"), exports);
+__exportStar(require("./protocol-params"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,wCAAsB;AACtB,2CAAyB;AACzB,mDAAiC;AACjC,4CAA0B;AAC1B,oDAAkC"}

package/node_modules/@hexcore/shared/dist/cjs/naming.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 declare const CONTAINER_PREFIX = "hexcore";
+export declare const DOCKER_NETWORK = "hexcore-net";
+export declare const LABEL_MANAGED = "io.hexcore.managed";
+export declare const LABEL_HEAD_ID = "io.hexcore.head-id";
+export declare const LABEL_NODE_ID = "io.hexcore.node-id";
+export declare 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 declare const LABEL_INSTALL = "io.hexcore.install";
+/** e.g. head 3, index 0 -> `hexcore-h3-n0` (also the Hydra --node-id and DNS name). */
+export declare function nodeContainerName(headId: number, nodeIndex: number): string;
+export declare function headDirName(headId: number): string;
+/** Layout under the state dir: heads/head-1/{keys,persistence,...} */
+export declare const headPaths: (stateDir: string, headId: number) => {
+    root: string;
+    keys: string;
+    persistence: string;
+    protocolParameters: string;
+    /**
+     * 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: string;
+    ledgerGenesis: string;
+    /**
+     * 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: string;
+    /**
+     * 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: number) => string;
+    nodePersistence: (nodeIndex: number) => string;
+    nodeKeys: (nodeIndex: number) => {
+        hydraSk: string;
+        hydraVk: string;
+        cardanoSk: string;
+        cardanoVk: string;
+    };
+};
+/**
+ * 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 declare const CONTAINER_DATA_DIR = "/data";
+export declare const containerHeadPaths: (headId: number) => {
+    root: string;
+    keys: string;
+    persistence: string;
+    protocolParameters: string;
+    /**
+     * 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: string;
+    ledgerGenesis: string;
+    /**
+     * 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: string;
+    /**
+     * 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: number) => string;
+    nodePersistence: (nodeIndex: number) => string;
+    nodeKeys: (nodeIndex: number) => {
+        hydraSk: string;
+        hydraVk: string;
+        cardanoSk: string;
+        cardanoVk: string;
+    };
+};
+/**
+ * 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 declare const PORT_BASE = 14000;
+export declare const PORTS_PER_NODE = 10;
+export interface NodePorts {
+    api: number;
+    p2p: number;
+    monitoring: number;
+}
+export declare function portsForSlot(slot: number, base?: number): NodePorts;
+//# sourceMappingURL=naming.d.ts.map

package/node_modules/@hexcore/shared/dist/cjs/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../src/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAClD,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,uBAAuB,CAAC;AAElD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,sEAAsE;AACtE,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,QAAQ,MAAM;;;;;IAOlD;;;;;OAKG;;;IAGH;;;OAGG;;IAEH;;;;OAIG;qCAC8B,MAAM;iCACV,MAAM;0BACb,MAAM;;;;;;CAOnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAC1C,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM;;;;;IAnCzC;;;;;OAKG;;;IAGH;;;OAGG;;IAEH;;;;OAIG;qCAC8B,MAAM;iCACV,MAAM;0BACb,MAAM;;;;;;CAeuD,CAAC;AAM5F;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,MAAM,WAAW,SAAS;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,SAAS,CAGtE"}