@mysten-incubation/devstack 0.0.1 → 0.1.0

package/dist/plugins/walrus/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/walrus/index.ts"],"sourcesContent":["// Walrus plugin — barrel + factories.\n//\n// Architecture: Walrus is a service plugin that owns a local cluster\n// or describes a known deployment. The factory at this file folds the\n// four modes behind:\n//\n//   - `walrus(opts?)`           — local-cluster shorthand. No env\n//                                  defaulting; use `walrusFor(...)`\n//                                  for known deployments.\n//   - `walrusFor(network)`  — mode-narrowed factory namespace\n//                                  (architecture Tension 11). Returns\n//                                  `{ local: …, known: … }` narrowed\n//                                  to the network's mode. Crucially,\n//                                  the fork branch exposes ONLY\n//                                  `.known` — `.local` is a compile\n//                                  error on a fork-mode network.\n//\n// The plugin emits FOUR capability decls (per mode):\n//\n//   Local mode (full local cluster):\n//     1. `snapshotable`        — runtime/walrus/<name>/deploy/ subtree\n//                                 + storage-node managed containers.\n//     2. `codegenable`         — `walrus-network` bindings.\n//     3. `routable` × (N + 2)  — per-node + aggregator + publisher.\n//     4. `strategy-contributor:walrus-state-registry`  — local entry.\n//     5. `strategy-contributor:endpoint-registry`      — N+2 entries.\n//     6. `strategy-contributor:package-registry`       — `walrus.<name>`.\n//     7. `strategy-contributor:coinType:<WAL fullCoinType>`\n//                                                      — WAL faucet\n//                                                        strategy\n//                                                        (when exchange exists).\n//\n//   Known mode (read-only deployment):\n//     1. `snapshotable`        — identity-guard only; no subtrees.\n//     2. `codegenable`         — `walrus-network` bindings (mode='known').\n//     3. `strategy-contributor:walrus-state-registry` — known entry.\n//\n// Resource id: `'walrus'` (singular). The plugin's substrate-level\n// plugin key is the same string.\n\nimport { Effect, Path } from 'effect';\n\nimport { defineModeNamespace } from '../../api/mode-narrowed-factory.ts';\nimport { definePlugin, resource, type ResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { ContainerRuntime, EnsureNetworkSpec } from '../../contracts/container-runtime.ts';\nimport type { RoutableDecl } from '../../contracts/routable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport { ContainerRuntimeService } from '../../runtime/docker/service.ts';\nimport { IdentityContext, StackPathsService } from '../../substrate/runtime/paths.ts';\nimport { ArtifactPublisherService } from '../../substrate/runtime/artifact-publisher/index.ts';\nimport type { AcquireContext } from '../../substrate/plugin.ts';\nimport type { AccountFundingCoinValue } from '../account/index.ts';\nimport { coinResourceId, type CoinResourceId } from '../coin/index.ts';\nimport type { SuiProbeKey } from '../sui/chain-probe.ts';\nimport { suiResource } from '../sui/index.ts';\n\nimport { chainProbeFor } from '../../substrate/runtime/strategy-registry/index.ts';\n\nimport { makeCodegenable } from './codegen.ts';\nimport { walrusPluginKey } from './plugin-key.ts';\nimport { WALRUS_ERROR_TAGS, walrusPluginError, type WalrusPluginError } from './errors.ts';\nimport { walFaucetStrategyKey, type WalFaucetStrategy } from './faucet-strategy.ts';\nimport { bootWalrusService, type WalrusMode } from './service.ts';\nimport {\n\tresolveLocalClusterOptions,\n\ttype WalrusLocalClusterOptions,\n} from './mode/local-cluster.ts';\nimport {\n\tresolveKnownDeploymentOptions,\n\ttype WalrusKnownDeploymentOptions,\n} from './mode/known-deploy.ts';\nimport { makeSnapshotable, type WalrusSnapshotMode } from './snapshot.ts';\nimport { makeLocalRoutables } from './routable.ts';\nimport { WALRUS_STATE_REGISTRY_KEY, type WalrusStateEntry } from './registry-publish.ts';\nimport { buildWalrusNetworkName, type WalrusStorageNode } from './storage-nodes.ts';\n\n// ---------------------------------------------------------------------------\n// Resource — the resolved value all consumers read\n// ---------------------------------------------------------------------------\n\n/** The Walrus resolved value carried by the resource. */\nexport interface WalrusResolved {\n\treadonly mode: 'local' | 'known';\n\treadonly chain: string;\n\treadonly walrusPackageId: string | null;\n\treadonly walPackageId: string | null;\n\t/** SDK-ready `packageConfig` — structurally compatible with\n\t *  `@mysten/walrus`'s `WalrusPackageConfig`. */\n\treadonly packageConfig: {\n\t\treadonly systemObjectId: string;\n\t\treadonly stakingPoolId: string;\n\t\treadonly exchangeIds?: ReadonlyArray<string>;\n\t};\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\treadonly proxyUrl: string | null;\n\treadonly aggregatorUrl: string | null;\n\treadonly publisherUrl: string | null;\n\treadonly walFaucetStrategy: WalFaucetStrategy | null;\n\treadonly walCoinType: string | null;\n}\n\n/** Walrus plugin resource. */\nexport const walrusResource = resource<'walrus', WalrusResolved>('walrus');\nconst walrusErrorContributions = pluginErrorContributions(WALRUS_ERROR_TAGS);\n\nexport interface WalrusNetworkIdentity {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly walrusName: string;\n}\n\n/** Walrus deploy records storage-node listening IPs under this /24.\n *  Docker network create requests the matching subnet explicitly, with\n *  the prefix derived from the Walrus network identity so parallel\n *  stacks don't all claim the same Docker IPAM range. */\nexport const deriveWalrusSubnetPrefix = (identity: WalrusNetworkIdentity): string => {\n\tconst key = `${identity.app}\\0${identity.stack}\\0${identity.walrusName}`;\n\tlet hash = 0x811c9dc5;\n\tfor (let i = 0; i < key.length; i += 1) {\n\t\thash ^= key.charCodeAt(i);\n\t\thash = Math.imul(hash, 0x01000193) >>> 0;\n\t}\n\tconst bucket = hash % (64 * 256);\n\tconst secondOctet = 64 + Math.floor(bucket / 256);\n\tconst thirdOctet = bucket % 256;\n\treturn `10.${secondOctet}.${thirdOctet}`;\n};\n\nexport const walrusNetworkCreateSpec = <Spec extends EnsureNetworkSpec>(\n\tspec: Spec,\n\tsubnetPrefix: string,\n): Spec & Required<Pick<EnsureNetworkSpec, 'subnet' | 'gateway'>> => ({\n\t...spec,\n\tsubnet: `${subnetPrefix}.0/24`,\n\tgateway: `${subnetPrefix}.1`,\n});\n\nconst withWalrusNetworkAddressing = (\n\truntime: ContainerRuntime,\n\twalrusNetworkName: string,\n\tsubnetPrefix: string,\n): ContainerRuntime => ({\n\t...runtime,\n\tensureNetwork: (spec) =>\n\t\truntime.ensureNetwork(\n\t\t\tspec.name === walrusNetworkName ? walrusNetworkCreateSpec(spec, subnetPrefix) : spec,\n\t\t),\n});\n\n// ---------------------------------------------------------------------------\n// Plugin construction (internal — used by walrus() + walrusFor())\n// ---------------------------------------------------------------------------\n\nconst buildLocalPlugin = (opts: WalrusLocalClusterOptions) => {\n\t// Synchronous factory-time validation (distilled-doc invariants\n\t// 11 — `nodeCount >= 1` + `shards >= nodeCount`).\n\tconst resolved = resolveLocalClusterOptions(opts);\n\n\tconst walrusKey = walrusPluginKey(resolved.name);\n\n\treturn definePlugin({\n\t\tid: walrusResource.id,\n\t\tdependsOn: [suiResource] as const,\n\t\trole: 'service',\n\t\tpluginKey: walrusKey,\n\t\tstart: (deps) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst [sui] = deps;\n\n\t\t\t\t// Substrate-context primitives:\n\t\t\t\t//   - `ContainerRuntimeService` + `IdentityContext` arrive\n\t\t\t\t//     via the supervisor's plugin runtime context.\n\t\t\t\t//   - `ArtifactPublisher` is the substrate-level\n\t\t\t\t//     publisher (cache → verify → produce → register cycle).\n\t\t\t\t//   - `ChainProbe<SuiProbeKey>` is looked up via the\n\t\t\t\t//     StrategyRegistry under `chain-probe:<chainId>`;\n\t\t\t\t//     Sui registered itself there at its own acquire.\n\t\t\t\t//   - `StackPathsService` resolves the per-stack on-disk\n\t\t\t\t//     root so the deploy-output bind-mount source is a\n\t\t\t\t//     real path (not the `<runtime>/...` template).\n\t\t\t\tconst runtime = yield* ContainerRuntimeService;\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst stackPaths = yield* StackPathsService;\n\t\t\t\tconst path = yield* Path.Path;\n\t\t\t\tconst publisher = yield* ArtifactPublisherService;\n\t\t\t\tconst probe = yield* chainProbeFor<SuiProbeKey>(sui.chain);\n\n\t\t\t\t// Resolve the deploy-output bind-mount source from the\n\t\t\t\t// per-stack paths bundle. The deploy one-shot owns preparing\n\t\t\t\t// the directory immediately before its Docker bind mount.\n\t\t\t\tconst deployHostMountPath = path.join(\n\t\t\t\t\tstackPaths.stackRoot,\n\t\t\t\t\t'walrus',\n\t\t\t\t\tresolved.name,\n\t\t\t\t\t'deploy',\n\t\t\t\t);\n\n\t\t\t\t// Cross-container DNS: walrus containers (deploy one-shot\n\t\t\t\t// + N storage nodes) dial sui RPC + faucet via\n\t\t\t\t// `host.docker.internal`. The sui plugin binds brokered\n\t\t\t\t// host ports — no shared docker network needed.\n\t\t\t\t//\n\t\t\t\t// Architectural decision (B5): walrus owns its OWN docker\n\t\t\t\t// network for storage-node ↔ deploy connectivity; sui-side\n\t\t\t\t// hops go through the host gateway.\n\t\t\t\t// On Linux this requires Docker Desktop or the\n\t\t\t\t// `host.docker.internal:host-gateway` runtime hint (the\n\t\t\t\t// established devstack convention — see plugins/deepbook\n\t\t\t\t// which uses the same pattern).\n\t\t\t\tconst walrusNetworkName = buildWalrusNetworkName(\n\t\t\t\t\tidentity.app,\n\t\t\t\t\tidentity.stack,\n\t\t\t\t\tresolved.name,\n\t\t\t\t);\n\t\t\t\tconst walrusSubnetPrefix = deriveWalrusSubnetPrefix({\n\t\t\t\t\tapp: identity.app,\n\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\twalrusName: resolved.name,\n\t\t\t\t});\n\t\t\t\tconst walrusRuntime = withWalrusNetworkAddressing(\n\t\t\t\t\truntime,\n\t\t\t\t\twalrusNetworkName,\n\t\t\t\t\twalrusSubnetPrefix,\n\t\t\t\t);\n\t\t\t\tconst suiRpcUrlInNetwork = sui.hostGateway.rpcUrl;\n\t\t\t\t// sui-faucet v2 endpoint — `/v2/gas` is the supported path\n\t\t\t\t// on devnet-v1.71.0+ (the binary still answers `/v1/gas`\n\t\t\t\t// for backwards-compat but new code targets v2).\n\t\t\t\tconst suiFaucetUrlInNetwork = sui.hostGateway.faucetUrl;\n\t\t\t\tif (suiFaucetUrlInNetwork === null) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'deploy',\n\t\t\t\t\t\t\t'walrus local-cluster requires a Sui faucet URL for deploy funding.',\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst walrusFaucetUrlInNetwork = `${suiFaucetUrlInNetwork}/v2/gas`;\n\n\t\t\t\tconst mode: WalrusMode = { mode: 'local', opts: resolved };\n\t\t\t\tconst boot = yield* bootWalrusService(\n\t\t\t\t\t{\n\t\t\t\t\t\truntime: walrusRuntime,\n\t\t\t\t\t\tpublisher,\n\t\t\t\t\t\tprobe,\n\t\t\t\t\t\tsuiSdk: sui.sdk,\n\t\t\t\t\t\tsuiChainId: sui.chain,\n\t\t\t\t\t\tsuiRpcUrlInNetwork,\n\t\t\t\t\t\twalrusFaucetUrlInNetwork,\n\t\t\t\t\t\twaitForFundsReady: sui.waitForTransactionsReady.wait,\n\t\t\t\t\t\tapp: identity.app,\n\t\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\t\tsubnetPrefix: walrusSubnetPrefix,\n\t\t\t\t\t\twalrusNetworkName,\n\t\t\t\t\t\t// Walrus has no `sui-net` to attach to (sui binds\n\t\t\t\t\t\t// host ports). Reuse the walrus network so the\n\t\t\t\t\t\t// deploy one-shot + storage nodes land on a single\n\t\t\t\t\t\t// network and reach sui via `host.docker.internal`.\n\t\t\t\t\t\tsuiNetworkName: walrusNetworkName,\n\t\t\t\t\t\tdeployHostMountPath,\n\t\t\t\t\t},\n\t\t\t\t\tmode,\n\t\t\t\t);\n\n\t\t\t\tif (boot.mode !== 'local') {\n\t\t\t\t\t// Should be unreachable — dispatch is by mode. Defense.\n\t\t\t\t\treturn yield* Effect.die('walrus: mode mismatch in local plugin');\n\t\t\t\t}\n\n\t\t\t\tconst resolvedValue: WalrusResolved = {\n\t\t\t\t\tmode: 'local',\n\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\twalrusPackageId: boot.walrusPackageId,\n\t\t\t\t\twalPackageId: boot.walPackageId,\n\t\t\t\t\tpackageConfig: {\n\t\t\t\t\t\tsystemObjectId: boot.deploy.systemObject,\n\t\t\t\t\t\tstakingPoolId: boot.deploy.stakingObject,\n\t\t\t\t\t\texchangeIds: boot.exchangeObjectId ? [boot.exchangeObjectId] : undefined,\n\t\t\t\t\t},\n\t\t\t\t\tnodes: boot.nodes,\n\t\t\t\t\tproxyUrl: boot.proxyUrl,\n\t\t\t\t\taggregatorUrl: boot.aggregatorUrl,\n\t\t\t\t\tpublisherUrl: boot.publisherUrl,\n\t\t\t\t\twalFaucetStrategy: boot.walFaucetStrategy,\n\t\t\t\t\twalCoinType: boot.walCoinType,\n\t\t\t\t};\n\t\t\t\treturn resolvedValue;\n\t\t\t}),\n\t\tcapabilities: ({ value: resolvedValue, runtime: acquireCtx }) =>\n\t\t\tmakeLocalCapabilities({\n\t\t\t\tname: resolved.name,\n\t\t\t\tnodeCount: resolved.nodeCount,\n\t\t\t\tcontainerApiPort: resolved.containerApiPort,\n\t\t\t\tserviceKey: String(walrusKey),\n\t\t\t\tresolved: resolvedValue,\n\t\t\t\tacquireCtx,\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\nconst buildKnownPlugin = (opts: WalrusKnownDeploymentOptions) => {\n\t// Synchronous factory-time validation for required deployment ids.\n\tconst resolved = resolveKnownDeploymentOptions(opts);\n\n\treturn definePlugin({\n\t\tid: walrusResource.id,\n\t\tdependsOn: [suiResource] as const,\n\t\t// Known deployment is a pure value-producer — no containers,\n\t\t// no long-running children.\n\t\trole: 'task',\n\t\tstart: () =>\n\t\t\tEffect.succeed({\n\t\t\t\tmode: 'known',\n\t\t\t\tchain: resolved.chain,\n\t\t\t\twalrusPackageId: null,\n\t\t\t\twalPackageId: null,\n\t\t\t\tpackageConfig: {\n\t\t\t\t\tsystemObjectId: resolved.systemObjectId,\n\t\t\t\t\tstakingPoolId: resolved.stakingPoolId,\n\t\t\t\t\texchangeIds: resolved.exchangeIds.length > 0 ? resolved.exchangeIds : undefined,\n\t\t\t\t},\n\t\t\t\tnodes: resolved.nodes,\n\t\t\t\tproxyUrl: resolved.proxyUrl,\n\t\t\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\t\t\tpublisherUrl: resolved.publisherUrl,\n\t\t\t\twalFaucetStrategy: null,\n\t\t\t\twalCoinType: null,\n\t\t\t} satisfies WalrusResolved),\n\t\tcapabilities: ({ value: resolvedValue, runtime: acquireCtx }) =>\n\t\t\tmakeKnownCapabilities({\n\t\t\t\tresolved: resolvedValue,\n\t\t\t\tacquireCtx,\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\nconst makeLocalCapabilities = (parts: {\n\treadonly name: string;\n\treadonly nodeCount: number;\n\treadonly containerApiPort: number;\n\treadonly serviceKey: string;\n\treadonly resolved: WalrusResolved;\n\treadonly acquireCtx: AcquireContext;\n}) => {\n\tconst { name, nodeCount, containerApiPort, serviceKey, resolved, acquireCtx } = parts;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\t'local' satisfies WalrusSnapshotMode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\tname,\n\t\tresolved.chain,\n\t\tnodeCount,\n\t);\n\tconst codegen: CodegenableDecl<'walrus-network'> = makeCodegenable({\n\t\tmode: 'local',\n\t\tchain: resolved.chain,\n\t\twalrusPackageId: resolved.walrusPackageId,\n\t\twalPackageId: resolved.walPackageId,\n\t\twalCoinType: resolved.walCoinType,\n\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\tstakingPoolId: resolved.packageConfig.stakingPoolId,\n\t\texchangeIds: resolved.packageConfig.exchangeIds ? [...resolved.packageConfig.exchangeIds] : [],\n\t\tproxyUrl: resolved.proxyUrl,\n\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\tpublisherUrl: resolved.publisherUrl,\n\t\tnodes: resolved.nodes,\n\t});\n\tconst stateRegistry: StrategyContributorDecl<\n\t\ttypeof WALRUS_STATE_REGISTRY_KEY,\n\t\t{ readonly noteName: string }\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: WALRUS_STATE_REGISTRY_KEY,\n\t\tstrategy: { noteName: name },\n\t\tautoMounted: true,\n\t};\n\tconst walFaucetContribution =\n\t\tresolved.walFaucetStrategy === null || resolved.walCoinType === null\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t{\n\t\t\t\t\t\tkind: 'strategy-contributor',\n\t\t\t\t\t\tcapabilityKey: walFaucetStrategyKey(resolved.walCoinType),\n\t\t\t\t\t\tstrategy: resolved.walFaucetStrategy,\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<\n\t\t\t\t\t\tReturnType<typeof walFaucetStrategyKey>,\n\t\t\t\t\t\tWalFaucetStrategy\n\t\t\t\t\t>,\n\t\t\t\t];\n\tconst routables = makeLocalRoutables({\n\t\tapp: acquireCtx.identity.app,\n\t\tstack: acquireCtx.identity.stack,\n\t\twalrusName: name,\n\t\tserviceKey,\n\t\tnodeCount,\n\t\tcontainerApiPort,\n\t});\n\treturn [\n\t\tsnap,\n\t\tcodegen,\n\t\tstateRegistry,\n\t\t...walFaucetContribution,\n\t\t...(routables as readonly RoutableDecl[]),\n\t] as const;\n};\n\nconst makeKnownCapabilities = (parts: {\n\treadonly resolved: WalrusResolved;\n\treadonly acquireCtx: AcquireContext;\n}) => {\n\tconst { resolved, acquireCtx } = parts;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\t'known' satisfies WalrusSnapshotMode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\t'walrusKnownDeployment',\n\t\tresolved.chain,\n\t);\n\tconst codegen: CodegenableDecl<'walrus-network'> = makeCodegenable({\n\t\tmode: 'known',\n\t\tchain: resolved.chain,\n\t\twalrusPackageId: resolved.walrusPackageId,\n\t\twalPackageId: resolved.walPackageId,\n\t\twalCoinType: resolved.walCoinType,\n\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\tstakingPoolId: resolved.packageConfig.stakingPoolId,\n\t\texchangeIds: resolved.packageConfig.exchangeIds ? [...resolved.packageConfig.exchangeIds] : [],\n\t\tproxyUrl: resolved.proxyUrl,\n\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\tpublisherUrl: resolved.publisherUrl,\n\t\tnodes: resolved.nodes,\n\t});\n\tconst stateRegistry: StrategyContributorDecl<typeof WALRUS_STATE_REGISTRY_KEY, WalrusStateEntry> =\n\t\t{\n\t\t\tkind: 'strategy-contributor',\n\t\t\tcapabilityKey: WALRUS_STATE_REGISTRY_KEY,\n\t\t\tstrategy: {\n\t\t\t\tname: 'walrusKnownDeployment',\n\t\t\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\t\t\tstakingObjectId: resolved.packageConfig.stakingPoolId,\n\t\t\t\tchain: resolved.chain,\n\t\t\t},\n\t\t\tautoMounted: true,\n\t\t};\n\treturn [snap, codegen, stateRegistry] as const;\n};\n\nexport interface WalCoinValue extends AccountFundingCoinValue {\n\treadonly symbol: 'WAL';\n\treadonly fullCoinType: `${string}::wal::WAL`;\n\treadonly decimals: 9;\n\treadonly source: 'walrus';\n}\n\n/** Resolve the local Walrus deployment's WAL coin as an account-funding\n *  coin ref. Accounts that need WAL should use:\n *\n *      funding: [{ coin: walCoin(localWalrus), amount }]\n *\n *  The funding strategy itself is contributed by the Walrus service\n *  once its local exchange exists. */\nexport const walCoin = (walrusMember: ResourceRef<'walrus', WalrusResolved>) => {\n\tconst coinRef = resource<CoinResourceId<'wal'>, WalCoinValue>(coinResourceId('wal'));\n\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: walrusMember,\n\t\trole: 'task',\n\t\tstart: (resolved): Effect.Effect<WalCoinValue, WalrusPluginError> =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tif (resolved.walCoinType === null) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'exchange',\n\t\t\t\t\t\t\t'walCoin(...) requires a local Walrus deployment with a WAL package.',\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tsymbol: 'WAL',\n\t\t\t\t\tfullCoinType: resolved.walCoinType as `${string}::wal::WAL`,\n\t\t\t\t\tdecimals: 9,\n\t\t\t\t\tsource: 'walrus',\n\t\t\t\t} satisfies WalCoinValue;\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// User-facing factories\n// ---------------------------------------------------------------------------\n\n/** Local-cluster shorthand. Known deployments are selected through\n *  `walrusFor(network).known(...)` so network choice stays explicit. */\nexport const walrus = (opts?: { readonly local?: WalrusLocalClusterOptions }) => {\n\treturn buildLocalPlugin(opts?.local ?? {});\n};\n\n/** Mode-narrowed factory namespace.\n *\n *  Usage:\n *      const network = { mode: 'local', chain: 'sui:localnet' } as const;\n *      walrusFor(network).local({...})    // OK\n *      walrusFor(network).known({...})    // type error: 'known' not in 'local' branch\n *\n *  Critically, the fork branch exposes ONLY `.known` — calling\n *  `.local` on a fork-mode network is a **compile error** at the\n *  call site (distilled-doc invariant 12 — type-level refusal).\n *  Runtime defense-in-depth: see `mode/fork-refusal.ts`. */\nexport const walrusFor = defineModeNamespace({\n\tlocal: {\n\t\tlocal: (opts: WalrusLocalClusterOptions = {}) => buildLocalPlugin(opts),\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n\tlive: {\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n\tfork: {\n\t\t// `.local` is intentionally absent — calling\n\t\t// `walrusFor(forkNetwork).local(...)` is a compile error.\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n});\n\n// ---------------------------------------------------------------------------\n// Re-exports for advanced callers\n// ---------------------------------------------------------------------------\n\nexport type { WalrusLocalClusterOptions } from './mode/local-cluster.ts';\nexport type { WalrusKnownDeploymentOptions, WalrusKnownNetwork } from './mode/known-deploy.ts';\nexport type { WalrusStorageNode } from './storage-nodes.ts';\nexport type { WalrusBindings, WalrusNodeBinding } from './codegen.ts';\nexport type { WalrusError, WalrusPluginError, WalrusConfigError, WalrusPhase } from './errors.ts';\n// `ForkIncompatibleError` is the cross-cutting mode-refusal shape owned\n// by `substrate/runtime/mode-errors.ts`; seal re-exports it\n// under its canonical name from its barrel, so walrus exposes the\n// SAME class under a walrus-namespaced alias to avoid a collision\n// when a downstream consumer imports both plugin barrels in the same\n// scope (STYLE_GUIDE §2 — one `_tag` literal per logical error type).\nexport type { ForkIncompatibleError as WalrusForkIncompatible } from './errors.ts';\nexport { WALRUS_ERROR_TAGS } from './errors.ts';\nexport {\n\twalCoinType,\n\twalFaucetStrategyKey,\n\ttype WalFaucetStrategy,\n\ttype WalFaucetRequest,\n} from './faucet-strategy.ts';\nexport {\n\tWALRUS_STATE_REGISTRY_KEY,\n\ttype WalrusStateEntry,\n\ttype WalrusLocalStateEntry,\n\ttype WalrusKnownStateEntry,\n} from './registry-publish.ts';\nexport { WALRUS_ROUTER_PORT } from './storage-nodes.ts';\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/walrus/index.ts"],"sourcesContent":["// Walrus plugin — barrel + factories.\n//\n// Architecture: Walrus is a service plugin that owns a local cluster\n// or describes a known deployment. The factory at this file folds the\n// four modes behind:\n//\n//   - `walrus(opts?)`           — local-cluster shorthand. No env\n//                                  defaulting; use `walrusFor(...)`\n//                                  for known deployments.\n//   - `walrusFor(network)`  — mode-narrowed factory namespace\n//                                  (architecture Tension 11). Returns\n//                                  `{ local: …, known: … }` narrowed\n//                                  to the network's mode. Crucially,\n//                                  the fork branch exposes ONLY\n//                                  `.known` — `.local` is a compile\n//                                  error on a fork-mode network.\n//\n// The plugin emits FOUR capability decls (per mode):\n//\n//   Local mode (full local cluster):\n//     1. `snapshotable`        — runtime/walrus/<name>/deploy/ subtree\n//                                 + storage-node managed containers.\n//     2. `codegenable`         — `walrus-network` bindings.\n//     3. `routable` × (N + 2)  — per-node + aggregator + publisher.\n//     4. `strategy-contributor:walrus-state-registry`  — local entry.\n//     5. `strategy-contributor:endpoint-registry`      — N+2 entries.\n//     6. `strategy-contributor:package-registry`       — `walrus.<name>`.\n//     7. `strategy-contributor:coinType:<WAL fullCoinType>`\n//                                                      — WAL faucet\n//                                                        strategy\n//                                                        (when exchange exists).\n//\n//   Known mode (read-only deployment):\n//     1. `snapshotable`        — identity-guard only; no subtrees.\n//     2. `codegenable`         — `walrus-network` bindings (mode='known').\n//     3. `strategy-contributor:walrus-state-registry` — known entry.\n//\n// Resource id: `'walrus'` (singular). The plugin's substrate-level\n// plugin key is the same string.\n\nimport { Effect, Path } from 'effect';\n\nimport { defineModeNamespace } from '../../api/mode-narrowed-factory.ts';\nimport { definePlugin, resource, type ResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { ContainerRuntime } from '../../contracts/container-runtime.ts';\nimport type { RoutableDecl } from '../../contracts/routable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport { ContainerRuntimeService } from '../../runtime/docker/service.ts';\nimport { IdentityContext, StackPathsService } from '../../substrate/runtime/paths.ts';\nimport { ArtifactPublisherService } from '../../substrate/runtime/artifact-publisher/index.ts';\nimport {\n\tderiveSubnetPrefix,\n\twithSubnetAddressing,\n} from '../../substrate/runtime/subnet-broker.ts';\nimport type { AcquireContext } from '../../substrate/plugin.ts';\nimport type { AccountFundingCoinValue } from '../account/index.ts';\nimport { coinResourceId, type CoinResourceId } from '../coin/index.ts';\nimport { suiResource, type SuiProbeKey } from '../sui/index.ts';\n\nimport { chainProbeFor } from '../../substrate/runtime/strategy-registry/index.ts';\n\nimport { makeCodegenable } from './codegen.ts';\nimport { walrusPluginKey } from './plugin-key.ts';\nimport { WALRUS_ERROR_TAGS, walrusPluginError, type WalrusPluginError } from './errors.ts';\nimport { walFaucetStrategyKey, type WalFaucetStrategy } from './faucet-strategy.ts';\nimport { bootWalrusService, type WalrusMode } from './service.ts';\nimport {\n\tresolveLocalClusterOptions,\n\ttype WalrusLocalClusterOptions,\n} from './mode/local-cluster.ts';\nimport {\n\tresolveKnownDeploymentOptions,\n\ttype WalrusKnownDeploymentOptions,\n} from './mode/known-deploy.ts';\nimport { makeSnapshotable, type WalrusSnapshotMode } from './snapshot.ts';\nimport { makeLocalRoutables } from './routable.ts';\nimport { WALRUS_STATE_REGISTRY_KEY, type WalrusStateEntry } from './registry-publish.ts';\nimport { buildWalrusNetworkName, type WalrusStorageNode } from './storage-nodes.ts';\n\n// ---------------------------------------------------------------------------\n// Resource — the resolved value all consumers read\n// ---------------------------------------------------------------------------\n\n/** The Walrus resolved value carried by the resource. */\nexport interface WalrusResolved {\n\treadonly mode: 'local' | 'known';\n\treadonly chain: string;\n\treadonly walrusPackageId: string | null;\n\treadonly walPackageId: string | null;\n\t/** SDK-ready `packageConfig` — structurally compatible with\n\t *  `@mysten/walrus`'s `WalrusPackageConfig`. */\n\treadonly packageConfig: {\n\t\treadonly systemObjectId: string;\n\t\treadonly stakingPoolId: string;\n\t\treadonly exchangeIds?: ReadonlyArray<string>;\n\t};\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\treadonly proxyUrl: string | null;\n\treadonly aggregatorUrl: string | null;\n\treadonly publisherUrl: string | null;\n\treadonly walFaucetStrategy: WalFaucetStrategy | null;\n\treadonly walCoinType: string | null;\n}\n\n/** Walrus plugin resource. */\nexport const walrusResource = resource<'walrus', WalrusResolved>('walrus');\nconst walrusErrorContributions = pluginErrorContributions(WALRUS_ERROR_TAGS);\n\nexport interface WalrusNetworkIdentity {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly walrusName: string;\n}\n\n/** Walrus deploy records storage-node listening IPs under this /24.\n *  Docker network create requests the matching subnet explicitly, with\n *  the prefix derived from the Walrus network identity so parallel\n *  stacks don't all claim the same Docker IPAM range. Walrus claims\n *  the `10.64.*` – `10.127.*` band; see substrate/runtime/subnet-broker.ts\n *  for the algorithm and band coordination with seal. */\nexport const deriveWalrusSubnetPrefix = (identity: WalrusNetworkIdentity): string =>\n\tderiveSubnetPrefix(`${identity.app}\\0${identity.stack}\\0${identity.walrusName}`, 64);\n\nconst withWalrusNetworkAddressing = (\n\truntime: ContainerRuntime,\n\twalrusNetworkName: string,\n\tsubnetPrefix: string,\n): ContainerRuntime => ({\n\t...runtime,\n\tensureNetwork: (spec) =>\n\t\truntime.ensureNetwork(\n\t\t\tspec.name === walrusNetworkName ? withSubnetAddressing(spec, subnetPrefix) : spec,\n\t\t),\n});\n\n// ---------------------------------------------------------------------------\n// Plugin construction (internal — used by walrus() + walrusFor())\n// ---------------------------------------------------------------------------\n\nconst buildLocalPlugin = (opts: WalrusLocalClusterOptions) => {\n\t// Synchronous factory-time validation (distilled-doc invariants\n\t// 11 — `nodeCount >= 1` + `shards >= nodeCount`).\n\tconst resolved = resolveLocalClusterOptions(opts);\n\n\tconst walrusKey = walrusPluginKey(resolved.name);\n\n\treturn definePlugin({\n\t\tid: walrusResource.id,\n\t\tdependsOn: [suiResource] as const,\n\t\trole: 'service',\n\t\tsection: 'service',\n\t\tpluginKey: walrusKey,\n\t\tstart: (deps) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst [sui] = deps;\n\n\t\t\t\t// Substrate-context primitives:\n\t\t\t\t//   - `ContainerRuntimeService` + `IdentityContext` arrive\n\t\t\t\t//     via the supervisor's plugin runtime context.\n\t\t\t\t//   - `ArtifactPublisher` is the substrate-level\n\t\t\t\t//     publisher (cache → verify → produce → register cycle).\n\t\t\t\t//   - `ChainProbe<SuiProbeKey>` is looked up via the\n\t\t\t\t//     StrategyRegistry under `chain-probe:<chainId>`;\n\t\t\t\t//     Sui registered itself there at its own acquire.\n\t\t\t\t//   - `StackPathsService` resolves the per-stack on-disk\n\t\t\t\t//     root so the deploy-output bind-mount source is a\n\t\t\t\t//     real path (not the `<runtime>/...` template).\n\t\t\t\tconst runtime = yield* ContainerRuntimeService;\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst stackPaths = yield* StackPathsService;\n\t\t\t\tconst path = yield* Path.Path;\n\t\t\t\tconst publisher = yield* ArtifactPublisherService;\n\t\t\t\tconst probe = yield* chainProbeFor<SuiProbeKey>(sui.chain);\n\n\t\t\t\t// Resolve the deploy-output bind-mount source from the\n\t\t\t\t// per-stack paths bundle. The deploy one-shot owns preparing\n\t\t\t\t// the directory immediately before its Docker bind mount.\n\t\t\t\tconst deployHostMountPath = path.join(\n\t\t\t\t\tstackPaths.stackRoot,\n\t\t\t\t\t'walrus',\n\t\t\t\t\tresolved.name,\n\t\t\t\t\t'deploy',\n\t\t\t\t);\n\n\t\t\t\t// Cross-container DNS: walrus containers (deploy one-shot\n\t\t\t\t// + N storage nodes) dial sui RPC + faucet via\n\t\t\t\t// `host.docker.internal`. The sui plugin binds brokered\n\t\t\t\t// host ports — no shared docker network needed.\n\t\t\t\t//\n\t\t\t\t// Architectural decision (B5): walrus owns its OWN docker\n\t\t\t\t// network for storage-node ↔ deploy connectivity; sui-side\n\t\t\t\t// hops go through the host gateway.\n\t\t\t\t// On Linux this requires Docker Desktop or the\n\t\t\t\t// `host.docker.internal:host-gateway` runtime hint (the\n\t\t\t\t// established devstack convention — see plugins/deepbook\n\t\t\t\t// which uses the same pattern).\n\t\t\t\tconst walrusNetworkName = buildWalrusNetworkName(\n\t\t\t\t\tidentity.app,\n\t\t\t\t\tidentity.stack,\n\t\t\t\t\tresolved.name,\n\t\t\t\t);\n\t\t\t\tconst walrusSubnetPrefix = deriveWalrusSubnetPrefix({\n\t\t\t\t\tapp: identity.app,\n\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\twalrusName: resolved.name,\n\t\t\t\t});\n\t\t\t\tconst walrusRuntime = withWalrusNetworkAddressing(\n\t\t\t\t\truntime,\n\t\t\t\t\twalrusNetworkName,\n\t\t\t\t\twalrusSubnetPrefix,\n\t\t\t\t);\n\t\t\t\tconst suiRpcUrlInNetwork = sui.hostGateway.rpcUrl;\n\t\t\t\t// sui-faucet v2 endpoint — `/v2/gas` is the supported path\n\t\t\t\t// on devnet-v1.71.0+ (the binary still answers `/v1/gas`\n\t\t\t\t// for backwards-compat but new code targets v2).\n\t\t\t\tconst suiFaucetUrlInNetwork = sui.hostGateway.faucetUrl;\n\t\t\t\tif (suiFaucetUrlInNetwork === null) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'deploy',\n\t\t\t\t\t\t\t'walrus local-cluster requires a Sui faucet URL for deploy funding.',\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst walrusFaucetUrlInNetwork = `${suiFaucetUrlInNetwork}/v2/gas`;\n\n\t\t\t\tconst mode: WalrusMode = { mode: 'local', opts: resolved };\n\t\t\t\tconst boot = yield* bootWalrusService(\n\t\t\t\t\t{\n\t\t\t\t\t\truntime: walrusRuntime,\n\t\t\t\t\t\tpublisher,\n\t\t\t\t\t\tprobe,\n\t\t\t\t\t\tsuiSdk: sui.sdk,\n\t\t\t\t\t\tsuiChainId: sui.chain,\n\t\t\t\t\t\tsuiRpcUrlInNetwork,\n\t\t\t\t\t\twalrusFaucetUrlInNetwork,\n\t\t\t\t\t\twaitForFundsReady: sui.waitForTransactionsReady.wait,\n\t\t\t\t\t\tapp: identity.app,\n\t\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\t\tsubnetPrefix: walrusSubnetPrefix,\n\t\t\t\t\t\twalrusNetworkName,\n\t\t\t\t\t\t// Walrus has no `sui-net` to attach to (sui binds\n\t\t\t\t\t\t// host ports). Reuse the walrus network so the\n\t\t\t\t\t\t// deploy one-shot + storage nodes land on a single\n\t\t\t\t\t\t// network and reach sui via `host.docker.internal`.\n\t\t\t\t\t\tsuiNetworkName: walrusNetworkName,\n\t\t\t\t\t\tdeployHostMountPath,\n\t\t\t\t\t\tstackRoot: stackPaths.stackRoot,\n\t\t\t\t\t},\n\t\t\t\t\tmode,\n\t\t\t\t);\n\n\t\t\t\tif (boot.mode !== 'local') {\n\t\t\t\t\t// Should be unreachable — dispatch is by mode. Defense.\n\t\t\t\t\treturn yield* Effect.die('walrus: mode mismatch in local plugin');\n\t\t\t\t}\n\n\t\t\t\tconst resolvedValue: WalrusResolved = {\n\t\t\t\t\tmode: 'local',\n\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\twalrusPackageId: boot.walrusPackageId,\n\t\t\t\t\twalPackageId: boot.walPackageId,\n\t\t\t\t\tpackageConfig: {\n\t\t\t\t\t\tsystemObjectId: boot.deploy.systemObject,\n\t\t\t\t\t\tstakingPoolId: boot.deploy.stakingObject,\n\t\t\t\t\t\texchangeIds: boot.exchangeObjectId ? [boot.exchangeObjectId] : undefined,\n\t\t\t\t\t},\n\t\t\t\t\tnodes: boot.nodes,\n\t\t\t\t\tproxyUrl: boot.proxyUrl,\n\t\t\t\t\taggregatorUrl: boot.aggregatorUrl,\n\t\t\t\t\tpublisherUrl: boot.publisherUrl,\n\t\t\t\t\twalFaucetStrategy: boot.walFaucetStrategy,\n\t\t\t\t\twalCoinType: boot.walCoinType,\n\t\t\t\t};\n\t\t\t\treturn resolvedValue;\n\t\t\t}),\n\t\tcapabilities: ({ value: resolvedValue, runtime: acquireCtx }) =>\n\t\t\tmakeLocalCapabilities({\n\t\t\t\tname: resolved.name,\n\t\t\t\tnodeCount: resolved.nodeCount,\n\t\t\t\tcontainerApiPort: resolved.containerApiPort,\n\t\t\t\tserviceKey: String(walrusKey),\n\t\t\t\tresolved: resolvedValue,\n\t\t\t\tacquireCtx,\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\nconst buildKnownPlugin = (opts: WalrusKnownDeploymentOptions) => {\n\t// Synchronous factory-time validation for required deployment ids.\n\tconst resolved = resolveKnownDeploymentOptions(opts);\n\n\treturn definePlugin({\n\t\tid: walrusResource.id,\n\t\tdependsOn: [suiResource] as const,\n\t\t// Known deployment is a pure value-producer — no containers,\n\t\t// no long-running children.\n\t\trole: 'task',\n\t\tsection: 'service',\n\t\tstart: () =>\n\t\t\tEffect.succeed({\n\t\t\t\tmode: 'known',\n\t\t\t\tchain: resolved.chain,\n\t\t\t\twalrusPackageId: null,\n\t\t\t\twalPackageId: null,\n\t\t\t\tpackageConfig: {\n\t\t\t\t\tsystemObjectId: resolved.systemObjectId,\n\t\t\t\t\tstakingPoolId: resolved.stakingPoolId,\n\t\t\t\t\texchangeIds: resolved.exchangeIds.length > 0 ? resolved.exchangeIds : undefined,\n\t\t\t\t},\n\t\t\t\tnodes: resolved.nodes,\n\t\t\t\tproxyUrl: resolved.proxyUrl,\n\t\t\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\t\t\tpublisherUrl: resolved.publisherUrl,\n\t\t\t\twalFaucetStrategy: null,\n\t\t\t\twalCoinType: null,\n\t\t\t} satisfies WalrusResolved),\n\t\tcapabilities: ({ value: resolvedValue, runtime: acquireCtx }) =>\n\t\t\tmakeKnownCapabilities({\n\t\t\t\tresolved: resolvedValue,\n\t\t\t\tacquireCtx,\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\nconst makeLocalCapabilities = (parts: {\n\treadonly name: string;\n\treadonly nodeCount: number;\n\treadonly containerApiPort: number;\n\treadonly serviceKey: string;\n\treadonly resolved: WalrusResolved;\n\treadonly acquireCtx: AcquireContext;\n}) => {\n\tconst { name, nodeCount, containerApiPort, serviceKey, resolved, acquireCtx } = parts;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\t'local' satisfies WalrusSnapshotMode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\tname,\n\t\tresolved.chain,\n\t\tnodeCount,\n\t);\n\tconst codegen: CodegenableDecl<'walrus-network'> = makeCodegenable({\n\t\tmode: 'local',\n\t\tchain: resolved.chain,\n\t\twalrusPackageId: resolved.walrusPackageId,\n\t\twalPackageId: resolved.walPackageId,\n\t\twalCoinType: resolved.walCoinType,\n\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\tstakingPoolId: resolved.packageConfig.stakingPoolId,\n\t\texchangeIds: resolved.packageConfig.exchangeIds ? [...resolved.packageConfig.exchangeIds] : [],\n\t\tproxyUrl: resolved.proxyUrl,\n\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\tpublisherUrl: resolved.publisherUrl,\n\t\tnodes: resolved.nodes,\n\t});\n\tconst stateRegistry: StrategyContributorDecl<\n\t\ttypeof WALRUS_STATE_REGISTRY_KEY,\n\t\t{ readonly noteName: string }\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: WALRUS_STATE_REGISTRY_KEY,\n\t\tstrategy: { noteName: name },\n\t\tautoMounted: true,\n\t};\n\tconst walFaucetContribution =\n\t\tresolved.walFaucetStrategy === null || resolved.walCoinType === null\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t{\n\t\t\t\t\t\tkind: 'strategy-contributor',\n\t\t\t\t\t\tcapabilityKey: walFaucetStrategyKey(resolved.walCoinType),\n\t\t\t\t\t\tstrategy: resolved.walFaucetStrategy,\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<\n\t\t\t\t\t\tReturnType<typeof walFaucetStrategyKey>,\n\t\t\t\t\t\tWalFaucetStrategy\n\t\t\t\t\t>,\n\t\t\t\t];\n\tconst routables = makeLocalRoutables({\n\t\tapp: acquireCtx.identity.app,\n\t\tstack: acquireCtx.identity.stack,\n\t\twalrusName: name,\n\t\tserviceKey,\n\t\tnodeCount,\n\t\tcontainerApiPort,\n\t});\n\treturn [\n\t\tsnap,\n\t\tcodegen,\n\t\tstateRegistry,\n\t\t...walFaucetContribution,\n\t\t...(routables as readonly RoutableDecl[]),\n\t] as const;\n};\n\nconst makeKnownCapabilities = (parts: {\n\treadonly resolved: WalrusResolved;\n\treadonly acquireCtx: AcquireContext;\n}) => {\n\tconst { resolved, acquireCtx } = parts;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\t'known' satisfies WalrusSnapshotMode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\t'walrusKnownDeployment',\n\t\tresolved.chain,\n\t);\n\tconst codegen: CodegenableDecl<'walrus-network'> = makeCodegenable({\n\t\tmode: 'known',\n\t\tchain: resolved.chain,\n\t\twalrusPackageId: resolved.walrusPackageId,\n\t\twalPackageId: resolved.walPackageId,\n\t\twalCoinType: resolved.walCoinType,\n\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\tstakingPoolId: resolved.packageConfig.stakingPoolId,\n\t\texchangeIds: resolved.packageConfig.exchangeIds ? [...resolved.packageConfig.exchangeIds] : [],\n\t\tproxyUrl: resolved.proxyUrl,\n\t\taggregatorUrl: resolved.aggregatorUrl,\n\t\tpublisherUrl: resolved.publisherUrl,\n\t\tnodes: resolved.nodes,\n\t});\n\tconst stateRegistry: StrategyContributorDecl<typeof WALRUS_STATE_REGISTRY_KEY, WalrusStateEntry> =\n\t\t{\n\t\t\tkind: 'strategy-contributor',\n\t\t\tcapabilityKey: WALRUS_STATE_REGISTRY_KEY,\n\t\t\tstrategy: {\n\t\t\t\tname: 'walrusKnownDeployment',\n\t\t\t\tsystemObjectId: resolved.packageConfig.systemObjectId,\n\t\t\t\tstakingObjectId: resolved.packageConfig.stakingPoolId,\n\t\t\t\tchain: resolved.chain,\n\t\t\t},\n\t\t\tautoMounted: true,\n\t\t};\n\treturn [snap, codegen, stateRegistry] as const;\n};\n\nexport interface WalCoinValue extends AccountFundingCoinValue {\n\treadonly symbol: 'WAL';\n\treadonly fullCoinType: `${string}::wal::WAL`;\n\treadonly decimals: 9;\n\treadonly source: 'walrus';\n}\n\n/** Resolve the local Walrus deployment's WAL coin as an account-funding\n *  coin ref. Accounts that need WAL should use:\n *\n *      funding: [{ coin: walCoin(localWalrus), amount }]\n *\n *  The funding strategy itself is contributed by the Walrus service\n *  once its local exchange exists. */\nexport const walCoin = (walrusMember: ResourceRef<'walrus', WalrusResolved>) => {\n\tconst coinRef = resource<CoinResourceId<'wal'>, WalCoinValue>(coinResourceId('wal'));\n\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: walrusMember,\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\tstart: (resolved): Effect.Effect<WalCoinValue, WalrusPluginError> =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tif (resolved.walCoinType === null) {\n\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'exchange',\n\t\t\t\t\t\t\t'walCoin(...) requires a local Walrus deployment with a WAL package.',\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tsymbol: 'WAL',\n\t\t\t\t\tfullCoinType: resolved.walCoinType as `${string}::wal::WAL`,\n\t\t\t\t\tdecimals: 9,\n\t\t\t\t\tsource: 'walrus',\n\t\t\t\t} satisfies WalCoinValue;\n\t\t\t}),\n\t\terrorContributions: walrusErrorContributions,\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// User-facing factories\n// ---------------------------------------------------------------------------\n\n/** Local-cluster shorthand. Known deployments are selected through\n *  `walrusFor(network).known(...)` so network choice stays explicit. */\nexport const walrus = (opts?: { readonly local?: WalrusLocalClusterOptions }) => {\n\treturn buildLocalPlugin(opts?.local ?? {});\n};\n\n/** Mode-narrowed factory namespace.\n *\n *  Usage:\n *      const network = { mode: 'local', chain: 'sui:localnet' } as const;\n *      walrusFor(network).local({...})    // OK\n *      walrusFor(network).known({...})    // type error: 'known' not in 'local' branch\n *\n *  Critically, the fork branch exposes ONLY `.known` — calling\n *  `.local` on a fork-mode network is a **compile error** at the\n *  call site (distilled-doc invariant 12 — type-level refusal). */\nexport const walrusFor = defineModeNamespace({\n\tlocal: {\n\t\tlocal: (opts: WalrusLocalClusterOptions = {}) => buildLocalPlugin(opts),\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n\tlive: {\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n\tfork: {\n\t\t// `.local` is intentionally absent — calling\n\t\t// `walrusFor(forkNetwork).local(...)` is a compile error.\n\t\tknown: (opts: WalrusKnownDeploymentOptions) => buildKnownPlugin(opts),\n\t},\n});\n\n// ---------------------------------------------------------------------------\n// Re-exports for advanced callers\n// ---------------------------------------------------------------------------\n\nexport type { WalrusLocalClusterOptions } from './mode/local-cluster.ts';\nexport type { WalrusKnownDeploymentOptions, WalrusKnownNetwork } from './mode/known-deploy.ts';\nexport type { WalrusStorageNode } from './storage-nodes.ts';\nexport type { WalrusBindings, WalrusNodeBinding } from './codegen.ts';\nexport type { WalrusError, WalrusPluginError, WalrusConfigError, WalrusPhase } from './errors.ts';\nexport { WALRUS_ERROR_TAGS } from './errors.ts';\nexport {\n\twalCoinType,\n\twalFaucetStrategyKey,\n\ttype WalFaucetStrategy,\n\ttype WalFaucetRequest,\n} from './faucet-strategy.ts';\nexport {\n\tWALRUS_STATE_REGISTRY_KEY,\n\ttype WalrusStateEntry,\n\ttype WalrusLocalStateEntry,\n\ttype WalrusKnownStateEntry,\n} from './registry-publish.ts';\nexport { WALRUS_ROUTER_PORT } from './storage-nodes.ts';\nexport { WalrusSpans } from './spans.ts';\n"],"mappings":"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"}

package/dist/plugins/walrus/mode/known-deploy.mjs

@@ -45,7 +45,6 @@ const resolveKnownDeploymentOptions = (opts) => {
 	const aggregatorUrl = opts.aggregatorUrl ?? reg?.aggregatorUrl ?? null;
 	const publisherUrl = opts.publisherUrl ?? reg?.publisherUrl ?? null;
 	const proxyUrl = opts.proxyUrl ?? reg?.proxyUrl ?? aggregatorUrl ?? publisherUrl ?? null;
-	const allUrlsPresent = aggregatorUrl !== null && publisherUrl !== null && proxyUrl !== null;
 	return {
 		mode: "known",
 		chain: reg?.chain ?? "sui:custom",
@@ -53,9 +52,9 @@ const resolveKnownDeploymentOptions = (opts) => {
 		stakingPoolId,
 		exchangeIds: opts.exchangeIds ?? reg?.exchangeIds ?? [],
 		nodes,
-		proxyUrl: allUrlsPresent ? proxyUrl : null,
-		aggregatorUrl: allUrlsPresent ? aggregatorUrl : null,
-		publisherUrl: allUrlsPresent ? publisherUrl : null
+		proxyUrl,
+		aggregatorUrl,
+		publisherUrl
 	};
 };
 /** "Boot" the known deployment. Purely synchronous projection inside
@@ -63,7 +62,10 @@ const resolveKnownDeploymentOptions = (opts) => {
 *  uniformity with the local-cluster boot signature. */
 const bootKnownDeployment = (opts) => Effect.try({
 	try: () => resolveKnownDeploymentOptions(opts),
-	catch: (err) => err
+	catch: (err) => {
+		if (typeof err === "object" && err !== null && "_tag" in err && err._tag === "WalrusConfigError") return err;
+		return walrusConfigError("unknown", `walrusKnownDeployment: unexpected non-typed throw inside resolveKnownDeploymentOptions: ${err instanceof Error ? err.message : String(err)}`, void 0, err);
+	}
 });
 //#endregion
 export { bootKnownDeployment, resolveKnownDeploymentOptions };

package/dist/plugins/walrus/mode/known-deploy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"known-deploy.mjs","names":[],"sources":["../../../../src/plugins/walrus/mode/known-deploy.ts"],"sourcesContent":["// Walrus mode — known deployment (testnet / mainnet / *-fork via\n// upstream translation).\n//\n// Distilled-doc reference (06-walrus.md §\"Lifecycle: Startup —\n// known deployment\"). Purely synchronous body — no ordered phases.\n// The factory validates required deployment fields and returns a\n// resolved value whose tags are eager `Layer.succeed(...)` constants.\n//\n// Distilled-doc invariants honored:\n//   - 15: `WalrusProxyTag` only when ALL three URLs (proxy,\n//         aggregator, publisher) are present. Encoded as\n//         `proxyUrl / aggregatorUrl / publisherUrl: string | null`\n//         in the resolved shape; the plugin's projection step\n//         hides the proxy tag when any is missing.\n//   - 16: throw synchronously when `nodes` is missing for a\n//         registered network. Testnet has 100+ nodes that the\n//         `@mysten/walrus` SDK fetches dynamically; pinning them\n//         statically would be misleading.\n\nimport { Effect, type Scope } from 'effect';\n\nimport { expectNonEmptyString } from '../../../substrate/runtime/config-validation.ts';\nimport { walrusConfigError, type WalrusConfigError } from '../errors.ts';\nimport type { WalrusStorageNode } from '../storage-nodes.ts';\n\n/** Known networks supported by the registry lookup. */\nexport type WalrusKnownNetwork = 'testnet' | 'mainnet' | 'devnet';\n\n/** Options for the known-deployment mode. */\nexport interface WalrusKnownDeploymentOptions {\n\t/** Network shortcut — looks up per-field defaults from a registry\n\t *  baked into this package. */\n\treadonly network?: WalrusKnownNetwork;\n\t/** Per-field overrides. Required when `network` is omitted. */\n\treadonly systemObjectId?: string;\n\treadonly stakingPoolId?: string;\n\treadonly exchangeIds?: ReadonlyArray<string>;\n\t/** Explicit storage-node committee. Required (throws if missing\n\t *  even when `network` is set — distilled-doc invariant 16). */\n\treadonly nodes?: ReadonlyArray<WalrusStorageNode>;\n\treadonly aggregatorUrl?: string;\n\treadonly publisherUrl?: string;\n\treadonly proxyUrl?: string;\n}\n\n/** Resolved known-deployment boot artifacts. */\nexport interface KnownDeploymentBootResult {\n\treadonly mode: 'known';\n\treadonly chain: string;\n\treadonly systemObjectId: string;\n\treadonly stakingPoolId: string;\n\treadonly exchangeIds: ReadonlyArray<string>;\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\t/** Null when any of the three URLs are missing — distilled-doc\n\t *  invariant 15. */\n\treadonly proxyUrl: string | null;\n\treadonly aggregatorUrl: string | null;\n\treadonly publisherUrl: string | null;\n}\n\n/** Known-deployment registry — baked-in record per network. The\n *  values here mirror v3's `knownDeployments.walrus.{testnet,\n *  mainnet}` entries. Devnet has no canonical record today. */\nconst KNOWN_DEPLOYMENT_REGISTRY: Readonly<\n\tRecord<\n\t\tWalrusKnownNetwork,\n\t\t{\n\t\t\treadonly chain: string;\n\t\t\treadonly systemObjectId?: string;\n\t\t\treadonly stakingPoolId?: string;\n\t\t\treadonly exchangeIds?: ReadonlyArray<string>;\n\t\t\treadonly aggregatorUrl?: string;\n\t\t\treadonly publisherUrl?: string;\n\t\t\treadonly proxyUrl?: string;\n\t\t}\n\t>\n> = {\n\ttestnet: {\n\t\tchain: 'sui:testnet',\n\t\t// Real ids must be supplied via the explicit options form\n\t\t// (`walrusFor(testnet).known({ systemObjectId, stakingPoolId, ... })`).\n\t\t// The known-deployment lookup table only canonicalises the URLs;\n\t\t// the on-chain ids are network-specific and live outside this\n\t\t// package.\n\t\tsystemObjectId: undefined,\n\t\tstakingPoolId: undefined,\n\t\texchangeIds: [],\n\t\taggregatorUrl: 'https://aggregator.walrus-testnet.walrus.space',\n\t\tpublisherUrl: 'https://publisher.walrus-testnet.walrus.space',\n\t\tproxyUrl: 'https://aggregator.walrus-testnet.walrus.space',\n\t},\n\tmainnet: {\n\t\tchain: 'sui:mainnet',\n\t\tsystemObjectId: undefined,\n\t\tstakingPoolId: undefined,\n\t\texchangeIds: [],\n\t\taggregatorUrl: 'https://aggregator.walrus.space',\n\t\tpublisherUrl: 'https://publisher.walrus.space',\n\t\tproxyUrl: 'https://aggregator.walrus.space',\n\t},\n\tdevnet: {\n\t\tchain: 'sui:devnet',\n\t},\n};\n\n/** Synchronous factory-time validation + projection. Throws (NOT\n *  Effect-fail) on missing required fields so misconfiguration trips\n *  at the `defineDevstack` call site rather than at deferred\n *  Layer.build time. Distilled-doc invariants 14 + 16. */\nexport const resolveKnownDeploymentOptions = (\n\topts: WalrusKnownDeploymentOptions,\n): KnownDeploymentBootResult => {\n\tconst reg = opts.network ? KNOWN_DEPLOYMENT_REGISTRY[opts.network] : undefined;\n\n\tconst systemObjectId = expectNonEmptyString(opts.systemObjectId ?? reg?.systemObjectId, {\n\t\tfield: 'systemObjectId',\n\t\tmkError: ({ field }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusKnownDeployment: 'systemObjectId' is required (pass it explicitly, or pass network with a registered entry)`,\n\t\t\t),\n\t});\n\n\tconst stakingPoolId = expectNonEmptyString(opts.stakingPoolId ?? reg?.stakingPoolId, {\n\t\tfield: 'stakingPoolId',\n\t\tmkError: ({ field }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusKnownDeployment: 'stakingPoolId' is required (pass it explicitly, or pass network with a registered entry)`,\n\t\t\t),\n\t});\n\n\tconst nodes = opts.nodes;\n\tif (!nodes) {\n\t\t// Distilled-doc invariant 16: even when `network` is set, the\n\t\t// nodes must be explicit. Testnet has 100+ nodes the SDK\n\t\t// fetches dynamically; pinning would be misleading.\n\t\tthrow walrusConfigError(\n\t\t\t'nodes',\n\t\t\t`walrusKnownDeployment: explicit 'nodes' committee is required — ` +\n\t\t\t\t`Walrus ${opts.network ?? 'custom'} has nodes fetched dynamically by the SDK`,\n\t\t\t`pass an empty array if you accept the SDK-driven committee lookup, ` +\n\t\t\t\t`or use walrus()/walrusFor(network).local({...}) for a local self-hosted cluster`,\n\t\t);\n\t}\n\n\tconst aggregatorUrl = opts.aggregatorUrl ?? reg?.aggregatorUrl ?? null;\n\tconst publisherUrl = opts.publisherUrl ?? reg?.publisherUrl ?? null;\n\tconst proxyUrl = opts.proxyUrl ?? reg?.proxyUrl ?? aggregatorUrl ?? publisherUrl ?? null;\n\n\t// Invariant 15: surface null when any URL is missing so the\n\t// plugin's projection can conditionally publish the proxy tag.\n\tconst allUrlsPresent = aggregatorUrl !== null && publisherUrl !== null && proxyUrl !== null;\n\n\treturn {\n\t\tmode: 'known' as const,\n\t\tchain: reg?.chain ?? 'sui:custom',\n\t\tsystemObjectId,\n\t\tstakingPoolId,\n\t\texchangeIds: opts.exchangeIds ?? reg?.exchangeIds ?? [],\n\t\tnodes,\n\t\tproxyUrl: allUrlsPresent ? proxyUrl : null,\n\t\taggregatorUrl: allUrlsPresent ? aggregatorUrl : null,\n\t\tpublisherUrl: allUrlsPresent ? publisherUrl : null,\n\t};\n};\n\n/** \"Boot\" the known deployment. Purely synchronous projection inside\n *  Effect.gen — no I/O, no Scope work. Surfaces as Effect for\n *  uniformity with the local-cluster boot signature. */\nexport const bootKnownDeployment = (\n\topts: WalrusKnownDeploymentOptions,\n): Effect.Effect<KnownDeploymentBootResult, WalrusConfigError, Scope.Scope> =>\n\tEffect.try({\n\t\ttry: () => resolveKnownDeploymentOptions(opts),\n\t\t// `resolveKnownDeploymentOptions` throws our typed config error\n\t\t// shape; map straight back into the typed channel.\n\t\tcatch: (err) => err as WalrusConfigError,\n\t});\n"],"mappings":";;;;;;;AA+DA,MAAM,4BAaF;CACH,SAAS;EACR,OAAO;EAMP,gBAAgB,KAAA;EAChB,eAAe,KAAA;EACf,aAAa,EAAE;EACf,eAAe;EACf,cAAc;EACd,UAAU;EACV;CACD,SAAS;EACR,OAAO;EACP,gBAAgB,KAAA;EAChB,eAAe,KAAA;EACf,aAAa,EAAE;EACf,eAAe;EACf,cAAc;EACd,UAAU;EACV;CACD,QAAQ,EACP,OAAO,cACP;CACD;;;;;AAMD,MAAa,iCACZ,SAC+B;CAC/B,MAAM,MAAM,KAAK,UAAU,0BAA0B,KAAK,WAAW,KAAA;CAErE,MAAM,iBAAiB,qBAAqB,KAAK,kBAAkB,KAAK,gBAAgB;EACvF,OAAO;EACP,UAAU,EAAE,YACX,kBACC,OACA,oHACA;EACF,CAAC;CAEF,MAAM,gBAAgB,qBAAqB,KAAK,iBAAiB,KAAK,eAAe;EACpF,OAAO;EACP,UAAU,EAAE,YACX,kBACC,OACA,mHACA;EACF,CAAC;CAEF,MAAM,QAAQ,KAAK;AACnB,KAAI,CAAC,MAIJ,OAAM,kBACL,SACA,0EACW,KAAK,WAAW,SAAS,4CACpC,qJAEA;CAGF,MAAM,gBAAgB,KAAK,iBAAiB,KAAK,iBAAiB;CAClE,MAAM,eAAe,KAAK,gBAAgB,KAAK,gBAAgB;CAC/D,MAAM,WAAW,KAAK,YAAY,KAAK,YAAY,iBAAiB,gBAAgB;CAIpF,MAAM,iBAAiB,kBAAkB,QAAQ,iBAAiB,QAAQ,aAAa;AAEvF,QAAO;EACN,MAAM;EACN,OAAO,KAAK,SAAS;EACrB;EACA;EACA,aAAa,KAAK,eAAe,KAAK,eAAe,EAAE;EACvD;EACA,UAAU,iBAAiB,WAAW;EACtC,eAAe,iBAAiB,gBAAgB;EAChD,cAAc,iBAAiB,eAAe;EAC9C;;;;;AAMF,MAAa,uBACZ,SAEA,OAAO,IAAI;CACV,WAAW,8BAA8B,KAAK;CAG9C,QAAQ,QAAQ;CAChB,CAAC"}
+{"version":3,"file":"known-deploy.mjs","names":[],"sources":["../../../../src/plugins/walrus/mode/known-deploy.ts"],"sourcesContent":["// Walrus mode — known deployment (testnet / mainnet / *-fork via\n// upstream translation).\n//\n// Distilled-doc reference (06-walrus.md §\"Lifecycle: Startup —\n// known deployment\"). Purely synchronous body — no ordered phases.\n// The factory validates required deployment fields and returns a\n// resolved value whose tags are eager `Layer.succeed(...)` constants.\n//\n// Distilled-doc invariants honored:\n//   - 15: each of `proxyUrl / aggregatorUrl / publisherUrl` surfaces\n//         INDEPENDENTLY. Encoded as `string | null` in the resolved\n//         shape — a given field is null only when THAT specific URL\n//         is unresolved (registry default + explicit override both\n//         absent). The plugin's projection step publishes each tag\n//         when its own URL is present; a missing publisher URL no\n//         longer suppresses an available proxy/aggregator URL. (The\n//         earlier all-or-nothing gate that nullified all three when\n//         any single URL was missing was removed.)\n//   - 16: throw synchronously when `nodes` is missing for a\n//         registered network. Testnet has 100+ nodes that the\n//         `@mysten/walrus` SDK fetches dynamically; pinning them\n//         statically would be misleading.\n\nimport { Effect, type Scope } from 'effect';\n\nimport { expectNonEmptyString } from '../../../substrate/runtime/config-validation.ts';\nimport { walrusConfigError, type WalrusConfigError } from '../errors.ts';\nimport type { WalrusStorageNode } from '../storage-nodes.ts';\n\n/** Known networks supported by the registry lookup. */\nexport type WalrusKnownNetwork = 'testnet' | 'mainnet' | 'devnet';\n\n/** Options for the known-deployment mode. */\nexport interface WalrusKnownDeploymentOptions {\n\t/** Network shortcut — looks up per-field defaults from a registry\n\t *  baked into this package. */\n\treadonly network?: WalrusKnownNetwork;\n\t/** Per-field overrides. Required when `network` is omitted. */\n\treadonly systemObjectId?: string;\n\treadonly stakingPoolId?: string;\n\treadonly exchangeIds?: ReadonlyArray<string>;\n\t/** Explicit storage-node committee. Required (throws if missing\n\t *  even when `network` is set — distilled-doc invariant 16). */\n\treadonly nodes?: ReadonlyArray<WalrusStorageNode>;\n\treadonly aggregatorUrl?: string;\n\treadonly publisherUrl?: string;\n\treadonly proxyUrl?: string;\n}\n\n/** Resolved known-deployment boot artifacts. */\nexport interface KnownDeploymentBootResult {\n\treadonly mode: 'known';\n\treadonly chain: string;\n\treadonly systemObjectId: string;\n\treadonly stakingPoolId: string;\n\treadonly exchangeIds: ReadonlyArray<string>;\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\t/** Null only when the proxy URL itself is unresolved (no explicit\n\t *  `proxyUrl` override and no registry/aggregator/publisher\n\t *  fallback). Surfaces independently of `aggregatorUrl` /\n\t *  `publisherUrl` — distilled-doc invariant 15. */\n\treadonly proxyUrl: string | null;\n\treadonly aggregatorUrl: string | null;\n\treadonly publisherUrl: string | null;\n}\n\n/** Known-deployment registry — baked-in record per network. The\n *  values here mirror v3's `knownDeployments.walrus.{testnet,\n *  mainnet}` entries. Devnet has no canonical record today. */\nconst KNOWN_DEPLOYMENT_REGISTRY: Readonly<\n\tRecord<\n\t\tWalrusKnownNetwork,\n\t\t{\n\t\t\treadonly chain: string;\n\t\t\treadonly systemObjectId?: string;\n\t\t\treadonly stakingPoolId?: string;\n\t\t\treadonly exchangeIds?: ReadonlyArray<string>;\n\t\t\treadonly aggregatorUrl?: string;\n\t\t\treadonly publisherUrl?: string;\n\t\t\treadonly proxyUrl?: string;\n\t\t}\n\t>\n> = {\n\ttestnet: {\n\t\tchain: 'sui:testnet',\n\t\t// Real ids must be supplied via the explicit options form\n\t\t// (`walrusFor(testnet).known({ systemObjectId, stakingPoolId, ... })`).\n\t\t// The known-deployment lookup table only canonicalises the URLs;\n\t\t// the on-chain ids are network-specific and live outside this\n\t\t// package.\n\t\tsystemObjectId: undefined,\n\t\tstakingPoolId: undefined,\n\t\texchangeIds: [],\n\t\taggregatorUrl: 'https://aggregator.walrus-testnet.walrus.space',\n\t\tpublisherUrl: 'https://publisher.walrus-testnet.walrus.space',\n\t\tproxyUrl: 'https://aggregator.walrus-testnet.walrus.space',\n\t},\n\tmainnet: {\n\t\tchain: 'sui:mainnet',\n\t\tsystemObjectId: undefined,\n\t\tstakingPoolId: undefined,\n\t\texchangeIds: [],\n\t\taggregatorUrl: 'https://aggregator.walrus.space',\n\t\tpublisherUrl: 'https://publisher.walrus.space',\n\t\tproxyUrl: 'https://aggregator.walrus.space',\n\t},\n\tdevnet: {\n\t\tchain: 'sui:devnet',\n\t},\n};\n\n/** Synchronous factory-time validation + projection. Throws (NOT\n *  Effect-fail) on missing required fields so misconfiguration trips\n *  at the `defineDevstack` call site rather than at deferred\n *  Layer.build time. Distilled-doc invariants 14 + 16. */\nexport const resolveKnownDeploymentOptions = (\n\topts: WalrusKnownDeploymentOptions,\n): KnownDeploymentBootResult => {\n\tconst reg = opts.network ? KNOWN_DEPLOYMENT_REGISTRY[opts.network] : undefined;\n\n\tconst systemObjectId = expectNonEmptyString(opts.systemObjectId ?? reg?.systemObjectId, {\n\t\tfield: 'systemObjectId',\n\t\tmkError: ({ field }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusKnownDeployment: 'systemObjectId' is required (pass it explicitly, or pass network with a registered entry)`,\n\t\t\t),\n\t});\n\n\tconst stakingPoolId = expectNonEmptyString(opts.stakingPoolId ?? reg?.stakingPoolId, {\n\t\tfield: 'stakingPoolId',\n\t\tmkError: ({ field }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusKnownDeployment: 'stakingPoolId' is required (pass it explicitly, or pass network with a registered entry)`,\n\t\t\t),\n\t});\n\n\tconst nodes = opts.nodes;\n\tif (!nodes) {\n\t\t// Distilled-doc invariant 16: even when `network` is set, the\n\t\t// nodes must be explicit. Testnet has 100+ nodes the SDK\n\t\t// fetches dynamically; pinning would be misleading.\n\t\tthrow walrusConfigError(\n\t\t\t'nodes',\n\t\t\t`walrusKnownDeployment: explicit 'nodes' committee is required — ` +\n\t\t\t\t`Walrus ${opts.network ?? 'custom'} has nodes fetched dynamically by the SDK`,\n\t\t\t`pass an empty array if you accept the SDK-driven committee lookup, ` +\n\t\t\t\t`or use walrus()/walrusFor(network).local({...}) for a local self-hosted cluster`,\n\t\t);\n\t}\n\n\tconst aggregatorUrl = opts.aggregatorUrl ?? reg?.aggregatorUrl ?? null;\n\tconst publisherUrl = opts.publisherUrl ?? reg?.publisherUrl ?? null;\n\tconst proxyUrl = opts.proxyUrl ?? reg?.proxyUrl ?? aggregatorUrl ?? publisherUrl ?? null;\n\n\t// Invariant 15: surface null per individual URL when missing so the\n\t// plugin's projection can conditionally publish each tag. Previously\n\t// any single missing URL nullified all three, dropping user-supplied\n\t// values for the URLs they did provide.\n\treturn {\n\t\tmode: 'known' as const,\n\t\tchain: reg?.chain ?? 'sui:custom',\n\t\tsystemObjectId,\n\t\tstakingPoolId,\n\t\texchangeIds: opts.exchangeIds ?? reg?.exchangeIds ?? [],\n\t\tnodes,\n\t\tproxyUrl,\n\t\taggregatorUrl,\n\t\tpublisherUrl,\n\t};\n};\n\n/** \"Boot\" the known deployment. Purely synchronous projection inside\n *  Effect.gen — no I/O, no Scope work. Surfaces as Effect for\n *  uniformity with the local-cluster boot signature. */\nexport const bootKnownDeployment = (\n\topts: WalrusKnownDeploymentOptions,\n): Effect.Effect<KnownDeploymentBootResult, WalrusConfigError, Scope.Scope> =>\n\tEffect.try({\n\t\ttry: () => resolveKnownDeploymentOptions(opts),\n\t\t// `resolveKnownDeploymentOptions` throws our typed config error\n\t\t// shape. STYLE_GUIDE §2 forbids bare error casts; runtime-guard\n\t\t// the `_tag` so an unexpected synchronous throw (e.g. a future\n\t\t// helper that throws a stock `TypeError`) is wrapped instead of\n\t\t// silently mis-tagged as `WalrusConfigError`.\n\t\tcatch: (err): WalrusConfigError => {\n\t\t\tif (\n\t\t\t\ttypeof err === 'object' &&\n\t\t\t\terr !== null &&\n\t\t\t\t'_tag' in err &&\n\t\t\t\t(err as { readonly _tag?: unknown })._tag === 'WalrusConfigError'\n\t\t\t) {\n\t\t\t\treturn err as WalrusConfigError;\n\t\t\t}\n\t\t\treturn walrusConfigError(\n\t\t\t\t'unknown',\n\t\t\t\t`walrusKnownDeployment: unexpected non-typed throw inside resolveKnownDeploymentOptions: ${\n\t\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t\t}`,\n\t\t\t\tundefined,\n\t\t\t\terr,\n\t\t\t);\n\t\t},\n\t});\n"],"mappings":";;;;;;;AAqEA,MAAM,4BAaF;CACH,SAAS;EACR,OAAO;EAMP,gBAAgB,KAAA;EAChB,eAAe,KAAA;EACf,aAAa,EAAE;EACf,eAAe;EACf,cAAc;EACd,UAAU;EACV;CACD,SAAS;EACR,OAAO;EACP,gBAAgB,KAAA;EAChB,eAAe,KAAA;EACf,aAAa,EAAE;EACf,eAAe;EACf,cAAc;EACd,UAAU;EACV;CACD,QAAQ,EACP,OAAO,cACP;CACD;;;;;AAMD,MAAa,iCACZ,SAC+B;CAC/B,MAAM,MAAM,KAAK,UAAU,0BAA0B,KAAK,WAAW,KAAA;CAErE,MAAM,iBAAiB,qBAAqB,KAAK,kBAAkB,KAAK,gBAAgB;EACvF,OAAO;EACP,UAAU,EAAE,YACX,kBACC,OACA,oHACA;EACF,CAAC;CAEF,MAAM,gBAAgB,qBAAqB,KAAK,iBAAiB,KAAK,eAAe;EACpF,OAAO;EACP,UAAU,EAAE,YACX,kBACC,OACA,mHACA;EACF,CAAC;CAEF,MAAM,QAAQ,KAAK;AACnB,KAAI,CAAC,MAIJ,OAAM,kBACL,SACA,0EACW,KAAK,WAAW,SAAS,4CACpC,qJAEA;CAGF,MAAM,gBAAgB,KAAK,iBAAiB,KAAK,iBAAiB;CAClE,MAAM,eAAe,KAAK,gBAAgB,KAAK,gBAAgB;CAC/D,MAAM,WAAW,KAAK,YAAY,KAAK,YAAY,iBAAiB,gBAAgB;AAMpF,QAAO;EACN,MAAM;EACN,OAAO,KAAK,SAAS;EACrB;EACA;EACA,aAAa,KAAK,eAAe,KAAK,eAAe,EAAE;EACvD;EACA;EACA;EACA;EACA;;;;;AAMF,MAAa,uBACZ,SAEA,OAAO,IAAI;CACV,WAAW,8BAA8B,KAAK;CAM9C,QAAQ,QAA2B;AAClC,MACC,OAAO,QAAQ,YACf,QAAQ,QACR,UAAU,OACT,IAAoC,SAAS,oBAE9C,QAAO;AAER,SAAO,kBACN,WACA,2FACC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,IAEjD,KAAA,GACA,IACA;;CAEF,CAAC"}

package/dist/plugins/walrus/mode/local-cluster.mjs

@@ -1,8 +1,11 @@
 import { contentHash } from "../../../substrate/brand.mjs";
-import { expectPositiveInteger } from "../../../substrate/runtime/config-validation.mjs";
+import { SpanAttr } from "../../../substrate/runtime/observability/spans.mjs";
 import { setCurrentPluginPhase } from "../../../substrate/runtime/current-plugin.mjs";
+import { expectPositiveInteger } from "../../../substrate/runtime/config-validation.mjs";
 import { walrusConfigError, walrusPluginError } from "../errors.mjs";
+import { WalrusSpans } from "../spans.mjs";
 import { computePublicHostname, startStorageNodes } from "../storage-nodes.mjs";
+import "../routable.mjs";
 import { resolveWalExchange } from "../wal-swap.mjs";
 import { makeWalFaucetStrategy, resolveWalCoinType, walPackageIdFromCoinType } from "../faucet-strategy.mjs";
 import { deployWalrusContracts } from "../deploy.mjs";
@@ -19,6 +22,7 @@ const resolveLocalClusterOptions = (opts) => {
 		mkError: ({ field, message, hint }) => walrusConfigError(field, `walrusLocalCluster: nodeCount must be >= 1 (got ${String(opts.nodeCount ?? 1)})`, hint ?? message),
 		hint: "set nodeCount to a positive integer (default 1)"
 	});
+	if (nodeCount > 8) throw walrusConfigError("nodeCount", `walrusLocalCluster: nodeCount (${nodeCount}) exceeds the maximum 8 pre-declared Traefik entrypoints (walrus-node-0..7).`, `reduce nodeCount or raise WALRUS_MAX_NODE_COUNT in plugins/walrus/routable.ts`);
 	const shards = expectPositiveInteger(opts.shards ?? 100, {
 		field: "shards",
 		mkError: ({ field, message, hint }) => walrusConfigError(field, `walrusLocalCluster: shards must be a positive integer (got ${String(opts.shards ?? 100)})`, hint ?? message),
@@ -63,7 +67,11 @@ const bootLocalCluster = (deps, opts) => Effect.gen(function* () {
 	yield* setCurrentPluginPhase(`resolving Walrus image ${opts.version}`);
 	const walrusImage = yield* resolveCargoImage(deps.runtime, {
 		walrusRef: opts.version,
-		suiVersion: opts.suiVersion
+		suiVersion: opts.suiVersion,
+		owner: {
+			app: deps.app,
+			stack: deps.stack
+		}
 	});
 	yield* setCurrentPluginPhase(`ensuring Walrus network ${deps.walrusNetworkName}`);
 	yield* deps.runtime.ensureNetwork({
@@ -79,6 +87,7 @@ const bootLocalCluster = (deps, opts) => Effect.gen(function* () {
 		chainId: deps.suiChainId,
 		contentHash: contentHash(`walrus|${opts.version}|${opts.suiVersion}|${opts.nodeCount}|${opts.shards}|${opts.epochDuration}`),
 		outputDirHostPath: deps.deployHostMountPath,
+		stackRoot: deps.stackRoot,
 		suiRpcUrlInNetwork: deps.suiRpcUrlInNetwork,
 		walrusFaucetUrlInNetwork: deps.walrusFaucetUrlInNetwork,
 		waitForFundsReady: deps.waitForFundsReady,
@@ -97,18 +106,28 @@ const bootLocalCluster = (deps, opts) => Effect.gen(function* () {
 		state.stakingObject,
 		state.exchangeObject ?? "no-exchange"
 	].join("|");
+	const nodeImageScope = state.walrusPackageId.replace(/^0x/, "").slice(0, 12);
+	const nodeImages = yield* Effect.forEach(Array.from({ length: opts.nodeCount }, (_, i) => i), (i) => resolveCargoImage(deps.runtime, {
+		walrusRef: opts.version,
+		suiVersion: opts.suiVersion,
+		owner: {
+			app: deps.app,
+			stack: deps.stack
+		}
+	}, `${walrusImage.tag}-${nodeImageScope}-node-${i}`));
 	yield* setCurrentPluginPhase(`starting ${opts.nodeCount} Walrus storage node${opts.nodeCount === 1 ? "" : "s"}`);
 	const { nodes } = yield* startStorageNodes(deps.runtime, {
 		app: deps.app,
 		stack: deps.stack,
 		walrusName: opts.name,
-		image: walrusImage,
+		images: nodeImages,
 		nodeCount: opts.nodeCount,
 		subnetPrefix: deps.subnetPrefix,
 		containerApiPort: opts.containerApiPort,
 		walrusNetworkName: deps.walrusNetworkName,
 		suiNetworkName: deps.suiNetworkName,
 		deployHostMountPath: deps.deployHostMountPath,
+		stackRoot: deps.stackRoot,
 		deployConfigHash,
 		readyTimeoutMs: opts.readyTimeoutMs
 	});
@@ -142,10 +161,10 @@ const bootLocalCluster = (deps, opts) => Effect.gen(function* () {
 		walCoinType: resolvedWalCoinType
 	};
 }).pipe(Effect.withSpan("devstack.plugin.walrus.localCluster.boot", { attributes: {
-	"devstack.plugin": "walrus",
-	"walrus.name": opts.name,
-	"walrus.nodeCount": opts.nodeCount,
-	"walrus.shards": opts.shards
+	[SpanAttr.plugin]: "walrus",
+	[WalrusSpans.name]: opts.name,
+	[WalrusSpans.nodeCount]: opts.nodeCount,
+	[WalrusSpans.shards]: opts.shards
 } }));
 //#endregion
 export { bootLocalCluster, resolveLocalClusterOptions };

package/dist/plugins/walrus/mode/local-cluster.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"local-cluster.mjs","names":["brandContentHash"],"sources":["../../../../src/plugins/walrus/mode/local-cluster.ts"],"sourcesContent":["// Walrus mode — local cluster.\n//\n// Distilled-doc reference (06-walrus.md §\"Lifecycle: Startup —\n// local cluster\"). Eight ordered phases:\n//\n//   0. Yield deps (Sui, Identity, ChainProbe, faucet strategy opt).\n//   1. Image build — upstream cargo image (bootstrap asset) +\n//                    wrapper image (inline; content-addressed on\n//                    the upstream tag + suiVersion).\n//  1b. Docker network create — per-stack `/24` via\n//      `Docker.networkCreate(networkName, {subnet})`.\n//   2. Deploy contracts — via `ArtifactPublisher`. The\n//                          publisher folds chainId into the cache\n//                          key; verify probes BOTH the on-disk\n//                          `deploy` file AND on-chain object\n//                          existence; produce runs the deploy\n//                          one-shot.\n//   3. Register committee — currently a typed no-op (distilled-doc\n//                            opportunity #3: drop the cargo-culted\n//                            placeholder). We omit it entirely in\n//                            v3 rewrite.\n//   4. Storage nodes — parallel boot of N storage-node containers.\n//   5. Exchange resolution — on-chain getObject + parse type.\n//                             Degrades to undefined on\n//                             OBJECT_NOT_FOUND.\n//   6. Proxy URL pick — nodes[0].rpcUrl is the representative\n//                        aggregator/publisher.\n//  7a. WAL faucet strategy register — opt-in when an exchange exists.\n//   8. Registries — package + endpoint + walrus-state.\n//\n// What this file owns: the dispatch shape + the typed options\n// surface + the synchronous factory-time validation.\n//\n// What this file delegates: container/Move heavy paths live in\n// `storage-nodes.ts`, `deploy.ts`, and the `ArtifactPublisher`\n// primitive.\n\nimport { Effect, FileSystem, Path, type Scope } from 'effect';\n\nimport type {\n\tArtifactPublishError,\n\tArtifactPublisher,\n} from '../../../primitives/artifact-publisher.ts';\nimport type { ChainProbe } from '../../../contracts/chain-probe.ts';\nimport type { ContainerRuntime } from '../../../contracts/container-runtime.ts';\nimport type { SuiProbeKey } from '../../sui/chain-probe.ts';\nimport { contentHash as brandContentHash } from '../../../substrate/brand.ts';\nimport type { ChainId } from '../../../substrate/brand.ts';\nimport { expectPositiveInteger } from '../../../substrate/runtime/config-validation.ts';\nimport { setCurrentPluginPhase } from '../../../substrate/runtime/current-plugin.ts';\nimport { walrusConfigError, walrusPluginError, type WalrusError } from '../errors.ts';\nimport type { WalrusStorageNode } from '../storage-nodes.ts';\nimport {\n\tDEFAULT_NODE_READY_TIMEOUT_MS,\n\tDEFAULT_CONTAINER_API_PORT,\n\tWALRUS_NODE_IP_BASE,\n\tcomputePublicHostname,\n\tstartStorageNodes,\n} from '../storage-nodes.ts';\nimport { deployWalrusContracts, type CachedDeployState } from '../deploy.ts';\nimport {\n\tDEFAULT_SUI_VERSION,\n\tDEFAULT_WALRUS_REF,\n\tresolveCargoImage,\n} from '../bootstrap-assets/cargo-image.ts';\nimport {\n\tmakeWalFaucetStrategy,\n\twalPackageIdFromCoinType,\n\tresolveWalCoinType,\n\ttype WalFaucetStrategy,\n} from '../faucet-strategy.ts';\nimport { resolveWalExchange, type WalExchangeHandle, type WalSwapSdk } from '../wal-swap.ts';\n\n/** Options for the local-cluster mode. Mirrors v3\n *  `WalrusLocalClusterOptions<Name>` (06-walrus.md §\"Configuration\"). */\nexport interface WalrusLocalClusterOptions {\n\t/** Engine row name + on-disk dir suffix + registry key.\n\t *  Default `'walrus'`. */\n\treadonly name?: string;\n\t/** Number of storage-node containers. Must be `>= 1` (synchronous\n\t *  factory-time guard). Default `1`. */\n\treadonly nodeCount?: number;\n\t/** Total shards distributed across the committee. Must be\n\t *  `>= nodeCount`. Default `100` (distilled-doc default block). */\n\treadonly shards?: number;\n\t/** Pinned walrus release — drives the wrapper image build.\n\t *  Default `'testnet-v1.49.1'`. */\n\treadonly version?: string;\n\t/** Sui release whose binary the wrapper image bakes (distilled-\n\t *  doc invariant 24). Default `'devnet-v1.71.0'`. */\n\treadonly suiVersion?: string;\n\t/** Port each storage node binds inside the container. Default\n\t *  9185 (same as the router entrypoint — invariant 9). */\n\treadonly containerApiPort?: number;\n\t/** Walrus epoch length passed to `walrus-deploy --epoch-duration`.\n\t *  Default `'24h'`. */\n\treadonly epochDuration?: string;\n\t/** Per-node TCP ready-probe timeout (ms). Defaults to\n\t *  `DEFAULT_NODE_READY_TIMEOUT_MS`. */\n\treadonly readyTimeoutMs?: number;\n}\n\n/** Resolved local-cluster boot artifacts. */\nexport interface LocalClusterBootResult {\n\treadonly mode: 'local';\n\treadonly deploy: CachedDeployState;\n\treadonly walrusPackageId: string;\n\treadonly walPackageId: string;\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\treadonly aggregatorUrl: string;\n\treadonly publisherUrl: string;\n\treadonly proxyUrl: string;\n\treadonly exchangeObjectId: string | undefined;\n\treadonly exchange: WalExchangeHandle | null;\n\t/** WAL faucet strategy — present only when the local cluster has a\n\t *  non-empty exchange object. The barrel registers this onto the\n\t *  `coinType:<fullCoinType>` strategy contributor decl. `null`\n\t *  otherwise. */\n\treadonly walFaucetStrategy: WalFaucetStrategy | null;\n\treadonly walCoinType: string;\n}\n\n/** Defaults applied to options. */\nexport interface ResolvedLocalClusterOptions {\n\treadonly name: string;\n\treadonly nodeCount: number;\n\treadonly shards: number;\n\treadonly version: string;\n\treadonly suiVersion: string;\n\treadonly containerApiPort: number;\n\treadonly epochDuration: string;\n\treadonly readyTimeoutMs: number;\n}\n\n/** Synchronous factory-time validation. Mirrors v3's\n *  `local-cluster.ts:101-121` guards. Throws (NOT Effect-fail) so\n *  misconfiguration trips at the `defineDevstack` call site rather\n *  than at deferred Layer.build time. Distilled-doc invariant 11. */\nexport const resolveLocalClusterOptions = (\n\topts: WalrusLocalClusterOptions,\n): ResolvedLocalClusterOptions => {\n\tconst nodeCount = expectPositiveInteger(opts.nodeCount ?? 1, {\n\t\tfield: 'nodeCount',\n\t\tmkError: ({ field, message, hint }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusLocalCluster: nodeCount must be >= 1 (got ${String(opts.nodeCount ?? 1)})`,\n\t\t\t\thint ?? message,\n\t\t\t),\n\t\thint: 'set nodeCount to a positive integer (default 1)',\n\t});\n\tconst shards = expectPositiveInteger(opts.shards ?? 100, {\n\t\tfield: 'shards',\n\t\tmkError: ({ field, message, hint }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusLocalCluster: shards must be a positive integer (got ${String(opts.shards ?? 100)})`,\n\t\t\t\thint ?? message,\n\t\t\t),\n\t\thint: 'set shards to a positive integer (default 100)',\n\t});\n\tif (shards < nodeCount) {\n\t\tthrow walrusConfigError(\n\t\t\t'shards',\n\t\t\t`walrusLocalCluster: shards (${shards}) must be >= nodeCount (${nodeCount})`,\n\t\t\t`set shards >= ${nodeCount} (default 100)`,\n\t\t);\n\t}\n\treturn {\n\t\tname: opts.name ?? 'walrus',\n\t\tnodeCount,\n\t\tshards,\n\t\tversion: opts.version ?? DEFAULT_WALRUS_REF,\n\t\tsuiVersion: opts.suiVersion ?? DEFAULT_SUI_VERSION,\n\t\tcontainerApiPort: opts.containerApiPort ?? DEFAULT_CONTAINER_API_PORT,\n\t\tepochDuration: opts.epochDuration ?? '24h',\n\t\treadyTimeoutMs: opts.readyTimeoutMs ?? DEFAULT_NODE_READY_TIMEOUT_MS,\n\t};\n};\n\n/** Dependencies the local service consumes at acquire-time. */\nexport interface LocalClusterDeps {\n\treadonly runtime: ContainerRuntime;\n\treadonly publisher: ArtifactPublisher;\n\treadonly probe: ChainProbe<SuiProbeKey>;\n\treadonly suiSdk: WalSwapSdk;\n\treadonly suiChainId: ChainId;\n\treadonly suiRpcUrlInNetwork: string;\n\treadonly walrusFaucetUrlInNetwork: string;\n\treadonly waitForFundsReady: Effect.Effect<void, unknown>;\n\treadonly app: string;\n\treadonly stack: string;\n\t/** Pre-allocated /24 prefix from `subnetForStack`. */\n\treadonly subnetPrefix: string;\n\treadonly walrusNetworkName: string;\n\treadonly suiNetworkName: string;\n\treadonly deployHostMountPath: string;\n}\n\n/** Boot the local cluster. Returns the resolved value the plugin\n *  projects onto its tags.\n *\n *  Steps:\n *    - Image build — `resolveCargoImage` (bootstrap asset).\n *      Honors `WALRUS_CARGO_IMAGE_OVERRIDE` for the pre-baked path.\n *    - Docker network ensure — `runtime.ensureNetwork(walrusNet)`.\n *      The sui network is owned by the sui plugin; we attach to it\n *      as a secondary network on each storage node.\n *    - Deploy contracts — `deployWalrusContracts` dispatches through\n *      the artifact publisher primitive; the produce body runs the walrus deploy\n *      one-shot.\n *    - Storage nodes — parallel boot via `startStorageNodes`.\n *    - Proxy URL pick — `nodes[0].rpcUrl`.\n *    - WAL faucet strategy — constructed if `state.exchangeObject`\n *      exists. Surfaced on the boot result; the barrel registers\n *      the contributor decl.\n *\n *  Per-step failures surface as `WalrusPluginError` with the phase\n *  vocabulary from `errors.ts`; artifact publisher failures pass through as\n *  `ArtifactPublishError`. The plugin narration vocabulary anchors\n *  on these phase tags.\n */\nexport const bootLocalCluster = (\n\tdeps: LocalClusterDeps,\n\topts: ResolvedLocalClusterOptions,\n): Effect.Effect<\n\tLocalClusterBootResult,\n\tWalrusError | ArtifactPublishError,\n\tScope.Scope | FileSystem.FileSystem | Path.Path\n> =>\n\tEffect.gen(function* () {\n\t\t// ---- cargo image (bootstrap asset) -----------------------\n\t\t// The cargo image is content-addressed; the resolver owns the\n\t\t// cache check + the registry-tag override fast path.\n\t\tyield* setCurrentPluginPhase(`resolving Walrus image ${opts.version}`);\n\t\tconst walrusImage = yield* resolveCargoImage(deps.runtime, {\n\t\t\twalrusRef: opts.version,\n\t\t\tsuiVersion: opts.suiVersion,\n\t\t});\n\n\t\t// ---- docker network ensure ------------------------------\n\t\tyield* setCurrentPluginPhase(`ensuring Walrus network ${deps.walrusNetworkName}`);\n\t\tyield* deps.runtime\n\t\t\t.ensureNetwork({\n\t\t\t\tname: deps.walrusNetworkName,\n\t\t\t\tapp: deps.app,\n\t\t\t\tstack: deps.stack,\n\t\t\t})\n\t\t\t.pipe(\n\t\t\t\tEffect.catch((cause) =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'cluster-network',\n\t\t\t\t\t\t\t`walrus: ensureNetwork('${deps.walrusNetworkName}') failed: ${cause.reason}: ${cause.detail}`,\n\t\t\t\t\t\t\t{ cause },\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\n\t\t// ---- deploy via ArtifactPublisher ----------------\n\t\t// The deploy one-shot needs the walrus image + sui network so it\n\t\t// can dial the per-stack sui RPC + faucet over docker DNS.\n\t\t//\n\t\t// Per-node IP CSV is derived from the subnet prefix; per-node\n\t\t// hostnames likewise. Both must be in lockstep with the\n\t\t// storage-node boot below — the deploy step writes per-node\n\t\t// committee records on chain using these.\n\t\tconst publicHosts = Array.from({ length: opts.nodeCount }, (_, i) =>\n\t\t\tcomputePublicHostname(deps.app, deps.stack, i),\n\t\t).join(',');\n\t\tconst listeningIps = Array.from(\n\t\t\t{ length: opts.nodeCount },\n\t\t\t(_, i) => `${deps.subnetPrefix}.${WALRUS_NODE_IP_BASE + i}`,\n\t\t).join(',');\n\n\t\tyield* setCurrentPluginPhase(\n\t\t\t`deploying Walrus contracts (${opts.nodeCount} node${opts.nodeCount === 1 ? '' : 's'}, ${opts.shards} shards)`,\n\t\t);\n\t\tconst { state } = yield* deployWalrusContracts(deps.publisher, deps.probe, deps.runtime, {\n\t\t\twalrusName: opts.name,\n\t\t\tchainId: deps.suiChainId,\n\t\t\tcontentHash: brandContentHash(\n\t\t\t\t`walrus|${opts.version}|${opts.suiVersion}|${opts.nodeCount}|${opts.shards}|${opts.epochDuration}`,\n\t\t\t),\n\t\t\toutputDirHostPath: deps.deployHostMountPath,\n\t\t\tsuiRpcUrlInNetwork: deps.suiRpcUrlInNetwork,\n\t\t\twalrusFaucetUrlInNetwork: deps.walrusFaucetUrlInNetwork,\n\t\t\twaitForFundsReady: deps.waitForFundsReady,\n\t\t\tcommitteeSize: opts.nodeCount,\n\t\t\tshards: opts.shards,\n\t\t\tepochDuration: opts.epochDuration,\n\t\t\tpublicHostsCsv: publicHosts,\n\t\t\tlisteningIpsCsv: listeningIps,\n\t\t\twalrusImage,\n\t\t\tsuiNetworkName: deps.suiNetworkName,\n\t\t});\n\t\tconst deployConfigHash = [\n\t\t\t'walrus-deploy',\n\t\t\tstate.walrusPackageId,\n\t\t\tstate.systemObject,\n\t\t\tstate.stakingObject,\n\t\t\tstate.exchangeObject ?? 'no-exchange',\n\t\t].join('|');\n\n\t\t// ---- storage nodes — parallel boot ----------------------\n\t\tyield* setCurrentPluginPhase(\n\t\t\t`starting ${opts.nodeCount} Walrus storage node${opts.nodeCount === 1 ? '' : 's'}`,\n\t\t);\n\t\tconst { nodes } = yield* startStorageNodes(deps.runtime, {\n\t\t\tapp: deps.app,\n\t\t\tstack: deps.stack,\n\t\t\twalrusName: opts.name,\n\t\t\timage: walrusImage,\n\t\t\tnodeCount: opts.nodeCount,\n\t\t\tsubnetPrefix: deps.subnetPrefix,\n\t\t\tcontainerApiPort: opts.containerApiPort,\n\t\t\twalrusNetworkName: deps.walrusNetworkName,\n\t\t\tsuiNetworkName: deps.suiNetworkName,\n\t\t\tdeployHostMountPath: deps.deployHostMountPath,\n\t\t\tdeployConfigHash,\n\t\t\treadyTimeoutMs: opts.readyTimeoutMs,\n\t\t});\n\n\t\t// ---- proxy URL pick — nodes[0].rpcUrl -------------------\n\t\t// `nodeCount >= 1` is enforced synchronously already; this is\n\t\t// defense-in-depth.\n\t\tif (nodes.length === 0) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\twalrusPluginError('proxy', 'walrus: at least one storage node is required'),\n\t\t\t);\n\t\t}\n\t\tconst proxyUrl = nodes[0]!.rpcUrl;\n\n\t\t// ---- exchange resolution + WAL funding strategy ------\n\t\t// Register a `coinType:<fullCoinType>` strategy that swaps the\n\t\t// requesting account's SUI into WAL on demand. Accounts opt in via\n\t\t// their normal `funding` list.\n\t\tyield* setCurrentPluginPhase('resolving WAL exchange');\n\t\tconst exchange = yield* resolveWalExchange(deps.probe, state.exchangeObject);\n\t\tconst walFaucetStrategy: WalFaucetStrategy | null = exchange\n\t\t\t? makeWalFaucetStrategy({\n\t\t\t\t\texchange,\n\t\t\t\t\tsdk: deps.suiSdk,\n\t\t\t\t})\n\t\t\t: null;\n\t\tconst resolvedWalCoinType = yield* resolveWalCoinType({\n\t\t\tprobe: deps.probe,\n\t\t\ttreasuryObjectId: state.treasuryObject,\n\t\t\tdeployPackageId: state.walrusPackageId,\n\t\t\trequireTreasuryObject: exchange !== null,\n\t\t});\n\t\tconst resolvedWalPackageId = walPackageIdFromCoinType(resolvedWalCoinType);\n\n\t\treturn {\n\t\t\tmode: 'local' as const,\n\t\t\tdeploy: state,\n\t\t\twalrusPackageId: state.walrusPackageId,\n\t\t\twalPackageId: resolvedWalPackageId,\n\t\t\tnodes,\n\t\t\taggregatorUrl: proxyUrl,\n\t\t\tpublisherUrl: proxyUrl,\n\t\t\tproxyUrl,\n\t\t\texchangeObjectId: state.exchangeObject,\n\t\t\texchange,\n\t\t\twalFaucetStrategy,\n\t\t\twalCoinType: resolvedWalCoinType,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.walrus.localCluster.boot', {\n\t\t\tattributes: {\n\t\t\t\t'devstack.plugin': 'walrus',\n\t\t\t\t'walrus.name': opts.name,\n\t\t\t\t'walrus.nodeCount': opts.nodeCount,\n\t\t\t\t'walrus.shards': opts.shards,\n\t\t\t},\n\t\t}),\n\t);\n"],"mappings":"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"}
+{"version":3,"file":"local-cluster.mjs","names":["brandContentHash"],"sources":["../../../../src/plugins/walrus/mode/local-cluster.ts"],"sourcesContent":["// Walrus mode — local cluster.\n//\n// Distilled-doc reference (06-walrus.md §\"Lifecycle: Startup —\n// local cluster\"). Eight ordered phases:\n//\n//   0. Yield deps (Sui, Identity, ChainProbe, faucet strategy opt).\n//   1. Image build — upstream cargo image (bootstrap asset) +\n//                    wrapper image (inline; content-addressed on\n//                    the upstream tag + suiVersion).\n//  1b. Docker network create — per-stack `/24` via\n//      `Docker.networkCreate(networkName, {subnet})`.\n//   2. Deploy contracts — via `ArtifactPublisher`. The\n//                          publisher folds chainId into the cache\n//                          key; verify probes BOTH the on-disk\n//                          `deploy` file AND on-chain object\n//                          existence; produce runs the deploy\n//                          one-shot.\n//   3. Register committee — currently a typed no-op (distilled-doc\n//                            opportunity #3: drop the cargo-culted\n//                            placeholder). We omit it entirely in\n//                            v3 rewrite.\n//   4. Storage nodes — parallel boot of N storage-node containers.\n//   5. Exchange resolution — on-chain getObject + parse type.\n//                             Degrades to undefined on\n//                             OBJECT_NOT_FOUND.\n//   6. Proxy URL pick — nodes[0].rpcUrl is the representative\n//                        aggregator/publisher.\n//  7a. WAL faucet strategy register — opt-in when an exchange exists.\n//   8. Registries — package + endpoint + walrus-state.\n//\n// What this file owns: the dispatch shape + the typed options\n// surface + the synchronous factory-time validation.\n//\n// What this file delegates: container/Move heavy paths live in\n// `storage-nodes.ts`, `deploy.ts`, and the `ArtifactPublisher`\n// primitive.\n\nimport { Effect, FileSystem, Path, type Scope } from 'effect';\n\nimport type {\n\tArtifactPublishError,\n\tArtifactPublisher,\n} from '../../../primitives/artifact-publisher.ts';\nimport type { ChainProbe } from '../../../contracts/chain-probe.ts';\nimport type { ContainerRuntime } from '../../../contracts/container-runtime.ts';\nimport type { SuiProbeKey } from '../../sui/index.ts';\nimport { contentHash as brandContentHash } from '../../../substrate/brand.ts';\nimport type { ChainId } from '../../../substrate/brand.ts';\nimport { expectPositiveInteger } from '../../../substrate/runtime/config-validation.ts';\nimport { setCurrentPluginPhase } from '../../../substrate/runtime/current-plugin.ts';\nimport { SpanAttr } from '../../../substrate/runtime/observability/spans.ts';\nimport { walrusConfigError, walrusPluginError, type WalrusError } from '../errors.ts';\nimport { WALRUS_MAX_NODE_COUNT } from '../routable.ts';\nimport { WalrusSpans } from '../spans.ts';\nimport type { WalrusStorageNode } from '../storage-nodes.ts';\nimport {\n\tDEFAULT_NODE_READY_TIMEOUT_MS,\n\tDEFAULT_CONTAINER_API_PORT,\n\tWALRUS_NODE_IP_BASE,\n\tcomputePublicHostname,\n\tstartStorageNodes,\n} from '../storage-nodes.ts';\nimport { deployWalrusContracts, type CachedDeployState } from '../deploy.ts';\nimport {\n\tDEFAULT_SUI_VERSION,\n\tDEFAULT_WALRUS_REF,\n\tresolveCargoImage,\n} from '../bootstrap-assets/cargo-image.ts';\nimport {\n\tmakeWalFaucetStrategy,\n\twalPackageIdFromCoinType,\n\tresolveWalCoinType,\n\ttype WalFaucetStrategy,\n} from '../faucet-strategy.ts';\nimport { resolveWalExchange, type WalExchangeHandle, type WalSwapSdk } from '../wal-swap.ts';\n\n/** Options for the local-cluster mode. Mirrors v3\n *  `WalrusLocalClusterOptions<Name>` (06-walrus.md §\"Configuration\"). */\nexport interface WalrusLocalClusterOptions {\n\t/** Engine row name + on-disk dir suffix + registry key.\n\t *  Default `'walrus'`. */\n\treadonly name?: string;\n\t/** Number of storage-node containers. Must be `>= 1` (synchronous\n\t *  factory-time guard). Default `1`. */\n\treadonly nodeCount?: number;\n\t/** Total shards distributed across the committee. Must be\n\t *  `>= nodeCount`. Default `100` (distilled-doc default block). */\n\treadonly shards?: number;\n\t/** Pinned walrus release — drives the wrapper image build.\n\t *  Default `'testnet-v1.49.1'`. */\n\treadonly version?: string;\n\t/** Sui release whose binary the wrapper image bakes (distilled-\n\t *  doc invariant 24). Default `'devnet-v1.71.0'`. */\n\treadonly suiVersion?: string;\n\t/** Port each storage node binds inside the container. Default\n\t *  9185 (same as the router entrypoint — invariant 9). */\n\treadonly containerApiPort?: number;\n\t/** Walrus epoch length passed to `walrus-deploy --epoch-duration`.\n\t *  Default `'24h'`. */\n\treadonly epochDuration?: string;\n\t/** Per-node TCP ready-probe timeout (ms). Defaults to\n\t *  `DEFAULT_NODE_READY_TIMEOUT_MS`. */\n\treadonly readyTimeoutMs?: number;\n}\n\n/** Resolved local-cluster boot artifacts. */\nexport interface LocalClusterBootResult {\n\treadonly mode: 'local';\n\treadonly deploy: CachedDeployState;\n\treadonly walrusPackageId: string;\n\treadonly walPackageId: string;\n\treadonly nodes: ReadonlyArray<WalrusStorageNode>;\n\treadonly aggregatorUrl: string;\n\treadonly publisherUrl: string;\n\treadonly proxyUrl: string;\n\treadonly exchangeObjectId: string | undefined;\n\treadonly exchange: WalExchangeHandle | null;\n\t/** WAL faucet strategy — present only when the local cluster has a\n\t *  non-empty exchange object. The barrel registers this onto the\n\t *  `coinType:<fullCoinType>` strategy contributor decl. `null`\n\t *  otherwise. */\n\treadonly walFaucetStrategy: WalFaucetStrategy | null;\n\treadonly walCoinType: string;\n}\n\n/** Defaults applied to options. */\nexport interface ResolvedLocalClusterOptions {\n\treadonly name: string;\n\treadonly nodeCount: number;\n\treadonly shards: number;\n\treadonly version: string;\n\treadonly suiVersion: string;\n\treadonly containerApiPort: number;\n\treadonly epochDuration: string;\n\treadonly readyTimeoutMs: number;\n}\n\n/** Synchronous factory-time validation. Mirrors v3's\n *  `local-cluster.ts:101-121` guards. Throws (NOT Effect-fail) so\n *  misconfiguration trips at the `defineDevstack` call site rather\n *  than at deferred Layer.build time. Distilled-doc invariant 11. */\nexport const resolveLocalClusterOptions = (\n\topts: WalrusLocalClusterOptions,\n): ResolvedLocalClusterOptions => {\n\tconst nodeCount = expectPositiveInteger(opts.nodeCount ?? 1, {\n\t\tfield: 'nodeCount',\n\t\tmkError: ({ field, message, hint }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusLocalCluster: nodeCount must be >= 1 (got ${String(opts.nodeCount ?? 1)})`,\n\t\t\t\thint ?? message,\n\t\t\t),\n\t\thint: 'set nodeCount to a positive integer (default 1)',\n\t});\n\tif (nodeCount > WALRUS_MAX_NODE_COUNT) {\n\t\tthrow walrusConfigError(\n\t\t\t'nodeCount',\n\t\t\t`walrusLocalCluster: nodeCount (${nodeCount}) exceeds the maximum ${WALRUS_MAX_NODE_COUNT} ` +\n\t\t\t\t`pre-declared Traefik entrypoints (walrus-node-0..${WALRUS_MAX_NODE_COUNT - 1}).`,\n\t\t\t`reduce nodeCount or raise WALRUS_MAX_NODE_COUNT in plugins/walrus/routable.ts`,\n\t\t);\n\t}\n\tconst shards = expectPositiveInteger(opts.shards ?? 100, {\n\t\tfield: 'shards',\n\t\tmkError: ({ field, message, hint }) =>\n\t\t\twalrusConfigError(\n\t\t\t\tfield,\n\t\t\t\t`walrusLocalCluster: shards must be a positive integer (got ${String(opts.shards ?? 100)})`,\n\t\t\t\thint ?? message,\n\t\t\t),\n\t\thint: 'set shards to a positive integer (default 100)',\n\t});\n\tif (shards < nodeCount) {\n\t\tthrow walrusConfigError(\n\t\t\t'shards',\n\t\t\t`walrusLocalCluster: shards (${shards}) must be >= nodeCount (${nodeCount})`,\n\t\t\t`set shards >= ${nodeCount} (default 100)`,\n\t\t);\n\t}\n\treturn {\n\t\tname: opts.name ?? 'walrus',\n\t\tnodeCount,\n\t\tshards,\n\t\tversion: opts.version ?? DEFAULT_WALRUS_REF,\n\t\tsuiVersion: opts.suiVersion ?? DEFAULT_SUI_VERSION,\n\t\tcontainerApiPort: opts.containerApiPort ?? DEFAULT_CONTAINER_API_PORT,\n\t\tepochDuration: opts.epochDuration ?? '24h',\n\t\treadyTimeoutMs: opts.readyTimeoutMs ?? DEFAULT_NODE_READY_TIMEOUT_MS,\n\t};\n};\n\n/** Dependencies the local service consumes at acquire-time. */\nexport interface LocalClusterDeps {\n\treadonly runtime: ContainerRuntime;\n\treadonly publisher: ArtifactPublisher;\n\treadonly probe: ChainProbe<SuiProbeKey>;\n\treadonly suiSdk: WalSwapSdk;\n\treadonly suiChainId: ChainId;\n\treadonly suiRpcUrlInNetwork: string;\n\treadonly walrusFaucetUrlInNetwork: string;\n\treadonly waitForFundsReady: Effect.Effect<void, unknown>;\n\treadonly app: string;\n\treadonly stack: string;\n\t/** Pre-allocated /24 prefix from `subnetForStack`. */\n\treadonly subnetPrefix: string;\n\treadonly walrusNetworkName: string;\n\treadonly suiNetworkName: string;\n\treadonly deployHostMountPath: string;\n\t/** On-disk per-stack root from `StackPathsService.stackRoot`. The\n\t *  walrus bind-mount is computed off this; `deployHostMountPath`\n\t *  MUST live under it. */\n\treadonly stackRoot: string;\n}\n\n/** Boot the local cluster. Returns the resolved value the plugin\n *  projects onto its tags.\n *\n *  Steps:\n *    - Image build — `resolveCargoImage` (bootstrap asset).\n *      Honors `WALRUS_CARGO_IMAGE_OVERRIDE` for the pre-baked path.\n *    - Docker network ensure — `runtime.ensureNetwork(walrusNet)`.\n *      The sui network is owned by the sui plugin; we attach to it\n *      as a secondary network on each storage node.\n *    - Deploy contracts — `deployWalrusContracts` dispatches through\n *      the artifact publisher primitive; the produce body runs the walrus deploy\n *      one-shot.\n *    - Storage nodes — parallel boot via `startStorageNodes`.\n *    - Proxy URL pick — `nodes[0].rpcUrl`.\n *    - WAL faucet strategy — constructed if `state.exchangeObject`\n *      exists. Surfaced on the boot result; the barrel registers\n *      the contributor decl.\n *\n *  Per-step failures surface as `WalrusPluginError` with the phase\n *  vocabulary from `errors.ts`; artifact publisher failures pass through as\n *  `ArtifactPublishError`. The plugin narration vocabulary anchors\n *  on these phase tags.\n */\nexport const bootLocalCluster = (\n\tdeps: LocalClusterDeps,\n\topts: ResolvedLocalClusterOptions,\n): Effect.Effect<\n\tLocalClusterBootResult,\n\tWalrusError | ArtifactPublishError,\n\tScope.Scope | FileSystem.FileSystem | Path.Path\n> =>\n\tEffect.gen(function* () {\n\t\t// ---- cargo image (bootstrap asset) -----------------------\n\t\t// The cargo image is content-addressed; the resolver owns the\n\t\t// cache check + the registry-tag override fast path.\n\t\tyield* setCurrentPluginPhase(`resolving Walrus image ${opts.version}`);\n\t\tconst walrusImage = yield* resolveCargoImage(deps.runtime, {\n\t\t\twalrusRef: opts.version,\n\t\t\tsuiVersion: opts.suiVersion,\n\t\t\towner: { app: deps.app, stack: deps.stack },\n\t\t});\n\n\t\t// ---- docker network ensure ------------------------------\n\t\tyield* setCurrentPluginPhase(`ensuring Walrus network ${deps.walrusNetworkName}`);\n\t\tyield* deps.runtime\n\t\t\t.ensureNetwork({\n\t\t\t\tname: deps.walrusNetworkName,\n\t\t\t\tapp: deps.app,\n\t\t\t\tstack: deps.stack,\n\t\t\t})\n\t\t\t.pipe(\n\t\t\t\tEffect.catch((cause) =>\n\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\twalrusPluginError(\n\t\t\t\t\t\t\t'cluster-network',\n\t\t\t\t\t\t\t`walrus: ensureNetwork('${deps.walrusNetworkName}') failed: ${cause.reason}: ${cause.detail}`,\n\t\t\t\t\t\t\t{ cause },\n\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t);\n\n\t\t// ---- deploy via ArtifactPublisher ----------------\n\t\t// The deploy one-shot needs the walrus image + sui network so it\n\t\t// can dial the per-stack sui RPC + faucet over docker DNS.\n\t\t//\n\t\t// Per-node IP CSV is derived from the subnet prefix; per-node\n\t\t// hostnames likewise. Both must be in lockstep with the\n\t\t// storage-node boot below — the deploy step writes per-node\n\t\t// committee records on chain using these.\n\t\tconst publicHosts = Array.from({ length: opts.nodeCount }, (_, i) =>\n\t\t\tcomputePublicHostname(deps.app, deps.stack, i),\n\t\t).join(',');\n\t\tconst listeningIps = Array.from(\n\t\t\t{ length: opts.nodeCount },\n\t\t\t(_, i) => `${deps.subnetPrefix}.${WALRUS_NODE_IP_BASE + i}`,\n\t\t).join(',');\n\n\t\tyield* setCurrentPluginPhase(\n\t\t\t`deploying Walrus contracts (${opts.nodeCount} node${opts.nodeCount === 1 ? '' : 's'}, ${opts.shards} shards)`,\n\t\t);\n\t\tconst { state } = yield* deployWalrusContracts(deps.publisher, deps.probe, deps.runtime, {\n\t\t\twalrusName: opts.name,\n\t\t\tchainId: deps.suiChainId,\n\t\t\tcontentHash: brandContentHash(\n\t\t\t\t`walrus|${opts.version}|${opts.suiVersion}|${opts.nodeCount}|${opts.shards}|${opts.epochDuration}`,\n\t\t\t),\n\t\t\toutputDirHostPath: deps.deployHostMountPath,\n\t\t\tstackRoot: deps.stackRoot,\n\t\t\tsuiRpcUrlInNetwork: deps.suiRpcUrlInNetwork,\n\t\t\twalrusFaucetUrlInNetwork: deps.walrusFaucetUrlInNetwork,\n\t\t\twaitForFundsReady: deps.waitForFundsReady,\n\t\t\tcommitteeSize: opts.nodeCount,\n\t\t\tshards: opts.shards,\n\t\t\tepochDuration: opts.epochDuration,\n\t\t\tpublicHostsCsv: publicHosts,\n\t\t\tlisteningIpsCsv: listeningIps,\n\t\t\twalrusImage,\n\t\t\tsuiNetworkName: deps.suiNetworkName,\n\t\t});\n\t\tconst deployConfigHash = [\n\t\t\t'walrus-deploy',\n\t\t\tstate.walrusPackageId,\n\t\t\tstate.systemObject,\n\t\t\tstate.stakingObject,\n\t\t\tstate.exchangeObject ?? 'no-exchange',\n\t\t].join('|');\n\n\t\t// Per-node image tags. Each storage node runs under its OWN tag (a cheap\n\t\t// re-tag of the one content-cached cargo build) so its committed writable\n\t\t// layer — the RocksDB holding that node's slivers — promotes to a DISTINCT\n\t\t// image on snapshot restore. A single shared tag would make the restore\n\t\t// image-promote collapse all N committed layers onto one tag\n\t\t// (last-write-wins): N-1 nodes boot on the wrong layer and every\n\t\t// pre-snapshot blob is orphaned. The tag is scoped by the deployed\n\t\t// `walrusPackageId` — stable across boot1 -> restore -> boot2 (the deploy\n\t\t// cache reuses the same id, so the restore's promote target matches what\n\t\t// boot2 requests), but DISTINCT per fresh deployment, so a later cold boot\n\t\t// on a new chain never inherits a prior run's committed node layers (which\n\t\t// carry a stale committee and would reject writes). The base `walrusImage`\n\t\t// (shared) still backs the transient deploy one-shot (`--rm`, unsnapshotted).\n\t\tconst nodeImageScope = state.walrusPackageId.replace(/^0x/, '').slice(0, 12);\n\t\tconst nodeImages = yield* Effect.forEach(\n\t\t\tArray.from({ length: opts.nodeCount }, (_, i) => i),\n\t\t\t(i) =>\n\t\t\t\tresolveCargoImage(\n\t\t\t\t\tdeps.runtime,\n\t\t\t\t\t{\n\t\t\t\t\t\twalrusRef: opts.version,\n\t\t\t\t\t\tsuiVersion: opts.suiVersion,\n\t\t\t\t\t\towner: { app: deps.app, stack: deps.stack },\n\t\t\t\t\t},\n\t\t\t\t\t`${walrusImage.tag}-${nodeImageScope}-node-${i}`,\n\t\t\t\t),\n\t\t);\n\n\t\t// ---- storage nodes — parallel boot ----------------------\n\t\tyield* setCurrentPluginPhase(\n\t\t\t`starting ${opts.nodeCount} Walrus storage node${opts.nodeCount === 1 ? '' : 's'}`,\n\t\t);\n\t\tconst { nodes } = yield* startStorageNodes(deps.runtime, {\n\t\t\tapp: deps.app,\n\t\t\tstack: deps.stack,\n\t\t\twalrusName: opts.name,\n\t\t\timages: nodeImages,\n\t\t\tnodeCount: opts.nodeCount,\n\t\t\tsubnetPrefix: deps.subnetPrefix,\n\t\t\tcontainerApiPort: opts.containerApiPort,\n\t\t\twalrusNetworkName: deps.walrusNetworkName,\n\t\t\tsuiNetworkName: deps.suiNetworkName,\n\t\t\tdeployHostMountPath: deps.deployHostMountPath,\n\t\t\tstackRoot: deps.stackRoot,\n\t\t\tdeployConfigHash,\n\t\t\treadyTimeoutMs: opts.readyTimeoutMs,\n\t\t});\n\n\t\t// ---- proxy URL pick — nodes[0].rpcUrl -------------------\n\t\t// `nodeCount >= 1` is enforced synchronously already; this is\n\t\t// defense-in-depth.\n\t\tif (nodes.length === 0) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\twalrusPluginError('proxy', 'walrus: at least one storage node is required'),\n\t\t\t);\n\t\t}\n\t\tconst proxyUrl = nodes[0]!.rpcUrl;\n\n\t\t// ---- exchange resolution + WAL funding strategy ------\n\t\t// Register a `coinType:<fullCoinType>` strategy that swaps the\n\t\t// requesting account's SUI into WAL on demand. Accounts opt in via\n\t\t// their normal `funding` list.\n\t\tyield* setCurrentPluginPhase('resolving WAL exchange');\n\t\tconst exchange = yield* resolveWalExchange(deps.probe, state.exchangeObject);\n\t\tconst walFaucetStrategy: WalFaucetStrategy | null = exchange\n\t\t\t? makeWalFaucetStrategy({\n\t\t\t\t\texchange,\n\t\t\t\t\tsdk: deps.suiSdk,\n\t\t\t\t})\n\t\t\t: null;\n\t\tconst resolvedWalCoinType = yield* resolveWalCoinType({\n\t\t\tprobe: deps.probe,\n\t\t\ttreasuryObjectId: state.treasuryObject,\n\t\t\tdeployPackageId: state.walrusPackageId,\n\t\t\trequireTreasuryObject: exchange !== null,\n\t\t});\n\t\tconst resolvedWalPackageId = walPackageIdFromCoinType(resolvedWalCoinType);\n\n\t\treturn {\n\t\t\tmode: 'local' as const,\n\t\t\tdeploy: state,\n\t\t\twalrusPackageId: state.walrusPackageId,\n\t\t\twalPackageId: resolvedWalPackageId,\n\t\t\tnodes,\n\t\t\taggregatorUrl: proxyUrl,\n\t\t\tpublisherUrl: proxyUrl,\n\t\t\tproxyUrl,\n\t\t\texchangeObjectId: state.exchangeObject,\n\t\t\texchange,\n\t\t\twalFaucetStrategy,\n\t\t\twalCoinType: resolvedWalCoinType,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.walrus.localCluster.boot', {\n\t\t\tattributes: {\n\t\t\t\t[SpanAttr.plugin]: 'walrus',\n\t\t\t\t[WalrusSpans.name]: opts.name,\n\t\t\t\t[WalrusSpans.nodeCount]: opts.nodeCount,\n\t\t\t\t[WalrusSpans.shards]: opts.shards,\n\t\t\t},\n\t\t}),\n\t);\n"],"mappings":"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"}

package/dist/plugins/walrus/registry-publish.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"registry-publish.mjs","names":[],"sources":["../../../src/plugins/walrus/registry-publish.ts"],"sourcesContent":["// Walrus registry publish — mode-based registry contribution shapes.\n//\n// This file is the runtime publishing layer for the downstream registries:\n//\n//   - WalrusStateRegistry  — `{name, systemObjectId}` entry. Local\n//                            uses `opts.name`; known uses the fixed\n//                            `'walrusKnownDeployment'`.\n//   - EndpointRegistry     — local publishes `walrus-aggregator` +\n//                            `walrus-publisher` + N × `walrus-node-<i>`.\n//                            Known publishes nothing (the URLs ride\n//                            on the WalrusResolved value).\n//   - PackageRegistry      — local only: `walrus.<name>` entry.\n//\n// Following the package plugin's pattern, contributions land via\n// `StrategyContributor` capability keys; the orchestrator dispatches\n// by key. This file declares the *contribution shapes*; the actual\n// `Register` closures live with the local-cluster acquire path where the resolved\n// values are bound.\n\n/** Capability-key constant for the per-stack Walrus state registry. */\nexport const WALRUS_STATE_REGISTRY_KEY = 'walrus-state-registry' as const;\n\n/** Capability-key constant for the per-stack endpoint registry —\n *  shared across plugins (matches faucet/coin/etc.). */\nexport const ENDPOINT_REGISTRY_KEY = 'endpoint-registry' as const;\n\n/** Capability-key constant for the per-stack package registry —\n *  mirrors `plugins/package/registry.ts`'s\n *  `PACKAGE_REGISTRY_CAPABILITY_KEY` but typed independently here so\n *  Walrus doesn't take a direct dep on the package plugin's internals.\n *  Same string value — substrate dispatches by string equality. */\nexport const PACKAGE_REGISTRY_KEY = 'package-registry' as const;\n\n/** Local-cluster's state registry entry. The `name` field is the\n *  factory's `name` option (default: `'walrus'`); two walrus\n *  instances in one stack publish under disjoint names. */\nexport interface WalrusLocalStateEntry {\n\treadonly name: string;\n\treadonly systemObjectId: string;\n\treadonly stakingObjectId: string;\n\treadonly walrusPackageId: string;\n\treadonly exchangeObjectId?: string;\n}\n\n/** Known-deployment's state registry entry. The `name` is always\n *  `'walrusKnownDeployment'` (distilled-doc invariant: this factory\n *  does not vary by user-supplied name). */\nexport interface WalrusKnownStateEntry {\n\treadonly name: 'walrusKnownDeployment';\n\treadonly systemObjectId: string;\n\treadonly stakingObjectId: string;\n\treadonly chain: string;\n}\n\nexport type WalrusStateEntry = WalrusLocalStateEntry | WalrusKnownStateEntry;\n\n/** Endpoint contribution shape — what the local-cluster publishes\n *  to the endpoint registry. Mirrors the v3 surface:\n *  `walrus-aggregator` + `walrus-publisher` (1 each) +\n *  `walrus-node-<i>` (N). */\nexport interface WalrusEndpointEntry {\n\treadonly name: string;\n\treadonly url: string;\n\treadonly kind: 'http' | 'walrus-node';\n}\n\n/** Package contribution — local-cluster publishes one entry under\n *  `walrus.<name>` with `mvrPlaceholder: '@local/walrus'`.\n *  (Distilled-doc §\"Registry writes\" + Invariant 6: registers fire\n *  on EVERY cycle.) */\nexport interface WalrusPackageEntry {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvrPlaceholder: string;\n\treadonly captured: Readonly<{\n\t\treadonly systemObject: string;\n\t\treadonly stakingObject: string;\n\t\treadonly exchangeObject?: string;\n\t}>;\n}\n"],"mappings":";;AAoBA,MAAa,4BAA4B"}
+{"version":3,"file":"registry-publish.mjs","names":[],"sources":["../../../src/plugins/walrus/registry-publish.ts"],"sourcesContent":["// Walrus registry publish — mode-based registry contribution shapes.\n//\n// This file is the runtime publishing layer for the downstream registries:\n//\n//   - WalrusStateRegistry  — `{name, systemObjectId}` entry. Local\n//                            uses `opts.name`; known uses the fixed\n//                            `'walrusKnownDeployment'`.\n//   - EndpointRegistry     — local publishes `walrus-aggregator` +\n//                            `walrus-publisher` + N × `walrus-node-<i>`.\n//                            Known publishes nothing (the URLs ride\n//                            on the WalrusResolved value).\n//   - PackageRegistry      — local only: `walrus.<name>` entry.\n//\n// Following the package plugin's pattern, contributions land via\n// `StrategyContributor` capability keys; the orchestrator dispatches\n// by key. This file declares the *contribution shapes*; the actual\n// `Register` closures live with the local-cluster acquire path where the resolved\n// values are bound.\n\n/** Capability-key constant for the per-stack Walrus state registry. */\nexport const WALRUS_STATE_REGISTRY_KEY = 'walrus-state-registry' as const;\n\n/** Capability-key constant for the per-stack endpoint registry —\n *  shared across plugins (matches faucet/coin/etc.). */\nexport const ENDPOINT_REGISTRY_KEY = 'endpoint-registry' as const;\n\n/** Capability-key constant for the per-stack package registry —\n *  mirrors `plugins/package/registry.ts`'s\n *  `PACKAGE_REGISTRY_CAPABILITY_KEY` but typed independently here so\n *  Walrus doesn't take a direct dep on the package plugin's internals.\n *  Same string value — substrate dispatches by string equality. */\nexport const PACKAGE_REGISTRY_KEY = 'package-registry' as const;\n\n/** Local-cluster's state registry entry. The `name` field is the\n *  factory's `name` option (default: `'walrus'`); two walrus\n *  instances in one stack publish under disjoint names. */\nexport interface WalrusLocalStateEntry {\n\treadonly name: string;\n\treadonly systemObjectId: string;\n\treadonly stakingObjectId: string;\n\treadonly walrusPackageId: string;\n\treadonly exchangeObjectId?: string;\n}\n\n/** Known-deployment's state registry entry. The `name` is always\n *  `'walrusKnownDeployment'` (distilled-doc invariant: this factory\n *  does not vary by user-supplied name). */\nexport interface WalrusKnownStateEntry {\n\treadonly name: 'walrusKnownDeployment';\n\treadonly systemObjectId: string;\n\treadonly stakingObjectId: string;\n\treadonly chain: string;\n}\n\nexport type WalrusStateEntry = WalrusLocalStateEntry | WalrusKnownStateEntry;\n"],"mappings":";;AAoBA,MAAa,4BAA4B"}

package/dist/plugins/walrus/routable.mjs

@@ -1,38 +1,22 @@
-import "./storage-nodes.mjs";
+import { WALRUS_ROUTER_PORT } from "./storage-nodes.mjs";
 //#region src/plugins/walrus/routable.ts
-const WALRUS_ENTRYPOINT_PORT = 9185;
 const WALRUS_NODE_ENDPOINT_PREFIX = "walrus-node-";
 const WALRUS_AGGREGATOR_ENDPOINT_NAME = "walrus-aggregator";
 const WALRUS_PUBLISHER_ENDPOINT_NAME = "walrus-publisher";
 const WALRUS_ENTRYPOINTS = [
-	{
-		name: "walrus-node-0",
-		port: WALRUS_ENTRYPOINT_PORT,
-		protocol: "http"
-	},
-	{
-		name: "walrus-node-1",
-		port: WALRUS_ENTRYPOINT_PORT,
+	...Array.from({ length: 8 }, (_, i) => ({
+		name: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,
+		port: WALRUS_ROUTER_PORT,
 		protocol: "http"
-	},
-	{
-		name: "walrus-node-2",
-		port: WALRUS_ENTRYPOINT_PORT,
-		protocol: "http"
-	},
-	{
-		name: "walrus-node-3",
-		port: WALRUS_ENTRYPOINT_PORT,
-		protocol: "http"
-	},
+	})),
 	{
 		name: WALRUS_AGGREGATOR_ENDPOINT_NAME,
-		port: WALRUS_ENTRYPOINT_PORT,
+		port: WALRUS_ROUTER_PORT,
 		protocol: "http"
 	},
 	{
 		name: WALRUS_PUBLISHER_ENDPOINT_NAME,
-		port: WALRUS_ENTRYPOINT_PORT,
+		port: WALRUS_ROUTER_PORT,
 		protocol: "http"
 	}
 ];

package/dist/plugins/walrus/routable.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/walrus/routable.ts"],"sourcesContent":["// Walrus plugin — Routable contributions.\n//\n// Distilled-doc reference (06-walrus.md §\"Routes registered\"):\n// each storage node carries one Traefik route. The router binds host\n// port 9185 once globally and dispatches by `Host:` header to the\n// per-stack backend — `routerHostname(identity, 'walrus-node-<i>')`.\n//\n// For the local cluster:\n//   - N × `walrus-node-<i>` routes — one per storage node, with\n//     `cors: true` (walrus storage REST API lacks CORS headers).\n//   - 1 × `walrus-aggregator` alias — same backend as `walrus-node-0`,\n//     surfaces the conventional alias for SDK consumers.\n//   - 1 × `walrus-publisher` alias — collapsed onto the same backend\n//     (distilled-doc §\"Endpoints\" — \"collapsed onto a single Traefik\n//     vhost\").\n//\n// Known-deployment publishes no routes — the aggregator/publisher\n// URLs land on the codegen-emitted `WalrusBindings.{aggregator,\n// publisher}Url` instead.\n\nimport type { EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\nimport { WALRUS_ROUTER_PORT } from './storage-nodes.ts';\n\nexport const WALRUS_ENTRYPOINT_PORT = 9185;\nexport const WALRUS_NODE_ENDPOINT_PREFIX = 'walrus-node-' as const;\nexport const WALRUS_AGGREGATOR_ENDPOINT_NAME = 'walrus-aggregator' as const;\nexport const WALRUS_PUBLISHER_ENDPOINT_NAME = 'walrus-publisher' as const;\n\nexport const WALRUS_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t{ name: 'walrus-node-0', port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n\t{ name: 'walrus-node-1', port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n\t{ name: 'walrus-node-2', port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n\t{ name: 'walrus-node-3', port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n\t{ name: WALRUS_AGGREGATOR_ENDPOINT_NAME, port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n\t{ name: WALRUS_PUBLISHER_ENDPOINT_NAME, port: WALRUS_ENTRYPOINT_PORT, protocol: 'http' },\n];\n\n/** Build the Routable contributions for the local cluster. `nodeCount`\n *  drives the per-node fan-out; the plugin's service key + route role\n *  identify the dispatch target. */\nexport const makeLocalRoutables = (args: {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly walrusName: string;\n\treadonly serviceKey: string;\n\treadonly nodeCount: number;\n\treadonly containerApiPort?: number;\n}): ReadonlyArray<RoutableDecl> => {\n\tconst containerPort = args.containerApiPort ?? WALRUS_ROUTER_PORT;\n\tconst containerNameFor = (i: number): string =>\n\t\t`devstack-${args.app}-${args.stack}-walrus-${args.walrusName}-node-${i}`;\n\tconst perNodeRoutes: ReadonlyArray<RoutableDecl> = Array.from(\n\t\t{ length: args.nodeCount },\n\t\t(_, i): RoutableDecl => ({\n\t\t\tkind: 'routable',\n\t\t\tendpointName: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,\n\t\t\tdispatchId: {\n\t\t\t\tserviceKey: args.serviceKey,\n\t\t\t\trole: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,\n\t\t\t},\n\t\t\tupstream: {\n\t\t\t\ttype: 'container',\n\t\t\t\tcontainerName: containerNameFor(i),\n\t\t\t\tcontainerPort,\n\t\t\t},\n\t\t\t// Distilled-doc §\"Routes registered\": cors: true (walrus\n\t\t\t// storage REST API lacks CORS headers).\n\t\t\tcors: true,\n\t\t\twireProtocol: 'http',\n\t\t}),\n\t);\n\n\t// Aggregator + publisher aliases — collapsed onto node-0 per the\n\t// distilled doc. The aggregator and publisher are conventional\n\t// endpoint names that downstream HTTP consumers look up via the\n\t// substrate's endpoint registry.\n\tconst aggregator: RoutableDecl = {\n\t\tkind: 'routable',\n\t\tendpointName: WALRUS_AGGREGATOR_ENDPOINT_NAME,\n\t\tdispatchId: {\n\t\t\tserviceKey: args.serviceKey,\n\t\t\trole: WALRUS_AGGREGATOR_ENDPOINT_NAME,\n\t\t},\n\t\tupstream: { type: 'container', containerName: containerNameFor(0), containerPort },\n\t\tcors: true,\n\t\twireProtocol: 'http',\n\t};\n\tconst publisher: RoutableDecl = {\n\t\tkind: 'routable',\n\t\tendpointName: WALRUS_PUBLISHER_ENDPOINT_NAME,\n\t\tdispatchId: {\n\t\t\tserviceKey: args.serviceKey,\n\t\t\trole: WALRUS_PUBLISHER_ENDPOINT_NAME,\n\t\t},\n\t\tupstream: { type: 'container', containerName: containerNameFor(0), containerPort },\n\t\tcors: true,\n\t\twireProtocol: 'http',\n\t};\n\n\treturn [...perNodeRoutes, aggregator, publisher];\n};\n"],"mappings":";;AAuBA,MAAa,yBAAyB;AACtC,MAAa,8BAA8B;AAC3C,MAAa,kCAAkC;AAC/C,MAAa,iCAAiC;AAE9C,MAAa,qBAAoD;CAChE;EAAE,MAAM;EAAiB,MAAM;EAAwB,UAAU;EAAQ;CACzE;EAAE,MAAM;EAAiB,MAAM;EAAwB,UAAU;EAAQ;CACzE;EAAE,MAAM;EAAiB,MAAM;EAAwB,UAAU;EAAQ;CACzE;EAAE,MAAM;EAAiB,MAAM;EAAwB,UAAU;EAAQ;CACzE;EAAE,MAAM;EAAiC,MAAM;EAAwB,UAAU;EAAQ;CACzF;EAAE,MAAM;EAAgC,MAAM;EAAwB,UAAU;EAAQ;CACxF;;;;AAKD,MAAa,sBAAsB,SAOA;CAClC,MAAM,gBAAgB,KAAK,oBAAA;CAC3B,MAAM,oBAAoB,MACzB,YAAY,KAAK,IAAI,GAAG,KAAK,MAAM,UAAU,KAAK,WAAW,QAAQ;CACtE,MAAM,gBAA6C,MAAM,KACxD,EAAE,QAAQ,KAAK,WAAW,GACzB,GAAG,OAAqB;EACxB,MAAM;EACN,cAAc,GAAG,8BAA8B;EAC/C,YAAY;GACX,YAAY,KAAK;GACjB,MAAM,GAAG,8BAA8B;GACvC;EACD,UAAU;GACT,MAAM;GACN,eAAe,iBAAiB,EAAE;GAClC;GACA;EAGD,MAAM;EACN,cAAc;EACd,EACD;CAMD,MAAM,aAA2B;EAChC,MAAM;EACN,cAAc;EACd,YAAY;GACX,YAAY,KAAK;GACjB,MAAM;GACN;EACD,UAAU;GAAE,MAAM;GAAa,eAAe,iBAAiB,EAAE;GAAE;GAAe;EAClF,MAAM;EACN,cAAc;EACd;CACD,MAAM,YAA0B;EAC/B,MAAM;EACN,cAAc;EACd,YAAY;GACX,YAAY,KAAK;GACjB,MAAM;GACN;EACD,UAAU;GAAE,MAAM;GAAa,eAAe,iBAAiB,EAAE;GAAE;GAAe;EAClF,MAAM;EACN,cAAc;EACd;AAED,QAAO;EAAC,GAAG;EAAe;EAAY;EAAU"}
+{"version":3,"file":"routable.mjs","names":[],"sources":["../../../src/plugins/walrus/routable.ts"],"sourcesContent":["// Walrus plugin — Routable contributions.\n//\n// Distilled-doc reference (06-walrus.md §\"Routes registered\"):\n// each storage node carries one Traefik route. The router binds host\n// port 9185 once globally and dispatches by `Host:` header to the\n// per-stack backend — `routerHostname(identity, 'walrus-node-<i>')`.\n//\n// For the local cluster:\n//   - N × `walrus-node-<i>` routes — one per storage node, with\n//     `cors: true` (walrus storage REST API lacks CORS headers).\n//   - 1 × `walrus-aggregator` alias — same backend as `walrus-node-0`,\n//     surfaces the conventional alias for SDK consumers.\n//   - 1 × `walrus-publisher` alias — collapsed onto the same backend\n//     (distilled-doc §\"Endpoints\" — \"collapsed onto a single Traefik\n//     vhost\").\n//\n// Known-deployment publishes no routes — the aggregator/publisher\n// URLs land on the codegen-emitted `WalrusBindings.{aggregator,\n// publisher}Url` instead.\n\nimport type { EntrypointDecl, RoutableDecl } from '../../contracts/routable.ts';\nimport { WALRUS_ROUTER_PORT } from './storage-nodes.ts';\n\nexport const WALRUS_NODE_ENDPOINT_PREFIX = 'walrus-node-' as const;\nexport const WALRUS_AGGREGATOR_ENDPOINT_NAME = 'walrus-aggregator' as const;\nexport const WALRUS_PUBLISHER_ENDPOINT_NAME = 'walrus-publisher' as const;\n\n/** Upper bound on `nodeCount` — Traefik entrypoints are bound at boot,\n *  so the cluster's per-node routes need pre-declared entrypoint names.\n *  Validated at factory time in `mode/local-cluster.ts:resolveOptions`. */\nexport const WALRUS_MAX_NODE_COUNT = 8;\n\nexport const WALRUS_ENTRYPOINTS: ReadonlyArray<EntrypointDecl> = [\n\t...Array.from(\n\t\t{ length: WALRUS_MAX_NODE_COUNT },\n\t\t(_, i): EntrypointDecl => ({\n\t\t\tname: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,\n\t\t\tport: WALRUS_ROUTER_PORT,\n\t\t\tprotocol: 'http',\n\t\t}),\n\t),\n\t{ name: WALRUS_AGGREGATOR_ENDPOINT_NAME, port: WALRUS_ROUTER_PORT, protocol: 'http' },\n\t{ name: WALRUS_PUBLISHER_ENDPOINT_NAME, port: WALRUS_ROUTER_PORT, protocol: 'http' },\n];\n\n/** Build the Routable contributions for the local cluster. `nodeCount`\n *  drives the per-node fan-out; the plugin's service key + route role\n *  identify the dispatch target. */\nexport const makeLocalRoutables = (args: {\n\treadonly app: string;\n\treadonly stack: string;\n\treadonly walrusName: string;\n\treadonly serviceKey: string;\n\treadonly nodeCount: number;\n\treadonly containerApiPort?: number;\n}): ReadonlyArray<RoutableDecl> => {\n\tconst containerPort = args.containerApiPort ?? WALRUS_ROUTER_PORT;\n\tconst containerNameFor = (i: number): string =>\n\t\t`devstack-${args.app}-${args.stack}-walrus-${args.walrusName}-node-${i}`;\n\tconst perNodeRoutes: ReadonlyArray<RoutableDecl> = Array.from(\n\t\t{ length: args.nodeCount },\n\t\t(_, i): RoutableDecl => ({\n\t\t\tkind: 'routable',\n\t\t\tendpointName: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,\n\t\t\tdispatchId: {\n\t\t\t\tserviceKey: args.serviceKey,\n\t\t\t\trole: `${WALRUS_NODE_ENDPOINT_PREFIX}${i}`,\n\t\t\t},\n\t\t\tupstream: {\n\t\t\t\ttype: 'container',\n\t\t\t\tcontainerName: containerNameFor(i),\n\t\t\t\tcontainerPort,\n\t\t\t},\n\t\t\t// Distilled-doc §\"Routes registered\": cors: true (walrus\n\t\t\t// storage REST API lacks CORS headers).\n\t\t\tcors: true,\n\t\t\twireProtocol: 'http',\n\t\t}),\n\t);\n\n\t// Aggregator + publisher aliases — collapsed onto node-0 per the\n\t// distilled doc. The aggregator and publisher are conventional\n\t// endpoint names that downstream HTTP consumers look up via the\n\t// substrate's endpoint registry.\n\tconst aggregator: RoutableDecl = {\n\t\tkind: 'routable',\n\t\tendpointName: WALRUS_AGGREGATOR_ENDPOINT_NAME,\n\t\tdispatchId: {\n\t\t\tserviceKey: args.serviceKey,\n\t\t\trole: WALRUS_AGGREGATOR_ENDPOINT_NAME,\n\t\t},\n\t\tupstream: { type: 'container', containerName: containerNameFor(0), containerPort },\n\t\tcors: true,\n\t\twireProtocol: 'http',\n\t};\n\tconst publisher: RoutableDecl = {\n\t\tkind: 'routable',\n\t\tendpointName: WALRUS_PUBLISHER_ENDPOINT_NAME,\n\t\tdispatchId: {\n\t\t\tserviceKey: args.serviceKey,\n\t\t\trole: WALRUS_PUBLISHER_ENDPOINT_NAME,\n\t\t},\n\t\tupstream: { type: 'container', containerName: containerNameFor(0), containerPort },\n\t\tcors: true,\n\t\twireProtocol: 'http',\n\t};\n\n\treturn [...perNodeRoutes, aggregator, publisher];\n};\n"],"mappings":";;AAuBA,MAAa,8BAA8B;AAC3C,MAAa,kCAAkC;AAC/C,MAAa,iCAAiC;AAO9C,MAAa,qBAAoD;CAChE,GAAG,MAAM,KACR,EAAE,QAAA,GAA+B,GAChC,GAAG,OAAuB;EAC1B,MAAM,GAAG,8BAA8B;EACvC,MAAM;EACN,UAAU;EACV,EACD;CACD;EAAE,MAAM;EAAiC,MAAM;EAAoB,UAAU;EAAQ;CACrF;EAAE,MAAM;EAAgC,MAAM;EAAoB,UAAU;EAAQ;CACpF;;;;AAKD,MAAa,sBAAsB,SAOA;CAClC,MAAM,gBAAgB,KAAK,oBAAA;CAC3B,MAAM,oBAAoB,MACzB,YAAY,KAAK,IAAI,GAAG,KAAK,MAAM,UAAU,KAAK,WAAW,QAAQ;CACtE,MAAM,gBAA6C,MAAM,KACxD,EAAE,QAAQ,KAAK,WAAW,GACzB,GAAG,OAAqB;EACxB,MAAM;EACN,cAAc,GAAG,8BAA8B;EAC/C,YAAY;GACX,YAAY,KAAK;GACjB,MAAM,GAAG,8BAA8B;GACvC;EACD,UAAU;GACT,MAAM;GACN,eAAe,iBAAiB,EAAE;GAClC;GACA;EAGD,MAAM;EACN,cAAc;EACd,EACD;CAMD,MAAM,aAA2B;EAChC,MAAM;EACN,cAAc;EACd,YAAY;GACX,YAAY,KAAK;GACjB,MAAM;GACN;EACD,UAAU;GAAE,MAAM;GAAa,eAAe,iBAAiB,EAAE;GAAE;GAAe;EAClF,MAAM;EACN,cAAc;EACd;CACD,MAAM,YAA0B;EAC/B,MAAM;EACN,cAAc;EACd,YAAY;GACX,YAAY,KAAK;GACjB,MAAM;GACN;EACD,UAAU;GAAE,MAAM;GAAa,eAAe,iBAAiB,EAAE;GAAE;GAAe;EAClF,MAAM;EACN,cAAc;EACd;AAED,QAAO;EAAC,GAAG;EAAe;EAAY;EAAU"}

package/dist/plugins/walrus/service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/walrus/service.ts"],"sourcesContent":["// Walrus plugin — main acquire body. Mode dispatch.\n//\n// Distilled-doc reference (06-walrus.md §\"Modes & variants\" — four\n// distinct operating modes):\n//\n//   - local                       — `walrusLocalCluster(...)`\n//   - live (testnet/mainnet)      — `walrusKnownDeployment(...)`\n//   - fork-known (`*-fork`)       — known-deployment wrapper for the\n//                                    wrapped upstream\n//   - fork-localcluster-refused   — synchronous refusal at factory\n//                                    time\n//\n// Architecture: Walrus is ONE plugin with internal mode dispatch.\n// The factory at the barrel (`index.ts`) constructs the discriminator\n// from typed options; this file dispatches on the discriminator and\n// assembles mode-appropriate\n// subsystems.\n//\n// What this file does:\n//\n//   1. Receive a resolved mode discriminator.\n//   2. Dispatch to the right `boot*` builder.\n//   3. Return the mode's boot artifacts (the barrel projects them\n//      onto the plugin's resolved value).\n//\n// What it does NOT do:\n//\n//   - Provision the container runtime — that arrives via the\n//     `BuildContext` passed by the barrel.\n//   - Resolve bootstrap assets — local-cluster mode owns those\n//     resolvers; this file just dispatches.\n\nimport { Effect, FileSystem, Path, type Scope } from 'effect';\n\nimport type { ArtifactPublishError } from '../../primitives/artifact-publisher.ts';\nimport type { WalrusError } from './errors.ts';\nimport {\n\tbootKnownDeployment,\n\ttype KnownDeploymentBootResult,\n\ttype WalrusKnownDeploymentOptions,\n} from './mode/known-deploy.ts';\nimport {\n\tbootLocalCluster,\n\ttype LocalClusterBootResult,\n\ttype LocalClusterDeps,\n\ttype ResolvedLocalClusterOptions,\n} from './mode/local-cluster.ts';\nimport { refuseLocalClusterOnFork } from './mode/fork-refusal.ts';\n\n/** Mode discriminator. Internal — the barrel constructs ONE of these\n *  per composed walrus instance and dispatches here. */\nexport type WalrusMode =\n\t| { readonly mode: 'local'; readonly opts: ResolvedLocalClusterOptions }\n\t| { readonly mode: 'known'; readonly opts: WalrusKnownDeploymentOptions };\n\n/** Result of one acquire — discriminated by mode so the barrel can\n *  project mode-asymmetrically onto the tag set. */\nexport type WalrusBootResult = LocalClusterBootResult | KnownDeploymentBootResult;\n\n/** Dispatch on the mode and return the boot artifacts.\n *\n *  `deps` is the local-cluster's full dependency bundle. The known\n *  branch ignores all of it (no I/O at acquire time — purely\n *  synchronous projection from options); the type lets the barrel\n *  pass one record for both paths. */\nexport const bootWalrusService = (\n\tdeps: LocalClusterDeps,\n\tmode: WalrusMode,\n): Effect.Effect<\n\tWalrusBootResult,\n\tWalrusError | ArtifactPublishError,\n\tScope.Scope | FileSystem.FileSystem | Path.Path\n> => {\n\tswitch (mode.mode) {\n\t\tcase 'local':\n\t\t\treturn bootLocalCluster(deps, mode.opts);\n\t\tcase 'known':\n\t\t\treturn bootKnownDeployment(mode.opts);\n\t}\n};\n\n// Re-export so callers (the barrel's `walrus()` factory's fork\n// branch) can invoke the refusal directly without an extra import.\nexport { refuseLocalClusterOnFork };\n"],"mappings":";;;;;;;;;;AAiEA,MAAa,qBACZ,MACA,SAKI;AACJ,SAAQ,KAAK,MAAb;EACC,KAAK,QACJ,QAAO,iBAAiB,MAAM,KAAK,KAAK;EACzC,KAAK,QACJ,QAAO,oBAAoB,KAAK,KAAK"}
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/walrus/service.ts"],"sourcesContent":["// Walrus plugin — main acquire body. Mode dispatch.\n//\n// Distilled-doc reference (06-walrus.md §\"Modes & variants\" — four\n// distinct operating modes):\n//\n//   - local                       — `walrusLocalCluster(...)`\n//   - live (testnet/mainnet)      — `walrusKnownDeployment(...)`\n//   - fork-known (`*-fork`)       — known-deployment wrapper for the\n//                                    wrapped upstream\n//   - fork-localcluster-refused   — synchronous refusal at factory\n//                                    time\n//\n// Architecture: Walrus is ONE plugin with internal mode dispatch.\n// The factory at the barrel (`index.ts`) constructs the discriminator\n// from typed options; this file dispatches on the discriminator and\n// assembles mode-appropriate\n// subsystems.\n//\n// What this file does:\n//\n//   1. Receive a resolved mode discriminator.\n//   2. Dispatch to the right `boot*` builder.\n//   3. Return the mode's boot artifacts (the barrel projects them\n//      onto the plugin's resolved value).\n//\n// What it does NOT do:\n//\n//   - Provision the container runtime — that arrives via the\n//     `BuildContext` passed by the barrel.\n//   - Resolve bootstrap assets — local-cluster mode owns those\n//     resolvers; this file just dispatches.\n\nimport { Effect, FileSystem, Path, type Scope } from 'effect';\n\nimport type { ArtifactPublishError } from '../../primitives/artifact-publisher.ts';\nimport type { WalrusError } from './errors.ts';\nimport {\n\tbootKnownDeployment,\n\ttype KnownDeploymentBootResult,\n\ttype WalrusKnownDeploymentOptions,\n} from './mode/known-deploy.ts';\nimport {\n\tbootLocalCluster,\n\ttype LocalClusterBootResult,\n\ttype LocalClusterDeps,\n\ttype ResolvedLocalClusterOptions,\n} from './mode/local-cluster.ts';\n\n/** Mode discriminator. Internal — the barrel constructs ONE of these\n *  per composed walrus instance and dispatches here. */\nexport type WalrusMode =\n\t| { readonly mode: 'local'; readonly opts: ResolvedLocalClusterOptions }\n\t| { readonly mode: 'known'; readonly opts: WalrusKnownDeploymentOptions };\n\n/** Result of one acquire — discriminated by mode so the barrel can\n *  project mode-asymmetrically onto the tag set. */\nexport type WalrusBootResult = LocalClusterBootResult | KnownDeploymentBootResult;\n\n/** Dispatch on the mode and return the boot artifacts.\n *\n *  `deps` is the local-cluster's full dependency bundle. The known\n *  branch ignores all of it (no I/O at acquire time — purely\n *  synchronous projection from options); the type lets the barrel\n *  pass one record for both paths. */\nexport const bootWalrusService = (\n\tdeps: LocalClusterDeps,\n\tmode: WalrusMode,\n): Effect.Effect<\n\tWalrusBootResult,\n\tWalrusError | ArtifactPublishError,\n\tScope.Scope | FileSystem.FileSystem | Path.Path\n> => {\n\tswitch (mode.mode) {\n\t\tcase 'local':\n\t\t\treturn bootLocalCluster(deps, mode.opts);\n\t\tcase 'known':\n\t\t\treturn bootKnownDeployment(mode.opts);\n\t}\n};\n"],"mappings":";;;;;;;;;;AAgEA,MAAa,qBACZ,MACA,SAKI;AACJ,SAAQ,KAAK,MAAb;EACC,KAAK,QACJ,QAAO,iBAAiB,MAAM,KAAK,KAAK;EACzC,KAAK,QACJ,QAAO,oBAAoB,KAAK,KAAK"}

package/dist/plugins/walrus/spans.mjs

@@ -0,0 +1,18 @@
+//#region src/plugins/walrus/spans.ts
+const WalrusSpans = {
+	chain: "walrus.chain",
+	committeeSize: "walrus.committeeSize",
+	fundAccount: "walrus.fund.account",
+	fundAddress: "walrus.fund.address",
+	fundExchange: "walrus.fund.exchange",
+	name: "walrus.name",
+	node: "walrus.node",
+	nodeCount: "walrus.nodeCount",
+	ref: "walrus.ref",
+	shards: "walrus.shards",
+	suiVersion: "walrus.suiVersion"
+};
+//#endregion
+export { WalrusSpans };
+
+//# sourceMappingURL=spans.mjs.map

package/dist/plugins/walrus/spans.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.mjs","names":[],"sources":["../../../src/plugins/walrus/spans.ts"],"sourcesContent":["// Walrus plugin span-attribute vocabulary. Plugin-local — substrate's\n// `SpanAttr` carries only engine-dimensional + http/process generic\n// keys; plugin-domain keys live next to the plugin that owns them.\n//\n// Callsite pattern: `Effect.annotateCurrentSpan({ [WalrusSpans.name]:\n// value })`. Free-form string literals are a STYLE_GUIDE §16 violation.\n\nexport const WalrusSpans = {\n\tchain: 'walrus.chain',\n\tcommitteeSize: 'walrus.committeeSize',\n\tfundAccount: 'walrus.fund.account',\n\tfundAddress: 'walrus.fund.address',\n\tfundExchange: 'walrus.fund.exchange',\n\tname: 'walrus.name',\n\tnode: 'walrus.node',\n\tnodeCount: 'walrus.nodeCount',\n\tref: 'walrus.ref',\n\tshards: 'walrus.shards',\n\tsuiVersion: 'walrus.suiVersion',\n} as const;\n"],"mappings":";AAOA,MAAa,cAAc;CAC1B,OAAO;CACP,eAAe;CACf,aAAa;CACb,aAAa;CACb,cAAc;CACd,MAAM;CACN,MAAM;CACN,WAAW;CACX,KAAK;CACL,QAAQ;CACR,YAAY;CACZ"}

package/dist/plugins/walrus/storage-nodes.d.mts

@@ -2,11 +2,15 @@ import { Effect, Scope } from "effect";
 
 //#region src/plugins/walrus/storage-nodes.d.ts
 /** Per-node descriptor — what the plugin resolved value surfaces
- *  for downstream consumers (the `@mysten/walrus` SDK reads this). */
+ *  for downstream consumers (the `@mysten/walrus` SDK reads this).
+ *
+ *  Note: no `publicKey` field. The per-node BLS12-381 keypair lives
+ *  inside the per-node keystore the deploy one-shot emitted; the SDK
+ *  consumer reads the public key off `packageConfig` rather than this
+ *  routing-handle descriptor. */
 interface WalrusStorageNode {
   readonly nodeIndex: number;
   readonly nodeId: string;
-  readonly publicKey: string;
   readonly publicHostname: string;
   readonly rpcUrl: string;
 }