@mysten-incubation/devstack 0.1.1 → 0.2.0

package/dist/plugins/coin/codegen.mjs

@@ -1,22 +1,103 @@
-import { defineSimpleConstExport } from "../internal/codegen-helpers.mjs";
+import { keyedBucketSpec, liveBucketCodegen, staticBucketCodegen } from "../../contracts/config-bindings.mjs";
 //#region src/plugins/coin/codegen.ts
-/** Construct the Codegenable contribution for one coin instance.
+/** Build the coin's config-binding spec for symbol `key`. `symbol` and
+*  `source` are structural literals; the coin type, decimals, and on-chain
+*  object ids are runtime-resolved (`resolveValue`).
 *
-*  Emitter name is literal `coin/${symbol}` so the orchestrator can
-*  group them and folds them into a single `coins.ts` at staging
-*  time. Mirrors `account/${name}` naming in the Account plugin. */
-const makeCoinCodegen = (parts) => defineSimpleConstExport({
-	emitterName: `coin/${parts.symbol}`,
-	outputPath: `coins/${parts.symbol}.ts`,
-	exportName: parts.symbol,
-	value: parts.resolved,
-	aggregate: {
-		kind: "coin",
-		bucket: "coins.ts",
-		project: (exported) => exported
+*  Field-set DETERMINISM. A committed `resolveValue(...)` call evaluates at
+*  module-load and THROWS when the id is absent, so the static stub must
+*  emit ONLY fields the injected ids will carry. `source` (known at factory
+*  time) decides this: a `'builtin'` coin (SUI) is fully protocol-defined —
+*  it carries NO package id and its coin type / decimals are constants, so
+*  it emits them as LITERALS (no `resolveValue` that would throw at load).
+*  A `'registry'` / `'on-chain'` coin carries a real `packageId`, so it
+*  emits `fullCoinType` / `decimals` / `packageId` as resolved. The OPTIONAL
+*  discovery-only ids (`treasuryCapId` / `metadataId` / `iconUrl` /
+*  `displayName`) are non-deterministic — the static stub omits them; the
+*  LIVE record emits whatever it actually surfaced (consumers read them
+*  through optional chaining). */
+const coinBucketSpec = (key, structural, live) => {
+	const builtin = structural.source === "builtin";
+	const fields = [{
+		key: "symbol",
+		variant: "literal",
+		value: structural.symbol
+	}, {
+		key: "source",
+		variant: "literal",
+		value: structural.source
+	}];
+	const constants = structural.constants ?? (live !== null && builtin ? {
+		fullCoinType: live.fullCoinType,
+		decimals: live.decimals
+	} : void 0);
+	if (builtin && constants !== void 0) {
+		fields.push({
+			key: "fullCoinType",
+			variant: "literal",
+			value: constants.fullCoinType
+		});
+		fields.push({
+			key: "decimals",
+			variant: "literal",
+			value: constants.decimals
+		});
+	} else {
+		if (structural.knownCoinType !== void 0) fields.push({
+			key: "fullCoinType",
+			variant: "literal",
+			value: structural.knownCoinType
+		});
+		else fields.push({
+			key: "fullCoinType",
+			variant: "resolved",
+			tsType: "string",
+			live: (s) => s.fullCoinType
+		});
+		fields.push({
+			key: "decimals",
+			variant: "resolved",
+			tsType: "number",
+			live: (s) => s.decimals
+		});
+		fields.push({
+			key: "packageId",
+			variant: "resolved",
+			tsType: "string | null",
+			live: (s) => s.packageId ?? null
+		});
+	}
+	if (live !== null) {
+		for (const field of [
+			"displayName",
+			"iconUrl",
+			"treasuryCapId",
+			"metadataId"
+		]) if (live[field] !== void 0) fields.push({
+			key: field,
+			variant: "resolved",
+			live: (s) => s[field] ?? null
+		});
 	}
-});
+	return keyedBucketSpec({
+		bucket: "coins.ts",
+		kind: "coin",
+		key,
+		fields
+	});
+};
+/** Construct the LIVE Codegenable contribution for one coin instance.
+*  Bakes the resolved record + feeds the generic id-config `values` channel.
+*  Mirrors `account/${name}` naming. */
+const makeCoinCodegen = (parts) => liveBucketCodegen(coinBucketSpec(parts.symbol, {
+	symbol: parts.resolved.symbol,
+	source: parts.resolved.source
+}, parts.resolved), parts.resolved);
+/** Construct the STATIC (stack-free) Codegenable contribution for one coin.
+*  Emits `resolveValue('coin:<symbol>', '<key>')` for runtime fields; the
+*  committed `coins.ts` carries no baked coin type / object id. */
+const makeCoinStaticCodegen = (config) => staticBucketCodegen(coinBucketSpec(config.symbol, config, null));
 //#endregion
-export { makeCoinCodegen };
+export { makeCoinCodegen, makeCoinStaticCodegen };
 
 //# sourceMappingURL=codegen.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"codegen.mjs","names":[],"sources":["../../../src/plugins/coin/codegen.ts"],"sourcesContent":["// Coin plugin — Codegenable contribution.\n//\n// Distilled-doc 13-coin.md §\"Files written\": the codegen orchestrator\n// projects the per-stack CoinRegistry into a generated `coins.ts`\n// table:\n//\n//   export const coins = {\n//     mUSDC: { type, decimals, sdkCoin, symbol, ... },\n//     mWETH: { type, decimals, sdkCoin, symbol, ... },\n//   } as const;\n//   export type CoinName = keyof typeof coins;\n//\n// This file declares the SEAM — the typed binding shape and the\n// per-coin contribution. The heavy lift (writing the bytes, merging\n// all coins into one file) happens in the codegen orchestrator\n// (plugin/codegen layer, NOT this plugin); it walks every member's\n// caps tuple, finds the Coin-emitted contributions, and emits ONE\n// `coins.ts` referencing every entry.\n//\n// Per-coin shape mirrors the v3 `CoinEntry` (manifest schema) sans\n// the `sdkCoin` runtime projection — that lives in the SDK adapter\n// at codegen time, not in the binding shape.\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\n\nimport { defineSimpleConstExport } from '../internal/codegen-helpers.ts';\n\n/** The typed shape per emitted coin record. */\nexport interface CoinBindings {\n\treadonly symbol: string;\n\treadonly fullCoinType: string;\n\treadonly decimals: number;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\treadonly treasuryCapId?: string;\n\treadonly metadataId?: string;\n\treadonly packageId?: string;\n\treadonly source: 'registry' | 'on-chain' | 'builtin';\n}\n\n/** Construct the Codegenable contribution for one coin instance.\n *\n *  Emitter name is literal `coin/${symbol}` so the orchestrator can\n *  group them and folds them into a single `coins.ts` at staging\n *  time. Mirrors `account/${name}` naming in the Account plugin. */\nexport const makeCoinCodegen = <Symbol extends string>(parts: {\n\treadonly symbol: Symbol;\n\treadonly resolved: CoinBindings;\n}): CodegenableDecl<`coin/${Symbol}`> =>\n\tdefineSimpleConstExport({\n\t\temitterName: `coin/${parts.symbol}` as `coin/${Symbol}`,\n\t\toutputPath: `coins/${parts.symbol}.ts`,\n\t\texportName: parts.symbol,\n\t\tvalue: parts.resolved,\n\t\taggregate: {\n\t\t\tkind: 'coin',\n\t\t\tbucket: 'coins.ts',\n\t\t\t// Pass-through: this decl's exported map already keys by\n\t\t\t// coin symbol, which is the aggregate's merge key.\n\t\t\tproject: (exported) => exported,\n\t\t},\n\t});\n"],"mappings":";;;;;;;AA6CA,MAAa,mBAA0C,UAItD,wBAAwB;CACvB,aAAa,QAAQ,MAAM;CAC3B,YAAY,SAAS,MAAM,OAAO;CAClC,YAAY,MAAM;CAClB,OAAO,MAAM;CACb,WAAW;EACV,MAAM;EACN,QAAQ;EAGR,UAAU,aAAa;EACvB;CACD,CAAC"}
+{"version":3,"file":"codegen.mjs","names":[],"sources":["../../../src/plugins/coin/codegen.ts"],"sourcesContent":["// Coin plugin — Codegenable contribution, via the UNIFIED config-binding\n// declaration.\n//\n// Distilled-doc 13-coin.md §\"Files written\": the codegen orchestrator\n// projects the per-stack CoinRegistry into a generated `coins.ts` table:\n//\n//   export const coins = {\n//     mUSDC: { type, decimals, sdkCoin, symbol, ... },\n//     mWETH: { type, decimals, sdkCoin, symbol, ... },\n//   } as const;\n//\n// ONE declaration, TWO derivations. A coin declares its `coins.ts`\n// contribution ONCE as a `ConfigBindingSet` (rooted under its symbol key).\n// The framework derives both behaviors (see `contracts/config-bindings.ts`):\n//   - LIVE (boot): bakes the resolved on-chain values (fullCoinType,\n//     decimals, ids) AND feeds the generic id-config `values` channel.\n//   - STATIC (committed tree): emits `resolveValue('coin:<symbol>', '<key>')`\n//     so the committed `coins.ts` carries NO baked coin type / object id.\n//\n// STRUCTURAL fields (symbol, source) stay literals; the coin type, decimals,\n// icon URL, and on-chain object ids are RUNTIME (loaded config data),\n// resolved at app build/dev time via the injected `__DEVSTACK_IDS__` global.\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport {\n\tkeyedBucketSpec,\n\tliveBucketCodegen,\n\tstaticBucketCodegen,\n\ttype BucketField,\n\ttype SiblingBucketSpec,\n} from '../../contracts/config-bindings.ts';\nimport type { JsonValue } from '../../orchestrators/codegen/id-config.ts';\n\n/** The typed shape per emitted coin record. */\nexport interface CoinBindings {\n\treadonly symbol: string;\n\treadonly fullCoinType: string;\n\treadonly decimals: number;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\treadonly treasuryCapId?: string;\n\treadonly metadataId?: string;\n\treadonly packageId?: string;\n\treadonly source: 'registry' | 'on-chain' | 'builtin';\n}\n\n/** Static-config shape a coin can describe BEFORE acquire — the fields the\n *  stack-free `staticCodegen` hook needs to emit a deterministic committed\n *  stub for this symbol. `source` is the address-form provenance (known at\n *  factory time). `constants` is set ONLY for a `'builtin'` coin (SUI),\n *  whose coin type + decimals are protocol-defined constants the stub bakes\n *  as literals (no `resolveValue` that would throw at module load). */\nexport interface CoinStaticConfig {\n\treadonly symbol: string;\n\treadonly source: CoinBindings['source'];\n\treadonly constants?: { readonly fullCoinType: string; readonly decimals: number };\n\t/** A user-declared on-chain coin type (the `coin.known('0x…::m::W')`\n\t *  argument). This is DECLARED config (not loaded-at-runtime data), so the\n\t *  committed `coins.ts` bakes it as a LITERAL `fullCoinType`. `decimals` and\n\t *  `packageId` still resolve at runtime (they come from `getCoinMetadata`,\n\t *  genuinely only known after a live probe), so they stay `resolveValue`.\n\t *  Absent for `fromPackage` (registry/local) coins whose type is dynamic. */\n\treadonly knownCoinType?: string;\n}\n\n/** The state the LIVE binding derivation reads — the resolved coin record. */\ntype CoinLiveState = CoinBindings;\n\n/** Build the coin's config-binding spec for symbol `key`. `symbol` and\n *  `source` are structural literals; the coin type, decimals, and on-chain\n *  object ids are runtime-resolved (`resolveValue`).\n *\n *  Field-set DETERMINISM. A committed `resolveValue(...)` call evaluates at\n *  module-load and THROWS when the id is absent, so the static stub must\n *  emit ONLY fields the injected ids will carry. `source` (known at factory\n *  time) decides this: a `'builtin'` coin (SUI) is fully protocol-defined —\n *  it carries NO package id and its coin type / decimals are constants, so\n *  it emits them as LITERALS (no `resolveValue` that would throw at load).\n *  A `'registry'` / `'on-chain'` coin carries a real `packageId`, so it\n *  emits `fullCoinType` / `decimals` / `packageId` as resolved. The OPTIONAL\n *  discovery-only ids (`treasuryCapId` / `metadataId` / `iconUrl` /\n *  `displayName`) are non-deterministic — the static stub omits them; the\n *  LIVE record emits whatever it actually surfaced (consumers read them\n *  through optional chaining). */\nconst coinBucketSpec = (\n\tkey: string,\n\tstructural: CoinStaticConfig,\n\tlive: CoinLiveState | null,\n): SiblingBucketSpec<CoinLiveState> => {\n\tconst builtin = structural.source === 'builtin';\n\tconst fields: Array<BucketField<CoinLiveState>> = [\n\t\t{ key: 'symbol', variant: 'literal', value: structural.symbol },\n\t\t{ key: 'source', variant: 'literal', value: structural.source },\n\t];\n\tconst constants =\n\t\tstructural.constants ??\n\t\t(live !== null && builtin\n\t\t\t? { fullCoinType: live.fullCoinType, decimals: live.decimals }\n\t\t\t: undefined);\n\tif (builtin && constants !== undefined) {\n\t\t// A builtin coin (SUI) is protocol-defined: bake its constants as\n\t\t// literals in BOTH paths (no `resolveValue` to throw at module load).\n\t\t// The coin type carries `::` so it is not a baked on-chain id.\n\t\tfields.push({ key: 'fullCoinType', variant: 'literal', value: constants.fullCoinType });\n\t\tfields.push({ key: 'decimals', variant: 'literal', value: constants.decimals });\n\t} else {\n\t\t// A package / on-chain coin: decimals + package id are LOADED CONFIG\n\t\t// DATA (from `getCoinMetadata`) — resolve at app build/dev time. The\n\t\t// `fullCoinType` is DECLARED config when the caller passed an explicit\n\t\t// `coin.known('0x…::m::W')` type (`knownCoinType`) — bake it as a\n\t\t// LITERAL; otherwise (`fromPackage`) it is dynamic, so resolve it.\n\t\tif (structural.knownCoinType !== undefined) {\n\t\t\tfields.push({ key: 'fullCoinType', variant: 'literal', value: structural.knownCoinType });\n\t\t} else {\n\t\t\tfields.push({\n\t\t\t\tkey: 'fullCoinType',\n\t\t\t\tvariant: 'resolved',\n\t\t\t\ttsType: 'string',\n\t\t\t\tlive: (s) => s.fullCoinType,\n\t\t\t});\n\t\t}\n\t\tfields.push({\n\t\t\tkey: 'decimals',\n\t\t\tvariant: 'resolved',\n\t\t\ttsType: 'number',\n\t\t\tlive: (s) => s.decimals,\n\t\t});\n\t\tfields.push({\n\t\t\tkey: 'packageId',\n\t\t\tvariant: 'resolved',\n\t\t\ttsType: 'string | null',\n\t\t\tlive: (s) => (s.packageId ?? null) as JsonValue,\n\t\t});\n\t}\n\t// Discovery-only optional ids — emitted ONLY on the LIVE path, and only\n\t// when the resolved record carries them (non-deterministic, so the\n\t// committed static stub omits them; consumers read via optional chaining).\n\tif (live !== null) {\n\t\tconst optional: ReadonlyArray<keyof CoinBindings> = [\n\t\t\t'displayName',\n\t\t\t'iconUrl',\n\t\t\t'treasuryCapId',\n\t\t\t'metadataId',\n\t\t];\n\t\tfor (const field of optional) {\n\t\t\tif (live[field] !== undefined) {\n\t\t\t\tfields.push({\n\t\t\t\t\tkey: field,\n\t\t\t\t\tvariant: 'resolved',\n\t\t\t\t\tlive: (s) => (s[field] ?? null) as JsonValue,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\treturn keyedBucketSpec({ bucket: 'coins.ts', kind: 'coin', key, fields });\n};\n\n/** Construct the LIVE Codegenable contribution for one coin instance.\n *  Bakes the resolved record + feeds the generic id-config `values` channel.\n *  Mirrors `account/${name}` naming. */\nexport const makeCoinCodegen = <Symbol extends string>(parts: {\n\treadonly symbol: Symbol;\n\treadonly resolved: CoinBindings;\n}): CodegenableDecl =>\n\tliveBucketCodegen(\n\t\tcoinBucketSpec(\n\t\t\tparts.symbol,\n\t\t\t{ symbol: parts.resolved.symbol, source: parts.resolved.source },\n\t\t\tparts.resolved,\n\t\t),\n\t\tparts.resolved,\n\t);\n\n/** Construct the STATIC (stack-free) Codegenable contribution for one coin.\n *  Emits `resolveValue('coin:<symbol>', '<key>')` for runtime fields; the\n *  committed `coins.ts` carries no baked coin type / object id. */\nexport const makeCoinStaticCodegen = (config: CoinStaticConfig): CodegenableDecl =>\n\tstaticBucketCodegen(coinBucketSpec(config.symbol, config, null));\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoFA,MAAM,kBACL,KACA,YACA,SACsC;CACtC,MAAM,UAAU,WAAW,WAAW;CACtC,MAAM,SAA4C,CACjD;EAAE,KAAK;EAAU,SAAS;EAAW,OAAO,WAAW;CAAO,GAC9D;EAAE,KAAK;EAAU,SAAS;EAAW,OAAO,WAAW;CAAO,CAC/D;CACA,MAAM,YACL,WAAW,cACV,SAAS,QAAQ,UACf;EAAE,cAAc,KAAK;EAAc,UAAU,KAAK;CAAS,IAC3D,KAAA;CACJ,IAAI,WAAW,cAAc,KAAA,GAAW;EAIvC,OAAO,KAAK;GAAE,KAAK;GAAgB,SAAS;GAAW,OAAO,UAAU;EAAa,CAAC;EACtF,OAAO,KAAK;GAAE,KAAK;GAAY,SAAS;GAAW,OAAO,UAAU;EAAS,CAAC;CAC/E,OAAO;EAMN,IAAI,WAAW,kBAAkB,KAAA,GAChC,OAAO,KAAK;GAAE,KAAK;GAAgB,SAAS;GAAW,OAAO,WAAW;EAAc,CAAC;OAExF,OAAO,KAAK;GACX,KAAK;GACL,SAAS;GACT,QAAQ;GACR,OAAO,MAAM,EAAE;EAChB,CAAC;EAEF,OAAO,KAAK;GACX,KAAK;GACL,SAAS;GACT,QAAQ;GACR,OAAO,MAAM,EAAE;EAChB,CAAC;EACD,OAAO,KAAK;GACX,KAAK;GACL,SAAS;GACT,QAAQ;GACR,OAAO,MAAO,EAAE,aAAa;EAC9B,CAAC;CACF;CAIA,IAAI,SAAS;OAOP,MAAM,SAAS;GALnB;GACA;GACA;GACA;EAE0B,GAC1B,IAAI,KAAK,WAAW,KAAA,GACnB,OAAO,KAAK;GACX,KAAK;GACL,SAAS;GACT,OAAO,MAAO,EAAE,UAAU;EAC3B,CAAC;CAAA;CAIJ,OAAO,gBAAgB;EAAE,QAAQ;EAAY,MAAM;EAAQ;EAAK;CAAO,CAAC;AACzE;;;;AAKA,MAAa,mBAA0C,UAItD,kBACC,eACC,MAAM,QACN;CAAE,QAAQ,MAAM,SAAS;CAAQ,QAAQ,MAAM,SAAS;AAAO,GAC/D,MAAM,QACP,GACA,MAAM,QACP;;;;AAKD,MAAa,yBAAyB,WACrC,oBAAoB,eAAe,OAAO,QAAQ,QAAQ,IAAI,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"discovery.mjs","names":[],"sources":["../../../src/plugins/coin/discovery.ts"],"sourcesContent":["// Coin auto-discovery — pure projection over a `LocalPackagePublishOutput`.\n//\n// Distilled-doc 13-coin.md §\"Capabilities PRODUCED\" §\"Registry\n// entries\" + Invariant 6 + Invariant 7:\n//\n//   - Iterate `output.objectChanges`,\n//   - Find paired Sui-framework `coin::TreasuryCap<T>` +\n//     `coin::CoinMetadata<T>`,\n//   - Reject nested generics (`TreasuryCap<A<B>>` returns no record),\n//   - Sort ascending by fullCoinType for deterministic order.\n//\n// This file is PURE — no Effect, no RPC. Metadata enrichment (the\n// `getCoinMetadata` RPC fold) lives in `metadata.ts`; we just emit\n// the raw discovered shape here. The input is structural so Coin does\n// not import Package internals.\n\nimport {\n\tpickSuiFrameworkInnerGeneric,\n\tpickSuiFrameworkInnerGenericFromModule,\n} from './type-strings.ts';\n\nexport interface CoinDiscoveryObjectChange {\n\treadonly type: 'created' | 'published' | 'mutated' | 'wrapped' | 'transferred';\n\treadonly objectId?: string;\n\treadonly objectType?: string;\n\treadonly owner?: unknown;\n\treadonly json?: unknown;\n}\n\nexport interface CoinDiscoveryPublishOutput {\n\treadonly publisher: string;\n\treadonly objectChanges: ReadonlyArray<CoinDiscoveryObjectChange>;\n}\n\n/** A discovered coin pulled out of a publish output. The downstream\n *  metadata enricher in `metadata.ts` turns this into a full\n *  `CoinRecord`. */\nexport interface DiscoveredCoin {\n\t/** `0xPKG::module::Witness`. */\n\treadonly fullCoinType: string;\n\t/** Lower-cased witness name. */\n\treadonly witness: string;\n\t/** Lower-cased module name. */\n\treadonly moduleName: string;\n\treadonly treasuryCapId?: string;\n\treadonly treasuryCapOwner?: string;\n\treadonly metadataId?: string;\n\treadonly decimals?: number;\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\t/** True when the cap is address-owned by the publisher at the\n\t *  end of the publish tx. Distilled-doc invariant: the faucet's\n\t *  treasury-cap-mint auto-registration is gated off this flag. */\n\treadonly publisherOwnsCap: boolean;\n}\n\ninterface DiscoveredMetadata {\n\treadonly id: string;\n\treadonly decimals?: number;\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n}\n\n/** Extract module + witness from `0xPKG::module::Witness`. */\nconst splitCoinType = (\n\tfullCoinType: string,\n): { readonly moduleName: string; readonly witness: string } | null => {\n\tconst parts = fullCoinType.split('::');\n\tif (parts.length !== 3) return null;\n\tconst [, moduleName, witness] = parts;\n\tif (moduleName === undefined || witness === undefined) return null;\n\treturn { moduleName, witness };\n};\n\n/** Read the address owner from a package-publish-output change. Handles\n *  the SDK's discriminated owner-shape; non-address owners surface as\n *  `undefined`. The owner shape varies across SDK versions; this\n *  helper covers the common surface and degrades gracefully. */\nconst pickAddressOwner = (change: CoinDiscoveryObjectChange): string | undefined => {\n\tconst owner = change.owner as\n\t\t| { readonly AddressOwner?: string; readonly $kind?: string }\n\t\t| string\n\t\t| undefined;\n\tif (owner === undefined || owner === null) return undefined;\n\tif (typeof owner === 'string') return owner; // some SDK projections flatten\n\tif (typeof owner === 'object' && 'AddressOwner' in owner) {\n\t\treturn owner.AddressOwner;\n\t}\n\treturn undefined;\n};\n\nconst pickString = (json: Record<string, unknown>, key: string): string | undefined => {\n\tconst value = json[key];\n\treturn typeof value === 'string' && value.length > 0 ? value : undefined;\n};\n\nconst pickNumber = (json: Record<string, unknown>, key: string): number | undefined => {\n\tconst value = json[key];\n\treturn typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n};\n\n/** Project the `json` payload of a `created` object change into the\n *  metadata fields the discovery aggregate consumes. Always returns a\n *  `Partial<...>` (never `null`) — an empty object is the natural \"no\n *  fields recognised\" outcome and lets callers spread unconditionally\n *  without an `??` fallback. */\nconst pickMetadata = (\n\tchange: CoinDiscoveryObjectChange,\n): Partial<Omit<DiscoveredMetadata, 'id'>> => {\n\tconst json = change.json;\n\tif (json === null || typeof json !== 'object' || Array.isArray(json)) return {};\n\tconst record = json as Record<string, unknown>;\n\tconst decimals = pickNumber(record, 'decimals');\n\tconst symbol = pickString(record, 'symbol');\n\tconst displayName = pickString(record, 'name');\n\tconst iconUrl = pickString(record, 'iconUrl') ?? pickString(record, 'icon_url');\n\treturn {\n\t\t...(decimals === undefined ? {} : { decimals }),\n\t\t...(symbol === undefined ? {} : { symbol }),\n\t\t...(displayName === undefined ? {} : { displayName }),\n\t\t...(iconUrl === undefined ? {} : { iconUrl }),\n\t};\n};\n\n/** Walk a publish output for coin pairs.\n *\n *  Sort ascending by fullCoinType — distilled-doc invariant 6 — so\n *  the registry sees a stable order across re-runs of the same\n *  publish.\n *\n *  Pure. No Effect / RPC. */\nexport const discoverCoinsFromPublish = (\n\toutput: CoinDiscoveryPublishOutput,\n): ReadonlyArray<DiscoveredCoin> => {\n\tconst publisher = output.publisher;\n\t// Two passes over the changes: collect caps, collect metadata,\n\t// then JOIN on fullCoinType. The straightforward \"iterate once and\n\t// build per-coin records\" is harder to read when the two object\n\t// types interleave in the output.\n\tconst caps = new Map<string, { readonly id: string; readonly owner: string | undefined }>();\n\tconst metadata = new Map<string, DiscoveredMetadata>();\n\n\tfor (const change of output.objectChanges) {\n\t\tif (change.type !== 'created') continue;\n\t\tif (!change.objectType) continue;\n\t\tconst capInner = pickSuiFrameworkInnerGeneric(change.objectType, 'TreasuryCap');\n\t\tif (capInner !== null && change.objectId !== undefined) {\n\t\t\tcaps.set(capInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\towner: pickAddressOwner(change),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst metaInner = pickSuiFrameworkInnerGeneric(change.objectType, 'CoinMetadata');\n\t\tif (metaInner !== null && change.objectId !== undefined) {\n\t\t\tmetadata.set(metaInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\t...pickMetadata(change),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst currencyInner = pickSuiFrameworkInnerGenericFromModule(\n\t\t\tchange.objectType,\n\t\t\t'coin_registry',\n\t\t\t'Currency',\n\t\t);\n\t\tif (currencyInner !== null && change.objectId !== undefined) {\n\t\t\tmetadata.set(currencyInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\t...pickMetadata(change),\n\t\t\t});\n\t\t}\n\t}\n\n\t// Union the two sets of coin types — a coin with only a cap or\n\t// only metadata is still a coin (distilled-doc invariant: we\n\t// surface degraded records rather than drop them).\n\tconst allTypes = new Set<string>([...caps.keys(), ...metadata.keys()]);\n\tconst records: Array<DiscoveredCoin> = [];\n\tfor (const fullCoinType of allTypes) {\n\t\tconst parts = splitCoinType(fullCoinType);\n\t\tif (!parts) continue;\n\t\tconst cap = caps.get(fullCoinType);\n\t\tconst meta = metadata.get(fullCoinType);\n\t\tconst publisherOwnsCap = cap !== undefined && cap.owner === publisher;\n\t\trecords.push({\n\t\t\tfullCoinType,\n\t\t\twitness: parts.witness.toLowerCase(),\n\t\t\tmoduleName: parts.moduleName.toLowerCase(),\n\t\t\ttreasuryCapId: cap?.id,\n\t\t\ttreasuryCapOwner: cap?.owner,\n\t\t\tmetadataId: meta?.id,\n\t\t\t...(meta?.decimals === undefined ? {} : { decimals: meta.decimals }),\n\t\t\t...(meta?.symbol === undefined ? {} : { symbol: meta.symbol }),\n\t\t\t...(meta?.displayName === undefined ? {} : { displayName: meta.displayName }),\n\t\t\t...(meta?.iconUrl === undefined ? {} : { iconUrl: meta.iconUrl }),\n\t\t\tpublisherOwnsCap,\n\t\t});\n\t}\n\t// Distilled-doc invariant 6: ascending sort by fullCoinType. Stable\n\t// across re-runs so the \"first wins on collision\" tie-break is\n\t// deterministic.\n\trecords.sort((a, b) =>\n\t\ta.fullCoinType < b.fullCoinType ? -1 : a.fullCoinType > b.fullCoinType ? 1 : 0,\n\t);\n\treturn records;\n};\n"],"mappings":"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"}
+{"version":3,"file":"discovery.mjs","names":[],"sources":["../../../src/plugins/coin/discovery.ts"],"sourcesContent":["// Coin auto-discovery — pure projection over a `LocalPackagePublishOutput`.\n//\n// Distilled-doc 13-coin.md §\"Capabilities PRODUCED\" §\"Registry\n// entries\" + Invariant 6 + Invariant 7:\n//\n//   - Iterate `output.objectChanges`,\n//   - Find paired Sui-framework `coin::TreasuryCap<T>` +\n//     `coin::CoinMetadata<T>`,\n//   - Reject nested generics (`TreasuryCap<A<B>>` returns no record),\n//   - Sort ascending by fullCoinType for deterministic order.\n//\n// This file is PURE — no Effect, no RPC. Metadata enrichment (the\n// `getCoinMetadata` RPC fold) lives in `metadata.ts`; we just emit\n// the raw discovered shape here. The input is structural so Coin does\n// not import Package internals.\n\nimport {\n\tpickSuiFrameworkInnerGeneric,\n\tpickSuiFrameworkInnerGenericFromModule,\n} from './type-strings.ts';\n\nexport interface CoinDiscoveryObjectChange {\n\treadonly type: 'created' | 'published' | 'mutated' | 'wrapped' | 'transferred';\n\treadonly objectId?: string;\n\treadonly objectType?: string;\n\treadonly owner?: unknown;\n\treadonly json?: unknown;\n}\n\nexport interface CoinDiscoveryPublishOutput {\n\treadonly publisher: string;\n\treadonly objectChanges: ReadonlyArray<CoinDiscoveryObjectChange>;\n}\n\n/** A discovered coin pulled out of a publish output. The downstream\n *  metadata enricher in `metadata.ts` turns this into a full\n *  `CoinRecord`. */\nexport interface DiscoveredCoin {\n\t/** `0xPKG::module::Witness`. */\n\treadonly fullCoinType: string;\n\t/** Lower-cased witness name. */\n\treadonly witness: string;\n\t/** Lower-cased module name. */\n\treadonly moduleName: string;\n\treadonly treasuryCapId?: string;\n\treadonly treasuryCapOwner?: string;\n\treadonly metadataId?: string;\n\treadonly decimals?: number;\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\t/** True when the cap is address-owned by the publisher at the\n\t *  end of the publish tx. Distilled-doc invariant: the faucet's\n\t *  treasury-cap-mint auto-registration is gated off this flag. */\n\treadonly publisherOwnsCap: boolean;\n}\n\ninterface DiscoveredMetadata {\n\treadonly id: string;\n\treadonly decimals?: number;\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n}\n\n/** Extract module + witness from `0xPKG::module::Witness`. */\nconst splitCoinType = (\n\tfullCoinType: string,\n): { readonly moduleName: string; readonly witness: string } | null => {\n\tconst parts = fullCoinType.split('::');\n\tif (parts.length !== 3) return null;\n\tconst [, moduleName, witness] = parts;\n\tif (moduleName === undefined || witness === undefined) return null;\n\treturn { moduleName, witness };\n};\n\n/** Read the address owner from a package-publish-output change. Handles\n *  the SDK's discriminated owner-shape; non-address owners surface as\n *  `undefined`. The owner shape varies across SDK versions; this\n *  helper covers the common surface and degrades gracefully. */\nconst pickAddressOwner = (change: CoinDiscoveryObjectChange): string | undefined => {\n\tconst owner = change.owner as\n\t\t| { readonly AddressOwner?: string; readonly $kind?: string }\n\t\t| string\n\t\t| undefined;\n\tif (owner === undefined || owner === null) return undefined;\n\tif (typeof owner === 'string') return owner; // some SDK projections flatten\n\tif (typeof owner === 'object' && 'AddressOwner' in owner) {\n\t\treturn owner.AddressOwner;\n\t}\n\treturn undefined;\n};\n\nconst pickString = (json: Record<string, unknown>, key: string): string | undefined => {\n\tconst value = json[key];\n\treturn typeof value === 'string' && value.length > 0 ? value : undefined;\n};\n\nconst pickNumber = (json: Record<string, unknown>, key: string): number | undefined => {\n\tconst value = json[key];\n\treturn typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n};\n\n/** Project the `json` payload of a `created` object change into the\n *  metadata fields the discovery aggregate consumes. Always returns a\n *  `Partial<...>` (never `null`) — an empty object is the natural \"no\n *  fields recognised\" outcome and lets callers spread unconditionally\n *  without an `??` fallback. */\nconst pickMetadata = (\n\tchange: CoinDiscoveryObjectChange,\n): Partial<Omit<DiscoveredMetadata, 'id'>> => {\n\tconst json = change.json;\n\tif (json === null || typeof json !== 'object' || Array.isArray(json)) return {};\n\tconst record = json as Record<string, unknown>;\n\tconst decimals = pickNumber(record, 'decimals');\n\tconst symbol = pickString(record, 'symbol');\n\tconst displayName = pickString(record, 'name');\n\tconst iconUrl = pickString(record, 'iconUrl') ?? pickString(record, 'icon_url');\n\treturn {\n\t\t...(decimals === undefined ? {} : { decimals }),\n\t\t...(symbol === undefined ? {} : { symbol }),\n\t\t...(displayName === undefined ? {} : { displayName }),\n\t\t...(iconUrl === undefined ? {} : { iconUrl }),\n\t};\n};\n\n/** Walk a publish output for coin pairs.\n *\n *  Sort ascending by fullCoinType — distilled-doc invariant 6 — so\n *  the registry sees a stable order across re-runs of the same\n *  publish.\n *\n *  Pure. No Effect / RPC. */\nexport const discoverCoinsFromPublish = (\n\toutput: CoinDiscoveryPublishOutput,\n): ReadonlyArray<DiscoveredCoin> => {\n\tconst publisher = output.publisher;\n\t// Two passes over the changes: collect caps, collect metadata,\n\t// then JOIN on fullCoinType. The straightforward \"iterate once and\n\t// build per-coin records\" is harder to read when the two object\n\t// types interleave in the output.\n\tconst caps = new Map<string, { readonly id: string; readonly owner: string | undefined }>();\n\tconst metadata = new Map<string, DiscoveredMetadata>();\n\n\tfor (const change of output.objectChanges) {\n\t\tif (change.type !== 'created') continue;\n\t\tif (!change.objectType) continue;\n\t\tconst capInner = pickSuiFrameworkInnerGeneric(change.objectType, 'TreasuryCap');\n\t\tif (capInner !== null && change.objectId !== undefined) {\n\t\t\tcaps.set(capInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\towner: pickAddressOwner(change),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst metaInner = pickSuiFrameworkInnerGeneric(change.objectType, 'CoinMetadata');\n\t\tif (metaInner !== null && change.objectId !== undefined) {\n\t\t\tmetadata.set(metaInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\t...pickMetadata(change),\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst currencyInner = pickSuiFrameworkInnerGenericFromModule(\n\t\t\tchange.objectType,\n\t\t\t'coin_registry',\n\t\t\t'Currency',\n\t\t);\n\t\tif (currencyInner !== null && change.objectId !== undefined) {\n\t\t\tmetadata.set(currencyInner, {\n\t\t\t\tid: change.objectId,\n\t\t\t\t...pickMetadata(change),\n\t\t\t});\n\t\t}\n\t}\n\n\t// Union the two sets of coin types — a coin with only a cap or\n\t// only metadata is still a coin (distilled-doc invariant: we\n\t// surface degraded records rather than drop them).\n\tconst allTypes = new Set<string>([...caps.keys(), ...metadata.keys()]);\n\tconst records: Array<DiscoveredCoin> = [];\n\tfor (const fullCoinType of allTypes) {\n\t\tconst parts = splitCoinType(fullCoinType);\n\t\tif (!parts) continue;\n\t\tconst cap = caps.get(fullCoinType);\n\t\tconst meta = metadata.get(fullCoinType);\n\t\tconst publisherOwnsCap = cap !== undefined && cap.owner === publisher;\n\t\trecords.push({\n\t\t\tfullCoinType,\n\t\t\twitness: parts.witness.toLowerCase(),\n\t\t\tmoduleName: parts.moduleName.toLowerCase(),\n\t\t\ttreasuryCapId: cap?.id,\n\t\t\ttreasuryCapOwner: cap?.owner,\n\t\t\tmetadataId: meta?.id,\n\t\t\t...(meta?.decimals === undefined ? {} : { decimals: meta.decimals }),\n\t\t\t...(meta?.symbol === undefined ? {} : { symbol: meta.symbol }),\n\t\t\t...(meta?.displayName === undefined ? {} : { displayName: meta.displayName }),\n\t\t\t...(meta?.iconUrl === undefined ? {} : { iconUrl: meta.iconUrl }),\n\t\t\tpublisherOwnsCap,\n\t\t});\n\t}\n\t// Distilled-doc invariant 6: ascending sort by fullCoinType. Stable\n\t// across re-runs so the \"first wins on collision\" tie-break is\n\t// deterministic.\n\trecords.sort((a, b) =>\n\t\ta.fullCoinType < b.fullCoinType ? -1 : a.fullCoinType > b.fullCoinType ? 1 : 0,\n\t);\n\treturn records;\n};\n"],"mappings":"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"}

package/dist/plugins/coin/errors.mjs

@@ -4,10 +4,7 @@ const coinError = (phase, parts) => ({
 	phase,
 	...parts
 });
-/** Error tags this plugin contributes — surfaced to the cause walker
-*  via `PluginErrorContribution`. */
-const COIN_ERROR_TAGS = ["CoinError"];
 //#endregion
-export { COIN_ERROR_TAGS, coinError };
+export { coinError };
 
 //# sourceMappingURL=errors.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/plugins/coin/errors.ts"],"sourcesContent":["// Coin plugin — typed errors.\n//\n// Distilled-doc finding (13-coin.md Pain point #8 \"No CoinError tag at\n// all\"): the v3 coin module reused `PublishError` for mint failures\n// and surfaced `CoinNotFoundError` / `CoinAmbiguousError` only on the\n// factory path. The redesign unifies coin-side failures into a SINGLE\n// tagged error with a CLOSED phase set so downstream `catchTag`\n// callers can distinguish \"not in registry\" from \"mint failed\" from\n// \"cap missing\".\n//\n// Effect v4: plain interface + `_tag` literal discriminator (no\n// subclassing). Mirrors the Account plugin's split shape and the\n// substrate's per-plugin tagged-error convention.\n\n/** Phases for `CoinError`. Closed sum — adding a phase requires\n *  editing this list AND the cause walker's display table.\n *\n *  Phase semantics:\n *   - `not-found`           — symbol/witness/bare-type didn't resolve\n *                             against the registry / on-chain metadata.\n *   - `ambiguous`           — two distinct coin types matched a single\n *                             registry-key lookup. Caller should\n *                             disambiguate via the witness form.\n *   - `nested-generic`      — bare-coin-type rejected because it\n *                             carried a nested generic (`<T<U>>`).\n *                             Distilled-doc invariant 7: refuse to\n *                             guess. Surfaces during the discovery\n *                             walker AND during the address-resolution\n *                             bare-string branch.\n *   - `cap-missing`         — the package didn't capture a\n *                             `TreasuryCap` under the requested field\n *                             (either no cap at all, or the captured\n *                             record key is wrong).\n *   - `metadata-fetch`      — `getCoinMetadata` failed after retries.\n *                             Soft-degradation path: the discovery\n *                             walker swallows this to keep partial\n *                             coverage; the bare-coin-type branch of\n *                             the user-facing factory surfaces it.\n *   - `mint-tx`             — sign-and-execute of the mint tx failed.\n *   - `mint-parse`          — the minted `Coin<T>` was not present in\n *                             the resulting `objectChanges`. */\nexport type CoinPhase =\n\t| 'not-found'\n\t| 'ambiguous'\n\t| 'nested-generic'\n\t| 'cap-missing'\n\t| 'metadata-fetch'\n\t| 'mint-tx'\n\t| 'mint-parse';\n\n/** Single tagged coin error. */\nexport interface CoinError {\n\treadonly _tag: 'CoinError';\n\treadonly phase: CoinPhase;\n\t/** User-facing identifier — the symbol / witness / bare-type the\n\t *  caller passed. Populated even when the cause was a mint\n\t *  (in which case it carries the resolved fullCoinType so the\n\t *  pretty-cause walker can render context). */\n\treadonly identifier: string;\n\treadonly message: string;\n\t/** Optional list of registered candidates — populated by\n\t *  `not-found` / `ambiguous` so the renderer can show what WAS\n\t *  available. */\n\treadonly candidates?: ReadonlyArray<string>;\n\treadonly cause?: unknown;\n}\n\nexport const coinError = (\n\tphase: CoinPhase,\n\tparts: Omit<CoinError, '_tag' | 'phase'>,\n): CoinError => ({ _tag: 'CoinError', phase, ...parts });\n\n/** Error tags this plugin contributes — surfaced to the cause walker\n *  via `PluginErrorContribution`. */\nexport const COIN_ERROR_TAGS = ['CoinError'] as const;\n"],"mappings":";AAmEA,MAAa,aACZ,OACA,WACgB;CAAE,MAAM;CAAa;CAAO,GAAG;CAAO;;;AAIvD,MAAa,kBAAkB,CAAC,YAAY"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/plugins/coin/errors.ts"],"sourcesContent":["// Coin plugin — typed errors.\n//\n// Coin-side failures unify into a SINGLE tagged error with a CLOSED\n// phase set so downstream `catchTag` callers can distinguish \"not in\n// registry\" from \"mint failed\" from \"cap missing\".\n//\n// Effect v4: plain interface + `_tag` literal discriminator (no\n// subclassing). Mirrors the Account plugin's split shape and the\n// substrate's per-plugin tagged-error convention.\n\n/** Phases for `CoinError`. Closed sum — adding a phase requires\n *  editing this list AND the cause walker's display table.\n *\n *  Phase semantics:\n *   - `not-found`           — symbol/witness/bare-type didn't resolve\n *                             against the registry / on-chain metadata.\n *   - `ambiguous`           — two distinct coin types matched a single\n *                             registry-key lookup. Caller should\n *                             disambiguate via the witness form.\n *   - `nested-generic`      — bare-coin-type rejected because it\n *                             carried a nested generic (`<T<U>>`).\n *                             Distilled-doc invariant 7: refuse to\n *                             guess. Surfaces during the discovery\n *                             walker AND during the address-resolution\n *                             bare-string branch.\n *   - `cap-missing`         — the package didn't capture a\n *                             `TreasuryCap` under the requested field\n *                             (either no cap at all, or the captured\n *                             record key is wrong).\n *   - `metadata-fetch`      — `getCoinMetadata` failed after retries.\n *                             Soft-degradation path: the discovery\n *                             walker swallows this to keep partial\n *                             coverage; the bare-coin-type branch of\n *                             the user-facing factory surfaces it.\n *   - `mint-tx`             — sign-and-execute of the mint tx failed.\n *   - `mint-parse`          — the minted `Coin<T>` was not present in\n *                             the resulting `objectChanges`. */\nexport type CoinPhase =\n\t| 'not-found'\n\t| 'ambiguous'\n\t| 'nested-generic'\n\t| 'cap-missing'\n\t| 'metadata-fetch'\n\t| 'mint-tx'\n\t| 'mint-parse';\n\n/** Single tagged coin error. */\nexport interface CoinError {\n\treadonly _tag: 'CoinError';\n\treadonly phase: CoinPhase;\n\t/** User-facing identifier — the symbol / witness / bare-type the\n\t *  caller passed. Populated even when the cause was a mint\n\t *  (in which case it carries the resolved fullCoinType so the\n\t *  pretty-cause walker can render context). */\n\treadonly identifier: string;\n\treadonly message: string;\n\t/** Optional list of registered candidates — populated by\n\t *  `not-found` / `ambiguous` so the renderer can show what WAS\n\t *  available. */\n\treadonly candidates?: ReadonlyArray<string>;\n\treadonly cause?: unknown;\n}\n\nexport const coinError = (\n\tphase: CoinPhase,\n\tparts: Omit<CoinError, '_tag' | 'phase'>,\n): CoinError => ({ _tag: 'CoinError', phase, ...parts });\n\n/** The catchable error tags this plugin exposes. Pinned against the\n *  user-facing error catalog by the error-catalog-parity test. */\nexport const COIN_ERROR_TAGS = ['CoinError'] as const;\n"],"mappings":";AA+DA,MAAa,aACZ,OACA,WACgB;CAAE,MAAM;CAAa;CAAO,GAAG;AAAM"}

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

@@ -1,10 +1,6 @@
-import { CodegenableDecl } from "../../contracts/codegenable.mjs";
-import { SnapshotableDecl } from "../../contracts/snapshotable.mjs";
 import { AnyResourceRef, Plugin, ResourceRef } from "../../substrate/plugin.mjs";
-import { SuiClient } from "../sui/mode/shared.mjs";
 import { SuiOptions } from "../sui/mode/spec.mjs";
-import { AccountFundingRequest } from "../../contracts/funding-strategy.mjs";
-import { ArtifactPublishError } from "../../primitives/artifact-publisher.mjs";
+import { SuiClient } from "../sui/mode/shared.mjs";
 import { CoinError, CoinPhase } from "./errors.mjs";
 import { MintResult, MintSigner } from "./mint.mjs";
 import { isBareCoinType, validateBareCoinType } from "./metadata.mjs";
@@ -12,8 +8,6 @@ import { BUILTIN_COINS, BuiltinCoinName, ResolvedCoin } from "./address-resoluti
 import { CoinAddressForm, CoinValue } from "./service.mjs";
 import { CoinBindings } from "./codegen.mjs";
 import { DiscoveredCoin } from "./discovery.mjs";
-import { Effect } from "effect";
-
 //#region src/plugins/coin/index.d.ts
 type PackageNameOf<Pkg extends PackageMember> = Pkg extends ResourceRef<`package:${infer Name}`, PackageMemberValue> ? Name : string;
 /** A user-supplied package ref. The user passes the result of
@@ -40,37 +34,13 @@ declare const coin: {
     readonly sui: ResourceRef<"sui", SuiClient & {
       readonly mode: SuiOptions["mode"];
     }>;
-  } ? T extends Readonly<Record<string, AnyResourceRef>> ? readonly T[keyof T][] : readonly [] : never : never, readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, ...{
-    kind: "strategy-contributor";
-    capabilityKey: `coinType:${string}`;
-    strategy: {
-      usesAccountSigner: true;
-      request: (req: AccountFundingRequest<unknown>) => Effect.Effect<void, ArtifactPublishError | CoinError, never>;
-    };
-    autoMounted: true;
-  }[]]>;
+  } ? T extends Readonly<Record<string, AnyResourceRef>> ? readonly T[keyof T][] : readonly [] : never : never>;
   readonly known: <FullType extends string>(fullCoinType: FullType) => Plugin<`coin:${string}`, CoinValue, readonly ResourceRef<"sui", SuiClient & {
     readonly mode: SuiOptions["mode"];
-  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, ...{
-    kind: "strategy-contributor";
-    capabilityKey: `coinType:${string}`;
-    strategy: {
-      usesAccountSigner: true;
-      request: (req: AccountFundingRequest<unknown>) => Effect.Effect<void, ArtifactPublishError | CoinError, never>;
-    };
-    autoMounted: true;
-  }[]]>;
+  }>[]>;
   readonly builtin: <Name extends keyof typeof BUILTIN_COINS>(name: Name) => Plugin<`coin:${Name}`, CoinValue, readonly ResourceRef<"sui", SuiClient & {
     readonly mode: SuiOptions["mode"];
-  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, ...{
-    kind: "strategy-contributor";
-    capabilityKey: `coinType:${string}`;
-    strategy: {
-      usesAccountSigner: true;
-      request: (req: AccountFundingRequest<unknown>) => Effect.Effect<void, ArtifactPublishError | CoinError, never>;
-    };
-    autoMounted: true;
-  }[]]>;
+  }>[]>;
 };
 //#endregion
 export { PackageMember, coin };

package/dist/plugins/coin/index.mjs

@@ -1,22 +1,21 @@
 import { definePlugin, resource } from "../../substrate/plugin.mjs";
 import "../../api/define-plugin.mjs";
-import { ArtifactPublisherService } from "../../substrate/runtime/artifact-publisher/index.mjs";
-import "./discovery.mjs";
+import { CacheService } from "../../substrate/runtime/cache/service.mjs";
+import "../../substrate/runtime/cache/index.mjs";
+import { PluginContext, emitContributions } from "../../substrate/plugin-ctx.mjs";
 import { CoinRegistryService } from "./registry.mjs";
-import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
 import { suiResource } from "../sui/index.mjs";
-import { makeCoinCodegen } from "./codegen.mjs";
+import { makeCoinCodegen, makeCoinStaticCodegen } from "./codegen.mjs";
 import { makeCoinSnapshotable } from "./snapshot.mjs";
-import { COIN_ERROR_TAGS } from "./errors.mjs";
-import "./spans.mjs";
+import "./errors.mjs";
 import "./metadata.mjs";
-import "./address-resolution.mjs";
+import { BUILTIN_COINS } from "./address-resolution.mjs";
 import "./mint.mjs";
 import { acquireCoin } from "./service.mjs";
+import "./discovery.mjs";
 import { Effect } from "effect";
 import { createHash } from "node:crypto";
 //#region src/plugins/coin/index.ts
-const coinErrorContributions = pluginErrorContributions(COIN_ERROR_TAGS);
 const coinFundingCapabilityKey = (fullCoinType) => `coinType:${fullCoinType}`;
 /** Resource id constructor. The symbolic name is part of the resource identity
 *  so the substrate's compose-time dedup catches collisions. */
@@ -52,7 +51,7 @@ const projectCoinSdk = (sui) => ({
 	client: sui.sdk.client,
 	forkMode: sui.fork !== null
 });
-const buildCapabilities = (symbol, resolved) => {
+const coinContributions = (symbol, resolved) => {
 	const bindings = {
 		symbol: resolved.symbol ?? symbol,
 		fullCoinType: resolved.fullCoinType,
@@ -110,10 +109,15 @@ const fromPackage = (pkg, witnessName) => {
 		},
 		role: "task",
 		section: "action",
+		staticCodegen: () => [makeCoinStaticCodegen({
+			symbol,
+			source: "registry"
+		})],
 		start: ({ pkg: resolved, sui }) => Effect.gen(function* () {
-			const artifactPublisher = yield* ArtifactPublisherService;
+			const ctx = yield* PluginContext;
+			const artifactPublisher = yield* CacheService;
 			const registry = yield* CoinRegistryService;
-			return yield* acquireCoin({
+			const value = yield* acquireCoin({
 				kind: "witness",
 				publishingPackageName: resolved.name,
 				witness: witnessName,
@@ -121,12 +125,12 @@ const fromPackage = (pkg, witnessName) => {
 			}, {
 				registry,
 				sdk: projectCoinSdk(sui),
-				chain: sui.chain,
+				chainId: sui.chainId,
 				publisher: artifactPublisher
 			});
-		}),
-		errorContributions: coinErrorContributions,
-		capabilities: ({ value }) => buildCapabilities(symbol, value)
+			emitContributions(ctx, coinContributions(symbol, value));
+			return value;
+		})
 	});
 };
 /** Resolve a coin by bare on-chain type via `getCoinMetadata`.
@@ -143,21 +147,27 @@ const known = (fullCoinType) => {
 		dependsOn: { sui: suiResource },
 		role: "task",
 		section: "action",
+		staticCodegen: () => [makeCoinStaticCodegen({
+			symbol: id,
+			source: "on-chain",
+			knownCoinType: fullCoinType
+		})],
 		start: ({ sui }) => Effect.gen(function* () {
-			const publisher = yield* ArtifactPublisherService;
+			const ctx = yield* PluginContext;
+			const publisher = yield* CacheService;
 			const registry = yield* CoinRegistryService;
-			return yield* acquireCoin({
+			const value = yield* acquireCoin({
 				kind: "known",
 				fullCoinType
 			}, {
 				registry,
 				sdk: projectCoinSdk(sui),
-				chain: sui.chain,
+				chainId: sui.chainId,
 				publisher
 			});
-		}),
-		errorContributions: coinErrorContributions,
-		capabilities: ({ value }) => buildCapabilities(id, value)
+			emitContributions(ctx, coinContributions(id, value));
+			return value;
+		})
 	});
 };
 /** Resolve a protocol-defined builtin coin. Currently `'sui'` only —
@@ -170,21 +180,30 @@ const builtin = (name) => {
 		dependsOn: { sui: suiResource },
 		role: "task",
 		section: "action",
+		staticCodegen: () => [makeCoinStaticCodegen({
+			symbol,
+			source: "builtin",
+			constants: {
+				fullCoinType: BUILTIN_COINS[name].fullCoinType,
+				decimals: BUILTIN_COINS[name].decimals
+			}
+		})],
 		start: ({ sui }) => Effect.gen(function* () {
-			const publisher = yield* ArtifactPublisherService;
+			const ctx = yield* PluginContext;
+			const publisher = yield* CacheService;
 			const registry = yield* CoinRegistryService;
-			return yield* acquireCoin({
+			const value = yield* acquireCoin({
 				kind: "builtin",
 				name
 			}, {
 				registry,
 				sdk: projectCoinSdk(sui),
-				chain: sui.chain,
+				chainId: sui.chainId,
 				publisher
 			});
-		}),
-		errorContributions: coinErrorContributions,
-		capabilities: ({ value }) => buildCapabilities(symbol, value)
+			emitContributions(ctx, coinContributions(symbol, value));
+			return value;
+		})
 	});
 };
 /** User-facing factory namespace. Three variants — see file header for
@@ -196,6 +215,6 @@ const coin = {
 	builtin
 };
 //#endregion
-export { coin, coinResourceId };
+export { builtin, coin, coinResourceId, fromPackage };
 
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/coin/index.ts"],"sourcesContent":["// Coin plugin — barrel + `coin(...)` factory family.\n//\n// Architecture (13-coin.md): Coin is the user-facing primitive family\n// for *addressing* custom Move coin types. It does NOT publish Move\n// modules itself — the Package plugin publishes; coin auto-discovery\n// (in `discovery.ts`) folds the publish output into the per-stack\n// `CoinRegistry`; this factory resolves user-supplied addresses\n// (witness / bare-type / builtin) against that registry plus the live RPC.\n//\n// User-facing factory shape — three variants mirroring the address\n// forms:\n//\n//   coin.fromPackage(pkg, 'MOCK_USDC')       // package member → registry\n//   coin.known('0x...::deep::DEEP')          // bare → live RPC\n//   coin.builtin('sui')                      // protocol-defined constant\n//\n// (A `coin(identifier)` convenience entry is intentionally NOT\n// exposed — distilled-doc 13-coin.md Pain point #6 documents how the\n// \"guess the form from the string\" path is a footgun. The three-form\n// surface forces the user to make the disambiguation explicit at the\n// call site.)\n//\n// Resource id: `'coin:<package>/<witness>'` for package-scoped coins and\n// `'coin:<identifier>'` for known/builtin coins — one tag per declared\n// coin instance, so the substrate's compose-time dedup detects collisions\n// cleanly. Mirrors the Package plugin's per-instance resource identity.\n\nimport { createHash } from 'node:crypto';\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type ResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport { ArtifactPublisherService } from '../../substrate/runtime/artifact-publisher/index.ts';\nimport { suiResource } from '../sui/index.ts';\nimport type { SuiClient } from '../sui/index.ts';\nimport type { AccountFundingStrategy } from '../../contracts/funding-strategy.ts';\n\nimport { makeCoinCodegen, type CoinBindings } from './codegen.ts';\nimport { makeCoinSnapshotable } from './snapshot.ts';\nimport { CoinRegistryService } from './registry.ts';\nimport { COIN_ERROR_TAGS } from './errors.ts';\nimport { acquireCoin, type CoinAddressForm, type CoinValue } from './service.ts';\nimport { BUILTIN_COINS } from './address-resolution.ts';\nimport type { MetadataSdkShim } from './metadata.ts';\nimport type { MintSdkShim } from './mint.ts';\n\nconst coinErrorContributions = pluginErrorContributions(COIN_ERROR_TAGS);\n\nexport const coinFundingCapabilityKey = <FullType extends string>(\n\tfullCoinType: FullType,\n): `coinType:${FullType}` => `coinType:${fullCoinType}` as const;\n\n// ---------------------------------------------------------------------------\n// Resource — one per declared coin instance, keyed by explicit address form.\n// ---------------------------------------------------------------------------\n\n/** Resource id constructor. The symbolic name is part of the resource identity\n *  so the substrate's compose-time dedup catches collisions. */\nexport const coinResourceId = <Sym extends string>(symbol: Sym): `coin:${Sym}` => `coin:${symbol}`;\n\nexport type CoinResourceId<Sym extends string> = `coin:${Sym}`;\n\n/** Maximum length of the readable prefix in a `coin.known(...)` resource\n *  id. Two long coin types sharing this prefix length would silently\n *  collide in the substrate's compose-time dedup (string equality on\n *  the resource id), so beyond this length we append a short hash of\n *  the full coin type to disambiguate. */\nconst COIN_KNOWN_PREFIX_MAX = 60;\n\n/** Length of the SHA-256 hex suffix appended to long `coin.known(...)`\n *  resource ids. Eight chars (~32 bits) is the same width used by other\n *  collision-disambiguation hashes in the package (e.g. router profile,\n *  fork preimage suffixes). */\nconst COIN_KNOWN_HASH_SUFFIX_LEN = 8;\n\n/** Derive a stable, human-readable, collision-free resource-id segment\n *  for `coin.known(fullCoinType)`. Short types pass through as the\n *  readable `<addr>_<module>_<witness>` form; long types get a hash\n *  suffix so two types sharing a 60-char prefix can coexist. */\nconst coinKnownResourceKey = (fullCoinType: string): string => {\n\tconst readable = fullCoinType.replace(/^0x/, '').replace(/::/g, '_');\n\tif (readable.length <= COIN_KNOWN_PREFIX_MAX) {\n\t\treturn readable;\n\t}\n\tconst hash = createHash('sha256')\n\t\t.update(fullCoinType)\n\t\t.digest('hex')\n\t\t.slice(0, COIN_KNOWN_HASH_SUFFIX_LEN);\n\t// The readable prefix is truncated to leave room for the `_` divider\n\t// (`-1`) and the hash suffix (`-COIN_KNOWN_HASH_SUFFIX_LEN`), so the\n\t// resulting `<prefix>_<hash>` id has total length\n\t// ≤ COIN_KNOWN_PREFIX_MAX — bounded and deterministic per input.\n\treturn `${readable.slice(0, COIN_KNOWN_PREFIX_MAX - COIN_KNOWN_HASH_SUFFIX_LEN - 1)}_${hash}`;\n};\n\ntype PackageNameOf<Pkg extends PackageMember> =\n\tPkg extends ResourceRef<`package:${infer Name}`, PackageMemberValue> ? Name : string;\n\ntype PackageCoinResourceKey<\n\tPkg extends PackageMember,\n\tWit extends string,\n> = `${PackageNameOf<Pkg>}/${Lowercase<Wit>}`;\n\nconst packageNameFromMember = <Pkg extends PackageMember>(pkg: Pkg): PackageNameOf<Pkg> =>\n\tpkg.id.slice('package:'.length) as PackageNameOf<Pkg>;\n\n// ---------------------------------------------------------------------------\n// SDK shim projection\n// ---------------------------------------------------------------------------\n//\n// The coin plugin's resolvers need three Sui surfaces: `core.getObject`\n// (mint verify probe), `core.getCoinMetadata` (bare-type address form),\n// and the opaque `client` (`Transaction.build({client})` in the mint\n// produce body).\n//\n// `sui.sdk.core.getObject` lives on the typed `SuiSdkShim` directly;\n// `getCoinMetadata` lives on the underlying `ClientWithCoreApi['core']`\n// reached via `sui.sdk.client.core`. Project both onto the combined\n// `MetadataSdkShim & MintSdkShim` here at the boundary.\n\nconst projectCoinSdk = (sui: SuiClient): MetadataSdkShim & MintSdkShim => ({\n\tcore: {\n\t\tgetObject: sui.sdk.core.getObject,\n\t\tgetCoinMetadata: (args) => sui.sdk.client.core.getCoinMetadata(args),\n\t\tlistCoins: sui.sdk.core.listCoins,\n\t},\n\tclient: sui.sdk.client,\n\t// Fork mode mints offline with explicit gas (sui-fork has no simulate).\n\tforkMode: sui.fork !== null,\n});\n\n// ---------------------------------------------------------------------------\n// Per-form capability builders — dynamic (POST-acquire). Receive the\n// resolved `CoinValue` so codegen bindings stamp the REAL fullCoinType\n// + decimals instead of placeholder values.\n// ---------------------------------------------------------------------------\n\nconst buildCapabilities = (symbol: string, resolved: CoinValue) => {\n\tconst bindings: CoinBindings = {\n\t\tsymbol: resolved.symbol ?? symbol,\n\t\tfullCoinType: resolved.fullCoinType,\n\t\tdecimals: resolved.decimals,\n\t\tsource: resolved.source,\n\t\t...(resolved.displayName !== undefined ? { displayName: resolved.displayName } : {}),\n\t\t...(resolved.iconUrl !== undefined ? { iconUrl: resolved.iconUrl } : {}),\n\t\t...(resolved.treasuryCapId !== undefined ? { treasuryCapId: resolved.treasuryCapId } : {}),\n\t\t...(resolved.metadataId !== undefined ? { metadataId: resolved.metadataId } : {}),\n\t\t...(resolved.packageId !== undefined ? { packageId: resolved.packageId } : {}),\n\t};\n\tconst snap: SnapshotableDecl = makeCoinSnapshotable({ symbol });\n\tconst codegen: CodegenableDecl<`coin/${string}`> = makeCoinCodegen({\n\t\tsymbol,\n\t\tresolved: bindings,\n\t});\n\t// Project the coin's narrow `{address, amount}`-shaped strategy\n\t// to the wider cross-plugin `AccountFundingStrategy` contract\n\t// (`{address, amount, account}`) at the capability boundary. The\n\t// coin publisher signs the mint via its own lease (see\n\t// `coin/service.ts → mint`), so `account` is dropped honestly\n\t// here — the type-level contract is satisfied structurally\n\t// without a misleading `as` cast on the contribution literal.\n\t// Direct consumers (e.g. deepbook seed funding) keep using the\n\t// narrow shape on `CoinValue.fundingStrategy` directly.\n\tconst narrowStrategy = resolved.fundingStrategy;\n\tconst fundingContribution =\n\t\tnarrowStrategy === undefined\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t{\n\t\t\t\t\t\tkind: 'strategy-contributor',\n\t\t\t\t\t\tcapabilityKey: coinFundingCapabilityKey(resolved.fullCoinType),\n\t\t\t\t\t\tstrategy: {\n\t\t\t\t\t\t\t// usesAccountSigner: true — the coin strategy mints via\n\t\t\t\t\t\t\t// the publisher account's own `withTransactionSigner`,\n\t\t\t\t\t\t\t// which acquires the per-address lease\n\t\t\t\t\t\t\t// `account:<publisherAddress>` internally (service.ts\n\t\t\t\t\t\t\t// mint -> performMint -> signAndDispatch). The account\n\t\t\t\t\t\t\t// funding dispatcher must therefore NOT wrap the request\n\t\t\t\t\t\t\t// in its own `account:<fundedAddress>` lease. Two reasons:\n\t\t\t\t\t\t\t//   1. The funded account is a passive `recipient` in\n\t\t\t\t\t\t\t//      `mint_and_transfer` — it neither signs nor\n\t\t\t\t\t\t\t//      contributes objects, so the funded-address lease\n\t\t\t\t\t\t\t//      serializes nothing; the publisher lease already\n\t\t\t\t\t\t\t//      serializes the only account whose gas + treasury\n\t\t\t\t\t\t\t//      cap the mint consumes.\n\t\t\t\t\t\t\t//   2. When the funded address IS the publisher address\n\t\t\t\t\t\t\t//      (fund a publisher with a coin it published), the\n\t\t\t\t\t\t\t//      dispatcher's `account:<funded>` lease and the\n\t\t\t\t\t\t\t//      mint's `account:<publisher>` lease collapse to the\n\t\t\t\t\t\t\t//      same non-reentrant key, so the inner acquire would\n\t\t\t\t\t\t\t//      block forever. Owning the lease inside the strategy\n\t\t\t\t\t\t\t//      (signalled by this flag) makes self-funding\n\t\t\t\t\t\t\t//      single-acquire and deadlock-free while leaving the\n\t\t\t\t\t\t\t//      cross-account path's mint + publisher lease\n\t\t\t\t\t\t\t//      unchanged.\n\t\t\t\t\t\t\t// Mirrors deepbook's DEEP strategy (faucet-strategy.ts),\n\t\t\t\t\t\t\t// which sets the same flag and self-acquires via\n\t\t\t\t\t\t\t// `req.account.withTransactionSigner`.\n\t\t\t\t\t\t\tusesAccountSigner: true,\n\t\t\t\t\t\t\trequest: (req) =>\n\t\t\t\t\t\t\t\tnarrowStrategy.request({ address: req.address, amount: req.amount }),\n\t\t\t\t\t\t} satisfies AccountFundingStrategy,\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<`coinType:${string}`, AccountFundingStrategy>,\n\t\t\t\t];\n\treturn [snap, codegen, ...fundingContribution] as const;\n};\n\n// ---------------------------------------------------------------------------\n// Form 1: coin.fromPackage(pkg, witness) — package-scoped registry lookup\n// ---------------------------------------------------------------------------\n\n/** A user-supplied package ref. The user passes the result of\n *  `localPackage('foo', …)` / `knownPackage('foo', …)` — NOT a bare string\n *  value. Generic over the literal package name so the witness-form\n *  coin's dependency preserves the per-package resource id. */\nexport interface PackageMemberValue {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly publisher?: import('./mint.ts').MintSigner;\n}\n\nexport type PackageMember<Name extends string = string> = ResourceRef<\n\t`package:${Name}`,\n\tPackageMemberValue\n>;\n\n/** Resolve a coin by `(publishing package member, witness)`. Forces\n *  a dep edge on the publishing package's resource — the substrate ensures\n *  the publish has completed before this resolves.\n *\n *  Resource identity includes both the package's symbolic name and the\n *  witness name, so two packages can expose the same witness without\n *  colliding in the substrate graph.\n *\n *  Pass the package MEMBER (the value returned by `localPackage(...)`\n *  / `knownPackage(...)`). The factory\n *  projects it to a dependency resource and receives the package value\n *  in `start`. */\nexport const fromPackage = <const Pkg extends PackageMember, Wit extends string>(\n\tpkg: Pkg,\n\twitnessName: Wit,\n) => {\n\tconst packageName = packageNameFromMember(pkg);\n\tconst symbol = witnessName.toLowerCase() as Lowercase<Wit>;\n\tconst resourceKey = `${packageName}/${symbol}` as PackageCoinResourceKey<Pkg, Wit>;\n\tconst coinRef = resource<CoinResourceId<typeof resourceKey>, CoinValue>(\n\t\tcoinResourceId(resourceKey),\n\t);\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { pkg, sui: suiResource },\n\t\trole: 'task',\n\t\t// Coin lifecycle is action-shaped — uses the action section bucket;\n\t\t// see substrate/projection.ts `RowSection` for the canonical list.\n\t\t// All three coin factories (`fromPackage` / `known` / `builtin`)\n\t\t// share this deliberate bucketing; promoting to a dedicated\n\t\t// `'coin'` section would ripple through every projection / TUI\n\t\t// consumer for marginal display value.\n\t\tsection: 'action',\n\t\tstart: ({ pkg: resolved, sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst artifactPublisher = yield* ArtifactPublisherService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = {\n\t\t\t\t\tkind: 'witness',\n\t\t\t\t\tpublishingPackageName: resolved.name,\n\t\t\t\t\twitness: witnessName,\n\t\t\t\t\t...(resolved.publisher === undefined ? {} : { fundingSigner: resolved.publisher }),\n\t\t\t\t};\n\t\t\t\treturn yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\tpublisher: artifactPublisher,\n\t\t\t\t});\n\t\t\t}),\n\t\terrorContributions: coinErrorContributions,\n\t\tcapabilities: ({ value }) => buildCapabilities(symbol, value),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Form 2: coin.known(fullCoinType) — bare on-chain type\n// ---------------------------------------------------------------------------\n\n/** Resolve a coin by bare on-chain type via `getCoinMetadata`.\n *  Used for live-net coins (mainnet DEEP, USDC etc.) that no local\n *  `Package(...)` publishes.\n *\n *  Soft-degrades to `decimals: 0` on RPC failure — distilled-doc\n *  invariant. Resource id uses a deterministic-but-readable derivation of\n *  the coin type so collisions surface at compose time. */\nexport const known = <FullType extends string>(fullCoinType: FullType) => {\n\t// Derive a resource id from the type: keep it readable but unique.\n\t// The substrate's compose-time dedup uses string equality on the id,\n\t// so two long coin types that share a 60-char prefix MUST NOT collide.\n\t// When the projection truncates, append a short hash of the FULL coin\n\t// type so the suffix disambiguates the two — the readable prefix\n\t// stays human-recognizable while the hash guarantees uniqueness.\n\tconst id = coinKnownResourceKey(fullCoinType);\n\tconst coinRef = resource<CoinResourceId<typeof id>, CoinValue>(\n\t\tcoinResourceId(id) as CoinResourceId<typeof id>,\n\t);\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { sui: suiResource },\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\tstart: ({ sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst publisher = yield* ArtifactPublisherService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = { kind: 'known', fullCoinType };\n\t\t\t\treturn yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\tpublisher,\n\t\t\t\t});\n\t\t\t}),\n\t\terrorContributions: coinErrorContributions,\n\t\tcapabilities: ({ value }) => buildCapabilities(id, value),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Form 3: coin.builtin('sui') — protocol-defined constant\n// ---------------------------------------------------------------------------\n\n/** Resolve a protocol-defined builtin coin. Currently `'sui'` only —\n *  distilled-doc 13-coin.md Invariant 4: SUI is `0x2::sui::SUI`,\n *  decimals=9. No RPC, no registry. */\nexport const builtin = <Name extends keyof typeof BUILTIN_COINS>(name: Name) => {\n\tconst symbol = name; // 'sui' today\n\tconst coinRef = resource<CoinResourceId<Name>, CoinValue>(coinResourceId(name));\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { sui: suiResource },\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\tstart: ({ sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst publisher = yield* ArtifactPublisherService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = { kind: 'builtin', name };\n\t\t\t\treturn yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\tpublisher,\n\t\t\t\t});\n\t\t\t}),\n\t\terrorContributions: coinErrorContributions,\n\t\tcapabilities: ({ value }) => buildCapabilities(symbol, value),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Public `coin` namespace\n// ---------------------------------------------------------------------------\n\n/** User-facing factory namespace. Three variants — see file header for\n *  the rationale on not exposing a `coin(identifier)` form-guessing\n *  entry. */\nexport const coin = {\n\tfromPackage,\n\tknown,\n\tbuiltin,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Re-exports — advanced callers (Wallet, Faucet, Deepbook, examples)\n// ---------------------------------------------------------------------------\n\nexport type { CoinValue, CoinAddressForm } from './service.ts';\nexport type { ResolvedCoin, BuiltinCoinName } from './address-resolution.ts';\nexport { BUILTIN_COINS } from './address-resolution.ts';\n\nexport type { CoinRecord, CoinRegistry, CoinKey } from './registry.ts';\nexport { CoinRegistryService, layerCoinRegistry } from './registry.ts';\n\nexport type { CoinBindings } from './codegen.ts';\n\nexport type { DiscoveredCoin } from './discovery.ts';\nexport { discoverCoinsFromPublish } from './discovery.ts';\n\nexport type { MetadataSdkShim, OnchainCoinMetadata, CoinMetadataCache } from './metadata.ts';\nexport {\n\tOnchainCoinMetadataShape,\n\tMETADATA_FETCH_TIMEOUT_MS,\n\tMETADATA_RETRY_SCHEDULE,\n\tfetchCoinMetadataOnce,\n\tfetchCoinMetadataMany,\n\tmakeCoinMetadataCache,\n\tisBareCoinType,\n\tvalidateBareCoinType,\n} from './metadata.ts';\n\nexport type { MintInputs, MintResult, MintSigner, MintSdkShim, CachedMint } from './mint.ts';\nexport { performMint, MintedCoinVerifyShape, mintTxError, mintParseError } from './mint.ts';\n\nexport type { CoinError, CoinPhase } from './errors.ts';\nexport { coinError, COIN_ERROR_TAGS } from './errors.ts';\n\nexport { CoinSpans } from './spans.ts';\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/coin/index.ts"],"sourcesContent":["// Coin plugin — barrel + `coin(...)` factory family.\n//\n// Architecture (13-coin.md): Coin is the user-facing primitive family\n// for *addressing* custom Move coin types. It does NOT publish Move\n// modules itself — the Package plugin publishes; coin auto-discovery\n// (in `discovery.ts`) folds the publish output into the per-stack\n// `CoinRegistry`; this factory resolves user-supplied addresses\n// (witness / bare-type / builtin) against that registry plus the live RPC.\n//\n// User-facing factory shape — three variants mirroring the address\n// forms:\n//\n//   coin.fromPackage(pkg, 'MOCK_USDC')       // package member → registry\n//   coin.known('0x...::deep::DEEP')          // bare → live RPC\n//   coin.builtin('sui')                      // protocol-defined constant\n//\n// (A `coin(identifier)` convenience entry is intentionally NOT\n// exposed — distilled-doc 13-coin.md Pain point #6 documents how the\n// \"guess the form from the string\" path is a footgun. The three-form\n// surface forces the user to make the disambiguation explicit at the\n// call site.)\n//\n// Resource id: `'coin:<package>/<witness>'` for package-scoped coins and\n// `'coin:<identifier>'` for known/builtin coins — one tag per declared\n// coin instance, so the substrate's compose-time dedup detects collisions\n// cleanly. Mirrors the Package plugin's per-instance resource identity.\n\nimport { createHash } from 'node:crypto';\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type ResourceRef } from '../../api/define-plugin.ts';\nimport type { CodegenableDecl } from '../../contracts/codegenable.ts';\nimport type { SnapshotableDecl } from '../../contracts/snapshotable.ts';\nimport type { StrategyContributorDecl } from '../../contracts/strategy-contributor.ts';\nimport type { Contribution } from '../../substrate/plugin-ctx.ts';\nimport { emitContributions, PluginContext } from '../../substrate/plugin-ctx.ts';\nimport { CacheService } from '../../substrate/runtime/cache/index.ts';\nimport { suiResource } from '../sui/index.ts';\nimport type { SuiClient } from '../sui/index.ts';\nimport type { AccountFundingStrategy } from '../../contracts/funding-strategy.ts';\n\nimport { makeCoinCodegen, makeCoinStaticCodegen, type CoinBindings } from './codegen.ts';\nimport { makeCoinSnapshotable } from './snapshot.ts';\nimport { CoinRegistryService } from './registry.ts';\nimport { acquireCoin, type CoinAddressForm, type CoinValue } from './service.ts';\nimport { BUILTIN_COINS } from './address-resolution.ts';\nimport type { MetadataSdkShim } from './metadata.ts';\nimport type { MintSdkShim } from './mint.ts';\n\nexport const coinFundingCapabilityKey = <FullType extends string>(\n\tfullCoinType: FullType,\n): `coinType:${FullType}` => `coinType:${fullCoinType}` as const;\n\n// ---------------------------------------------------------------------------\n// Resource — one per declared coin instance, keyed by explicit address form.\n// ---------------------------------------------------------------------------\n\n/** Resource id constructor. The symbolic name is part of the resource identity\n *  so the substrate's compose-time dedup catches collisions. */\nexport const coinResourceId = <Sym extends string>(symbol: Sym): `coin:${Sym}` => `coin:${symbol}`;\n\nexport type CoinResourceId<Sym extends string> = `coin:${Sym}`;\n\n/** Maximum length of the readable prefix in a `coin.known(...)` resource\n *  id. Two long coin types sharing this prefix length would silently\n *  collide in the substrate's compose-time dedup (string equality on\n *  the resource id), so beyond this length we append a short hash of\n *  the full coin type to disambiguate. */\nconst COIN_KNOWN_PREFIX_MAX = 60;\n\n/** Length of the SHA-256 hex suffix appended to long `coin.known(...)`\n *  resource ids. Eight chars (~32 bits) is the same width used by other\n *  collision-disambiguation hashes in the package (e.g. router profile,\n *  fork preimage suffixes). */\nconst COIN_KNOWN_HASH_SUFFIX_LEN = 8;\n\n/** Derive a stable, human-readable, collision-free resource-id segment\n *  for `coin.known(fullCoinType)`. Short types pass through as the\n *  readable `<addr>_<module>_<witness>` form; long types get a hash\n *  suffix so two types sharing a 60-char prefix can coexist. */\nconst coinKnownResourceKey = (fullCoinType: string): string => {\n\tconst readable = fullCoinType.replace(/^0x/, '').replace(/::/g, '_');\n\tif (readable.length <= COIN_KNOWN_PREFIX_MAX) {\n\t\treturn readable;\n\t}\n\tconst hash = createHash('sha256')\n\t\t.update(fullCoinType)\n\t\t.digest('hex')\n\t\t.slice(0, COIN_KNOWN_HASH_SUFFIX_LEN);\n\t// The readable prefix is truncated to leave room for the `_` divider\n\t// (`-1`) and the hash suffix (`-COIN_KNOWN_HASH_SUFFIX_LEN`), so the\n\t// resulting `<prefix>_<hash>` id has total length\n\t// ≤ COIN_KNOWN_PREFIX_MAX — bounded and deterministic per input.\n\treturn `${readable.slice(0, COIN_KNOWN_PREFIX_MAX - COIN_KNOWN_HASH_SUFFIX_LEN - 1)}_${hash}`;\n};\n\ntype PackageNameOf<Pkg extends PackageMember> =\n\tPkg extends ResourceRef<`package:${infer Name}`, PackageMemberValue> ? Name : string;\n\ntype PackageCoinResourceKey<\n\tPkg extends PackageMember,\n\tWit extends string,\n> = `${PackageNameOf<Pkg>}/${Lowercase<Wit>}`;\n\nconst packageNameFromMember = <Pkg extends PackageMember>(pkg: Pkg): PackageNameOf<Pkg> =>\n\tpkg.id.slice('package:'.length) as PackageNameOf<Pkg>;\n\n// ---------------------------------------------------------------------------\n// SDK shim projection\n// ---------------------------------------------------------------------------\n//\n// The coin plugin's resolvers need three Sui surfaces: `core.getObject`\n// (mint verify probe), `core.getCoinMetadata` (bare-type address form),\n// and the opaque `client` (`Transaction.build({client})` in the mint\n// produce body).\n//\n// `sui.sdk.core.getObject` lives on the typed `SuiSdkShim` directly;\n// `getCoinMetadata` lives on the underlying `ClientWithCoreApi['core']`\n// reached via `sui.sdk.client.core`. Project both onto the combined\n// `MetadataSdkShim & MintSdkShim` here at the boundary.\n\nconst projectCoinSdk = (sui: SuiClient): MetadataSdkShim & MintSdkShim => ({\n\tcore: {\n\t\tgetObject: sui.sdk.core.getObject,\n\t\tgetCoinMetadata: (args) => sui.sdk.client.core.getCoinMetadata(args),\n\t\tlistCoins: sui.sdk.core.listCoins,\n\t},\n\tclient: sui.sdk.client,\n\t// Fork mode mints offline with explicit gas (sui-fork has no simulate).\n\tforkMode: sui.fork !== null,\n});\n\n// ---------------------------------------------------------------------------\n// Per-form contribution decls — dynamic (POST-acquire). Receive the\n// resolved `CoinValue` so codegen bindings stamp the REAL fullCoinType\n// + decimals instead of placeholder values.\n//\n// `coinContributions` is a PURE decl-builder (NOT a routing wrapper): the\n// three coin `start` bodies feed its return into the shared\n// `emitContributions(ctx, …)`, which routes each decl by `kind`. Shared by\n// all three forms so the rich funding-strategy projection below lives once.\n// Decl shapes + ORDER are load-bearing.\n//\n// Exported for the funding-strategy decl-shape test: it feeds a hand-built\n// resolved `CoinValue` here and asserts the projected `strategy-contributor`\n// decl via `emitContributions` against a capturing ctx.\n// ---------------------------------------------------------------------------\n\nexport const coinContributions = (\n\tsymbol: string,\n\tresolved: CoinValue,\n): ReadonlyArray<Contribution> => {\n\tconst bindings: CoinBindings = {\n\t\tsymbol: resolved.symbol ?? symbol,\n\t\tfullCoinType: resolved.fullCoinType,\n\t\tdecimals: resolved.decimals,\n\t\tsource: resolved.source,\n\t\t...(resolved.displayName !== undefined ? { displayName: resolved.displayName } : {}),\n\t\t...(resolved.iconUrl !== undefined ? { iconUrl: resolved.iconUrl } : {}),\n\t\t...(resolved.treasuryCapId !== undefined ? { treasuryCapId: resolved.treasuryCapId } : {}),\n\t\t...(resolved.metadataId !== undefined ? { metadataId: resolved.metadataId } : {}),\n\t\t...(resolved.packageId !== undefined ? { packageId: resolved.packageId } : {}),\n\t};\n\tconst snap: SnapshotableDecl = makeCoinSnapshotable({ symbol });\n\tconst codegen: CodegenableDecl = makeCoinCodegen({\n\t\tsymbol,\n\t\tresolved: bindings,\n\t});\n\t// Project the coin's narrow `{address, amount}`-shaped strategy\n\t// to the wider cross-plugin `AccountFundingStrategy` contract\n\t// (`{address, amount, account}`) at the capability boundary. The\n\t// coin publisher signs the mint via its own lease (see\n\t// `coin/service.ts → mint`), so `account` is dropped honestly\n\t// here — the type-level contract is satisfied structurally\n\t// without a misleading `as` cast on the contribution literal.\n\t// Direct consumers (e.g. deepbook seed funding) keep using the\n\t// narrow shape on `CoinValue.fundingStrategy` directly.\n\tconst narrowStrategy = resolved.fundingStrategy;\n\tconst fundingContribution =\n\t\tnarrowStrategy === undefined\n\t\t\t? []\n\t\t\t: [\n\t\t\t\t\t{\n\t\t\t\t\t\tkind: 'strategy-contributor',\n\t\t\t\t\t\tcapabilityKey: coinFundingCapabilityKey(resolved.fullCoinType),\n\t\t\t\t\t\tstrategy: {\n\t\t\t\t\t\t\t// usesAccountSigner: true — the coin strategy mints via\n\t\t\t\t\t\t\t// the publisher account's own `withTransactionSigner`,\n\t\t\t\t\t\t\t// which acquires the per-address lease\n\t\t\t\t\t\t\t// `account:<publisherAddress>` internally (service.ts\n\t\t\t\t\t\t\t// mint -> performMint -> signAndDispatch). The account\n\t\t\t\t\t\t\t// funding dispatcher must therefore NOT wrap the request\n\t\t\t\t\t\t\t// in its own `account:<fundedAddress>` lease. Two reasons:\n\t\t\t\t\t\t\t//   1. The funded account is a passive `recipient` in\n\t\t\t\t\t\t\t//      `mint_and_transfer` — it neither signs nor\n\t\t\t\t\t\t\t//      contributes objects, so the funded-address lease\n\t\t\t\t\t\t\t//      serializes nothing; the publisher lease already\n\t\t\t\t\t\t\t//      serializes the only account whose gas + treasury\n\t\t\t\t\t\t\t//      cap the mint consumes.\n\t\t\t\t\t\t\t//   2. When the funded address IS the publisher address\n\t\t\t\t\t\t\t//      (fund a publisher with a coin it published), the\n\t\t\t\t\t\t\t//      dispatcher's `account:<funded>` lease and the\n\t\t\t\t\t\t\t//      mint's `account:<publisher>` lease collapse to the\n\t\t\t\t\t\t\t//      same non-reentrant key, so the inner acquire would\n\t\t\t\t\t\t\t//      block forever. Owning the lease inside the strategy\n\t\t\t\t\t\t\t//      (signalled by this flag) makes self-funding\n\t\t\t\t\t\t\t//      single-acquire and deadlock-free while leaving the\n\t\t\t\t\t\t\t//      cross-account path's mint + publisher lease\n\t\t\t\t\t\t\t//      unchanged.\n\t\t\t\t\t\t\t// Mirrors deepbook's DEEP strategy (faucet-strategy.ts),\n\t\t\t\t\t\t\t// which sets the same flag and self-acquires via\n\t\t\t\t\t\t\t// `req.account.withTransactionSigner`.\n\t\t\t\t\t\t\tusesAccountSigner: true,\n\t\t\t\t\t\t\trequest: (req) =>\n\t\t\t\t\t\t\t\tnarrowStrategy.request({ address: req.address, amount: req.amount }),\n\t\t\t\t\t\t} satisfies AccountFundingStrategy,\n\t\t\t\t\t\tautoMounted: true,\n\t\t\t\t\t} satisfies StrategyContributorDecl<`coinType:${string}`, AccountFundingStrategy>,\n\t\t\t\t];\n\treturn [snap, codegen, ...fundingContribution];\n};\n\n// ---------------------------------------------------------------------------\n// Form 1: coin.fromPackage(pkg, witness) — package-scoped registry lookup\n// ---------------------------------------------------------------------------\n\n/** A user-supplied package ref. The user passes the result of\n *  `localPackage('foo', …)` / `knownPackage('foo', …)` — NOT a bare string\n *  value. Generic over the literal package name so the witness-form\n *  coin's dependency preserves the per-package resource id. */\nexport interface PackageMemberValue {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly publisher?: import('./mint.ts').MintSigner;\n}\n\nexport type PackageMember<Name extends string = string> = ResourceRef<\n\t`package:${Name}`,\n\tPackageMemberValue\n>;\n\n/** Resolve a coin by `(publishing package member, witness)`. Forces\n *  a dep edge on the publishing package's resource — the substrate ensures\n *  the publish has completed before this resolves.\n *\n *  Resource identity includes both the package's symbolic name and the\n *  witness name, so two packages can expose the same witness without\n *  colliding in the substrate graph.\n *\n *  Pass the package MEMBER (the value returned by `localPackage(...)`\n *  / `knownPackage(...)`). The factory\n *  projects it to a dependency resource and receives the package value\n *  in `start`. */\nexport const fromPackage = <const Pkg extends PackageMember, Wit extends string>(\n\tpkg: Pkg,\n\twitnessName: Wit,\n) => {\n\tconst packageName = packageNameFromMember(pkg);\n\tconst symbol = witnessName.toLowerCase() as Lowercase<Wit>;\n\tconst resourceKey = `${packageName}/${symbol}` as PackageCoinResourceKey<Pkg, Wit>;\n\tconst coinRef = resource<CoinResourceId<typeof resourceKey>, CoinValue>(\n\t\tcoinResourceId(resourceKey),\n\t);\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { pkg, sui: suiResource },\n\t\trole: 'task',\n\t\t// Coin lifecycle is action-shaped — uses the action section bucket;\n\t\t// see substrate/projection.ts `RowSection` for the canonical list.\n\t\t// All three coin factories (`fromPackage` / `known` / `builtin`)\n\t\t// share this deliberate bucketing; promoting to a dedicated\n\t\t// `'coin'` section would ripple through every projection / TUI\n\t\t// consumer for marginal display value.\n\t\tsection: 'action',\n\t\t// Stack-free codegen: a package coin's type / decimals / package id\n\t\t// are LOADED CONFIG DATA -- the committed stub emits\n\t\t// `resolveValue('coin:<symbol>', '<key>')`, never a baked coin type.\n\t\tstaticCodegen: () => [makeCoinStaticCodegen({ symbol, source: 'registry' })],\n\t\t// `deps` auto-infers the resolved `{ pkg, sui }` dependency object;\n\t\t// `ctx` arrives via the `PluginContext` service.\n\t\tstart: ({ pkg: resolved, sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst ctx = yield* PluginContext;\n\t\t\t\tconst artifactPublisher = yield* CacheService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = {\n\t\t\t\t\tkind: 'witness',\n\t\t\t\t\tpublishingPackageName: resolved.name,\n\t\t\t\t\twitness: witnessName,\n\t\t\t\t\t...(resolved.publisher === undefined ? {} : { fundingSigner: resolved.publisher }),\n\t\t\t\t};\n\t\t\t\tconst value = yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchainId: sui.chainId,\n\t\t\t\t\tpublisher: artifactPublisher,\n\t\t\t\t});\n\t\t\t\t// Emit the resolved coin's contributions inline. `value` is the\n\t\t\t\t// just-resolved `CoinValue`; `symbol` is the package-scoped\n\t\t\t\t// witness symbol in scope.\n\t\t\t\temitContributions(ctx, coinContributions(symbol, value));\n\t\t\t\treturn value;\n\t\t\t}),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Form 2: coin.known(fullCoinType) — bare on-chain type\n// ---------------------------------------------------------------------------\n\n/** Resolve a coin by bare on-chain type via `getCoinMetadata`.\n *  Used for live-net coins (mainnet DEEP, USDC etc.) that no local\n *  `Package(...)` publishes.\n *\n *  Soft-degrades to `decimals: 0` on RPC failure — distilled-doc\n *  invariant. Resource id uses a deterministic-but-readable derivation of\n *  the coin type so collisions surface at compose time. */\nexport const known = <FullType extends string>(fullCoinType: FullType) => {\n\t// Derive a resource id from the type: keep it readable but unique.\n\t// The substrate's compose-time dedup uses string equality on the id,\n\t// so two long coin types that share a 60-char prefix MUST NOT collide.\n\t// When the projection truncates, append a short hash of the FULL coin\n\t// type so the suffix disambiguates the two — the readable prefix\n\t// stays human-recognizable while the hash guarantees uniqueness.\n\tconst id = coinKnownResourceKey(fullCoinType);\n\tconst coinRef = resource<CoinResourceId<typeof id>, CoinValue>(\n\t\tcoinResourceId(id) as CoinResourceId<typeof id>,\n\t);\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { sui: suiResource },\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\t// Stack-free codegen: the caller DECLARED this on-chain coin type, so\n\t\t// the committed stub bakes `fullCoinType` as a LITERAL; `decimals` /\n\t\t// `packageId` still resolve at app build/dev time (they come from\n\t\t// `getCoinMetadata`, only known after a live probe).\n\t\tstaticCodegen: () => [\n\t\t\tmakeCoinStaticCodegen({ symbol: id, source: 'on-chain', knownCoinType: fullCoinType }),\n\t\t],\n\t\tstart: ({ sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst ctx = yield* PluginContext;\n\t\t\t\tconst publisher = yield* CacheService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = { kind: 'known', fullCoinType };\n\t\t\t\tconst value = yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchainId: sui.chainId,\n\t\t\t\t\tpublisher,\n\t\t\t\t});\n\t\t\t\t// Emit inline. `value` is the resolved `CoinValue`; `id` is the\n\t\t\t\t// derived `coin.known` resource key.\n\t\t\t\temitContributions(ctx, coinContributions(id, value));\n\t\t\t\treturn value;\n\t\t\t}),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Form 3: coin.builtin('sui') — protocol-defined constant\n// ---------------------------------------------------------------------------\n\n/** Resolve a protocol-defined builtin coin. Currently `'sui'` only —\n *  distilled-doc 13-coin.md Invariant 4: SUI is `0x2::sui::SUI`,\n *  decimals=9. No RPC, no registry. */\nexport const builtin = <Name extends keyof typeof BUILTIN_COINS>(name: Name) => {\n\tconst symbol = name; // 'sui' today\n\tconst coinRef = resource<CoinResourceId<Name>, CoinValue>(coinResourceId(name));\n\treturn definePlugin({\n\t\tid: coinRef.id,\n\t\tdependsOn: { sui: suiResource },\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\t// Stack-free codegen: a builtin coin (SUI) is protocol-defined --\n\t\t// its coin type + decimals are constants baked as LITERALS (no\n\t\t// `resolveValue` that would throw at module load for a coin with no\n\t\t// injected id).\n\t\tstaticCodegen: () => [\n\t\t\tmakeCoinStaticCodegen({\n\t\t\t\tsymbol,\n\t\t\t\tsource: 'builtin',\n\t\t\t\tconstants: {\n\t\t\t\t\tfullCoinType: BUILTIN_COINS[name].fullCoinType,\n\t\t\t\t\tdecimals: BUILTIN_COINS[name].decimals,\n\t\t\t\t},\n\t\t\t}),\n\t\t],\n\t\tstart: ({ sui }) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst ctx = yield* PluginContext;\n\t\t\t\tconst publisher = yield* CacheService;\n\t\t\t\tconst registry = yield* CoinRegistryService;\n\t\t\t\tconst form: CoinAddressForm = { kind: 'builtin', name };\n\t\t\t\tconst value = yield* acquireCoin(form, {\n\t\t\t\t\tregistry,\n\t\t\t\t\tsdk: projectCoinSdk(sui),\n\t\t\t\t\tchainId: sui.chainId,\n\t\t\t\t\tpublisher,\n\t\t\t\t});\n\t\t\t\t// Emit inline. `value` is the resolved `CoinValue`; `symbol` is\n\t\t\t\t// the builtin coin name (`'sui'`).\n\t\t\t\temitContributions(ctx, coinContributions(symbol, value));\n\t\t\t\treturn value;\n\t\t\t}),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Public `coin` namespace\n// ---------------------------------------------------------------------------\n\n/** User-facing factory namespace. Three variants — see file header for\n *  the rationale on not exposing a `coin(identifier)` form-guessing\n *  entry. */\nexport const coin = {\n\tfromPackage,\n\tknown,\n\tbuiltin,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Re-exports — advanced callers (Wallet, Faucet, Deepbook, examples)\n// ---------------------------------------------------------------------------\n\nexport type { CoinValue, CoinAddressForm } from './service.ts';\nexport type { ResolvedCoin, BuiltinCoinName } from './address-resolution.ts';\nexport { BUILTIN_COINS } from './address-resolution.ts';\n\nexport type { CoinRecord, CoinRegistry, CoinKey } from './registry.ts';\nexport { CoinRegistryService, layerCoinRegistry } from './registry.ts';\n\nexport type { CoinBindings } from './codegen.ts';\n\nexport type { DiscoveredCoin } from './discovery.ts';\nexport { discoverCoinsFromPublish } from './discovery.ts';\n\nexport type { MetadataSdkShim, OnchainCoinMetadata, CoinMetadataCache } from './metadata.ts';\nexport {\n\tOnchainCoinMetadataShape,\n\tMETADATA_FETCH_TIMEOUT_MS,\n\tMETADATA_RETRY_SCHEDULE,\n\tfetchCoinMetadataOnce,\n\tfetchCoinMetadataMany,\n\tmakeCoinMetadataCache,\n\tisBareCoinType,\n\tvalidateBareCoinType,\n} from './metadata.ts';\n\nexport type { MintInputs, MintResult, MintSigner, MintSdkShim, CachedMint } from './mint.ts';\nexport { performMint, MintedCoinVerifyShape, mintTxError, mintParseError } from './mint.ts';\n\nexport type { CoinError, CoinPhase } from './errors.ts';\nexport { coinError } from './errors.ts';\n"],"mappings":"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"}

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

@@ -1,5 +1,6 @@
 import { CoinError } from "./errors.mjs";
 import { Effect, Schema } from "effect";
+
 //#region src/plugins/coin/metadata.d.ts
 /** Bare-coin-type heuristic — distilled-doc 13-coin.md Invariant 3.
  *