@mysten-incubation/devstack 0.0.1 → 0.1.1

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

@@ -1 +1 @@
-{"version":3,"file":"service.mjs","names":["brandContentHash"],"sources":["../../../src/plugins/action/service.ts"],"sourcesContent":["// Action plugin — main acquire body.\n//\n// Architecture (16-action.md): an action is a ONE-SHOT on-chain effect\n// that runs once per (chain × content-hash), caches its receipt, and\n// re-fires when its discriminator changes (or the chain regenesises).\n//\n// Implementation: thin wrapper over `ArtifactPublisher`. The\n// substrate handles the cache → verify → produce → register cycle; this\n// file composes the spec:\n//\n//   - namespace      = `action`\n//   - chain          = Sui dependency's resolved `chain`\n//   - contentHash    = hash of (actionName, upstreamResourceIds[], dynamic\n//                      discriminator if any)\n//   - verifySchema   = `ActionReceiptSchema` — Schema-validated cached\n//                      shape so a corrupt entry surfaces as a miss\n//   - verify         = `chainProbe.get({kind:'transaction', digest},\n//                      VerifyTxShape, 'lenient')` — null on transient\n//                      or not-found, NOT raise.\n//   - produce        = user's `body(ctx)` Effect. Wraps any non-tagged\n//                      throw in `ActionError({phase:'sign'})`.\n//   - register       = no-op (Action declares no in-process registry —\n//                      mirrors v3 `services/action.ts:189-191` \"Action\n//                      does NOT populate any in-process registries\").\n//\n// Constraints honored:\n//\n//   - Cache key folds (name, chainId, dependency resource ids, discriminator?) —\n//     16-action.md invariant #1.\n//   - Dynamic discriminator re-runs on EVERY acquire — invariant #6.\n//   - Lenient verify probe — invariant #4.\n//   - signAndExecute failure routes via ActionError(phase: 'sign') —\n//     invariant #8 (mirroring v3's `PublishError({phase:'publish-tx'})`,\n//     but tagged separately so action consumers `catchTag('ActionError')`\n//     without clashing with package's tagged error).\n\nimport { createHash } from 'node:crypto';\n\nimport { Effect, Schema, type Scope } from 'effect';\n\nimport { contentHash as brandContentHash, type ChainId } from '../../substrate/brand.ts';\nimport type {\n\tArtifactPublishError,\n\tArtifactPublisher,\n} from '../../primitives/artifact-publisher.ts';\nimport type { ChainProbe } from '../../contracts/chain-probe.ts';\nimport type { SuiProbeKey } from '../sui/chain-probe.ts';\nimport type { ActionBuildContext } from './build-context.ts';\nimport { actionError, type ActionError } from './errors.ts';\nimport {\n\tcomposeDiscriminatorMaterial,\n\ttype DynamicDiscriminator,\n\ttype StaticDiscriminator,\n} from './discriminator.ts';\n\n/** Action receipt — the cached value. Minimal shape: digest is the\n *  load-bearing identifier (drives verify probe + downstream\n *  consumers); the change arrays are surfaced opaquely (typed\n *  `unknown` here so the cache schema stays narrow) but the in-memory\n *  shape produced by the `ctx.signAndExecute` helper is\n *  `ActionObjectChange` (`{ kind: 'created' | 'mutated', objectId,\n *  objectType?, outputState?, idOperation? }`). Consumers can cast or\n *  use `findCreatedByType`-style helpers — mirrors v3's\n *  `pickCreatedByType(r.objectChanges, ...)` pattern from\n *  `examples/connect-four/devstack.config.ts`.\n *\n *  Distilled doc §\"Capabilities PRODUCED\" — the v3 Action's `TxResult`\n *  carries `digest`, `effects`, `objectChanges`, `balanceChanges`. We\n *  narrow to the columns that fit the cache + are actually used by\n *  downstream consumers. */\nexport interface ActionReceipt {\n\treadonly digest: string;\n\treadonly objectChanges?: ReadonlyArray<unknown>;\n\treadonly balanceChanges?: ReadonlyArray<unknown>;\n}\n\n/** Schema for the cached `ActionReceipt`. `objectChanges` /\n *  `balanceChanges` are `Unknown`-typed arrays — we don't enforce the\n *  SDK's wide change-shape here because callers project these\n *  manually (mirrors v3's `pickCreatedByType(r.objectChanges, ...)`\n *  pattern from `examples/connect-four/devstack.config.ts`). */\nexport const ActionReceiptSchema = Schema.Struct({\n\tdigest: Schema.String,\n\tobjectChanges: Schema.optional(Schema.Array(Schema.Unknown)),\n\tbalanceChanges: Schema.optional(Schema.Array(Schema.Unknown)),\n});\n\n/** Verify-probe shape — what `getTransaction(digest)` returns on\n *  success. We don't decode the full transaction envelope; presence\n *  of the digest field is the \"exists\" signal. The lenient probe\n *  already coerces transient + not-found to null. */\nconst VerifyTxShape = Schema.Struct({\n\tdigest: Schema.String,\n});\n\n/** Per-acquire inputs handed to `bootActionService`. The dynamic\n *  discriminator is pre-resolved by `index.ts` — at this layer the\n *  `staticDiscriminator` + optional `dynamicMaterial` string suffice. */\nexport interface ActionAcquireInputs {\n\treadonly actionName: string;\n\treadonly chainId: ChainId;\n\treadonly staticDiscriminator: StaticDiscriminator;\n\t/** Resolved dynamic-discriminator material — already projected to\n\t *  a string at acquire-time by `index.ts` (the callback form\n\t *  receives the `ActionBuildContext` there). */\n\treadonly dynamicMaterial: Effect.Effect<string | undefined, ActionError>;\n\t/** The user's body Effect. Receives no parameter — it closes over\n\t *  upstream-tag values via the outer `acquire` scope. Returns the\n\t *  receipt of the on-chain effect; the plugin caches this. */\n\treadonly body: Effect.Effect<ActionReceipt, ActionError, Scope.Scope>;\n}\n\n/** Resolve a `DynamicDiscriminator` against the action's\n *  action context and resolved dependency values. Two input shapes\n *  (per `DynamicDiscriminator`) collapse onto\n *  `Effect<string | undefined, ActionError>`. */\nexport const resolveDiscriminator = <Deps>(\n\tactionName: string,\n\tdynamic: DynamicDiscriminator<Deps> | undefined,\n\tctx: ActionBuildContext,\n\tdeps: Deps,\n): Effect.Effect<string | undefined, ActionError> => {\n\tif (dynamic === undefined) return Effect.succeed(undefined);\n\tif (typeof dynamic === 'string') return Effect.succeed(dynamic);\n\treturn dynamic(ctx, deps).pipe(\n\t\tEffect.catch(\n\t\t\t(cause): Effect.Effect<string, ActionError> =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\t// If the user's discriminator Effect itself raises an\n\t\t\t\t\t// ActionError, surface it verbatim. Otherwise wrap.\n\t\t\t\t\t(cause as ActionError)._tag === 'ActionError'\n\t\t\t\t\t\t? (cause as ActionError)\n\t\t\t\t\t\t: actionError('discriminator', {\n\t\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\t\tmessage: `Action '${actionName}': discriminator Effect failed.`,\n\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t}),\n\t\t\t\t),\n\t\t),\n\t);\n};\n\n/** Build the verify-probe Effect for a given cached digest. Lenient\n *  mode coerces transient + not-found to null; the substrate then\n *  re-produces on null. */\nconst buildVerifyProbe = (\n\tprobe: ChainProbe<SuiProbeKey>,\n\tcachedDigest: string,\n): Effect.Effect<typeof VerifyTxShape.Type | null, never> =>\n\tprobe.get({ kind: 'transaction', digest: cachedDigest }, VerifyTxShape, 'lenient').pipe(\n\t\t// `decode-failed` on verify is stale shape — null so the\n\t\t// substrate re-fires rather than carry forward a mismatch.\n\t\tEffect.catch(() => Effect.succeed(null as typeof VerifyTxShape.Type | null)),\n\t);\n\n/** Main acquire body. Composes the ArtifactSpec for the action\n *  and yields it to the publisher.\n *\n *  Returns the cached/produced `ActionReceipt`. Errors flow as\n *  `ActionError | ArtifactPublishError` — the latter when the substrate\n *  itself surfaces a produce-failure wrap. */\nexport const bootActionService = (\n\tpublisher: ArtifactPublisher,\n\tprobe: ChainProbe<SuiProbeKey>,\n\tinputs: ActionAcquireInputs,\n): Effect.Effect<ActionReceipt, ActionError | ArtifactPublishError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t'action.name': inputs.actionName,\n\t\t\t'action.chain': inputs.chainId,\n\t\t});\n\n\t\t// --- Pull the pre-projected dynamic-discriminator material\n\t\t// (every acquire — hit OR miss). The callback form's\n\t\t// `(ctx) => Effect<string>` is invoked by `index.ts` before\n\t\t// reaching here, so this layer sees only the resolved Effect.\n\t\tconst resolvedDynamic = yield* inputs.dynamicMaterial;\n\n\t\t// --- Compose content-hash inputs\n\t\tconst material = composeDiscriminatorMaterial(inputs.staticDiscriminator, resolvedDynamic);\n\t\tconst inputsHash = brandContentHash(createHash('sha256').update(material).digest('hex'));\n\n\t\t// --- Submit the spec to the publisher.\n\t\t//\n\t\t// The artifact publisher substrate decodes the cached `ActionReceipt` and\n\t\t// passes it into `verify(cached)` — so the verify Effect can\n\t\t// pull the digest off the cached payload directly. No\n\t\t// in-process registry-hop required (mirrors the seam pattern\n\t\t// the package plugin's mode-local TODO calls out).\n\t\tconst produced = yield* publisher.publish<ActionReceipt, typeof VerifyTxShape.Type>({\n\t\t\tnamespace: 'action',\n\t\t\tchain: inputs.chainId,\n\t\t\tcontentHash: inputsHash,\n\t\t\tverifySchema: VerifyTxShape,\n\t\t\tverify: (cached) => buildVerifyProbe(probe, cached.digest),\n\t\t\tproduce: Effect.gen(function* () {\n\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t'action.phase': 'building',\n\t\t\t\t});\n\t\t\t\tconst receipt: ActionReceipt = yield* inputs.body.pipe(\n\t\t\t\t\tEffect.catch(\n\t\t\t\t\t\t(cause): Effect.Effect<ActionReceipt, ActionError> =>\n\t\t\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\t\t\t(cause as ActionError)?._tag === 'ActionError'\n\t\t\t\t\t\t\t\t\t? (cause as ActionError)\n\t\t\t\t\t\t\t\t\t: actionError('sign', {\n\t\t\t\t\t\t\t\t\t\t\tactionName: inputs.actionName,\n\t\t\t\t\t\t\t\t\t\t\tmessage: `Action '${inputs.actionName}': body Effect failed.`,\n\t\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t\t'action.phase': 'parsing',\n\t\t\t\t\t'action.digest': receipt.digest,\n\t\t\t\t});\n\t\t\t\treturn receipt;\n\t\t\t}).pipe(\n\t\t\t\tEffect.mapError(\n\t\t\t\t\t(err): ArtifactPublishError => ({\n\t\t\t\t\t\t_tag: 'ArtifactPublishError',\n\t\t\t\t\t\treason: 'produce-failed',\n\t\t\t\t\t\tdetail: `action.${inputs.actionName} ${err.phase}: ${err.message}`,\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t),\n\t\t\tregister: (_artifact) =>\n\t\t\t\t// Action declares no in-process registry (mirrors v3's\n\t\t\t\t// `services/action.ts:189-191` \"Action does NOT populate\n\t\t\t\t// any in-process registries\"). The cached digest is now\n\t\t\t\t// threaded directly via the artifact publisher's `verify(cached)`\n\t\t\t\t// parameter — no register-hop hint required.\n\t\t\t\tEffect.void,\n\t\t});\n\n\t\t// The publisher returns `Produced | Verified`. Both shapes\n\t\t// carry `digest`; the action's resolved value is the cached\n\t\t// receipt (full `ActionReceipt` on produce/decoded-hit, or a\n\t\t// projected `{digest}` on bare-verify-hit). Callers expect the\n\t\t// wider shape — surface defensively.\n\t\tif ('digest' in produced && typeof produced.digest === 'string') {\n\t\t\t// Already-`ActionReceipt`-shaped. Cast through to recover\n\t\t\t// the optional change arrays if present.\n\t\t\treturn produced as ActionReceipt;\n\t\t}\n\t\t// Defensive: unreachable under the current substrate (verify\n\t\t// returns the bare `{digest}` shape; the substrate falls back\n\t\t// to it ONLY when the cached payload failed to decode, which\n\t\t// we treat as miss elsewhere). Surface a parse-phase error.\n\t\treturn yield* Effect.fail(\n\t\t\tactionError('parse', {\n\t\t\t\tactionName: inputs.actionName,\n\t\t\t\tmessage: `Action '${inputs.actionName}': cached payload missing digest.`,\n\t\t\t}),\n\t\t);\n\t});\n"],"mappings":";;;;;AAiFmC,OAAO,OAAO;CAChD,QAAQ,OAAO;CACf,eAAe,OAAO,SAAS,OAAO,MAAM,OAAO,QAAQ,CAAC;CAC5D,gBAAgB,OAAO,SAAS,OAAO,MAAM,OAAO,QAAQ,CAAC;CAC7D,CAAC;;;;;AAMF,MAAM,gBAAgB,OAAO,OAAO,EACnC,QAAQ,OAAO,QACf,CAAC;;;;;AAuBF,MAAa,wBACZ,YACA,SACA,KACA,SACoD;AACpD,KAAI,YAAY,KAAA,EAAW,QAAO,OAAO,QAAQ,KAAA,EAAU;AAC3D,KAAI,OAAO,YAAY,SAAU,QAAO,OAAO,QAAQ,QAAQ;AAC/D,QAAO,QAAQ,KAAK,KAAK,CAAC,KACzB,OAAO,OACL,UACA,OAAO,KAGL,MAAsB,SAAS,gBAC5B,QACD,YAAY,iBAAiB;EAC7B;EACA,SAAS,WAAW,WAAW;EAC/B;EACA,CAAC,CACJ,CACF,CACD;;;;;AAMF,MAAM,oBACL,OACA,iBAEA,MAAM,IAAI;CAAE,MAAM;CAAe,QAAQ;CAAc,EAAE,eAAe,UAAU,CAAC,KAGlF,OAAO,YAAY,OAAO,QAAQ,KAAyC,CAAC,CAC5E;;;;;;;AAQF,MAAa,qBACZ,WACA,OACA,WAEA,OAAO,IAAI,aAAa;AACvB,QAAO,OAAO,oBAAoB;EACjC,eAAe,OAAO;EACtB,gBAAgB,OAAO;EACvB,CAAC;CAMF,MAAM,kBAAkB,OAAO,OAAO;CAGtC,MAAM,WAAW,6BAA6B,OAAO,qBAAqB,gBAAgB;CAC1F,MAAM,aAAaA,YAAiB,WAAW,SAAS,CAAC,OAAO,SAAS,CAAC,OAAO,MAAM,CAAC;CASxF,MAAM,WAAW,OAAO,UAAU,QAAkD;EACnF,WAAW;EACX,OAAO,OAAO;EACd,aAAa;EACb,cAAc;EACd,SAAS,WAAW,iBAAiB,OAAO,OAAO,OAAO;EAC1D,SAAS,OAAO,IAAI,aAAa;AAChC,UAAO,OAAO,oBAAoB,EACjC,gBAAgB,YAChB,CAAC;GACF,MAAM,UAAyB,OAAO,OAAO,KAAK,KACjD,OAAO,OACL,UACA,OAAO,KACL,OAAuB,SAAS,gBAC7B,QACD,YAAY,QAAQ;IACpB,YAAY,OAAO;IACnB,SAAS,WAAW,OAAO,WAAW;IACtC;IACA,CAAC,CACJ,CACF,CACD;AACD,UAAO,OAAO,oBAAoB;IACjC,gBAAgB;IAChB,iBAAiB,QAAQ;IACzB,CAAC;AACF,UAAO;IACN,CAAC,KACF,OAAO,UACL,SAA+B;GAC/B,MAAM;GACN,QAAQ;GACR,QAAQ,UAAU,OAAO,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI;GACzD,EACD,CACD;EACD,WAAW,cAMV,OAAO;EACR,CAAC;AAOF,KAAI,YAAY,YAAY,OAAO,SAAS,WAAW,SAGtD,QAAO;AAMR,QAAO,OAAO,OAAO,KACpB,YAAY,SAAS;EACpB,YAAY,OAAO;EACnB,SAAS,WAAW,OAAO,WAAW;EACtC,CAAC,CACF;EACA"}
+{"version":3,"file":"service.mjs","names":["brandContentHash"],"sources":["../../../src/plugins/action/service.ts"],"sourcesContent":["// Action plugin — main acquire body.\n//\n// Architecture (16-action.md): an action is a ONE-SHOT on-chain effect\n// that runs once per (chain × content-hash), caches its receipt, and\n// re-fires when its discriminator changes (or the chain regenesises).\n//\n// Implementation: thin wrapper over `ArtifactPublisher`. The\n// substrate handles the cache → verify → produce → register cycle; this\n// file composes the spec:\n//\n//   - namespace      = `action`\n//   - chain          = Sui dependency's resolved `chain`\n//   - contentHash    = hash of (actionName, upstreamResourceIds[], dynamic\n//                      discriminator if any)\n//   - verify         = `chainProbe.get({kind:'transaction', digest},\n//                      VerifyTxShape, 'lenient')` — null on transient\n//                      or not-found, NOT raise.\n//   - produce        = user's `body(ctx)` Effect. Wraps any non-tagged\n//                      throw in `ActionError({phase:'sign'})`.\n//   - register       = no-op (Action declares no in-process registry —\n//                      mirrors v3 `services/action.ts:189-191` \"Action\n//                      does NOT populate any in-process registries\").\n//\n// Constraints honored:\n//\n//   - Cache key folds (name, chainId, dependency resource ids, discriminator?) —\n//     16-action.md invariant #1.\n//   - Dynamic discriminator re-runs on EVERY acquire — invariant #6.\n//   - Lenient verify probe — invariant #4.\n//   - signAndExecute failure routes via ActionError(phase: 'sign') —\n//     invariant #8 (mirroring v3's `PublishError({phase:'publish-tx'})`,\n//     but tagged separately so action consumers `catchTag('ActionError')`\n//     without clashing with package's tagged error).\n\nimport { createHash } from 'node:crypto';\n\nimport { Cause, Effect, Schema, type Scope } from 'effect';\n\nimport { contentHash as brandContentHash, type ChainId } from '../../substrate/brand.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 { withPhasePreservingProduce } from '../../substrate/runtime/phase-preserving-produce.ts';\nimport type { ChainProbe } from '../../contracts/chain-probe.ts';\nimport type { SuiProbeKey } from '../sui/index.ts';\nimport type { ActionBuildContext } from './build-context.ts';\nimport { actionError, type ActionError } from './errors.ts';\nimport {\n\tcomposeDiscriminatorMaterial,\n\ttype DynamicDiscriminator,\n\ttype StaticDiscriminator,\n} from './discriminator.ts';\nimport { ActionSpans } from './spans.ts';\n\n/** Action receipt — the cached value. Minimal shape: digest is the\n *  load-bearing identifier (drives verify probe + downstream\n *  consumers); the change arrays are surfaced opaquely (typed\n *  `unknown` here so the cache schema stays narrow) but the in-memory\n *  shape produced by the `ctx.signAndExecute` helper is\n *  `ActionObjectChange` (`{ kind: 'created' | 'mutated', objectId,\n *  objectType?, outputState?, idOperation? }`). Consumers can cast or\n *  use `findCreatedByType`-style helpers — mirrors v3's\n *  `pickCreatedByType(r.objectChanges, ...)` pattern from\n *  `examples/connect-four/devstack.config.ts`.\n *\n *  Distilled doc §\"Capabilities PRODUCED\" — the v3 Action's `TxResult`\n *  carries `digest`, `effects`, `objectChanges`, `balanceChanges`. We\n *  narrow to the columns that fit the cache + are actually used by\n *  downstream consumers. */\nexport interface ActionReceipt {\n\treadonly digest: string;\n\treadonly objectChanges?: ReadonlyArray<unknown>;\n\treadonly balanceChanges?: ReadonlyArray<unknown>;\n}\n\n/** Schema for the cached `ActionReceipt`. `objectChanges` /\n *  `balanceChanges` are `Unknown`-typed arrays — we don't enforce the\n *  SDK's wide change-shape here because callers project these\n *  manually (mirrors v3's `pickCreatedByType(r.objectChanges, ...)`\n *  pattern from `examples/connect-four/devstack.config.ts`). */\nexport const ActionReceiptSchema = Schema.Struct({\n\tdigest: Schema.String,\n\tobjectChanges: Schema.optional(Schema.Array(Schema.Unknown)),\n\tbalanceChanges: Schema.optional(Schema.Array(Schema.Unknown)),\n});\n\n/** Verify-probe shape — what `getTransaction(digest)` returns on\n *  success. We don't decode the full transaction envelope; presence\n *  of the digest field is the \"exists\" signal. The lenient probe\n *  already coerces transient + not-found to null. */\nconst VerifyTxShape = Schema.Struct({\n\tdigest: Schema.String,\n});\n\n/** Per-acquire inputs handed to `bootActionService`. The dynamic\n *  discriminator is pre-resolved by `index.ts` — at this layer the\n *  `staticDiscriminator` + optional `dynamicMaterial` string suffice. */\nexport interface ActionAcquireInputs {\n\treadonly actionName: string;\n\treadonly chainId: ChainId;\n\treadonly staticDiscriminator: StaticDiscriminator;\n\t/** Resolved dynamic-discriminator material — already projected to\n\t *  a string at acquire-time by `index.ts` (the callback form\n\t *  receives the `ActionBuildContext` there). */\n\treadonly dynamicMaterial: Effect.Effect<string | undefined, ActionError>;\n\t/** The user's body Effect. Receives no parameter — it closes over\n\t *  upstream-tag values via the outer `acquire` scope. Returns the\n\t *  receipt of the on-chain effect; the plugin caches this. */\n\treadonly body: Effect.Effect<ActionReceipt, ActionError, Scope.Scope>;\n}\n\n/** Resolve a `DynamicDiscriminator` against the action's\n *  action context and resolved dependency values. Two input shapes\n *  (per `DynamicDiscriminator`) collapse onto\n *  `Effect<string | undefined, ActionError>`. */\nexport const resolveDiscriminator = <Deps>(\n\tdynamic: DynamicDiscriminator<Deps> | undefined,\n\tctx: ActionBuildContext,\n\tdeps: Deps,\n): Effect.Effect<string | undefined, ActionError> => {\n\tif (dynamic === undefined) return Effect.succeed(undefined);\n\tif (typeof dynamic === 'string') return Effect.succeed(dynamic);\n\t// The dynamic discriminator's error channel is typed `ActionError`\n\t// (see `DynamicDiscriminator<Deps>` in `discriminator.ts`), so user\n\t// failures already arrive in the tagged shape — no wrap or\n\t// re-projection needed. (Prior code ran `Effect.catch` to fall\n\t// through tag-or-wrap, but the channel is exhaustively\n\t// ActionError; the wrap branch was unreachable.)\n\treturn dynamic(ctx, deps);\n};\n\n/** Build the verify-probe Effect for a given cached digest. Lenient\n *  mode coerces transient + not-found to null; the substrate then\n *  re-produces on null. */\nconst buildVerifyProbe = (\n\tprobe: ChainProbe<SuiProbeKey>,\n\tcachedDigest: string,\n): Effect.Effect<typeof VerifyTxShape.Type | null, never> =>\n\tprobe.get({ kind: 'transaction', digest: cachedDigest }, VerifyTxShape, 'lenient').pipe(\n\t\t// `decode-failed` on verify is stale shape — null so the\n\t\t// substrate re-fires rather than carry forward a mismatch.\n\t\tEffect.catch(() => Effect.succeed(null as typeof VerifyTxShape.Type | null)),\n\t);\n\n/** Main acquire body. Composes the ArtifactSpec for the action\n *  and yields it to the publisher.\n *\n *  Returns the cached/produced `ActionReceipt`. Errors flow as\n *  `ActionError | ArtifactPublishError` — the latter when the substrate\n *  itself surfaces a produce-failure wrap. */\nexport const bootActionService = (\n\tpublisher: ArtifactPublisher,\n\tprobe: ChainProbe<SuiProbeKey>,\n\tinputs: ActionAcquireInputs,\n): Effect.Effect<ActionReceipt, ActionError | ArtifactPublishError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t[ActionSpans.name]: inputs.actionName,\n\t\t\t[ActionSpans.chain]: inputs.chainId,\n\t\t});\n\n\t\t// --- Pull the pre-projected dynamic-discriminator material\n\t\t// (every acquire — hit OR miss). The callback form's\n\t\t// `(ctx) => Effect<string>` is invoked by `index.ts` before\n\t\t// reaching here, so this layer sees only the resolved Effect.\n\t\tconst resolvedDynamic = yield* inputs.dynamicMaterial;\n\n\t\t// --- Compose content-hash inputs\n\t\tconst material = composeDiscriminatorMaterial(inputs.staticDiscriminator, resolvedDynamic);\n\t\tconst inputsHash = brandContentHash(createHash('sha256').update(material).digest('hex'));\n\n\t\t// --- Phase-preserving produce.\n\t\t//\n\t\t// `publisher.publish`'s `produce` channel must surface failures\n\t\t// as `ArtifactPublishError` per the substrate contract. That\n\t\t// erases the original `ActionError.phase`.\n\t\t// `withPhasePreservingProduce` stashes the typed `ActionError`\n\t\t// in a Ref BEFORE the mapError boundary so the outer recovery\n\t\t// (`recoverTypedError`) can re-raise it untouched. The caller in\n\t\t// `index.ts` then sees the original `phase` rather than a\n\t\t// uniformly-stamped `'sign'`.\n\t\tconst typedProduce = Effect.gen(function* () {\n\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t[ActionSpans.phase]: 'building',\n\t\t\t});\n\t\t\t// `inputs.body` is a USER-SUPPLIED Effect. Two failure\n\t\t\t// surfaces must collapse onto a single `ActionError`:\n\t\t\t//\n\t\t\t//   1. Typed `ActionError` on the failure channel —\n\t\t\t//      `catchTag('ActionError')` re-raises untouched so\n\t\t\t//      the original `phase` survives.\n\t\t\t//   2. Defects (sync `throw` inside the body, `die(...)`)\n\t\t\t//      bypass typed catches entirely — `catchCause` is\n\t\t\t//      the only seam that sees them. Defects get\n\t\t\t//      rebadged to `phase: 'sign'` so a user body that\n\t\t\t//      throws lands on the typed channel rather than\n\t\t\t//      crashing the produce step. Interrupt-only causes\n\t\t\t//      propagate untouched so cancellation semantics\n\t\t\t//      survive.\n\t\t\tconst receipt: ActionReceipt = yield* inputs.body.pipe(\n\t\t\t\tEffect.catchCause((cause) => {\n\t\t\t\t\t// 1. Typed `ActionError` on the failure channel —\n\t\t\t\t\t//    re-raise untouched so the original `phase`\n\t\t\t\t\t//    survives the downstream re-wrap step.\n\t\t\t\t\tconst failed = Cause.findError(cause);\n\t\t\t\t\tif (failed._tag === 'Success') {\n\t\t\t\t\t\treturn Effect.fail(failed.success);\n\t\t\t\t\t}\n\t\t\t\t\t// 2. Interrupt-only causes propagate untouched so\n\t\t\t\t\t//    cancellation semantics survive.\n\t\t\t\t\tif (Cause.hasInterruptsOnly(cause)) {\n\t\t\t\t\t\treturn Effect.failCause(cause);\n\t\t\t\t\t}\n\t\t\t\t\t// 3. Defects (sync `throw` inside the body, `die(...)`)\n\t\t\t\t\t//    bypass typed catches entirely — `catchCause` is\n\t\t\t\t\t//    the only seam that sees them. Rebadge to\n\t\t\t\t\t//    `phase: 'sign'` so a user body that throws\n\t\t\t\t\t//    lands on the typed channel rather than crashing\n\t\t\t\t\t//    the produce step.\n\t\t\t\t\tconst defect = Cause.findDefect(cause);\n\t\t\t\t\tconst defectValue =\n\t\t\t\t\t\tdefect._tag === 'Success' ? defect.success : Cause.squash(cause);\n\t\t\t\t\treturn Effect.fail(\n\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\tactionName: inputs.actionName,\n\t\t\t\t\t\t\tmessage: `Action '${inputs.actionName}': body Effect raised a defect.`,\n\t\t\t\t\t\t\tcause: defectValue,\n\t\t\t\t\t\t}),\n\t\t\t\t\t);\n\t\t\t\t}),\n\t\t\t);\n\t\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t\t[ActionSpans.phase]: 'parsing',\n\t\t\t\t[ActionSpans.digest]: receipt.digest,\n\t\t\t});\n\t\t\treturn receipt;\n\t\t});\n\n\t\tconst { wrappedProduce, recoverTypedError } = yield* withPhasePreservingProduce({\n\t\t\tproduce: typedProduce,\n\t\t\twrapProduceError: (err: ActionError): ArtifactPublishError =>\n\t\t\t\tartifactPublishError(\n\t\t\t\t\t'produce-failed',\n\t\t\t\t\t`action.${inputs.actionName} ${err.phase}: ${err.message}`,\n\t\t\t\t),\n\t\t});\n\n\t\t// --- Submit the spec to the publisher.\n\t\t//\n\t\t// The artifact publisher substrate decodes the cached `ActionReceipt` and\n\t\t// passes it into `verify(cached)` — so the verify Effect can\n\t\t// pull the digest off the cached payload directly. No\n\t\t// in-process registry-hop required (mirrors the seam pattern\n\t\t// the package plugin's mode-local TODO calls out).\n\t\tconst receipt: ActionReceipt = yield* acquireOnChainArtifact<\n\t\t\tActionReceipt,\n\t\t\ttypeof VerifyTxShape.Type\n\t\t>(publisher, {\n\t\t\tnamespace: 'action',\n\t\t\tchain: inputs.chainId,\n\t\t\tcontentHash: inputsHash,\n\t\t\tverify: (cached) => buildVerifyProbe(probe, cached.digest),\n\t\t\tproduce: wrappedProduce,\n\t\t}).pipe(recoverTypedError);\n\n\t\t// The substrate hands back the decoded `ActionReceipt` on every\n\t\t// path (decoded cached payload on hit, fresh produce on miss).\n\t\treturn receipt;\n\t}).pipe(\n\t\t// Outer span so the per-action `annotateCurrentSpan` annotations\n\t\t// above attach to a real span instead of dropping silently when\n\t\t// `bootActionService` is invoked outside a parent span.\n\t\tEffect.withSpan('devstack.plugin.action.boot', {\n\t\t\tattributes: {\n\t\t\t\t[ActionSpans.name]: inputs.actionName,\n\t\t\t\t[ActionSpans.chain]: inputs.chainId,\n\t\t\t},\n\t\t}),\n\t);\n"],"mappings":";;;;;;;;;AAmFmC,OAAO,OAAO;CAChD,QAAQ,OAAO;CACf,eAAe,OAAO,SAAS,OAAO,MAAM,OAAO,QAAQ,CAAC;CAC5D,gBAAgB,OAAO,SAAS,OAAO,MAAM,OAAO,QAAQ,CAAC;CAC7D,CAAC;;;;;AAMF,MAAM,gBAAgB,OAAO,OAAO,EACnC,QAAQ,OAAO,QACf,CAAC;;;;;AAuBF,MAAa,wBACZ,SACA,KACA,SACoD;AACpD,KAAI,YAAY,KAAA,EAAW,QAAO,OAAO,QAAQ,KAAA,EAAU;AAC3D,KAAI,OAAO,YAAY,SAAU,QAAO,OAAO,QAAQ,QAAQ;AAO/D,QAAO,QAAQ,KAAK,KAAK;;;;;AAM1B,MAAM,oBACL,OACA,iBAEA,MAAM,IAAI;CAAE,MAAM;CAAe,QAAQ;CAAc,EAAE,eAAe,UAAU,CAAC,KAGlF,OAAO,YAAY,OAAO,QAAQ,KAAyC,CAAC,CAC5E;;;;;;;AAQF,MAAa,qBACZ,WACA,OACA,WAEA,OAAO,IAAI,aAAa;AACvB,QAAO,OAAO,oBAAoB;GAChC,YAAY,OAAO,OAAO;GAC1B,YAAY,QAAQ,OAAO;EAC5B,CAAC;CAMF,MAAM,kBAAkB,OAAO,OAAO;CAGtC,MAAM,WAAW,6BAA6B,OAAO,qBAAqB,gBAAgB;CAC1F,MAAM,aAAaA,YAAiB,WAAW,SAAS,CAAC,OAAO,SAAS,CAAC,OAAO,MAAM,CAAC;CAqExF,MAAM,EAAE,gBAAgB,sBAAsB,OAAO,2BAA2B;EAC/E,SA1DoB,OAAO,IAAI,aAAa;AAC5C,UAAO,OAAO,oBAAoB,GAChC,YAAY,QAAQ,YACrB,CAAC;GAeF,MAAM,UAAyB,OAAO,OAAO,KAAK,KACjD,OAAO,YAAY,UAAU;IAI5B,MAAM,SAAS,MAAM,UAAU,MAAM;AACrC,QAAI,OAAO,SAAS,UACnB,QAAO,OAAO,KAAK,OAAO,QAAQ;AAInC,QAAI,MAAM,kBAAkB,MAAM,CACjC,QAAO,OAAO,UAAU,MAAM;IAQ/B,MAAM,SAAS,MAAM,WAAW,MAAM;IACtC,MAAM,cACL,OAAO,SAAS,YAAY,OAAO,UAAU,MAAM,OAAO,MAAM;AACjE,WAAO,OAAO,KACb,YAAY,QAAQ;KACnB,YAAY,OAAO;KACnB,SAAS,WAAW,OAAO,WAAW;KACtC,OAAO;KACP,CAAC,CACF;KACA,CACF;AACD,UAAO,OAAO,oBAAoB;KAChC,YAAY,QAAQ;KACpB,YAAY,SAAS,QAAQ;IAC9B,CAAC;AACF,UAAO;IAIc;EACrB,mBAAmB,QAClB,qBACC,kBACA,UAAU,OAAO,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI,UACjD;EACF,CAAC;AAsBF,QAAO,OAb+B,uBAGpC,WAAW;EACZ,WAAW;EACX,OAAO,OAAO;EACd,aAAa;EACb,SAAS,WAAW,iBAAiB,OAAO,OAAO,OAAO;EAC1D,SAAS;EACT,CAAC,CAAC,KAAK,kBAAkB;EAKzB,CAAC,KAIF,OAAO,SAAS,+BAA+B,EAC9C,YAAY;EACV,YAAY,OAAO,OAAO;EAC1B,YAAY,QAAQ,OAAO;CAC5B,EACD,CAAC,CACF"}

package/dist/plugins/action/spans.mjs

@@ -0,0 +1,11 @@
+//#region src/plugins/action/spans.ts
+const ActionSpans = {
+	name: "action.name",
+	chain: "action.chain",
+	phase: "action.phase",
+	digest: "action.digest"
+};
+//#endregion
+export { ActionSpans };
+
+//# sourceMappingURL=spans.mjs.map

package/dist/plugins/action/spans.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.mjs","names":[],"sources":["../../../src/plugins/action/spans.ts"],"sourcesContent":["// Action plugin span-attribute vocabulary. Plugin-local — substrate's\n// `SpanAttr` carries only engine-dimensional + http/process generic\n// keys; plugin-domain keys live next to the plugin that owns them.\n//\n// Callsite pattern: `Effect.annotateCurrentSpan({ [ActionSpans.name]:\n// inputs.actionName })`. Free-form string literals are a STYLE_GUIDE §16\n// violation.\n\nexport const ActionSpans = {\n\tname: 'action.name',\n\tchain: 'action.chain',\n\tphase: 'action.phase',\n\tdigest: 'action.digest',\n} as const;\n"],"mappings":";AAQA,MAAa,cAAc;CAC1B,MAAM;CACN,OAAO;CACP,OAAO;CACP,QAAQ;CACR"}

package/dist/plugins/coin/codegen.mjs

@@ -1,19 +1,20 @@
-import { Effect } from "effect";
+import { defineSimpleConstExport } from "../internal/codegen-helpers.mjs";
 //#region src/plugins/coin/codegen.ts
 /** Construct the Codegenable contribution for one coin instance.
 *
 *  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) => ({
-	kind: "codegenable",
+const makeCoinCodegen = (parts) => defineSimpleConstExport({
 	emitterName: `coin/${parts.symbol}`,
 	outputPath: `coins/${parts.symbol}.ts`,
-	sensitive: false,
-	emit: (ctx) => Effect.sync(() => {
-		ctx.exportConst(parts.symbol, parts.resolved);
-		return ctx.done();
-	})
+	exportName: parts.symbol,
+	value: parts.resolved,
+	aggregate: {
+		kind: "coin",
+		bucket: "coins.ts",
+		project: (exported) => exported
+	}
 });
 //#endregion
 export { makeCoinCodegen };

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 { Effect } from 'effect';\n\nimport type { CodegenableDecl } from '../../contracts/codegenable.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\tkind: 'codegenable',\n\temitterName: `coin/${parts.symbol}` as `coin/${Symbol}`,\n\toutputPath: `coins/${parts.symbol}.ts`,\n\tsensitive: false,\n\temit: (ctx) =>\n\t\tEffect.sync(() => {\n\t\t\tctx.exportConst(parts.symbol, parts.resolved);\n\t\t\treturn ctx.done();\n\t\t}),\n});\n"],"mappings":";;;;;;;AA6CA,MAAa,mBAA0C,WAGb;CACzC,MAAM;CACN,aAAa,QAAQ,MAAM;CAC3B,YAAY,SAAS,MAAM,OAAO;CAClC,WAAW;CACX,OAAO,QACN,OAAO,WAAW;AACjB,MAAI,YAAY,MAAM,QAAQ,MAAM,SAAS;AAC7C,SAAO,IAAI,MAAM;GAChB;CACH"}
+{"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"}

package/dist/plugins/coin/discovery.mjs

@@ -29,15 +29,19 @@ const pickNumber = (json, key) => {
 	const value = json[key];
 	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 };
+/** Project the `json` payload of a `created` object change into the
+*  metadata fields the discovery aggregate consumes. Always returns a
+*  `Partial<...>` (never `null`) — an empty object is the natural "no
+*  fields recognised" outcome and lets callers spread unconditionally
+*  without an `??` fallback. */
 const pickMetadata = (change) => {
 	const json = change.json;
-	if (json === null || typeof json !== "object" || Array.isArray(json)) return null;
+	if (json === null || typeof json !== "object" || Array.isArray(json)) return {};
 	const record = json;
 	const decimals = pickNumber(record, "decimals");
 	const symbol = pickString(record, "symbol");
 	const displayName = pickString(record, "name");
 	const iconUrl = pickString(record, "iconUrl") ?? pickString(record, "icon_url");
-	if (decimals === void 0 && symbol === void 0 && displayName === void 0 && iconUrl === void 0) return null;
 	return {
 		...decimals === void 0 ? {} : { decimals },
 		...symbol === void 0 ? {} : { symbol },
@@ -71,14 +75,14 @@ const discoverCoinsFromPublish = (output) => {
 		if (metaInner !== null && change.objectId !== void 0) {
 			metadata.set(metaInner, {
 				id: change.objectId,
-				...pickMetadata(change) ?? {}
+				...pickMetadata(change)
 			});
 			continue;
 		}
 		const currencyInner = pickSuiFrameworkInnerGenericFromModule(change.objectType, "coin_registry", "Currency");
 		if (currencyInner !== null && change.objectId !== void 0) metadata.set(currencyInner, {
 			id: change.objectId,
-			...pickMetadata(change) ?? {}
+			...pickMetadata(change)
 		});
 	}
 	const allTypes = new Set([...caps.keys(), ...metadata.keys()]);

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\nconst pickMetadata = (change: CoinDiscoveryObjectChange): Omit<DiscoveredMetadata, 'id'> | null => {\n\tconst json = change.json;\n\tif (json === null || typeof json !== 'object' || Array.isArray(json)) return null;\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\tif (\n\t\tdecimals === undefined &&\n\t\tsymbol === undefined &&\n\t\tdisplayName === undefined &&\n\t\ticonUrl === undefined\n\t) {\n\t\treturn null;\n\t}\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":";;;AAkEA,MAAM,iBACL,iBACsE;CACtE,MAAM,QAAQ,aAAa,MAAM,KAAK;AACtC,KAAI,MAAM,WAAW,EAAG,QAAO;CAC/B,MAAM,GAAG,YAAY,WAAW;AAChC,KAAI,eAAe,KAAA,KAAa,YAAY,KAAA,EAAW,QAAO;AAC9D,QAAO;EAAE;EAAY;EAAS;;;;;;AAO/B,MAAM,oBAAoB,WAA0D;CACnF,MAAM,QAAQ,OAAO;AAIrB,KAAI,UAAU,KAAA,KAAa,UAAU,KAAM,QAAO,KAAA;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI,OAAO,UAAU,YAAY,kBAAkB,MAClD,QAAO,MAAM;;AAKf,MAAM,cAAc,MAA+B,QAAoC;CACtF,MAAM,QAAQ,KAAK;AACnB,QAAO,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ,KAAA;;AAGhE,MAAM,cAAc,MAA+B,QAAoC;CACtF,MAAM,QAAQ,KAAK;AACnB,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM,GAAG,QAAQ,KAAA;;AAGtE,MAAM,gBAAgB,WAA6E;CAClG,MAAM,OAAO,OAAO;AACpB,KAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,KAAK,CAAE,QAAO;CAC7E,MAAM,SAAS;CACf,MAAM,WAAW,WAAW,QAAQ,WAAW;CAC/C,MAAM,SAAS,WAAW,QAAQ,SAAS;CAC3C,MAAM,cAAc,WAAW,QAAQ,OAAO;CAC9C,MAAM,UAAU,WAAW,QAAQ,UAAU,IAAI,WAAW,QAAQ,WAAW;AAC/E,KACC,aAAa,KAAA,KACb,WAAW,KAAA,KACX,gBAAgB,KAAA,KAChB,YAAY,KAAA,EAEZ,QAAO;AAER,QAAO;EACN,GAAI,aAAa,KAAA,IAAY,EAAE,GAAG,EAAE,UAAU;EAC9C,GAAI,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ;EAC1C,GAAI,gBAAgB,KAAA,IAAY,EAAE,GAAG,EAAE,aAAa;EACpD,GAAI,YAAY,KAAA,IAAY,EAAE,GAAG,EAAE,SAAS;EAC5C;;;;;;;;;AAUF,MAAa,4BACZ,WACmC;CACnC,MAAM,YAAY,OAAO;CAKzB,MAAM,uBAAO,IAAI,KAA0E;CAC3F,MAAM,2BAAW,IAAI,KAAiC;AAEtD,MAAK,MAAM,UAAU,OAAO,eAAe;AAC1C,MAAI,OAAO,SAAS,UAAW;AAC/B,MAAI,CAAC,OAAO,WAAY;EACxB,MAAM,WAAW,6BAA6B,OAAO,YAAY,cAAc;AAC/E,MAAI,aAAa,QAAQ,OAAO,aAAa,KAAA,GAAW;AACvD,QAAK,IAAI,UAAU;IAClB,IAAI,OAAO;IACX,OAAO,iBAAiB,OAAO;IAC/B,CAAC;AACF;;EAED,MAAM,YAAY,6BAA6B,OAAO,YAAY,eAAe;AACjF,MAAI,cAAc,QAAQ,OAAO,aAAa,KAAA,GAAW;AACxD,YAAS,IAAI,WAAW;IACvB,IAAI,OAAO;IACX,GAAI,aAAa,OAAO,IAAI,EAAE;IAC9B,CAAC;AACF;;EAED,MAAM,gBAAgB,uCACrB,OAAO,YACP,iBACA,WACA;AACD,MAAI,kBAAkB,QAAQ,OAAO,aAAa,KAAA,EACjD,UAAS,IAAI,eAAe;GAC3B,IAAI,OAAO;GACX,GAAI,aAAa,OAAO,IAAI,EAAE;GAC9B,CAAC;;CAOJ,MAAM,WAAW,IAAI,IAAY,CAAC,GAAG,KAAK,MAAM,EAAE,GAAG,SAAS,MAAM,CAAC,CAAC;CACtE,MAAM,UAAiC,EAAE;AACzC,MAAK,MAAM,gBAAgB,UAAU;EACpC,MAAM,QAAQ,cAAc,aAAa;AACzC,MAAI,CAAC,MAAO;EACZ,MAAM,MAAM,KAAK,IAAI,aAAa;EAClC,MAAM,OAAO,SAAS,IAAI,aAAa;EACvC,MAAM,mBAAmB,QAAQ,KAAA,KAAa,IAAI,UAAU;AAC5D,UAAQ,KAAK;GACZ;GACA,SAAS,MAAM,QAAQ,aAAa;GACpC,YAAY,MAAM,WAAW,aAAa;GAC1C,eAAe,KAAK;GACpB,kBAAkB,KAAK;GACvB,YAAY,MAAM;GAClB,GAAI,MAAM,aAAa,KAAA,IAAY,EAAE,GAAG,EAAE,UAAU,KAAK,UAAU;GACnE,GAAI,MAAM,WAAW,KAAA,IAAY,EAAE,GAAG,EAAE,QAAQ,KAAK,QAAQ;GAC7D,GAAI,MAAM,gBAAgB,KAAA,IAAY,EAAE,GAAG,EAAE,aAAa,KAAK,aAAa;GAC5E,GAAI,MAAM,YAAY,KAAA,IAAY,EAAE,GAAG,EAAE,SAAS,KAAK,SAAS;GAChE;GACA,CAAC;;AAKH,SAAQ,MAAM,GAAG,MAChB,EAAE,eAAe,EAAE,eAAe,KAAK,EAAE,eAAe,EAAE,eAAe,IAAI,EAC7E;AACD,QAAO"}
+{"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/index.d.mts

@@ -1,10 +1,9 @@
 import { CodegenableDecl } from "../../contracts/codegenable.mjs";
 import { SnapshotableDecl } from "../../contracts/snapshotable.mjs";
-import { StrategyContributorDecl } from "../../contracts/strategy-contributor.mjs";
 import { AnyResourceRef, Plugin, ResourceRef } from "../../substrate/plugin.mjs";
-import { SeedObjectsAccumulator } from "../sui/seed-objects.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 { CoinError, CoinPhase } from "./errors.mjs";
 import { MintResult, MintSigner } from "./mint.mjs";
@@ -16,7 +15,6 @@ import { DiscoveredCoin } from "./discovery.mjs";
 import { Effect } from "effect";
 
 //#region src/plugins/coin/index.d.ts
-type CoinResourceId<Sym extends string> = `coin:${Sym}`;
 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
  *  `localPackage('foo', …)` / `knownPackage('foo', …)` — NOT a bare string
@@ -36,60 +34,44 @@ declare const coin: {
     readonly pkg: Pkg;
     readonly sui: ResourceRef<"sui", SuiClient & {
       readonly mode: SuiOptions["mode"];
-      readonly seedObjects: SeedObjectsAccumulator;
     }>;
   } extends infer T ? T extends {
     readonly pkg: Pkg;
     readonly sui: ResourceRef<"sui", SuiClient & {
       readonly mode: SuiOptions["mode"];
-      readonly seedObjects: SeedObjectsAccumulator;
     }>;
-  } ? T extends Readonly<Record<string, AnyResourceRef>> ? readonly T[keyof T][] : readonly [] : never : never, readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, StrategyContributorDecl<"coin-registry", {
-    readonly symbol: string;
-  }>, ...{
+  } ? 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: {
-      readonly request: (req: {
-        readonly address: string;
-        readonly amount: bigint;
-      }) => Effect.Effect<void, CoinError | ArtifactPublishError>;
+      usesAccountSigner: true;
+      request: (req: AccountFundingRequest<unknown>) => Effect.Effect<void, ArtifactPublishError | CoinError, never>;
     };
     autoMounted: true;
   }[]]>;
   readonly known: <FullType extends string>(fullCoinType: FullType) => Plugin<`coin:${string}`, CoinValue, readonly ResourceRef<"sui", SuiClient & {
     readonly mode: SuiOptions["mode"];
-    readonly seedObjects: SeedObjectsAccumulator;
-  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, StrategyContributorDecl<"coin-registry", {
-    readonly symbol: string;
-  }>, ...{
+  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, ...{
     kind: "strategy-contributor";
     capabilityKey: `coinType:${string}`;
     strategy: {
-      readonly request: (req: {
-        readonly address: string;
-        readonly amount: bigint;
-      }) => Effect.Effect<void, CoinError | ArtifactPublishError>;
+      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 seedObjects: SeedObjectsAccumulator;
-  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, StrategyContributorDecl<"coin-registry", {
-    readonly symbol: string;
-  }>, ...{
+  }>[], readonly [SnapshotableDecl, CodegenableDecl<`coin/${string}`>, ...{
     kind: "strategy-contributor";
     capabilityKey: `coinType:${string}`;
     strategy: {
-      readonly request: (req: {
-        readonly address: string;
-        readonly amount: bigint;
-      }) => Effect.Effect<void, CoinError | ArtifactPublishError>;
+      usesAccountSigner: true;
+      request: (req: AccountFundingRequest<unknown>) => Effect.Effect<void, ArtifactPublishError | CoinError, never>;
     };
     autoMounted: true;
   }[]]>;
 };
 //#endregion
-export { CoinResourceId, PackageMember, coin };
+export { PackageMember, coin };
 //# sourceMappingURL=index.d.mts.map

package/dist/plugins/coin/index.mjs

@@ -1,34 +1,57 @@
 import { definePlugin, resource } from "../../substrate/plugin.mjs";
-import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
-import { suiResource } from "../sui/index.mjs";
+import "../../api/define-plugin.mjs";
 import { ArtifactPublisherService } from "../../substrate/runtime/artifact-publisher/index.mjs";
 import "./discovery.mjs";
-import { COIN_REGISTRY_CAPABILITY_KEY, CoinRegistryService } from "./registry.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 { makeCoinSnapshotable } from "./snapshot.mjs";
 import { COIN_ERROR_TAGS } from "./errors.mjs";
+import "./spans.mjs";
 import "./metadata.mjs";
 import "./address-resolution.mjs";
 import "./mint.mjs";
 import { acquireCoin } from "./service.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. */
 const coinResourceId = (symbol) => `coin:${symbol}`;
-const packageNameFromMember = (pkg) => pkg.id.slice(8);
-const projectCoinSdk = (sui) => {
-	const grpcClient = sui.sdk.client;
-	return {
-		core: {
-			getObject: sui.sdk.core.getObject,
-			getCoinMetadata: (args) => grpcClient.core.getCoinMetadata(args)
-		},
-		client: sui.sdk.client
-	};
+/** Maximum length of the readable prefix in a `coin.known(...)` resource
+*  id. Two long coin types sharing this prefix length would silently
+*  collide in the substrate's compose-time dedup (string equality on
+*  the resource id), so beyond this length we append a short hash of
+*  the full coin type to disambiguate. */
+const COIN_KNOWN_PREFIX_MAX = 60;
+/** Length of the SHA-256 hex suffix appended to long `coin.known(...)`
+*  resource ids. Eight chars (~32 bits) is the same width used by other
+*  collision-disambiguation hashes in the package (e.g. router profile,
+*  fork preimage suffixes). */
+const COIN_KNOWN_HASH_SUFFIX_LEN = 8;
+/** Derive a stable, human-readable, collision-free resource-id segment
+*  for `coin.known(fullCoinType)`. Short types pass through as the
+*  readable `<addr>_<module>_<witness>` form; long types get a hash
+*  suffix so two types sharing a 60-char prefix can coexist. */
+const coinKnownResourceKey = (fullCoinType) => {
+	const readable = fullCoinType.replace(/^0x/, "").replace(/::/g, "_");
+	if (readable.length <= COIN_KNOWN_PREFIX_MAX) return readable;
+	const hash = createHash("sha256").update(fullCoinType).digest("hex").slice(0, COIN_KNOWN_HASH_SUFFIX_LEN);
+	return `${readable.slice(0, COIN_KNOWN_PREFIX_MAX - COIN_KNOWN_HASH_SUFFIX_LEN - 1)}_${hash}`;
 };
+const packageNameFromMember = (pkg) => pkg.id.slice(8);
+const projectCoinSdk = (sui) => ({
+	core: {
+		getObject: sui.sdk.core.getObject,
+		getCoinMetadata: (args) => sui.sdk.client.core.getCoinMetadata(args),
+		listCoins: sui.sdk.core.listCoins
+	},
+	client: sui.sdk.client,
+	forkMode: sui.fork !== null
+});
 const buildCapabilities = (symbol, resolved) => {
 	const bindings = {
 		symbol: resolved.symbol ?? symbol,
@@ -41,22 +64,25 @@ const buildCapabilities = (symbol, resolved) => {
 		...resolved.metadataId !== void 0 ? { metadataId: resolved.metadataId } : {},
 		...resolved.packageId !== void 0 ? { packageId: resolved.packageId } : {}
 	};
+	const snap = makeCoinSnapshotable({ symbol });
+	const codegen = makeCoinCodegen({
+		symbol,
+		resolved: bindings
+	});
+	const narrowStrategy = resolved.fundingStrategy;
 	return [
-		makeCoinSnapshotable({ symbol }),
-		makeCoinCodegen({
-			symbol,
-			resolved: bindings
-		}),
-		{
-			kind: "strategy-contributor",
-			capabilityKey: COIN_REGISTRY_CAPABILITY_KEY,
-			strategy: { symbol },
-			autoMounted: true
-		},
-		...resolved.fundingStrategy === void 0 ? [] : [{
+		snap,
+		codegen,
+		...narrowStrategy === void 0 ? [] : [{
 			kind: "strategy-contributor",
 			capabilityKey: coinFundingCapabilityKey(resolved.fullCoinType),
-			strategy: resolved.fundingStrategy,
+			strategy: {
+				usesAccountSigner: true,
+				request: (req) => narrowStrategy.request({
+					address: req.address,
+					amount: req.amount
+				})
+			},
 			autoMounted: true
 		}]
 	];
@@ -83,6 +109,7 @@ const fromPackage = (pkg, witnessName) => {
 			sui: suiResource
 		},
 		role: "task",
+		section: "action",
 		start: ({ pkg: resolved, sui }) => Effect.gen(function* () {
 			const artifactPublisher = yield* ArtifactPublisherService;
 			const registry = yield* CoinRegistryService;
@@ -110,11 +137,12 @@ const fromPackage = (pkg, witnessName) => {
 *  invariant. Resource id uses a deterministic-but-readable derivation of
 *  the coin type so collisions surface at compose time. */
 const known = (fullCoinType) => {
-	const id = fullCoinType.replace(/^0x/, "").replace(/::/g, "_").slice(0, 60);
+	const id = coinKnownResourceKey(fullCoinType);
 	return definePlugin({
 		id: resource(coinResourceId(id)).id,
 		dependsOn: { sui: suiResource },
 		role: "task",
+		section: "action",
 		start: ({ sui }) => Effect.gen(function* () {
 			const publisher = yield* ArtifactPublisherService;
 			const registry = yield* CoinRegistryService;
@@ -141,6 +169,7 @@ const builtin = (name) => {
 		id: resource(coinResourceId(name)).id,
 		dependsOn: { sui: suiResource },
 		role: "task",
+		section: "action",
 		start: ({ sui }) => Effect.gen(function* () {
 			const publisher = yield* ArtifactPublisherService;
 			const registry = yield* CoinRegistryService;

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 { 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 '../account/funding.ts';\n\nimport { makeCoinCodegen, type CoinBindings } from './codegen.ts';\nimport { makeCoinSnapshotable } from './snapshot.ts';\nimport { COIN_REGISTRY_CAPABILITY_KEY, 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\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` is on the typed `SuiSdkShim`; `getCoinMetadata`\n// lives on the underlying `SuiGrpcClient` reached via the opaque\n// `sui.sdk.client`. We project both onto a single `MetadataSdkShim &\n// MintSdkShim` here at the boundary — the cast mirrors STYLE_GUIDE §14\n// (localized cast through an opaque SDK surface), kept narrow to one\n// method projection.\n\nconst projectCoinSdk = (sui: SuiClient): MetadataSdkShim & MintSdkShim => {\n\tconst grpcClient = sui.sdk.client as {\n\t\treadonly core: {\n\t\t\treadonly getCoinMetadata: (args: { readonly coinType: string }) => Promise<unknown>;\n\t\t};\n\t};\n\treturn {\n\t\tcore: {\n\t\t\tgetObject: sui.sdk.core.getObject,\n\t\t\tgetCoinMetadata: (args) => grpcClient.core.getCoinMetadata(args),\n\t\t},\n\t\tclient: sui.sdk.client,\n\t};\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// Auto-mounted strategy contribution — siblings (Wallet, Faucet's\n\t// treasury-cap mint, Deepbook market-maker) read the per-stack\n\t// registry via this seam. The actual `CoinRegistry` instance is\n\t// wired at compose time (one registry per stack); each coin\n\t// contributes its `register(record)` call as a side effect at\n\t// acquire.\n\tconst registryContribution: StrategyContributorDecl<\n\t\ttypeof COIN_REGISTRY_CAPABILITY_KEY,\n\t\t{ readonly symbol: string }\n\t> = {\n\t\tkind: 'strategy-contributor',\n\t\tcapabilityKey: COIN_REGISTRY_CAPABILITY_KEY,\n\t\tstrategy: { symbol },\n\t\tautoMounted: true,\n\t};\n\tconst fundingContribution =\n\t\tresolved.fundingStrategy === 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: resolved.fundingStrategy,\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, registryContribution, ...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\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. The\n\t// substrate's compose-time dedup uses string equality on the id.\n\tconst id = fullCoinType.replace(/^0x/, '').replace(/::/g, '_').slice(0, 60);\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\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\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 {\n\tCOIN_REGISTRY_CAPABILITY_KEY,\n\tCoinRegistryService,\n\tcoinRegistryLayer,\n} 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"],"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 { 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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"}

package/dist/plugins/coin/metadata.mjs

@@ -1,7 +1,9 @@
-import { decodeUnknown } from "../../substrate/runtime/runtime-decode.mjs";
 import { SpanAttr } from "../../substrate/runtime/observability/spans.mjs";
+import { decodeUnknown } from "../../substrate/runtime/runtime-decode.mjs";
 import { makeSpacedRetrySchedule } from "../../substrate/runtime/retry-policy.mjs";
+import { formatUnknownError } from "../../substrate/runtime/format-unknown-error.mjs";
 import { coinError } from "./errors.mjs";
+import { CoinSpans } from "./spans.mjs";
 import { Effect, Schema } from "effect";
 //#region src/plugins/coin/metadata.ts
 /** Per-attempt timeout (5 seconds) — distilled-doc invariant. */
@@ -50,8 +52,8 @@ const fetchCoinMetadataOnce = (sdk, fullCoinType) => Effect.gen(function* () {
 		})
 	}), Effect.retry(METADATA_RETRY_SCHEDULE), Effect.catch((err) => {
 		return Effect.logWarning("coin metadata fetch failed; soft-degrading to null").pipe(Effect.annotateLogs({
-			[SpanAttr.coinType]: fullCoinType,
-			[SpanAttr.errorCause]: stringifyCause(err.cause)
+			[CoinSpans.type]: fullCoinType,
+			[SpanAttr.errorCause]: formatUnknownError(err.cause)
 		}), Effect.as(null));
 	}));
 	if (raw === null || raw === void 0) return null;
@@ -59,10 +61,10 @@ const fetchCoinMetadataOnce = (sdk, fullCoinType) => Effect.gen(function* () {
 		source: "coin metadata RPC response",
 		mkError: (issue) => issue
 	}).pipe(Effect.catch((issue) => Effect.logWarning("coin metadata response had non-conforming shape; degrading to null").pipe(Effect.annotateLogs({
-		[SpanAttr.coinType]: fullCoinType,
-		[SpanAttr.errorCause]: stringifyCause(issue.cause ?? issue)
+		[CoinSpans.type]: fullCoinType,
+		[SpanAttr.errorCause]: formatUnknownError(issue.cause ?? issue)
 	}), Effect.as(null))));
-}).pipe(Effect.withSpan("coin.metadata.fetch", { attributes: { fullCoinType } }));
+}).pipe(Effect.withSpan("devstack.plugin.coin.metadata.fetch", { attributes: { [CoinSpans.metadata.fullCoinType]: fullCoinType } }));
 /** Bare-coin-type heuristic — distilled-doc 13-coin.md Invariant 3.
 *
 *  MUST agree with what `getCoinMetadata` accepts as a coin-type
@@ -84,15 +86,6 @@ const validateBareCoinType = (identifier) => {
 	});
 	return null;
 };
-const stringifyCause = (cause) => {
-	if (cause instanceof Error) return cause.message;
-	if (typeof cause === "string") return cause;
-	try {
-		return JSON.stringify(cause);
-	} catch {
-		return String(cause);
-	}
-};
 //#endregion
 export { METADATA_FETCH_TIMEOUT_MS, METADATA_RETRY_SCHEDULE, OnchainCoinMetadataShape, fetchCoinMetadataOnce, isBareCoinType, validateBareCoinType };