@mysten-incubation/devstack 0.1.0 → 0.2.0

package/dist/plugins/account/variants/signer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"signer.mjs","names":[],"sources":["../../../../src/plugins/account/variants/signer.ts"],"sourcesContent":["// Account variant — signer (provided as a Signer object directly).\n//\n// Distilled-doc surface: the escape hatch for hardware wallets,\n// custom KMS adapters, and dApp-side signers. Devstack NEVER calls\n// `getSecretKey()` on this branch — the supplied signer's\n// `signTransaction` / `signPersonalMessage` / `signAndExecuteTransaction`\n// methods are called directly.\n//\n// Type-encoded contract: the `signer` field is the @mysten/sui\n// abstract `Signer` shape. We accept `unknown` here at the variant\n// boundary (the substrate's import surface stays SDK-free for tree-\n// shaking and version-pinning); the user-facing factory in `index.ts`\n// pins `Signer` from `@mysten/sui/cryptography`.\n\nimport { Effect } from 'effect';\n\nimport { accountAcquireError, type AccountAcquireError } from '../errors.ts';\nimport { normalizeScheme, type ResolvedKeypair } from '../keypair.ts';\n\nexport interface SignerVariantArgs {\n\treadonly name: string;\n\t/** A `@mysten/sui/cryptography` `Signer` instance. Typed loosely\n\t *  here; the user-facing factory pins the SDK type. */\n\treadonly signer: {\n\t\treadonly toSuiAddress: () => string;\n\t\treadonly getKeyScheme: () => string;\n\t\treadonly getPublicKey: () => { readonly toRawBytes: () => Uint8Array };\n\t};\n\t/** Optional address override. When omitted, `signer.toSuiAddress()`\n\t *  is called. Useful for signers whose address is more expensive\n\t *  to derive than to memoize. */\n\treadonly addressOverride?: string;\n}\n\n/** Resolve the signer variant.\n *\n *  The body reads the address + scheme via the SDK shim and hands\n *  back the resolved-keypair view. The `bech32Secret` field is\n *  `null` — we never fish the secret out of an external signer. */\nexport const resolveSignerVariant = (\n\targs: SignerVariantArgs,\n): Effect.Effect<ResolvedKeypair, AccountAcquireError> =>\n\tEffect.gen(function* () {\n\t\tconst address = args.addressOverride ?? args.signer.toSuiAddress();\n\t\tconst rawScheme = args.signer.getKeyScheme();\n\t\tconst scheme = yield* normalizeScheme(rawScheme, args.name, 'signer');\n\t\tconst publicKey = yield* Effect.try({\n\t\t\ttry: () => args.signer.getPublicKey().toRawBytes(),\n\t\t\tcatch: (cause) =>\n\t\t\t\taccountAcquireError({\n\t\t\t\t\tphase: 'bind-signer',\n\t\t\t\t\taccountName: args.name,\n\t\t\t\t\tvariant: 'signer',\n\t\t\t\t\tmessage: `Account '${args.name}': signer.getPublicKey().toRawBytes() threw.`,\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t});\n\t\treturn {\n\t\t\taddress,\n\t\t\tscheme,\n\t\t\tpublicKey,\n\t\t\tsigner: args.signer,\n\t\t\tbech32Secret: null,\n\t\t} satisfies ResolvedKeypair;\n\t});\n"],"mappings":";;;;;;;;;AAuCA,MAAa,wBACZ,SAEA,OAAO,IAAI,aAAa;AAevB,QAAO;EACN,SAfe,KAAK,mBAAmB,KAAK,OAAO,cAAc;EAgBjE,QAAA,OAdqB,gBADJ,KAAK,OAAO,cACiB,EAAE,KAAK,MAAM,SAAS;EAepE,WAAA,OAdwB,OAAO,IAAI;GACnC,WAAW,KAAK,OAAO,cAAc,CAAC,YAAY;GAClD,QAAQ,UACP,oBAAoB;IACnB,OAAO;IACP,aAAa,KAAK;IAClB,SAAS;IACT,SAAS,YAAY,KAAK,KAAK;IAC/B;IACA,CAAC;GACH,CAAC;EAKD,QAAQ,KAAK;EACb,cAAc;EACd;EACA"}
+{"version":3,"file":"signer.mjs","names":[],"sources":["../../../../src/plugins/account/variants/signer.ts"],"sourcesContent":["// Account variant — signer (provided as a Signer object directly).\n//\n// Distilled-doc surface: the escape hatch for hardware wallets,\n// custom KMS adapters, and dApp-side signers. Devstack NEVER calls\n// `getSecretKey()` on this branch — the supplied signer's\n// `signTransaction` / `signPersonalMessage` / `signAndExecuteTransaction`\n// methods are called directly.\n//\n// Type-encoded contract: the `signer` field is the @mysten/sui\n// abstract `Signer` shape. We accept `unknown` here at the variant\n// boundary (the substrate's import surface stays SDK-free for tree-\n// shaking and version-pinning); the user-facing factory in `index.ts`\n// pins `Signer` from `@mysten/sui/cryptography`.\n\nimport { Effect } from 'effect';\n\nimport { accountAcquireError, type AccountAcquireError } from '../errors.ts';\nimport { normalizeScheme, type ResolvedKeypair } from '../keypair.ts';\n\nexport interface SignerVariantArgs {\n\treadonly name: string;\n\t/** A `@mysten/sui/cryptography` `Signer` instance. Typed loosely\n\t *  here; the user-facing factory pins the SDK type. */\n\treadonly signer: {\n\t\treadonly toSuiAddress: () => string;\n\t\treadonly getKeyScheme: () => string;\n\t\treadonly getPublicKey: () => { readonly toRawBytes: () => Uint8Array };\n\t};\n\t/** Optional address override. When omitted, `signer.toSuiAddress()`\n\t *  is called. Useful for signers whose address is more expensive\n\t *  to derive than to memoize. */\n\treadonly addressOverride?: string;\n}\n\n/** Resolve the signer variant.\n *\n *  The body reads the address + scheme via the SDK shim and hands\n *  back the resolved-keypair view. The `bech32Secret` field is\n *  `null` — we never fish the secret out of an external signer. */\nexport const resolveSignerVariant = (\n\targs: SignerVariantArgs,\n): Effect.Effect<ResolvedKeypair, AccountAcquireError> =>\n\tEffect.gen(function* () {\n\t\tconst address = args.addressOverride ?? args.signer.toSuiAddress();\n\t\tconst rawScheme = args.signer.getKeyScheme();\n\t\tconst scheme = yield* normalizeScheme(rawScheme, args.name, 'signer');\n\t\tconst publicKey = yield* Effect.try({\n\t\t\ttry: () => args.signer.getPublicKey().toRawBytes(),\n\t\t\tcatch: (cause) =>\n\t\t\t\taccountAcquireError({\n\t\t\t\t\tphase: 'bind-signer',\n\t\t\t\t\taccountName: args.name,\n\t\t\t\t\tvariant: 'signer',\n\t\t\t\t\tmessage: `Account '${args.name}': signer.getPublicKey().toRawBytes() threw.`,\n\t\t\t\t\tcause,\n\t\t\t\t}),\n\t\t});\n\t\treturn {\n\t\t\taddress,\n\t\t\tscheme,\n\t\t\tpublicKey,\n\t\t\tsigner: args.signer,\n\t\t\tbech32Secret: null,\n\t\t} satisfies ResolvedKeypair;\n\t});\n"],"mappings":";;;;;;;;;AAuCA,MAAa,wBACZ,SAEA,OAAO,IAAI,aAAa;CAevB,OAAO;EACN,SAfe,KAAK,mBAAmB,KAAK,OAAO,aAAa;EAgBhE,QAAA,OAdqB,gBADJ,KAAK,OAAO,aACgB,GAAG,KAAK,MAAM,QAAQ;EAenE,WAAA,OAdwB,OAAO,IAAI;GACnC,WAAW,KAAK,OAAO,aAAa,CAAC,CAAC,WAAW;GACjD,QAAQ,UACP,oBAAoB;IACnB,OAAO;IACP,aAAa,KAAK;IAClB,SAAS;IACT,SAAS,YAAY,KAAK,KAAK;IAC/B;GACD,CAAC;EACH,CAAC;EAKA,QAAQ,KAAK;EACb,cAAc;CACf;AACD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"discriminator.mjs","names":[],"sources":["../../../src/plugins/action/discriminator.ts"],"sourcesContent":["// Action plugin — discriminator types.\n//\n// An action's cache key is `action/<chainId>/<contentHash>` where the\n// content hash folds in:\n//\n//   - `actionName`   — symbolic action name (drives namespace + TUI\n//                      attribution).\n//   - `chainId`      — substrate-folded automatically (substrate-side\n//                      of the artifact publisher cache key).\n//   - `consumedKeys` — the literal resource ids of every entry in\n//                      `dependsOn`. Folded so reordering/changing\n//                      upstream deps invalidates the cache. Static —\n//                      resolved at factory construction time.\n//   - `discriminator` — OPTIONAL caller-supplied extra material. Two\n//                      accepted shapes: a literal `string`, or a\n//                      callback `(ctx, deps) => Effect<string>`\n//                      receiving action helpers and resolved deps\n//                      shaped by `dependsOn`. The callback form re-runs\n//                      on EVERY acquire (hit OR miss) — mirrors v3's `cacheKey:\n//                      Effect<string>` semantics (16-action.md\n//                      invariant 5/6).\n//\n// The dynamic discriminator covers the common case where the action's\n// idempotency hinges on a value not known until upstream resolution\n// completes. The v3 example: `cacheKey: Effect.gen(function* () {\n// const pkg = yield* connectFour; return pkg.packageId; })`.\n\nimport type { Effect } from 'effect';\n\nimport type { ActionError } from './errors.ts';\nimport type { ActionBuildContext } from './build-context.ts';\n\n/** Static portion of the discriminator (known at factory construction\n *  time). The substrate folds this into the content-hash so the\n *  cache key changes when these fields do. */\nexport interface StaticDiscriminator {\n\t/** Symbolic action name. */\n\treadonly actionName: string;\n\t/** Resource-id literals of every entry in `dependsOn`, in declaration\n\t *  order. Reordering MUST invalidate the cache (this is the v3\n\t *  behavior — `needs.map(n => n.key)` was folded in order). */\n\treadonly dependencyResourceIds: ReadonlyArray<string>;\n}\n\n/** Dynamic portion (resolved at acquire time). Two accepted shapes:\n *\n *  - `string`    — literal cache-key fragment, used verbatim.\n *  - `(ctx, deps) => Effect<string, ActionError>` — callback receiving\n *                  action helpers and resolved deps in the same shape\n *                  as the body callback. The Effect is yielded at\n *                  acquire time so the callback can derive the\n *                  discriminator from upstream resolved values (e.g.\n *                  fold in a freshly-published package id). Re-runs\n *                  on EVERY acquire (hit OR miss). User errors\n *                  propagate as `ActionError({phase: 'discriminator'})`. */\nexport type DynamicDiscriminator<Deps = unknown> =\n\t| string\n\t| ((ctx: ActionBuildContext, deps: Deps) => Effect.Effect<string, ActionError>);\n\n/** Build the content-hash input string from static + resolved-dynamic\n *  pieces. Canonical shape: newline-delimited so two strings with\n *  shared prefixes hash differently. */\nexport const composeDiscriminatorMaterial = (\n\tstaticParts: StaticDiscriminator,\n\tresolvedDynamic: string | undefined,\n): string => {\n\tconst lines: string[] = [\n\t\t`action=${staticParts.actionName}`,\n\t\t`dependencies=${JSON.stringify(staticParts.dependencyResourceIds)}`,\n\t];\n\tif (resolvedDynamic !== undefined) {\n\t\tlines.push(`discriminator=${resolvedDynamic}`);\n\t}\n\treturn lines.join('\\n');\n};\n"],"mappings":";;;;AA8DA,MAAa,gCACZ,aACA,oBACY;CACZ,MAAM,QAAkB,CACvB,UAAU,YAAY,cACtB,gBAAgB,KAAK,UAAU,YAAY,sBAAsB,GACjE;AACD,KAAI,oBAAoB,KAAA,EACvB,OAAM,KAAK,iBAAiB,kBAAkB;AAE/C,QAAO,MAAM,KAAK,KAAK"}
+{"version":3,"file":"discriminator.mjs","names":[],"sources":["../../../src/plugins/action/discriminator.ts"],"sourcesContent":["// Action plugin — discriminator types.\n//\n// An action's cache key is `action/<chainId>/<contentHash>` where the\n// content hash folds in:\n//\n//   - `actionName`   — symbolic action name (drives namespace + TUI\n//                      attribution).\n//   - `chainId`      — substrate-folded automatically (substrate-side\n//                      of the artifact publisher cache key).\n//   - `consumedKeys` — the literal resource ids of every entry in\n//                      `dependsOn`. Folded so reordering/changing\n//                      upstream deps invalidates the cache. Static —\n//                      resolved at factory construction time.\n//   - `discriminator` — OPTIONAL caller-supplied extra material. Two\n//                      accepted shapes: a literal `string`, or a\n//                      callback `(ctx, deps) => Effect<string>`\n//                      receiving action helpers and resolved deps\n//                      shaped by `dependsOn`. The callback form re-runs\n//                      on EVERY acquire (hit OR miss) — a\n//                      `cacheKey: Effect<string>` (16-action.md\n//                      invariant 5/6).\n//\n// The dynamic discriminator covers the common case where the action's\n// idempotency hinges on a value not known until upstream resolution\n// completes, e.g. `cacheKey: Effect.gen(function* () {\n// const pkg = yield* connectFour; return pkg.packageId; })`.\n\nimport type { Effect } from 'effect';\n\nimport type { ActionError } from './errors.ts';\nimport type { ActionBuildContext } from './build-context.ts';\n\n/** Static portion of the discriminator (known at factory construction\n *  time). The substrate folds this into the content-hash so the\n *  cache key changes when these fields do. */\nexport interface StaticDiscriminator {\n\t/** Symbolic action name. */\n\treadonly actionName: string;\n\t/** Resource-id literals of every entry in `dependsOn`, in declaration\n\t *  order. Reordering MUST invalidate the cache (`needs.map(n => n.key)`\n\t *  is folded in order). */\n\treadonly dependencyResourceIds: ReadonlyArray<string>;\n}\n\n/** Dynamic portion (resolved at acquire time). Two accepted shapes:\n *\n *  - `string`    — literal cache-key fragment, used verbatim.\n *  - `(ctx, deps) => Effect<string, ActionError>` — callback receiving\n *                  action helpers and resolved deps in the same shape\n *                  as the body callback. The Effect is yielded at\n *                  acquire time so the callback can derive the\n *                  discriminator from upstream resolved values (e.g.\n *                  fold in a freshly-published package id). Re-runs\n *                  on EVERY acquire (hit OR miss). User errors\n *                  propagate as `ActionError({phase: 'discriminator'})`. */\nexport type DynamicDiscriminator<Deps = unknown> =\n\t| string\n\t| ((ctx: ActionBuildContext, deps: Deps) => Effect.Effect<string, ActionError>);\n\n/** Build the content-hash input string from static + resolved-dynamic\n *  pieces. Canonical shape: newline-delimited so two strings with\n *  shared prefixes hash differently. */\nexport const composeDiscriminatorMaterial = (\n\tstaticParts: StaticDiscriminator,\n\tresolvedDynamic: string | undefined,\n): string => {\n\tconst lines: string[] = [\n\t\t`action=${staticParts.actionName}`,\n\t\t`dependencies=${JSON.stringify(staticParts.dependencyResourceIds)}`,\n\t];\n\tif (resolvedDynamic !== undefined) {\n\t\tlines.push(`discriminator=${resolvedDynamic}`);\n\t}\n\treturn lines.join('\\n');\n};\n"],"mappings":";;;;AA8DA,MAAa,gCACZ,aACA,oBACY;CACZ,MAAM,QAAkB,CACvB,UAAU,YAAY,cACtB,gBAAgB,KAAK,UAAU,YAAY,qBAAqB,GACjE;CACA,IAAI,oBAAoB,KAAA,GACvB,MAAM,KAAK,iBAAiB,iBAAiB;CAE9C,OAAO,MAAM,KAAK,IAAI;AACvB"}

package/dist/plugins/action/errors.mjs

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

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

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/plugins/action/errors.ts"],"sourcesContent":["// Action plugin — typed errors.\n//\n// Distilled doc 16-action.md \"Failure modes\": signing failure routes\n// through `PublishError({ phase: 'publish-tx' })`. The rewrite splits\n// the user-facing action error from `package`'s `PublishError` because\n// action-specific phases carry different semantics — `build` here is the\n// user-supplied transaction-builder Effect, `sign` is the build/sign/\n// submit transport (the `signAndExecute` invocation, including the\n// Account plugin's `no-digest` envelope violation surfaced via `cause`),\n// and `execute-failed` is the on-chain `FailedTransaction` outcome.\n//\n// Per architecture §Effect, errors are plain interfaces with a `_tag`\n// discriminator; `Effect.catchTag` / `catchTags` match on the literal.\n\n/** Phases for `ActionError`. Closed sum — adding a phase requires\n *  editing this file (and the plugin doc's catalog).\n *\n *  Phase semantics:\n *   - `discriminator`   — `opts.discriminator` Effect evaluation failed.\n *                         User-code defect or yielded upstream raised.\n *   - `build`           — `opts.body`'s build phase (the user-supplied\n *                         Effect) failed before producing a transaction.\n *   - `sign`            — signing / submit transport failed (signer\n *                         refused, RPC unreachable, finality timeout).\n *                         This is `account.signAndExecute`'s error\n *                         channel; it does NOT cover on-chain failures.\n *   - `execute-failed`  — transaction was delivered + executed by the\n *                         validator but the on-chain execution failed\n *                         (the `$kind: 'FailedTransaction'` variant of\n *                         `account.signAndExecute`'s return value).\n *   - `verify`          — verify probe authoritatively raised (transient\n *                         is masked by the lenient probe — does NOT raise\n *                         this).\n */\nexport type ActionPhase = 'discriminator' | 'build' | 'sign' | 'execute-failed' | 'verify';\n\n/** Single tagged action error. */\nexport interface ActionError {\n\treadonly _tag: 'ActionError';\n\treadonly phase: ActionPhase;\n\t/** Symbolic action name (the user-declared `action.name`). Flows\n\t *  into the cache key namespace and the TUI row title. */\n\treadonly actionName: string;\n\treadonly message: string;\n\treadonly cause?: unknown;\n}\n\nexport const actionError = (\n\tphase: ActionPhase,\n\tparts: Omit<ActionError, '_tag' | 'phase'>,\n): ActionError => ({ _tag: 'ActionError', phase, ...parts });\n\n/** Error tags this plugin contributes — surfaced to the cause walker\n *  via `PluginErrorContribution`. */\nexport const ACTION_ERROR_TAGS = ['ActionError'] as const;\n"],"mappings":";AA+CA,MAAa,eACZ,OACA,WACkB;CAAE,MAAM;CAAe;CAAO,GAAG;CAAO;;;AAI3D,MAAa,oBAAoB,CAAC,cAAc"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/plugins/action/errors.ts"],"sourcesContent":["// Action plugin — typed errors.\n//\n// Distilled doc 16-action.md \"Failure modes\": signing failure routes\n// through `PublishError({ phase: 'publish-tx' })`. The rewrite splits\n// the user-facing action error from `package`'s `PublishError` because\n// action-specific phases carry different semantics — `build` here is the\n// user-supplied transaction-builder Effect, `sign` is the build/sign/\n// submit transport (the `signAndExecute` invocation, including the\n// Account plugin's `no-digest` envelope violation surfaced via `cause`),\n// and `execute-failed` is the on-chain `FailedTransaction` outcome.\n//\n// Per architecture §Effect, errors are plain interfaces with a `_tag`\n// discriminator; `Effect.catchTag` / `catchTags` match on the literal.\n\n/** Phases for `ActionError`. Closed sum — adding a phase requires\n *  editing this file (and the plugin doc's catalog).\n *\n *  Phase semantics:\n *   - `discriminator`   — `opts.discriminator` Effect evaluation failed.\n *                         User-code defect or yielded upstream raised.\n *   - `build`           — `opts.body`'s build phase (the user-supplied\n *                         Effect) failed before producing a transaction.\n *   - `sign`            — signing / submit transport failed (signer\n *                         refused, RPC unreachable, finality timeout).\n *                         This is `account.signAndExecute`'s error\n *                         channel; it does NOT cover on-chain failures.\n *   - `execute-failed`  — transaction was delivered + executed by the\n *                         validator but the on-chain execution failed\n *                         (the `$kind: 'FailedTransaction'` variant of\n *                         `account.signAndExecute`'s return value).\n *   - `verify`          — verify probe authoritatively raised (transient\n *                         is masked by the lenient probe — does NOT raise\n *                         this).\n */\nexport type ActionPhase = 'discriminator' | 'build' | 'sign' | 'execute-failed' | 'verify';\n\n/** Single tagged action error. */\nexport interface ActionError {\n\treadonly _tag: 'ActionError';\n\treadonly phase: ActionPhase;\n\t/** Symbolic action name (the user-declared `action.name`). Flows\n\t *  into the cache key namespace and the TUI row title. */\n\treadonly actionName: string;\n\treadonly message: string;\n\treadonly cause?: unknown;\n}\n\nexport const actionError = (\n\tphase: ActionPhase,\n\tparts: Omit<ActionError, '_tag' | 'phase'>,\n): ActionError => ({ _tag: 'ActionError', phase, ...parts });\n\n/** The catchable error tags this plugin exposes. Pinned against the\n *  user-facing error catalog by the error-catalog-parity test. */\nexport const ACTION_ERROR_TAGS = ['ActionError'] as const;\n"],"mappings":";AA+CA,MAAa,eACZ,OACA,WACkB;CAAE,MAAM;CAAe;CAAO,GAAG;AAAM"}

package/dist/plugins/action/execute.mjs

@@ -1,10 +1,9 @@
 import { formatUnknownError } from "../../substrate/runtime/format-unknown-error.mjs";
-import { signAndDispatch } from "../../substrate/runtime/sui-execute/sign-and-dispatch.mjs";
-import { formatExecutedFailure } from "../../substrate/runtime/sui-execute/index.mjs";
+import { formatExecutedFailure } from "../sui/exec/index.mjs";
 import { buildForkImpersonationTransactionBytes } from "../sui/fork-transaction.mjs";
+import { signAndDispatch } from "../sui/exec/sign-and-dispatch.mjs";
 import "../sui/index.mjs";
 import { actionError } from "./errors.mjs";
-import { ActionSpans } from "./spans.mjs";
 import { Effect } from "effect";
 import { Transaction } from "@mysten/sui/transactions";
 //#region src/plugins/action/execute.ts
@@ -99,7 +98,7 @@ const signAndExecute = (params) => {
 			message: `Action '${actionName}': transaction execution failed on-chain for account '${account.name}' (address=${account.address}) ` + formatExecutedFailure(failure)
 		})),
 		onSuccess: (txResult) => Effect.succeed(receiptFromTxResult(txResult))
-	}).pipe(Effect.withSpan("devstack.plugin.action.signAndExecute", { attributes: { [ActionSpans.name]: actionName } }));
+	});
 };
 //#endregion
 export { signAndExecute };

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

@@ -1 +1 @@
-{"version":3,"file":"execute.mjs","names":[],"sources":["../../../src/plugins/action/execute.ts"],"sourcesContent":["// Action plugin — `signAndExecute` helper.\n//\n// Delegates the full build → sign → execute → wait → project pipeline\n// to the Account plugin's `withTransactionSigner` scope. The action\n// body never sees the SDK envelope; instead it receives the Account's\n// already-projected `TxResult`, which this module re-projects into the\n// action's `ActionReceipt` shape (bucketed `created`/`mutated` instead\n// of the account-flat `objectChanges`).\n//\n// Before the dedup, this module reimplemented the entire SDK roundtrip\n// (`executeTransaction`, `$kind`/`FailedTransaction`/no-digest envelope\n// projection, `waitForTransaction` finality wait). The same logic lived\n// in `account/service.ts:666-704` and `package/publish-executor.ts`, with\n// three near-identical SDK envelope projectors. Backlog item #29 lifts\n// the action path; the remaining package projector is tracked there too.\n//\n// Boundary discipline: this module imports the Account plugin's\n// `AccountValue` + `TxResult` (peer L4 contract) and a `SuiClient`\n// shim (peer L4 contract). It does not import `@mysten/sui/client` or\n// reach into the SDK envelope — those concerns live in\n// `account/service.ts`'s `projectTxResult`.\n\nimport { Effect, type Scope } from 'effect';\n\nimport { Transaction } from '@mysten/sui/transactions';\n\nimport type { AccountSignError, AccountValue, TxResult } from '../account/index.ts';\nimport { buildForkImpersonationTransactionBytes, type SuiClient } from '../sui/index.ts';\nimport { formatUnknownError } from '../../substrate/runtime/format-unknown-error.ts';\nimport { formatExecutedFailure } from '../../substrate/runtime/sui-execute/index.ts';\nimport { signAndDispatch } from '../../substrate/runtime/sui-execute/sign-and-dispatch.ts';\n\nimport { actionError, type ActionError } from './errors.ts';\nimport type { ActionReceipt } from './service.ts';\nimport { ActionSpans } from './spans.ts';\n\n// ---------------------------------------------------------------------------\n// Receipt object-change projection\n// ---------------------------------------------------------------------------\n\n/** Flat object-change record surfaced on an `ActionReceipt`. Mirrors\n *  the package plugin's `PublishObjectChange` shape so consumers can\n *  reuse `findCreatedByType`-style helpers across the two surfaces.\n *\n *  - `kind`: 'created' when `idOperation === 'Created'`, else 'mutated'\n *    (we expose the same two buckets the package plugin uses; finer\n *    distinctions are recoverable from the raw `idOperation` /\n *    `outputState` fields preserved alongside).\n *  - `objectType`: optional fully-qualified type string\n *    (`<packageId>::<module>::<Name>`) — present when the SDK's\n *    `objectTypes` map carries the id. */\nexport interface ActionObjectChange {\n\treadonly kind: 'created' | 'mutated';\n\treadonly objectId: string;\n\treadonly objectType?: string;\n\treadonly outputState?: string;\n\treadonly idOperation?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Account TxResult → ActionReceipt projection\n// ---------------------------------------------------------------------------\n\n/**\n * Re-bucket the account's flat `objectChanges` into action-flavored\n * `created` / `mutated` rows. The account plugin's projection emits\n * `{type, objectId, objectType?, outputState?, idOperation?}`; we\n * carry through the optional fields and discriminate on `type` /\n * `kind` so a downstream `findCreatedByType` consumer keeps working.\n */\nconst projectAccountObjectChanges = (\n\tchanges: ReadonlyArray<unknown>,\n): ReadonlyArray<ActionObjectChange> =>\n\tchanges\n\t\t.filter(\n\t\t\t(\n\t\t\t\tchange,\n\t\t\t): change is {\n\t\t\t\treadonly type?: string;\n\t\t\t\treadonly kind?: string;\n\t\t\t\treadonly objectId: string;\n\t\t\t\treadonly objectType?: string;\n\t\t\t\treadonly outputState?: string;\n\t\t\t\treadonly idOperation?: string;\n\t\t\t} =>\n\t\t\t\ttypeof change === 'object' &&\n\t\t\t\tchange !== null &&\n\t\t\t\ttypeof (change as { readonly objectId?: unknown }).objectId === 'string',\n\t\t)\n\t\t.map((change) => {\n\t\t\tconst entry: {\n\t\t\t\t-readonly [K in keyof ActionObjectChange]: ActionObjectChange[K];\n\t\t\t} = {\n\t\t\t\tkind: change.type === 'created' || change.kind === 'created' ? 'created' : 'mutated',\n\t\t\t\tobjectId: change.objectId,\n\t\t\t};\n\t\t\tif (typeof change.objectType === 'string') entry.objectType = change.objectType;\n\t\t\tif (typeof change.outputState === 'string') entry.outputState = change.outputState;\n\t\t\tif (typeof change.idOperation === 'string') entry.idOperation = change.idOperation;\n\t\t\treturn entry;\n\t\t});\n\nconst receiptFromTxResult = (tx: TxResult): ActionReceipt => ({\n\tdigest: tx.digest,\n\tobjectChanges: projectAccountObjectChanges(tx.objectChanges),\n\tbalanceChanges: tx.balanceChanges,\n});\n\n// ---------------------------------------------------------------------------\n// AccountSignError → ActionError mapping\n// ---------------------------------------------------------------------------\n\n/**\n * Map an `AccountSignError` onto the action's `'sign'` phase. The\n * account's `signAndExecute` returns a discriminated `SignAndExecuteResult`\n * for the on-chain outcome (success vs FailedTransaction); only\n * transport / lifecycle failures surface here.\n */\nconst accountSignErrorToActionError =\n\t(actionName: string) =>\n\t(cause: AccountSignError): ActionError =>\n\t\tactionError('sign', {\n\t\t\tactionName,\n\t\t\tmessage:\n\t\t\t\t`Action '${actionName}': account sign/execute failed for ` +\n\t\t\t\t`'${cause.accountName}' (address=${cause.address}): ${cause.message}`,\n\t\t\tcause,\n\t\t});\n\n// ---------------------------------------------------------------------------\n// `signAndExecute` helper\n// ---------------------------------------------------------------------------\n\n/** Drive the full build → sign → execute → wait → project pipeline by\n *  delegating to the account's `withTransactionSigner` /\n *  `signAndExecute` surface, then re-projecting the returned\n *  `TxResult` into the action's `ActionReceipt` shape.\n *\n *  Allocates a fresh `Transaction`, sets the sender to the account's\n *  address, lets the caller populate it via the `build` callback,\n *  serialises via `Transaction.build({ client })` (or the fork-mode\n *  builder for impersonation accounts), then hands the bytes to the\n *  account's locked-signer scope. The account plugin owns sign,\n *  execute, finality wait, and envelope projection.\n *\n *  All failures surface as `ActionError`:\n *   - `build` callback throws  → `phase: 'sign'`.\n *   - `Transaction.build` rejects → `phase: 'sign'`.\n *   - `account.signAndExecute` rejects with `AccountSignError` → mapped\n *     to `phase: 'sign'`. The Account plugin's `'no-digest'` phase\n *     (SDK envelope protocol violation) flows through here as well —\n *     the originating `AccountSignError` is preserved via `cause` so\n *     the cause walker renders the underlying `phase: 'no-digest'`.\n *\n *  The `actionName` parameter threads into every error's `actionName`\n *  field so cause-walker output stays attributable.\n */\nexport const signAndExecute = (params: {\n\treadonly actionName: string;\n\treadonly sui: SuiClient;\n\treadonly account: AccountValue;\n\treadonly build: (tx: Transaction) => void;\n}): Effect.Effect<ActionReceipt, ActionError, Scope.Scope> => {\n\tconst { actionName, sui, account, build } = params;\n\tconst mapAccountErr = accountSignErrorToActionError(actionName);\n\t// Delegate the build → sign → execute → dispatch pipeline to the\n\t// shared `signAndDispatch` helper. The build closure handles both\n\t// the user callback (`build(tx)`) and mode-appropriate serialization\n\t// (fork impersonation vs SDK-resolver). On-chain failures surface\n\t// as `phase: 'execute-failed'` so cause-walker renders them distinctly\n\t// from transport-level signing failures (`phase: 'sign'`).\n\treturn signAndDispatch({\n\t\tsignerSource: account,\n\t\tbuildTxBytes: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\t// --- 1. Allocate + populate the Transaction ------------------\n\t\t\t\tconst tx = new Transaction();\n\t\t\t\ttx.setSender(account.address);\n\t\t\t\tyield* Effect.try({\n\t\t\t\t\ttry: () => build(tx),\n\t\t\t\t\tcatch: (cause): ActionError =>\n\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\tmessage: `Action '${actionName}': build callback threw before serialisation.`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\n\t\t\t\t// --- 2. Serialise via the mode-appropriate path --------------\n\t\t\t\t// Fork mode (impersonate OR real signer) must build offline with\n\t\t\t\t// explicit gas: the sui-fork binary has no simulate_transaction,\n\t\t\t\t// so the SDK's gas-estimating `tx.build({ client })` fails. The\n\t\t\t\t// real-vs-empty-signature split happens later in signAndExecute.\n\t\t\t\treturn account.source === 'impersonate' || sui.fork !== null\n\t\t\t\t\t? yield* buildForkImpersonationTransactionBytes(tx, account.address, sui.sdk.core).pipe(\n\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t(cause): ActionError =>\n\t\t\t\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\t\t\t\tmessage: `Action '${actionName}': fork Transaction.build failed — ${cause.message}.`,\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t)\n\t\t\t\t\t: yield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: () => tx.build({ client: sui.sdk.client }),\n\t\t\t\t\t\t\tcatch: (cause): ActionError =>\n\t\t\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\t\t\tmessage: `Action '${actionName}': Transaction.build failed — ${\n\t\t\t\t\t\t\t\t\t\tformatUnknownError(cause)\n\t\t\t\t\t\t\t\t\t}.`,\n\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t});\n\t\t\t}),\n\t\tmapSignError: mapAccountErr,\n\t\tonFailed: (failure) =>\n\t\t\tEffect.fail(\n\t\t\t\tactionError('execute-failed', {\n\t\t\t\t\tactionName,\n\t\t\t\t\tmessage:\n\t\t\t\t\t\t`Action '${actionName}': transaction execution failed on-chain ` +\n\t\t\t\t\t\t`for account '${account.name}' (address=${account.address}) ` +\n\t\t\t\t\t\tformatExecutedFailure(failure),\n\t\t\t\t}),\n\t\t\t),\n\t\tonSuccess: (txResult) => Effect.succeed(receiptFromTxResult(txResult)),\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.action.signAndExecute', {\n\t\t\tattributes: { [ActionSpans.name]: actionName },\n\t\t}),\n\t);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAsEA,MAAM,+BACL,YAEA,QACE,QAEC,WASA,OAAO,WAAW,YAClB,WAAW,QACX,OAAQ,OAA2C,aAAa,SACjE,CACA,KAAK,WAAW;CAChB,MAAM,QAEF;EACH,MAAM,OAAO,SAAS,aAAa,OAAO,SAAS,YAAY,YAAY;EAC3E,UAAU,OAAO;EACjB;AACD,KAAI,OAAO,OAAO,eAAe,SAAU,OAAM,aAAa,OAAO;AACrE,KAAI,OAAO,OAAO,gBAAgB,SAAU,OAAM,cAAc,OAAO;AACvE,KAAI,OAAO,OAAO,gBAAgB,SAAU,OAAM,cAAc,OAAO;AACvE,QAAO;EACN;AAEJ,MAAM,uBAAuB,QAAiC;CAC7D,QAAQ,GAAG;CACX,eAAe,4BAA4B,GAAG,cAAc;CAC5D,gBAAgB,GAAG;CACnB;;;;;;;AAYD,MAAM,iCACJ,gBACA,UACA,YAAY,QAAQ;CACnB;CACA,SACC,WAAW,WAAW,sCAClB,MAAM,YAAY,aAAa,MAAM,QAAQ,KAAK,MAAM;CAC7D;CACA,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA8BJ,MAAa,kBAAkB,WAK+B;CAC7D,MAAM,EAAE,YAAY,KAAK,SAAS,UAAU;AAQ5C,QAAO,gBAAgB;EACtB,cAAc;EACd,oBACC,OAAO,IAAI,aAAa;GAEvB,MAAM,KAAK,IAAI,aAAa;AAC5B,MAAG,UAAU,QAAQ,QAAQ;AAC7B,UAAO,OAAO,IAAI;IACjB,WAAW,MAAM,GAAG;IACpB,QAAQ,UACP,YAAY,QAAQ;KACnB;KACA,SAAS,WAAW,WAAW;KAC/B;KACA,CAAC;IACH,CAAC;AAOF,UAAO,QAAQ,WAAW,iBAAiB,IAAI,SAAS,OACrD,OAAO,uCAAuC,IAAI,QAAQ,SAAS,IAAI,IAAI,KAAK,CAAC,KACjF,OAAO,UACL,UACA,YAAY,QAAQ;IACnB;IACA,SAAS,WAAW,WAAW,qCAAqC,MAAM,QAAQ;IAClF;IACA,CAAC,CACH,CACD,GACA,OAAO,OAAO,WAAW;IACzB,WAAW,GAAG,MAAM,EAAE,QAAQ,IAAI,IAAI,QAAQ,CAAC;IAC/C,QAAQ,UACP,YAAY,QAAQ;KACnB;KACA,SAAS,WAAW,WAAW,gCAC9B,mBAAmB,MAAM,CACzB;KACD;KACA,CAAC;IACH,CAAC;IACH;EACH,cApDqB,8BAA8B,WAoDxB;EAC3B,WAAW,YACV,OAAO,KACN,YAAY,kBAAkB;GAC7B;GACA,SACC,WAAW,WAAW,wDACN,QAAQ,KAAK,aAAa,QAAQ,QAAQ,MAC1D,sBAAsB,QAAQ;GAC/B,CAAC,CACF;EACF,YAAY,aAAa,OAAO,QAAQ,oBAAoB,SAAS,CAAC;EACtE,CAAC,CAAC,KACF,OAAO,SAAS,yCAAyC,EACxD,YAAY,GAAG,YAAY,OAAO,YAAY,EAC9C,CAAC,CACF"}
+{"version":3,"file":"execute.mjs","names":[],"sources":["../../../src/plugins/action/execute.ts"],"sourcesContent":["// Action plugin — `signAndExecute` helper.\n//\n// Delegates the full build → sign → execute → wait → project pipeline\n// to the Account plugin's `withTransactionSigner` scope. The action\n// body never sees the SDK envelope; instead it receives the Account's\n// already-projected `TxResult`, which this module re-projects into the\n// action's `ActionReceipt` shape (bucketed `created`/`mutated` instead\n// of the account-flat `objectChanges`).\n//\n// Before the dedup, this module reimplemented the entire SDK roundtrip\n// (`executeTransaction`, `$kind`/`FailedTransaction`/no-digest envelope\n// projection, `waitForTransaction` finality wait). The same logic lived\n// in `account/service.ts:666-704` and `package/publish-executor.ts`, with\n// three near-identical SDK envelope projectors. Backlog item #29 lifts\n// the action path; the remaining package projector is tracked there too.\n//\n// Boundary discipline: this module imports the Account plugin's\n// `AccountValue` + `TxResult` (peer L4 contract) and a `SuiClient`\n// shim (peer L4 contract). It does not import `@mysten/sui/client` or\n// reach into the SDK envelope — those concerns live in\n// `account/service.ts`'s `projectTxResult`.\n\nimport { Effect, type Scope } from 'effect';\n\nimport { Transaction } from '@mysten/sui/transactions';\n\nimport type { AccountSignError, AccountValue, TxResult } from '../account/index.ts';\nimport {\n\tbuildForkImpersonationTransactionBytes,\n\tformatExecutedFailure,\n\tsignAndDispatch,\n\ttype SuiClient,\n} from '../sui/index.ts';\nimport { formatUnknownError } from '../../substrate/runtime/format-unknown-error.ts';\n\nimport { actionError, type ActionError } from './errors.ts';\nimport type { ActionReceipt } from './service.ts';\n\n// ---------------------------------------------------------------------------\n// Receipt object-change projection\n// ---------------------------------------------------------------------------\n\n/** Flat object-change record surfaced on an `ActionReceipt`. Mirrors\n *  the package plugin's `PublishObjectChange` shape so consumers can\n *  reuse `findCreatedByType`-style helpers across the two surfaces.\n *\n *  - `kind`: 'created' when `idOperation === 'Created'`, else 'mutated'\n *    (we expose the same two buckets the package plugin uses; finer\n *    distinctions are recoverable from the raw `idOperation` /\n *    `outputState` fields preserved alongside).\n *  - `objectType`: optional fully-qualified type string\n *    (`<packageId>::<module>::<Name>`) — present when the SDK's\n *    `objectTypes` map carries the id. */\nexport interface ActionObjectChange {\n\treadonly kind: 'created' | 'mutated';\n\treadonly objectId: string;\n\treadonly objectType?: string;\n\treadonly outputState?: string;\n\treadonly idOperation?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Account TxResult → ActionReceipt projection\n// ---------------------------------------------------------------------------\n\n/**\n * Re-bucket the account's flat `objectChanges` into action-flavored\n * `created` / `mutated` rows. The account plugin's projection emits\n * `{type, objectId, objectType?, outputState?, idOperation?}`; we\n * carry through the optional fields and discriminate on `type` /\n * `kind` so a downstream `findCreatedByType` consumer keeps working.\n */\nconst projectAccountObjectChanges = (\n\tchanges: ReadonlyArray<unknown>,\n): ReadonlyArray<ActionObjectChange> =>\n\tchanges\n\t\t.filter(\n\t\t\t(\n\t\t\t\tchange,\n\t\t\t): change is {\n\t\t\t\treadonly type?: string;\n\t\t\t\treadonly kind?: string;\n\t\t\t\treadonly objectId: string;\n\t\t\t\treadonly objectType?: string;\n\t\t\t\treadonly outputState?: string;\n\t\t\t\treadonly idOperation?: string;\n\t\t\t} =>\n\t\t\t\ttypeof change === 'object' &&\n\t\t\t\tchange !== null &&\n\t\t\t\ttypeof (change as { readonly objectId?: unknown }).objectId === 'string',\n\t\t)\n\t\t.map((change) => {\n\t\t\tconst entry: {\n\t\t\t\t-readonly [K in keyof ActionObjectChange]: ActionObjectChange[K];\n\t\t\t} = {\n\t\t\t\tkind: change.type === 'created' || change.kind === 'created' ? 'created' : 'mutated',\n\t\t\t\tobjectId: change.objectId,\n\t\t\t};\n\t\t\tif (typeof change.objectType === 'string') entry.objectType = change.objectType;\n\t\t\tif (typeof change.outputState === 'string') entry.outputState = change.outputState;\n\t\t\tif (typeof change.idOperation === 'string') entry.idOperation = change.idOperation;\n\t\t\treturn entry;\n\t\t});\n\nconst receiptFromTxResult = (tx: TxResult): ActionReceipt => ({\n\tdigest: tx.digest,\n\tobjectChanges: projectAccountObjectChanges(tx.objectChanges),\n\tbalanceChanges: tx.balanceChanges,\n});\n\n// ---------------------------------------------------------------------------\n// AccountSignError → ActionError mapping\n// ---------------------------------------------------------------------------\n\n/**\n * Map an `AccountSignError` onto the action's `'sign'` phase. The\n * account's `signAndExecute` returns a discriminated `SignAndExecuteResult`\n * for the on-chain outcome (success vs FailedTransaction); only\n * transport / lifecycle failures surface here.\n */\nconst accountSignErrorToActionError =\n\t(actionName: string) =>\n\t(cause: AccountSignError): ActionError =>\n\t\tactionError('sign', {\n\t\t\tactionName,\n\t\t\tmessage:\n\t\t\t\t`Action '${actionName}': account sign/execute failed for ` +\n\t\t\t\t`'${cause.accountName}' (address=${cause.address}): ${cause.message}`,\n\t\t\tcause,\n\t\t});\n\n// ---------------------------------------------------------------------------\n// `signAndExecute` helper\n// ---------------------------------------------------------------------------\n\n/** Drive the full build → sign → execute → wait → project pipeline by\n *  delegating to the account's `withTransactionSigner` /\n *  `signAndExecute` surface, then re-projecting the returned\n *  `TxResult` into the action's `ActionReceipt` shape.\n *\n *  Allocates a fresh `Transaction`, sets the sender to the account's\n *  address, lets the caller populate it via the `build` callback,\n *  serialises via `Transaction.build({ client })` (or the fork-mode\n *  builder for impersonation accounts), then hands the bytes to the\n *  account's locked-signer scope. The account plugin owns sign,\n *  execute, finality wait, and envelope projection.\n *\n *  All failures surface as `ActionError`:\n *   - `build` callback throws  → `phase: 'sign'`.\n *   - `Transaction.build` rejects → `phase: 'sign'`.\n *   - `account.signAndExecute` rejects with `AccountSignError` → mapped\n *     to `phase: 'sign'`. The Account plugin's `'no-digest'` phase\n *     (SDK envelope protocol violation) flows through here as well —\n *     the originating `AccountSignError` is preserved via `cause` so\n *     the cause walker renders the underlying `phase: 'no-digest'`.\n *\n *  The `actionName` parameter threads into every error's `actionName`\n *  field so cause-walker output stays attributable.\n */\nexport const signAndExecute = (params: {\n\treadonly actionName: string;\n\treadonly sui: SuiClient;\n\treadonly account: AccountValue;\n\treadonly build: (tx: Transaction) => void;\n}): Effect.Effect<ActionReceipt, ActionError, Scope.Scope> => {\n\tconst { actionName, sui, account, build } = params;\n\tconst mapAccountErr = accountSignErrorToActionError(actionName);\n\t// Delegate the build → sign → execute → dispatch pipeline to the\n\t// shared `signAndDispatch` helper. The build closure handles both\n\t// the user callback (`build(tx)`) and mode-appropriate serialization\n\t// (fork impersonation vs SDK-resolver). On-chain failures surface\n\t// as `phase: 'execute-failed'` so cause-walker renders them distinctly\n\t// from transport-level signing failures (`phase: 'sign'`).\n\treturn signAndDispatch({\n\t\tsignerSource: account,\n\t\tbuildTxBytes: () =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\t// --- 1. Allocate + populate the Transaction ------------------\n\t\t\t\tconst tx = new Transaction();\n\t\t\t\ttx.setSender(account.address);\n\t\t\t\tyield* Effect.try({\n\t\t\t\t\ttry: () => build(tx),\n\t\t\t\t\tcatch: (cause): ActionError =>\n\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\tmessage: `Action '${actionName}': build callback threw before serialisation.`,\n\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t}),\n\t\t\t\t});\n\n\t\t\t\t// --- 2. Serialise via the mode-appropriate path --------------\n\t\t\t\t// Fork mode (impersonate OR real signer) must build offline with\n\t\t\t\t// explicit gas: the sui-fork binary has no simulate_transaction,\n\t\t\t\t// so the SDK's gas-estimating `tx.build({ client })` fails. The\n\t\t\t\t// real-vs-empty-signature split happens later in signAndExecute.\n\t\t\t\treturn account.source === 'impersonate' || sui.fork !== null\n\t\t\t\t\t? yield* buildForkImpersonationTransactionBytes(tx, account.address, sui.sdk.core).pipe(\n\t\t\t\t\t\t\tEffect.mapError(\n\t\t\t\t\t\t\t\t(cause): ActionError =>\n\t\t\t\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\t\t\t\tmessage: `Action '${actionName}': fork Transaction.build failed — ${cause.message}.`,\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t)\n\t\t\t\t\t: yield* Effect.tryPromise({\n\t\t\t\t\t\t\ttry: () => tx.build({ client: sui.sdk.client }),\n\t\t\t\t\t\t\tcatch: (cause): ActionError =>\n\t\t\t\t\t\t\t\tactionError('sign', {\n\t\t\t\t\t\t\t\t\tactionName,\n\t\t\t\t\t\t\t\t\tmessage: `Action '${actionName}': Transaction.build failed — ${formatUnknownError(\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t)}.`,\n\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t});\n\t\t\t}),\n\t\tmapSignError: mapAccountErr,\n\t\tonFailed: (failure) =>\n\t\t\tEffect.fail(\n\t\t\t\tactionError('execute-failed', {\n\t\t\t\t\tactionName,\n\t\t\t\t\tmessage:\n\t\t\t\t\t\t`Action '${actionName}': transaction execution failed on-chain ` +\n\t\t\t\t\t\t`for account '${account.name}' (address=${account.address}) ` +\n\t\t\t\t\t\tformatExecutedFailure(failure),\n\t\t\t\t}),\n\t\t\t),\n\t\tonSuccess: (txResult) => Effect.succeed(receiptFromTxResult(txResult)),\n\t});\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAwEA,MAAM,+BACL,YAEA,QACE,QAEC,WASA,OAAO,WAAW,YAClB,WAAW,QACX,OAAQ,OAA2C,aAAa,QAClE,CAAC,CACA,KAAK,WAAW;CAChB,MAAM,QAEF;EACH,MAAM,OAAO,SAAS,aAAa,OAAO,SAAS,YAAY,YAAY;EAC3E,UAAU,OAAO;CAClB;CACA,IAAI,OAAO,OAAO,eAAe,UAAU,MAAM,aAAa,OAAO;CACrE,IAAI,OAAO,OAAO,gBAAgB,UAAU,MAAM,cAAc,OAAO;CACvE,IAAI,OAAO,OAAO,gBAAgB,UAAU,MAAM,cAAc,OAAO;CACvE,OAAO;AACR,CAAC;AAEH,MAAM,uBAAuB,QAAiC;CAC7D,QAAQ,GAAG;CACX,eAAe,4BAA4B,GAAG,aAAa;CAC3D,gBAAgB,GAAG;AACpB;;;;;;;AAYA,MAAM,iCACJ,gBACA,UACA,YAAY,QAAQ;CACnB;CACA,SACC,WAAW,WAAW,sCAClB,MAAM,YAAY,aAAa,MAAM,QAAQ,KAAK,MAAM;CAC7D;AACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,MAAa,kBAAkB,WAK+B;CAC7D,MAAM,EAAE,YAAY,KAAK,SAAS,UAAU;CAQ5C,OAAO,gBAAgB;EACtB,cAAc;EACd,oBACC,OAAO,IAAI,aAAa;GAEvB,MAAM,KAAK,IAAI,YAAY;GAC3B,GAAG,UAAU,QAAQ,OAAO;GAC5B,OAAO,OAAO,IAAI;IACjB,WAAW,MAAM,EAAE;IACnB,QAAQ,UACP,YAAY,QAAQ;KACnB;KACA,SAAS,WAAW,WAAW;KAC/B;IACD,CAAC;GACH,CAAC;GAOD,OAAO,QAAQ,WAAW,iBAAiB,IAAI,SAAS,OACrD,OAAO,uCAAuC,IAAI,QAAQ,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,KACjF,OAAO,UACL,UACA,YAAY,QAAQ;IACnB;IACA,SAAS,WAAW,WAAW,qCAAqC,MAAM,QAAQ;IAClF;GACD,CAAC,CACH,CACD,IACC,OAAO,OAAO,WAAW;IACzB,WAAW,GAAG,MAAM,EAAE,QAAQ,IAAI,IAAI,OAAO,CAAC;IAC9C,QAAQ,UACP,YAAY,QAAQ;KACnB;KACA,SAAS,WAAW,WAAW,gCAAgC,mBAC9D,KACD,EAAE;KACF;IACD,CAAC;GACH,CAAC;EACJ,CAAC;EACF,cApDqB,8BAA8B,UAoDzB;EAC1B,WAAW,YACV,OAAO,KACN,YAAY,kBAAkB;GAC7B;GACA,SACC,WAAW,WAAW,wDACN,QAAQ,KAAK,aAAa,QAAQ,QAAQ,MAC1D,sBAAsB,OAAO;EAC/B,CAAC,CACF;EACD,YAAY,aAAa,OAAO,QAAQ,oBAAoB,QAAQ,CAAC;CACtE,CAAC;AACF"}

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

@@ -1,6 +1,6 @@
 import { AnyResourceRef, DependencyInput, DependencyList, Plugin, ResolvedDependencies, ResourceRef } from "../../substrate/plugin.mjs";
-import { SuiClient } from "../sui/mode/shared.mjs";
 import { SuiOptions } from "../sui/mode/spec.mjs";
+import { SuiClient } from "../sui/mode/shared.mjs";
 import { ActionError, ActionPhase } from "./errors.mjs";
 import { DynamicDiscriminator } from "./discriminator.mjs";
 import { ActionReceipt } from "./service.mjs";
@@ -48,7 +48,7 @@ interface ActionOptions<DependsOn extends ActionDependencySpec> {
  */
 declare const action: <const Name extends string, const DependsOn extends ActionDependencySpec>(name: Name, opts: ActionOptions<DependsOn>) => Plugin<`action:${Name}`, ActionReceipt, readonly [ResourceRef<"sui", SuiClient & {
   readonly mode: SuiOptions["mode"];
-}>, ...DependencyList<DependsOn>], readonly []>;
+}>, ...DependencyList<DependsOn>]>;
 //#endregion
 export { ActionOptions, ActionUpstreamRef, action };
 //# sourceMappingURL=index.d.mts.map

package/dist/plugins/action/index.mjs

@@ -1,17 +1,15 @@
 import { definePlugin, dependencyList, resolveDependencyValues, resource } from "../../substrate/plugin.mjs";
 import "../../api/define-plugin.mjs";
-import { ArtifactPublisherService } from "../../substrate/runtime/artifact-publisher/index.mjs";
+import { CacheService } from "../../substrate/runtime/cache/service.mjs";
+import "../../substrate/runtime/cache/index.mjs";
 import { chainProbeFor } from "../../substrate/runtime/strategy-registry/chain-probe-for.mjs";
 import "../../substrate/runtime/strategy-registry/index.mjs";
-import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
 import { suiResource } from "../sui/index.mjs";
-import { ACTION_ERROR_TAGS, actionError } from "./errors.mjs";
-import "./spans.mjs";
+import { actionError } from "./errors.mjs";
 import { signAndExecute } from "./execute.mjs";
 import { bootActionService, resolveDiscriminator } from "./service.mjs";
 import { Effect } from "effect";
 //#region src/plugins/action/index.ts
-const actionErrorContributions = pluginErrorContributions(ACTION_ERROR_TAGS);
 /** Resource id constructor. The symbolic action name is part of the tag
 *  identity so two `action('foo', ...)` calls in one stack collide
 *  cleanly at compose time. */
@@ -46,8 +44,8 @@ const action = (name, opts) => {
 				message: `Action '${name}': dependency '${ref.id}' was not resolved.`
 			}));
 			const readDeclaredDependency = (id) => resolvedByResourceId.get(id);
-			const publisher = yield* ArtifactPublisherService;
-			const probe = yield* chainProbeFor(sui.chain);
+			const publisher = yield* CacheService;
+			const probe = yield* chainProbeFor(sui.chainId);
 			const bodyCtx = {
 				sui,
 				signAndExecute: (account, build) => signAndExecute({
@@ -60,7 +58,7 @@ const action = (name, opts) => {
 			const bodyDeps = resolveDependencyValues(opts.dependsOn, (member) => readDeclaredDependency(member.id));
 			return yield* bootActionService(publisher, probe, {
 				actionName: name,
-				chainId: sui.chain,
+				chainId: sui.chainId,
 				staticDiscriminator: {
 					actionName: name,
 					dependencyResourceIds
@@ -75,9 +73,7 @@ const action = (name, opts) => {
 					cause: err
 				}))
 			}));
-		}),
-		capabilities: [],
-		errorContributions: actionErrorContributions
+		})
 	});
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["signAndExecuteImpl"],"sources":["../../../src/plugins/action/index.ts"],"sourcesContent":["// Action plugin — barrel + `action(name, opts)` factory.\n//\n// Architecture (16-action.md): an action is a ONE-SHOT on-chain effect\n// (mint, create-singleton-object, seed-config, etc.) that runs after\n// its declared upstream refs (typically a signer account + one or more\n// published packages) are ready. The result (digest + change arrays)\n// is yieldable through the action resource.\n//\n// User-facing factory shape (recommended high-level form):\n//\n//   const openLobby = action('connect-four.openLobby', {\n//     dependsOn: { signer: alice, pkg: connectFour },\n//     body: (ctx, { signer, pkg }) =>\n//       ctx.signAndExecute(signer, (tx) => {\n//         tx.moveCall({ target: `${pkg.packageId}::game::create_lobby` });\n//       }),\n//   });\n//\n// The `ctx.signAndExecute(account, build)` helper folds the full\n// build → sign → execute (with `include: {effects, objectTypes}`) →\n// wait-for-finality → envelope-projection pipeline into a single call\n// (see `execute.ts`). The returned `ActionReceipt` carries the real\n// transaction digest and an `objectChanges` array that surfaces the\n// SDK's `changedObjects` (with `kind: 'created' | 'mutated'` + the\n// fully-qualified `objectType` string when available).\n//\n// Resource id: `'action:<name>'` — one tag per user-declared action (the\n// symbolic name is part of the identity so two `action('foo', ...)`\n// calls in one stack collide cleanly at compose time).\n//\n// Caching: delegated to the substrate's `ArtifactPublisher`.\n// Namespace is `action`; the cache key folds chainId + content-hash\n// derived from (name, dependencyResourceIds, dynamic discriminator).\n\nimport { Effect, type Scope } from 'effect';\n\nimport {\n\tdefinePlugin,\n\tdependencyList,\n\tresource,\n\tresolveDependencyValues,\n\ttype AnyResourceRef,\n\ttype DependencyInput,\n\ttype ResolvedDependencies,\n} from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport { ArtifactPublisherService } from '../../substrate/runtime/artifact-publisher/index.ts';\nimport { chainProbeFor } from '../../substrate/runtime/strategy-registry/index.ts';\nimport { suiResource, type SuiProbeKey } from '../sui/index.ts';\n\nimport type { ActionBuildContext } from './build-context.ts';\nimport { actionError, ACTION_ERROR_TAGS, type ActionError } from './errors.ts';\nimport type { DynamicDiscriminator } from './discriminator.ts';\nimport { signAndExecute as signAndExecuteImpl } from './execute.ts';\nimport {\n\tbootActionService,\n\tresolveDiscriminator,\n\ttype ActionAcquireInputs,\n\ttype ActionReceipt,\n} from './service.ts';\n\nconst actionErrorContributions = pluginErrorContributions(ACTION_ERROR_TAGS);\n\n// ---------------------------------------------------------------------------\n// Resource — one per declared action, keyed by symbolic name\n// ---------------------------------------------------------------------------\n\n/** Resource id constructor. The symbolic action name is part of the tag\n *  identity so two `action('foo', ...)` calls in one stack collide\n *  cleanly at compose time. */\nexport const actionResourceId = <Name extends string>(name: Name): `action:${Name}` =>\n\t`action:${name}`;\n\nexport type ActionResourceId<Name extends string> = `action:${Name}`;\n\n// ---------------------------------------------------------------------------\n// User-facing factory shape\n// ---------------------------------------------------------------------------\n\n/** A user-supplied upstream resource ref. The user passes plugin values\n *  such as `account('alice')` or `localPackage('demo', ...)`; object,\n *  tuple, and single-ref shapes are preserved for the action body. */\nexport type ActionUpstreamRef = AnyResourceRef;\n\n/** Options for `action(name, opts)`. */\ntype ActionDependencySpec = DependencyInput;\n\ntype ResolvedActionDependencies<Input extends ActionDependencySpec> = ResolvedDependencies<Input>;\n\nexport interface ActionOptions<DependsOn extends ActionDependencySpec> {\n\t/** Upstream refs the action depends on. The shape determines the\n\t *  second argument passed to `body`. */\n\treadonly dependsOn: DependsOn;\n\t/** Optional caller-supplied discriminator material. Two shapes:\n\t *  a literal `string`, or a callback `(ctx, deps) => Effect<string>`\n\t *  that receives action helpers plus resolved deps shaped like\n\t *  `dependsOn`, so the discriminator can derive its value from\n\t *  upstream resolved values. See\n\t *  `discriminator.ts`. */\n\treadonly discriminator?: DynamicDiscriminator<ResolvedActionDependencies<DependsOn>>;\n\t/** The user's body. Receives action helpers plus resolved deps\n\t *  shaped like `dependsOn`, then returns the on-chain effect.\n\t *\n\t *  Errors raised here surface as `ActionError({phase:'sign'})`\n\t *  unless the body raises an `ActionError` itself (in which case\n\t *  it propagates verbatim). */\n\treadonly body: (\n\t\tctx: ActionBuildContext,\n\t\tdeps: ResolvedActionDependencies<DependsOn>,\n\t) => Effect.Effect<ActionReceipt, ActionError, Scope.Scope>;\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/** Construct the action plugin instance.\n *\n *  The result is a plugin/resource ref that:\n *\n *   - publishes an `ActionReceipt`-typed resource identified by\n *     `action:<name>`,\n *   - `dependsOn:` `[suiResource, ...userDependencies]` (Sui hard upstream for\n *     ChainProbe lookup + chainId folding),\n *   - `role: 'task'` — Action has no long-lived resources;\n *     the substrate's lifecycle wrap surfaces it as \"done\" after\n *     `start` resolves.\n */\nexport const action = <const Name extends string, const DependsOn extends ActionDependencySpec>(\n\tname: Name,\n\topts: ActionOptions<DependsOn>,\n) => {\n\tconst actionRef = resource<ActionResourceId<Name>, ActionReceipt>(actionResourceId(name));\n\n\t// Flatten the user-supplied upstream refs for ordering. The start\n\t// body below keeps the original `dependsOn` shape so it can\n\t// reconstruct the user's dependency argument.\n\tconst upstreamRefs = dependencyList(opts.dependsOn);\n\tconst dependencies = [suiResource, ...upstreamRefs] as const;\n\n\t// Static discriminator pieces — known at factory construction\n\t// time. The tag-ids preserve the literal `id` so two actions with\n\t// identical bodies but different upstream packages get different\n\t// cache keys.\n\tconst dependencyResourceIds = upstreamRefs.map(({ id }) => id) as ReadonlyArray<string>;\n\n\treturn definePlugin({\n\t\tid: actionRef.id,\n\t\tdependsOn: dependencies,\n\t\t// Action has no long-lived resources — the body runs once at\n\t\t// acquire and returns; supervisor's lifecycle wrap surfaces\n\t\t// \"done\" after that.\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\tstart: (deps) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst [sui, ...resolvedUpstream] = deps;\n\t\t\t\tconst resolvedByResourceId = new Map<string, unknown>(\n\t\t\t\t\tupstreamRefs.map((ref, index) => [ref.id, resolvedUpstream[index]]),\n\t\t\t\t);\n\n\t\t\t\t// Substrate guarantees `deps` is the resolved positional\n\t\t\t\t// list matching `dependsOn`, so this map is densely\n\t\t\t\t// populated. If the invariant ever breaks (substrate\n\t\t\t\t// bug) we surface a typed ActionError(`build`) BEFORE\n\t\t\t\t// invoking the downstream sync resolver so the cause\n\t\t\t\t// walker attributes the failure to this action rather\n\t\t\t\t// than producing an unattributed defect.\n\t\t\t\tfor (const ref of upstreamRefs) {\n\t\t\t\t\tif (!resolvedByResourceId.has(ref.id)) {\n\t\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\t\tactionError('build', {\n\t\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\t\tmessage: `Action '${name}': dependency '${ref.id}' was not resolved.`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst readDeclaredDependency = (id: string): unknown => resolvedByResourceId.get(id);\n\n\t\t\t\t// Substrate-context primitives. artifact publisher + strategy registry\n\t\t\t\t// are both provided by the supervisor's pluginContext.\n\t\t\t\tconst publisher = yield* ArtifactPublisherService;\n\t\t\t\tconst probe = yield* chainProbeFor<SuiProbeKey>(sui.chain);\n\n\t\t\t\t// Compose the user's body Effect, closing over the\n\t\t\t\t// action helper context. Resolved upstream values are\n\t\t\t\t// passed separately in the same shape as `dependsOn`.\n\t\t\t\t//   - `ctx.sui` — the resolved SuiClient (always set;\n\t\t\t\t//     suiResource is the hard upstream).\n\t\t\t\t//   - `ctx.signAndExecute(account, build)` — high-level\n\t\t\t\t//     helper that drives the full build → sign → execute\n\t\t\t\t//     → wait → project pipeline against the supplied\n\t\t\t\t//     account, returning a parsed `ActionReceipt`. This\n\t\t\t\t//     is what most action bodies want — it folds the\n\t\t\t\t//     SDK-boundary cast + `include: {effects, objectTypes}`\n\t\t\t\t//     execute + finality wait + envelope projection.\n\t\t\t\tconst bodyCtx: ActionBuildContext = {\n\t\t\t\t\tsui,\n\t\t\t\t\tsignAndExecute: (account, build) =>\n\t\t\t\t\t\tsignAndExecuteImpl({\n\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\tsui,\n\t\t\t\t\t\t\taccount,\n\t\t\t\t\t\t\tbuild,\n\t\t\t\t\t\t}),\n\t\t\t\t};\n\n\t\t\t\tconst bodyDeps = resolveDependencyValues(opts.dependsOn, (member) =>\n\t\t\t\t\treadDeclaredDependency(member.id),\n\t\t\t\t) as ResolvedActionDependencies<DependsOn>;\n\t\t\t\tconst acquireInputs: ActionAcquireInputs = {\n\t\t\t\t\tactionName: name,\n\t\t\t\t\tchainId: sui.chain,\n\t\t\t\t\tstaticDiscriminator: {\n\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\tdependencyResourceIds,\n\t\t\t\t\t},\n\t\t\t\t\tdynamicMaterial: resolveDiscriminator(opts.discriminator, bodyCtx, bodyDeps),\n\t\t\t\t\tbody: opts.body(bodyCtx, bodyDeps),\n\t\t\t\t};\n\n\t\t\t\tconst receipt = yield* bootActionService(publisher, probe, acquireInputs).pipe(\n\t\t\t\t\t// `catchTags` narrows on the `_tag` discriminant so each\n\t\t\t\t\t// branch's handler sees the typed shape directly.\n\t\t\t\t\t//\n\t\t\t\t\t// The produce-side body in `service.ts` recovers any\n\t\t\t\t\t// stashed ActionError before the substrate's\n\t\t\t\t\t// mapError wrap, so an ArtifactPublishError reaching\n\t\t\t\t\t// here is always a substrate-side failure (cache\n\t\t\t\t\t// decode failure, verify exhausted). Surface those as\n\t\t\t\t\t// `phase: 'verify'` — they happen during the cache\n\t\t\t\t\t// verify cycle, not at sign-time.\n\t\t\t\t\tEffect.catchTags({\n\t\t\t\t\t\tActionError: (err) => Effect.fail(err),\n\t\t\t\t\t\tArtifactPublishError: (err) =>\n\t\t\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\t\t\tactionError('verify', {\n\t\t\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\t\t\tmessage: err.detail,\n\t\t\t\t\t\t\t\t\tcause: err,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn receipt;\n\t\t\t}),\n\t\t// No capability decls today. Future surfaces (codegen of\n\t\t// action receipts, manifest extras) land here.\n\t\tcapabilities: [] as const,\n\t\t// Plugin-side error vocabulary. The supervisor's harvest loop\n\t\t// folds this into the substrate's FormatterRegistry; the\n\t\t// cascade formatter then renders `ActionError`-tagged failures\n\t\t// with the action's phase/message header.\n\t\terrorContributions: actionErrorContributions,\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type { ActionBuildContext } from './build-context.ts';\nexport type { ActionError, ActionPhase } from './errors.ts';\nexport { ACTION_ERROR_TAGS } from './errors.ts';\nexport type { DynamicDiscriminator, StaticDiscriminator } from './discriminator.ts';\nexport type { ActionReceipt } from './service.ts';\nexport { ActionReceiptSchema } from './service.ts';\nexport type { ActionObjectChange } from './execute.ts';\nexport { signAndExecute } from './execute.ts';\n\nexport { ActionSpans } from './spans.ts';\n"],"mappings":";;;;;;;;;;;;;AA6DA,MAAM,2BAA2B,yBAAyB,kBAAkB;;;;AAS5E,MAAa,oBAAyC,SACrD,UAAU;;;;;;;;;;;;;AAyDX,MAAa,UACZ,MACA,SACI;CACJ,MAAM,YAAY,SAAgD,iBAAiB,KAAK,CAAC;CAKzF,MAAM,eAAe,eAAe,KAAK,UAAU;CACnD,MAAM,eAAe,CAAC,aAAa,GAAG,aAAa;CAMnD,MAAM,wBAAwB,aAAa,KAAK,EAAE,SAAS,GAAG;AAE9D,QAAO,aAAa;EACnB,IAAI,UAAU;EACd,WAAW;EAIX,MAAM;EACN,SAAS;EACT,QAAQ,SACP,OAAO,IAAI,aAAa;GACvB,MAAM,CAAC,KAAK,GAAG,oBAAoB;GACnC,MAAM,uBAAuB,IAAI,IAChC,aAAa,KAAK,KAAK,UAAU,CAAC,IAAI,IAAI,iBAAiB,OAAO,CAAC,CACnE;AASD,QAAK,MAAM,OAAO,aACjB,KAAI,CAAC,qBAAqB,IAAI,IAAI,GAAG,CACpC,QAAO,OAAO,OAAO,KACpB,YAAY,SAAS;IACpB,YAAY;IACZ,SAAS,WAAW,KAAK,iBAAiB,IAAI,GAAG;IACjD,CAAC,CACF;GAGH,MAAM,0BAA0B,OAAwB,qBAAqB,IAAI,GAAG;GAIpF,MAAM,YAAY,OAAO;GACzB,MAAM,QAAQ,OAAO,cAA2B,IAAI,MAAM;GAc1D,MAAM,UAA8B;IACnC;IACA,iBAAiB,SAAS,UACzBA,eAAmB;KAClB,YAAY;KACZ;KACA;KACA;KACA,CAAC;IACH;GAED,MAAM,WAAW,wBAAwB,KAAK,YAAY,WACzD,uBAAuB,OAAO,GAAG,CACjC;AAmCD,UAAO,OAvBgB,kBAAkB,WAAW,OAAO;IAV1D,YAAY;IACZ,SAAS,IAAI;IACb,qBAAqB;KACpB,YAAY;KACZ;KACA;IACD,iBAAiB,qBAAqB,KAAK,eAAe,SAAS,SAAS;IAC5E,MAAM,KAAK,KAAK,SAAS,SAAS;IAGqC,CAAC,CAAC,KAWzE,OAAO,UAAU;IAChB,cAAc,QAAQ,OAAO,KAAK,IAAI;IACtC,uBAAuB,QACtB,OAAO,KACN,YAAY,UAAU;KACrB,YAAY;KACZ,SAAS,IAAI;KACb,OAAO;KACP,CAAC,CACF;IACF,CAAC,CACF;IAEA;EAGH,cAAc,EAAE;EAKhB,oBAAoB;EACpB,CAAC"}
+{"version":3,"file":"index.mjs","names":["signAndExecuteImpl"],"sources":["../../../src/plugins/action/index.ts"],"sourcesContent":["// Action plugin — barrel + `action(name, opts)` factory.\n//\n// Architecture (16-action.md): an action is a ONE-SHOT on-chain effect\n// (mint, create-singleton-object, seed-config, etc.) that runs after\n// its declared upstream refs (typically a signer account + one or more\n// published packages) are ready. The result (digest + change arrays)\n// is yieldable through the action resource.\n//\n// User-facing factory shape (recommended high-level form):\n//\n//   const openLobby = action('connect-four.openLobby', {\n//     dependsOn: { signer: alice, pkg: connectFour },\n//     body: (ctx, { signer, pkg }) =>\n//       ctx.signAndExecute(signer, (tx) => {\n//         tx.moveCall({ target: `${pkg.packageId}::game::create_lobby` });\n//       }),\n//   });\n//\n// The `ctx.signAndExecute(account, build)` helper folds the full\n// build → sign → execute (with `include: {effects, objectTypes}`) →\n// wait-for-finality → envelope-projection pipeline into a single call\n// (see `execute.ts`). The returned `ActionReceipt` carries the real\n// transaction digest and an `objectChanges` array that surfaces the\n// SDK's `changedObjects` (with `kind: 'created' | 'mutated'` + the\n// fully-qualified `objectType` string when available).\n//\n// Resource id: `'action:<name>'` — one tag per user-declared action (the\n// symbolic name is part of the identity so two `action('foo', ...)`\n// calls in one stack collide cleanly at compose time).\n//\n// Caching: delegated to the substrate's `ArtifactPublisher`.\n// Namespace is `action`; the cache key folds chainId + content-hash\n// derived from (name, dependencyResourceIds, dynamic discriminator).\n\nimport { Effect, type Scope } from 'effect';\n\nimport {\n\tdefinePlugin,\n\tdependencyList,\n\tresource,\n\tresolveDependencyValues,\n\ttype AnyResourceRef,\n\ttype DependencyInput,\n\ttype ResolvedDependencies,\n} from '../../api/define-plugin.ts';\nimport { CacheService } from '../../substrate/runtime/cache/index.ts';\nimport { chainProbeFor } from '../../substrate/runtime/strategy-registry/index.ts';\nimport { suiResource, type SuiProbeKey } from '../sui/index.ts';\n\nimport type { ActionBuildContext } from './build-context.ts';\nimport { actionError, type ActionError } from './errors.ts';\nimport type { DynamicDiscriminator } from './discriminator.ts';\nimport { signAndExecute as signAndExecuteImpl } from './execute.ts';\nimport {\n\tbootActionService,\n\tresolveDiscriminator,\n\ttype ActionAcquireInputs,\n\ttype ActionReceipt,\n} from './service.ts';\n\n// ---------------------------------------------------------------------------\n// Resource — one per declared action, keyed by symbolic name\n// ---------------------------------------------------------------------------\n\n/** Resource id constructor. The symbolic action name is part of the tag\n *  identity so two `action('foo', ...)` calls in one stack collide\n *  cleanly at compose time. */\nexport const actionResourceId = <Name extends string>(name: Name): `action:${Name}` =>\n\t`action:${name}`;\n\nexport type ActionResourceId<Name extends string> = `action:${Name}`;\n\n// ---------------------------------------------------------------------------\n// User-facing factory shape\n// ---------------------------------------------------------------------------\n\n/** A user-supplied upstream resource ref. The user passes plugin values\n *  such as `account('alice')` or `localPackage('demo', ...)`; object,\n *  tuple, and single-ref shapes are preserved for the action body. */\nexport type ActionUpstreamRef = AnyResourceRef;\n\n/** Options for `action(name, opts)`. */\ntype ActionDependencySpec = DependencyInput;\n\ntype ResolvedActionDependencies<Input extends ActionDependencySpec> = ResolvedDependencies<Input>;\n\nexport interface ActionOptions<DependsOn extends ActionDependencySpec> {\n\t/** Upstream refs the action depends on. The shape determines the\n\t *  second argument passed to `body`. */\n\treadonly dependsOn: DependsOn;\n\t/** Optional caller-supplied discriminator material. Two shapes:\n\t *  a literal `string`, or a callback `(ctx, deps) => Effect<string>`\n\t *  that receives action helpers plus resolved deps shaped like\n\t *  `dependsOn`, so the discriminator can derive its value from\n\t *  upstream resolved values. See\n\t *  `discriminator.ts`. */\n\treadonly discriminator?: DynamicDiscriminator<ResolvedActionDependencies<DependsOn>>;\n\t/** The user's body. Receives action helpers plus resolved deps\n\t *  shaped like `dependsOn`, then returns the on-chain effect.\n\t *\n\t *  Errors raised here surface as `ActionError({phase:'sign'})`\n\t *  unless the body raises an `ActionError` itself (in which case\n\t *  it propagates verbatim). */\n\treadonly body: (\n\t\tctx: ActionBuildContext,\n\t\tdeps: ResolvedActionDependencies<DependsOn>,\n\t) => Effect.Effect<ActionReceipt, ActionError, Scope.Scope>;\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/** Construct the action plugin instance.\n *\n *  The result is a plugin/resource ref that:\n *\n *   - publishes an `ActionReceipt`-typed resource identified by\n *     `action:<name>`,\n *   - `dependsOn:` `[suiResource, ...userDependencies]` (Sui hard upstream for\n *     ChainProbe lookup + chainId folding),\n *   - `role: 'task'` — Action has no long-lived resources;\n *     the substrate's lifecycle wrap surfaces it as \"done\" after\n *     `start` resolves.\n */\nexport const action = <const Name extends string, const DependsOn extends ActionDependencySpec>(\n\tname: Name,\n\topts: ActionOptions<DependsOn>,\n) => {\n\tconst actionRef = resource<ActionResourceId<Name>, ActionReceipt>(actionResourceId(name));\n\n\t// Flatten the user-supplied upstream refs for ordering. The start\n\t// body below keeps the original `dependsOn` shape so it can\n\t// reconstruct the user's dependency argument.\n\tconst upstreamRefs = dependencyList(opts.dependsOn);\n\tconst dependencies = [suiResource, ...upstreamRefs] as const;\n\n\t// Static discriminator pieces — known at factory construction\n\t// time. The tag-ids preserve the literal `id` so two actions with\n\t// identical bodies but different upstream packages get different\n\t// cache keys.\n\tconst dependencyResourceIds = upstreamRefs.map(({ id }) => id) as ReadonlyArray<string>;\n\n\treturn definePlugin({\n\t\tid: actionRef.id,\n\t\tdependsOn: dependencies,\n\t\t// Action has no long-lived resources — the body runs once at\n\t\t// acquire and returns; supervisor's lifecycle wrap surfaces\n\t\t// \"done\" after that.\n\t\trole: 'task',\n\t\tsection: 'action',\n\t\tstart: (deps) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst [sui, ...resolvedUpstream] = deps;\n\t\t\t\tconst resolvedByResourceId = new Map<string, unknown>(\n\t\t\t\t\tupstreamRefs.map((ref, index) => [ref.id, resolvedUpstream[index]]),\n\t\t\t\t);\n\n\t\t\t\t// Substrate guarantees `deps` is the resolved positional\n\t\t\t\t// list matching `dependsOn`, so this map is densely\n\t\t\t\t// populated. If the invariant ever breaks (substrate\n\t\t\t\t// bug) we surface a typed ActionError(`build`) BEFORE\n\t\t\t\t// invoking the downstream sync resolver so the cause\n\t\t\t\t// walker attributes the failure to this action rather\n\t\t\t\t// than producing an unattributed defect.\n\t\t\t\tfor (const ref of upstreamRefs) {\n\t\t\t\t\tif (!resolvedByResourceId.has(ref.id)) {\n\t\t\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\t\t\tactionError('build', {\n\t\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\t\tmessage: `Action '${name}': dependency '${ref.id}' was not resolved.`,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tconst readDeclaredDependency = (id: string): unknown => resolvedByResourceId.get(id);\n\n\t\t\t\t// Substrate-context primitives. artifact publisher + strategy registry\n\t\t\t\t// are both provided by the supervisor's pluginContext.\n\t\t\t\tconst publisher = yield* CacheService;\n\t\t\t\tconst probe = yield* chainProbeFor<SuiProbeKey>(sui.chainId);\n\n\t\t\t\t// Compose the user's body Effect, closing over the\n\t\t\t\t// action helper context. Resolved upstream values are\n\t\t\t\t// passed separately in the same shape as `dependsOn`.\n\t\t\t\t//   - `ctx.sui` — the resolved SuiClient (always set;\n\t\t\t\t//     suiResource is the hard upstream).\n\t\t\t\t//   - `ctx.signAndExecute(account, build)` — high-level\n\t\t\t\t//     helper that drives the full build → sign → execute\n\t\t\t\t//     → wait → project pipeline against the supplied\n\t\t\t\t//     account, returning a parsed `ActionReceipt`. This\n\t\t\t\t//     is what most action bodies want — it folds the\n\t\t\t\t//     SDK-boundary cast + `include: {effects, objectTypes}`\n\t\t\t\t//     execute + finality wait + envelope projection.\n\t\t\t\tconst bodyCtx: ActionBuildContext = {\n\t\t\t\t\tsui,\n\t\t\t\t\tsignAndExecute: (account, build) =>\n\t\t\t\t\t\tsignAndExecuteImpl({\n\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\tsui,\n\t\t\t\t\t\t\taccount,\n\t\t\t\t\t\t\tbuild,\n\t\t\t\t\t\t}),\n\t\t\t\t};\n\n\t\t\t\tconst bodyDeps = resolveDependencyValues(opts.dependsOn, (member) =>\n\t\t\t\t\treadDeclaredDependency(member.id),\n\t\t\t\t) as ResolvedActionDependencies<DependsOn>;\n\t\t\t\tconst acquireInputs: ActionAcquireInputs = {\n\t\t\t\t\tactionName: name,\n\t\t\t\t\tchainId: sui.chainId,\n\t\t\t\t\tstaticDiscriminator: {\n\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\tdependencyResourceIds,\n\t\t\t\t\t},\n\t\t\t\t\tdynamicMaterial: resolveDiscriminator(opts.discriminator, bodyCtx, bodyDeps),\n\t\t\t\t\tbody: opts.body(bodyCtx, bodyDeps),\n\t\t\t\t};\n\n\t\t\t\tconst receipt = yield* bootActionService(publisher, probe, acquireInputs).pipe(\n\t\t\t\t\t// `catchTags` narrows on the `_tag` discriminant so each\n\t\t\t\t\t// branch's handler sees the typed shape directly.\n\t\t\t\t\t//\n\t\t\t\t\t// The produce-side body in `service.ts` recovers any\n\t\t\t\t\t// stashed ActionError before the substrate's\n\t\t\t\t\t// mapError wrap, so an ArtifactPublishError reaching\n\t\t\t\t\t// here is always a substrate-side failure (cache\n\t\t\t\t\t// decode failure, verify exhausted). Surface those as\n\t\t\t\t\t// `phase: 'verify'` — they happen during the cache\n\t\t\t\t\t// verify cycle, not at sign-time.\n\t\t\t\t\tEffect.catchTags({\n\t\t\t\t\t\tActionError: (err) => Effect.fail(err),\n\t\t\t\t\t\tArtifactPublishError: (err) =>\n\t\t\t\t\t\t\tEffect.fail(\n\t\t\t\t\t\t\t\tactionError('verify', {\n\t\t\t\t\t\t\t\t\tactionName: name,\n\t\t\t\t\t\t\t\t\tmessage: err.detail,\n\t\t\t\t\t\t\t\t\tcause: err,\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t),\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t\treturn receipt;\n\t\t\t}),\n\t});\n};\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type { ActionBuildContext } from './build-context.ts';\nexport type { ActionError, ActionPhase } from './errors.ts';\nexport type { DynamicDiscriminator, StaticDiscriminator } from './discriminator.ts';\nexport type { ActionReceipt } from './service.ts';\nexport { ActionReceiptSchema } from './service.ts';\nexport type { ActionObjectChange } from './execute.ts';\nexport { signAndExecute } from './execute.ts';\n"],"mappings":";;;;;;;;;;;;;;;AAmEA,MAAa,oBAAyC,SACrD,UAAU;;;;;;;;;;;;;AAyDX,MAAa,UACZ,MACA,SACI;CACJ,MAAM,YAAY,SAAgD,iBAAiB,IAAI,CAAC;CAKxF,MAAM,eAAe,eAAe,KAAK,SAAS;CAClD,MAAM,eAAe,CAAC,aAAa,GAAG,YAAY;CAMlD,MAAM,wBAAwB,aAAa,KAAK,EAAE,SAAS,EAAE;CAE7D,OAAO,aAAa;EACnB,IAAI,UAAU;EACd,WAAW;EAIX,MAAM;EACN,SAAS;EACT,QAAQ,SACP,OAAO,IAAI,aAAa;GACvB,MAAM,CAAC,KAAK,GAAG,oBAAoB;GACnC,MAAM,uBAAuB,IAAI,IAChC,aAAa,KAAK,KAAK,UAAU,CAAC,IAAI,IAAI,iBAAiB,MAAM,CAAC,CACnE;GASA,KAAK,MAAM,OAAO,cACjB,IAAI,CAAC,qBAAqB,IAAI,IAAI,EAAE,GACnC,OAAO,OAAO,OAAO,KACpB,YAAY,SAAS;IACpB,YAAY;IACZ,SAAS,WAAW,KAAK,iBAAiB,IAAI,GAAG;GAClD,CAAC,CACF;GAGF,MAAM,0BAA0B,OAAwB,qBAAqB,IAAI,EAAE;GAInF,MAAM,YAAY,OAAO;GACzB,MAAM,QAAQ,OAAO,cAA2B,IAAI,OAAO;GAc3D,MAAM,UAA8B;IACnC;IACA,iBAAiB,SAAS,UACzBA,eAAmB;KAClB,YAAY;KACZ;KACA;KACA;IACD,CAAC;GACH;GAEA,MAAM,WAAW,wBAAwB,KAAK,YAAY,WACzD,uBAAuB,OAAO,EAAE,CACjC;GAmCA,OAAO,OAvBgB,kBAAkB,WAAW,OAAO;IAV1D,YAAY;IACZ,SAAS,IAAI;IACb,qBAAqB;KACpB,YAAY;KACZ;IACD;IACA,iBAAiB,qBAAqB,KAAK,eAAe,SAAS,QAAQ;IAC3E,MAAM,KAAK,KAAK,SAAS,QAAQ;GAGqC,CAAC,CAAC,CAAC,KAWzE,OAAO,UAAU;IAChB,cAAc,QAAQ,OAAO,KAAK,GAAG;IACrC,uBAAuB,QACtB,OAAO,KACN,YAAY,UAAU;KACrB,YAAY;KACZ,SAAS,IAAI;KACb,OAAO;IACR,CAAC,CACF;GACF,CAAC,CACF;EAED,CAAC;CACH,CAAC;AACF"}

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

@@ -8,14 +8,12 @@ import { Effect, Schema, Scope } from "effect";
  *  shape produced by the `ctx.signAndExecute` helper is
  *  `ActionObjectChange` (`{ kind: 'created' | 'mutated', objectId,
  *  objectType?, outputState?, idOperation? }`). Consumers can cast or
- *  use `findCreatedByType`-style helpers — mirrors v3's
- *  `pickCreatedByType(r.objectChanges, ...)` pattern from
- *  `examples/connect-four/devstack.config.ts`.
+ *  use `findCreatedByType`-style helpers, e.g.
+ *  `pickCreatedByType(r.objectChanges, ...)` (see
+ *  `examples/connect-four/devstack.config.ts`).
  *
- *  Distilled doc §"Capabilities PRODUCED" — the v3 Action's `TxResult`
- *  carries `digest`, `effects`, `objectChanges`, `balanceChanges`. We
- *  narrow to the columns that fit the cache + are actually used by
- *  downstream consumers. */
+ *  The receipt narrows to the columns that fit the cache + are actually
+ *  used by downstream consumers. */
 interface ActionReceipt {
   readonly digest: string;
   readonly objectChanges?: ReadonlyArray<unknown>;

package/dist/plugins/action/service.mjs

@@ -2,7 +2,6 @@ import { contentHash } from "../../substrate/brand.mjs";
 import { artifactPublishError } from "../../primitives/artifact-publisher.mjs";
 import { acquireOnChainArtifact } from "../internal/acquire-on-chain-artifact.mjs";
 import { actionError } from "./errors.mjs";
-import { ActionSpans } from "./spans.mjs";
 import { withPhasePreservingProduce } from "../../substrate/runtime/phase-preserving-produce.mjs";
 import { composeDiscriminatorMaterial } from "./discriminator.mjs";
 import { Cause, Effect, Schema } from "effect";
@@ -40,17 +39,12 @@ const buildVerifyProbe = (probe, cachedDigest) => probe.get({
 *  `ActionError | ArtifactPublishError` — the latter when the substrate
 *  itself surfaces a produce-failure wrap. */
 const bootActionService = (publisher, probe, inputs) => Effect.gen(function* () {
-	yield* Effect.annotateCurrentSpan({
-		[ActionSpans.name]: inputs.actionName,
-		[ActionSpans.chain]: inputs.chainId
-	});
 	const resolvedDynamic = yield* inputs.dynamicMaterial;
 	const material = composeDiscriminatorMaterial(inputs.staticDiscriminator, resolvedDynamic);
 	const inputsHash = contentHash(createHash("sha256").update(material).digest("hex"));
 	const { wrappedProduce, recoverTypedError } = yield* withPhasePreservingProduce({
 		produce: Effect.gen(function* () {
-			yield* Effect.annotateCurrentSpan({ [ActionSpans.phase]: "building" });
-			const receipt = yield* inputs.body.pipe(Effect.catchCause((cause) => {
+			return yield* inputs.body.pipe(Effect.catchCause((cause) => {
 				const failed = Cause.findError(cause);
 				if (failed._tag === "Success") return Effect.fail(failed.success);
 				if (Cause.hasInterruptsOnly(cause)) return Effect.failCause(cause);
@@ -62,11 +56,6 @@ const bootActionService = (publisher, probe, inputs) => Effect.gen(function* ()
 					cause: defectValue
 				}));
 			}));
-			yield* Effect.annotateCurrentSpan({
-				[ActionSpans.phase]: "parsing",
-				[ActionSpans.digest]: receipt.digest
-			});
-			return receipt;
 		}),
 		wrapProduceError: (err) => artifactPublishError("produce-failed", `action.${inputs.actionName} ${err.phase}: ${err.message}`)
 	});
@@ -77,10 +66,7 @@ const bootActionService = (publisher, probe, inputs) => Effect.gen(function* ()
 		verify: (cached) => buildVerifyProbe(probe, cached.digest),
 		produce: wrappedProduce
 	}).pipe(recoverTypedError);
-}).pipe(Effect.withSpan("devstack.plugin.action.boot", { attributes: {
-	[ActionSpans.name]: inputs.actionName,
-	[ActionSpans.chain]: inputs.chainId
-} }));
+});
 //#endregion
 export { bootActionService, resolveDiscriminator };
 

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//   - 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"}
+{"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//   - chainId         = Sui dependency's resolved `chainId`\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//                      it 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 (tagged separately so action consumers\n//     `catchTag('ActionError')` without clashing with package's tagged\n//     error).\n\nimport { createHash } from 'node:crypto';\n\nimport { Cause, Effect, Schema, type Scope } from 'effect';\n\nimport { contentHash as brandContentHash } 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';\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, e.g.\n *  `pickCreatedByType(r.objectChanges, ...)` (see\n *  `examples/connect-four/devstack.config.ts`).\n *\n *  The receipt narrows to the columns that fit the cache + are actually\n *  used by 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 (e.g. `pickCreatedByType(r.objectChanges, ...)`; see\n *  `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: string;\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\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\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 = defect._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\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});\n"],"mappings":";;;;;;;;AA+EmC,OAAO,OAAO;CAChD,QAAQ,OAAO;CACf,eAAe,OAAO,SAAS,OAAO,MAAM,OAAO,OAAO,CAAC;CAC3D,gBAAgB,OAAO,SAAS,OAAO,MAAM,OAAO,OAAO,CAAC;AAC7D,CAAC;;;;;AAMD,MAAM,gBAAgB,OAAO,OAAO,EACnC,QAAQ,OAAO,OAChB,CAAC;;;;;AAuBD,MAAa,wBACZ,SACA,KACA,SACoD;CACpD,IAAI,YAAY,KAAA,GAAW,OAAO,OAAO,QAAQ,KAAA,CAAS;CAC1D,IAAI,OAAO,YAAY,UAAU,OAAO,OAAO,QAAQ,OAAO;CAO9D,OAAO,QAAQ,KAAK,IAAI;AACzB;;;;AAKA,MAAM,oBACL,OACA,iBAEA,MAAM,IAAI;CAAE,MAAM;CAAe,QAAQ;AAAa,GAAG,eAAe,SAAS,CAAC,CAAC,KAGlF,OAAO,YAAY,OAAO,QAAQ,IAAwC,CAAC,CAC5E;;;;;;;AAQD,MAAa,qBACZ,WACA,OACA,WAEA,OAAO,IAAI,aAAa;CAKvB,MAAM,kBAAkB,OAAO,OAAO;CAGtC,MAAM,WAAW,6BAA6B,OAAO,qBAAqB,eAAe;CACzF,MAAM,aAAaA,YAAiB,WAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC;CA6DvF,MAAM,EAAE,gBAAgB,sBAAsB,OAAO,2BAA2B;EAC/E,SAlDoB,OAAO,IAAI,aAAa;GA8C5C,OAAO,OA/B+B,OAAO,KAAK,KACjD,OAAO,YAAY,UAAU;IAI5B,MAAM,SAAS,MAAM,UAAU,KAAK;IACpC,IAAI,OAAO,SAAS,WACnB,OAAO,OAAO,KAAK,OAAO,OAAO;IAIlC,IAAI,MAAM,kBAAkB,KAAK,GAChC,OAAO,OAAO,UAAU,KAAK;IAQ9B,MAAM,SAAS,MAAM,WAAW,KAAK;IACrC,MAAM,cAAc,OAAO,SAAS,YAAY,OAAO,UAAU,MAAM,OAAO,KAAK;IACnF,OAAO,OAAO,KACb,YAAY,QAAQ;KACnB,YAAY,OAAO;KACnB,SAAS,WAAW,OAAO,WAAW;KACtC,OAAO;IACR,CAAC,CACF;GACD,CAAC,CACF;EAED,CAGqB;EACpB,mBAAmB,QAClB,qBACC,kBACA,UAAU,OAAO,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI,SAClD;CACF,CAAC;CAsBD,OAAO,OAb+B,uBAGpC,WAAW;EACZ,WAAW;EACX,OAAO,OAAO;EACd,aAAa;EACb,SAAS,WAAW,iBAAiB,OAAO,OAAO,MAAM;EACzD,SAAS;CACV,CAAC,CAAC,CAAC,KAAK,iBAAiB;AAK1B,CAAC"}

package/dist/plugins/coin/address-resolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"address-resolution.mjs","names":[],"sources":["../../../src/plugins/coin/address-resolution.ts"],"sourcesContent":["// Coin address-resolution — the three user-facing forms unified.\n//\n// Distilled-doc 13-coin.md §Configuration: the user-facing\n// `coin(...)` factory takes one of three address forms. Each form\n// resolves to a `ResolvedCoin`:\n//\n//   1. **Package-scoped witness** — `coin.fromPackage(pkg, 'MOCK_USDC')`.\n//      Forces a dependency edge on the publishing package resource, then\n//      reads its publish output's discovered coins. Statically typed\n//      against local packages only (KnownPackages have no output).\n//\n//   2. **Bare on-chain type** — `coin.known('0x...::DEEP::DEEP')`.\n//      Bypasses the registry; calls `getCoinMetadata` against the\n//      resolved Sui client. Use for live-net coins (mainnet DEEP).\n//\n//   3. **Builtin SUI** — `coin.builtin('sui')`. Pure constant.\n//      Resolves to `0x2::sui::SUI` with `decimals: 9` synchronously.\n//\n// Each form returns a `ResolvedCoin` carrying the same shape so\n// downstream consumers (Wallet balance UI, Faucet treasury-cap mint,\n// Deepbook market maker) see one consistent value.\n\nimport { Effect } from 'effect';\n\nimport { coinError, type CoinError } from './errors.ts';\nimport {\n\tfetchCoinMetadataOnce,\n\tisBareCoinType,\n\tvalidateBareCoinType,\n\ttype MetadataSdkShim,\n} from './metadata.ts';\nimport type { CoinRecord, CoinRegistry } from './registry.ts';\n\n/** The Tag's resolved value. One uniform shape across all three\n *  address forms — downstream consumers branch on `source` only if\n *  they care about provenance. */\nexport interface ResolvedCoin {\n\treadonly fullCoinType: string;\n\treadonly decimals: number;\n\treadonly source: 'registry' | 'on-chain' | 'builtin';\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\treadonly treasuryCapId?: string;\n\treadonly metadataId?: string;\n\treadonly packageId?: string;\n}\n\n// -----------------------------------------------------------------------------\n// Builtin SUI\n// -----------------------------------------------------------------------------\n\n/** Distilled-doc 13-coin.md Invariant 4: `BUILTIN_COINS.sui` MUST\n *  always be `0x2::sui::SUI` with `decimals: 9`. Protocol-defined; any\n *  divergence breaks downstream guards (Deepbook's SUI guard, the\n *  balance UI's canonical-type compare). */\nexport const BUILTIN_COINS = {\n\tsui: {\n\t\tfullCoinType: '0x2::sui::SUI',\n\t\tdecimals: 9,\n\t\tsource: 'builtin' as const,\n\t\tsymbol: 'SUI',\n\t\tdisplayName: 'Sui',\n\t} satisfies ResolvedCoin,\n} as const;\n\nexport type BuiltinCoinName = keyof typeof BUILTIN_COINS;\n\n/** Resolve a builtin coin. Pure constant — no Effect, no upstream. */\nexport const resolveBuiltin = (name: BuiltinCoinName): ResolvedCoin => BUILTIN_COINS[name];\n\n// -----------------------------------------------------------------------------\n// Registry record projection\n// -----------------------------------------------------------------------------\n\n/** Project a `CoinRecord` to the resolved-value shape. Shared across\n *  registry-backed forms. */\nconst projectRecord = (record: CoinRecord, source: 'registry'): ResolvedCoin => ({\n\tfullCoinType: record.type,\n\tdecimals: record.decimals,\n\tsource,\n\t...(record.symbol !== undefined ? { symbol: record.symbol } : {}),\n\t...(record.displayName !== undefined ? { displayName: record.displayName } : {}),\n\t...(record.iconUrl !== undefined ? { iconUrl: record.iconUrl } : {}),\n\t...(record.treasuryCapId !== undefined ? { treasuryCapId: record.treasuryCapId } : {}),\n\t...(record.metadataId !== undefined ? { metadataId: record.metadataId } : {}),\n\tpackageId: record.packageId,\n});\n\n// -----------------------------------------------------------------------------\n// Form 1: package-scoped witness → registry\n// -----------------------------------------------------------------------------\n\n/** Resolve a coin by `(publishing package's symbolic name, witness)`.\n *  Distilled-doc 13-coin.md §\"Lifecycle\" path 3: the caller yields\n *  the package tag first to force the dep edge; this helper assumes\n *  the registry is already populated by the time it runs. */\nexport const resolveByWitness = (\n\tregistry: CoinRegistry,\n\tpackageName: string,\n\twitness: string,\n): Effect.Effect<ResolvedCoin, CoinError> =>\n\tEffect.gen(function* () {\n\t\tconst record = yield* registry.byWitness(packageName, witness);\n\t\tif (record === null) {\n\t\t\tconst candidates = (yield* registry.list())\n\t\t\t\t.filter((r) => r.publishingPackageName === packageName)\n\t\t\t\t.map((r) => r.symbol ?? r.witness);\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tcoinError('not-found', {\n\t\t\t\t\tidentifier: `${packageName}::${witness}`,\n\t\t\t\t\tmessage: `coin.fromPackage('${packageName}', '${witness}'): witness not present in the package's discovered coins.`,\n\t\t\t\t\tcandidates,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\treturn projectRecord(record, 'registry');\n\t});\n\n// -----------------------------------------------------------------------------\n// Form 2: bare on-chain type → live RPC\n// -----------------------------------------------------------------------------\n\n/** Resolve a coin by bare on-chain type. Calls `getCoinMetadata`\n *  against the resolved Sui client; soft-degrades to `decimals: 0` on\n *  RPC failure (distilled-doc 13-coin.md Failure modes table).\n *\n *  Bare type is validated first (distilled-doc invariant 7: refuses\n *  nested generics). The validator surfaces `CoinError('nested-\n *  generic')`; everything else falls through to the lenient fetch. */\nexport const resolveByBareType = (\n\tsdk: MetadataSdkShim,\n\tfullCoinType: string,\n): Effect.Effect<ResolvedCoin, CoinError> =>\n\tEffect.gen(function* () {\n\t\tconst validation = validateBareCoinType(fullCoinType);\n\t\tif (validation !== null) {\n\t\t\treturn yield* Effect.fail(validation);\n\t\t}\n\t\tif (!isBareCoinType(fullCoinType)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tcoinError('not-found', {\n\t\t\t\t\tidentifier: fullCoinType,\n\t\t\t\t\tmessage: `coin.known('${fullCoinType}'): not a bare on-chain coin type — expected '0xHEX::module::Witness'.`,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\tconst metadata = yield* fetchCoinMetadataOnce(sdk, fullCoinType);\n\t\tif (metadata === null) {\n\t\t\t// Soft-degradation: surface a record with decimals=0 and no\n\t\t\t// metadata. Downstream consumers that NEED metadata see\n\t\t\t// degraded fields — but we don't fail boot.\n\t\t\treturn {\n\t\t\t\tfullCoinType,\n\t\t\t\tdecimals: 0,\n\t\t\t\tsource: 'on-chain',\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tfullCoinType,\n\t\t\tdecimals: metadata.decimals,\n\t\t\tsource: 'on-chain',\n\t\t\tsymbol: metadata.symbol,\n\t\t\tdisplayName: metadata.name,\n\t\t\t...(metadata.iconUrl !== undefined ? { iconUrl: metadata.iconUrl } : {}),\n\t\t\tmetadataId: metadata.id,\n\t\t};\n\t});\n"],"mappings":";;;;;;;;AAwDA,MAAa,gBAAgB,EAC5B,KAAK;CACJ,cAAc;CACd,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,aAAa;CACb,EACD;;AAKD,MAAa,kBAAkB,SAAwC,cAAc;;;AAQrF,MAAM,iBAAiB,QAAoB,YAAsC;CAChF,cAAc,OAAO;CACrB,UAAU,OAAO;CACjB;CACA,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,QAAQ,OAAO,QAAQ,GAAG,EAAE;CAChE,GAAI,OAAO,gBAAgB,KAAA,IAAY,EAAE,aAAa,OAAO,aAAa,GAAG,EAAE;CAC/E,GAAI,OAAO,YAAY,KAAA,IAAY,EAAE,SAAS,OAAO,SAAS,GAAG,EAAE;CACnE,GAAI,OAAO,kBAAkB,KAAA,IAAY,EAAE,eAAe,OAAO,eAAe,GAAG,EAAE;CACrF,GAAI,OAAO,eAAe,KAAA,IAAY,EAAE,YAAY,OAAO,YAAY,GAAG,EAAE;CAC5E,WAAW,OAAO;CAClB;;;;;AAUD,MAAa,oBACZ,UACA,aACA,YAEA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO,SAAS,UAAU,aAAa,QAAQ;AAC9D,KAAI,WAAW,MAAM;EACpB,MAAM,cAAc,OAAO,SAAS,MAAM,EACxC,QAAQ,MAAM,EAAE,0BAA0B,YAAY,CACtD,KAAK,MAAM,EAAE,UAAU,EAAE,QAAQ;AACnC,SAAO,OAAO,OAAO,KACpB,UAAU,aAAa;GACtB,YAAY,GAAG,YAAY,IAAI;GAC/B,SAAS,qBAAqB,YAAY,MAAM,QAAQ;GACxD;GACA,CAAC,CACF;;AAEF,QAAO,cAAc,QAAQ,WAAW;EACvC;;;;;;;;AAaH,MAAa,qBACZ,KACA,iBAEA,OAAO,IAAI,aAAa;CACvB,MAAM,aAAa,qBAAqB,aAAa;AACrD,KAAI,eAAe,KAClB,QAAO,OAAO,OAAO,KAAK,WAAW;AAEtC,KAAI,CAAC,eAAe,aAAa,CAChC,QAAO,OAAO,OAAO,KACpB,UAAU,aAAa;EACtB,YAAY;EACZ,SAAS,eAAe,aAAa;EACrC,CAAC,CACF;CAEF,MAAM,WAAW,OAAO,sBAAsB,KAAK,aAAa;AAChE,KAAI,aAAa,KAIhB,QAAO;EACN;EACA,UAAU;EACV,QAAQ;EACR;AAEF,QAAO;EACN;EACA,UAAU,SAAS;EACnB,QAAQ;EACR,QAAQ,SAAS;EACjB,aAAa,SAAS;EACtB,GAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,SAAS,SAAS,GAAG,EAAE;EACvE,YAAY,SAAS;EACrB;EACA"}
+{"version":3,"file":"address-resolution.mjs","names":[],"sources":["../../../src/plugins/coin/address-resolution.ts"],"sourcesContent":["// Coin address-resolution — the three user-facing forms unified.\n//\n// Distilled-doc 13-coin.md §Configuration: the user-facing\n// `coin(...)` factory takes one of three address forms. Each form\n// resolves to a `ResolvedCoin`:\n//\n//   1. **Package-scoped witness** — `coin.fromPackage(pkg, 'MOCK_USDC')`.\n//      Forces a dependency edge on the publishing package resource, then\n//      reads its publish output's discovered coins. Statically typed\n//      against local packages only (KnownPackages have no output).\n//\n//   2. **Bare on-chain type** — `coin.known('0x...::DEEP::DEEP')`.\n//      Bypasses the registry; calls `getCoinMetadata` against the\n//      resolved Sui client. Use for live-net coins (mainnet DEEP).\n//\n//   3. **Builtin SUI** — `coin.builtin('sui')`. Pure constant.\n//      Resolves to `0x2::sui::SUI` with `decimals: 9` synchronously.\n//\n// Each form returns a `ResolvedCoin` carrying the same shape so\n// downstream consumers (Wallet balance UI, Faucet treasury-cap mint,\n// Deepbook market maker) see one consistent value.\n\nimport { Effect } from 'effect';\n\nimport { coinError, type CoinError } from './errors.ts';\nimport {\n\tfetchCoinMetadataOnce,\n\tisBareCoinType,\n\tvalidateBareCoinType,\n\ttype MetadataSdkShim,\n} from './metadata.ts';\nimport type { CoinRecord, CoinRegistry } from './registry.ts';\n\n/** The Tag's resolved value. One uniform shape across all three\n *  address forms — downstream consumers branch on `source` only if\n *  they care about provenance. */\nexport interface ResolvedCoin {\n\treadonly fullCoinType: string;\n\treadonly decimals: number;\n\treadonly source: 'registry' | 'on-chain' | 'builtin';\n\treadonly symbol?: string;\n\treadonly displayName?: string;\n\treadonly iconUrl?: string;\n\treadonly treasuryCapId?: string;\n\treadonly metadataId?: string;\n\treadonly packageId?: string;\n}\n\n// -----------------------------------------------------------------------------\n// Builtin SUI\n// -----------------------------------------------------------------------------\n\n/** Distilled-doc 13-coin.md Invariant 4: `BUILTIN_COINS.sui` MUST\n *  always be `0x2::sui::SUI` with `decimals: 9`. Protocol-defined; any\n *  divergence breaks downstream guards (Deepbook's SUI guard, the\n *  balance UI's canonical-type compare). */\nexport const BUILTIN_COINS = {\n\tsui: {\n\t\tfullCoinType: '0x2::sui::SUI',\n\t\tdecimals: 9,\n\t\tsource: 'builtin' as const,\n\t\tsymbol: 'SUI',\n\t\tdisplayName: 'Sui',\n\t} satisfies ResolvedCoin,\n} as const;\n\nexport type BuiltinCoinName = keyof typeof BUILTIN_COINS;\n\n/** Resolve a builtin coin. Pure constant — no Effect, no upstream. */\nexport const resolveBuiltin = (name: BuiltinCoinName): ResolvedCoin => BUILTIN_COINS[name];\n\n// -----------------------------------------------------------------------------\n// Registry record projection\n// -----------------------------------------------------------------------------\n\n/** Project a `CoinRecord` to the resolved-value shape. Shared across\n *  registry-backed forms. */\nconst projectRecord = (record: CoinRecord, source: 'registry'): ResolvedCoin => ({\n\tfullCoinType: record.type,\n\tdecimals: record.decimals,\n\tsource,\n\t...(record.symbol !== undefined ? { symbol: record.symbol } : {}),\n\t...(record.displayName !== undefined ? { displayName: record.displayName } : {}),\n\t...(record.iconUrl !== undefined ? { iconUrl: record.iconUrl } : {}),\n\t...(record.treasuryCapId !== undefined ? { treasuryCapId: record.treasuryCapId } : {}),\n\t...(record.metadataId !== undefined ? { metadataId: record.metadataId } : {}),\n\tpackageId: record.packageId,\n});\n\n// -----------------------------------------------------------------------------\n// Form 1: package-scoped witness → registry\n// -----------------------------------------------------------------------------\n\n/** Resolve a coin by `(publishing package's symbolic name, witness)`.\n *  Distilled-doc 13-coin.md §\"Lifecycle\" path 3: the caller yields\n *  the package tag first to force the dep edge; this helper assumes\n *  the registry is already populated by the time it runs. */\nexport const resolveByWitness = (\n\tregistry: CoinRegistry,\n\tpackageName: string,\n\twitness: string,\n): Effect.Effect<ResolvedCoin, CoinError> =>\n\tEffect.gen(function* () {\n\t\tconst record = yield* registry.byWitness(packageName, witness);\n\t\tif (record === null) {\n\t\t\tconst candidates = (yield* registry.list())\n\t\t\t\t.filter((r) => r.publishingPackageName === packageName)\n\t\t\t\t.map((r) => r.symbol ?? r.witness);\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tcoinError('not-found', {\n\t\t\t\t\tidentifier: `${packageName}::${witness}`,\n\t\t\t\t\tmessage: `coin.fromPackage('${packageName}', '${witness}'): witness not present in the package's discovered coins.`,\n\t\t\t\t\tcandidates,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\treturn projectRecord(record, 'registry');\n\t});\n\n// -----------------------------------------------------------------------------\n// Form 2: bare on-chain type → live RPC\n// -----------------------------------------------------------------------------\n\n/** Resolve a coin by bare on-chain type. Calls `getCoinMetadata`\n *  against the resolved Sui client; soft-degrades to `decimals: 0` on\n *  RPC failure (distilled-doc 13-coin.md Failure modes table).\n *\n *  Bare type is validated first (distilled-doc invariant 7: refuses\n *  nested generics). The validator surfaces `CoinError('nested-\n *  generic')`; everything else falls through to the lenient fetch. */\nexport const resolveByBareType = (\n\tsdk: MetadataSdkShim,\n\tfullCoinType: string,\n): Effect.Effect<ResolvedCoin, CoinError> =>\n\tEffect.gen(function* () {\n\t\tconst validation = validateBareCoinType(fullCoinType);\n\t\tif (validation !== null) {\n\t\t\treturn yield* Effect.fail(validation);\n\t\t}\n\t\tif (!isBareCoinType(fullCoinType)) {\n\t\t\treturn yield* Effect.fail(\n\t\t\t\tcoinError('not-found', {\n\t\t\t\t\tidentifier: fullCoinType,\n\t\t\t\t\tmessage: `coin.known('${fullCoinType}'): not a bare on-chain coin type — expected '0xHEX::module::Witness'.`,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\t\tconst metadata = yield* fetchCoinMetadataOnce(sdk, fullCoinType);\n\t\tif (metadata === null) {\n\t\t\t// Soft-degradation: surface a record with decimals=0 and no\n\t\t\t// metadata. Downstream consumers that NEED metadata see\n\t\t\t// degraded fields — but we don't fail boot.\n\t\t\treturn {\n\t\t\t\tfullCoinType,\n\t\t\t\tdecimals: 0,\n\t\t\t\tsource: 'on-chain',\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tfullCoinType,\n\t\t\tdecimals: metadata.decimals,\n\t\t\tsource: 'on-chain',\n\t\t\tsymbol: metadata.symbol,\n\t\t\tdisplayName: metadata.name,\n\t\t\t...(metadata.iconUrl !== undefined ? { iconUrl: metadata.iconUrl } : {}),\n\t\t\tmetadataId: metadata.id,\n\t\t};\n\t});\n"],"mappings":";;;;;;;;AAwDA,MAAa,gBAAgB,EAC5B,KAAK;CACJ,cAAc;CACd,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,aAAa;AACd,EACD;;AAKA,MAAa,kBAAkB,SAAwC,cAAc;;;AAQrF,MAAM,iBAAiB,QAAoB,YAAsC;CAChF,cAAc,OAAO;CACrB,UAAU,OAAO;CACjB;CACA,GAAI,OAAO,WAAW,KAAA,IAAY,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;CAC/D,GAAI,OAAO,gBAAgB,KAAA,IAAY,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;CAC9E,GAAI,OAAO,YAAY,KAAA,IAAY,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;CAClE,GAAI,OAAO,kBAAkB,KAAA,IAAY,EAAE,eAAe,OAAO,cAAc,IAAI,CAAC;CACpF,GAAI,OAAO,eAAe,KAAA,IAAY,EAAE,YAAY,OAAO,WAAW,IAAI,CAAC;CAC3E,WAAW,OAAO;AACnB;;;;;AAUA,MAAa,oBACZ,UACA,aACA,YAEA,OAAO,IAAI,aAAa;CACvB,MAAM,SAAS,OAAO,SAAS,UAAU,aAAa,OAAO;CAC7D,IAAI,WAAW,MAAM;EACpB,MAAM,cAAc,OAAO,SAAS,KAAK,EAAA,CACvC,QAAQ,MAAM,EAAE,0BAA0B,WAAW,CAAC,CACtD,KAAK,MAAM,EAAE,UAAU,EAAE,OAAO;EAClC,OAAO,OAAO,OAAO,KACpB,UAAU,aAAa;GACtB,YAAY,GAAG,YAAY,IAAI;GAC/B,SAAS,qBAAqB,YAAY,MAAM,QAAQ;GACxD;EACD,CAAC,CACF;CACD;CACA,OAAO,cAAc,QAAQ,UAAU;AACxC,CAAC;;;;;;;;AAaF,MAAa,qBACZ,KACA,iBAEA,OAAO,IAAI,aAAa;CACvB,MAAM,aAAa,qBAAqB,YAAY;CACpD,IAAI,eAAe,MAClB,OAAO,OAAO,OAAO,KAAK,UAAU;CAErC,IAAI,CAAC,eAAe,YAAY,GAC/B,OAAO,OAAO,OAAO,KACpB,UAAU,aAAa;EACtB,YAAY;EACZ,SAAS,eAAe,aAAa;CACtC,CAAC,CACF;CAED,MAAM,WAAW,OAAO,sBAAsB,KAAK,YAAY;CAC/D,IAAI,aAAa,MAIhB,OAAO;EACN;EACA,UAAU;EACV,QAAQ;CACT;CAED,OAAO;EACN;EACA,UAAU,SAAS;EACnB,QAAQ;EACR,QAAQ,SAAS;EACjB,aAAa,SAAS;EACtB,GAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,SAAS,QAAQ,IAAI,CAAC;EACtE,YAAY,SAAS;CACtB;AACD,CAAC"}