@mysten-incubation/devstack 0.0.1 → 0.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.mjs","names":[],"sources":["../../../src/plugins/coin/metadata.ts"],"sourcesContent":["// CoinMetadata fetch + soft-degradation.\n//\n// Distilled-doc 13-coin.md Invariant 8: `getCoinMetadata` failures\n// degrade, do not throw. A timeout or RPC error after one retry\n// returns `null` (logged as a warning); the discovery pipeline keeps\n// going. The next supervisor cycle picks the missing record up.\n//\n// Per-attempt timeout 5s, ONE retry at 250ms backoff (matches the v3\n// `RETRY_SCHEDULE` exactly — distilled-doc 13-coin.md §Configuration).\n//\n// In-process per-Layer-invocation cache keyed by fullCoinType. The\n// fullCoinType folds the packageId, so a fresh chain (new genesis)\n// means new packageIds, which means the cache misses naturally —\n// persistence across restart is unnecessary.\n\nimport { Effect, Ref, Schema } from 'effect';\n\nimport { decodeUnknown } from '../../substrate/runtime/runtime-decode.ts';\nimport { SpanAttr } from '../../substrate/runtime/observability/spans.ts';\nimport { makeSpacedRetrySchedule } from '../../substrate/runtime/retry-policy.ts';\nimport { coinError, type CoinError } from './errors.ts';\n\n/** Per-attempt timeout (5 seconds) — distilled-doc invariant. */\nexport const METADATA_FETCH_TIMEOUT_MS = 5_000;\n\n/** Retry schedule — ONE retry at 250ms backoff. Matches the v3\n *  `RETRY_SCHEDULE` (250ms spaced, bounded to one retry). */\nexport const METADATA_RETRY_SCHEDULE = makeSpacedRetrySchedule(250, 1);\n\n/** On-chain CoinMetadata projection — narrowed to the columns the\n *  registry needs. The SDK's full shape carries more (description,\n *  raw bytes); we don't.\n *\n *  IMPORTANT (chain-probe schema constraint from the last sweep):\n *  this Schema MUST NOT depend on any services. `Schema.Schema<T>` is\n *  parameterized `<Type, Encoded, R, RD>`; we constrain `R` and `RD`\n *  to `never` via `Schema.Codec<T, unknown, never, never>` at the\n *  consumer boundary, but the schema literal itself uses ONLY\n *  service-free combinators (`Schema.String`, `Schema.Number`,\n *  `Schema.optional`). */\nexport const OnchainCoinMetadataShape = Schema.Struct({\n\tid: Schema.String,\n\tdecimals: Schema.Number,\n\tname: Schema.String,\n\tsymbol: Schema.String,\n\tdescription: Schema.optional(Schema.String),\n\ticonUrl: Schema.optional(Schema.String),\n});\n\nexport type OnchainCoinMetadata = typeof OnchainCoinMetadataShape.Type;\n\n/** SDK shim — the surface the discovery pass calls. The Sui plugin's\n *  resolved client exposes this via `sdk.core.getCoinMetadata`. Kept\n *  narrow (no `@mysten/sui` type import) so this module stays\n *  layering-neutral; the consumer hands in the resolved client. */\nexport interface MetadataSdkShim {\n\treadonly core: {\n\t\treadonly getCoinMetadata: (args: { readonly coinType: string }) => Promise<unknown>;\n\t};\n}\n\n/** Per-Layer-invocation cache. `null` means \"we tried and the RPC\n *  said the coin had no CoinMetadata\"; `undefined` means \"we haven't\n *  asked yet\". */\nexport interface CoinMetadataCache {\n\treadonly get: (fullCoinType: string) => Effect.Effect<OnchainCoinMetadata | null | undefined>;\n\treadonly put: (fullCoinType: string, value: OnchainCoinMetadata | null) => Effect.Effect<void>;\n}\n\n/** Build an empty cache. */\nexport const makeCoinMetadataCache = (): Effect.Effect<CoinMetadataCache> =>\n\tEffect.gen(function* () {\n\t\tconst ref = yield* Ref.make<Record<string, OnchainCoinMetadata | null>>({});\n\t\treturn {\n\t\t\tget: (fullCoinType) =>\n\t\t\t\tRef.get(ref).pipe(Effect.map((m) => (fullCoinType in m ? m[fullCoinType] : undefined))),\n\t\t\tput: (fullCoinType, value) => Ref.update(ref, (m) => ({ ...m, [fullCoinType]: value })),\n\t\t};\n\t});\n\n/** Fetch CoinMetadata for one coin type. Soft-degrades on RPC\n *  failure / timeout: returns `null` after the retry budget is\n *  exhausted, AND logs a warning.\n *\n *  Distilled-doc 13-coin.md Invariant 8: this is intentional. The\n *  publish-discovery pass must not fail the whole supervisor cycle on\n *  a flaky RPC blip. */\nexport const fetchCoinMetadataOnce = (\n\tsdk: MetadataSdkShim,\n\tfullCoinType: string,\n): Effect.Effect<OnchainCoinMetadata | null> =>\n\tEffect.gen(function* () {\n\t\tconst raw: unknown = yield* Effect.tryPromise({\n\t\t\ttry: () => sdk.core.getCoinMetadata({ coinType: fullCoinType }),\n\t\t\tcatch: (cause): { readonly _tag: 'rpc'; readonly cause: unknown } => ({\n\t\t\t\t_tag: 'rpc',\n\t\t\t\tcause,\n\t\t\t}),\n\t\t}).pipe(\n\t\t\t// Effect v4: `timeoutOrElse` (not `timeoutFail`). The\n\t\t\t// `orElse` branch is the new value (Effect), not just an\n\t\t\t// error constructor — we surface a tagged failure that the\n\t\t\t// downstream `Effect.catch` swallows into `null`.\n\t\t\tEffect.timeoutOrElse({\n\t\t\t\tduration: `${METADATA_FETCH_TIMEOUT_MS} millis`,\n\t\t\t\torElse: () => Effect.fail({ _tag: 'rpc' as const, cause: 'timeout' }),\n\t\t\t}),\n\t\t\tEffect.retry(METADATA_RETRY_SCHEDULE),\n\t\t\tEffect.catch((err): Effect.Effect<unknown> => {\n\t\t\t\treturn Effect.logWarning('coin metadata fetch failed; soft-degrading to null').pipe(\n\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t[SpanAttr.coinType]: fullCoinType,\n\t\t\t\t\t\t[SpanAttr.errorCause]: stringifyCause(err.cause),\n\t\t\t\t\t}),\n\t\t\t\t\tEffect.as(null),\n\t\t\t\t);\n\t\t\t}),\n\t\t);\n\t\tif (raw === null || raw === undefined) return null;\n\t\treturn yield* decodeUnknown(OnchainCoinMetadataShape, raw, {\n\t\t\tsource: 'coin metadata RPC response',\n\t\t\tmkError: (issue) => issue,\n\t\t}).pipe(\n\t\t\tEffect.catch((issue) =>\n\t\t\t\tEffect.logWarning(\n\t\t\t\t\t'coin metadata response had non-conforming shape; degrading to null',\n\t\t\t\t).pipe(\n\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t[SpanAttr.coinType]: fullCoinType,\n\t\t\t\t\t\t[SpanAttr.errorCause]: stringifyCause(issue.cause ?? issue),\n\t\t\t\t\t}),\n\t\t\t\t\tEffect.as(null as OnchainCoinMetadata | null),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t}).pipe(Effect.withSpan('coin.metadata.fetch', { attributes: { fullCoinType } }));\n\n/** Batch-fetch with cache. Each fullCoinType is asked at most once\n *  per Layer-invocation. The fetches run concurrently — distilled-doc\n *  opportunity (\"Coin discovery is naturally batchable\"). */\nexport const fetchCoinMetadataMany = (\n\tsdk: MetadataSdkShim,\n\tfullCoinTypes: ReadonlyArray<string>,\n\tcache: CoinMetadataCache,\n): Effect.Effect<ReadonlyMap<string, OnchainCoinMetadata | null>> =>\n\tEffect.gen(function* () {\n\t\tconst result = new Map<string, OnchainCoinMetadata | null>();\n\t\tyield* Effect.forEach(\n\t\t\tfullCoinTypes,\n\t\t\t(fullCoinType) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst cached = yield* cache.get(fullCoinType);\n\t\t\t\t\tif (cached !== undefined) {\n\t\t\t\t\t\tresult.set(fullCoinType, cached);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst fetched = yield* fetchCoinMetadataOnce(sdk, fullCoinType);\n\t\t\t\t\tyield* cache.put(fullCoinType, fetched);\n\t\t\t\t\tresult.set(fullCoinType, fetched);\n\t\t\t\t}),\n\t\t\t{ concurrency: 'unbounded' },\n\t\t);\n\t\treturn result;\n\t});\n\n/** Bare-coin-type heuristic — distilled-doc 13-coin.md Invariant 3.\n *\n *  MUST agree with what `getCoinMetadata` accepts as a coin-type\n *  argument: `0xHEX::module::Witness`. Anything else (symbol, witness\n *  alone) falls through to the registry path. */\nexport const isBareCoinType = (s: string): boolean => {\n\tif (!s.startsWith('0x')) return false;\n\tif (!s.includes('::')) return false;\n\tif (s.split('::').length !== 3) return false;\n\t// Distilled-doc invariant 7: nested generics rejected at the\n\t// bare-string boundary too. The check fires before the RPC so\n\t// callers see a typed error rather than a downstream decode\n\t// failure.\n\tif (s.includes('<') || s.includes('>')) return false;\n\treturn true;\n};\n\n/** Project a coin-type validation failure to `CoinError`. Surfaces\n *  the nested-generic case at the user-facing factory boundary. */\nexport const validateBareCoinType = (identifier: string): CoinError | null => {\n\tif (identifier.includes('<') || identifier.includes('>')) {\n\t\treturn coinError('nested-generic', {\n\t\t\tidentifier,\n\t\t\tmessage: `coin('${identifier}'): nested generics not supported.`,\n\t\t});\n\t}\n\treturn null;\n};\n\nconst stringifyCause = (cause: unknown): string => {\n\tif (cause instanceof Error) return cause.message;\n\tif (typeof cause === 'string') return cause;\n\ttry {\n\t\treturn JSON.stringify(cause);\n\t} catch {\n\t\treturn String(cause);\n\t}\n};\n"],"mappings":";;;;;;;AAuBA,MAAa,4BAA4B;;;AAIzC,MAAa,0BAA0B,wBAAwB,KAAK,EAAE;;;;;;;;;;;;AAatE,MAAa,2BAA2B,OAAO,OAAO;CACrD,IAAI,OAAO;CACX,UAAU,OAAO;CACjB,MAAM,OAAO;CACb,QAAQ,OAAO;CACf,aAAa,OAAO,SAAS,OAAO,OAAO;CAC3C,SAAS,OAAO,SAAS,OAAO,OAAO;CACvC,CAAC;;;;;;;;AAwCF,MAAa,yBACZ,KACA,iBAEA,OAAO,IAAI,aAAa;CACvB,MAAM,MAAe,OAAO,OAAO,WAAW;EAC7C,WAAW,IAAI,KAAK,gBAAgB,EAAE,UAAU,cAAc,CAAC;EAC/D,QAAQ,WAA8D;GACrE,MAAM;GACN;GACA;EACD,CAAC,CAAC,KAKF,OAAO,cAAc;EACpB,UAAU,GAAG,0BAA0B;EACvC,cAAc,OAAO,KAAK;GAAE,MAAM;GAAgB,OAAO;GAAW,CAAC;EACrE,CAAC,EACF,OAAO,MAAM,wBAAwB,EACrC,OAAO,OAAO,QAAgC;AAC7C,SAAO,OAAO,WAAW,qDAAqD,CAAC,KAC9E,OAAO,aAAa;IAClB,SAAS,WAAW;IACpB,SAAS,aAAa,eAAe,IAAI,MAAM;GAChD,CAAC,EACF,OAAO,GAAG,KAAK,CACf;GACA,CACF;AACD,KAAI,QAAQ,QAAQ,QAAQ,KAAA,EAAW,QAAO;AAC9C,QAAO,OAAO,cAAc,0BAA0B,KAAK;EAC1D,QAAQ;EACR,UAAU,UAAU;EACpB,CAAC,CAAC,KACF,OAAO,OAAO,UACb,OAAO,WACN,qEACA,CAAC,KACD,OAAO,aAAa;GAClB,SAAS,WAAW;GACpB,SAAS,aAAa,eAAe,MAAM,SAAS,MAAM;EAC3D,CAAC,EACF,OAAO,GAAG,KAAmC,CAC7C,CACD,CACD;EACA,CAAC,KAAK,OAAO,SAAS,uBAAuB,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;;;;;;AAmClF,MAAa,kBAAkB,MAAuB;AACrD,KAAI,CAAC,EAAE,WAAW,KAAK,CAAE,QAAO;AAChC,KAAI,CAAC,EAAE,SAAS,KAAK,CAAE,QAAO;AAC9B,KAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAG,QAAO;AAKvC,KAAI,EAAE,SAAS,IAAI,IAAI,EAAE,SAAS,IAAI,CAAE,QAAO;AAC/C,QAAO;;;;AAKR,MAAa,wBAAwB,eAAyC;AAC7E,KAAI,WAAW,SAAS,IAAI,IAAI,WAAW,SAAS,IAAI,CACvD,QAAO,UAAU,kBAAkB;EAClC;EACA,SAAS,SAAS,WAAW;EAC7B,CAAC;AAEH,QAAO;;AAGR,MAAM,kBAAkB,UAA2B;AAClD,KAAI,iBAAiB,MAAO,QAAO,MAAM;AACzC,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI;AACH,SAAO,KAAK,UAAU,MAAM;SACrB;AACP,SAAO,OAAO,MAAM"}
+{"version":3,"file":"metadata.mjs","names":[],"sources":["../../../src/plugins/coin/metadata.ts"],"sourcesContent":["// CoinMetadata fetch + soft-degradation.\n//\n// Distilled-doc 13-coin.md Invariant 8: `getCoinMetadata` failures\n// degrade, do not throw. A timeout or RPC error after one retry\n// returns `null` (logged as a warning); the discovery pipeline keeps\n// going. The next supervisor cycle picks the missing record up.\n//\n// Per-attempt timeout 5s, ONE retry at 250ms backoff (matches the v3\n// `RETRY_SCHEDULE` exactly — distilled-doc 13-coin.md §Configuration).\n//\n// In-process per-Layer-invocation cache keyed by fullCoinType. The\n// fullCoinType folds the packageId, so a fresh chain (new genesis)\n// means new packageIds, which means the cache misses naturally —\n// persistence across restart is unnecessary.\n\nimport { Effect, Ref, Schema } from 'effect';\n\nimport { decodeUnknown } from '../../substrate/runtime/runtime-decode.ts';\nimport { SpanAttr } from '../../substrate/runtime/observability/spans.ts';\nimport { makeSpacedRetrySchedule } from '../../substrate/runtime/retry-policy.ts';\nimport { formatUnknownError } from '../../substrate/runtime/format-unknown-error.ts';\nimport { coinError, type CoinError } from './errors.ts';\nimport { CoinSpans } from './spans.ts';\n\n/** Per-attempt timeout (5 seconds) — distilled-doc invariant. */\nexport const METADATA_FETCH_TIMEOUT_MS = 5_000;\n\n/** Retry schedule — ONE retry at 250ms backoff. Matches the v3\n *  `RETRY_SCHEDULE` (250ms spaced, bounded to one retry). */\nexport const METADATA_RETRY_SCHEDULE = makeSpacedRetrySchedule(250, 1);\n\n/** On-chain CoinMetadata projection — narrowed to the columns the\n *  registry needs. The SDK's full shape carries more (description,\n *  raw bytes); we don't.\n *\n *  IMPORTANT (chain-probe schema constraint from the last sweep):\n *  this Schema MUST NOT depend on any services. `Schema.Schema<T>` is\n *  parameterized `<Type, Encoded, R, RD>`; we constrain `R` and `RD`\n *  to `never` via `Schema.Codec<T, unknown, never, never>` at the\n *  consumer boundary, but the schema literal itself uses ONLY\n *  service-free combinators (`Schema.String`, `Schema.Number`,\n *  `Schema.optional`). */\nexport const OnchainCoinMetadataShape = Schema.Struct({\n\tid: Schema.String,\n\tdecimals: Schema.Number,\n\tname: Schema.String,\n\tsymbol: Schema.String,\n\tdescription: Schema.optional(Schema.String),\n\ticonUrl: Schema.optional(Schema.String),\n});\n\nexport type OnchainCoinMetadata = typeof OnchainCoinMetadataShape.Type;\n\n/** SDK shim — the surface the discovery pass calls. The Sui plugin's\n *  resolved client exposes this via `sdk.core.getCoinMetadata`. Kept\n *  narrow (no `@mysten/sui` type import) so this module stays\n *  layering-neutral; the consumer hands in the resolved client. */\nexport interface MetadataSdkShim {\n\treadonly core: {\n\t\treadonly getCoinMetadata: (args: { readonly coinType: string }) => Promise<unknown>;\n\t};\n}\n\n/** Per-Layer-invocation cache. `null` means \"we tried and the RPC\n *  said the coin had no CoinMetadata\"; `undefined` means \"we haven't\n *  asked yet\". */\nexport interface CoinMetadataCache {\n\treadonly get: (fullCoinType: string) => Effect.Effect<OnchainCoinMetadata | null | undefined>;\n\treadonly put: (fullCoinType: string, value: OnchainCoinMetadata | null) => Effect.Effect<void>;\n}\n\n/** Build an empty cache. */\nexport const makeCoinMetadataCache = (): Effect.Effect<CoinMetadataCache> =>\n\tEffect.gen(function* () {\n\t\tconst ref = yield* Ref.make<Record<string, OnchainCoinMetadata | null>>({});\n\t\treturn {\n\t\t\tget: (fullCoinType) =>\n\t\t\t\tRef.get(ref).pipe(Effect.map((m) => (fullCoinType in m ? m[fullCoinType] : undefined))),\n\t\t\tput: (fullCoinType, value) => Ref.update(ref, (m) => ({ ...m, [fullCoinType]: value })),\n\t\t};\n\t});\n\n/** Fetch CoinMetadata for one coin type. Soft-degrades on RPC\n *  failure / timeout: returns `null` after the retry budget is\n *  exhausted, AND logs a warning.\n *\n *  Distilled-doc 13-coin.md Invariant 8: this is intentional. The\n *  publish-discovery pass must not fail the whole supervisor cycle on\n *  a flaky RPC blip. */\nexport const fetchCoinMetadataOnce = (\n\tsdk: MetadataSdkShim,\n\tfullCoinType: string,\n): Effect.Effect<OnchainCoinMetadata | null> =>\n\tEffect.gen(function* () {\n\t\tconst raw: unknown = yield* Effect.tryPromise({\n\t\t\ttry: () => sdk.core.getCoinMetadata({ coinType: fullCoinType }),\n\t\t\tcatch: (cause): { readonly _tag: 'rpc'; readonly cause: unknown } => ({\n\t\t\t\t_tag: 'rpc',\n\t\t\t\tcause,\n\t\t\t}),\n\t\t}).pipe(\n\t\t\t// Effect v4: `timeoutOrElse` (not `timeoutFail`). The\n\t\t\t// `orElse` branch is the new value (Effect), not just an\n\t\t\t// error constructor — we surface a tagged failure that the\n\t\t\t// downstream `Effect.catch` swallows into `null`.\n\t\t\tEffect.timeoutOrElse({\n\t\t\t\tduration: `${METADATA_FETCH_TIMEOUT_MS} millis`,\n\t\t\t\torElse: () => Effect.fail({ _tag: 'rpc' as const, cause: 'timeout' }),\n\t\t\t}),\n\t\t\tEffect.retry(METADATA_RETRY_SCHEDULE),\n\t\t\tEffect.catch((err): Effect.Effect<unknown> => {\n\t\t\t\treturn Effect.logWarning('coin metadata fetch failed; soft-degrading to null').pipe(\n\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t[CoinSpans.type]: fullCoinType,\n\t\t\t\t\t\t[SpanAttr.errorCause]: formatUnknownError(err.cause),\n\t\t\t\t\t}),\n\t\t\t\t\tEffect.as(null),\n\t\t\t\t);\n\t\t\t}),\n\t\t);\n\t\tif (raw === null || raw === undefined) return null;\n\t\treturn yield* decodeUnknown(OnchainCoinMetadataShape, raw, {\n\t\t\tsource: 'coin metadata RPC response',\n\t\t\tmkError: (issue) => issue,\n\t\t}).pipe(\n\t\t\tEffect.catch((issue) =>\n\t\t\t\tEffect.logWarning(\n\t\t\t\t\t'coin metadata response had non-conforming shape; degrading to null',\n\t\t\t\t).pipe(\n\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t[CoinSpans.type]: fullCoinType,\n\t\t\t\t\t\t[SpanAttr.errorCause]: formatUnknownError(issue.cause ?? issue),\n\t\t\t\t\t}),\n\t\t\t\t\tEffect.as(null as OnchainCoinMetadata | null),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.coin.metadata.fetch', {\n\t\t\tattributes: { [CoinSpans.metadata.fullCoinType]: fullCoinType },\n\t\t}),\n\t);\n\n/** Batch-fetch with cache. Each fullCoinType is asked at most once\n *  per Layer-invocation. The fetches run concurrently — distilled-doc\n *  opportunity (\"Coin discovery is naturally batchable\"). */\nexport const fetchCoinMetadataMany = (\n\tsdk: MetadataSdkShim,\n\tfullCoinTypes: ReadonlyArray<string>,\n\tcache: CoinMetadataCache,\n): Effect.Effect<ReadonlyMap<string, OnchainCoinMetadata | null>> =>\n\tEffect.gen(function* () {\n\t\tconst result = new Map<string, OnchainCoinMetadata | null>();\n\t\tyield* Effect.forEach(\n\t\t\tfullCoinTypes,\n\t\t\t(fullCoinType) =>\n\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\tconst cached = yield* cache.get(fullCoinType);\n\t\t\t\t\tif (cached !== undefined) {\n\t\t\t\t\t\tresult.set(fullCoinType, cached);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tconst fetched = yield* fetchCoinMetadataOnce(sdk, fullCoinType);\n\t\t\t\t\tyield* cache.put(fullCoinType, fetched);\n\t\t\t\t\tresult.set(fullCoinType, fetched);\n\t\t\t\t}),\n\t\t\t{ concurrency: 'unbounded' },\n\t\t);\n\t\treturn result;\n\t});\n\n/** Bare-coin-type heuristic — distilled-doc 13-coin.md Invariant 3.\n *\n *  MUST agree with what `getCoinMetadata` accepts as a coin-type\n *  argument: `0xHEX::module::Witness`. Anything else (symbol, witness\n *  alone) falls through to the registry path. */\nexport const isBareCoinType = (s: string): boolean => {\n\tif (!s.startsWith('0x')) return false;\n\tif (!s.includes('::')) return false;\n\tif (s.split('::').length !== 3) return false;\n\t// Distilled-doc invariant 7: nested generics rejected at the\n\t// bare-string boundary too. The check fires before the RPC so\n\t// callers see a typed error rather than a downstream decode\n\t// failure.\n\tif (s.includes('<') || s.includes('>')) return false;\n\treturn true;\n};\n\n/** Project a coin-type validation failure to `CoinError`. Surfaces\n *  the nested-generic case at the user-facing factory boundary. */\nexport const validateBareCoinType = (identifier: string): CoinError | null => {\n\tif (identifier.includes('<') || identifier.includes('>')) {\n\t\treturn coinError('nested-generic', {\n\t\t\tidentifier,\n\t\t\tmessage: `coin('${identifier}'): nested generics not supported.`,\n\t\t});\n\t}\n\treturn null;\n};\n"],"mappings":";;;;;;;;;AAyBA,MAAa,4BAA4B;;;AAIzC,MAAa,0BAA0B,wBAAwB,KAAK,EAAE;;;;;;;;;;;;AAatE,MAAa,2BAA2B,OAAO,OAAO;CACrD,IAAI,OAAO;CACX,UAAU,OAAO;CACjB,MAAM,OAAO;CACb,QAAQ,OAAO;CACf,aAAa,OAAO,SAAS,OAAO,OAAO;CAC3C,SAAS,OAAO,SAAS,OAAO,OAAO;CACvC,CAAC;;;;;;;;AAwCF,MAAa,yBACZ,KACA,iBAEA,OAAO,IAAI,aAAa;CACvB,MAAM,MAAe,OAAO,OAAO,WAAW;EAC7C,WAAW,IAAI,KAAK,gBAAgB,EAAE,UAAU,cAAc,CAAC;EAC/D,QAAQ,WAA8D;GACrE,MAAM;GACN;GACA;EACD,CAAC,CAAC,KAKF,OAAO,cAAc;EACpB,UAAU,GAAG,0BAA0B;EACvC,cAAc,OAAO,KAAK;GAAE,MAAM;GAAgB,OAAO;GAAW,CAAC;EACrE,CAAC,EACF,OAAO,MAAM,wBAAwB,EACrC,OAAO,OAAO,QAAgC;AAC7C,SAAO,OAAO,WAAW,qDAAqD,CAAC,KAC9E,OAAO,aAAa;IAClB,UAAU,OAAO;IACjB,SAAS,aAAa,mBAAmB,IAAI,MAAM;GACpD,CAAC,EACF,OAAO,GAAG,KAAK,CACf;GACA,CACF;AACD,KAAI,QAAQ,QAAQ,QAAQ,KAAA,EAAW,QAAO;AAC9C,QAAO,OAAO,cAAc,0BAA0B,KAAK;EAC1D,QAAQ;EACR,UAAU,UAAU;EACpB,CAAC,CAAC,KACF,OAAO,OAAO,UACb,OAAO,WACN,qEACA,CAAC,KACD,OAAO,aAAa;GAClB,UAAU,OAAO;GACjB,SAAS,aAAa,mBAAmB,MAAM,SAAS,MAAM;EAC/D,CAAC,EACF,OAAO,GAAG,KAAmC,CAC7C,CACD,CACD;EACA,CAAC,KACF,OAAO,SAAS,uCAAuC,EACtD,YAAY,GAAG,UAAU,SAAS,eAAe,cAAc,EAC/D,CAAC,CACF;;;;;;AAmCF,MAAa,kBAAkB,MAAuB;AACrD,KAAI,CAAC,EAAE,WAAW,KAAK,CAAE,QAAO;AAChC,KAAI,CAAC,EAAE,SAAS,KAAK,CAAE,QAAO;AAC9B,KAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAG,QAAO;AAKvC,KAAI,EAAE,SAAS,IAAI,IAAI,EAAE,SAAS,IAAI,CAAE,QAAO;AAC/C,QAAO;;;;AAKR,MAAa,wBAAwB,eAAyC;AAC7E,KAAI,WAAW,SAAS,IAAI,IAAI,WAAW,SAAS,IAAI,CACvD,QAAO,UAAU,kBAAkB;EAClC;EACA,SAAS,SAAS,WAAW;EAC7B,CAAC;AAEH,QAAO"}

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

@@ -2,14 +2,34 @@ import { Effect, Schema, Scope } from "effect";
 
 //#region src/plugins/coin/mint.d.ts
 /** Sign+execute surface narrowed from `AccountValue.signAndExecute`.
- *  We don't import `AccountValue` directly to avoid a layering cycle —
- *  the Account plugin imports nothing from coin, so coin re-publishes
- *  the structural shape. */
-interface MintTransactionSigner {
-  readonly signAndExecute: (tx: Uint8Array) => Effect.Effect<{
+ *  Mirrors the SDK's discriminated `TransactionResult` return shape —
+ *  on-chain failures are a return variant (`$kind: 'FailedTransaction'`),
+ *  not an error.
+ *
+ *  Modelled as a proper $kind-discriminated union (not both-optional
+ *  fields) so consumers do not need non-null assertions after the
+ *  `result.$kind === 'FailedTransaction'` narrow. We don't import
+ *  `SignAndExecuteResult` from the Account plugin barrel directly
+ *  because the success transaction shape consumed here is narrower
+ *  (only `digest` + `objectChanges`) than the Account plugin's
+ *  `TxResult` (which adds `effects` + `balanceChanges` — fields the
+ *  mint produce body does not surface). The shape is structurally
+ *  compatible — Account's `signAndExecute` widens to this surface. */
+type MintSignAndExecuteResult = {
+  readonly $kind: 'Transaction';
+  readonly Transaction: {
     readonly digest: string;
     readonly objectChanges: ReadonlyArray<unknown>;
-  }, {
+  };
+} | {
+  readonly $kind: 'FailedTransaction';
+  readonly FailedTransaction: {
+    readonly digest: string;
+    readonly executionError?: string;
+  };
+};
+interface MintTransactionSigner {
+  readonly signAndExecute: (tx: Uint8Array) => Effect.Effect<MintSignAndExecuteResult, {
     readonly _tag: 'AccountSignError';
     readonly message: string;
   }>;
@@ -19,11 +39,10 @@ interface MintSigner extends MintTransactionSigner {
   readonly withTransactionSigner: <A, E, R>(body: (signer: MintTransactionSigner) => Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
 }
 interface MintResult {
-  /** Tx digest of the producing mint. `null` on the verify-hit path:
-   *  the artifact publisher's cache-hit verify returns the decoded probe shape
-   *  (which doesn't carry the digest); callers that need the digest
-   *  on cache hit consult the artifact publisher cache directly. */
-  readonly digest: string | null;
+  /** Tx digest of the producing mint. Surfaces the cached digest on
+   *  verify-hit (the substrate hands back the decoded `CachedMint`
+   *  payload, which carries it). */
+  readonly digest: string;
   readonly mintedCoinId: string;
   readonly recipient: string;
   readonly amount: bigint;

package/dist/plugins/coin/mint.mjs

@@ -1,7 +1,15 @@
-import { decodeUnknown } from "../../substrate/runtime/runtime-decode.mjs";
 import { contentHash } from "../../substrate/brand.mjs";
+import { decodeUnknown } from "../../substrate/runtime/runtime-decode.mjs";
 import { isSuiFrameworkObjectForCoin } from "./type-strings.mjs";
+import { formatUnknownError } from "../../substrate/runtime/format-unknown-error.mjs";
+import { signAndDispatch } from "../../substrate/runtime/sui-execute/sign-and-dispatch.mjs";
+import { formatExecutedFailure } from "../../substrate/runtime/sui-execute/index.mjs";
+import { buildForkImpersonationTransactionBytes } from "../sui/fork-transaction.mjs";
+import "../sui/index.mjs";
+import { artifactPublishError } from "../../primitives/artifact-publisher.mjs";
 import { coinError } from "./errors.mjs";
+import { CoinSpans } from "./spans.mjs";
+import { acquireOnChainArtifact } from "../internal/acquire-on-chain-artifact.mjs";
 import { Effect, Schema } from "effect";
 import { Transaction } from "@mysten/sui/transactions";
 //#region src/plugins/coin/mint.ts
@@ -14,10 +22,17 @@ const MintedCoinVerifyShape = Schema.Struct({
 });
 /** 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()}`);
+*  `coin/mint/<chainId>/<treasuryCapId>/<signerAddress>/<recipient>/<amount>`.
+*  The substrate's artifact publisher folds in chainId via the
+*  `chain` parameter; we fold the remaining columns into `contentHash`.
+*
+*  `signerAddress` is folded in because the producing signer is part
+*  of the cache identity — reusing the same `(treasuryCap, recipient,
+*  amount)` under a different signer MUST miss the cache so the new
+*  signer actually re-executes the mint. Mirrors the symmetric
+*  `publisherAddress` fold in `plugins/package/mode-local.ts:149-152`.
+*  Backlog #6. */
+const buildMintContentHash = (parts) => contentHash(`mint/${parts.treasuryCapId}/${parts.signerAddress}/${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).
@@ -72,87 +87,76 @@ const isCreatedObjectChange = (raw) => {
 *  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. */
+*  The substrate's `publish` returns the `CachedMint` payload on every
+*  path (decoded cached payload on verify-hit, fresh produce on miss);
+*  we project it directly to `MintResult`. */
 const performMint = (publisher, chain, signer, sdk, inputs) => Effect.gen(function* () {
-	const cacheHash = buildMintContentHash(inputs);
-	const verified = yield* publisher.publish({
+	const cached = yield* acquireOnChainArtifact(publisher, {
 		namespace: "coin-mint",
 		chain,
-		contentHash: cacheHash,
-		verifySchema: MintedCoinVerifyShape,
+		contentHash: buildMintContentHash({
+			treasuryCapId: inputs.treasuryCapId,
+			recipient: inputs.recipient,
+			amount: inputs.amount,
+			signerAddress: signer.address
+		}),
 		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()
+				[CoinSpans.mint.recipient]: inputs.recipient,
+				[CoinSpans.mint.fullCoinType]: inputs.fullCoinType,
+				[CoinSpans.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
+			return yield* signAndDispatch({
+				signerSource: signer,
+				buildTxBytes: () => 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)
+						]
+					});
+					return sdk.forkMode === true ? yield* buildForkImpersonationTransactionBytes(tx, signer.address, sdk.core).pipe(Effect.mapError((cause) => artifactPublishError("produce-failed", `coin.mint(${inputs.fullCoinType}): fork Transaction.build failed — ${cause.message}`))) : yield* Effect.tryPromise({
+						try: () => tx.build({ client: sdk.client }),
+						catch: (cause) => artifactPublishError("produce-failed", `coin.mint(${inputs.fullCoinType}): Transaction.build failed — ${formatUnknownError(cause)}`)
+					});
+				}),
+				mapSignError: (cause) => artifactPublishError("produce-failed", `coin.mint(${inputs.fullCoinType}): signAndExecute failed — ` + cause.message),
+				onFailed: (failed) => Effect.fail(artifactPublishError("produce-failed", `coin.mint(${inputs.fullCoinType}): transaction execution failed on-chain ` + formatExecutedFailure(failed))),
+				onSuccess: (ok) => Effect.gen(function* () {
+					const mintedCoinId = pickCreatedCoin(ok.objectChanges, inputs.fullCoinType);
+					if (mintedCoinId === null) return yield* Effect.fail(artifactPublishError("produce-failed", `coin.mint(${inputs.fullCoinType}): minted Coin<T> not found in objectChanges (digest=${ok.digest}). ` + mintParseError(inputs.fullCoinType, "minted Coin<T> absent in objectChanges").message));
+					yield* Effect.annotateCurrentSpan({
+						[CoinSpans.mint.digest]: ok.digest,
+						[CoinSpans.mint.mintedCoinId]: mintedCoinId
+					});
+					return {
+						digest: ok.digest,
+						mintedCoinId,
+						recipient: inputs.recipient,
+						amount: inputs.amount.toString()
+					};
+				})
 			});
-			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,
+		digest: cached.digest,
+		mintedCoinId: cached.mintedCoinId,
+		recipient: cached.recipient,
+		amount: BigInt(cached.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()
+}).pipe(Effect.withSpan("devstack.plugin.coin.mint", { attributes: {
+	[CoinSpans.mint.recipient]: inputs.recipient,
+	[CoinSpans.mint.fullCoinType]: inputs.fullCoinType,
+	[CoinSpans.mint.amount]: inputs.amount.toString()
 } }));
 const mintParseError = (fullCoinType, message) => coinError("mint-parse", {
 	identifier: fullCoinType,

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

@@ -1 +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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"}
+{"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 {\n\tartifactPublishError,\n\ttype ArtifactPublishError,\n\ttype ArtifactPublisher,\n} from '../../primitives/artifact-publisher.ts';\nimport { acquireOnChainArtifact } from '../internal/acquire-on-chain-artifact.ts';\nimport { formatUnknownError } from '../../substrate/runtime/format-unknown-error.ts';\nimport { formatExecutedFailure } from '../../substrate/runtime/sui-execute/index.ts';\nimport { signAndDispatch } from '../../substrate/runtime/sui-execute/sign-and-dispatch.ts';\nimport {\n\tbuildForkImpersonationTransactionBytes,\n\ttype ClientWithCoreApi,\n\ttype ForkImpersonationGasClient,\n} from '../sui/index.ts';\nimport { coinError, type CoinError } from './errors.ts';\nimport { CoinSpans } from './spans.ts';\nimport { isSuiFrameworkObjectForCoin } from './type-strings.ts';\n\n/** Sign+execute surface narrowed from `AccountValue.signAndExecute`.\n *  Mirrors the SDK's discriminated `TransactionResult` return shape —\n *  on-chain failures are a return variant (`$kind: 'FailedTransaction'`),\n *  not an error.\n *\n *  Modelled as a proper $kind-discriminated union (not both-optional\n *  fields) so consumers do not need non-null assertions after the\n *  `result.$kind === 'FailedTransaction'` narrow. We don't import\n *  `SignAndExecuteResult` from the Account plugin barrel directly\n *  because the success transaction shape consumed here is narrower\n *  (only `digest` + `objectChanges`) than the Account plugin's\n *  `TxResult` (which adds `effects` + `balanceChanges` — fields the\n *  mint produce body does not surface). The shape is structurally\n *  compatible — Account's `signAndExecute` widens to this surface. */\nexport type MintSignAndExecuteResult =\n\t| {\n\t\t\treadonly $kind: 'Transaction';\n\t\t\treadonly Transaction: {\n\t\t\t\treadonly digest: string;\n\t\t\t\treadonly objectChanges: ReadonlyArray<unknown>;\n\t\t\t};\n\t  }\n\t| {\n\t\t\treadonly $kind: 'FailedTransaction';\n\t\t\treadonly FailedTransaction: {\n\t\t\t\treadonly digest: string;\n\t\t\t\treadonly executionError?: string;\n\t\t\t};\n\t  };\n\nexport interface MintTransactionSigner {\n\treadonly signAndExecute: (\n\t\ttx: Uint8Array,\n\t) => Effect.Effect<\n\t\tMintSignAndExecuteResult,\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>/<signerAddress>/<recipient>/<amount>`.\n *  The substrate's artifact publisher folds in chainId via the\n *  `chain` parameter; we fold the remaining columns into `contentHash`.\n *\n *  `signerAddress` is folded in because the producing signer is part\n *  of the cache identity — reusing the same `(treasuryCap, recipient,\n *  amount)` under a different signer MUST miss the cache so the new\n *  signer actually re-executes the mint. Mirrors the symmetric\n *  `publisherAddress` fold in `plugins/package/mode-local.ts:149-152`.\n *  Backlog #6. */\nexport const buildMintContentHash = (parts: {\n\treadonly treasuryCapId: string;\n\treadonly recipient: string;\n\treadonly amount: bigint;\n\treadonly signerAddress: string;\n}): ContentHash =>\n\tbrandContentHash(\n\t\t`mint/${parts.treasuryCapId}/${parts.signerAddress}/${parts.recipient}/${parts.amount.toString()}`,\n\t);\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. Surfaces the cached digest on\n\t *  verify-hit (the substrate hands back the decoded `CachedMint`\n\t *  payload, which carries it). */\n\treadonly digest: string;\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 *  The `core.getObject` field is the verify-probe surface; the\n *  `client` field is the build-target the produce body hands to\n *  `Transaction.build({ client })`. */\nexport interface MintSdkShim {\n\treadonly core: {\n\t\treadonly getObject: (args: { readonly objectId: string }) => Promise<unknown>;\n\t\t/** Coin selection for the fork-mode offline build (gas + input\n\t\t *  resolution). Reuses the fork impersonation gas client's paginating\n\t\t *  signature so `sdk.core` satisfies it exactly — selection walks the\n\t\t *  coin set via `cursor`/`hasNextPage`, not a single page. */\n\t\treadonly listCoins: ForkImpersonationGasClient['listCoins'];\n\t};\n\t/** Client reference for `Transaction.build({ client })`. The Sui\n\t *  barrel hands in the resolved `SuiGrpcClient`. */\n\treadonly client: ClientWithCoreApi;\n\t/** Fork mode — build offline with explicit gas (the sui-fork binary has\n\t *  no `simulate_transaction` for the SDK's gas-estimating `tx.build`). */\n\treadonly forkMode?: boolean;\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 *  The substrate's `publish` returns the `CachedMint` payload on every\n *  path (decoded cached payload on verify-hit, fresh produce on miss);\n *  we project it directly to `MintResult`. */\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({\n\t\t\ttreasuryCapId: inputs.treasuryCapId,\n\t\t\trecipient: inputs.recipient,\n\t\t\tamount: inputs.amount,\n\t\t\tsignerAddress: signer.address,\n\t\t});\n\n\t\tconst cached: CachedMint = yield* acquireOnChainArtifact<\n\t\t\tCachedMint,\n\t\t\ttypeof MintedCoinVerifyShape.Type\n\t\t>(publisher, {\n\t\t\tnamespace: 'coin-mint',\n\t\t\tchain,\n\t\t\tcontentHash: cacheHash,\n\t\t\t// Verify probe runs on cache hit. The artifact publisher threads the\n\t\t\t// cached payload through to its internal probe — our\n\t\t\t// closure here just hands back a \"null = miss\" signal\n\t\t\t// when the cached id has vanished on chain.\n\t\t\t//\n\t\t\t// The artifact publisher substrate now threads the decoded\n\t\t\t// `CachedMint` into `verify(cached)`; we pull\n\t\t\t// `mintedCoinId` off it and probe the chain. Lenient\n\t\t\t// mode masks transient + not-found → null → substrate\n\t\t\t// re-mints rather than carry a stale digest forward.\n\t\t\tverify: (cached) => buildVerifyProbe(sdk, cached.mintedCoinId),\n\t\t\tproduce: Effect.gen(function* () {\n\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t[CoinSpans.mint.recipient]: inputs.recipient,\n\t\t\t\t\t[CoinSpans.mint.fullCoinType]: inputs.fullCoinType,\n\t\t\t\t\t[CoinSpans.mint.amount]: inputs.amount.toString(),\n\t\t\t\t});\n\n\t\t\t\t// Drive build → sign → execute → dispatch via the shared\n\t\t\t\t// `signAndDispatch` helper. On-chain `FailedTransaction`\n\t\t\t\t// is a return value (not an error) — surfaced as a\n\t\t\t\t// `produce-failed` artifact error so the cache treats\n\t\t\t\t// this as a re-run candidate. Successful dispatch\n\t\t\t\t// projects to the cached payload.\n\t\t\t\treturn yield* signAndDispatch({\n\t\t\t\t\tsignerSource: signer,\n\t\t\t\t\tbuildTxBytes: () =>\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\t\t\t\t\t\t\t// 2. Serialize the tx to BCS bytes while the account lease is\n\t\t\t\t\t\t\t//    held. Fork mode must build offline with explicit gas (the\n\t\t\t\t\t\t\t//    sui-fork binary has no simulate_transaction); other modes\n\t\t\t\t\t\t\t//    use the SDK resolver, which fills gas + object versions.\n\t\t\t\t\t\t\treturn sdk.forkMode === true\n\t\t\t\t\t\t\t\t? yield* buildForkImpersonationTransactionBytes(\n\t\t\t\t\t\t\t\t\t\ttx,\n\t\t\t\t\t\t\t\t\t\tsigner.address,\n\t\t\t\t\t\t\t\t\t\tsdk.core,\n\t\t\t\t\t\t\t\t\t).pipe(\n\t\t\t\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t\t\t\t(cause): ArtifactPublishError =>\n\t\t\t\t\t\t\t\t\t\t\t\tartifactPublishError(\n\t\t\t\t\t\t\t\t\t\t\t\t\t'produce-failed',\n\t\t\t\t\t\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): fork Transaction.build failed — ${cause.message}`,\n\t\t\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t: yield* Effect.tryPromise({\n\t\t\t\t\t\t\t\t\t\ttry: () => tx.build({ client: sdk.client }),\n\t\t\t\t\t\t\t\t\t\tcatch: (cause): ArtifactPublishError =>\n\t\t\t\t\t\t\t\t\t\t\tartifactPublishError(\n\t\t\t\t\t\t\t\t\t\t\t\t'produce-failed',\n\t\t\t\t\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): Transaction.build failed — ${formatUnknownError(cause)}`,\n\t\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}),\n\t\t\t\t\t// 3. Sign + execute via the Account-supplied signer. Map\n\t\t\t\t\t//    `AccountSignError` → `ArtifactPublishError`. The\n\t\t\t\t\t//    Account plugin's signer handles waitForTransaction internally.\n\t\t\t\t\tmapSignError: (cause): ArtifactPublishError =>\n\t\t\t\t\t\tartifactPublishError(\n\t\t\t\t\t\t\t'produce-failed',\n\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): signAndExecute failed — ` + cause.message,\n\t\t\t\t\t\t),\n\t\t\t\t\t// 4a. On-chain failure dispatch.\n\t\t\t\t\tonFailed: (failed) =>\n\t\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\t\tartifactPublishError(\n\t\t\t\t\t\t\t\t'produce-failed',\n\t\t\t\t\t\t\t\t`coin.mint(${inputs.fullCoinType}): transaction execution failed on-chain ` +\n\t\t\t\t\t\t\t\t\tformatExecutedFailure(failed),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t),\n\t\t\t\t\t// 4b. On success, 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\tonSuccess: (ok) =>\n\t\t\t\t\t\tEffect.gen(function* () {\n\t\t\t\t\t\t\tconst mintedCoinId = pickCreatedCoin(ok.objectChanges, inputs.fullCoinType);\n\t\t\t\t\t\t\tif (mintedCoinId === null) {\n\t\t\t\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\t\t\t\tartifactPublishError(\n\t\t\t\t\t\t\t\t\t\t'produce-failed',\n\t\t\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\t\t\t`objectChanges (digest=${ok.digest}). ` +\n\t\t\t\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\t\t\t.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\n\t\t\t\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t\t\t\t[CoinSpans.mint.digest]: ok.digest,\n\t\t\t\t\t\t\t\t[CoinSpans.mint.mintedCoinId]: mintedCoinId,\n\t\t\t\t\t\t\t});\n\n\t\t\t\t\t\t\t// 5. Return the cached payload. The artifact publisher caches it under\n\t\t\t\t\t\t\t//    the content hash; the next cycle's verify probe (on\n\t\t\t\t\t\t\t//    cache hit) will lenient-probe `mintedCoinId`.\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tdigest: ok.digest,\n\t\t\t\t\t\t\t\tmintedCoinId,\n\t\t\t\t\t\t\t\trecipient: inputs.recipient,\n\t\t\t\t\t\t\t\tamount: inputs.amount.toString(),\n\t\t\t\t\t\t\t} satisfies CachedMint;\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\t\t\t}),\n\t\t});\n\n\t\t// Project the cached payload to MintResult. The substrate\n\t\t// hands back the decoded `CachedMint` on every path.\n\t\treturn {\n\t\t\tdigest: cached.digest,\n\t\t\tmintedCoinId: cached.mintedCoinId,\n\t\t\trecipient: cached.recipient,\n\t\t\tamount: BigInt(cached.amount),\n\t\t\tfullCoinType: inputs.fullCoinType,\n\t\t};\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.coin.mint', {\n\t\t\tattributes: {\n\t\t\t\t[CoinSpans.mint.recipient]: inputs.recipient,\n\t\t\t\t[CoinSpans.mint.fullCoinType]: inputs.fullCoinType,\n\t\t\t\t[CoinSpans.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.mjs

@@ -1,4 +1,5 @@
 import { defineScopedRefMap } from "../../substrate/runtime/scoped-ref-map/service.mjs";
+import "../../substrate/runtime/scoped-ref-map/index.mjs";
 import { Context, Effect, Layer } from "effect";
 //#region src/plugins/coin/registry.ts
 const coinKey = (fullCoinType) => fullCoinType;
@@ -18,20 +19,16 @@ const wrapRefMap = (refMap) => ({
 });
 /** 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") {};
+var CoinRegistryService = class extends Context.Service()("@devstack/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 layerCoinRegistry = 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 };
+export { CoinRegistryService, layerCoinRegistry };
 
 //# sourceMappingURL=registry.mjs.map

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

@@ -1 +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"}
+{"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/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 layerCoinRegistry: 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"],"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,sCACA,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"}

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

@@ -31,10 +31,48 @@ interface CoinValue extends ResolvedCoin {
     readonly amount: bigint;
     readonly treasuryCapId?: string;
   }) => Effect.Effect<MintResult, CoinError | ArtifactPublishError, Scope.Scope>;
+  /** Self-contained mint that needs NO external signer — present
+   *  exactly when `fundingStrategy` is (witness-form coins whose
+   *  publisher still owns the TreasuryCap). Captures the publisher
+   *  `MintSigner` + the resolved `treasuryCapId` internally and returns
+   *  the full `MintResult` (digest + minted-coin id), unlike
+   *  `fundingStrategy.request` which discards the result.
+   *
+   *  This is the seam the control-plane dashboard mint ACTION drives:
+   *  the supervisor reads the resolved `CoinValue` and calls this with
+   *  `{to, amount}` — no signer threading needed, because the
+   *  treasury-cap-owning publisher signer is already in-process here
+   *  (the same lease-owning path `fundingStrategy` uses). The Effect is
+   *  self-scoping (wraps `Effect.scoped` over the artifact-publisher
+   *  round), so callers run it directly without a surrounding Scope. */
+  readonly mintFromCap?: (opts: {
+    readonly to: string;
+    readonly amount: bigint;
+  }) => Effect.Effect<MintResult, CoinError | ArtifactPublishError>;
   /** 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. */
+   *  can mint arbitrary local coins without bespoke example actions.
+   *
+   *  The request shape is a NARROWED projection of
+   *  `AccountFundingRequest` (`{address, amount}` only — the coin
+   *  strategy doesn't need the resolved account handle since the
+   *  TreasuryCap-owning publisher signs the mint via its own lease
+   *  inside `mint → signAndDispatch`). Direct consumers (deepbook
+   *  seed funding) call `.request({address, amount})` against this
+   *  narrowed shape; the coin barrel projects the value to the wider
+   *  `AccountFundingStrategy` cross-plugin contract at the
+   *  `strategy-contributor` capability boundary (see
+   *  `coin/index.ts → buildCapabilities`), wrapping the narrow
+   *  request fn so the account bus's `{address, amount, account}`
+   *  shape is satisfied honestly at the boundary.
+   *
+   *  The E channel preserves the tagged vocabulary
+   *  (`CoinError | ArtifactPublishError`) rather than collapsing to
+   *  `unknown`, so direct consumers can catchTag on the typed
+   *  errors. The account-side dispatcher's registry lookup narrows
+   *  the channel to `unknown` at the registry boundary and reads
+   *  `_tag` defensively. */
   readonly fundingStrategy?: {
     readonly request: (req: {
       readonly address: string;

package/dist/plugins/coin/service.mjs

@@ -1,11 +1,12 @@
 import { coinError } from "./errors.mjs";
+import { CoinSpans } from "./spans.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 });
+	yield* Effect.annotateCurrentSpan({ [CoinSpans.form]: form.kind });
 	const resolved = yield* (() => {
 		switch (form.kind) {
 			case "witness": return resolveByWitness(ctx.registry, form.publishingPackageName, form.witness);
@@ -14,9 +15,9 @@ const acquireCoin = (form, ctx) => Effect.gen(function* () {
 		}
 	})();
 	yield* Effect.annotateCurrentSpan({
-		"coin.fullCoinType": resolved.fullCoinType,
-		"coin.decimals": resolved.decimals,
-		"coin.source": resolved.source
+		[CoinSpans.fullCoinType]: resolved.fullCoinType,
+		[CoinSpans.decimals]: resolved.decimals,
+		[CoinSpans.source]: resolved.source
 	});
 	const mint = (signer, opts) => {
 		const capId = opts.treasuryCapId ?? resolved.treasuryCapId;
@@ -34,6 +35,11 @@ const acquireCoin = (form, ctx) => Effect.gen(function* () {
 	};
 	const fundingSigner = form.kind === "witness" ? form.fundingSigner : void 0;
 	const fundingTreasuryCapId = resolved.treasuryCapId;
+	const mintFromCap = fundingSigner !== void 0 && fundingTreasuryCapId !== void 0 ? (opts) => Effect.scoped(mint(fundingSigner, {
+		to: opts.to,
+		amount: opts.amount,
+		treasuryCapId: fundingTreasuryCapId
+	})) : void 0;
 	const fundingStrategy = fundingSigner !== void 0 && fundingTreasuryCapId !== void 0 ? { request: (req) => Effect.scoped(mint(fundingSigner, {
 		to: req.address,
 		amount: req.amount,
@@ -42,6 +48,7 @@ const acquireCoin = (form, ctx) => Effect.gen(function* () {
 	return {
 		...resolved,
 		mint,
+		...mintFromCap === void 0 ? {} : { mintFromCap },
 		...fundingStrategy === void 0 ? {} : { fundingStrategy }
 	};
 });