@mysten-incubation/devstack 0.0.0

package/dist/plugins/deepbook/faucet-strategy.mjs

@@ -0,0 +1,81 @@
+import { deepbookPluginError } from "./errors.mjs";
+import { Effect } from "effect";
+import { Transaction } from "@mysten/sui/transactions";
+import { DeepBookClient } from "@mysten/deepbook-v3";
+//#region src/plugins/deepbook/faucet-strategy.ts
+const DEEPBOOK_TESTNET_DEEP_COIN_TYPE = "0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP";
+const DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY = `coinType:${DEEPBOOK_TESTNET_DEEP_COIN_TYPE}`;
+const DEEPBOOK_DEEP_POOL_KEY = "DEEP_SUI";
+const DEEP_SCALAR = 1000000n;
+const SUI_SCALAR = 1000000000n;
+const DEFAULT_INPUT_BUFFER_BPS = 500n;
+const decimalToRaw = (value, scalar, round) => {
+	const scaled = value * Number(scalar);
+	if (!Number.isFinite(scaled) || scaled < 0) return Effect.fail(deepbookPluginError("fund-deep", `DeepBook quote returned an invalid decimal amount: ${value}.`));
+	return Effect.succeed(BigInt(round === "ceil" ? Math.ceil(scaled) : Math.floor(scaled)));
+};
+const applyInputBuffer = (raw, bufferBps) => (raw * (10000n + bufferBps) + 9999n) / 10000n;
+const buildDeepbookClient = (req, suiSdk) => new DeepBookClient({
+	address: req.account.address,
+	client: suiSdk.client,
+	network: "testnet"
+});
+const makeDeepbookDeepFundingStrategy = (opts) => ({
+	usesAccountSigner: true,
+	request: (req) => Effect.gen(function* () {
+		if (req.amount <= 0n) return;
+		const deepBook = buildDeepbookClient(req, opts.suiSdk);
+		const quote = yield* Effect.tryPromise({
+			try: () => deepBook.getQuoteQuantityIn(DEEPBOOK_DEEP_POOL_KEY, req.amount, false),
+			catch: (cause) => deepbookPluginError("fund-deep", `DeepBook DEEP funding quote failed for ${req.amount} base units.`, { cause })
+		});
+		const baseOutRaw = yield* decimalToRaw(quote.baseOut, DEEP_SCALAR, "floor");
+		if (baseOutRaw < req.amount) return yield* Effect.fail(deepbookPluginError("fund-deep", `DeepBook DEEP funding quote cannot satisfy ${req.amount} base units; quoted ${baseOutRaw}.`));
+		const quoteInRaw = yield* decimalToRaw(quote.quoteIn, SUI_SCALAR, "ceil");
+		if (quoteInRaw <= 0n) return yield* Effect.fail(deepbookPluginError("fund-deep", `DeepBook DEEP funding quote returned zero SUI input for ${req.amount} base units.`));
+		const quoteAmountRaw = applyInputBuffer(quoteInRaw, opts.inputBufferBps ?? DEFAULT_INPUT_BUFFER_BPS);
+		const deepAmountRaw = yield* decimalToRaw(quote.deepRequired, DEEP_SCALAR, "ceil");
+		yield* req.account.withTransactionSigner((lockedSigner) => Effect.gen(function* () {
+			const tx = yield* Effect.try({
+				try: () => {
+					const transaction = new Transaction();
+					transaction.setSender(req.account.address);
+					const [baseCoin, quoteCoin, deepCoin] = transaction.add(deepBook.deepBook.swapExactQuantity({
+						poolKey: DEEPBOOK_DEEP_POOL_KEY,
+						amount: quoteAmountRaw,
+						deepAmount: deepAmountRaw,
+						minOut: req.amount,
+						isBaseToCoin: false
+					}));
+					transaction.transferObjects([
+						baseCoin,
+						quoteCoin,
+						deepCoin
+					], req.address);
+					return transaction;
+				},
+				catch: (cause) => deepbookPluginError("fund-deep", "DeepBook DEEP funding transaction build failed.", { cause })
+			});
+			const txBytes = yield* Effect.tryPromise({
+				try: () => tx.build({ client: opts.suiSdk.client }),
+				catch: (cause) => deepbookPluginError("fund-deep", `DeepBook DEEP funding transaction serialization failed: ${cause instanceof Error ? cause.message : String(cause)}.`, { cause })
+			});
+			yield* lockedSigner.signAndExecute(txBytes).pipe(Effect.mapError((cause) => deepbookPluginError("fund-deep", `DeepBook DEEP funding transaction failed for account '${req.account.name}'.`, { cause })));
+		})).pipe(Effect.asVoid);
+	}).pipe(Effect.withSpan("devstack.plugin.deepbook.fundDeep", { attributes: {
+		"account.name": req.account.name,
+		"account.address": req.account.address,
+		"fund.coin": DEEPBOOK_TESTNET_DEEP_COIN_TYPE,
+		"fund.amount": req.amount.toString()
+	} }))
+});
+const makeDeepbookDeepFundingContribution = (strategy) => ({
+	kind: "strategy-contributor",
+	capabilityKey: DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY,
+	strategy,
+	autoMounted: true
+});
+//#endregion
+export { DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY, DEEPBOOK_TESTNET_DEEP_COIN_TYPE, makeDeepbookDeepFundingContribution, makeDeepbookDeepFundingStrategy };
+
+//# sourceMappingURL=faucet-strategy.mjs.map

package/dist/plugins/deepbook/faucet-strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"faucet-strategy.mjs","names":[],"sources":["../../../src/plugins/deepbook/faucet-strategy.ts"],"sourcesContent":["// DeepBook DEEP funding strategy.\n//\n// Testnet DEEP has no public mint faucet. The usable funding path is a\n// real DeepBook swap from the requesting account's SUI balance into\n// DEEP. This strategy is contributed by the known testnet DeepBook\n// plugin under the standard `coinType:<fullCoinType>` key, so accounts\n// can request DEEP through the same cross-cutting funding pipeline as\n// SUI and WAL.\n\nimport { Effect } from 'effect';\n\nimport { DeepBookClient, type DeepBookCompatibleClient } from '@mysten/deepbook-v3';\nimport { Transaction } from '@mysten/sui/transactions';\n\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport type { AccountFundingRequest, AccountFundingStrategy } from '../account/funding.ts';\nimport type { SuiSdkShim } from '../sui/chain-probe.ts';\n\nimport { deepbookPluginError, type DeepbookPluginError } from './errors.ts';\n\nexport const DEEPBOOK_TESTNET_DEEP_COIN_TYPE =\n\t'0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP' as const;\nexport const DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY =\n\t`coinType:${DEEPBOOK_TESTNET_DEEP_COIN_TYPE}` as const;\n\nconst DEEPBOOK_DEEP_POOL_KEY = 'DEEP_SUI';\nconst DEEP_SCALAR = 1_000_000n;\nconst SUI_SCALAR = 1_000_000_000n;\nconst DEFAULT_INPUT_BUFFER_BPS = 500n;\n\ntype TransactionBuildClient = Parameters<Transaction['build']>[0] extends\n\t| { readonly client?: infer Client }\n\t| undefined\n\t? Client\n\t: never;\n\nexport interface DeepbookDeepFundingStrategyOptions {\n\treadonly suiSdk: SuiSdkShim;\n\t/** Extra SUI input above the quote. 500 bps means 5%. */\n\treadonly inputBufferBps?: bigint;\n}\n\nexport type DeepbookDeepFundingStrategy = AccountFundingStrategy<DeepbookPluginError>;\n\nconst decimalToRaw = (\n\tvalue: number,\n\tscalar: bigint,\n\tround: 'ceil' | 'floor',\n): Effect.Effect<bigint, DeepbookPluginError> => {\n\tconst scaled = value * Number(scalar);\n\tif (!Number.isFinite(scaled) || scaled < 0) {\n\t\treturn Effect.fail(\n\t\t\tdeepbookPluginError(\n\t\t\t\t'fund-deep',\n\t\t\t\t`DeepBook quote returned an invalid decimal amount: ${value}.`,\n\t\t\t),\n\t\t);\n\t}\n\treturn Effect.succeed(BigInt(round === 'ceil' ? Math.ceil(scaled) : Math.floor(scaled)));\n};\n\nconst applyInputBuffer = (raw: bigint, bufferBps: bigint): bigint =>\n\t(raw * (10_000n + bufferBps) + 9_999n) / 10_000n;\n\nconst buildDeepbookClient = (req: AccountFundingRequest, suiSdk: SuiSdkShim): DeepBookClient =>\n\tnew DeepBookClient({\n\t\taddress: req.account.address,\n\t\tclient: suiSdk.client as DeepBookCompatibleClient,\n\t\tnetwork: 'testnet',\n\t});\n\nexport const makeDeepbookDeepFundingStrategy = (\n\topts: DeepbookDeepFundingStrategyOptions,\n): DeepbookDeepFundingStrategy => ({\n\tusesAccountSigner: true,\n\trequest: (req) =>\n\t\tEffect.gen(function* () {\n\t\t\tif (req.amount <= 0n) return;\n\n\t\t\tconst deepBook = buildDeepbookClient(req, opts.suiSdk);\n\t\t\tconst quote = yield* Effect.tryPromise({\n\t\t\t\ttry: () => deepBook.getQuoteQuantityIn(DEEPBOOK_DEEP_POOL_KEY, req.amount, false),\n\t\t\t\tcatch: (cause): DeepbookPluginError =>\n\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t`DeepBook DEEP funding quote failed for ${req.amount} base units.`,\n\t\t\t\t\t\t{ cause },\n\t\t\t\t\t),\n\t\t\t});\n\n\t\t\tconst baseOutRaw = yield* decimalToRaw(quote.baseOut, DEEP_SCALAR, 'floor');\n\t\t\tif (baseOutRaw < req.amount) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t`DeepBook DEEP funding quote cannot satisfy ${req.amount} base units; quoted ${baseOutRaw}.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst quoteInRaw = yield* decimalToRaw(quote.quoteIn, SUI_SCALAR, 'ceil');\n\t\t\tif (quoteInRaw <= 0n) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t`DeepBook DEEP funding quote returned zero SUI input for ${req.amount} base units.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst quoteAmountRaw = applyInputBuffer(\n\t\t\t\tquoteInRaw,\n\t\t\t\topts.inputBufferBps ?? DEFAULT_INPUT_BUFFER_BPS,\n\t\t\t);\n\t\t\tconst deepAmountRaw = yield* decimalToRaw(quote.deepRequired, DEEP_SCALAR, 'ceil');\n\n\t\t\tyield* req.account\n\t\t\t\t.withTransactionSigner((lockedSigner) =>\n\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\tconst tx = yield* Effect.try({\n\t\t\t\t\t\t\ttry: () => {\n\t\t\t\t\t\t\t\tconst transaction = new Transaction();\n\t\t\t\t\t\t\t\ttransaction.setSender(req.account.address);\n\t\t\t\t\t\t\t\tconst [baseCoin, quoteCoin, deepCoin] = transaction.add(\n\t\t\t\t\t\t\t\t\tdeepBook.deepBook.swapExactQuantity({\n\t\t\t\t\t\t\t\t\t\tpoolKey: DEEPBOOK_DEEP_POOL_KEY,\n\t\t\t\t\t\t\t\t\t\tamount: quoteAmountRaw,\n\t\t\t\t\t\t\t\t\t\tdeepAmount: deepAmountRaw,\n\t\t\t\t\t\t\t\t\t\tminOut: req.amount,\n\t\t\t\t\t\t\t\t\t\tisBaseToCoin: false,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\ttransaction.transferObjects([baseCoin, quoteCoin, deepCoin], req.address);\n\t\t\t\t\t\t\t\treturn transaction;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tcatch: (cause): DeepbookPluginError =>\n\t\t\t\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t\t\t\t'DeepBook DEEP funding transaction build failed.',\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tconst txBytes = yield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: () =>\n\t\t\t\t\t\t\t\ttx.build({\n\t\t\t\t\t\t\t\t\tclient: opts.suiSdk.client as TransactionBuildClient,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcatch: (cause): DeepbookPluginError =>\n\t\t\t\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t\t\t\t`DeepBook DEEP funding transaction serialization failed: ${\n\t\t\t\t\t\t\t\t\t\tcause instanceof Error ? cause.message : String(cause)\n\t\t\t\t\t\t\t\t\t}.`,\n\t\t\t\t\t\t\t\t\t{ cause },\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tyield* lockedSigner\n\t\t\t\t\t\t\t.signAndExecute(txBytes)\n\t\t\t\t\t\t\t.pipe(\n\t\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t\t(cause): DeepbookPluginError =>\n\t\t\t\t\t\t\t\t\t\tdeepbookPluginError(\n\t\t\t\t\t\t\t\t\t\t\t'fund-deep',\n\t\t\t\t\t\t\t\t\t\t\t`DeepBook DEEP funding transaction failed for account '${req.account.name}'.`,\n\t\t\t\t\t\t\t\t\t\t\t{ cause },\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t}),\n\t\t\t\t)\n\t\t\t\t.pipe(Effect.asVoid);\n\t\t}).pipe(\n\t\t\tEffect.withSpan('devstack.plugin.deepbook.fundDeep', {\n\t\t\t\tattributes: {\n\t\t\t\t\t'account.name': req.account.name,\n\t\t\t\t\t'account.address': req.account.address,\n\t\t\t\t\t'fund.coin': DEEPBOOK_TESTNET_DEEP_COIN_TYPE,\n\t\t\t\t\t'fund.amount': req.amount.toString(),\n\t\t\t\t},\n\t\t\t}),\n\t\t),\n});\n\nexport const makeDeepbookDeepFundingContribution = (\n\tstrategy: DeepbookDeepFundingStrategy,\n): StrategyContributorDecl<\n\ttypeof DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY,\n\tDeepbookDeepFundingStrategy\n> => ({\n\tkind: 'strategy-contributor',\n\tcapabilityKey: DEEPBOOK_DEEP_FAUCET_STRATEGY_KEY,\n\tstrategy,\n\tautoMounted: true,\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,171 @@
+import { CodegenableDecl } from "../../contracts/codegenable.mjs";
+import { SnapshotableDecl } from "../../contracts/snapshotable.mjs";
+import { StrategyContributorDecl } from "../../contracts/strategy-contributor.mjs";
+import { Plugin, ResourceRef } from "../../substrate/plugin.mjs";
+import { ModeNamespace } from "../../api/mode-narrowed-factory.mjs";
+import { SeedObjectsAccumulator } from "../sui/seed-objects.mjs";
+import { SuiClient } from "../sui/mode/shared.mjs";
+import { SuiOptions } from "../sui/mode/spec.mjs";
+import { DeepbookConfigError, DeepbookError, DeepbookPhase, DeepbookPluginError } from "./errors.mjs";
+import { DeepbookDeepFundingStrategy } from "./faucet-strategy.mjs";
+import { AccountMemberAlias, CoinMemberAlias, DEEP_PRICE_FEED_ID, DeepbookPackageMember, DeepbookPool, DeepbookPoolCoin, DeepbookPoolSeedLiquidity, DeepbookPoolSeedOrder, DeepbookPoolSpec, PythFeed, PythHandle, PythOptions, PythPackageMember, PythPriceFeedId, SUI_PRICE_FEED_ID, USDC_PRICE_FEED_ID, pythPriceFeedId } from "./types.mjs";
+import { DeepbookBindings, DeepbookPoolBinding } from "./codegen.mjs";
+//#region src/plugins/deepbook/index.d.ts
+/** The deepbook resolved value. Mode-asymmetric:
+ *
+ *   - `adminCapId` is `null` for known-deployment mode.
+ *   - `margin` / `serverUrl` / `indexerUrl` / `marketMakerRunning`
+ *     are `null` when the corresponding sub-feature is not enabled. */
+interface DeepbookResolved {
+  readonly mode: 'local' | 'override' | 'known';
+  readonly chain: string;
+  readonly packageId: string;
+  readonly registryId: string;
+  readonly adminCapId: string | null;
+  readonly deepTreasuryId: string | null;
+  readonly pools: ReadonlyArray<DeepbookPool>;
+  readonly pyth: PythHandle | null;
+  readonly margin: {
+    readonly packageId: string;
+    readonly registryId: string;
+  } | null;
+  readonly serverUrl: string | null;
+  readonly indexerUrl: string | null;
+  readonly marketMakerRunning: boolean;
+  readonly deepFundingStrategy: DeepbookDeepFundingStrategy | null;
+}
+interface DeepbookCommonOptions {
+  readonly name?: string;
+}
+/** Override mode wraps an explicitly supplied deployment. It does not
+ *  publish or manage DeepBook locally. */
+interface DeepbookOverrideOptions extends DeepbookCommonOptions {
+  readonly packageId: string;
+  readonly registryId: string;
+  readonly adminCapId: string;
+  readonly chain?: string;
+}
+/** Local mode wraps an explicitly supplied local DeepBook package. */
+interface DeepbookLocalOptions<Publisher extends AccountMemberAlias = AccountMemberAlias, Package extends DeepbookPackageMember = DeepbookPackageMember, Pools extends ReadonlyArray<DeepbookPoolSpec> = readonly [], Pyth extends PythOptions | undefined = undefined> extends DeepbookCommonOptions {
+  /** Publisher account — Direct Member Ref (locked API decision). */
+  readonly publisher: Publisher;
+  /** Published DeepBook package member. The package must capture the
+   *  `registry::Registry` and `registry::DeepbookAdminCap` object ids. */
+  readonly package: Package;
+  /** Optional local mock-Pyth package + feed setup. */
+  readonly pyth?: Pyth;
+  /** Capture key for the package-created `registry::Registry`. */
+  readonly registryIdKey?: string;
+  /** Capture key for the package-created `registry::DeepbookAdminCap`. */
+  readonly adminCapIdKey?: string;
+  /** Optional capture key for a DEEP treasury object used by SDK bindings. */
+  readonly deepTreasuryIdKey?: string;
+  /** Pools to create after the DeepBook package publishes. Pass `[]`
+   *  only for composition tests or known-empty deployments. */
+  readonly pools: Pools;
+}
+type DeepbookKnownNetwork = 'mainnet' | 'testnet';
+interface DeepbookKnownCommonOptions extends DeepbookCommonOptions {
+  /** Optional chain id pin (defaults to the configured network). */
+  readonly chain?: string;
+}
+interface DeepbookKnownNetworkOptions extends DeepbookKnownCommonOptions {
+  readonly network: DeepbookKnownNetwork;
+  readonly packageId?: string;
+  readonly registryId?: string;
+}
+interface DeepbookKnownExplicitOptions extends DeepbookKnownCommonOptions {
+  readonly packageId: string;
+  readonly registryId: string;
+  readonly network?: DeepbookKnownNetwork;
+}
+type DeepbookKnownOptions = DeepbookKnownNetworkOptions | DeepbookKnownExplicitOptions;
+type DeepbookOptions<Publisher extends AccountMemberAlias = AccountMemberAlias, Pyth extends PythOptions | undefined = PythOptions | undefined> = ({
+  readonly mode: 'local';
+} & DeepbookLocalOptions<Publisher, DeepbookPackageMember, ReadonlyArray<DeepbookPoolSpec>, Pyth>) | ({
+  readonly mode: 'override';
+} & DeepbookOverrideOptions) | ({
+  readonly mode: 'known';
+} & DeepbookKnownOptions);
+type DeepbookLocalEmptyPoolOptions<Publisher extends AccountMemberAlias, Package extends DeepbookPackageMember, Pyth extends PythOptions | undefined = undefined> = Omit<DeepbookLocalOptions<Publisher, Package, readonly [], Pyth>, 'pools'> & {
+  readonly pools: readonly [];
+};
+type PoolCoinRefs<Pools extends ReadonlyArray<DeepbookPoolSpec>> = Pools[number] extends DeepbookPoolSpec<infer Base, infer Quote> ? Base | Quote : never;
+type PoolCoinRefTuple<Pools extends ReadonlyArray<DeepbookPoolSpec>> = Pools extends readonly [] ? readonly [] : readonly PoolCoinRefs<Pools>[];
+type PythRefs<Pyth extends PythOptions | undefined> = Pyth extends PythOptions<infer Package, infer Pusher> ? readonly [Pusher, Package] : readonly [];
+declare const buildOverridePlugin: (opts: DeepbookOverrideOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+  readonly mode: SuiOptions["mode"];
+  readonly seedObjects: SeedObjectsAccumulator;
+}>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">]>;
+declare const buildLocalPlugin: <const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pools extends ReadonlyArray<DeepbookPoolSpec> = readonly [], const Pyth extends PythOptions | undefined = undefined>(opts: DeepbookLocalOptions<Publisher, Package, Pools, Pyth>) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+  readonly mode: SuiOptions["mode"];
+  readonly seedObjects: SeedObjectsAccumulator;
+}>, Publisher, Package, ...PythRefs<Pyth>, ...PoolCoinRefTuple<Pools>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">]>;
+declare const buildKnownPlugin: (opts: DeepbookKnownOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+  readonly mode: SuiOptions["mode"];
+  readonly seedObjects: SeedObjectsAccumulator;
+}>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">, ...StrategyContributorDecl<"coinType:0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP", DeepbookDeepFundingStrategy>[]]>;
+/** Env-driven factory. Defaults to local mode on localnet when passed local
+ *  options. Explicit `override` and `known` modes bypass env inference. */
+type DeepbookLocalMember<Publisher extends AccountMemberAlias, Package extends DeepbookPackageMember, Pools extends ReadonlyArray<DeepbookPoolSpec>, Pyth extends PythOptions | undefined = undefined> = ReturnType<typeof buildLocalPlugin<Publisher, Package, Pools, Pyth>>;
+type DeepbookOverrideMember = ReturnType<typeof buildOverridePlugin>;
+type DeepbookKnownMember = ReturnType<typeof buildKnownPlugin>;
+declare function deepbookCore<const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pyth extends PythOptions | undefined = undefined>(opts: {
+  readonly mode: 'local';
+} & DeepbookLocalEmptyPoolOptions<Publisher, Package, Pyth>): DeepbookLocalMember<Publisher, Package, readonly [], Pyth>;
+declare function deepbookCore<const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pools extends ReadonlyArray<DeepbookPoolSpec> = readonly [], const Pyth extends PythOptions | undefined = undefined>(opts: {
+  readonly mode: 'local';
+} & DeepbookLocalOptions<Publisher, Package, Pools, Pyth>): DeepbookLocalMember<Publisher, Package, Pools, Pyth>;
+declare function deepbookCore(opts: {
+  readonly mode: 'override';
+} & DeepbookOverrideOptions): DeepbookOverrideMember;
+declare function deepbookCore(opts: {
+  readonly mode: 'known';
+} & DeepbookKnownOptions): DeepbookKnownMember;
+declare function deepbookCore<const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pyth extends PythOptions | undefined = undefined>(opts: DeepbookLocalEmptyPoolOptions<Publisher, Package, Pyth>): DeepbookLocalMember<Publisher, Package, readonly [], Pyth>;
+declare function deepbookCore<const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pools extends ReadonlyArray<DeepbookPoolSpec> = readonly [], const Pyth extends PythOptions | undefined = undefined>(opts: DeepbookLocalOptions<Publisher, Package, Pools, Pyth>): DeepbookLocalMember<Publisher, Package, Pools, Pyth>;
+/** Mode-narrowed factory namespace.
+ *
+ *  Usage:
+ *      const local = { mode: 'local', chain: 'sui:localnet' } as const;
+ *      deepbookFor(local).local({publisher, package, pools})    // OK
+ *      deepbookFor(local).override({packageId, registryId, adminCapId}) // OK
+ *      deepbookFor(local).known({...})                          // OK
+ *
+ *      const fork = { mode: 'fork', chain: 'sui:mainnet-fork', upstream: 'mainnet' } as const;
+ *      deepbookFor(fork).local({...})                       // COMPILE ERROR
+ *      deepbookFor(fork).override({...})                    // COMPILE ERROR
+ *
+ *  The fork branch has NO `.local` or `.override` entry — `deepbookFor(forkNetwork).local`
+ *  is a compile-time refusal. */
+declare const deepbookFor: ModeNamespace<{
+  local: {
+    local: <const Publisher extends AccountMemberAlias, const Package extends DeepbookPackageMember, const Pools extends ReadonlyArray<DeepbookPoolSpec> = readonly [], const Pyth extends PythOptions | undefined = undefined>(opts: DeepbookLocalOptions<Publisher, Package, Pools, Pyth>) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+      readonly mode: SuiOptions["mode"];
+      readonly seedObjects: SeedObjectsAccumulator;
+    }>, Publisher, Package, ...PythRefs<Pyth>, ...PoolCoinRefTuple<Pools>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">]>;
+    override: (opts: DeepbookOverrideOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+      readonly mode: SuiOptions["mode"];
+      readonly seedObjects: SeedObjectsAccumulator;
+    }>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">]>;
+    known: (opts: DeepbookKnownOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+      readonly mode: SuiOptions["mode"];
+      readonly seedObjects: SeedObjectsAccumulator;
+    }>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">, ...StrategyContributorDecl<"coinType:0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP", DeepbookDeepFundingStrategy>[]]>;
+  };
+  live: {
+    known: (opts: DeepbookKnownOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+      readonly mode: SuiOptions["mode"];
+      readonly seedObjects: SeedObjectsAccumulator;
+    }>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">, ...StrategyContributorDecl<"coinType:0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP", DeepbookDeepFundingStrategy>[]]>;
+  };
+  fork: {
+    known: (opts: DeepbookKnownOptions) => Plugin<`deepbook/${string}`, DeepbookResolved, readonly [ResourceRef<"sui", SuiClient & {
+      readonly mode: SuiOptions["mode"];
+      readonly seedObjects: SeedObjectsAccumulator;
+    }>], readonly [SnapshotableDecl, CodegenableDecl<"deepbook-network">, ...StrategyContributorDecl<"coinType:0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP", DeepbookDeepFundingStrategy>[]]>;
+  };
+}>;
+//#endregion
+export { DeepbookCommonOptions, DeepbookKnownNetwork, DeepbookKnownOptions, DeepbookOptions, DeepbookOverrideOptions, DeepbookResolved, deepbookCore, deepbookFor };
+//# sourceMappingURL=index.d.mts.map

package/dist/plugins/deepbook/index.mjs

@@ -0,0 +1,359 @@
+import { definePlugin, resource } from "../../substrate/plugin.mjs";
+import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
+import { defineModeNamespace } from "../../api/mode-narrowed-factory.mjs";
+import { setCurrentPluginPhase } from "../../substrate/runtime/current-plugin.mjs";
+import { suiResource } from "../sui/index.mjs";
+import { ArtifactPublisherService } from "../../substrate/runtime/artifact-publisher/index.mjs";
+import { deepbookPluginKey } from "./plugin-key.mjs";
+import { DEEPBOOK_ERROR_TAGS, deepbookConfigError, deepbookPluginError } from "./errors.mjs";
+import { makeDeepbookCodegenable } from "./codegen.mjs";
+import { makeDeepbookDeepFundingContribution, makeDeepbookDeepFundingStrategy } from "./faucet-strategy.mjs";
+import { makeKnownSnapshotable, makeLocalSnapshotable } from "./snapshot.mjs";
+import { createDeepbookPools, seedDeepbookPools } from "./deploy.mjs";
+import "./types.mjs";
+import { initLocalPythFeeds } from "./pyth/index.mjs";
+import { Effect } from "effect";
+//#region src/plugins/deepbook/index.ts
+const makeDeepbookResource = (name) => resource(`deepbook/${name}`);
+const DEFAULT_NAME = "deepbook";
+const deepbookErrorContributions = pluginErrorContributions(DEEPBOOK_ERROR_TAGS);
+const KNOWN_DEEPBOOK_DEPLOYMENTS = {
+	testnet: {
+		chain: "sui:testnet",
+		packageId: "0x22be4cade64bf2d02412c7e8d0e8beea2f78828b948118d46735315409371a3c",
+		registryId: "0x7c256edbda983a2cd6f946655f4bf3f00a41043993781f8674a7046e8c0e11d1",
+		deepTreasuryId: "0x69fffdae0075f8f71f4fa793549c11079266910e8905169845af1f5d00e09dcb",
+		pyth: {
+			packageId: null,
+			stateId: "0x243759059f4c3111179da5878c12f68d612c21a8d54d85edc86164bb18be1c7c",
+			wormholeStateId: "0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790",
+			feeds: []
+		}
+	},
+	mainnet: {
+		chain: "sui:mainnet",
+		packageId: "0xf48222c4e057fa468baf136bff8e12504209d43850c5778f76159292a96f621e",
+		registryId: "0xaf16199a2dff736e9f07a845f23c5da6df6f756eddb631aed9d24a93efc4549d",
+		deepTreasuryId: "0x032abf8948dda67a271bcc18e776dbbcfb0d58c8d288a700ff0d5521e57a1ffe",
+		pyth: {
+			packageId: null,
+			stateId: "0x1f9310238ee9298fb703c3419030b35b22bb1cc37113e3bb5007c99aec79e5b8",
+			wormholeStateId: "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c",
+			feeds: []
+		}
+	}
+};
+const poolCoinRefs = (pools) => pools.flatMap((pool) => [pool.base.coin, pool.quote.coin]);
+const pythRefs = (pyth) => pyth === void 0 ? [] : [pyth.pusher, pyth.package];
+const localDependsOn = (opts) => [
+	suiResource,
+	opts.publisher,
+	opts.package,
+	...pythRefs(opts.pyth),
+	...poolCoinRefs(opts.pools)
+];
+const requireCapturedId = (pkg, key, kind) => {
+	const value = pkg.captured[key];
+	if (typeof value === "string" && value.length > 0) return Effect.succeed(value);
+	return Effect.fail(deepbookPluginError("publish", `deepbook local package '${pkg.name}' is missing captured ${kind} '${key}'.`));
+};
+const resolvePoolSpecs = (pools, coinValuesByRefId) => pools.map((pool) => {
+	const base = coinValuesByRefId.get(pool.base.coin.id);
+	const quote = coinValuesByRefId.get(pool.quote.coin.id);
+	return {
+		name: pool.name,
+		base: pool.base.key,
+		quote: pool.quote.key,
+		baseCoinType: base.fullCoinType,
+		quoteCoinType: quote.fullCoinType,
+		...base.fundingStrategy === void 0 ? {} : { baseFundingStrategy: base.fundingStrategy },
+		...quote.fundingStrategy === void 0 ? {} : { quoteFundingStrategy: quote.fundingStrategy },
+		tickSize: pool.tickSize,
+		lotSize: pool.lotSize,
+		minSize: pool.minSize,
+		whitelisted: pool.whitelisted ?? true,
+		stablePool: pool.stablePool ?? false,
+		...pool.seed === void 0 ? {} : { seed: pool.seed }
+	};
+});
+const assertUniquePoolNames = (name, pools) => {
+	const seen = /* @__PURE__ */ new Set();
+	for (const pool of pools) {
+		if (seen.has(pool.name)) throw deepbookConfigError("pools", `deepbook({mode:'local', name:'${name}'}) has duplicate pool '${pool.name}'.`, "Give each local DeepBook pool a unique SDK key.");
+		seen.add(pool.name);
+		for (const order of pool.seed?.orders ?? []) {
+			if (order.quantity < pool.minSize) throw deepbookConfigError("pools", `deepbook({mode:'local', name:'${name}'}) seed order for pool '${pool.name}' is below minSize.`, "Use a seed order quantity greater than or equal to the pool minSize.");
+			if (order.quantity % pool.lotSize !== 0n) throw deepbookConfigError("pools", `deepbook({mode:'local', name:'${name}'}) seed order for pool '${pool.name}' is not lot-aligned.`, "Use a seed order quantity divisible by the pool lotSize.");
+			if (order.price % pool.tickSize !== 0n) throw deepbookConfigError("pools", `deepbook({mode:'local', name:'${name}'}) seed order for pool '${pool.name}' is not tick-aligned.`, "Use a seed order price divisible by the pool tickSize.");
+		}
+	}
+};
+const buildOverridePlugin = (opts) => {
+	const name = opts.name ?? DEFAULT_NAME;
+	if (!opts.packageId || !opts.registryId || !opts.adminCapId) throw deepbookConfigError("packageId", `deepbook({mode:'override', name:'${name}'}) requires packageId, registryId, and adminCapId.`, `Pass explicit deployment ids or use deepbook({mode:'known', network:'testnet'}).`);
+	const deepbookResource = makeDeepbookResource(name);
+	const snap = makeKnownSnapshotable({ name });
+	return definePlugin({
+		id: deepbookResource.id,
+		dependsOn: [suiResource],
+		role: "task",
+		pluginKey: deepbookPluginKey(name),
+		start: (deps) => Effect.sync(() => {
+			const [sui] = deps;
+			return {
+				mode: "override",
+				chain: opts.chain ?? sui.chain,
+				packageId: opts.packageId,
+				registryId: opts.registryId,
+				adminCapId: opts.adminCapId,
+				deepTreasuryId: null,
+				pools: [],
+				pyth: null,
+				margin: null,
+				serverUrl: null,
+				indexerUrl: null,
+				marketMakerRunning: false,
+				deepFundingStrategy: null
+			};
+		}),
+		capabilities: ({ value: resolved }) => {
+			return [snap, makeDeepbookCodegenable({
+				name,
+				chain: resolved.chain,
+				packageId: resolved.packageId,
+				registryId: resolved.registryId,
+				adminCapId: resolved.adminCapId,
+				deepTreasuryId: resolved.deepTreasuryId,
+				pools: [],
+				pyth: null,
+				margin: null,
+				serverUrl: null,
+				indexerUrl: null
+			})];
+		},
+		errorContributions: deepbookErrorContributions
+	});
+};
+const buildLocalPlugin = (opts) => {
+	const name = opts.name ?? DEFAULT_NAME;
+	if (!opts.package) throw deepbookConfigError("packageId", `deepbook({mode:'local', name:'${name}'}) requires a DeepBook package ref.`, `Pass \`package: <localPackageMember>\` with captured registryId/adminCapId.`);
+	assertUniquePoolNames(name, opts.pools);
+	const deepbookResource = makeDeepbookResource(name);
+	const dependsOn = localDependsOn(opts);
+	return definePlugin({
+		id: deepbookResource.id,
+		dependsOn,
+		role: "task",
+		pluginKey: deepbookPluginKey(name),
+		start: (deps) => Effect.gen(function* () {
+			const [sui, publisher, deepbookPackage, ...extraValues] = deps;
+			const pythValueCount = opts.pyth === void 0 ? 0 : 2;
+			const pythValues = extraValues.slice(0, pythValueCount);
+			const coinValues = extraValues.slice(pythValueCount);
+			yield* Effect.annotateCurrentSpan({
+				"deepbook.name": name,
+				"deepbook.chain": sui.chain,
+				"deepbook.publisher": publisher.address
+			});
+			yield* setCurrentPluginPhase("reading deployment captures");
+			const registryId = yield* requireCapturedId(deepbookPackage, opts.registryIdKey ?? "registryId", "registryId");
+			const adminCapId = yield* requireCapturedId(deepbookPackage, opts.adminCapIdKey ?? "adminCapId", "adminCapId");
+			const deepTreasuryId = opts.deepTreasuryIdKey === void 0 ? null : deepbookPackage.captured[opts.deepTreasuryIdKey] ?? null;
+			const deployment = {
+				packageId: deepbookPackage.packageId,
+				registryId,
+				adminCapId,
+				deepTreasuryId
+			};
+			const poolRefs = poolCoinRefs(opts.pools);
+			const coinValuesByRefId = /* @__PURE__ */ new Map();
+			for (let i = 0; i < poolRefs.length; i += 1) {
+				const ref = poolRefs[i];
+				const value = coinValues[i];
+				if (ref !== void 0 && value !== void 0) coinValuesByRefId.set(ref.id, value);
+			}
+			const poolSpecs = resolvePoolSpecs(opts.pools, coinValuesByRefId);
+			const artifactPublisher = yield* ArtifactPublisherService;
+			yield* setCurrentPluginPhase(opts.pyth === void 0 ? "creating pools" : "initializing Pyth feeds");
+			const pyth = opts.pyth === void 0 ? null : yield* initLocalPythFeeds(artifactPublisher, sui.sdk, sui.chain, pythValues[0], { packageId: pythValues[1].packageId }, opts.pyth.feeds);
+			yield* setCurrentPluginPhase("creating pools");
+			const poolResult = yield* createDeepbookPools(artifactPublisher, sui.sdk, sui.chain, publisher, deployment, poolSpecs);
+			yield* setCurrentPluginPhase("seeding pools");
+			const seedResults = yield* seedDeepbookPools(artifactPublisher, sui.sdk, sui.chain, publisher, deployment, poolSpecs, poolResult.pools);
+			yield* setCurrentPluginPhase(null);
+			return {
+				mode: "local",
+				chain: sui.chain,
+				packageId: deployment.packageId,
+				registryId: deployment.registryId,
+				adminCapId: deployment.adminCapId,
+				deepTreasuryId,
+				pools: poolResult.pools,
+				pyth,
+				margin: null,
+				serverUrl: null,
+				indexerUrl: null,
+				marketMakerRunning: seedResults.length > 0,
+				deepFundingStrategy: null
+			};
+		}).pipe(Effect.catch((err) => {
+			if (typeof err === "object" && err !== null && "_tag" in err && (err._tag === "DeepbookPluginError" || err._tag === "DeepbookConfigError" || err._tag === "ForkIncompatibleError")) return Effect.fail(err);
+			return Effect.fail(deepbookPluginError("publish", `deepbook acquire failed: ${String(err)}`));
+		})),
+		capabilities: ({ value: resolved, runtime: acquireCtx }) => {
+			return [makeLocalSnapshotable({
+				name,
+				app: acquireCtx.identity.app,
+				stack: acquireCtx.identity.stack,
+				indexerEnabled: false,
+				serverEnabled: false
+			}), makeDeepbookCodegenable({
+				name,
+				chain: resolved.chain,
+				packageId: resolved.packageId,
+				registryId: resolved.registryId,
+				adminCapId: resolved.adminCapId,
+				deepTreasuryId: resolved.deepTreasuryId,
+				pools: resolved.pools.map((p) => ({
+					name: p.name,
+					poolId: p.poolId,
+					base: p.base,
+					quote: p.quote,
+					baseCoinType: p.baseCoinType,
+					quoteCoinType: p.quoteCoinType
+				})),
+				pyth: resolved.pyth ? {
+					packageId: resolved.pyth.packageId,
+					stateId: resolved.pyth.stateId,
+					wormholeStateId: resolved.pyth.wormholeStateId,
+					feeds: resolved.pyth.feeds.map((feed) => ({
+						symbol: feed.symbol,
+						feedId: feed.feedId,
+						priceInfoObjectId: feed.priceInfoObjectId,
+						price: feed.price.toString(),
+						expo: feed.expo
+					}))
+				} : null,
+				margin: resolved.margin,
+				serverUrl: resolved.serverUrl,
+				indexerUrl: resolved.indexerUrl
+			})];
+		},
+		errorContributions: deepbookErrorContributions
+	});
+};
+function buildLocalPluginPublic(opts) {
+	return buildLocalPlugin(opts);
+}
+const buildKnownPlugin = (opts) => {
+	const name = opts.name ?? DEFAULT_NAME;
+	const known = opts.network ? KNOWN_DEEPBOOK_DEPLOYMENTS[opts.network] : null;
+	const packageId = opts.packageId ?? known?.packageId;
+	const registryId = opts.registryId ?? known?.registryId;
+	if (!packageId || !registryId) throw deepbookConfigError("packageId", `deepbook({mode:'known', name:'${name}'}) requires packageId and registryId, or network:'mainnet'|'testnet'.`, `Pass explicit ids or use deepbook({mode:'known', network:'testnet'}).`);
+	const deepbookResource = makeDeepbookResource(name);
+	const snap = makeKnownSnapshotable({ name });
+	return definePlugin({
+		id: deepbookResource.id,
+		dependsOn: [suiResource],
+		role: "task",
+		start: (deps) => Effect.sync(() => {
+			const [sui] = deps;
+			const chain = opts.chain ?? known?.chain ?? sui.chain;
+			return {
+				mode: "known",
+				chain,
+				packageId,
+				registryId,
+				adminCapId: null,
+				deepTreasuryId: known?.deepTreasuryId ?? null,
+				pools: [],
+				pyth: known?.pyth ?? null,
+				margin: null,
+				serverUrl: null,
+				indexerUrl: null,
+				marketMakerRunning: false,
+				deepFundingStrategy: opts.network === "testnet" && String(chain) === "sui:testnet" ? makeDeepbookDeepFundingStrategy({ suiSdk: sui.sdk }) : null
+			};
+		}),
+		capabilities: ({ value: resolved }) => {
+			const bindings = {
+				name,
+				chain: resolved.chain,
+				packageId: resolved.packageId,
+				registryId: resolved.registryId,
+				adminCapId: null,
+				deepTreasuryId: resolved.deepTreasuryId,
+				pools: [],
+				pyth: resolved.pyth ? {
+					packageId: resolved.pyth.packageId,
+					stateId: resolved.pyth.stateId,
+					wormholeStateId: resolved.pyth.wormholeStateId,
+					feeds: resolved.pyth.feeds.map((feed) => ({
+						symbol: feed.symbol,
+						feedId: feed.feedId,
+						priceInfoObjectId: feed.priceInfoObjectId,
+						price: feed.price.toString(),
+						expo: feed.expo
+					}))
+				} : null,
+				margin: null,
+				serverUrl: null,
+				indexerUrl: null
+			};
+			const deepFunding = resolved.deepFundingStrategy === null ? [] : [makeDeepbookDeepFundingContribution(resolved.deepFundingStrategy)];
+			return [
+				snap,
+				makeDeepbookCodegenable(bindings),
+				...deepFunding
+			];
+		},
+		errorContributions: deepbookErrorContributions
+	});
+};
+const resolveDefaultMode = (opts) => {
+	const env = globalThis.process?.env?.DEVSTACK_NETWORK;
+	if (env === void 0 || env === "localnet") {
+		if (!opts || !opts.publisher) throw deepbookConfigError("publisher", `deepbook() on localnet requires \`publisher\` and \`package\` member refs.`, `Pass options via deepbook({mode:'local', publisher, package: deepbookPackage, ...}).`);
+		return {
+			mode: "local",
+			...opts
+		};
+	}
+	throw deepbookConfigError("mode", `deepbook(): cannot auto-default to known mode on network='${env}'.`, `Use deepbookFor(network).known({packageId, registryId, ...}).`);
+};
+function deepbookCore(opts) {
+	const resolved = opts !== void 0 && "mode" in opts ? opts : resolveDefaultMode(opts);
+	switch (resolved.mode) {
+		case "local": return buildLocalPluginPublic(resolved);
+		case "override": return buildOverridePlugin(resolved);
+		case "known": return buildKnownPlugin(resolved);
+	}
+}
+/** Mode-narrowed factory namespace.
+*
+*  Usage:
+*      const local = { mode: 'local', chain: 'sui:localnet' } as const;
+*      deepbookFor(local).local({publisher, package, pools})    // OK
+*      deepbookFor(local).override({packageId, registryId, adminCapId}) // OK
+*      deepbookFor(local).known({...})                          // OK
+*
+*      const fork = { mode: 'fork', chain: 'sui:mainnet-fork', upstream: 'mainnet' } as const;
+*      deepbookFor(fork).local({...})                       // COMPILE ERROR
+*      deepbookFor(fork).override({...})                    // COMPILE ERROR
+*
+*  The fork branch has NO `.local` or `.override` entry — `deepbookFor(forkNetwork).local`
+*  is a compile-time refusal. */
+const deepbookFor = defineModeNamespace({
+	local: {
+		local: (opts) => buildLocalPluginPublic(opts),
+		override: (opts) => buildOverridePlugin(opts),
+		known: (opts) => buildKnownPlugin(opts)
+	},
+	live: { known: (opts) => buildKnownPlugin(opts) },
+	fork: { known: (opts) => buildKnownPlugin(opts) }
+});
+//#endregion
+export { deepbookCore, deepbookFor };
+
+//# sourceMappingURL=index.mjs.map