@mysten-incubation/devstack 0.0.0

package/dist/plugins/coin/mint.mjs

@@ -0,0 +1,164 @@
+import { decodeUnknown } from "../../substrate/runtime/runtime-decode.mjs";
+import { contentHash } from "../../substrate/brand.mjs";
+import { isSuiFrameworkObjectForCoin } from "./type-strings.mjs";
+import { coinError } from "./errors.mjs";
+import { Effect, Schema } from "effect";
+import { Transaction } from "@mysten/sui/transactions";
+//#region src/plugins/coin/mint.ts
+/** Verify-schema: what we expect when probing the minted coin.
+*  IMPORTANT (chain-probe schema constraint from the last sweep):
+*  schema literal uses ONLY service-free combinators. */
+const MintedCoinVerifyShape = Schema.Struct({
+	objectId: Schema.String,
+	type: Schema.String
+});
+/** Build the cache-key content hash. Distilled-doc 13-coin.md
+*  §"Persistence model": key shape is
+*  `coin/mint/<chainId>/<treasuryCapId>/<recipient>/<amount>`. The
+*  substrate's artifact publisher folds in chainId via the `chain` parameter; we
+*  fold the remaining columns into `contentHash`. */
+const buildMintContentHash = (parts) => contentHash(`mint/${parts.treasuryCapId}/${parts.recipient}/${parts.amount.toString()}`);
+/** Verify probe — checks the cached minted-coin still exists. Lenient:
+*  returns `null` for both not-found AND transient failure (distilled-
+*  doc invariant: the next cycle re-derives).
+*
+*  IMPORTANT (chain-probe schema constraint): the probe pipeline
+*  cannot inject services from the caller. We construct the schema
+*  literal at module scope (above) and call `decodeUnknownEffect` —
+*  which the substrate's `ChainProbe.get` does internally. This local
+*  verify mirrors the call-shape so the constraint is honored.
+*
+*  We model the verify here as an inline Effect because the cached
+*  minted-coin id is known only AFTER cache lookup — the substrate's
+*  `verify` Effect closes over the cached id. */
+const buildVerifyProbe = (sdk, mintedCoinIdOpt) => Effect.gen(function* () {
+	if (mintedCoinIdOpt === null) return null;
+	const raw = yield* Effect.tryPromise({
+		try: () => sdk.core.getObject({ objectId: mintedCoinIdOpt }),
+		catch: () => "transient"
+	}).pipe(Effect.catch(() => Effect.succeed(null)));
+	if (raw === null || raw === void 0) return null;
+	return yield* decodeUnknown(MintedCoinVerifyShape, raw, {
+		source: "minted coin verify response",
+		mkError: (issue) => issue
+	}).pipe(Effect.catch(() => Effect.succeed(null)));
+});
+/** Find the minted `Coin<T>` in a result's objectChanges. Returns the
+*  objectId of the first `created` entry whose `objectType` matches
+*  `0x2::coin::Coin<${fullCoinType}>` (or its address-normalized equivalent).
+*
+*  Returns `null` on no match — the caller maps that to a typed parse
+*  error.
+*
+*  The SDK can report the Sui framework address as compact `0x2` or
+*  fully padded `0x000...0002`, so this uses the shared type-string
+*  normalizer instead of substring matching. */
+const pickCreatedCoin = (changes, fullCoinType) => {
+	for (const change of changes) {
+		if (!isCreatedObjectChange(change)) continue;
+		if (typeof change.objectType === "string" && isSuiFrameworkObjectForCoin(change.objectType, "Coin", fullCoinType)) return change.objectId;
+	}
+	return null;
+};
+const isCreatedObjectChange = (raw) => {
+	if (raw === null || typeof raw !== "object") return false;
+	const r = raw;
+	return r.type === "created" && typeof r.objectId === "string";
+};
+/** Build the `ArtifactPublisher` spec for one mint round.
+*
+*  Substrate dispatches: cache lookup, verify-on-hit, produce-on-
+*  miss-or-verify-fail, register-on-every-cycle. We hand it the
+*  procedures; the substrate handles best-effort cache writes per
+*  Invariant 2.
+*
+*  Note on the `Produced | Verified` union: the artifact publisher's `publish`
+*  returns one OR the other shape; both are `CachedMint`-compatible
+*  for our purposes, so we collapse downstream. */
+const performMint = (publisher, chain, signer, sdk, inputs) => Effect.gen(function* () {
+	const cacheHash = buildMintContentHash(inputs);
+	const verified = yield* publisher.publish({
+		namespace: "coin-mint",
+		chain,
+		contentHash: cacheHash,
+		verifySchema: MintedCoinVerifyShape,
+		verify: (cached) => buildVerifyProbe(sdk, cached.mintedCoinId),
+		produce: Effect.gen(function* () {
+			yield* Effect.annotateCurrentSpan({
+				"coin.mint.recipient": inputs.recipient,
+				"coin.mint.fullCoinType": inputs.fullCoinType,
+				"coin.mint.amount": inputs.amount.toString()
+			});
+			const result = yield* signer.withTransactionSigner((lockedSigner) => Effect.gen(function* () {
+				const tx = new Transaction();
+				if (inputs.gasBudget !== void 0) tx.setGasBudget(inputs.gasBudget);
+				tx.setSender(signer.address);
+				tx.moveCall({
+					target: "0x2::coin::mint_and_transfer",
+					typeArguments: [inputs.fullCoinType],
+					arguments: [
+						tx.object(inputs.treasuryCapId),
+						tx.pure.u64(inputs.amount),
+						tx.pure.address(inputs.recipient)
+					]
+				});
+				const txBytes = yield* Effect.tryPromise({
+					try: () => tx.build({ client: sdk.client }),
+					catch: (cause) => ({
+						_tag: "ArtifactPublishError",
+						reason: "produce-failed",
+						detail: `coin.mint(${inputs.fullCoinType}): Transaction.build failed — ${cause instanceof Error ? cause.message : String(cause)}`
+					})
+				});
+				return yield* lockedSigner.signAndExecute(txBytes).pipe(Effect.mapError((cause) => ({
+					_tag: "ArtifactPublishError",
+					reason: "produce-failed",
+					detail: `coin.mint(${inputs.fullCoinType}): signAndExecute failed — ` + cause.message
+				})));
+			}));
+			const mintedCoinId = pickCreatedCoin(result.objectChanges, inputs.fullCoinType);
+			if (mintedCoinId === null) return yield* Effect.fail({
+				_tag: "ArtifactPublishError",
+				reason: "produce-failed",
+				detail: `coin.mint(${inputs.fullCoinType}): minted Coin<T> not found in objectChanges (digest=${result.digest}). ` + mintParseError(inputs.fullCoinType, "minted Coin<T> absent in objectChanges").message
+			});
+			yield* Effect.annotateCurrentSpan({
+				"coin.mint.digest": result.digest,
+				"coin.mint.mintedCoinId": mintedCoinId
+			});
+			return {
+				digest: result.digest,
+				mintedCoinId,
+				recipient: inputs.recipient,
+				amount: inputs.amount.toString()
+			};
+		}),
+		register: () => Effect.void
+	});
+	if ("mintedCoinId" in verified) return {
+		digest: verified.digest,
+		mintedCoinId: verified.mintedCoinId,
+		recipient: verified.recipient,
+		amount: BigInt(verified.amount),
+		fullCoinType: inputs.fullCoinType
+	};
+	return {
+		digest: null,
+		mintedCoinId: verified.objectId,
+		recipient: inputs.recipient,
+		amount: inputs.amount,
+		fullCoinType: inputs.fullCoinType
+	};
+}).pipe(Effect.withSpan("coin.mint", { attributes: {
+	"coin.mint.recipient": inputs.recipient,
+	"coin.mint.fullCoinType": inputs.fullCoinType,
+	"coin.mint.amount": inputs.amount.toString()
+} }));
+const mintParseError = (fullCoinType, message) => coinError("mint-parse", {
+	identifier: fullCoinType,
+	message
+});
+//#endregion
+export { MintedCoinVerifyShape, mintParseError, performMint };
+
+//# sourceMappingURL=mint.mjs.map

package/dist/plugins/coin/mint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.mjs","names":["brandContentHash"],"sources":["../../../src/plugins/coin/mint.ts"],"sourcesContent":["// Generic mint — wraps `0x2::coin::mint_and_transfer<T>` in the\n// `ArtifactPublisher` substrate primitive.\n//\n// Distilled-doc 13-coin.md §\"Lifecycle\" §\"mintFromTreasury\":\n//\n//   - Cache key:    (chainId, treasuryCapId, recipient, amount)\n//   - Verify:       lenient probe on the cached minted-coin id\n//                   (Invariant 1 — vanish-detection)\n//   - Produce:      sign + execute the `mint_and_transfer<T>` tx,\n//                   find the minted `Coin<T>` in objectChanges\n//   - Register:     in-memory note of the mint (no global registry —\n//                   the resolved value carries everything callers\n//                   need).\n//\n// Best-effort cache writes (distilled-doc Invariant 2): the mint\n// already settled on chain; a state-store IO defect just means the\n// next supervisor cycle re-mints. Don't let a StateStore failure\n// roll back the mint.\n//\n// Substrate constraint: the `ArtifactPublisher.publish` shape\n// already covers cache + verify + produce + register-on-every-cycle.\n// We compose its spec; the substrate dispatches.\n\nimport { Effect, Schema, type Scope } from 'effect';\nimport { Transaction } from '@mysten/sui/transactions';\n\nimport type { ChainId, ContentHash } from '../../substrate/brand.ts';\nimport { contentHash as brandContentHash } from '../../substrate/brand.ts';\nimport { decodeUnknown } from '../../substrate/runtime/runtime-decode.ts';\nimport type {\n\tArtifactPublishError,\n\tArtifactPublisher,\n} from '../../primitives/artifact-publisher.ts';\nimport { coinError, type CoinError } from './errors.ts';\nimport { isSuiFrameworkObjectForCoin } from './type-strings.ts';\n\n/** Sign+execute surface narrowed from `AccountValue.signAndExecute`.\n *  We don't import `AccountValue` directly to avoid a layering cycle —\n *  the Account plugin imports nothing from coin, so coin re-publishes\n *  the structural shape. */\nexport interface MintTransactionSigner {\n\treadonly signAndExecute: (tx: Uint8Array) => Effect.Effect<\n\t\t{\n\t\t\treadonly digest: string;\n\t\t\treadonly objectChanges: ReadonlyArray<unknown>;\n\t\t},\n\t\t{ readonly _tag: 'AccountSignError'; readonly message: string }\n\t>;\n}\n\nexport interface MintSigner extends MintTransactionSigner {\n\treadonly address: string;\n\treadonly withTransactionSigner: <A, E, R>(\n\t\tbody: (signer: MintTransactionSigner) => Effect.Effect<A, E, R>,\n\t) => Effect.Effect<A, E, R>;\n}\n\n/** Cached payload — the stable id verify re-confirms on every cycle.\n *  Distilled-doc invariant: the probe MUST consume a STABLE on-chain\n *  identifier (the minted Coin<T>'s objectId), NOT a derived hash. */\nexport interface CachedMint {\n\treadonly digest: string;\n\treadonly mintedCoinId: string;\n\treadonly recipient: string;\n\t/** `amount.toString()` — bigint isn't serializable. */\n\treadonly amount: string;\n}\n\n/** Verify-schema: what we expect when probing the minted coin.\n *  IMPORTANT (chain-probe schema constraint from the last sweep):\n *  schema literal uses ONLY service-free combinators. */\nexport const MintedCoinVerifyShape = Schema.Struct({\n\tobjectId: Schema.String,\n\ttype: Schema.String,\n});\n\n/** Build the cache-key content hash. Distilled-doc 13-coin.md\n *  §\"Persistence model\": key shape is\n *  `coin/mint/<chainId>/<treasuryCapId>/<recipient>/<amount>`. The\n *  substrate's artifact publisher folds in chainId via the `chain` parameter; we\n *  fold the remaining columns into `contentHash`. */\nconst buildMintContentHash = (parts: {\n\treadonly treasuryCapId: string;\n\treadonly recipient: string;\n\treadonly amount: bigint;\n}): ContentHash =>\n\tbrandContentHash(`mint/${parts.treasuryCapId}/${parts.recipient}/${parts.amount.toString()}`);\n\nexport interface MintInputs {\n\treadonly fullCoinType: string;\n\treadonly treasuryCapId: string;\n\treadonly recipient: string;\n\treadonly amount: bigint;\n\treadonly gasBudget?: bigint;\n}\n\nexport interface MintResult {\n\t/** Tx digest of the producing mint. `null` on the verify-hit path:\n\t *  the artifact publisher's cache-hit verify returns the decoded probe shape\n\t *  (which doesn't carry the digest); callers that need the digest\n\t *  on cache hit consult the artifact publisher cache directly. */\n\treadonly digest: string | null;\n\treadonly mintedCoinId: string;\n\treadonly recipient: string;\n\treadonly amount: bigint;\n\treadonly fullCoinType: string;\n}\n\n/** Sui SDK shim for the verify probe + transaction build.\n *\n *  Narrowed-but-not-too-narrow: the produce body needs to serialize a\n *  `Transaction` to BCS bytes, which the Sui SDK's\n *  `Transaction.build({ client })` resolves via the client. We accept\n *  the full client opaquely (typed `unknown` here — the runtime check\n *  is \"does `Transaction.build` accept it\"). The barrel wires the\n *  resolved `SuiGrpcClient` through.\n *\n *  Why `unknown` rather than `ClientWithCoreApi`: keeps this module\n *  free of a direct `@mysten/sui/client` type import — the produce body\n *  passes it through opaquely to `Transaction.build`, which validates\n *  the shape at runtime.\n *\n *  The `core.getObject` field is the verify-probe surface; the\n *  `client` field is the build-target. */\nexport interface MintSdkShim {\n\treadonly core: {\n\t\treadonly getObject: (args: { readonly objectId: string }) => Promise<unknown>;\n\t};\n\t/** Opaque client reference for `Transaction.build({ client })`. The\n\t *  shim layer doesn't type-narrow this; the Sui barrel hands in the\n\t *  resolved `SuiGrpcClient`. */\n\treadonly client: unknown;\n}\n\n/** Verify probe — checks the cached minted-coin still exists. Lenient:\n *  returns `null` for both not-found AND transient failure (distilled-\n *  doc invariant: the next cycle re-derives).\n *\n *  IMPORTANT (chain-probe schema constraint): the probe pipeline\n *  cannot inject services from the caller. We construct the schema\n *  literal at module scope (above) and call `decodeUnknownEffect` —\n *  which the substrate's `ChainProbe.get` does internally. This local\n *  verify mirrors the call-shape so the constraint is honored.\n *\n *  We model the verify here as an inline Effect because the cached\n *  minted-coin id is known only AFTER cache lookup — the substrate's\n *  `verify` Effect closes over the cached id. */\nconst buildVerifyProbe = (\n\tsdk: MintSdkShim,\n\tmintedCoinIdOpt: string | null,\n): Effect.Effect<typeof MintedCoinVerifyShape.Type | null, never> =>\n\tEffect.gen(function* () {\n\t\tif (mintedCoinIdOpt === null) return null;\n\t\tconst raw: unknown = yield* Effect.tryPromise({\n\t\t\ttry: () => sdk.core.getObject({ objectId: mintedCoinIdOpt }),\n\t\t\tcatch: () => 'transient' as const,\n\t\t}).pipe(\n\t\t\t// Lenient: not-found AND transient both coerce to null. The\n\t\t\t// artifact publisher's cache layer will then re-run produce.\n\t\t\tEffect.catch(() => Effect.succeed(null)),\n\t\t);\n\t\tif (raw === null || raw === undefined) return null;\n\t\t// Best-effort decode. A decode failure on the verify path is\n\t\t// treated as \"object exists but shape changed unexpectedly\" —\n\t\t// still null so the substrate re-mints rather than carry stale\n\t\t// data forward.\n\t\treturn yield* decodeUnknown(MintedCoinVerifyShape, raw, {\n\t\t\tsource: 'minted coin verify response',\n\t\t\tmkError: (issue) => issue,\n\t\t}).pipe(Effect.catch(() => Effect.succeed(null as typeof MintedCoinVerifyShape.Type | null)));\n\t});\n\n/** Object-change shape narrowed for `pickCreatedCoin`. The gRPC\n *  client emits `objectType` as a fully-qualified Sui type string on\n *  `created` entries; we sniff for the `Coin<T>` substring (inner\n *  generic carries the full coin type, so the match is unambiguous —\n *  distilled-doc 13-coin.md Invariant 9). */\ninterface CreatedObjectChange {\n\treadonly type: 'created';\n\treadonly objectId: string;\n\treadonly objectType?: string;\n}\n\n/** Find the minted `Coin<T>` in a result's objectChanges. Returns the\n *  objectId of the first `created` entry whose `objectType` matches\n *  `0x2::coin::Coin<${fullCoinType}>` (or its address-normalized equivalent).\n *\n *  Returns `null` on no match — the caller maps that to a typed parse\n *  error.\n *\n *  The SDK can report the Sui framework address as compact `0x2` or\n *  fully padded `0x000...0002`, so this uses the shared type-string\n *  normalizer instead of substring matching. */\nexport const pickCreatedCoin = (\n\tchanges: ReadonlyArray<unknown>,\n\tfullCoinType: string,\n): string | null => {\n\tfor (const change of changes) {\n\t\tif (!isCreatedObjectChange(change)) continue;\n\t\tif (\n\t\t\ttypeof change.objectType === 'string' &&\n\t\t\tisSuiFrameworkObjectForCoin(change.objectType, 'Coin', fullCoinType)\n\t\t) {\n\t\t\treturn change.objectId;\n\t\t}\n\t}\n\treturn null;\n};\n\nconst isCreatedObjectChange = (raw: unknown): raw is CreatedObjectChange => {\n\tif (raw === null || typeof raw !== 'object') return false;\n\tconst r = raw as { type?: unknown; objectId?: unknown };\n\treturn r.type === 'created' && typeof r.objectId === 'string';\n};\n\n/** Build the `ArtifactPublisher` spec for one mint round.\n *\n *  Substrate dispatches: cache lookup, verify-on-hit, produce-on-\n *  miss-or-verify-fail, register-on-every-cycle. We hand it the\n *  procedures; the substrate handles best-effort cache writes per\n *  Invariant 2.\n *\n *  Note on the `Produced | Verified` union: the artifact publisher's `publish`\n *  returns one OR the other shape; both are `CachedMint`-compatible\n *  for our purposes, so we collapse downstream. */\nexport const performMint = (\n\tpublisher: ArtifactPublisher,\n\tchain: ChainId,\n\tsigner: MintSigner,\n\tsdk: MintSdkShim,\n\tinputs: MintInputs,\n): Effect.Effect<MintResult, CoinError | ArtifactPublishError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst cacheHash = buildMintContentHash(inputs);\n\n\t\tconst verified: CachedMint | { readonly objectId: string; readonly type: string } =\n\t\t\tyield* publisher.publish<CachedMint, typeof MintedCoinVerifyShape.Type>({\n\t\t\t\tnamespace: 'coin-mint',\n\t\t\t\tchain,\n\t\t\t\tcontentHash: cacheHash,\n\t\t\t\tverifySchema: MintedCoinVerifyShape,\n\t\t\t\t// Verify probe runs on cache hit. The artifact publisher threads the\n\t\t\t\t// cached payload through to its internal probe — our\n\t\t\t\t// closure here just hands back a \"null = miss\" signal\n\t\t\t\t// when the cached id has vanished on chain.\n\t\t\t\t//\n\t\t\t\t// The artifact publisher substrate now threads the decoded\n\t\t\t\t// `CachedMint` into `verify(cached)`; we pull\n\t\t\t\t// `mintedCoinId` off it and probe the chain. Lenient\n\t\t\t\t// mode masks transient + not-found → null → substrate\n\t\t\t\t// re-mints rather than carry a stale digest forward.\n\t\t\t\tverify: (cached) => buildVerifyProbe(sdk, cached.mintedCoinId),\n\t\t\t\tproduce: Effect.gen(function* () {\n\t\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t\t'coin.mint.recipient': inputs.recipient,\n\t\t\t\t\t\t'coin.mint.fullCoinType': inputs.fullCoinType,\n\t\t\t\t\t\t'coin.mint.amount': inputs.amount.toString(),\n\t\t\t\t\t});\n\n\t\t\t\t\tconst result = yield* signer.withTransactionSigner((lockedSigner) =>\n\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\t// 1. Build the Move tx — distilled-doc 13-coin.md\n\t\t\t\t\t\t\t//    Invariant 9 pins the call shape:\n\t\t\t\t\t\t\t//    `0x2::coin::mint_and_transfer<T>(cap, amount, recipient)`.\n\t\t\t\t\t\t\tconst tx = new Transaction();\n\t\t\t\t\t\t\tif (inputs.gasBudget !== undefined) {\n\t\t\t\t\t\t\t\ttx.setGasBudget(inputs.gasBudget);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\ttx.setSender(signer.address);\n\t\t\t\t\t\t\ttx.moveCall({\n\t\t\t\t\t\t\t\ttarget: '0x2::coin::mint_and_transfer',\n\t\t\t\t\t\t\t\ttypeArguments: [inputs.fullCoinType],\n\t\t\t\t\t\t\t\targuments: [\n\t\t\t\t\t\t\t\t\ttx.object(inputs.treasuryCapId),\n\t\t\t\t\t\t\t\t\ttx.pure.u64(inputs.amount),\n\t\t\t\t\t\t\t\t\ttx.pure.address(inputs.recipient),\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t});\n\n\t\t\t\t\t\t\t// 2. Serialize the tx to BCS bytes while the account lease\n\t\t\t\t\t\t\t//    is held. `Transaction.build` resolves gas + object-version\n\t\t\t\t\t\t\t//    placeholders via the client.\n\t\t\t\t\t\t\tconst txBytes = yield* Effect.tryPromise({\n\t\t\t\t\t\t\t\ttry: () =>\n\t\t\t\t\t\t\t\t\ttx.build({\n\t\t\t\t\t\t\t\t\t\t// The shim exposes the client opaquely; @mysten/sui\n\t\t\t\t\t\t\t\t\t\t// validates the shape at runtime.\n\t\t\t\t\t\t\t\t\t\tclient: sdk.client as Parameters<typeof tx.build>[0] extends\n\t\t\t\t\t\t\t\t\t\t\t| { client?: infer C }\n\t\t\t\t\t\t\t\t\t\t\t| undefined\n\t\t\t\t\t\t\t\t\t\t\t? C\n\t\t\t\t\t\t\t\t\t\t\t: never,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t\tcatch: (cause): ArtifactPublishError => ({\n\t\t\t\t\t\t\t\t\t_tag: 'ArtifactPublishError',\n\t\t\t\t\t\t\t\t\treason: 'produce-failed',\n\t\t\t\t\t\t\t\t\tdetail:\n\t\t\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): Transaction.build failed — ` +\n\t\t\t\t\t\t\t\t\t\t`${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t});\n\n\t\t\t\t\t\t\t// 3. Sign + execute via the Account-supplied signer. Map\n\t\t\t\t\t\t\t//    `AccountSignError` → `ArtifactPublishError`. The\n\t\t\t\t\t\t\t//    Account plugin's signer handles waitForTransaction internally.\n\t\t\t\t\t\t\treturn yield* lockedSigner.signAndExecute(txBytes).pipe(\n\t\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t\t(cause): ArtifactPublishError => ({\n\t\t\t\t\t\t\t\t\t\t_tag: 'ArtifactPublishError',\n\t\t\t\t\t\t\t\t\t\treason: 'produce-failed',\n\t\t\t\t\t\t\t\t\t\tdetail:\n\t\t\t\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): signAndExecute failed — ` + cause.message,\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);\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\n\t\t\t\t\t// 4. Find the minted `Coin<T>` in objectChanges via the\n\t\t\t\t\t//    inner-generic match (distilled-doc Invariant 9).\n\t\t\t\t\t//    `mint_and_transfer` emits a fresh `Coin<T>` owned by\n\t\t\t\t\t//    the recipient; look it up by the\n\t\t\t\t\t//    `0x2::coin::Coin<${fullCoinType}>` substring.\n\t\t\t\t\tconst mintedCoinId = pickCreatedCoin(result.objectChanges, inputs.fullCoinType);\n\t\t\t\t\tif (mintedCoinId === null) {\n\t\t\t\t\t\treturn yield* Effect.fail({\n\t\t\t\t\t\t\t_tag: 'ArtifactPublishError' as const,\n\t\t\t\t\t\t\treason: 'produce-failed' as const,\n\t\t\t\t\t\t\tdetail:\n\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): minted Coin<T> not found in ` +\n\t\t\t\t\t\t\t\t`objectChanges (digest=${result.digest}). ` +\n\t\t\t\t\t\t\t\tmintParseError(inputs.fullCoinType, 'minted Coin<T> absent in objectChanges')\n\t\t\t\t\t\t\t\t\t.message,\n\t\t\t\t\t\t} satisfies ArtifactPublishError);\n\t\t\t\t\t}\n\n\t\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t\t'coin.mint.digest': result.digest,\n\t\t\t\t\t\t'coin.mint.mintedCoinId': mintedCoinId,\n\t\t\t\t\t});\n\n\t\t\t\t\t// 5. Return the cached payload. The artifact publisher caches it under\n\t\t\t\t\t//    the content hash; the next cycle's verify probe (on\n\t\t\t\t\t//    cache hit) will lenient-probe `mintedCoinId`.\n\t\t\t\t\treturn {\n\t\t\t\t\t\tdigest: result.digest,\n\t\t\t\t\t\tmintedCoinId,\n\t\t\t\t\t\trecipient: inputs.recipient,\n\t\t\t\t\t\tamount: inputs.amount.toString(),\n\t\t\t\t\t} satisfies CachedMint;\n\t\t\t\t}),\n\t\t\t\t// Register on EVERY cycle (hit AND miss). Distilled-doc\n\t\t\t\t// Invariant 6. Coin mint has no global registry to feed —\n\t\t\t\t// the resolved-value carries everything; this is a no-op.\n\t\t\t\tregister: () => Effect.void,\n\t\t\t});\n\n\t\t// Project the union back to MintResult. Both arms carry enough\n\t\t// to reconstruct: produce returns CachedMint; verify returns\n\t\t// the decoded `{ objectId, type }`.\n\t\tif ('mintedCoinId' in verified) {\n\t\t\treturn {\n\t\t\t\tdigest: verified.digest,\n\t\t\t\tmintedCoinId: verified.mintedCoinId,\n\t\t\t\trecipient: verified.recipient,\n\t\t\t\tamount: BigInt(verified.amount),\n\t\t\t\tfullCoinType: inputs.fullCoinType,\n\t\t\t};\n\t\t}\n\t\t// Verify-hit path — the artifact publisher returned the decoded probe shape.\n\t\t// The producing-tx digest lives only in the artifact publisher cache layer (not on\n\t\t// the probe response), so we surface `null` here. Callers that need\n\t\t// the producing digest on a cache hit consult the artifact publisher cache directly.\n\t\treturn {\n\t\t\tdigest: null,\n\t\t\tmintedCoinId: verified.objectId,\n\t\t\trecipient: inputs.recipient,\n\t\t\tamount: inputs.amount,\n\t\t\tfullCoinType: inputs.fullCoinType,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('coin.mint', {\n\t\t\tattributes: {\n\t\t\t\t'coin.mint.recipient': inputs.recipient,\n\t\t\t\t'coin.mint.fullCoinType': inputs.fullCoinType,\n\t\t\t\t'coin.mint.amount': inputs.amount.toString(),\n\t\t\t},\n\t\t}),\n\t);\n\n/** Project an artifact publisher-wire error back to a CoinError when the consumer\n *  wants a coin-side tagged shape. The artifact publisher boundary is generic; this\n *  helper recovers the typed `mint-tx` / `mint-parse` phase the cause\n *  walker uses. */\nexport const mintTxError = (fullCoinType: string, message: string, cause?: unknown): CoinError =>\n\tcoinError('mint-tx', {\n\t\tidentifier: fullCoinType,\n\t\tmessage,\n\t\t...(cause !== undefined ? { cause } : {}),\n\t});\n\nexport const mintParseError = (fullCoinType: string, message: string): CoinError =>\n\tcoinError('mint-parse', {\n\t\tidentifier: fullCoinType,\n\t\tmessage,\n\t});\n"],"mappings":"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"}

package/dist/plugins/coin/registry.d.mts

@@ -0,0 +1 @@
+import { Context, Effect, Layer } from "effect";

package/dist/plugins/coin/registry.mjs

@@ -0,0 +1,37 @@
+import { defineScopedRefMap } from "../../substrate/runtime/scoped-ref-map/service.mjs";
+import { Context, Effect, Layer } from "effect";
+//#region src/plugins/coin/registry.ts
+const coinKey = (fullCoinType) => fullCoinType;
+const CoinRefMap = defineScopedRefMap("CoinRegistry");
+const wrapRefMap = (refMap) => ({
+	register: (record) => refMap.set(coinKey(record.type), record),
+	bySymbol: (symbol) => refMap.entries().pipe(Effect.map((entries) => {
+		const lowered = symbol.toLowerCase();
+		return entries.map(([, r]) => r).filter((r) => r.key === lowered || r.symbol?.toLowerCase() === lowered);
+	})),
+	byWitness: (packageName, witness) => refMap.entries().pipe(Effect.map((entries) => {
+		const lowered = witness.toLowerCase();
+		return entries.map(([, r]) => r).find((r) => r.publishingPackageName === packageName && (r.witness === lowered || r.symbol?.toLowerCase() === lowered)) ?? null;
+	})),
+	byType: (fullCoinType) => refMap.find(coinKey(fullCoinType)).pipe(Effect.map((hit) => hit ?? null)),
+	list: () => refMap.entries().pipe(Effect.map((entries) => entries.map(([, r]) => r)))
+});
+/** Context.Service tag for the per-stack `CoinRegistry`. Plugins
+*  yield this in their acquire body. */
+var CoinRegistryService = class extends Context.Service()("@devstack-rewrite/plugins/coin/CoinRegistry") {};
+/** Scope-bound Layer materializing one `CoinRegistry` per stack
+*  scope. Boot wiring (CLI / e2e) provides this once per stack;
+*  every coin/package/wallet/faucet plugin in the stack yields the
+*  SAME instance via Context. */
+const coinRegistryLayer = Layer.effect(CoinRegistryService, Effect.gen(function* () {
+	const refMap = yield* CoinRefMap.Service;
+	return CoinRegistryService.of(wrapRefMap(refMap));
+})).pipe(Layer.provide(CoinRefMap.layer));
+/** Capability-key constant for the per-stack registry — siblings
+*  (Wallet, Faucet's treasury-cap mint strategy, Manifest emitter)
+*  look it up through the StrategyContributor registry. */
+const COIN_REGISTRY_CAPABILITY_KEY = "coin-registry";
+//#endregion
+export { COIN_REGISTRY_CAPABILITY_KEY, CoinRegistryService, coinRegistryLayer };
+
+//# sourceMappingURL=registry.mjs.map

package/dist/plugins/coin/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":[],"sources":["../../../src/plugins/coin/registry.ts"],"sourcesContent":["// Per-stack CoinRegistry — owned by the L2 Coin plugin.\n//\n// Architecture (ARCHITECTURE.md § Substrate name-blindness): the\n// substrate exposes ONLY the generic `ScopedRefMap<K, V>` primitive;\n// each L2 plugin instantiates it with its own domain shape. The\n// `CoinRecord` shape below carries Sui/Move-coin concepts\n// (`witness`, `treasuryCapId`, `metadataId`, `packageId`,\n// `mvrPlaceholder`, `publishingPackageName`, `moduleName`) — those\n// are L2 concerns, not substrate.\n//\n// The five Sui-specific lookup shapes (`bySymbol`, `byWitness`,\n// `byType`, `list`, `register`) live on the L2 `CoinRegistry`\n// wrapper. The underlying generic primitive only knows `K -> V`;\n// the wrapper iterates the snapshot for the symbol / witness /\n// type-based queries (cardinality is bounded by declared coins\n// per stack, typically < 10).\n//\n// Lifetime: one instance per stack scope (the generic primitive's\n// `layer` is scope-bound). Plugins yield `CoinRegistryService`\n// from their `acquire` body; the boot wiring (CLI / e2e) provides\n// the resolved instance once per stack.\n\nimport { Context, Effect, Layer } from 'effect';\n\nimport {\n\tdefineScopedRefMap,\n\ttype ScopedRefMap,\n} from '../../substrate/runtime/scoped-ref-map/index.ts';\n\n/** Discovered-coin record — the value-shape stored in the registry.\n *  Superset of the published-coin shape with discovery-populated\n *  metadata fields. */\nexport interface CoinRecord {\n\t/** Registry key — the discovered CoinMetadata symbol, falling\n\t *  back to the witness name when metadata is absent. Always\n\t *  lower-cased for case-insensitive lookups (the original-case\n\t *  `symbol` field carries the display form). */\n\treadonly key: string;\n\t/** Fully-qualified on-chain type — `0xPKG::module::Witness`. */\n\treadonly type: string;\n\t/** Lower-cased witness identifier (e.g. `mock_usdc`). Used for\n\t *  the `coin.fromPackage(pkg, 'MOCK_USDC')` lookup. */\n\treadonly witness: string;\n\t/** Lower-cased module name. */\n\treadonly moduleName: string;\n\t/** `0` when CoinMetadata absent. */\n\treadonly decimals: number;\n\t/** Display-case symbol from CoinMetadata. Absent when metadata\n\t *  fetch failed / coin had no CoinMetadata. */\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\t/** Present when the publisher held the cap at publish time AND\n\t *  the cap is still address-owned. */\n\treadonly treasuryCapId?: string;\n\treadonly metadataId?: string;\n\t/** The publishing package's id — load-bearing for the\n\t *  package-scoped witness lookup. */\n\treadonly packageId: string;\n\t/** Source-of-truth name of the publishing package (the Package\n\t *  plugin's symbolic name, NOT the on-chain packageId). Used to\n\t *  format error messages and drive the codegen emitter's\n\t *  per-package grouping. */\n\treadonly publishingPackageName: string;\n}\n\n/** Registry key — the fully-qualified on-chain coin type. Branded so\n *  the generic primitive's `K extends string` constraint applies\n *  without leaking the brand to substrate. */\nexport type CoinKey = string & { readonly _brand: 'CoinKey' };\n\nconst coinKey = (fullCoinType: string): CoinKey => fullCoinType as CoinKey;\n\n/** Per-stack registry of all discovered coins. The five lookup\n *  shapes are Sui-specific projections over a generic `K -> V`\n *  scope-bound ref-map. */\nexport interface CoinRegistry {\n\treadonly register: (record: CoinRecord) => Effect.Effect<void>;\n\treadonly bySymbol: (symbol: string) => Effect.Effect<ReadonlyArray<CoinRecord>>;\n\treadonly byWitness: (packageName: string, witness: string) => Effect.Effect<CoinRecord | null>;\n\treadonly byType: (fullCoinType: string) => Effect.Effect<CoinRecord | null>;\n\treadonly list: () => Effect.Effect<ReadonlyArray<CoinRecord>>;\n}\n\n// Generic substrate primitive — instantiated once per logical\n// registry. The service identity is namespaced by the `name`\n// argument; substrate stays name-blind (it sees only `K` and `V`).\nconst CoinRefMap = defineScopedRefMap<CoinKey, CoinRecord>('CoinRegistry');\n\nconst wrapRefMap = (refMap: ScopedRefMap<CoinKey, CoinRecord>): CoinRegistry => ({\n\tregister: (record) => refMap.set(coinKey(record.type), record),\n\tbySymbol: (symbol) =>\n\t\trefMap.entries().pipe(\n\t\t\tEffect.map((entries) => {\n\t\t\t\tconst lowered = symbol.toLowerCase();\n\t\t\t\treturn entries\n\t\t\t\t\t.map(([, r]) => r)\n\t\t\t\t\t.filter((r) => r.key === lowered || r.symbol?.toLowerCase() === lowered);\n\t\t\t}),\n\t\t),\n\tbyWitness: (packageName, witness) =>\n\t\trefMap.entries().pipe(\n\t\t\tEffect.map((entries) => {\n\t\t\t\tconst lowered = witness.toLowerCase();\n\t\t\t\treturn (\n\t\t\t\t\tentries\n\t\t\t\t\t\t.map(([, r]) => r)\n\t\t\t\t\t\t.find(\n\t\t\t\t\t\t\t(r) =>\n\t\t\t\t\t\t\t\tr.publishingPackageName === packageName &&\n\t\t\t\t\t\t\t\t(r.witness === lowered || r.symbol?.toLowerCase() === lowered),\n\t\t\t\t\t\t) ?? null\n\t\t\t\t);\n\t\t\t}),\n\t\t),\n\tbyType: (fullCoinType) =>\n\t\trefMap.find(coinKey(fullCoinType)).pipe(Effect.map((hit) => hit ?? null)),\n\tlist: () => refMap.entries().pipe(Effect.map((entries) => entries.map(([, r]) => r))),\n});\n\n/** Context.Service tag for the per-stack `CoinRegistry`. Plugins\n *  yield this in their acquire body. */\nexport class CoinRegistryService extends Context.Service<CoinRegistryService, CoinRegistry>()(\n\t'@devstack-rewrite/plugins/coin/CoinRegistry',\n) {}\n\n/** Scope-bound Layer materializing one `CoinRegistry` per stack\n *  scope. Boot wiring (CLI / e2e) provides this once per stack;\n *  every coin/package/wallet/faucet plugin in the stack yields the\n *  SAME instance via Context. */\nexport const coinRegistryLayer: Layer.Layer<CoinRegistryService> = Layer.effect(\n\tCoinRegistryService,\n\tEffect.gen(function* () {\n\t\tconst refMap = yield* CoinRefMap.Service;\n\t\treturn CoinRegistryService.of(wrapRefMap(refMap));\n\t}),\n).pipe(Layer.provide(CoinRefMap.layer));\n\n/** Capability-key constant for the per-stack registry — siblings\n *  (Wallet, Faucet's treasury-cap mint strategy, Manifest emitter)\n *  look it up through the StrategyContributor registry. */\nexport const COIN_REGISTRY_CAPABILITY_KEY = 'coin-registry' as const;\n"],"mappings":";;;AAuEA,MAAM,WAAW,iBAAkC;AAgBnD,MAAM,aAAa,mBAAwC,eAAe;AAE1E,MAAM,cAAc,YAA6D;CAChF,WAAW,WAAW,OAAO,IAAI,QAAQ,OAAO,KAAK,EAAE,OAAO;CAC9D,WAAW,WACV,OAAO,SAAS,CAAC,KAChB,OAAO,KAAK,YAAY;EACvB,MAAM,UAAU,OAAO,aAAa;AACpC,SAAO,QACL,KAAK,GAAG,OAAO,EAAE,CACjB,QAAQ,MAAM,EAAE,QAAQ,WAAW,EAAE,QAAQ,aAAa,KAAK,QAAQ;GACxE,CACF;CACF,YAAY,aAAa,YACxB,OAAO,SAAS,CAAC,KAChB,OAAO,KAAK,YAAY;EACvB,MAAM,UAAU,QAAQ,aAAa;AACrC,SACC,QACE,KAAK,GAAG,OAAO,EAAE,CACjB,MACC,MACA,EAAE,0BAA0B,gBAC3B,EAAE,YAAY,WAAW,EAAE,QAAQ,aAAa,KAAK,SACvD,IAAI;GAEN,CACF;CACF,SAAS,iBACR,OAAO,KAAK,QAAQ,aAAa,CAAC,CAAC,KAAK,OAAO,KAAK,QAAQ,OAAO,KAAK,CAAC;CAC1E,YAAY,OAAO,SAAS,CAAC,KAAK,OAAO,KAAK,YAAY,QAAQ,KAAK,GAAG,OAAO,EAAE,CAAC,CAAC;CACrF;;;AAID,IAAa,sBAAb,cAAyC,QAAQ,SAA4C,CAC5F,8CACA,CAAC;;;;;AAMF,MAAa,oBAAsD,MAAM,OACxE,qBACA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO,WAAW;AACjC,QAAO,oBAAoB,GAAG,WAAW,OAAO,CAAC;EAChD,CACF,CAAC,KAAK,MAAM,QAAQ,WAAW,MAAM,CAAC;;;;AAKvC,MAAa,+BAA+B"}

package/dist/plugins/coin/service.d.mts

@@ -0,0 +1,47 @@
+import { ArtifactPublishError } from "../../primitives/artifact-publisher.mjs";
+import { CoinError } from "./errors.mjs";
+import { MintResult, MintSigner } from "./mint.mjs";
+import { BUILTIN_COINS, ResolvedCoin } from "./address-resolution.mjs";
+import { Effect, Scope } from "effect";
+
+//#region src/plugins/coin/service.d.ts
+/** Per-instance options threaded into the acquire body. One-of the
+ *  three address forms. */
+type CoinAddressForm = {
+  readonly kind: 'witness';
+  readonly publishingPackageName: string;
+  readonly witness: string;
+  readonly fundingSigner?: MintSigner;
+} | {
+  readonly kind: 'known';
+  readonly fullCoinType: string;
+} | {
+  readonly kind: 'builtin';
+  readonly name: keyof typeof BUILTIN_COINS;
+};
+/** The tag's resolved value — the three address forms unified PLUS a
+ *  closure for the generic mint surface. */
+interface CoinValue extends ResolvedCoin {
+  /** Generic mint. Requires the cap id (either resolved from the
+   *  registry record's `treasuryCapId`, or supplied explicitly for
+   *  bare-type coins). Each call yields a fresh artifact publisher round (cache
+   *  hit means short-circuit per the substrate primitive). */
+  readonly mint: (signer: MintSigner, opts: {
+    readonly to: string;
+    readonly amount: bigint;
+    readonly treasuryCapId?: string;
+  }) => Effect.Effect<MintResult, CoinError | ArtifactPublishError, Scope.Scope>;
+  /** Centralized funding strategy, present for local package coins
+   *  whose publisher still owns the TreasuryCap. The coin barrel
+   *  publishes it under `coinType:<fullCoinType>` so Account funding
+   *  can mint arbitrary local coins without bespoke example actions. */
+  readonly fundingStrategy?: {
+    readonly request: (req: {
+      readonly address: string;
+      readonly amount: bigint;
+    }) => Effect.Effect<void, CoinError | ArtifactPublishError>;
+  };
+}
+//#endregion
+export { CoinAddressForm, CoinValue };
+//# sourceMappingURL=service.d.mts.map

package/dist/plugins/coin/service.mjs

@@ -0,0 +1,51 @@
+import { coinError } from "./errors.mjs";
+import { resolveBuiltin, resolveByBareType, resolveByWitness } from "./address-resolution.mjs";
+import { performMint } from "./mint.mjs";
+import { Effect } from "effect";
+//#region src/plugins/coin/service.ts
+/** Resolve a coin instance to the tag's resolved value. */
+const acquireCoin = (form, ctx) => Effect.gen(function* () {
+	yield* Effect.annotateCurrentSpan({ "coin.form": form.kind });
+	const resolved = yield* (() => {
+		switch (form.kind) {
+			case "witness": return resolveByWitness(ctx.registry, form.publishingPackageName, form.witness);
+			case "known": return resolveByBareType(ctx.sdk, form.fullCoinType);
+			case "builtin": return Effect.succeed(resolveBuiltin(form.name));
+		}
+	})();
+	yield* Effect.annotateCurrentSpan({
+		"coin.fullCoinType": resolved.fullCoinType,
+		"coin.decimals": resolved.decimals,
+		"coin.source": resolved.source
+	});
+	const mint = (signer, opts) => {
+		const capId = opts.treasuryCapId ?? resolved.treasuryCapId;
+		if (capId === void 0) return Effect.fail(coinError("cap-missing", {
+			identifier: resolved.fullCoinType,
+			message: `coin('${resolved.fullCoinType}').mint(): no treasury cap available — pass opts.treasuryCapId or use a coin discovered with publisherOwnsCap=true.`
+		}));
+		const inputs = {
+			fullCoinType: resolved.fullCoinType,
+			treasuryCapId: capId,
+			recipient: opts.to,
+			amount: opts.amount
+		};
+		return performMint(ctx.publisher, ctx.chain, signer, ctx.sdk, inputs);
+	};
+	const fundingSigner = form.kind === "witness" ? form.fundingSigner : void 0;
+	const fundingTreasuryCapId = resolved.treasuryCapId;
+	const fundingStrategy = fundingSigner !== void 0 && fundingTreasuryCapId !== void 0 ? { request: (req) => Effect.scoped(mint(fundingSigner, {
+		to: req.address,
+		amount: req.amount,
+		treasuryCapId: fundingTreasuryCapId
+	}).pipe(Effect.asVoid)) } : void 0;
+	return {
+		...resolved,
+		mint,
+		...fundingStrategy === void 0 ? {} : { fundingStrategy }
+	};
+});
+//#endregion
+export { acquireCoin };
+
+//# sourceMappingURL=service.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":[],"sources":["../../../src/plugins/coin/service.ts"],"sourcesContent":["// Coin plugin — main acquire body.\n//\n// One-shot value resolution: the three address forms unify behind a\n// single `acquireCoin` Effect. The barrel (`index.ts`) constructs ONE\n// `CoinAcquireInputs` per declared coin instance and routes here.\n//\n// What this file does:\n//\n//   1. Dispatch on the address-form discriminator to the right\n//      resolver under `address-resolution.ts`.\n//   2. Project the resolved value into the user-facing `ResolvedCoin`\n//      shape that the Tag publishes.\n//   3. Project a `mint(...)` closure (lazy mint — captures the\n//      resolved fullCoinType + the cap id; defers the substrate-\n//      primitive call to mint time so the cache key is keyed on\n//      mint-time inputs, not factory-time ones).\n//\n// What it does NOT do:\n//\n//   - Consume the LocalPackagePublishOutput — that's the discovery-fold path\n//     handled at compose-time in the barrel (the barrel calls into\n//     `discovery.ts` + `metadata.ts` to populate the registry as\n//     packages publish; this file just READS the registry).\n//   - Wire capabilities — the barrel's job.\n\nimport { Effect, type Scope } from 'effect';\n\nimport type { ChainId } from '../../substrate/brand.ts';\nimport type {\n\tArtifactPublishError,\n\tArtifactPublisher,\n} from '../../primitives/artifact-publisher.ts';\nimport {\n\tBUILTIN_COINS,\n\tresolveBuiltin,\n\tresolveByBareType,\n\tresolveByWitness,\n\ttype ResolvedCoin,\n} from './address-resolution.ts';\nimport { coinError, type CoinError } from './errors.ts';\nimport type { MetadataSdkShim } from './metadata.ts';\nimport {\n\tperformMint,\n\ttype MintInputs,\n\ttype MintResult,\n\ttype MintSdkShim,\n\ttype MintSigner,\n} from './mint.ts';\nimport type { CoinRegistry } from './registry.ts';\n\n/** Per-instance options threaded into the acquire body. One-of the\n *  three address forms. */\nexport type CoinAddressForm =\n\t| {\n\t\t\treadonly kind: 'witness';\n\t\t\treadonly publishingPackageName: string;\n\t\t\treadonly witness: string;\n\t\t\treadonly fundingSigner?: MintSigner;\n\t  }\n\t| { readonly kind: 'known'; readonly fullCoinType: string }\n\t| { readonly kind: 'builtin'; readonly name: keyof typeof BUILTIN_COINS };\n\n/** Per-acquire context supplied by the barrel from the BuildContext.\n *  Carries the resolved per-stack registry, the Sui-side SDK shim\n *  (verify probe + tx build), the chain id, and the\n *  `ArtifactPublisher` substrate primitive used by `performMint`. */\nexport interface CoinAcquireContext {\n\treadonly registry: CoinRegistry;\n\treadonly sdk: MetadataSdkShim & MintSdkShim;\n\treadonly chain: ChainId;\n\treadonly publisher: ArtifactPublisher;\n}\n\n/** The tag's resolved value — the three address forms unified PLUS a\n *  closure for the generic mint surface. */\nexport interface CoinValue extends ResolvedCoin {\n\t/** Generic mint. Requires the cap id (either resolved from the\n\t *  registry record's `treasuryCapId`, or supplied explicitly for\n\t *  bare-type coins). Each call yields a fresh artifact publisher round (cache\n\t *  hit means short-circuit per the substrate primitive). */\n\treadonly mint: (\n\t\tsigner: MintSigner,\n\t\topts: { readonly to: string; readonly amount: bigint; readonly treasuryCapId?: string },\n\t) => Effect.Effect<MintResult, CoinError | ArtifactPublishError, Scope.Scope>;\n\t/** Centralized funding strategy, present for local package coins\n\t *  whose publisher still owns the TreasuryCap. The coin barrel\n\t *  publishes it under `coinType:<fullCoinType>` so Account funding\n\t *  can mint arbitrary local coins without bespoke example actions. */\n\treadonly fundingStrategy?: {\n\t\treadonly request: (req: {\n\t\t\treadonly address: string;\n\t\t\treadonly amount: bigint;\n\t\t}) => Effect.Effect<void, CoinError | ArtifactPublishError>;\n\t};\n}\n\n/** Resolve a coin instance to the tag's resolved value. */\nexport const acquireCoin = (\n\tform: CoinAddressForm,\n\tctx: CoinAcquireContext,\n): Effect.Effect<CoinValue, CoinError> =>\n\tEffect.gen(function* () {\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t'coin.form': form.kind,\n\t\t});\n\n\t\tconst resolved: ResolvedCoin = yield* (() => {\n\t\t\tswitch (form.kind) {\n\t\t\t\tcase 'witness':\n\t\t\t\t\treturn resolveByWitness(ctx.registry, form.publishingPackageName, form.witness);\n\t\t\t\tcase 'known':\n\t\t\t\t\treturn resolveByBareType(ctx.sdk, form.fullCoinType);\n\t\t\t\tcase 'builtin':\n\t\t\t\t\treturn Effect.succeed(resolveBuiltin(form.name));\n\t\t\t}\n\t\t})();\n\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t'coin.fullCoinType': resolved.fullCoinType,\n\t\t\t'coin.decimals': resolved.decimals,\n\t\t\t'coin.source': resolved.source,\n\t\t});\n\n\t\tconst mint: CoinValue['mint'] = (signer, opts) => {\n\t\t\tconst capId = opts.treasuryCapId ?? resolved.treasuryCapId;\n\t\t\tif (capId === undefined) {\n\t\t\t\treturn Effect.fail(\n\t\t\t\t\tcoinError('cap-missing', {\n\t\t\t\t\t\tidentifier: resolved.fullCoinType,\n\t\t\t\t\t\tmessage: `coin('${resolved.fullCoinType}').mint(): no treasury cap available — pass opts.treasuryCapId or use a coin discovered with publisherOwnsCap=true.`,\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst inputs: MintInputs = {\n\t\t\t\tfullCoinType: resolved.fullCoinType,\n\t\t\t\ttreasuryCapId: capId,\n\t\t\t\trecipient: opts.to,\n\t\t\t\tamount: opts.amount,\n\t\t\t};\n\t\t\treturn performMint(ctx.publisher, ctx.chain, signer, ctx.sdk, inputs);\n\t\t};\n\t\tconst fundingSigner = form.kind === 'witness' ? form.fundingSigner : undefined;\n\t\tconst fundingTreasuryCapId = resolved.treasuryCapId;\n\t\tconst fundingStrategy =\n\t\t\tfundingSigner !== undefined && fundingTreasuryCapId !== undefined\n\t\t\t\t? {\n\t\t\t\t\t\trequest: (req: { readonly address: string; readonly amount: bigint }) =>\n\t\t\t\t\t\t\tEffect.scoped(\n\t\t\t\t\t\t\t\tmint(fundingSigner, {\n\t\t\t\t\t\t\t\t\tto: req.address,\n\t\t\t\t\t\t\t\t\tamount: req.amount,\n\t\t\t\t\t\t\t\t\ttreasuryCapId: fundingTreasuryCapId,\n\t\t\t\t\t\t\t\t}).pipe(Effect.asVoid),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\tconst value: CoinValue = {\n\t\t\t...resolved,\n\t\t\tmint,\n\t\t\t...(fundingStrategy === undefined ? {} : { fundingStrategy }),\n\t\t};\n\t\treturn value;\n\t});\n"],"mappings":";;;;;;AAiGA,MAAa,eACZ,MACA,QAEA,OAAO,IAAI,aAAa;AACvB,QAAO,OAAO,oBAAoB,EACjC,aAAa,KAAK,MAClB,CAAC;CAEF,MAAM,WAAyB,cAAc;AAC5C,UAAQ,KAAK,MAAb;GACC,KAAK,UACJ,QAAO,iBAAiB,IAAI,UAAU,KAAK,uBAAuB,KAAK,QAAQ;GAChF,KAAK,QACJ,QAAO,kBAAkB,IAAI,KAAK,KAAK,aAAa;GACrD,KAAK,UACJ,QAAO,OAAO,QAAQ,eAAe,KAAK,KAAK,CAAC;;KAE/C;AAEJ,QAAO,OAAO,oBAAoB;EACjC,qBAAqB,SAAS;EAC9B,iBAAiB,SAAS;EAC1B,eAAe,SAAS;EACxB,CAAC;CAEF,MAAM,QAA2B,QAAQ,SAAS;EACjD,MAAM,QAAQ,KAAK,iBAAiB,SAAS;AAC7C,MAAI,UAAU,KAAA,EACb,QAAO,OAAO,KACb,UAAU,eAAe;GACxB,YAAY,SAAS;GACrB,SAAS,SAAS,SAAS,aAAa;GACxC,CAAC,CACF;EAEF,MAAM,SAAqB;GAC1B,cAAc,SAAS;GACvB,eAAe;GACf,WAAW,KAAK;GAChB,QAAQ,KAAK;GACb;AACD,SAAO,YAAY,IAAI,WAAW,IAAI,OAAO,QAAQ,IAAI,KAAK,OAAO;;CAEtE,MAAM,gBAAgB,KAAK,SAAS,YAAY,KAAK,gBAAgB,KAAA;CACrE,MAAM,uBAAuB,SAAS;CACtC,MAAM,kBACL,kBAAkB,KAAA,KAAa,yBAAyB,KAAA,IACrD,EACA,UAAU,QACT,OAAO,OACN,KAAK,eAAe;EACnB,IAAI,IAAI;EACR,QAAQ,IAAI;EACZ,eAAe;EACf,CAAC,CAAC,KAAK,OAAO,OAAO,CACtB,EACF,GACA,KAAA;AAMJ,QAAO;EAJN,GAAG;EACH;EACA,GAAI,oBAAoB,KAAA,IAAY,EAAE,GAAG,EAAE,iBAAiB;EAEjD;EACX"}

package/dist/plugins/coin/snapshot.mjs

@@ -0,0 +1,19 @@
+import { Effect } from "effect";
+//#region src/plugins/coin/snapshot.ts
+/** Identity guard for the snapshot orchestrator. Per-coin record so
+*  the substrate can dedup by `(plugin, symbol)` if a future
+*  per-coin wipe lands. */
+const makeCoinSnapshotable = (parts) => ({
+	kind: "snapshotable",
+	subtrees: [],
+	missingTolerance: "fine",
+	preRestore: Effect.succeed({
+		kind: "coin",
+		symbol: parts.symbol
+	}),
+	postRestore: Effect.void
+});
+//#endregion
+export { makeCoinSnapshotable };
+
+//# sourceMappingURL=snapshot.mjs.map

package/dist/plugins/coin/snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../src/plugins/coin/snapshot.ts"],"sourcesContent":["// Coin plugin — Snapshotable contribution.\n//\n// Distilled-doc 13-coin.md §Persistence model:\n//\n//   - The mint-cache (`coin/mint/<chainId>/...`) lives in the\n//     state-store and IS captured by the substrate's auto-included\n//     subtree under `runtime/<plugin-key>/state-store/...`. We\n//     declare no extra subtrees here.\n//   - The `CoinRegistry` is purely in-process; nothing to capture.\n//   - Per-Layer-invocation metadata cache is also in-process.\n//\n// The plugin therefore emits a MINIMAL snapshot decl:\n// `missingTolerance: 'fine'` (a fresh stack with no cache entries\n// just re-mints / re-resolves on next acquisition), no subtrees, no\n// containers. The decl exists for shape symmetry with the other\n// plugins and so a per-coin \"wipe\" recipe has a contribution to\n// target in the future.\n\nimport { Effect } from 'effect';\n\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\n\n/** Identity guard for the snapshot orchestrator. Per-coin record so\n *  the substrate can dedup by `(plugin, symbol)` if a future\n *  per-coin wipe lands. */\nexport const makeCoinSnapshotable = (parts: { readonly symbol: string }): SnapshotableDecl => ({\n\tkind: 'snapshotable',\n\tsubtrees: [],\n\tmissingTolerance: 'fine',\n\tpreRestore: Effect.succeed({\n\t\tkind: 'coin' as const,\n\t\tsymbol: parts.symbol,\n\t}),\n\tpostRestore: Effect.void,\n});\n"],"mappings":";;;;;AAyBA,MAAa,wBAAwB,WAA0D;CAC9F,MAAM;CACN,UAAU,EAAE;CACZ,kBAAkB;CAClB,YAAY,OAAO,QAAQ;EAC1B,MAAM;EACN,QAAQ,MAAM;EACd,CAAC;CACF,aAAa,OAAO;CACpB"}

package/dist/plugins/coin/type-strings.mjs

@@ -0,0 +1,49 @@
+//#region src/plugins/coin/type-strings.ts
+const normalizeSuiAddress = (address) => {
+	if (!address.startsWith("0x")) return null;
+	const hex = address.slice(2).toLowerCase();
+	if (!/^[0-9a-f]+$/.test(hex)) return null;
+	return `0x${hex.replace(/^0+/, "") || "0"}`;
+};
+const normalizeStructTypeAddress = (typeName) => {
+	const parts = typeName.split("::");
+	if (parts.length !== 3) return null;
+	const [address, moduleName, structName] = parts;
+	if (address === void 0 || moduleName === void 0 || structName === void 0) return null;
+	const normalizedAddress = normalizeSuiAddress(address) ?? (address.startsWith("0x") ? address : null);
+	if (normalizedAddress === null) return null;
+	return `${normalizedAddress}::${moduleName}::${structName}`;
+};
+/** Parse the inner generic out of Sui-framework `coin::<Wrapper><INNER>`.
+*  The SDK may spell the framework address as `0x2` or fully padded
+*  `0x000...0002`; normalize before matching. Returns `null` if the
+*  inner generic itself carries angle brackets. */
+const pickSuiFrameworkInnerGenericFromModule = (objectType, moduleName, wrapperName) => {
+	if (!objectType.endsWith(">")) return null;
+	const firstSep = objectType.indexOf("::");
+	const secondSep = objectType.indexOf("::", firstSep + 2);
+	if (firstSep === -1 || secondSep === -1) return null;
+	const address = objectType.slice(0, firstSep);
+	const actualModuleName = objectType.slice(firstSep + 2, secondSep);
+	const rest = objectType.slice(secondSep + 2);
+	if (normalizeSuiAddress(address) !== "0x2") return null;
+	if (actualModuleName !== moduleName) return null;
+	const wrapperPrefix = `${wrapperName}<`;
+	if (!rest.startsWith(wrapperPrefix)) return null;
+	const inner = rest.slice(wrapperPrefix.length, -1);
+	if (inner.includes("<") || inner.includes(">")) return null;
+	if (normalizeStructTypeAddress(inner) === null) return null;
+	return inner;
+};
+const pickSuiFrameworkInnerGeneric = (objectType, wrapperName) => pickSuiFrameworkInnerGenericFromModule(objectType, "coin", wrapperName);
+const isSuiFrameworkObjectForCoin = (objectType, wrapperName, fullCoinType) => {
+	const inner = pickSuiFrameworkInnerGeneric(objectType, wrapperName);
+	if (inner === null) return false;
+	const normalizedInner = normalizeStructTypeAddress(inner);
+	const normalizedExpected = normalizeStructTypeAddress(fullCoinType);
+	return normalizedInner !== null && normalizedExpected !== null && normalizedInner === normalizedExpected;
+};
+//#endregion
+export { isSuiFrameworkObjectForCoin, pickSuiFrameworkInnerGeneric, pickSuiFrameworkInnerGenericFromModule };
+
+//# sourceMappingURL=type-strings.mjs.map

package/dist/plugins/coin/type-strings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-strings.mjs","names":[],"sources":["../../../src/plugins/coin/type-strings.ts"],"sourcesContent":["export const normalizeSuiAddress = (address: string): string | null => {\n\tif (!address.startsWith('0x')) return null;\n\tconst hex = address.slice(2).toLowerCase();\n\tif (!/^[0-9a-f]+$/.test(hex)) return null;\n\treturn `0x${hex.replace(/^0+/, '') || '0'}`;\n};\n\nexport const normalizeStructTypeAddress = (typeName: string): string | null => {\n\tconst parts = typeName.split('::');\n\tif (parts.length !== 3) return null;\n\tconst [address, moduleName, structName] = parts;\n\tif (address === undefined || moduleName === undefined || structName === undefined) return null;\n\tconst normalizedAddress =\n\t\tnormalizeSuiAddress(address) ?? (address.startsWith('0x') ? address : null);\n\tif (normalizedAddress === null) return null;\n\treturn `${normalizedAddress}::${moduleName}::${structName}`;\n};\n\n/** Parse the inner generic out of Sui-framework `coin::<Wrapper><INNER>`.\n *  The SDK may spell the framework address as `0x2` or fully padded\n *  `0x000...0002`; normalize before matching. Returns `null` if the\n *  inner generic itself carries angle brackets. */\nexport const pickSuiFrameworkInnerGenericFromModule = (\n\tobjectType: string,\n\tmoduleName: string,\n\twrapperName: string,\n): string | null => {\n\tif (!objectType.endsWith('>')) return null;\n\tconst firstSep = objectType.indexOf('::');\n\tconst secondSep = objectType.indexOf('::', firstSep + 2);\n\tif (firstSep === -1 || secondSep === -1) return null;\n\tconst address = objectType.slice(0, firstSep);\n\tconst actualModuleName = objectType.slice(firstSep + 2, secondSep);\n\tconst rest = objectType.slice(secondSep + 2);\n\tif (normalizeSuiAddress(address) !== '0x2') return null;\n\tif (actualModuleName !== moduleName) return null;\n\tconst wrapperPrefix = `${wrapperName}<`;\n\tif (!rest.startsWith(wrapperPrefix)) return null;\n\tconst inner = rest.slice(wrapperPrefix.length, -1);\n\tif (inner.includes('<') || inner.includes('>')) return null;\n\tif (normalizeStructTypeAddress(inner) === null) return null;\n\treturn inner;\n};\n\nexport const pickSuiFrameworkInnerGeneric = (\n\tobjectType: string,\n\twrapperName: string,\n): string | null => pickSuiFrameworkInnerGenericFromModule(objectType, 'coin', wrapperName);\n\nexport const isSuiFrameworkObjectForCoin = (\n\tobjectType: string,\n\twrapperName: string,\n\tfullCoinType: string,\n): boolean => {\n\tconst inner = pickSuiFrameworkInnerGeneric(objectType, wrapperName);\n\tif (inner === null) return false;\n\tconst normalizedInner = normalizeStructTypeAddress(inner);\n\tconst normalizedExpected = normalizeStructTypeAddress(fullCoinType);\n\treturn (\n\t\tnormalizedInner !== null &&\n\t\tnormalizedExpected !== null &&\n\t\tnormalizedInner === normalizedExpected\n\t);\n};\n"],"mappings":";AAAA,MAAa,uBAAuB,YAAmC;AACtE,KAAI,CAAC,QAAQ,WAAW,KAAK,CAAE,QAAO;CACtC,MAAM,MAAM,QAAQ,MAAM,EAAE,CAAC,aAAa;AAC1C,KAAI,CAAC,cAAc,KAAK,IAAI,CAAE,QAAO;AACrC,QAAO,KAAK,IAAI,QAAQ,OAAO,GAAG,IAAI;;AAGvC,MAAa,8BAA8B,aAAoC;CAC9E,MAAM,QAAQ,SAAS,MAAM,KAAK;AAClC,KAAI,MAAM,WAAW,EAAG,QAAO;CAC/B,MAAM,CAAC,SAAS,YAAY,cAAc;AAC1C,KAAI,YAAY,KAAA,KAAa,eAAe,KAAA,KAAa,eAAe,KAAA,EAAW,QAAO;CAC1F,MAAM,oBACL,oBAAoB,QAAQ,KAAK,QAAQ,WAAW,KAAK,GAAG,UAAU;AACvE,KAAI,sBAAsB,KAAM,QAAO;AACvC,QAAO,GAAG,kBAAkB,IAAI,WAAW,IAAI;;;;;;AAOhD,MAAa,0CACZ,YACA,YACA,gBACmB;AACnB,KAAI,CAAC,WAAW,SAAS,IAAI,CAAE,QAAO;CACtC,MAAM,WAAW,WAAW,QAAQ,KAAK;CACzC,MAAM,YAAY,WAAW,QAAQ,MAAM,WAAW,EAAE;AACxD,KAAI,aAAa,MAAM,cAAc,GAAI,QAAO;CAChD,MAAM,UAAU,WAAW,MAAM,GAAG,SAAS;CAC7C,MAAM,mBAAmB,WAAW,MAAM,WAAW,GAAG,UAAU;CAClE,MAAM,OAAO,WAAW,MAAM,YAAY,EAAE;AAC5C,KAAI,oBAAoB,QAAQ,KAAK,MAAO,QAAO;AACnD,KAAI,qBAAqB,WAAY,QAAO;CAC5C,MAAM,gBAAgB,GAAG,YAAY;AACrC,KAAI,CAAC,KAAK,WAAW,cAAc,CAAE,QAAO;CAC5C,MAAM,QAAQ,KAAK,MAAM,cAAc,QAAQ,GAAG;AAClD,KAAI,MAAM,SAAS,IAAI,IAAI,MAAM,SAAS,IAAI,CAAE,QAAO;AACvD,KAAI,2BAA2B,MAAM,KAAK,KAAM,QAAO;AACvD,QAAO;;AAGR,MAAa,gCACZ,YACA,gBACmB,uCAAuC,YAAY,QAAQ,YAAY;AAE3F,MAAa,+BACZ,YACA,aACA,iBACa;CACb,MAAM,QAAQ,6BAA6B,YAAY,YAAY;AACnE,KAAI,UAAU,KAAM,QAAO;CAC3B,MAAM,kBAAkB,2BAA2B,MAAM;CACzD,MAAM,qBAAqB,2BAA2B,aAAa;AACnE,QACC,oBAAoB,QACpB,uBAAuB,QACvB,oBAAoB"}

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

@@ -0,0 +1,39 @@
+//#region src/plugins/deepbook/codegen.d.ts
+interface DeepbookPoolBinding {
+  readonly name: string;
+  readonly poolId: string;
+  readonly base: string;
+  readonly quote: string;
+  readonly baseCoinType: string;
+  readonly quoteCoinType: string;
+}
+interface DeepbookBindings {
+  readonly name: string;
+  readonly chain: string;
+  readonly packageId: string;
+  readonly registryId: string;
+  readonly adminCapId: string | null;
+  readonly deepTreasuryId: string | null;
+  readonly pools: ReadonlyArray<DeepbookPoolBinding>;
+  readonly pyth: {
+    readonly packageId: string | null;
+    readonly stateId: string | null;
+    readonly wormholeStateId: string | null;
+    readonly feeds: ReadonlyArray<{
+      readonly symbol: string;
+      readonly feedId: string;
+      readonly priceInfoObjectId: string;
+      readonly price: string;
+      readonly expo: number;
+    }>;
+  } | null;
+  readonly margin: {
+    readonly packageId: string;
+    readonly registryId: string;
+  } | null;
+  readonly serverUrl: string | null;
+  readonly indexerUrl: string | null;
+}
+//#endregion
+export { DeepbookBindings, DeepbookPoolBinding };
+//# sourceMappingURL=codegen.d.mts.map

package/dist/plugins/deepbook/codegen.mjs

@@ -0,0 +1,15 @@
+import { Effect } from "effect";
+//#region src/plugins/deepbook/codegen.ts
+const makeDeepbookCodegenable = (bindings) => ({
+	kind: "codegenable",
+	emitterName: "deepbook-network",
+	outputPath: `deepbook/${bindings.name}.ts`,
+	emit: (ctx) => Effect.sync(() => {
+		ctx.exportConst("deepbookBindings", bindings);
+		return ctx.done();
+	})
+});
+//#endregion
+export { makeDeepbookCodegenable };
+
+//# sourceMappingURL=codegen.mjs.map

package/dist/plugins/deepbook/codegen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.mjs","names":[],"sources":["../../../src/plugins/deepbook/codegen.ts"],"sourcesContent":["// Deepbook plugin — Codegenable contribution.\n//\n// One emit shape: `deepbook-network`. Mirrors the resolved value's\n// stable identifiers (package id, registry id, per-pool ids).\n\nimport { Effect } from 'effect';\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\n\nexport interface DeepbookPoolBinding {\n\treadonly name: string;\n\treadonly poolId: string;\n\treadonly base: string;\n\treadonly quote: string;\n\treadonly baseCoinType: string;\n\treadonly quoteCoinType: string;\n}\n\nexport interface DeepbookBindings {\n\treadonly name: string;\n\treadonly chain: string;\n\treadonly packageId: string;\n\treadonly registryId: string;\n\treadonly adminCapId: string | null;\n\treadonly deepTreasuryId: string | null;\n\treadonly pools: ReadonlyArray<DeepbookPoolBinding>;\n\treadonly pyth: {\n\t\treadonly packageId: string | null;\n\t\treadonly stateId: string | null;\n\t\treadonly wormholeStateId: string | null;\n\t\treadonly feeds: ReadonlyArray<{\n\t\t\treadonly symbol: string;\n\t\t\treadonly feedId: string;\n\t\t\treadonly priceInfoObjectId: string;\n\t\t\treadonly price: string;\n\t\t\treadonly expo: number;\n\t\t}>;\n\t} | null;\n\treadonly margin: {\n\t\treadonly packageId: string;\n\t\treadonly registryId: string;\n\t} | null;\n\treadonly serverUrl: string | null;\n\treadonly indexerUrl: string | null;\n}\n\nexport const makeDeepbookCodegenable = (\n\tbindings: DeepbookBindings,\n): CodegenableDecl<'deepbook-network'> => ({\n\tkind: 'codegenable',\n\temitterName: 'deepbook-network',\n\toutputPath: `deepbook/${bindings.name}.ts`,\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\tctx.exportConst('deepbookBindings', bindings satisfies DeepbookBindings);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n"],"mappings":";;AA8CA,MAAa,2BACZ,cAC0C;CAC1C,MAAM;CACN,aAAa;CACb,YAAY,YAAY,SAAS,KAAK;CACtC,OAAO,QACN,OAAO,WAAW;AACjB,MAAI,YAAY,oBAAoB,SAAoC;AACxE,SAAO,IAAI,MAAM;GAChB;CACH"}