@mysten-incubation/devstack 0.0.1 → 0.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/sui/index.ts"],"sourcesContent":["// Sui plugin — barrel + factories.\n//\n// Architecture: Sui is the most-depended-on plugin in the stack.\n// Every consumer (Account/Coin/Wallet/Faucet/Package; Walrus/Seal/\n// Deepbook fork variants) reads its resolved `SuiClient` via the\n// `suiResource`. The factory at this file folds the four modes behind:\n//\n//   - `sui(opts?)`         — local shorthand. Defaults to an in-stack\n//                              local validator; pass a typed `opts`\n//                              record to select a different mode.\n//   - `suiFor(network)`    — mode-narrowed factory namespace (per\n//                              architecture Tension 11). Returns\n//                              `{ local: …, live: …, fork: … }`\n//                              narrowed to the network's mode.\n//\n// The plugin emits FIVE capability decls:\n//\n//   1. `chain-probe:<chainId>` strategy contributor — the\n//      schema-validated read surface (`makeSuiChainProbe`).\n//   2. `gate:funds-ready` strategy contributor — the funds-\n//      transferable gate. No-op on faucet-less networks.\n//   3. `sui:seed-objects` strategy contributor — the per-instance\n//      seed-objects accumulator (fork mode only; emits an empty\n//      accumulator on other modes for shape uniformity).\n//   4. Snapshotable — mode-aware container + bind-mount capture.\n//   5. Codegenable — `sui-network` bindings (chain id, rpc, etc.).\n//\n// Routable contributions are MODE-DEPENDENT (local + fork yes;\n// local-rpc + live no — the caller fronts their own RPC). They land\n// in the per-mode builder under `mode/*.ts`; this barrel composes\n// them into the plugin capability array.\n\nimport { Effect } from 'effect';\n\nimport { defineModeNamespace } from '../../api/mode-narrowed-factory.ts';\nimport { definePlugin, resource } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport type { ChainProbe } from '../../contracts/chain-probe.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport { FUNDS_READY_GATE_KEY } from '../../contracts/network-resolver.ts';\nimport type { AcquireContext } from '../../substrate/plugin.ts';\n\nimport { chainProbeCapabilityKey } from '../../contracts/chain-probe.ts';\nimport { ContainerRuntimeService } from '../../runtime/docker/service.ts';\nimport { IdentityContext, StackPathsService } from '../../substrate/runtime/paths.ts';\nimport {\n\tLeaseBrokerService,\n\ttype LeaseBroker,\n} from '../../substrate/runtime/lease-broker/index.ts';\nimport { PortBrokerService } from '../../substrate/runtime/port-broker/index.ts';\nimport { makeCodegenable } from './codegen.ts';\nimport type { SuiProbeKey } from './chain-probe.ts';\nimport { makeSnapshotable } from './snapshot.ts';\nimport {\n\tmakeSeedObjectsAccumulator,\n\tSEED_OBJECTS_CAPABILITY_KEY,\n\ttype SeedObjectsAccumulator,\n} from './seed-objects.ts';\nimport { bootSuiService } from './service.ts';\nimport { SUI_ERROR_TAGS, type SuiPluginError } from './errors.ts';\nimport { makeSuiForkRoutables, makeSuiLocalRoutables } from './routable.ts';\nimport { faucetCapabilityKey } from '../faucet/dispatcher.ts';\nimport { suiLocalStrategy } from '../faucet/strategies/sui-local.ts';\nimport type { SuiClient } from './mode/shared.ts';\nimport type {\n\tSuiForkOptions,\n\tSuiLiveOptions,\n\tSuiLocalRpcOptions,\n\tSuiLocalOptions,\n\tSuiOptions,\n} from './mode/spec.ts';\n\n// ---------------------------------------------------------------------------\n// Resource identity\n// ---------------------------------------------------------------------------\n\ntype SuiResolved = SuiClient & {\n\treadonly mode: SuiOptions['mode'];\n\treadonly seedObjects: SeedObjectsAccumulator;\n};\n\nconst fundingFaucetLeaseBrokerSymbol: unique symbol = Symbol(\n\t'@mysten-incubation/devstack/sui/fundingFaucetLeaseBroker',\n);\n\ntype SuiResolvedRuntime = SuiResolved & {\n\treadonly [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;\n};\n\n/** The Sui plugin's resource identity. The id is `'sui'` (singular). */\nexport const suiResource = resource<'sui', SuiResolved>('sui');\nconst suiErrorContributions = pluginErrorContributions(SUI_ERROR_TAGS);\n\n// ---------------------------------------------------------------------------\n// Plugin construction (internal — used by sui() + suiFor())\n// ---------------------------------------------------------------------------\n\nconst buildPlugin = (opts: SuiOptions) => {\n\treturn definePlugin({\n\t\tid: suiResource.id,\n\t\trole: 'service',\n\t\tstart: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\t// The substrate threads `ContainerRuntime` + `IdentityContext`\n\t\t\t\t// via the plugin runtime context; the supervisor provides\n\t\t\t\t// these before this body runs.\n\t\t\t\tconst runtime = yield* ContainerRuntimeService;\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst paths = yield* StackPathsService;\n\t\t\t\tconst portBroker = yield* PortBrokerService;\n\t\t\t\tconst fundingFaucetLeaseBroker = yield* LeaseBrokerService;\n\t\t\t\tconst { client } = yield* bootSuiService(runtime, identity, portBroker, paths, opts);\n\n\t\t\t\tconst seedObjects = yield* makeSeedObjectsAccumulator();\n\t\t\t\treturn {\n\t\t\t\t\t...client,\n\t\t\t\t\tmode: opts.mode,\n\t\t\t\t\tseedObjects,\n\t\t\t\t\t[fundingFaucetLeaseBrokerSymbol]: fundingFaucetLeaseBroker,\n\t\t\t\t} satisfies SuiResolvedRuntime;\n\t\t\t}),\n\t\tcapabilities: ({ value, runtime }) => makePluginCapabilities(opts, value, runtime),\n\t\terrorContributions: suiErrorContributions,\n\t});\n};\n\n/** Construct the capability tuple POST-acquire. Receives the resolved\n *  `SuiClient` + acquire context so decls can stamp REAL chain ids /\n *  rpc URLs into their fields instead of factory-time placeholders.\n *\n *  StrategyContributor declarations here carry real post-acquire\n *  strategy values. The generic strategy sink registers them on the\n *  scope-local `StrategyRegistry`. */\nconst makePluginCapabilities = (\n\topts: SuiOptions,\n\tresolved: SuiResolved,\n\tacquireCtx: AcquireContext,\n) => {\n\tconst realChain = resolved.chain;\n\tconst resolvedRuntime = resolved as SuiResolvedRuntime;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\topts.mode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\trealChain,\n\t);\n\tconst codegen: CodegenableDecl<'sui-network'> = makeCodegenable({\n\t\tmode: opts.mode,\n\t\tchain: realChain,\n\t\trpc: resolved.rpcUrl,\n\t\tsource: 'default',\n\t\t...(resolved.faucetUrl !== null ? { faucet: resolved.faucetUrl } : {}),\n\t\t...(resolved.graphqlUrl !== null ? { graphql: resolved.graphqlUrl } : {}),\n\t});\n\n\tconst chainProbeContribution: StrategyContributorDecl<\n\t\t`chain-probe:${string}`,\n\t\tChainProbe<SuiProbeKey>\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: chainProbeCapabilityKey(realChain),\n\t\tstrategy: resolved.chainProbe,\n\t\tautoMounted: true,\n\t};\n\n\tconst fundsReadyContribution: StrategyContributorDecl<\n\t\ttypeof FUNDS_READY_GATE_KEY,\n\t\t{\n\t\t\treadonly waitFundsReady: Effect.Effect<void, SuiPluginError>;\n\t\t}\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: FUNDS_READY_GATE_KEY,\n\t\tstrategy: { waitFundsReady: resolved.waitForTransactionsReady.wait },\n\t\tautoMounted: true,\n\t};\n\n\tconst seedObjectsContribution: StrategyContributorDecl<\n\t\ttypeof SEED_OBJECTS_CAPABILITY_KEY,\n\t\tSeedObjectsAccumulator\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: SEED_OBJECTS_CAPABILITY_KEY,\n\t\tstrategy: resolved.seedObjects,\n\t\tautoMounted: true,\n\t};\n\n\tconst faucetContribution =\n\t\tresolved.fundingFaucetUrl === 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: faucetCapabilityKey(realChain),\n\t\t\t\t\t\tstrategy: suiLocalStrategy({\n\t\t\t\t\t\t\tfaucetUrl: resolved.fundingFaucetUrl,\n\t\t\t\t\t\t\tserialization: {\n\t\t\t\t\t\t\t\tbroker: resolvedRuntime[fundingFaucetLeaseBrokerSymbol],\n\t\t\t\t\t\t\t\tkey: `sui-faucet:${realChain}`,\n\t\t\t\t\t\t\t\towner: `sui-faucet:${realChain}`,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}),\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<\n\t\t\t\t\t\t`faucet:request:${string}`,\n\t\t\t\t\t\tReturnType<typeof suiLocalStrategy>\n\t\t\t\t\t>,\n\t\t\t\t];\n\n\tconst localRoutables =\n\t\topts.mode === 'local'\n\t\t\t? makeSuiLocalRoutables({\n\t\t\t\t\tcontainerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-validator`,\n\t\t\t\t\tincludeGraphql: true,\n\t\t\t\t})\n\t\t\t: [];\n\tconst forkRoutables =\n\t\topts.mode === 'fork'\n\t\t\t? makeSuiForkRoutables({\n\t\t\t\t\tcontainerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-fork`,\n\t\t\t\t})\n\t\t\t: [];\n\n\treturn [\n\t\tsnap,\n\t\tcodegen,\n\t\tchainProbeContribution,\n\t\t...faucetContribution,\n\t\tfundsReadyContribution,\n\t\tseedObjectsContribution,\n\t\t...localRoutables,\n\t\t...forkRoutables,\n\t] as const;\n};\n\n// ---------------------------------------------------------------------------\n// User-facing factories\n// ---------------------------------------------------------------------------\n\n/** Local Sui shorthand. Network/env selection belongs to the CLI or\n *  `defineDevstackWith(...)`; plain `sui()` always means an in-stack\n *  local validator. */\nexport const sui = (opts: SuiOptions = { mode: 'local' }) => buildPlugin(opts);\n\n/** Mode-narrowed factory namespace.\n *\n *  Usage:\n *      const network = { mode: 'local', chain: 'sui:localnet' } as const;\n *      suiFor(network).local({...})    // OK\n *      suiFor(network).fork({...})     // type error: 'fork' not in 'local' branch\n *\n *  The namespace MIRRORS the four mode option records: `local`,\n *  `localRpc` (mapped onto the substrate `'local'` branch),\n *  `live`, `fork`. */\nexport const suiFor = defineModeNamespace({\n\tlocal: {\n\t\tlocal: (opts: Omit<SuiLocalOptions, 'mode'> = {}) => buildPlugin({ mode: 'local', ...opts }),\n\t\tlocalRpc: (opts: Omit<SuiLocalRpcOptions, 'mode'>) =>\n\t\t\tbuildPlugin({ mode: 'local-rpc', ...opts }),\n\t},\n\tlive: {\n\t\ttestnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'testnet', ...opts }),\n\t\tmainnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'mainnet', ...opts }),\n\t\tdevnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'devnet', ...opts }),\n\t\tcustom: (opts: Omit<SuiLiveOptions, 'mode' | 'network'>) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'custom', ...opts }),\n\t},\n\tfork: {\n\t\tmainnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'mainnet', ...opts }),\n\t\ttestnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'testnet', ...opts }),\n\t\tdevnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'devnet', ...opts }),\n\t},\n});\n\n// ---------------------------------------------------------------------------\n// Re-exports for advanced callers (Account/Coin/Wallet/etc.) and for\n// the sibling plugins (Walrus/Seal/Deepbook fork variants).\n// ---------------------------------------------------------------------------\n\nexport type { SuiClient, ForkAdminSurface, WaitForTransactionsReady } from './mode/shared.ts';\nexport type { ResolvedSuiNetwork } from './network-resolver.ts';\nexport type {\n\tSuiOptions,\n\tSuiLocalOptions,\n\tSuiLocalRpcOptions,\n\tSuiLiveOptions,\n\tSuiForkOptions,\n\tSuiPluginMode,\n} from './mode/spec.ts';\nexport type { SuiNetworkBindings } from './codegen.ts';\nexport type {\n\tSuiError,\n\tSuiPluginError,\n\tSuiCliError,\n\tSuiConfigError,\n\tForkUnsupportedError,\n\tSeedManifestMismatchError,\n\tSuiFundsReadyError,\n} from './errors.ts';\nexport { SUI_ERROR_TAGS } from './errors.ts';\n\n// Cross-plugin seams (consumed by Walrus/Seal/Deepbook fork variants\n// and by Account/Coin/Wallet/Package).\nexport {\n\tchainProbeCapabilityKey,\n\ttype ChainProbe,\n\ttype ChainProbeError,\n\ttype ChainProbeMode,\n} from '../../contracts/chain-probe.ts';\nexport {\n\tFUNDS_READY_GATE_KEY,\n\ttype FundsReadyStrategy,\n\ttype FundsReadyError,\n} from '../../contracts/network-resolver.ts';\nexport { SEED_OBJECTS_CAPABILITY_KEY, type SeedObjectsAccumulator } from './seed-objects.ts';\nexport {\n\tFORK_UNSUPPORTED_SURFACES,\n\twrapWithForkGuard,\n\ttype ForkMeta,\n\ttype ForkLockHolder,\n} from './fork-orchestration.ts';\nexport type { SuiProbeKey } from './chain-probe.ts';\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/sui/index.ts"],"sourcesContent":["// Sui plugin — barrel + factories.\n//\n// Architecture: Sui is the most-depended-on plugin in the stack.\n// Every consumer (Account/Coin/Wallet/Faucet/Package; Walrus/Seal/\n// Deepbook fork variants) reads its resolved `SuiClient` via the\n// `suiResource`. The factory at this file folds the four modes behind:\n//\n//   - `sui(opts?)`         — local shorthand. Defaults to an in-stack\n//                              local validator; pass a typed `opts`\n//                              record to select a different mode.\n//   - `suiFor(network)`    — mode-narrowed factory namespace (per\n//                              architecture Tension 11). Returns\n//                              `{ local: …, live: …, fork: … }`\n//                              narrowed to the network's mode.\n//\n// The plugin emits FOUR capability decls:\n//\n//   1. `chain-probe:<chainId>` strategy contributor — the\n//      schema-validated read surface (`makeSuiChainProbe`).\n//   2. Snapshotable — mode-aware container + bind-mount capture.\n//   3. Codegenable — `sui-network` bindings (chain id, rpc, etc.).\n//   4. Faucet strategy contributor — local-coin dispensing for the\n//      mode's chain id.\n//\n// Routable contributions are MODE-DEPENDENT (local + fork yes;\n// local-rpc + live no — the caller fronts their own RPC). They land\n// in the per-mode builder under `mode/*.ts`; this barrel composes\n// them into the plugin capability array.\n\nimport { Effect } from 'effect';\n\nimport { defineModeNamespace } from '../../api/mode-narrowed-factory.ts';\nimport { definePlugin, resource } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport type { ChainProbe } from '../../contracts/chain-probe.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport type { AcquireContext } from '../../substrate/plugin.ts';\n\nimport { chainProbeCapabilityKey } from '../../contracts/chain-probe.ts';\nimport { ContainerRuntimeService } from '../../runtime/docker/service.ts';\nimport { IdentityContext, StackPathsService } from '../../substrate/runtime/paths.ts';\nimport { LeaseBrokerService, type LeaseBroker } from '../../substrate/runtime/lease-broker/index.ts';\nimport { PortBrokerService } from '../../substrate/runtime/port-broker/index.ts';\nimport { makeCodegenable } from './codegen.ts';\nimport type { SuiProbeKey } from './chain-probe.ts';\nimport { makeSnapshotable } from './snapshot.ts';\nimport { bootSuiService } from './service.ts';\nimport { SUI_ERROR_TAGS, type SuiPluginError } from './errors.ts';\nimport { makeSuiForkRoutables, makeSuiLocalRoutables } from './routable.ts';\nimport { faucetCapabilityKey, type FaucetStrategy } from '../faucet/index.ts';\nimport { suiLocalStrategy } from './local-faucet-strategy.ts';\nimport { suiForkFaucetStrategy } from './fork-faucet-strategy.ts';\nimport { selectSufficientForkCoin } from './fork-transaction.ts';\nimport { FORK_FAUCET_WHALE_MIN_COIN_MIST, resolveForkWhale } from './mode/fork.ts';\nimport type { SuiClient } from './mode/shared.ts';\nimport type {\n\tSuiForkOptions,\n\tSuiLiveOptions,\n\tSuiLocalRpcOptions,\n\tSuiLocalOptions,\n\tSuiOptions,\n} from './mode/spec.ts';\n\n// ---------------------------------------------------------------------------\n// Resource identity\n// ---------------------------------------------------------------------------\n\ntype SuiResolved = SuiClient & {\n\treadonly mode: SuiOptions['mode'];\n};\n\n/** Internal extension of `SuiResolved` carrying the pre-built funding\n *  faucet strategy. `start` owns the `LeaseBrokerService` instance for\n *  serialization; building the strategy at start-time (where the broker\n *  is reachable) lets the capabilities factory consume a flat value\n *  without threading the broker through a side channel. Local/live wrap\n *  the HTTP faucet; fork impersonates a whale; `null` on networks with\n *  no faucet (live-mainnet, external-rpc-without-faucet, faucet-disabled\n *  fork). */\ntype SuiResolvedRuntime = SuiResolved & {\n\treadonly fundingFaucetStrategy: FaucetStrategy | null;\n};\n\n/** The Sui plugin's resource identity. The id is `'sui'` (singular). */\nexport const suiResource = resource<'sui', SuiResolved>('sui');\nconst suiErrorContributions = pluginErrorContributions(SUI_ERROR_TAGS);\n\n// ---------------------------------------------------------------------------\n// Plugin construction (internal — used by sui() + suiFor())\n// ---------------------------------------------------------------------------\n\n/** Build the funds-ready faucet strategy for the resolved network, or\n *  `null` when the network has none. Local/live wrap the HTTP faucet;\n *  fork mode impersonates a whale (resolved + validated here). */\nconst resolveFundingFaucetStrategy = (\n\topts: SuiOptions,\n\tclient: SuiClient,\n\tbroker: LeaseBroker,\n): Effect.Effect<FaucetStrategy | null, SuiPluginError> => {\n\tif (opts.mode === 'fork') {\n\t\treturn resolveForkFaucetStrategy(opts, client, broker);\n\t}\n\tif (client.fundingFaucetUrl === null) {\n\t\treturn Effect.succeed(null);\n\t}\n\treturn Effect.succeed(\n\t\tsuiLocalStrategy({\n\t\t\tfaucetUrl: client.fundingFaucetUrl,\n\t\t\tserialization: {\n\t\t\t\tbroker,\n\t\t\t\tkey: `sui-faucet:${client.chain}`,\n\t\t\t\towner: `sui-faucet:${client.chain}`,\n\t\t\t},\n\t\t}),\n\t);\n};\n\n/** Fork-mode faucet: resolve the whale, validate it holds a large enough\n *  SUI coin, then build the impersonation strategy. A whale the user set\n *  explicitly that fails validation hard-fails the boot; a per-upstream\n *  default whale only warns and disables the faucet so the fork still\n *  comes up (account funding then surfaces the \"no faucet strategy\"\n *  error only if something actually needs SUI). */\nconst resolveForkFaucetStrategy = (\n\topts: SuiForkOptions,\n\tclient: SuiClient,\n\tbroker: LeaseBroker,\n): Effect.Effect<FaucetStrategy | null, SuiPluginError> =>\n\tEffect.gen(function* () {\n\t\tconst resolved = resolveForkWhale(opts);\n\t\tconst fork = client.fork;\n\t\tif (resolved === null || fork === null) {\n\t\t\treturn null;\n\t\t}\n\t\tconst strategy = suiForkFaucetStrategy({\n\t\t\twhale: resolved.whale,\n\t\t\tfork,\n\t\t\tsdk: client.sdk,\n\t\t\tperRequestCapMist: resolved.perRequestCapMist,\n\t\t\tserialization: {\n\t\t\t\tbroker,\n\t\t\t\tkey: `sui-fork-faucet:${client.chain}`,\n\t\t\t\towner: `sui-fork-faucet:${client.chain}`,\n\t\t\t},\n\t\t});\n\t\treturn yield* selectSufficientForkCoin(\n\t\t\tclient.sdk.core,\n\t\t\tresolved.whale,\n\t\t\tFORK_FAUCET_WHALE_MIN_COIN_MIST,\n\t\t).pipe(\n\t\t\tEffect.as(strategy),\n\t\t\tEffect.catchTag('SuiPluginError', (cause) =>\n\t\t\t\tresolved.explicit\n\t\t\t\t\t? Effect.fail(cause)\n\t\t\t\t\t: Effect.logWarning(\n\t\t\t\t\t\t\t`sui fork mode: default faucet whale ${resolved.whale} is unusable ` +\n\t\t\t\t\t\t\t\t`(${cause.message}); disabling the fork faucet. Set faucet.whale to override.`,\n\t\t\t\t\t\t).pipe(Effect.as(null)),\n\t\t\t),\n\t\t);\n\t});\n\nconst buildPlugin = (opts: SuiOptions) => {\n\treturn definePlugin({\n\t\tid: suiResource.id,\n\t\trole: 'service',\n\t\tsection: 'service',\n\t\tstart: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\t// The substrate threads `ContainerRuntime` + `IdentityContext`\n\t\t\t\t// via the plugin runtime context; the supervisor provides\n\t\t\t\t// these before this body runs.\n\t\t\t\tconst runtime = yield* ContainerRuntimeService;\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst paths = yield* StackPathsService;\n\t\t\t\tconst portBroker = yield* PortBrokerService;\n\t\t\t\tconst fundingFaucetLeaseBroker = yield* LeaseBrokerService;\n\t\t\t\tconst { client } = yield* bootSuiService(runtime, identity, portBroker, paths, opts);\n\n\t\t\t\tconst fundingFaucetStrategy = yield* resolveFundingFaucetStrategy(\n\t\t\t\t\topts,\n\t\t\t\t\tclient,\n\t\t\t\t\tfundingFaucetLeaseBroker,\n\t\t\t\t);\n\t\t\t\treturn {\n\t\t\t\t\t...client,\n\t\t\t\t\tmode: opts.mode,\n\t\t\t\t\tfundingFaucetStrategy,\n\t\t\t\t} satisfies SuiResolvedRuntime;\n\t\t\t}),\n\t\tcapabilities: ({ value, runtime }) => makePluginCapabilities(opts, value, runtime),\n\t\terrorContributions: suiErrorContributions,\n\t});\n};\n\n/** Construct the capability tuple POST-acquire. Receives the resolved\n *  `SuiClient` + acquire context so decls can stamp REAL chain ids /\n *  rpc URLs into their fields instead of factory-time placeholders.\n *\n *  StrategyContributor declarations here carry real post-acquire\n *  strategy values. The generic strategy sink registers them on the\n *  scope-local `StrategyRegistry`. */\nconst makePluginCapabilities = (\n\topts: SuiOptions,\n\tresolved: SuiResolved,\n\tacquireCtx: AcquireContext,\n) => {\n\tconst realChain = resolved.chain;\n\tconst resolvedRuntime = resolved as SuiResolvedRuntime;\n\tconst snap: SnapshotableDecl = makeSnapshotable(\n\t\topts.mode,\n\t\tacquireCtx.identity.app,\n\t\tacquireCtx.identity.stack,\n\t\trealChain,\n\t);\n\tconst codegen: CodegenableDecl<'sui-network'> = makeCodegenable({\n\t\tmode: opts.mode,\n\t\tchain: realChain,\n\t\trpc: resolved.rpcUrl,\n\t\tsource: 'default',\n\t\t...(resolved.faucetUrl !== null ? { faucet: resolved.faucetUrl } : {}),\n\t\t...(resolved.graphqlUrl !== null ? { graphql: resolved.graphqlUrl } : {}),\n\t});\n\n\tconst chainProbeContribution: StrategyContributorDecl<\n\t\t`chain-probe:${string}`,\n\t\tChainProbe<SuiProbeKey>\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: chainProbeCapabilityKey(realChain),\n\t\tstrategy: resolved.chainProbe,\n\t\tautoMounted: true,\n\t};\n\n\tconst faucetContribution =\n\t\tresolvedRuntime.fundingFaucetStrategy === 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: faucetCapabilityKey(realChain),\n\t\t\t\t\t\tstrategy: resolvedRuntime.fundingFaucetStrategy,\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<\n\t\t\t\t\t\t`faucet:request:${string}`,\n\t\t\t\t\t\tReturnType<typeof suiLocalStrategy>\n\t\t\t\t\t>,\n\t\t\t\t];\n\n\tconst localRoutables =\n\t\topts.mode === 'local'\n\t\t\t? makeSuiLocalRoutables({\n\t\t\t\t\tcontainerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-validator`,\n\t\t\t\t\tincludeGraphql: true,\n\t\t\t\t})\n\t\t\t: [];\n\tconst forkRoutables =\n\t\topts.mode === 'fork'\n\t\t\t? makeSuiForkRoutables({\n\t\t\t\t\tcontainerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-fork`,\n\t\t\t\t})\n\t\t\t: [];\n\n\treturn [\n\t\tsnap,\n\t\tcodegen,\n\t\tchainProbeContribution,\n\t\t...faucetContribution,\n\t\t...localRoutables,\n\t\t...forkRoutables,\n\t] as const;\n};\n\n// ---------------------------------------------------------------------------\n// User-facing factories\n// ---------------------------------------------------------------------------\n\n/** Local Sui shorthand. Network/env selection belongs to the CLI or\n *  `defineDevstackWith(...)`; plain `sui()` always means an in-stack\n *  local validator. */\nexport const sui = (opts: SuiOptions = { mode: 'local' }) => buildPlugin(opts);\n\n/** Mode-narrowed factory namespace.\n *\n *  Usage:\n *      const network = { mode: 'local', chain: 'sui:localnet' } as const;\n *      suiFor(network).local({...})    // OK\n *      suiFor(network).fork({...})     // type error: 'fork' not in 'local' branch\n *\n *  The namespace MIRRORS the four mode option records: `local`,\n *  `localRpc` (mapped onto the substrate `'local'` branch),\n *  `live`, `fork`. */\nexport const suiFor = defineModeNamespace({\n\tlocal: {\n\t\tlocal: (opts: Omit<SuiLocalOptions, 'mode'> = {}) => buildPlugin({ mode: 'local', ...opts }),\n\t\tlocalRpc: (opts: Omit<SuiLocalRpcOptions, 'mode'>) =>\n\t\t\tbuildPlugin({ mode: 'local-rpc', ...opts }),\n\t},\n\tlive: {\n\t\ttestnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'testnet', ...opts }),\n\t\tmainnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'mainnet', ...opts }),\n\t\tdevnet: (opts: Omit<SuiLiveOptions, 'mode' | 'network'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'devnet', ...opts }),\n\t\tcustom: (opts: Omit<SuiLiveOptions, 'mode' | 'network'>) =>\n\t\t\tbuildPlugin({ mode: 'live', network: 'custom', ...opts }),\n\t},\n\tfork: {\n\t\tmainnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'mainnet', ...opts }),\n\t\ttestnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'testnet', ...opts }),\n\t\tdevnet: (opts: Omit<SuiForkOptions, 'mode' | 'upstream'> = {}) =>\n\t\t\tbuildPlugin({ mode: 'fork', upstream: 'devnet', ...opts }),\n\t},\n});\n\n// ---------------------------------------------------------------------------\n// Re-exports for advanced callers (Account/Coin/Wallet/etc.) and for\n// the sibling plugins (Walrus/Seal/Deepbook fork variants).\n// ---------------------------------------------------------------------------\n\nexport type { SuiClient, ForkAdminSurface, WaitForTransactionsReady } from './mode/shared.ts';\nexport type { ResolvedSuiNetwork } from './network-resolver.ts';\nexport type {\n\tSuiOptions,\n\tSuiLocalOptions,\n\tSuiLocalRpcOptions,\n\tSuiLiveOptions,\n\tSuiForkOptions,\n\tSuiPluginMode,\n} from './mode/spec.ts';\nexport type { SuiNetworkBindings } from './codegen.ts';\nexport type {\n\tSuiError,\n\tSuiPluginError,\n\tSuiCliError,\n\tSuiConfigError,\n\tForkUnsupportedError,\n} from './errors.ts';\nexport { SUI_ERROR_TAGS } from './errors.ts';\n\n// Cross-plugin seams (consumed by Walrus/Seal/Deepbook fork variants\n// and by Account/Coin/Wallet/Package).\nexport {\n\tchainProbeCapabilityKey,\n\ttype ChainProbe,\n\ttype ChainProbeError,\n\ttype ChainProbeMode,\n} from '../../contracts/chain-probe.ts';\nexport {\n\tFORK_UNSUPPORTED_SURFACES,\n\twrapWithForkGuard,\n\ttype ForkLockHolder,\n} from './fork-orchestration.ts';\nexport type { SuiProbeKey, SuiSdkShim } from './chain-probe.ts';\nexport { SuiSpans } from './spans.ts';\n\n/** The shape `Transaction.build({ client })` and every `sdk.core.*` call\n *  accepts. Re-exported from `@mysten/sui/client` so callers cast\n *  `sui.sdk.client as ClientWithCoreApi` without each having to know the\n *  SDK subpath. */\nexport type { ClientWithCoreApi } from '@mysten/sui/client';\n// Cross-plugin seams: fork impersonation + chain-build container.\n// Consumed by `action` (Move-call execution against fork) and\n// `package` (publish-to-fork + Move-build orchestration). Wave 2\n// switches consumer plugins from internal-module imports to these\n// barrel entries.\nexport {\n\tbuildForkImpersonationTransactionBytes,\n\tprepareForkImpersonationTransaction,\n\tverifyForkImpersonationSender,\n\tselectSufficientForkCoin,\n\tFORK_IMPERSONATION_GAS_BUDGET,\n\tFORK_IMPERSONATION_GAS_PRICE,\n\ttype ForkGasCoin,\n\ttype ForkImpersonationGasClient,\n} from './fork-transaction.ts';\nexport {\n\tsuiForkFaucetStrategy,\n\ttype SuiForkFaucetStrategyOptions,\n\ttype SuiForkFaucetSerialization,\n} from './fork-faucet-strategy.ts';\nexport {\n\tacquireChainBuildContainer,\n\tcontainerNameForApp,\n\tmoveBuildLockPathFor,\n\tMOVE_BUILD_LOCK_TIMEOUT_MS,\n\ttype ChainBuildContainer,\n\ttype ChainBuildContainerSpec,\n} from './chain-build-container.ts';\n"],"mappings":"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"}

package/dist/plugins/{faucet/strategies/sui-local.mjs → sui/local-faucet-strategy.mjs}

@@ -1,15 +1,18 @@
-import { leaseKey } from "../../../substrate/runtime/lease-broker/service.mjs";
-import { requestFundsWithRetry } from "../http.mjs";
+import { leaseKey } from "../../substrate/runtime/lease-broker/service.mjs";
+import "../../substrate/runtime/lease-broker/index.mjs";
+import { SuiSpans } from "./spans.mjs";
+import { requestFundsWithRetry } from "../faucet/http.mjs";
+import "../faucet/index.mjs";
 import { Effect } from "effect";
-//#region src/plugins/faucet/strategies/sui-local.ts
+//#region src/plugins/sui/local-faucet-strategy.ts
 const withSerialization = (serialization, effect) => {
 	if (serialization === void 0) return effect;
 	return Effect.scoped(Effect.gen(function* () {
 		yield* serialization.broker.acquire(leaseKey(serialization.key), serialization.owner);
 		yield* effect;
-	})).pipe(Effect.withSpan("faucet.suiLocal.serializedRequest", { attributes: {
-		"faucet.lease.key": serialization.key,
-		"faucet.lease.owner": serialization.owner
+	})).pipe(Effect.withSpan("devstack.plugin.sui.localFaucet.serializedRequest", { attributes: {
+		[SuiSpans.localFaucetLeaseKey]: serialization.key,
+		[SuiSpans.localFaucetLeaseOwner]: serialization.owner
 	} }));
 };
 /** Build a SUI local-faucet HTTP strategy. */
@@ -26,4 +29,4 @@ const suiLocalStrategy = (opts) => ({ request: ({ address, amount }) => {
 //#endregion
 export { suiLocalStrategy };
 
-//# sourceMappingURL=sui-local.mjs.map
+//# sourceMappingURL=local-faucet-strategy.mjs.map

package/dist/plugins/sui/local-faucet-strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-faucet-strategy.mjs","names":[],"sources":["../../../src/plugins/sui/local-faucet-strategy.ts"],"sourcesContent":["// SUI local-faucet HTTP strategy.\n//\n// Architecture: the Sui plugin OWNS the local-faucet endpoint\n// conceptually — it spins up the `sui-faucet` container in\n// `mode/local.ts`. The strategy CLOSES OVER the faucet URL at\n// construction so the dispatch site never sees Sui context, and is\n// registered into the `faucet:request:<chainId>` strategy registry\n// via a `StrategyContributor` decl from `sui/index.ts`.\n//\n// `FaucetStrategy` (the dispatch shape) is the faucet plugin's\n// contract surface and is imported from `../faucet/index.ts` — the\n// sui plugin only depends on faucet for the type, not for the\n// implementation. That keeps the dependency direction faucet ← sui,\n// matching the user-facing fact that `sui()` is the owner of the\n// faucet container.\n//\n// Amount semantics: the local faucet returns a fixed-amount grant\n// per request (the binary doesn't honor a variable amount today).\n// We carry `amount` through to error payloads so exhaustion errors\n// match the strategy-native unit (MIST), but the wire request\n// itself does not include it.\n\nimport { Effect } from 'effect';\n\nimport { leaseKey, type LeaseBroker } from '../../substrate/runtime/lease-broker/index.ts';\nimport { requestFundsWithRetry, type FaucetStrategy, type RetryOptions } from '../faucet/index.ts';\n\nimport { SuiSpans } from './spans.ts';\n\n/** Optional serialization for faucet backends that spend a shared funding coin. */\nexport interface SuiLocalFaucetSerialization {\n\t/** Stack-local broker; callers choose the resource key shape. */\n\treadonly broker: LeaseBroker;\n\t/** Opaque lease key, typically scoped by chain id. */\n\treadonly key: string;\n\t/** Diagnostic owner reported by the lease broker. */\n\treadonly owner: string;\n}\n\n/** Per-strategy options. */\nexport interface SuiLocalStrategyOptions {\n\t/** Faucet base URL — e.g. `http://localhost:9123`. The strategy\n\t *  appends `/v2/gas` internally. */\n\treadonly faucetUrl: string;\n\t/** Wall-clock budget; forwarded to `requestFundsWithRetry`. */\n\treadonly timeoutMs?: number;\n\t/** Max retry attempts; forwarded to `requestFundsWithRetry`. */\n\treadonly maxAttempts?: number;\n\t/** Serialize requests when the faucet backend shares one funding coin. */\n\treadonly serialization?: SuiLocalFaucetSerialization;\n}\n\nconst withSerialization = <E>(\n\tserialization: SuiLocalFaucetSerialization | undefined,\n\teffect: Effect.Effect<void, E>,\n): Effect.Effect<void, E> => {\n\tif (serialization === undefined) {\n\t\treturn effect;\n\t}\n\treturn Effect.scoped(\n\t\tEffect.gen(function* () {\n\t\t\tyield* serialization.broker.acquire(leaseKey(serialization.key), serialization.owner);\n\t\t\tyield* effect;\n\t\t}),\n\t).pipe(\n\t\tEffect.withSpan('devstack.plugin.sui.localFaucet.serializedRequest', {\n\t\t\tattributes: {\n\t\t\t\t[SuiSpans.localFaucetLeaseKey]: serialization.key,\n\t\t\t\t[SuiSpans.localFaucetLeaseOwner]: serialization.owner,\n\t\t\t},\n\t\t}),\n\t);\n};\n\n/** Build a SUI local-faucet HTTP strategy. */\nexport const suiLocalStrategy = (opts: SuiLocalStrategyOptions): FaucetStrategy => ({\n\trequest: ({ address, amount }) => {\n\t\tconst retryOpts: RetryOptions = {\n\t\t\tfaucetUrl: opts.faucetUrl,\n\t\t\taddress,\n\t\t\tamount,\n\t\t\t...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),\n\t\t\t...(opts.maxAttempts !== undefined ? { maxAttempts: opts.maxAttempts } : {}),\n\t\t};\n\t\treturn withSerialization(opts.serialization, requestFundsWithRetry(retryOpts));\n\t},\n});\n"],"mappings":";;;;;;;AAoDA,MAAM,qBACL,eACA,WAC4B;AAC5B,KAAI,kBAAkB,KAAA,EACrB,QAAO;AAER,QAAO,OAAO,OACb,OAAO,IAAI,aAAa;AACvB,SAAO,cAAc,OAAO,QAAQ,SAAS,cAAc,IAAI,EAAE,cAAc,MAAM;AACrF,SAAO;GACN,CACF,CAAC,KACD,OAAO,SAAS,qDAAqD,EACpE,YAAY;GACV,SAAS,sBAAsB,cAAc;GAC7C,SAAS,wBAAwB,cAAc;EAChD,EACD,CAAC,CACF;;;AAIF,MAAa,oBAAoB,UAAmD,EACnF,UAAU,EAAE,SAAS,aAAa;CACjC,MAAM,YAA0B;EAC/B,WAAW,KAAK;EAChB;EACA;EACA,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,WAAW,GAAG,EAAE;EACrE,GAAI,KAAK,gBAAgB,KAAA,IAAY,EAAE,aAAa,KAAK,aAAa,GAAG,EAAE;EAC3E;AACD,QAAO,kBAAkB,KAAK,eAAe,sBAAsB,UAAU,CAAC;GAE/E"}

package/dist/plugins/sui/mode/external.mjs

@@ -1,4 +1,7 @@
+import { SpanAttr } from "../../../substrate/runtime/observability/spans.mjs";
 import { suiPluginError } from "../errors.mjs";
+import { formatUnknownError } from "../../../substrate/runtime/format-unknown-error.mjs";
+import { SuiSpans } from "../spans.mjs";
 import { assembleSuiClient, buildWaitForTransactionsReady, fetchChainId, makeResolvedNetwork, noopWaitForTransactionsReady } from "./shared-boot.mjs";
 import { Duration, Effect } from "effect";
 import { SuiGrpcClient } from "@mysten/sui/grpc";
@@ -15,14 +18,14 @@ const bootLocalRpcMode = (opts) => Effect.gen(function* () {
 			baseUrl: opts.rpcUrl,
 			network: "localnet"
 		}),
-		catch: (cause) => suiPluginError("chain-id-fetch", `sui local-rpc mode: SuiGrpcClient construction failed for rpcUrl=${opts.rpcUrl}: ${stringifyCause(cause)}`, cause)
+		catch: (cause) => suiPluginError("chain-id-fetch", `sui local-rpc mode: SuiGrpcClient construction failed for rpcUrl=${opts.rpcUrl}: ${formatUnknownError(cause)}`, cause)
 	});
 	const chain = opts.chain ?? (yield* fetchChainId(sdkClient, {
 		timeout: opts.readyTimeout ?? DEFAULT_EXTERNAL_CHAIN_ID_TIMEOUT,
 		span: "devstack.plugin.sui.localRpc.fetchChainId"
 	}));
 	const waitForTransactionsReady = opts.faucetUrl !== void 0 ? yield* buildWaitForTransactionsReady(opts.faucetUrl) : noopWaitForTransactionsReady;
-	const { client } = assembleSuiClient({
+	const { client } = yield* assembleSuiClient({
 		sdkClient,
 		chain,
 		rpcUrl: opts.rpcUrl,
@@ -42,18 +45,9 @@ const bootLocalRpcMode = (opts) => Effect.gen(function* () {
 		client
 	};
 }).pipe(Effect.withSpan("devstack.plugin.sui.localRpc.boot", { attributes: {
-	"devstack.plugin": "sui",
-	"sui.mode": "local-rpc"
+	[SpanAttr.plugin]: "sui",
+	[SuiSpans.mode]: "local-rpc"
 } }));
-const stringifyCause = (cause) => {
-	if (cause instanceof Error) return cause.message;
-	if (typeof cause === "string") return cause;
-	try {
-		return JSON.stringify(cause);
-	} catch {
-		return String(cause);
-	}
-};
 //#endregion
 export { bootLocalRpcMode };
 

package/dist/plugins/sui/mode/external.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"external.mjs","names":[],"sources":["../../../../src/plugins/sui/mode/external.ts"],"sourcesContent":["// Sui plugin — local caller-owned RPC mode.\n//\n// Caller already has a Sui process running and supplies the RPC URL\n// (optionally faucet and GraphQL). Used in CI, custom-runtime\n// experiments, and \"wrap my own sui localnet\" scenarios.\n//\n// What's hard:\n//   - The entire container + sidecar + build-container pipeline\n//     must be skipped cleanly. No image build, no docker network,\n//     no SuiBuildImage wired in.\n//   - Downstream consumers must still get the same endpoint shape,\n//     the same chain id, and a working `waitForTransactionsReady`\n//     when a faucet URL is supplied.\n//   - The chain-id fetch IS the only readiness sentinel; must have\n//     a bounded timeout.\n//\n// Local-RPC mode contributes a `NetworkResolver` and a `ChainProbe`\n// but does NOT contribute a `Snapshotable`-managed container or a\n// `Routable` entrypoint (the caller's own router fronts the RPC).\n//\n// Boot sequence:\n//\n//   1. Construct an `@mysten/sui/grpc` `SuiGrpcClient` against the\n//      caller-supplied `rpcUrl`. `network: 'localnet'` is the\n//      semantically-correct discriminator — external IS a local-mode\n//      sub-shape, not a public-net target.\n//   2. Fetch the chain identifier with a bounded timeout — the only\n//      readiness sentinel for this mode.\n//   3. Build `waitForTransactionsReady`:\n//        - If `faucetUrl` is supplied, wire the real HTTP probe\n//          (same code path as local mode).\n//        - Otherwise, the gate is a trivially-succeeding no-op\n//          (callers that need funds must arrange them externally).\n//   4. Assemble the resolved `SuiClient` and return it alongside the\n//      `ResolvedSuiNetwork` projection (consumed by the codegen +\n//      network-resolver contributions at the barrel).\n\nimport { Duration, Effect, type Scope } from 'effect';\n\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\n\nimport { suiPluginError, type SuiPluginError } from '../errors.ts';\nimport type { ResolvedSuiNetwork } from '../network-resolver.ts';\nimport type { SuiClient } from './shared.ts';\nimport {\n\tassembleSuiClient,\n\tbuildWaitForTransactionsReady,\n\tfetchChainId,\n\tmakeResolvedNetwork,\n\tnoopWaitForTransactionsReady,\n} from './shared-boot.ts';\nimport type { SuiLocalRpcOptions } from './spec.ts';\n\n/** Default chain-id fetch timeout for caller-owned local RPCs. The wire\n *  latency is the dominant cost; 30s is the documented ceiling. */\nexport const DEFAULT_EXTERNAL_CHAIN_ID_TIMEOUT = Duration.seconds(30);\n\n/** Resolved local-RPC-mode boot artifacts. */\nexport interface LocalRpcModeBootResult {\n\treadonly resolved: ResolvedSuiNetwork;\n\treadonly client: SuiClient;\n}\n\n/** Build the local-RPC-mode boot Effect. No container, no sidecar,\n *  no build image. Just probe chain id + wire `waitForTransactionsReady`\n *  conditional on `faucetUrl`. */\nexport const bootLocalRpcMode = (\n\topts: SuiLocalRpcOptions,\n): Effect.Effect<LocalRpcModeBootResult, SuiPluginError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\t// ----- 1. Construct the grpc client ----------------------------------\n\t\t// `network: 'localnet'` is semantically correct: external is a\n\t\t// substrate-level `'local'` sub-mode (caller's own localnet); the\n\t\t// SDK uses `network` for MVR / wallet-standard hints which the\n\t\t// caller-provided RPC won't honor anyway.\n\t\tconst sdkClient = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\tnew SuiGrpcClient({\n\t\t\t\t\tbaseUrl: opts.rpcUrl,\n\t\t\t\t\tnetwork: 'localnet',\n\t\t\t\t}),\n\t\t\tcatch: (cause): SuiPluginError =>\n\t\t\t\tsuiPluginError(\n\t\t\t\t\t'chain-id-fetch',\n\t\t\t\t\t`sui local-rpc mode: SuiGrpcClient construction failed for rpcUrl=${opts.rpcUrl}: ${stringifyCause(cause)}`,\n\t\t\t\t\tcause,\n\t\t\t\t),\n\t\t});\n\n\t\t// ----- 2. Resolve chain id -------------------------------------------\n\t\tconst chain =\n\t\t\topts.chain ??\n\t\t\t(yield* fetchChainId(sdkClient, {\n\t\t\t\ttimeout: opts.readyTimeout ?? DEFAULT_EXTERNAL_CHAIN_ID_TIMEOUT,\n\t\t\t\tspan: 'devstack.plugin.sui.localRpc.fetchChainId',\n\t\t\t}));\n\n\t\t// ----- 3. Build waitForTransactionsReady -----------------------------\n\t\t// Faucet-bearing: real HTTP probe. Faucet-less: no-op (caller\n\t\t// must arrange funding out-of-band).\n\t\tconst waitForTransactionsReady =\n\t\t\topts.faucetUrl !== undefined\n\t\t\t\t? yield* buildWaitForTransactionsReady(opts.faucetUrl)\n\t\t\t\t: noopWaitForTransactionsReady;\n\n\t\t// ----- 4. Assemble + return ------------------------------------------\n\t\tconst { client } = assembleSuiClient({\n\t\t\tsdkClient,\n\t\t\tchain,\n\t\t\trpcUrl: opts.rpcUrl,\n\t\t\t...(opts.faucetUrl !== undefined ? { faucetUrl: opts.faucetUrl } : {}),\n\t\t\t...(opts.graphqlUrl !== undefined ? { graphqlUrl: opts.graphqlUrl } : {}),\n\t\t\twaitForTransactionsReady,\n\t\t});\n\t\tconst resolved = makeResolvedNetwork({\n\t\t\tmode: 'local-rpc',\n\t\t\tchain,\n\t\t\trpc: opts.rpcUrl,\n\t\t\tsource: 'config',\n\t\t\t...(opts.faucetUrl !== undefined ? { faucet: opts.faucetUrl } : {}),\n\t\t\t...(opts.graphqlUrl !== undefined ? { graphql: opts.graphqlUrl } : {}),\n\t\t});\n\n\t\treturn { resolved, client };\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.sui.localRpc.boot', {\n\t\t\tattributes: { 'devstack.plugin': 'sui', 'sui.mode': 'local-rpc' },\n\t\t}),\n\t);\n\nconst stringifyCause = (cause: unknown): string => {\n\tif (cause instanceof Error) return cause.message;\n\tif (typeof cause === 'string') return cause;\n\ttry {\n\t\treturn JSON.stringify(cause);\n\t} catch {\n\t\treturn String(cause);\n\t}\n};\n"],"mappings":";;;;;;;AAuDA,MAAa,oCAAoC,SAAS,QAAQ,GAAG;;;;AAWrE,MAAa,oBACZ,SAEA,OAAO,IAAI,aAAa;CAMvB,MAAM,YAAY,OAAO,OAAO,IAAI;EACnC,WACC,IAAI,cAAc;GACjB,SAAS,KAAK;GACd,SAAS;GACT,CAAC;EACH,QAAQ,UACP,eACC,kBACA,oEAAoE,KAAK,OAAO,IAAI,eAAe,MAAM,IACzG,MACA;EACF,CAAC;CAGF,MAAM,QACL,KAAK,UACJ,OAAO,aAAa,WAAW;EAC/B,SAAS,KAAK,gBAAgB;EAC9B,MAAM;EACN,CAAC;CAKH,MAAM,2BACL,KAAK,cAAc,KAAA,IAChB,OAAO,8BAA8B,KAAK,UAAU,GACpD;CAGJ,MAAM,EAAE,WAAW,kBAAkB;EACpC;EACA;EACA,QAAQ,KAAK;EACb,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,WAAW,GAAG,EAAE;EACrE,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE;EACA,CAAC;AAUF,QAAO;EAAE,UATQ,oBAAoB;GACpC,MAAM;GACN;GACA,KAAK,KAAK;GACV,QAAQ;GACR,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,QAAQ,KAAK,WAAW,GAAG,EAAE;GAClE,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,SAAS,KAAK,YAAY,GAAG,EAAE;GACrE,CAEgB;EAAE;EAAQ;EAC1B,CAAC,KACF,OAAO,SAAS,qCAAqC,EACpD,YAAY;CAAE,mBAAmB;CAAO,YAAY;CAAa,EACjE,CAAC,CACF;AAEF,MAAM,kBAAkB,UAA2B;AAClD,KAAI,iBAAiB,MAAO,QAAO,MAAM;AACzC,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI;AACH,SAAO,KAAK,UAAU,MAAM;SACrB;AACP,SAAO,OAAO,MAAM"}
+{"version":3,"file":"external.mjs","names":[],"sources":["../../../../src/plugins/sui/mode/external.ts"],"sourcesContent":["// Sui plugin — local caller-owned RPC mode.\n//\n// Caller already has a Sui process running and supplies the RPC URL\n// (optionally faucet and GraphQL). Used in CI, custom-runtime\n// experiments, and \"wrap my own sui localnet\" scenarios.\n//\n// What's hard:\n//   - The entire container + sidecar + build-container pipeline\n//     must be skipped cleanly. No image build, no docker network,\n//     no SuiBuildImage wired in.\n//   - Downstream consumers must still get the same endpoint shape,\n//     the same chain id, and a working `waitForTransactionsReady`\n//     when a faucet URL is supplied.\n//   - The chain-id fetch IS the only readiness sentinel; must have\n//     a bounded timeout.\n//\n// Local-RPC mode contributes a `ChainProbe` and a `Codegenable` but\n// does NOT contribute a `Snapshotable`-managed container or a\n// `Routable` entrypoint (the caller's own router fronts the RPC).\n//\n// Boot sequence:\n//\n//   1. Construct an `@mysten/sui/grpc` `SuiGrpcClient` against the\n//      caller-supplied `rpcUrl`. `network: 'localnet'` is the\n//      semantically-correct discriminator — external IS a local-mode\n//      sub-shape, not a public-net target.\n//   2. Fetch the chain identifier with a bounded timeout — the only\n//      readiness sentinel for this mode.\n//   3. Build `waitForTransactionsReady`:\n//        - If `faucetUrl` is supplied, wire the real HTTP probe\n//          (same code path as local mode).\n//        - Otherwise, the gate is a trivially-succeeding no-op\n//          (callers that need funds must arrange them externally).\n//   4. Assemble the resolved `SuiClient` and return it alongside the\n//      `ResolvedSuiNetwork` projection (consumed by the codegen\n//      contribution at the barrel).\n\nimport { Duration, Effect, type Scope } from 'effect';\n\nimport { SuiGrpcClient } from '@mysten/sui/grpc';\n\nimport { SpanAttr } from '../../../substrate/runtime/observability/spans.ts';\nimport { suiPluginError, type SuiConfigError, type SuiPluginError } from '../errors.ts';\nimport { formatUnknownError } from '../../../substrate/runtime/format-unknown-error.ts';\nimport type { ResolvedSuiNetwork } from '../network-resolver.ts';\nimport { SuiSpans } from '../spans.ts';\nimport type { SuiClient } from './shared.ts';\nimport {\n\tassembleSuiClient,\n\tbuildWaitForTransactionsReady,\n\tfetchChainId,\n\tmakeResolvedNetwork,\n\tnoopWaitForTransactionsReady,\n} from './shared-boot.ts';\nimport type { SuiLocalRpcOptions } from './spec.ts';\n\n/** Default chain-id fetch timeout for caller-owned local RPCs. The wire\n *  latency is the dominant cost; 30s is the documented ceiling. */\nexport const DEFAULT_EXTERNAL_CHAIN_ID_TIMEOUT = Duration.seconds(30);\n\n/** Resolved local-RPC-mode boot artifacts. */\nexport interface LocalRpcModeBootResult {\n\treadonly resolved: ResolvedSuiNetwork;\n\treadonly client: SuiClient;\n}\n\n/** Build the local-RPC-mode boot Effect. No container, no sidecar,\n *  no build image. Just probe chain id + wire `waitForTransactionsReady`\n *  conditional on `faucetUrl`. */\nexport const bootLocalRpcMode = (\n\topts: SuiLocalRpcOptions,\n): Effect.Effect<LocalRpcModeBootResult, SuiPluginError | SuiConfigError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\t// ----- 1. Construct the grpc client ----------------------------------\n\t\t// `network: 'localnet'` is semantically correct: external is a\n\t\t// substrate-level `'local'` sub-mode (caller's own localnet); the\n\t\t// SDK uses `network` for MVR / wallet-standard hints which the\n\t\t// caller-provided RPC won't honor anyway.\n\t\tconst sdkClient = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\tnew SuiGrpcClient({\n\t\t\t\t\tbaseUrl: opts.rpcUrl,\n\t\t\t\t\tnetwork: 'localnet',\n\t\t\t\t}),\n\t\t\tcatch: (cause): SuiPluginError =>\n\t\t\t\tsuiPluginError(\n\t\t\t\t\t'chain-id-fetch',\n\t\t\t\t\t`sui local-rpc mode: SuiGrpcClient construction failed for rpcUrl=${opts.rpcUrl}: ${formatUnknownError(cause)}`,\n\t\t\t\t\tcause,\n\t\t\t\t),\n\t\t});\n\n\t\t// ----- 2. Resolve chain id -------------------------------------------\n\t\tconst chain =\n\t\t\topts.chain ??\n\t\t\t(yield* fetchChainId(sdkClient, {\n\t\t\t\ttimeout: opts.readyTimeout ?? DEFAULT_EXTERNAL_CHAIN_ID_TIMEOUT,\n\t\t\t\tspan: 'devstack.plugin.sui.localRpc.fetchChainId',\n\t\t\t}));\n\n\t\t// ----- 3. Build waitForTransactionsReady -----------------------------\n\t\t// Faucet-bearing: real HTTP probe. Faucet-less: no-op (caller\n\t\t// must arrange funding out-of-band).\n\t\tconst waitForTransactionsReady =\n\t\t\topts.faucetUrl !== undefined\n\t\t\t\t? yield* buildWaitForTransactionsReady(opts.faucetUrl)\n\t\t\t\t: noopWaitForTransactionsReady;\n\n\t\t// ----- 4. Assemble + return ------------------------------------------\n\t\tconst { client } = yield* assembleSuiClient({\n\t\t\tsdkClient,\n\t\t\tchain,\n\t\t\trpcUrl: opts.rpcUrl,\n\t\t\t...(opts.faucetUrl !== undefined ? { faucetUrl: opts.faucetUrl } : {}),\n\t\t\t...(opts.graphqlUrl !== undefined ? { graphqlUrl: opts.graphqlUrl } : {}),\n\t\t\twaitForTransactionsReady,\n\t\t});\n\t\tconst resolved = makeResolvedNetwork({\n\t\t\tmode: 'local-rpc',\n\t\t\tchain,\n\t\t\trpc: opts.rpcUrl,\n\t\t\tsource: 'config',\n\t\t\t...(opts.faucetUrl !== undefined ? { faucet: opts.faucetUrl } : {}),\n\t\t\t...(opts.graphqlUrl !== undefined ? { graphql: opts.graphqlUrl } : {}),\n\t\t});\n\n\t\treturn { resolved, client };\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.sui.localRpc.boot', {\n\t\t\tattributes: { [SpanAttr.plugin]: 'sui', [SuiSpans.mode]: 'local-rpc' },\n\t\t}),\n\t);\n"],"mappings":";;;;;;;;;;AA0DA,MAAa,oCAAoC,SAAS,QAAQ,GAAG;;;;AAWrE,MAAa,oBACZ,SAEA,OAAO,IAAI,aAAa;CAMvB,MAAM,YAAY,OAAO,OAAO,IAAI;EACnC,WACC,IAAI,cAAc;GACjB,SAAS,KAAK;GACd,SAAS;GACT,CAAC;EACH,QAAQ,UACP,eACC,kBACA,oEAAoE,KAAK,OAAO,IAAI,mBAAmB,MAAM,IAC7G,MACA;EACF,CAAC;CAGF,MAAM,QACL,KAAK,UACJ,OAAO,aAAa,WAAW;EAC/B,SAAS,KAAK,gBAAgB;EAC9B,MAAM;EACN,CAAC;CAKH,MAAM,2BACL,KAAK,cAAc,KAAA,IAChB,OAAO,8BAA8B,KAAK,UAAU,GACpD;CAGJ,MAAM,EAAE,WAAW,OAAO,kBAAkB;EAC3C;EACA;EACA,QAAQ,KAAK;EACb,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,WAAW,GAAG,EAAE;EACrE,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,YAAY,GAAG,EAAE;EACxE;EACA,CAAC;AAUF,QAAO;EAAE,UATQ,oBAAoB;GACpC,MAAM;GACN;GACA,KAAK,KAAK;GACV,QAAQ;GACR,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,QAAQ,KAAK,WAAW,GAAG,EAAE;GAClE,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,SAAS,KAAK,YAAY,GAAG,EAAE;GACrE,CAEgB;EAAE;EAAQ;EAC1B,CAAC,KACF,OAAO,SAAS,qCAAqC,EACpD,YAAY;EAAG,SAAS,SAAS;EAAQ,SAAS,OAAO;CAAa,EACtE,CAAC,CACF"}

package/dist/plugins/sui/mode/fork.mjs

@@ -1,34 +1,95 @@
-import { renderUrl, routerHostname } from "../../../orchestrators/router/hostname.mjs";
+import { SpanAttr } from "../../../substrate/runtime/observability/spans.mjs";
 import { ProbeTimeoutError, waitForProbe } from "../../../substrate/runtime/probes.mjs";
+import { setCurrentPluginPhase } from "../../../substrate/runtime/current-plugin.mjs";
+import { DEFAULT_SUI_CLI_VERSION } from "../../../substrate/runtime/sui-move-build/index.mjs";
+import { renderUrl, routedHostname } from "../../../substrate/runtime/routed-url.mjs";
+import { SUI_RPC_ENTRYPOINT_PORT } from "../routable.mjs";
+import { ensureManagedContainer } from "../../../substrate/runtime/managed-container.mjs";
 import { suiPluginError } from "../errors.mjs";
+import { formatUnknownError } from "../../../substrate/runtime/format-unknown-error.mjs";
+import { SuiSpans } from "../spans.mjs";
 import { toDockerHostGatewayUrl } from "./shared.mjs";
 import { assembleSuiClient, fetchChainId, makeResolvedNetwork, noopWaitForTransactionsReady } from "./shared-boot.mjs";
-import { ensureManagedContainer } from "../../../substrate/runtime/managed-container.mjs";
+import { extractExecuteDigest } from "../../../substrate/runtime/sui-execute/index.mjs";
 import { resolveAutoTickIntervalMs, runAutoTickClock } from "../auto-tick.mjs";
-import { SUI_RPC_ENTRYPOINT_PORT } from "../routable.mjs";
-import { wrapWithForkGuard } from "../fork-orchestration.mjs";
-import { verifyForkImpersonationSender } from "../fork-transaction.mjs";
-import { DEFAULT_SUI_CLI_VERSION } from "../../../substrate/runtime/sui-move-build/index.mjs";
+import { acquireForkDataDirHolder, wrapWithForkGuard } from "../fork-orchestration.mjs";
+import { FORK_IMPERSONATION_GAS_BUDGET, verifyForkImpersonationSender } from "../fork-transaction.mjs";
 import { Duration, Effect } from "effect";
 import { createHash } from "node:crypto";
 import { join, resolve } from "node:path";
-import { SuiGrpcClient } from "@mysten/sui/grpc";
 import { mkdir } from "node:fs/promises";
+import { SuiGrpcClient } from "@mysten/sui/grpc";
+import { fileURLToPath } from "node:url";
 import { normalizeSuiAddress, normalizeSuiObjectId } from "@mysten/sui/utils";
 //#region src/plugins/sui/mode/fork.ts
 /** Default ready-probe timeout for fork-mode cold start. */
 const DEFAULT_FORK_READY_TIMEOUT = Duration.seconds(180);
 /** Default Sui repository revision used by the bundled `sui-fork` image build. */
 const DEFAULT_SUI_FORK_REV = "62ee6ada958cd61b3c8a4466dd33c9aba3cdff8a";
+/** Env var that overrides {@link DEFAULT_FORK_IMAGE_REF} for a single run. */
+const FORK_IMAGE_ENV_VAR = "DEVSTACK_SUI_FORK_IMAGE";
+const prebuiltForkImageRef = () => {
+	const fromEnv = process.env[FORK_IMAGE_ENV_VAR]?.trim();
+	return fromEnv !== void 0 && fromEnv.length > 0 ? fromEnv : void 0;
+};
 const DEFAULT_FORK_HOST_RPC_PORT = 51002;
+/** Default impersonation "whale" per upstream — a large-reserve address
+*  known to hold a big single SUI coin in the upstream's state, used as
+*  the fork faucet funding source when `faucet.whale` is omitted. `null`
+*  means no default is known (the faucet then requires an explicit
+*  `faucet.whale`). Validated at boot via `selectSufficientForkCoin`. */
+const FORK_DEFAULT_WHALE = {
+	mainnet: "0xbc7e7537564bd939b62e5b24477ac00ba8cef33ccec72d63090a080a1253b725",
+	testnet: "0xc397477d8b445e6295bc34e593b9a95d5d233cec1a8fe3740d0ab86012a460f6",
+	devnet: "0x4296747d0bd91c41b668702bdca0bf769a0e32db66982d986101e7975db55cbe"
+};
+/** Floor a single whale SUI coin must clear at boot to enable the fork faucet:
+*  a default ephemeral fund (1 SUI) plus the impersonation gas budget. Set to
+*  match the per-request requirement for the default fund so a whale that
+*  passes boot can actually satisfy the first auto-fund. */
+const FORK_FAUCET_WHALE_MIN_COIN_MIST = 1000000000n + FORK_IMPERSONATION_GAS_BUDGET;
+/** Resolve the fork faucet whale from options + per-upstream defaults,
+*  or `null` when the faucet is disabled / no whale is known. */
+const resolveForkWhale = (opts) => {
+	if (opts.faucet?.enabled === false) return null;
+	const perRequestCapMist = opts.faucet?.perRequestCapMist ?? 1000000000000n;
+	const explicit = opts.faucet?.whale?.trim();
+	if (explicit !== void 0 && explicit.length > 0) return {
+		whale: normalizeSuiAddress(explicit),
+		perRequestCapMist,
+		explicit: true
+	};
+	const fallback = FORK_DEFAULT_WHALE[opts.upstream];
+	return fallback === null ? null : {
+		whale: normalizeSuiAddress(fallback),
+		perRequestCapMist,
+		explicit: false
+	};
+};
+/** Inject the resolved faucet whale into the fork seed so its coins exist
+*  in fork state. MUST run before the data-dir key / container config
+*  hash are computed (both fold the seed) so enabling the faucet doesn't
+*  silently reuse a whale-less fork data dir. */
+const withForkFaucetSeed = (opts) => {
+	const resolved = resolveForkWhale(opts);
+	if (resolved === null) return opts;
+	return {
+		...opts,
+		seed: {
+			...opts.seed ?? {},
+			addresses: [...opts.seed?.addresses ?? [], resolved.whale]
+		}
+	};
+};
 const DOCKER_PUBLISH_HOST = "0.0.0.0";
 const CONTAINER_RPC_PORT = SUI_RPC_ENTRYPOINT_PORT;
 const FORK_CONTAINER_DATA_DIR = "/var/lib/sui-fork";
 const PROBE_ATTEMPT_TIMEOUT_MS = 3e3;
 const bootForkMode = (runtime, identity, portBroker, paths, opts) => Effect.gen(function* () {
-	const autoTickIntervalMs = resolveAutoTickIntervalMs(opts.autoTick);
-	const image = yield* resolveForkImage(runtime, opts);
-	const dataDir = yield* ensureForkDataDir(paths, opts);
+	const autoTickIntervalMs = yield* resolveAutoTickIntervalMs(opts.autoTick);
+	const seededOpts = withForkFaucetSeed(opts);
+	const image = yield* resolveForkImage(runtime, identity, opts);
+	const dataDir = yield* ensureForkDataDir(paths, seededOpts);
 	const { handle, ports } = yield* ensureForkContainer({
 		runtime,
 		portBroker,
@@ -41,7 +102,7 @@ const bootForkMode = (runtime, identity, portBroker, paths, opts) => Effect.gen(
 		},
 		containerName: `devstack-${identity.app}-${identity.stack}-sui-fork`,
 		dataDir,
-		opts
+		opts: seededOpts
 	});
 	const directRpcUrl = `http://127.0.0.1:${pickPublishedPort(ports, handle.ports).hostPort}`;
 	const rpcUrl = yield* routedSuiRpcUrl(identity);
@@ -49,10 +110,10 @@ const bootForkMode = (runtime, identity, portBroker, paths, opts) => Effect.gen(
 		baseUrl: directRpcUrl,
 		network: opts.upstream
 	});
-	const status = yield* waitForForkReady(sdkClient, opts.readyTimeout ?? DEFAULT_FORK_READY_TIMEOUT).pipe(Effect.annotateLogs({ "sui.container": handle.name }));
+	const status = yield* waitForForkReady(sdkClient, opts.readyTimeout ?? DEFAULT_FORK_READY_TIMEOUT).pipe(Effect.annotateLogs({ [SuiSpans.container]: handle.name }));
 	const chain = yield* fetchChainId(sdkClient, { span: "devstack.plugin.sui.fork.fetchChainId" });
 	const fork = makeForkAdminSurface(sdkClient);
-	const assembled = assembleSuiClient({
+	const assembled = yield* assembleSuiClient({
 		sdkClient,
 		chain,
 		rpcUrl,
@@ -82,31 +143,58 @@ const bootForkMode = (runtime, identity, portBroker, paths, opts) => Effect.gen(
 		client,
 		autoTickIntervalMs
 	};
-}).pipe(Effect.withSpan("devstack.plugin.sui.fork.boot", { attributes: { "devstack.plugin": "sui" } }));
+}).pipe(Effect.withSpan("devstack.plugin.sui.fork.boot", { attributes: { [SpanAttr.plugin]: "sui" } }));
 const suiForkImageBuildContext = (rev = DEFAULT_SUI_FORK_REV) => ({
-	contextPath: new URL("../../../../images/", import.meta.url).pathname,
+	contextPath: fileURLToPath(new URL("../../../../images/", import.meta.url)),
 	dockerfile: "sui-fork/Dockerfile",
 	buildArgs: {
 		SUI_FORK_REV: rev,
 		SUI_CLI_VERSION: DEFAULT_SUI_CLI_VERSION
 	}
 });
-const resolveForkImage = (runtime, opts) => Effect.gen(function* () {
-	if (opts.image && "pull" in opts.image) {
-		const pullRef = opts.image.pull;
-		if (runtime.pullImage === void 0) return yield* Effect.fail(suiPluginError("image-build", `sui fork mode cannot pull image '${pullRef}' because the configured container runtime does not expose image pulls.`));
-		return yield* runtime.pullImage(pullRef).pipe(Effect.mapError((cause) => suiPluginError("image-build", `sui fork mode failed to pull image '${pullRef}': ${cause.reason}: ${cause.detail}`, cause)));
-	}
+/** Pull a prebuilt fork image, narrating progress on the supervisor row.
+*  Fails with a `SuiPluginError` if the runtime can't pull or the pull errors. */
+const pullForkImage = (runtime, pullRef) => Effect.gen(function* () {
+	if (runtime.pullImage === void 0) return yield* Effect.fail(suiPluginError("image-build", `sui fork mode cannot pull image '${pullRef}' because the configured container runtime does not expose image pulls.`));
+	yield* setCurrentPluginPhase(`pulling sui-fork image ${pullRef}…`);
+	return yield* runtime.pullImage(pullRef).pipe(Effect.mapError((cause) => suiPluginError("image-build", `sui fork mode failed to pull image '${pullRef}': ${cause.reason}: ${cause.detail}`, cause)), Effect.ensuring(setCurrentPluginPhase(null)));
+});
+/** Build the bundled `sui-fork` image from source, narrating the cold
+*  compile so the row doesn't look hung for ~10 minutes on first run. */
+const buildForkImage = (runtime, buildCtx) => Effect.gen(function* () {
+	yield* setCurrentPluginPhase("building sui-fork image — first run compiles sui-fork from source (~10+ min); cached after");
+	return yield* runtime.ensureImage(buildCtx).pipe(Effect.mapError((cause) => suiPluginError("image-build", `sui fork image build failed: ${cause.reason}: ${cause.detail}`, cause)), Effect.ensuring(setCurrentPluginPhase(null)));
+});
+const resolveForkImage = (runtime, identity, opts) => Effect.gen(function* () {
+	if (opts.image && "pull" in opts.image) return yield* pullForkImage(runtime, opts.image.pull);
 	const rev = opts.version ?? "62ee6ada958cd61b3c8a4466dd33c9aba3cdff8a";
-	const buildCtx = opts.image && "build" in opts.image ? {
+	const owner = {
+		app: identity.app,
+		stack: identity.stack,
+		plugin: "sui",
+		role: "validator"
+	};
+	if (opts.image && "build" in opts.image) return yield* buildForkImage(runtime, {
 		contextPath: opts.image.build.context,
 		dockerfile: opts.image.build.dockerfile ?? "Dockerfile",
 		buildArgs: {
 			SUI_FORK_REV: rev,
 			SUI_CLI_VERSION: DEFAULT_SUI_CLI_VERSION
-		}
-	} : suiForkImageBuildContext(rev);
-	return yield* runtime.ensureImage(buildCtx).pipe(Effect.mapError((cause) => suiPluginError("image-build", `sui fork image build failed: ${cause.reason}: ${cause.detail}`, cause)));
+		},
+		owner
+	});
+	const prebuilt = prebuiltForkImageRef();
+	if (prebuilt !== void 0 && runtime.pullImage !== void 0) return yield* pullForkImage(runtime, prebuilt).pipe(Effect.catchTag("SuiPluginError", (cause) => Effect.gen(function* () {
+		yield* Effect.logWarning(`sui fork mode: prebuilt image '${prebuilt}' unavailable (${cause.message}); building from source.`);
+		return yield* buildForkImage(runtime, {
+			...suiForkImageBuildContext(rev),
+			owner
+		});
+	})));
+	return yield* buildForkImage(runtime, {
+		...suiForkImageBuildContext(rev),
+		owner
+	});
 }).pipe(Effect.withSpan("devstack.plugin.sui.fork.resolveImage"));
 const ensureForkContainer = (params) => Effect.gen(function* () {
 	const reusable = params.opts.ports === void 0 ? yield* findReusableForkPort(params.runtime, params.labels, params.containerName) : void 0;
@@ -166,11 +254,11 @@ const allocateForkRpcPort = (portBroker, override) => {
 	const overridePort = override?.[CONTAINER_RPC_PORT];
 	if (overridePort !== void 0) return Effect.succeed(portPublish(CONTAINER_RPC_PORT, overridePort));
 	return portBroker.allocate({
-		kind: "rpc",
+		owner: "sui:fork-rpc",
 		preferredPort: DEFAULT_FORK_HOST_RPC_PORT,
 		probeHost: DOCKER_PUBLISH_HOST
 	}).pipe(Effect.catchTag("PortBrokerError", (cause) => cause.reason === "preferred-busy" ? portBroker.allocate({
-		kind: "rpc",
+		owner: "sui:fork-rpc",
 		probeHost: DOCKER_PUBLISH_HOST
 	}) : Effect.fail(cause)), Effect.map((allocated) => portPublish(CONTAINER_RPC_PORT, allocated.port)), Effect.mapError((cause) => suiPluginError("port-allocate", `sui fork mode: failed to allocate RPC host port: ${cause.detail}`, cause)));
 };
@@ -187,19 +275,21 @@ const forkDataDirKey = (opts) => createHash("sha256").update(JSON.stringify({
 	version: opts.version ?? "62ee6ada958cd61b3c8a4466dd33c9aba3cdff8a",
 	seed: normalizeForkSeed(opts)
 })).digest("hex").slice(0, 16);
-const ensureForkDataDir = (paths, opts) => {
+/** Bring the data dir into being and claim it against concurrent
+*  stacks via the holder protocol. The holder claim is scope-bound —
+*  it heartbeats for the stack's lifetime and releases on teardown. */
+const ensureForkDataDir = (paths, opts) => Effect.gen(function* () {
 	const dataDir = resolve(join(paths.stackRoot, "sui-fork", forkDataDirKey(opts)));
-	return Effect.tryPromise({
-		try: async () => {
-			await mkdir(dataDir, {
-				recursive: true,
-				mode: 448
-			});
-			return dataDir;
-		},
-		catch: (cause) => suiPluginError("fork-data-dir", `sui fork mode: failed to create data directory ${dataDir}: ${stringifyCause(cause)}`, cause)
+	yield* Effect.tryPromise({
+		try: () => mkdir(dataDir, {
+			recursive: true,
+			mode: 448
+		}),
+		catch: (cause) => suiPluginError("fork-data-dir", `sui fork mode: failed to create data directory ${dataDir}: ${formatUnknownError(cause)}`, cause)
 	});
-};
+	yield* acquireForkDataDirHolder(paths.stackLockFile, dataDir);
+	return dataDir;
+});
 const waitForForkReady = (sdkClient, readyTimeout) => Effect.gen(function* () {
 	const readyTimeoutMs = Duration.toMillis(readyTimeout);
 	yield* waitForProbe({
@@ -208,7 +298,7 @@ const waitForForkReady = (sdkClient, readyTimeout) => Effect.gen(function* () {
 		intervalMs: 1e3,
 		attemptTimeoutMs: PROBE_ATTEMPT_TIMEOUT_MS,
 		probe: () => readForkStatus(sdkClient).pipe(Effect.as(true))
-	}).pipe(Effect.mapError((cause) => cause instanceof ProbeTimeoutError ? suiPluginError("fork-status-probe", `sui fork mode: ForkingService.GetStatus did not become ready within ${readyTimeoutMs}ms.`, cause.lastError ?? cause.lastNotReady ?? cause) : suiPluginError("fork-status-probe", `sui fork mode: ForkingService.GetStatus probe failed: ${stringifyCause(cause)}`, cause)));
+	}).pipe(Effect.mapError((cause) => cause instanceof ProbeTimeoutError ? suiPluginError("fork-status-probe", `sui fork mode: ForkingService.GetStatus did not become ready within ${readyTimeoutMs}ms. Inspect the sui-fork container logs (\`docker logs\`); if the image is still building or the upstream checkpoint is large, raise the \`readyTimeout\` option.`, cause.lastError ?? cause.lastNotReady ?? cause) : suiPluginError("fork-status-probe", `sui fork mode: ForkingService.GetStatus probe failed: ${formatUnknownError(cause)}`, cause)));
 	return yield* readForkStatus(sdkClient);
 }).pipe(Effect.withSpan("devstack.plugin.sui.fork.waitForReady"));
 const makeForkAdminSurface = (sdkClient) => ({
@@ -218,17 +308,17 @@ const makeForkAdminSurface = (sdkClient) => ({
 	}))),
 	advanceClock: (intervalMs) => Effect.tryPromise({
 		try: () => sdkClient.forkingService.advanceClock({ durationMs: BigInt(intervalMs) }).response,
-		catch: (cause) => suiPluginError("fork-advance-clock", `sui fork mode: advanceClock(${intervalMs}) failed: ${stringifyCause(cause)}`, cause)
+		catch: (cause) => suiPluginError("fork-advance-clock", `sui fork mode: advanceClock(${intervalMs}) failed: ${formatUnknownError(cause)}`, cause)
 	}).pipe(Effect.asVoid),
 	advanceCheckpoint: Effect.tryPromise({
 		try: () => sdkClient.forkingService.advanceCheckpoint({}).response,
-		catch: (cause) => suiPluginError("fork-advance-checkpoint", `sui fork mode: advanceCheckpoint failed: ${stringifyCause(cause)}`, cause)
+		catch: (cause) => suiPluginError("fork-advance-checkpoint", `sui fork mode: advanceCheckpoint failed: ${formatUnknownError(cause)}`, cause)
 	}).pipe(Effect.asVoid),
 	impersonate: (sender, tx) => Effect.gen(function* () {
 		if (!(tx instanceof Uint8Array)) return yield* Effect.fail(suiPluginError("fork-impersonate", `sui fork mode: impersonate(${sender}) expected serialized transaction bytes.`));
 		yield* verifyForkImpersonationSender(sender, tx);
 		const raw = yield* Effect.tryPromise({
-			try: () => sdkClient.executeTransaction({
+			try: () => sdkClient.core.executeTransaction({
 				transaction: tx,
 				signatures: [],
 				include: {
@@ -236,7 +326,7 @@ const makeForkAdminSurface = (sdkClient) => ({
 					objectTypes: true
 				}
 			}),
-			catch: (cause) => suiPluginError("fork-impersonate", `sui fork mode: impersonate(${sender}) failed: ${stringifyCause(cause)}`, cause)
+			catch: (cause) => suiPluginError("fork-impersonate", `sui fork mode: impersonate(${sender}) failed: ${formatUnknownError(cause)}`, cause)
 		});
 		const digest = extractExecuteDigest(raw);
 		if (digest === void 0) return yield* Effect.fail(suiPluginError("fork-impersonate", `sui fork mode: impersonate(${sender}) returned no transaction digest.`, raw));
@@ -256,28 +346,15 @@ const readForkStatus = (sdkClient) => Effect.tryPromise({
 			forkedAtCheckpoint: response.forkedAtCheckpoint.toString()
 		};
 	},
-	catch: (cause) => suiPluginError("fork-status-probe", `sui fork mode: GetStatus failed: ${stringifyCause(cause)}`, cause)
+	catch: (cause) => suiPluginError("fork-status-probe", `sui fork mode: GetStatus failed: ${formatUnknownError(cause)}`, cause)
 });
-const routedSuiRpcUrl = (identity) => routerHostname(identity, "rpc").pipe(Effect.map((hostname) => renderUrl({
+const routedSuiRpcUrl = (identity) => routedHostname(identity, "rpc").pipe(Effect.map((hostname) => renderUrl({
 	protocol: "http",
 	hostname,
 	port: SUI_RPC_ENTRYPOINT_PORT
 })), Effect.mapError((cause) => suiPluginError("container-start", `sui fork mode: failed to construct router RPC URL: ${cause.detail}`, cause)));
-const extractExecuteDigest = (raw) => {
-	const env = raw;
-	return env.$kind === "FailedTransaction" ? env.FailedTransaction?.digest : env.Transaction?.digest;
-};
 const isFailedTransaction = (raw) => raw.$kind === "FailedTransaction";
-const stringifyCause = (cause) => {
-	if (cause instanceof Error) return cause.message;
-	if (typeof cause === "string") return cause;
-	try {
-		return JSON.stringify(cause);
-	} catch {
-		return String(cause);
-	}
-};
 //#endregion
-export { bootForkMode };
+export { FORK_FAUCET_WHALE_MIN_COIN_MIST, bootForkMode, resolveForkWhale };
 
 //# sourceMappingURL=fork.mjs.map