@mysten-incubation/devstack 0.0.0

package/dist/plugins/sui/fork-transaction.mjs

@@ -0,0 +1,96 @@
+import { suiPluginError } from "./errors.mjs";
+import { Effect } from "effect";
+import { normalizeSuiAddress } from "@mysten/sui/utils";
+import { Inputs, TransactionDataBuilder } from "@mysten/sui/transactions";
+//#region src/plugins/sui/fork-transaction.ts
+const FORK_IMPERSONATION_GAS_BUDGET = 1000000000n;
+const FORK_IMPERSONATION_GAS_PRICE = 1000n;
+const prepareForkImpersonationTransaction = (tx, sender, gasPayment) => {
+	tx.setSender(sender);
+	tx.setGasBudget(FORK_IMPERSONATION_GAS_BUDGET);
+	tx.setGasPrice(FORK_IMPERSONATION_GAS_PRICE);
+	tx.setGasOwner(sender);
+	tx.setGasPayment([...gasPayment]);
+	if (tx.getData().expiration == null) tx.setExpiration({ None: true });
+};
+const buildForkImpersonationTransactionBytes = (tx, sender, client) => Effect.tryPromise({
+	try: async () => {
+		prepareForkImpersonationTransaction(tx, sender, await selectForkImpersonationGasPayment(client, sender));
+		await tx.prepareForSerialization({});
+		const data = tx.getData();
+		data.inputs = await Promise.all(data.inputs.map((input) => resolveForkInput(input, client)));
+		return TransactionDataBuilder.restore(data).build();
+	},
+	catch: (cause) => suiPluginError("fork-impersonate", `sui fork mode: failed to build fork impersonation transaction for ${sender}: ${stringifyCause(cause)}`, cause)
+});
+const resolveForkInput = async (input, client) => {
+	if (input.UnresolvedObject === void 0) return input;
+	const unresolved = input.UnresolvedObject;
+	if (unresolved.initialSharedVersion != null) return Inputs.SharedObjectRef({
+		objectId: unresolved.objectId,
+		initialSharedVersion: unresolved.initialSharedVersion,
+		mutable: unresolved.mutable ?? true
+	});
+	if (unresolved.version != null && unresolved.digest != null) return Inputs.ObjectRef({
+		objectId: unresolved.objectId,
+		version: unresolved.version,
+		digest: unresolved.digest
+	});
+	const object = objectFromGetObjectResponse(await client.getObject({ objectId: unresolved.objectId }));
+	const owner = object.owner;
+	if (owner?.$kind === "Shared" && owner.Shared !== void 0) return Inputs.SharedObjectRef({
+		objectId: object.objectId,
+		initialSharedVersion: owner.Shared.initialSharedVersion,
+		mutable: unresolved.mutable ?? true
+	});
+	return Inputs.ObjectRef({
+		objectId: object.objectId,
+		version: object.version,
+		digest: object.digest
+	});
+};
+const objectFromGetObjectResponse = (response) => {
+	const object = response.object;
+	if (typeof object !== "object" || object === null) throw new Error(`getObject returned no object: ${JSON.stringify(response)}`);
+	const candidate = object;
+	if (typeof candidate.objectId !== "string" || typeof candidate.version !== "string" || typeof candidate.digest !== "string") throw new Error(`getObject returned incomplete object ref: ${JSON.stringify(response)}`);
+	return {
+		objectId: candidate.objectId,
+		version: candidate.version,
+		digest: candidate.digest,
+		owner: candidate.owner
+	};
+};
+const selectForkImpersonationGasPayment = async (client, sender) => {
+	const coin = (await client.listCoins({
+		owner: sender,
+		limit: 1
+	})).objects[0];
+	if (coin === void 0) throw new Error(`no SUI gas coins found for ${sender}`);
+	return [{
+		objectId: coin.objectId,
+		version: String(coin.version),
+		digest: coin.digest
+	}];
+};
+const verifyForkImpersonationSender = (sender, txBytes) => Effect.try({
+	try: () => {
+		const actual = TransactionDataBuilder.fromBytes(txBytes).snapshot().sender;
+		if (actual == null) throw new Error("transaction has no sender");
+		if (normalizeSuiAddress(actual) !== normalizeSuiAddress(sender)) throw new Error(`transaction sender ${actual} does not match impersonated sender ${sender}`);
+	},
+	catch: (cause) => suiPluginError("fork-impersonate", `sui fork mode: refused impersonation transaction: ${stringifyCause(cause)}`, cause)
+});
+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 { buildForkImpersonationTransactionBytes, verifyForkImpersonationSender };
+
+//# sourceMappingURL=fork-transaction.mjs.map

package/dist/plugins/sui/fork-transaction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-transaction.mjs","names":[],"sources":["../../../src/plugins/sui/fork-transaction.ts"],"sourcesContent":["import { Effect } from 'effect';\n\nimport {\n\tInputs,\n\tTransaction,\n\tTransactionDataBuilder,\n\ttype CallArg,\n} from '@mysten/sui/transactions';\nimport { normalizeSuiAddress } from '@mysten/sui/utils';\n\nimport { suiPluginError, type SuiPluginError } from './errors.ts';\n\nexport const FORK_IMPERSONATION_GAS_BUDGET = 1_000_000_000n;\nexport const FORK_IMPERSONATION_GAS_PRICE = 1_000n;\n\ninterface ForkImpersonationGasClient {\n\treadonly getObject: (input: { readonly objectId: string }) => Promise<unknown>;\n\treadonly listCoins: (input: {\n\t\treadonly owner: string;\n\t\treadonly coinType?: string;\n\t\treadonly limit?: number;\n\t}) => Promise<{\n\t\treadonly objects: ReadonlyArray<{\n\t\t\treadonly objectId: string;\n\t\t\treadonly version: string | number | bigint;\n\t\t\treadonly digest: string;\n\t\t\treadonly balance?: string | number | bigint;\n\t\t}>;\n\t}>;\n}\n\nexport const prepareForkImpersonationTransaction = (\n\ttx: Transaction,\n\tsender: string,\n\tgasPayment: ReadonlyArray<{\n\t\treadonly objectId: string;\n\t\treadonly version: string;\n\t\treadonly digest: string;\n\t}>,\n): void => {\n\ttx.setSender(sender);\n\n\ttx.setGasBudget(FORK_IMPERSONATION_GAS_BUDGET);\n\ttx.setGasPrice(FORK_IMPERSONATION_GAS_PRICE);\n\ttx.setGasOwner(sender);\n\ttx.setGasPayment([...gasPayment]);\n\n\tconst data = tx.getData();\n\tif (data.expiration == null) tx.setExpiration({ None: true });\n};\n\nexport const buildForkImpersonationTransactionBytes = (\n\ttx: Transaction,\n\tsender: string,\n\tclient: ForkImpersonationGasClient,\n): Effect.Effect<Uint8Array, SuiPluginError> =>\n\tEffect.tryPromise({\n\t\ttry: async () => {\n\t\t\tconst gasPayment = await selectForkImpersonationGasPayment(client, sender);\n\t\t\tprepareForkImpersonationTransaction(tx, sender, gasPayment);\n\t\t\tawait tx.prepareForSerialization({});\n\t\t\tconst data = tx.getData();\n\t\t\tdata.inputs = await Promise.all(data.inputs.map((input) => resolveForkInput(input, client)));\n\t\t\treturn TransactionDataBuilder.restore(data).build();\n\t\t},\n\t\tcatch: (cause) =>\n\t\t\tsuiPluginError(\n\t\t\t\t'fork-impersonate',\n\t\t\t\t`sui fork mode: failed to build fork impersonation transaction for ${sender}: ${stringifyCause(cause)}`,\n\t\t\t\tcause,\n\t\t\t),\n\t});\n\nconst resolveForkInput = async (\n\tinput: CallArg,\n\tclient: ForkImpersonationGasClient,\n): Promise<CallArg> => {\n\tif (input.UnresolvedObject === undefined) return input;\n\tconst unresolved = input.UnresolvedObject;\n\tif (unresolved.initialSharedVersion != null) {\n\t\treturn Inputs.SharedObjectRef({\n\t\t\tobjectId: unresolved.objectId,\n\t\t\tinitialSharedVersion: unresolved.initialSharedVersion,\n\t\t\tmutable: unresolved.mutable ?? true,\n\t\t});\n\t}\n\tif (unresolved.version != null && unresolved.digest != null) {\n\t\treturn Inputs.ObjectRef({\n\t\t\tobjectId: unresolved.objectId,\n\t\t\tversion: unresolved.version,\n\t\t\tdigest: unresolved.digest,\n\t\t});\n\t}\n\n\tconst object = objectFromGetObjectResponse(\n\t\tawait client.getObject({ objectId: unresolved.objectId }),\n\t);\n\tconst owner = object.owner;\n\tif (owner?.$kind === 'Shared' && owner.Shared !== undefined) {\n\t\treturn Inputs.SharedObjectRef({\n\t\t\tobjectId: object.objectId,\n\t\t\tinitialSharedVersion: owner.Shared.initialSharedVersion,\n\t\t\tmutable: unresolved.mutable ?? true,\n\t\t});\n\t}\n\treturn Inputs.ObjectRef({\n\t\tobjectId: object.objectId,\n\t\tversion: object.version,\n\t\tdigest: object.digest,\n\t});\n};\n\nconst objectFromGetObjectResponse = (\n\tresponse: unknown,\n): {\n\treadonly objectId: string;\n\treadonly version: string;\n\treadonly digest: string;\n\treadonly owner?: {\n\t\treadonly $kind?: string;\n\t\treadonly Shared?: { readonly initialSharedVersion: string };\n\t};\n} => {\n\tconst object = (response as { readonly object?: unknown }).object;\n\tif (typeof object !== 'object' || object === null) {\n\t\tthrow new Error(`getObject returned no object: ${JSON.stringify(response)}`);\n\t}\n\tconst candidate = object as {\n\t\treadonly objectId?: unknown;\n\t\treadonly version?: unknown;\n\t\treadonly digest?: unknown;\n\t\treadonly owner?: {\n\t\t\treadonly $kind?: string;\n\t\t\treadonly Shared?: { readonly initialSharedVersion: string };\n\t\t};\n\t};\n\tif (\n\t\ttypeof candidate.objectId !== 'string' ||\n\t\ttypeof candidate.version !== 'string' ||\n\t\ttypeof candidate.digest !== 'string'\n\t) {\n\t\tthrow new Error(`getObject returned incomplete object ref: ${JSON.stringify(response)}`);\n\t}\n\treturn {\n\t\tobjectId: candidate.objectId,\n\t\tversion: candidate.version,\n\t\tdigest: candidate.digest,\n\t\towner: candidate.owner,\n\t};\n};\n\nconst selectForkImpersonationGasPayment = async (\n\tclient: ForkImpersonationGasClient,\n\tsender: string,\n): Promise<\n\tReadonlyArray<{ readonly objectId: string; readonly version: string; readonly digest: string }>\n> => {\n\tconst response = await client.listCoins({ owner: sender, limit: 1 });\n\tconst coin = response.objects[0];\n\tif (coin === undefined) {\n\t\tthrow new Error(`no SUI gas coins found for ${sender}`);\n\t}\n\treturn [\n\t\t{\n\t\t\tobjectId: coin.objectId,\n\t\t\tversion: String(coin.version),\n\t\t\tdigest: coin.digest,\n\t\t},\n\t];\n};\n\nexport const verifyForkImpersonationSender = (\n\tsender: string,\n\ttxBytes: Uint8Array,\n): Effect.Effect<void, SuiPluginError> =>\n\tEffect.try({\n\t\ttry: () => {\n\t\t\tconst actual = TransactionDataBuilder.fromBytes(txBytes).snapshot().sender;\n\t\t\tif (actual == null) {\n\t\t\t\tthrow new Error('transaction has no sender');\n\t\t\t}\n\t\t\tif (normalizeSuiAddress(actual) !== normalizeSuiAddress(sender)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`transaction sender ${actual} does not match impersonated sender ${sender}`,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t\tcatch: (cause) =>\n\t\t\tsuiPluginError(\n\t\t\t\t'fork-impersonate',\n\t\t\t\t`sui fork mode: refused impersonation transaction: ${stringifyCause(cause)}`,\n\t\t\t\tcause,\n\t\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":"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"}

package/dist/plugins/sui/index.d.mts

@@ -0,0 +1,318 @@
+import { ChainId } from "../../substrate/brand.mjs";
+import { CodegenableDecl } from "../../contracts/codegenable.mjs";
+import { RoutableDecl } from "../../contracts/routable.mjs";
+import { SnapshotableDecl } from "../../contracts/snapshotable.mjs";
+import { StrategyContributorDecl } from "../../contracts/strategy-contributor.mjs";
+import { Plugin } from "../../substrate/plugin.mjs";
+import { ImageRef } from "../../contracts/container-runtime.mjs";
+import { ModeNamespace } from "../../api/mode-narrowed-factory.mjs";
+import { ChainProbe, ChainProbeError, ChainProbeMode } from "../../contracts/chain-probe.mjs";
+import { SuiProbeKey, SuiSdkShim } from "./chain-probe.mjs";
+import { LeaseBroker } from "../../substrate/runtime/lease-broker/service.mjs";
+import { FaucetStrategy } from "../faucet/strategies/sui-local.mjs";
+import { SeedObjectsAccumulator } from "./seed-objects.mjs";
+import { ForkUnsupportedError, SeedManifestMismatchError, SuiCliError, SuiConfigError, SuiError, SuiFundsReadyError, SuiPluginError } from "./errors.mjs";
+import { ForkAdminSurface, SuiClient, WaitForTransactionsReady } from "./mode/shared.mjs";
+import { SuiForkOptions, SuiLiveOptions, SuiLocalOptions, SuiLocalRpcOptions, SuiOptions, SuiPluginMode } from "./mode/spec.mjs";
+import { FundsReadyError, FundsReadyStrategy } from "../../contracts/network-resolver.mjs";
+import { ResolvedSuiNetwork } from "./network-resolver.mjs";
+import { SuiNetworkBindings } from "./codegen.mjs";
+import { Effect } from "effect";
+
+//#region src/plugins/sui/index.d.ts
+declare const fundingFaucetLeaseBrokerSymbol: unique symbol;
+/** The Sui plugin's resource identity. The id is `'sui'` (singular). */
+/** Local Sui shorthand. Network/env selection belongs to the CLI or
+ *  `defineDevstackWith(...)`; plain `sui()` always means an in-stack
+ *  local validator. */
+declare const sui: (opts?: SuiOptions) => Plugin<"sui", {
+  mode: "local" | "local-rpc" | "live" | "fork";
+  seedObjects: SeedObjectsAccumulator;
+  [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+  sdk: SuiSdkShim;
+  rpcUrl: string;
+  faucetUrl: string | null;
+  fundingFaucetUrl: string | null;
+  graphqlUrl: string | null;
+  hostGateway: {
+    readonly rpcUrl: string;
+    readonly faucetUrl: string | null;
+    readonly graphqlUrl: string | null;
+  };
+  chain: ChainId;
+  waitForTransactionsReady: WaitForTransactionsReady;
+  chainProbe: ChainProbe<SuiProbeKey>;
+  fork: ForkAdminSurface | null;
+  buildImage: ImageRef | null;
+}, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+  kind: "strategy-contributor";
+  capabilityKey: `faucet:request:${ChainId}`;
+  strategy: FaucetStrategy;
+  autoMounted: true;
+} | StrategyContributorDecl<"gate:funds-ready", {
+  readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+}> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+/** Mode-narrowed factory namespace.
+ *
+ *  Usage:
+ *      const network = { mode: 'local', chain: 'sui:localnet' } as const;
+ *      suiFor(network).local({...})    // OK
+ *      suiFor(network).fork({...})     // type error: 'fork' not in 'local' branch
+ *
+ *  The namespace MIRRORS the four mode option records: `local`,
+ *  `localRpc` (mapped onto the substrate `'local'` branch),
+ *  `live`, `fork`. */
+declare const suiFor: ModeNamespace<{
+  local: {
+    local: (opts?: Omit<SuiLocalOptions, "mode">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    localRpc: (opts: Omit<SuiLocalRpcOptions, "mode">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+  };
+  live: {
+    testnet: (opts?: Omit<SuiLiveOptions, "mode" | "network">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    mainnet: (opts?: Omit<SuiLiveOptions, "mode" | "network">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    devnet: (opts?: Omit<SuiLiveOptions, "mode" | "network">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    custom: (opts: Omit<SuiLiveOptions, "mode" | "network">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+  };
+  fork: {
+    mainnet: (opts?: Omit<SuiForkOptions, "mode" | "upstream">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    testnet: (opts?: Omit<SuiForkOptions, "mode" | "upstream">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+    devnet: (opts?: Omit<SuiForkOptions, "mode" | "upstream">) => Plugin<"sui", {
+      mode: "local" | "local-rpc" | "live" | "fork";
+      seedObjects: SeedObjectsAccumulator;
+      [fundingFaucetLeaseBrokerSymbol]: LeaseBroker;
+      sdk: SuiSdkShim;
+      rpcUrl: string;
+      faucetUrl: string | null;
+      fundingFaucetUrl: string | null;
+      graphqlUrl: string | null;
+      hostGateway: {
+        readonly rpcUrl: string;
+        readonly faucetUrl: string | null;
+        readonly graphqlUrl: string | null;
+      };
+      chain: ChainId;
+      waitForTransactionsReady: WaitForTransactionsReady;
+      chainProbe: ChainProbe<SuiProbeKey>;
+      fork: ForkAdminSurface | null;
+      buildImage: ImageRef | null;
+    }, readonly [], readonly [SnapshotableDecl, CodegenableDecl<"sui-network">, StrategyContributorDecl<`chain-probe:${string}`, ChainProbe<SuiProbeKey>>, ...(RoutableDecl | {
+      kind: "strategy-contributor";
+      capabilityKey: `faucet:request:${ChainId}`;
+      strategy: FaucetStrategy;
+      autoMounted: true;
+    } | StrategyContributorDecl<"gate:funds-ready", {
+      readonly waitFundsReady: Effect.Effect<void, SuiPluginError>;
+    }> | StrategyContributorDecl<"sui:seed-objects", SeedObjectsAccumulator>)[]]>;
+  };
+}>;
+//#endregion
+export { sui, suiFor };
+//# sourceMappingURL=index.d.mts.map

package/dist/plugins/sui/index.mjs

@@ -0,0 +1,182 @@
+import { definePlugin, resource } from "../../substrate/plugin.mjs";
+import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
+import { IdentityContext, StackPathsService } from "../../substrate/runtime/paths.mjs";
+import { PortBrokerService } from "../../substrate/runtime/port-broker/service.mjs";
+import { defineModeNamespace } from "../../api/mode-narrowed-factory.mjs";
+import { FUNDS_READY_GATE_KEY } from "../../contracts/network-resolver.mjs";
+import { chainProbeCapabilityKey } from "../../contracts/chain-probe.mjs";
+import { ContainerRuntimeService } from "../../runtime/docker/service.mjs";
+import { LeaseBrokerService } from "../../substrate/runtime/lease-broker/service.mjs";
+import { makeCodegenable } from "./codegen.mjs";
+import { makeSnapshotable } from "./snapshot.mjs";
+import { SEED_OBJECTS_CAPABILITY_KEY, makeSeedObjectsAccumulator } from "./seed-objects.mjs";
+import { SUI_ERROR_TAGS } from "./errors.mjs";
+import { makeSuiForkRoutables, makeSuiLocalRoutables } from "./routable.mjs";
+import "./fork-orchestration.mjs";
+import { bootSuiService } from "./service.mjs";
+import { faucetCapabilityKey } from "../faucet/dispatcher.mjs";
+import { suiLocalStrategy } from "../faucet/strategies/sui-local.mjs";
+import { Effect } from "effect";
+//#region src/plugins/sui/index.ts
+const fundingFaucetLeaseBrokerSymbol = Symbol("@mysten-incubation/devstack/sui/fundingFaucetLeaseBroker");
+/** The Sui plugin's resource identity. The id is `'sui'` (singular). */
+const suiResource = resource("sui");
+const suiErrorContributions = pluginErrorContributions(SUI_ERROR_TAGS);
+const buildPlugin = (opts) => {
+	return definePlugin({
+		id: suiResource.id,
+		role: "service",
+		start: () => Effect.gen(function* () {
+			const runtime = yield* ContainerRuntimeService;
+			const identity = yield* IdentityContext;
+			const paths = yield* StackPathsService;
+			const portBroker = yield* PortBrokerService;
+			const fundingFaucetLeaseBroker = yield* LeaseBrokerService;
+			const { client } = yield* bootSuiService(runtime, identity, portBroker, paths, opts);
+			const seedObjects = yield* makeSeedObjectsAccumulator();
+			return {
+				...client,
+				mode: opts.mode,
+				seedObjects,
+				[fundingFaucetLeaseBrokerSymbol]: fundingFaucetLeaseBroker
+			};
+		}),
+		capabilities: ({ value, runtime }) => makePluginCapabilities(opts, value, runtime),
+		errorContributions: suiErrorContributions
+	});
+};
+/** Construct the capability tuple POST-acquire. Receives the resolved
+*  `SuiClient` + acquire context so decls can stamp REAL chain ids /
+*  rpc URLs into their fields instead of factory-time placeholders.
+*
+*  StrategyContributor declarations here carry real post-acquire
+*  strategy values. The generic strategy sink registers them on the
+*  scope-local `StrategyRegistry`. */
+const makePluginCapabilities = (opts, resolved, acquireCtx) => {
+	const realChain = resolved.chain;
+	const resolvedRuntime = resolved;
+	const snap = makeSnapshotable(opts.mode, acquireCtx.identity.app, acquireCtx.identity.stack, realChain);
+	const codegen = makeCodegenable({
+		mode: opts.mode,
+		chain: realChain,
+		rpc: resolved.rpcUrl,
+		source: "default",
+		...resolved.faucetUrl !== null ? { faucet: resolved.faucetUrl } : {},
+		...resolved.graphqlUrl !== null ? { graphql: resolved.graphqlUrl } : {}
+	});
+	const chainProbeContribution = {
+		kind: "strategy-contributor",
+		capabilityKey: chainProbeCapabilityKey(realChain),
+		strategy: resolved.chainProbe,
+		autoMounted: true
+	};
+	const fundsReadyContribution = {
+		kind: "strategy-contributor",
+		capabilityKey: FUNDS_READY_GATE_KEY,
+		strategy: { waitFundsReady: resolved.waitForTransactionsReady.wait },
+		autoMounted: true
+	};
+	const seedObjectsContribution = {
+		kind: "strategy-contributor",
+		capabilityKey: SEED_OBJECTS_CAPABILITY_KEY,
+		strategy: resolved.seedObjects,
+		autoMounted: true
+	};
+	const faucetContribution = resolved.fundingFaucetUrl === null ? [] : [{
+		kind: "strategy-contributor",
+		capabilityKey: faucetCapabilityKey(realChain),
+		strategy: suiLocalStrategy({
+			faucetUrl: resolved.fundingFaucetUrl,
+			serialization: {
+				broker: resolvedRuntime[fundingFaucetLeaseBrokerSymbol],
+				key: `sui-faucet:${realChain}`,
+				owner: `sui-faucet:${realChain}`
+			}
+		}),
+		autoMounted: true
+	}];
+	const localRoutables = opts.mode === "local" ? makeSuiLocalRoutables({
+		containerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-validator`,
+		includeGraphql: true
+	}) : [];
+	const forkRoutables = opts.mode === "fork" ? makeSuiForkRoutables({ containerName: `devstack-${acquireCtx.identity.app}-${acquireCtx.identity.stack}-sui-fork` }) : [];
+	return [
+		snap,
+		codegen,
+		chainProbeContribution,
+		...faucetContribution,
+		fundsReadyContribution,
+		seedObjectsContribution,
+		...localRoutables,
+		...forkRoutables
+	];
+};
+/** Local Sui shorthand. Network/env selection belongs to the CLI or
+*  `defineDevstackWith(...)`; plain `sui()` always means an in-stack
+*  local validator. */
+const sui = (opts = { mode: "local" }) => buildPlugin(opts);
+/** Mode-narrowed factory namespace.
+*
+*  Usage:
+*      const network = { mode: 'local', chain: 'sui:localnet' } as const;
+*      suiFor(network).local({...})    // OK
+*      suiFor(network).fork({...})     // type error: 'fork' not in 'local' branch
+*
+*  The namespace MIRRORS the four mode option records: `local`,
+*  `localRpc` (mapped onto the substrate `'local'` branch),
+*  `live`, `fork`. */
+const suiFor = defineModeNamespace({
+	local: {
+		local: (opts = {}) => buildPlugin({
+			mode: "local",
+			...opts
+		}),
+		localRpc: (opts) => buildPlugin({
+			mode: "local-rpc",
+			...opts
+		})
+	},
+	live: {
+		testnet: (opts = {}) => buildPlugin({
+			mode: "live",
+			network: "testnet",
+			...opts
+		}),
+		mainnet: (opts = {}) => buildPlugin({
+			mode: "live",
+			network: "mainnet",
+			...opts
+		}),
+		devnet: (opts = {}) => buildPlugin({
+			mode: "live",
+			network: "devnet",
+			...opts
+		}),
+		custom: (opts) => buildPlugin({
+			mode: "live",
+			network: "custom",
+			...opts
+		})
+	},
+	fork: {
+		mainnet: (opts = {}) => buildPlugin({
+			mode: "fork",
+			upstream: "mainnet",
+			...opts
+		}),
+		testnet: (opts = {}) => buildPlugin({
+			mode: "fork",
+			upstream: "testnet",
+			...opts
+		}),
+		devnet: (opts = {}) => buildPlugin({
+			mode: "fork",
+			upstream: "devnet",
+			...opts
+		})
+	}
+});
+//#endregion
+export { sui, suiFor, suiResource };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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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"}