@mysten-incubation/devstack 0.0.0

package/dist/plugins/account/funding.d.mts

@@ -0,0 +1,94 @@
+import { AnyResourceRef, ResourceRef } from "../../substrate/plugin.mjs";
+import { CoinResourceId } from "../coin/index.mjs";
+import { AccountValue } from "./service.mjs";
+import { Effect } from "effect";
+
+//#region src/plugins/account/funding.d.ts
+/** Direct resource ref shape for a coin upstream. The user passes the
+ *  result of `coin.fromPackage(...)` / `coin.known(...)` /
+ *  `coin.builtin(...)` — NOT a bare string or discriminator. Generic
+ *  over the literal symbol so the account's dependency tuple preserves
+ *  each per-coin resource id (`coin:managed_coin/managed_coin`,
+ *  `coin:wal`, ...).
+ *
+ *  Architecture (Direct Member Refs): cross-plugin references at the
+ *  user-facing surface are plugin/resource refs directly — no opaque
+ *  tag or string discriminator vocabulary. */
+interface AccountFundingCoinValue {
+  readonly fullCoinType: string;
+  readonly symbol?: string;
+}
+type CoinMember<Sym extends string = string> = ResourceRef<CoinResourceId<Sym>, AccountFundingCoinValue>;
+/** Optional dependency edge for the plugin that contributes the
+ *  funding strategy. Coin refs force the coin metadata edge; `via`
+ *  forces the strategy-provider edge (e.g. a known DeepBook
+ *  deployment that contributes `coinType:<DEEP>`). */
+type CrossCuttingFundingProvider = AnyResourceRef | readonly AnyResourceRef[];
+/** Built-in SUI funding entry. This uses the same account funding
+ *  list as arbitrary coins but avoids requiring `coin.builtin('sui')`
+ *  for the normal SUI faucet path. */
+interface SuiFundingEntry {
+  readonly coin: 'sui';
+  readonly amount: number | bigint;
+}
+/** A single cross-cutting funding entry. `coin` is a direct member ref
+ *  (the value returned by `coin.fromPackage(...)` etc.) — the account plugin
+ *  threads it through `dependsOn` so the substrate's dep graph forces
+ *  the publishing / discovery edge to land before funding.
+ *
+ *  Distilled-doc invariant ("Strict upstream declaration"): coin
+ *  references cited by Account must force a dep edge. `via` is the
+ *  same contract for the strategy contributor that can satisfy the
+ *  funding request. */
+interface CrossCuttingFundingEntry<M extends CoinMember = CoinMember> {
+  readonly coin: M;
+  readonly amount: bigint;
+  readonly via?: CrossCuttingFundingProvider;
+}
+type AccountFundingEntry<M extends CoinMember = CoinMember> = SuiFundingEntry | CrossCuttingFundingEntry<M>;
+type AccountFunding = ReadonlyArray<AccountFundingEntry>;
+/** Internal projected shape — the acquire body in `account/index.ts`
+ *  receives each funding entry's resolved `CoinValue`, reads
+ *  `fullCoinType`, and passes the projected entries to
+ *  `applyCrossCuttingFunding`. The funding pass never sees the raw
+ *  member refs — keeps the strategy dispatch logic
+ *  substrate-name-blind. */
+interface ProjectedFundingEntry {
+  readonly coin: string;
+  readonly fullCoinType: string;
+  readonly amount: bigint;
+}
+type ProjectedFunding = ReadonlyArray<ProjectedFundingEntry>;
+interface AccountFundingResult {
+  readonly requested: ProjectedFunding;
+  readonly applied: ProjectedFunding;
+}
+/** Request passed to account funding strategies. `amount` uses the
+ *  funded coin's smallest unit. The resolved account handle is present
+ *  so strategies without an admin signer can perform account-owned
+ *  swaps while still sharing the central funding dispatcher. */
+interface AccountFundingRequest {
+  readonly address: string;
+  readonly amount: bigint;
+  readonly account: AccountValue;
+}
+interface AccountFundingStrategy<E = unknown> {
+  readonly request: (req: AccountFundingRequest) => Effect.Effect<void, E>;
+  /** True when the strategy calls `account.withTransactionSigner`.
+   *  The dispatcher must not acquire the same non-reentrant
+   *  per-address lease outside the strategy. */
+  readonly usesAccountSigner?: boolean;
+}
+/** The canonical builtin SUI coin type. Used by the funding dispatch
+ *  to route SUI entries to the faucet strategy (same key as the
+ *  default-funding pass), and by everything that needs to detect
+ *  "this is the protocol-defined SUI". Mirrors `BUILTIN_COINS.sui`
+ *  in the coin plugin. */
+declare const SUI_FULL_COIN_TYPE: "0x2::sui::SUI";
+/** Default funding amount for ephemeral accounts — 1 SUI in MIST.
+ *  Documented at the user-facing factory so a bare `account('alice')`
+ *  is predictable. */
+declare const DEFAULT_EPHEMERAL_FUND_MIST = 1000000000n;
+//#endregion
+export { AccountFunding, AccountFundingCoinValue, AccountFundingEntry, AccountFundingRequest, AccountFundingResult, AccountFundingStrategy, CoinMember, CrossCuttingFundingEntry, CrossCuttingFundingProvider, DEFAULT_EPHEMERAL_FUND_MIST, ProjectedFunding, ProjectedFundingEntry, SUI_FULL_COIN_TYPE, SuiFundingEntry };
+//# sourceMappingURL=funding.d.mts.map

package/dist/plugins/account/funding.mjs

@@ -0,0 +1,199 @@
+import { setCurrentPluginPhase } from "../../substrate/runtime/current-plugin.mjs";
+import { StrategyRegistryService } from "../../substrate/runtime/strategy-registry/service.mjs";
+import { faucetCapabilityFor } from "../../substrate/runtime/strategy-registry/faucet-capability-for.mjs";
+import { accountAcquireError } from "./errors.mjs";
+import { withAddressLease } from "./lease.mjs";
+import { Duration, Effect } from "effect";
+//#region src/plugins/account/funding.ts
+/** The canonical builtin SUI coin type. Used by the funding dispatch
+*  to route SUI entries to the faucet strategy (same key as the
+*  default-funding pass), and by everything that needs to detect
+*  "this is the protocol-defined SUI". Mirrors `BUILTIN_COINS.sui`
+*  in the coin plugin. */
+const SUI_FULL_COIN_TYPE = "0x2::sui::SUI";
+/** Default funding amount for ephemeral accounts — 1 SUI in MIST.
+*  Documented at the user-facing factory so a bare `account('alice')`
+*  is predictable. */
+const DEFAULT_EPHEMERAL_FUND_MIST = 1000000000n;
+const FUNDING_SETTLEMENT_INTERVAL_MS = 250;
+const FUNDING_SETTLEMENT_TIMEOUT_MS = 3e4;
+/** Apply the default-funding pass for an ephemeral account.
+*
+*  Wiring: yields `StrategyRegistryService` (the R-channel from
+*  Round 7), looks up the faucet strategy registered by the Sui
+*  plugin under `faucet:request:<chainId>`, and dispatches a request
+*  through it. Per-address serialization is enforced by acquiring
+*  the address lock around the wire call. */
+const fundEphemeralDefault = (parts) => Effect.gen(function* () {
+	if (parts.suiMode === "fork") yield* parts.emitAutoPromotionEvent();
+	if (parts.amountMist <= 0n) return;
+	yield* setCurrentPluginPhase("checking SUI funding");
+	const existingBalance = yield* readExistingBalance(parts.balanceReader, {
+		owner: parts.address,
+		coinType: SUI_FULL_COIN_TYPE
+	});
+	if (existingBalance !== null && existingBalance >= parts.amountMist) return;
+	const strategy = yield* faucetCapabilityFor(parts.chainId).pipe(Effect.catchTag("StrategyNotFoundError", (err) => Effect.fail(accountAcquireError({
+		phase: "fund-default",
+		accountName: parts.accountName,
+		variant: "ephemeral",
+		message: `Account '${parts.accountName}': no faucet strategy registered for chain '${parts.chainId}' (sui mode=${parts.suiMode}). Registered keys: [${err.registeredKeys.join(", ")}].`,
+		hint: parts.suiMode === "fork" ? "Fork networks have no HTTP faucet — compose a plugin that contributes defineFaucetStrategy(...) for this chain id." : "Ensure a sui() plugin with a faucet-bearing mode (local/live-testnet/live-devnet) is in the stack."
+	}))));
+	const wrapFaucetFailure = (cause) => Effect.fail(accountAcquireError({
+		phase: "fund-default",
+		accountName: parts.accountName,
+		variant: "ephemeral",
+		message: `Account '${parts.accountName}': faucet strategy request failed for chain '${parts.chainId}' (tag=${cause._tag}).`,
+		cause,
+		hint: "See the cause chain — typical roots are the faucet container not yet ready (FaucetUnreachable), the wall-clock budget elapsed (FaucetExhausted), or the body returned Failure (FaucetBodyError)."
+	}));
+	yield* setCurrentPluginPhase("funding SUI");
+	yield* withAddressLease(parts.broker, parts.accountName, parts.address, strategy.request({
+		address: parts.address,
+		amount: parts.amountMist
+	}).pipe(Effect.catchTags({
+		FaucetUnreachable: wrapFaucetFailure,
+		FaucetExhausted: wrapFaucetFailure,
+		FaucetBodyError: wrapFaucetFailure
+	})));
+	yield* setCurrentPluginPhase("waiting for SUI funding settlement");
+	yield* waitForBalanceAtLeast({
+		balanceReader: parts.balanceReader,
+		accountName: parts.accountName,
+		variant: "ephemeral",
+		phase: "fund-default",
+		owner: parts.address,
+		coinType: SUI_FULL_COIN_TYPE,
+		coinLabel: "SUI",
+		amount: parts.amountMist
+	});
+	yield* Effect.annotateCurrentSpan({
+		"account.name": parts.accountName,
+		"account.address": parts.address,
+		"fund.amount.mist": parts.amountMist.toString(),
+		"sui.chain": parts.chainId,
+		"sui.mode": parts.suiMode
+	});
+}).pipe(Effect.withSpan("devstack.plugin.account.fundEphemeralDefault", { attributes: {
+	"account.name": parts.accountName,
+	"account.address": parts.address,
+	"sui.mode": parts.suiMode
+} }));
+/** Apply the cross-cutting funding pass. Variant-agnostic — runs for
+*  every variant once the keypair / impersonation slot is bound and
+*  the address is known.
+*
+*  Distilled-doc invariant: "Optional Faucet is a noop, not an
+*  error". Absence of a registered strategy for a non-SUI coin's
+*  capability key short-circuits silently (the entry is dropped).
+*  Explicit SUI entries are stricter: they route through the active
+*  chain's faucet strategy and fail loudly when none is registered.
+*  This lets a test author opt INTO arbitrary-coin funding without
+*  forcing every surrounding network to satisfy every custom coin.
+*
+*  Wiring: SUI entries (`fullCoinType === '0x2::sui::SUI'`) dispatch
+*  through `faucet:request:<chainId>` (same key as the default pass);
+*  other entries dispatch through `coinType:<fullCoinType>` keys
+*  contributed by the respective Coin/Walrus/Seal plugins.
+*
+*  Entries are processed serially. Strategies that use the resolved
+*  account signer acquire the per-address lease internally; strategies
+*  that do not are wrapped by this dispatcher. */
+const applyCrossCuttingFunding = (parts) => Effect.gen(function* () {
+	if (parts.funding.length === 0) return [];
+	const registry = yield* StrategyRegistryService;
+	const applied = [];
+	for (const entry of parts.funding) {
+		if (entry.amount <= 0n) continue;
+		yield* setCurrentPluginPhase(`checking ${entry.coin} funding`);
+		const existingBalance = yield* readExistingBalance(parts.balanceReader, {
+			owner: parts.address,
+			coinType: entry.fullCoinType
+		});
+		if (existingBalance !== null && existingBalance >= entry.amount) {
+			applied.push(entry);
+			continue;
+		}
+		const isSui = entry.fullCoinType === SUI_FULL_COIN_TYPE;
+		const coinKey = `coinType:${entry.fullCoinType}`;
+		const strategy = yield* (isSui ? faucetCapabilityFor(parts.chainId) : registry.get(coinKey)).pipe(Effect.catchTag("StrategyNotFoundError", (err) => isSui ? Effect.fail(accountAcquireError({
+			phase: "fund-cross-cutting",
+			accountName: parts.accountName,
+			variant: parts.variant,
+			message: `Account '${parts.accountName}': no SUI funding strategy registered for chain '${parts.chainId}'. Registered keys: [${err.registeredKeys.join(", ")}].`,
+			cause: err,
+			hint: "Ensure a sui() plugin with a faucet-bearing mode (local/live-testnet/live-devnet) is in the stack."
+		})) : Effect.succeed(null)));
+		if (strategy === null) continue;
+		const key = isSui ? `faucet:request:${parts.chainId}` : coinKey;
+		const wrapCrossCuttingFailure = (cause) => {
+			const tag = typeof cause === "object" && cause !== null && "_tag" in cause ? String(cause._tag) : "unknown";
+			return accountAcquireError({
+				phase: "fund-cross-cutting",
+				accountName: parts.accountName,
+				variant: parts.variant,
+				message: `Account '${parts.accountName}': cross-cutting funding failed for coin (key='${key}') amount=${entry.amount} (tag=${tag}).`,
+				cause,
+				hint: "Cross-cutting funding requires the matching strategy to be registered at the time of acquire — check the plugin that contributes this coin and any `via` dependency."
+			});
+		};
+		const request = strategy.request({
+			address: parts.address,
+			amount: entry.amount,
+			account: parts.account
+		}).pipe(Effect.mapError(wrapCrossCuttingFailure));
+		yield* setCurrentPluginPhase(`funding ${entry.coin}`);
+		yield* strategy.usesAccountSigner === true ? request : withAddressLease(parts.broker, parts.accountName, parts.address, request);
+		yield* setCurrentPluginPhase(`waiting for ${entry.coin} funding settlement`);
+		yield* waitForBalanceAtLeast({
+			balanceReader: parts.balanceReader,
+			accountName: parts.accountName,
+			variant: parts.variant,
+			phase: "fund-cross-cutting",
+			owner: parts.address,
+			coinType: entry.fullCoinType,
+			coinLabel: entry.coin,
+			amount: entry.amount
+		});
+		applied.push(entry);
+	}
+	yield* Effect.annotateCurrentSpan({
+		"account.name": parts.accountName,
+		"account.address": parts.address,
+		"fund.cross-cutting.count": parts.funding.length,
+		"sui.chain": parts.chainId
+	});
+	return applied;
+}).pipe(Effect.withSpan("devstack.plugin.account.applyCrossCuttingFunding", { attributes: {
+	"account.name": parts.accountName,
+	"account.address": parts.address,
+	"fund.cross-cutting.entries": parts.funding.length
+} }));
+const readExistingBalance = (balanceReader, args) => balanceReader === void 0 ? Effect.succeed(null) : balanceReader.readBalance(args);
+const waitForBalanceAtLeast = (parts) => {
+	if (parts.balanceReader === void 0) return Effect.void;
+	return Effect.gen(function* () {
+		const startedAt = Date.now();
+		let lastBalance = null;
+		for (;;) {
+			lastBalance = yield* readExistingBalance(parts.balanceReader, {
+				owner: parts.owner,
+				coinType: parts.coinType
+			});
+			if (lastBalance !== null && lastBalance >= parts.amount) return;
+			if (Date.now() - startedAt >= FUNDING_SETTLEMENT_TIMEOUT_MS) return yield* Effect.fail(accountAcquireError({
+				phase: parts.phase,
+				accountName: parts.accountName,
+				variant: parts.variant,
+				message: `Account '${parts.accountName}': funding for ${parts.coinLabel} was accepted but balance did not reach ${parts.amount} before the settlement timeout (last=${lastBalance === null ? "<unavailable>" : lastBalance}).`,
+				hint: "The faucet or funding strategy returned before the funded coin became spendable. Check the funding strategy finality gate and Sui RPC health."
+			}));
+			yield* Effect.sleep(Duration.millis(FUNDING_SETTLEMENT_INTERVAL_MS));
+		}
+	});
+};
+//#endregion
+export { DEFAULT_EPHEMERAL_FUND_MIST, SUI_FULL_COIN_TYPE, applyCrossCuttingFunding, fundEphemeralDefault };
+
+//# sourceMappingURL=funding.mjs.map

package/dist/plugins/account/funding.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"funding.mjs","names":[],"sources":["../../../src/plugins/account/funding.ts"],"sourcesContent":["// Account plugin — funding logic.\n//\n// Two funding paths converge here:\n//\n//   1. **Default funding** — applies to the `ephemeral` variant only.\n//      On non-fork networks: faucet POST via the SUI HTTP strategy\n//      auto-registered by Faucet (see 11-faucet.md). On fork networks:\n//      \"pay from a seed via impersonation\" because forks have no\n//      faucet. The auto-promotion is LOUD by default per the\n//      architecture's \"no silent surprises\" principle — we emit a\n//      `log.appended` event the first time a stack hits this path.\n//\n//   2. **Cross-cutting funding** — declared per-account via\n//      `AccountOptions.funding`. Applies to every variant.\n//      Dispatched through the ambient strategy registry. Missing\n//      strategy for non-SUI coins ⇒ silent noop (architecture-\n//      mandated test-ergonomics contract, distilled-doc invariant:\n//      \"Optional Faucet is a noop, not an error\"). Explicit SUI\n//      entries use the SUI faucet strategy and fail loudly when no\n//      faucet-bearing strategy exists.\n//\n// Distilled-doc invariant: per-address serialization — concurrent\n// funding requests for the same address MUST serialize. We share the\n// substrate `LeaseBroker` handle from `service.ts` and open a fresh\n// scope per wire call so the lease releases the moment that call\n// returns. Each cross-cutting iteration is its own scope: the broker\n// is non-reentrant by design, so a hypothetical loop holding a single\n// lease across iterations would deadlock the second one.\n\nimport { Duration, Effect } from 'effect';\n\nimport type { FaucetStrategy } from '../faucet/strategies/sui-local.ts';\nimport {\n\tfaucetCapabilityFor,\n\tStrategyRegistryService,\n} from '../../substrate/runtime/strategy-registry/index.ts';\nimport type { AnyResourceRef, ResourceRef } from '../../api/define-plugin.ts';\nimport type { LeaseBroker } from '../../substrate/runtime/lease-broker/index.ts';\nimport type { ChainId } from '../../substrate/brand.ts';\nimport type { CoinResourceId } from '../coin/index.ts';\nimport { setCurrentPluginPhase } from '../../substrate/runtime/current-plugin.ts';\n\nimport {\n\taccountAcquireError,\n\ttype AccountAcquireError,\n\ttype AccountVariantKind,\n} from './errors.ts';\nimport { withAddressLease } from './lease.ts';\nimport type { AccountValue } from './service.ts';\n\n/** Direct resource ref shape for a coin upstream. The user passes the\n *  result of `coin.fromPackage(...)` / `coin.known(...)` /\n *  `coin.builtin(...)` — NOT a bare string or discriminator. Generic\n *  over the literal symbol so the account's dependency tuple preserves\n *  each per-coin resource id (`coin:managed_coin/managed_coin`,\n *  `coin:wal`, ...).\n *\n *  Architecture (Direct Member Refs): cross-plugin references at the\n *  user-facing surface are plugin/resource refs directly — no opaque\n *  tag or string discriminator vocabulary. */\nexport interface AccountFundingCoinValue {\n\treadonly fullCoinType: string;\n\treadonly symbol?: string;\n}\n\nexport type CoinMember<Sym extends string = string> = ResourceRef<\n\tCoinResourceId<Sym>,\n\tAccountFundingCoinValue\n>;\n\n/** Optional dependency edge for the plugin that contributes the\n *  funding strategy. Coin refs force the coin metadata edge; `via`\n *  forces the strategy-provider edge (e.g. a known DeepBook\n *  deployment that contributes `coinType:<DEEP>`). */\nexport type CrossCuttingFundingProvider = AnyResourceRef | readonly AnyResourceRef[];\n\n/** Built-in SUI funding entry. This uses the same account funding\n *  list as arbitrary coins but avoids requiring `coin.builtin('sui')`\n *  for the normal SUI faucet path. */\nexport interface SuiFundingEntry {\n\treadonly coin: 'sui';\n\treadonly amount: number | bigint;\n}\n\n/** A single cross-cutting funding entry. `coin` is a direct member ref\n *  (the value returned by `coin.fromPackage(...)` etc.) — the account plugin\n *  threads it through `dependsOn` so the substrate's dep graph forces\n *  the publishing / discovery edge to land before funding.\n *\n *  Distilled-doc invariant (\"Strict upstream declaration\"): coin\n *  references cited by Account must force a dep edge. `via` is the\n *  same contract for the strategy contributor that can satisfy the\n *  funding request. */\nexport interface CrossCuttingFundingEntry<M extends CoinMember = CoinMember> {\n\treadonly coin: M;\n\treadonly amount: bigint;\n\treadonly via?: CrossCuttingFundingProvider;\n}\n\nexport type AccountFundingEntry<M extends CoinMember = CoinMember> =\n\t| SuiFundingEntry\n\t| CrossCuttingFundingEntry<M>;\n\nexport type AccountFunding = ReadonlyArray<AccountFundingEntry>;\n\n/** Internal projected shape — the acquire body in `account/index.ts`\n *  receives each funding entry's resolved `CoinValue`, reads\n *  `fullCoinType`, and passes the projected entries to\n *  `applyCrossCuttingFunding`. The funding pass never sees the raw\n *  member refs — keeps the strategy dispatch logic\n *  substrate-name-blind. */\nexport interface ProjectedFundingEntry {\n\treadonly coin: string;\n\treadonly fullCoinType: string;\n\treadonly amount: bigint;\n}\n\nexport type ProjectedFunding = ReadonlyArray<ProjectedFundingEntry>;\n\nexport interface AccountFundingResult {\n\treadonly requested: ProjectedFunding;\n\treadonly applied: ProjectedFunding;\n}\n\n/** Request passed to account funding strategies. `amount` uses the\n *  funded coin's smallest unit. The resolved account handle is present\n *  so strategies without an admin signer can perform account-owned\n *  swaps while still sharing the central funding dispatcher. */\nexport interface AccountFundingRequest {\n\treadonly address: string;\n\treadonly amount: bigint;\n\treadonly account: AccountValue;\n}\n\nexport interface AccountFundingStrategy<E = unknown> {\n\treadonly request: (req: AccountFundingRequest) => Effect.Effect<void, E>;\n\t/** True when the strategy calls `account.withTransactionSigner`.\n\t *  The dispatcher must not acquire the same non-reentrant\n\t *  per-address lease outside the strategy. */\n\treadonly usesAccountSigner?: boolean;\n}\n\nexport interface FundingBalanceReader {\n\treadonly readBalance: (args: {\n\t\treadonly owner: string;\n\t\treadonly coinType: string;\n\t}) => Effect.Effect<bigint | null>;\n}\n\n/** The canonical builtin SUI coin type. Used by the funding dispatch\n *  to route SUI entries to the faucet strategy (same key as the\n *  default-funding pass), and by everything that needs to detect\n *  \"this is the protocol-defined SUI\". Mirrors `BUILTIN_COINS.sui`\n *  in the coin plugin. */\nexport const SUI_FULL_COIN_TYPE = '0x2::sui::SUI' as const;\n\n/** Default funding amount for ephemeral accounts — 1 SUI in MIST.\n *  Documented at the user-facing factory so a bare `account('alice')`\n *  is predictable. */\nexport const DEFAULT_EPHEMERAL_FUND_MIST = 1_000_000_000n;\n\nconst FUNDING_SETTLEMENT_INTERVAL_MS = 250;\nconst FUNDING_SETTLEMENT_TIMEOUT_MS = 30_000;\n\n/** Inputs the default-funding pass needs from the per-acquire ctx. */\nexport interface FundEphemeralDefaultArgs {\n\treadonly accountName: string;\n\treadonly address: string;\n\treadonly amountMist: bigint;\n\treadonly suiMode: 'local' | 'local-rpc' | 'live' | 'fork';\n\t/** Resolved sui chain id — the substrate-level chain identity used\n\t *  to compose the faucet strategy's capability key\n\t *  (`faucet:request:<chainId>`). */\n\treadonly chainId: ChainId;\n\t/** Loud-by-default auto-promotion event (called on fork before the\n\t *  strategy is invoked, per the architecture's \"no silent surprises\"\n\t *  principle). */\n\treadonly emitAutoPromotionEvent: () => Effect.Effect<void>;\n\t/** Substrate lease-broker handle — funding opens a fresh scope per\n\t *  wire call and acquires the per-address lease so concurrent wire\n\t *  calls for the same address serialize at the chain boundary. */\n\treadonly broker: LeaseBroker;\n\treadonly balanceReader?: FundingBalanceReader;\n}\n\n/** Apply the default-funding pass for an ephemeral account.\n *\n *  Wiring: yields `StrategyRegistryService` (the R-channel from\n *  Round 7), looks up the faucet strategy registered by the Sui\n *  plugin under `faucet:request:<chainId>`, and dispatches a request\n *  through it. Per-address serialization is enforced by acquiring\n *  the address lock around the wire call. */\nexport const fundEphemeralDefault = (\n\tparts: FundEphemeralDefaultArgs,\n): Effect.Effect<void, AccountAcquireError, StrategyRegistryService> =>\n\tEffect.gen(function* () {\n\t\t// LOUD AUTO-PROMOTION — distilled-doc invariant: \"no silent\n\t\t// surprises\". Emit BEFORE attempting the dispatch so the user\n\t\t// sees the path change even if the wire call subsequently\n\t\t// fails. On fork we surface the path-change event; on non-fork\n\t\t// the strategy registered by Sui IS the canonical default and\n\t\t// no auto-promotion is needed.\n\t\tif (parts.suiMode === 'fork') {\n\t\t\tyield* parts.emitAutoPromotionEvent();\n\t\t}\n\n\t\t// Zero-amount short-circuit — both real strategies treat zero\n\t\t// as a no-op; doing the same here avoids a registry lookup +\n\t\t// span emission for the legitimately-no-funding case.\n\t\tif (parts.amountMist <= 0n) {\n\t\t\treturn;\n\t\t}\n\n\t\tyield* setCurrentPluginPhase('checking SUI funding');\n\t\tconst existingBalance = yield* readExistingBalance(parts.balanceReader, {\n\t\t\towner: parts.address,\n\t\t\tcoinType: SUI_FULL_COIN_TYPE,\n\t\t});\n\t\tif (existingBalance !== null && existingBalance >= parts.amountMist) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Look up the strategy. Sui auto-registers a faucet strategy\n\t\t// on non-fork modes; fork-mode strategies have to be supplied\n\t\t// by the faucet plugin (with the fork admin closed over). If\n\t\t// nothing is registered we surface a typed, actionable error\n\t\t// pointing at the architecture's contract: ephemeral-on-non-\n\t\t// fork without a Faucet MUST fail at acquire time.\n\t\tconst strategy = yield* faucetCapabilityFor<FaucetStrategy>(parts.chainId).pipe(\n\t\t\tEffect.catchTag('StrategyNotFoundError', (err) =>\n\t\t\t\tEffect.fail(\n\t\t\t\t\taccountAcquireError({\n\t\t\t\t\t\tphase: 'fund-default',\n\t\t\t\t\t\taccountName: parts.accountName,\n\t\t\t\t\t\tvariant: 'ephemeral',\n\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t`Account '${parts.accountName}': no faucet strategy registered for ` +\n\t\t\t\t\t\t\t`chain '${parts.chainId}' (sui mode=${parts.suiMode}). ` +\n\t\t\t\t\t\t\t`Registered keys: [${err.registeredKeys.join(', ')}].`,\n\t\t\t\t\t\thint:\n\t\t\t\t\t\t\tparts.suiMode === 'fork'\n\t\t\t\t\t\t\t\t? 'Fork networks have no HTTP faucet — compose a plugin that contributes defineFaucetStrategy(...) for this chain id.'\n\t\t\t\t\t\t\t\t: 'Ensure a sui() plugin with a faucet-bearing mode (local/live-testnet/live-devnet) is in the stack.',\n\t\t\t\t\t}),\n\t\t\t\t),\n\t\t\t),\n\t\t);\n\n\t\t// Per-address serialization around the wire call. The lease is\n\t\t// scope-bound and releases as soon as `request(...)` returns;\n\t\t// two concurrent funding requests for the same address — e.g.\n\t\t// ephemeral default + cross-cutting SUI top-up — interleave\n\t\t// deterministically via the broker's FIFO queue.\n\t\tconst wrapFaucetFailure = (cause: {\n\t\t\treadonly _tag: 'FaucetUnreachable' | 'FaucetExhausted' | 'FaucetBodyError';\n\t\t}) =>\n\t\t\tEffect.fail(\n\t\t\t\taccountAcquireError({\n\t\t\t\t\tphase: 'fund-default',\n\t\t\t\t\taccountName: parts.accountName,\n\t\t\t\t\tvariant: 'ephemeral',\n\t\t\t\t\tmessage:\n\t\t\t\t\t\t`Account '${parts.accountName}': faucet strategy request failed ` +\n\t\t\t\t\t\t`for chain '${parts.chainId}' (tag=${cause._tag}).`,\n\t\t\t\t\tcause,\n\t\t\t\t\thint:\n\t\t\t\t\t\t'See the cause chain — typical roots are the faucet container ' +\n\t\t\t\t\t\t'not yet ready (FaucetUnreachable), the wall-clock budget elapsed ' +\n\t\t\t\t\t\t'(FaucetExhausted), or the body returned Failure (FaucetBodyError).',\n\t\t\t\t}),\n\t\t\t);\n\t\tyield* setCurrentPluginPhase('funding SUI');\n\t\tyield* withAddressLease(\n\t\t\tparts.broker,\n\t\t\tparts.accountName,\n\t\t\tparts.address,\n\t\t\tstrategy.request({ address: parts.address, amount: parts.amountMist }).pipe(\n\t\t\t\tEffect.catchTags({\n\t\t\t\t\tFaucetUnreachable: wrapFaucetFailure,\n\t\t\t\t\tFaucetExhausted: wrapFaucetFailure,\n\t\t\t\t\tFaucetBodyError: wrapFaucetFailure,\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\tyield* setCurrentPluginPhase('waiting for SUI funding settlement');\n\t\tyield* waitForBalanceAtLeast({\n\t\t\tbalanceReader: parts.balanceReader,\n\t\t\taccountName: parts.accountName,\n\t\t\tvariant: 'ephemeral',\n\t\t\tphase: 'fund-default',\n\t\t\towner: parts.address,\n\t\t\tcoinType: SUI_FULL_COIN_TYPE,\n\t\t\tcoinLabel: 'SUI',\n\t\t\tamount: parts.amountMist,\n\t\t});\n\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t'account.name': parts.accountName,\n\t\t\t'account.address': parts.address,\n\t\t\t'fund.amount.mist': parts.amountMist.toString(),\n\t\t\t'sui.chain': parts.chainId,\n\t\t\t'sui.mode': parts.suiMode,\n\t\t});\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.account.fundEphemeralDefault', {\n\t\t\tattributes: {\n\t\t\t\t'account.name': parts.accountName,\n\t\t\t\t'account.address': parts.address,\n\t\t\t\t'sui.mode': parts.suiMode,\n\t\t\t},\n\t\t}),\n\t);\n\n/** Inputs the cross-cutting funding pass needs from the per-acquire ctx.\n *\n *  `funding` is the PROJECTED shape — the acquire body in\n *  `account/index.ts` receives each user-supplied `CoinMember` as a\n *  resolved dependency and projects to `{fullCoinType, amount}` BEFORE\n *  invoking this pass. Keeps the dispatch logic substrate-name-blind. */\nexport interface ApplyCrossCuttingFundingArgs {\n\treadonly accountName: string;\n\treadonly address: string;\n\treadonly variant: AccountVariantKind;\n\treadonly account: AccountValue;\n\treadonly funding: ProjectedFunding;\n\treadonly chainId: ChainId;\n\treadonly broker: LeaseBroker;\n\treadonly balanceReader?: FundingBalanceReader;\n}\n\n/** Apply the cross-cutting funding pass. Variant-agnostic — runs for\n *  every variant once the keypair / impersonation slot is bound and\n *  the address is known.\n *\n *  Distilled-doc invariant: \"Optional Faucet is a noop, not an\n *  error\". Absence of a registered strategy for a non-SUI coin's\n *  capability key short-circuits silently (the entry is dropped).\n *  Explicit SUI entries are stricter: they route through the active\n *  chain's faucet strategy and fail loudly when none is registered.\n *  This lets a test author opt INTO arbitrary-coin funding without\n *  forcing every surrounding network to satisfy every custom coin.\n *\n *  Wiring: SUI entries (`fullCoinType === '0x2::sui::SUI'`) dispatch\n *  through `faucet:request:<chainId>` (same key as the default pass);\n *  other entries dispatch through `coinType:<fullCoinType>` keys\n *  contributed by the respective Coin/Walrus/Seal plugins.\n *\n *  Entries are processed serially. Strategies that use the resolved\n *  account signer acquire the per-address lease internally; strategies\n *  that do not are wrapped by this dispatcher. */\nexport const applyCrossCuttingFunding = (\n\tparts: ApplyCrossCuttingFundingArgs,\n): Effect.Effect<ProjectedFunding, AccountAcquireError, StrategyRegistryService> =>\n\tEffect.gen(function* () {\n\t\tif (parts.funding.length === 0) {\n\t\t\treturn [];\n\t\t}\n\t\tconst registry = yield* StrategyRegistryService;\n\t\tconst applied: ProjectedFundingEntry[] = [];\n\n\t\tfor (const entry of parts.funding) {\n\t\t\tif (entry.amount <= 0n) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tyield* setCurrentPluginPhase(`checking ${entry.coin} funding`);\n\t\t\tconst existingBalance = yield* readExistingBalance(parts.balanceReader, {\n\t\t\t\towner: parts.address,\n\t\t\t\tcoinType: entry.fullCoinType,\n\t\t\t});\n\t\t\tif (existingBalance !== null && existingBalance >= entry.amount) {\n\t\t\t\tapplied.push(entry);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Resolve the capability key from the projected coin type.\n\t\t\t//\n\t\t\t// SUI (`0x2::sui::SUI`) → reuse the faucet-request key so the\n\t\t\t// SUI auto-registered strategy fields the request (this\n\t\t\t// matches the default-funding pass and keeps the registry\n\t\t\t// surface uniform).\n\t\t\t//\n\t\t\t// Everything else → `coinType:<fullCoinType>` so user-defined\n\t\t\t// Coin plugins (and Walrus's exchange strategy keyed by\n\t\t\t// `coinType:<WAL fullCoinType>`) can contribute strategies\n\t\t\t// declaratively.\n\t\t\tconst isSui = entry.fullCoinType === SUI_FULL_COIN_TYPE;\n\t\t\tconst coinKey = `coinType:${entry.fullCoinType}` as const;\n\t\t\tconst lookup = isSui\n\t\t\t\t? faucetCapabilityFor<AccountFundingStrategy>(parts.chainId)\n\t\t\t\t: registry.get<typeof coinKey, AccountFundingStrategy>(coinKey);\n\n\t\t\t// Architecture-distilled: optional-faucet-is-noop for\n\t\t\t// arbitrary coins. Explicit SUI entries are the normal gas\n\t\t\t// faucet path, so missing strategy is actionable and loud.\n\t\t\tconst strategy = yield* lookup.pipe(\n\t\t\t\tEffect.catchTag('StrategyNotFoundError', (err) =>\n\t\t\t\t\tisSui\n\t\t\t\t\t\t? Effect.fail(\n\t\t\t\t\t\t\t\taccountAcquireError({\n\t\t\t\t\t\t\t\t\tphase: 'fund-cross-cutting',\n\t\t\t\t\t\t\t\t\taccountName: parts.accountName,\n\t\t\t\t\t\t\t\t\tvariant: parts.variant,\n\t\t\t\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\t\t\t`Account '${parts.accountName}': no SUI funding strategy registered ` +\n\t\t\t\t\t\t\t\t\t\t`for chain '${parts.chainId}'. Registered keys: [${err.registeredKeys.join(', ')}].`,\n\t\t\t\t\t\t\t\t\tcause: err,\n\t\t\t\t\t\t\t\t\thint: 'Ensure a sui() plugin with a faucet-bearing mode (local/live-testnet/live-devnet) is in the stack.',\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: Effect.succeed(null as AccountFundingStrategy | null),\n\t\t\t\t),\n\t\t\t);\n\t\t\tif (strategy === null) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst key = isSui ? (`faucet:request:${parts.chainId}` as const) : coinKey;\n\t\t\tconst wrapCrossCuttingFailure = (cause: unknown): AccountAcquireError => {\n\t\t\t\tconst tag =\n\t\t\t\t\ttypeof cause === 'object' && cause !== null && '_tag' in cause\n\t\t\t\t\t\t? String((cause as { readonly _tag?: unknown })._tag)\n\t\t\t\t\t\t: 'unknown';\n\t\t\t\treturn accountAcquireError({\n\t\t\t\t\tphase: 'fund-cross-cutting',\n\t\t\t\t\taccountName: parts.accountName,\n\t\t\t\t\tvariant: parts.variant,\n\t\t\t\t\tmessage:\n\t\t\t\t\t\t`Account '${parts.accountName}': cross-cutting funding ` +\n\t\t\t\t\t\t`failed for coin (key='${key}') amount=${entry.amount} ` +\n\t\t\t\t\t\t`(tag=${tag}).`,\n\t\t\t\t\tcause,\n\t\t\t\t\thint:\n\t\t\t\t\t\t'Cross-cutting funding requires the matching strategy ' +\n\t\t\t\t\t\t'to be registered at the time of acquire — check the ' +\n\t\t\t\t\t\t'plugin that contributes this coin and any `via` dependency.',\n\t\t\t\t});\n\t\t\t};\n\t\t\tconst request = strategy\n\t\t\t\t.request({ address: parts.address, amount: entry.amount, account: parts.account })\n\t\t\t\t.pipe(Effect.mapError(wrapCrossCuttingFailure));\n\t\t\tyield* setCurrentPluginPhase(`funding ${entry.coin}`);\n\t\t\tyield* strategy.usesAccountSigner === true\n\t\t\t\t? request\n\t\t\t\t: withAddressLease(parts.broker, parts.accountName, parts.address, request);\n\t\t\tyield* setCurrentPluginPhase(`waiting for ${entry.coin} funding settlement`);\n\t\t\tyield* waitForBalanceAtLeast({\n\t\t\t\tbalanceReader: parts.balanceReader,\n\t\t\t\taccountName: parts.accountName,\n\t\t\t\tvariant: parts.variant,\n\t\t\t\tphase: 'fund-cross-cutting',\n\t\t\t\towner: parts.address,\n\t\t\t\tcoinType: entry.fullCoinType,\n\t\t\t\tcoinLabel: entry.coin,\n\t\t\t\tamount: entry.amount,\n\t\t\t});\n\t\t\tapplied.push(entry);\n\t\t}\n\n\t\tyield* Effect.annotateCurrentSpan({\n\t\t\t'account.name': parts.accountName,\n\t\t\t'account.address': parts.address,\n\t\t\t'fund.cross-cutting.count': parts.funding.length,\n\t\t\t'sui.chain': parts.chainId,\n\t\t});\n\t\treturn applied;\n\t}).pipe(\n\t\tEffect.withSpan('devstack.plugin.account.applyCrossCuttingFunding', {\n\t\t\tattributes: {\n\t\t\t\t'account.name': parts.accountName,\n\t\t\t\t'account.address': parts.address,\n\t\t\t\t'fund.cross-cutting.entries': parts.funding.length,\n\t\t\t},\n\t\t}),\n\t);\n\nconst readExistingBalance = (\n\tbalanceReader: FundingBalanceReader | undefined,\n\targs: {\n\t\treadonly owner: string;\n\t\treadonly coinType: string;\n\t},\n): Effect.Effect<bigint | null> =>\n\tbalanceReader === undefined ? Effect.succeed(null) : balanceReader.readBalance(args);\n\nconst waitForBalanceAtLeast = (parts: {\n\treadonly balanceReader: FundingBalanceReader | undefined;\n\treadonly accountName: string;\n\treadonly variant: AccountVariantKind;\n\treadonly phase: 'fund-default' | 'fund-cross-cutting';\n\treadonly owner: string;\n\treadonly coinType: string;\n\treadonly coinLabel: string;\n\treadonly amount: bigint;\n}): Effect.Effect<void, AccountAcquireError> => {\n\tif (parts.balanceReader === undefined) {\n\t\treturn Effect.void;\n\t}\n\treturn Effect.gen(function* () {\n\t\tconst startedAt = Date.now();\n\t\tlet lastBalance: bigint | null = null;\n\t\tfor (;;) {\n\t\t\tlastBalance = yield* readExistingBalance(parts.balanceReader, {\n\t\t\t\towner: parts.owner,\n\t\t\t\tcoinType: parts.coinType,\n\t\t\t});\n\t\t\tif (lastBalance !== null && lastBalance >= parts.amount) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (Date.now() - startedAt >= FUNDING_SETTLEMENT_TIMEOUT_MS) {\n\t\t\t\treturn yield* Effect.fail(\n\t\t\t\t\taccountAcquireError({\n\t\t\t\t\t\tphase: parts.phase,\n\t\t\t\t\t\taccountName: parts.accountName,\n\t\t\t\t\t\tvariant: parts.variant,\n\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t`Account '${parts.accountName}': funding for ${parts.coinLabel} was accepted ` +\n\t\t\t\t\t\t\t`but balance did not reach ${parts.amount} before the settlement timeout ` +\n\t\t\t\t\t\t\t`(last=${lastBalance === null ? '<unavailable>' : lastBalance}).`,\n\t\t\t\t\t\thint:\n\t\t\t\t\t\t\t'The faucet or funding strategy returned before the funded coin became spendable. ' +\n\t\t\t\t\t\t\t'Check the funding strategy finality gate and Sui RPC health.',\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tyield* Effect.sleep(Duration.millis(FUNDING_SETTLEMENT_INTERVAL_MS));\n\t\t}\n\t});\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,54 @@
+import { CodegenableDecl } from "../../contracts/codegenable.mjs";
+import { ProjectionDecl } from "../../contracts/projection.mjs";
+import { SnapshotableDecl } from "../../contracts/snapshotable.mjs";
+import { StrategyContributorDecl } from "../../contracts/strategy-contributor.mjs";
+import { AnyResourceRef, Plugin, ResourceRef } from "../../substrate/plugin.mjs";
+import { SeedObjectsAccumulator } from "../sui/seed-objects.mjs";
+import { SuiClient } from "../sui/mode/shared.mjs";
+import { SuiOptions } from "../sui/mode/spec.mjs";
+import { AccountAcquireError, AccountAcquirePhase, AccountError, AccountSignError, AccountSignPhase, AccountVariantKind } from "./errors.mjs";
+import { AccountOptions, AccountValue, TxResult } from "./service.mjs";
+import { AccountFunding, AccountFundingCoinValue, AccountFundingEntry, AccountFundingRequest, AccountFundingResult, AccountFundingStrategy, CoinMember, CrossCuttingFundingEntry, CrossCuttingFundingProvider, DEFAULT_EPHEMERAL_FUND_MIST, ProjectedFunding, ProjectedFundingEntry, SUI_FULL_COIN_TYPE, SuiFundingEntry } from "./funding.mjs";
+import { AccountRegistryEntry, AccountRegistryFunding } from "./registry.mjs";
+import { AccountBindings } from "./codegen.mjs";
+import { ResolvedKeypair, SignatureScheme } from "./keypair.mjs";
+import { SyntheticImpersonationSigner } from "./variants/impersonate.mjs";
+//#region src/plugins/account/index.d.ts
+/** Per-account-instance resource. The substrate's resource id MUST be unique
+ *  across the stack — we encode the account name as a literal-typed
+ *  template literal so the compiler catches duplicate-name composes
+ *  at the `defineDevstack` call site.
+ *
+ *  Distilled-doc invariant: resource id flows into the on-disk path, the
+ *  manifest key, container labels, and generated TypeScript exports —
+ *  the identifier-safe name validation (in `service.ts`) protects
+ *  those call sites. */
+type AccountResourceId<Name extends string> = `account/${Name}`;
+/** Construct the account plugin instance.
+ *
+ *  Variants — typed at the API boundary via the discriminated
+ *  `AccountOptions` union. The factory's second arg is OPTIONAL —
+ *  omitting it yields the bare-form default (ephemeral + default
+ *  funding). Passing a non-matching `kind:` is a compile error
+ *  thanks to the union's discriminator.
+ *
+ *  Distilled-doc invariant: the name is validated at the FACTORY
+ *  boundary (not just at acquire time) so a typo surfaces
+ *  immediately, not at runtime. */
+type FundingCoinDependencies<Entries extends readonly unknown[]> = Entries extends readonly [infer Head, ...infer Tail] ? Head extends {
+  readonly coin: infer Coin;
+} ? Coin extends CoinMember ? readonly [Coin, ...FundingCoinDependencies<Tail>] : FundingCoinDependencies<Tail> : FundingCoinDependencies<Tail> : readonly [];
+type FundingProviderDependenciesFor<Provider> = Provider extends readonly AnyResourceRef[] ? Provider : Provider extends AnyResourceRef ? readonly [Provider] : readonly [];
+type FundingEntryProviderDependencies<Entry> = Entry extends {
+  readonly coin: CoinMember;
+} ? 'via' extends keyof Entry ? Entry extends {
+  readonly via: infer Provider;
+} ? FundingProviderDependenciesFor<Provider> : readonly [] : readonly [] : readonly [];
+type FundingProviderDependencies<Entries extends readonly unknown[]> = Entries extends readonly [infer Head, ...infer Tail] ? readonly [...FundingEntryProviderDependencies<Head>, ...FundingProviderDependencies<Tail>] : readonly [];
+declare const account: <const N extends string, const Funding extends AccountFunding = readonly []>(name: N, opts?: AccountOptions<Funding>) => Plugin<`account/${N}`, AccountValue, readonly [ResourceRef<"sui", SuiClient & {
+  readonly mode: SuiOptions["mode"];
+  readonly seedObjects: SeedObjectsAccumulator;
+}>, ...FundingCoinDependencies<Funding>, ...FundingProviderDependencies<Funding>], readonly [SnapshotableDecl, CodegenableDecl<`account/${N}`>, StrategyContributorDecl<`account:${N}`, AccountRegistryEntry>, ProjectionDecl]>;
+//#endregion
+export { AccountResourceId, account };
+//# sourceMappingURL=index.d.mts.map

package/dist/plugins/account/index.mjs

@@ -0,0 +1,151 @@
+import { definePlugin, resource } from "../../substrate/plugin.mjs";
+import { pluginErrorContributions } from "../../api/plugin-errors.mjs";
+import { IdentityContext, StackPathsService } from "../../substrate/runtime/paths.mjs";
+import { SpanAttr } from "../../substrate/runtime/observability/spans.mjs";
+import { suiResource } from "../sui/index.mjs";
+import { makeAccountCodegen } from "./codegen.mjs";
+import { ACCOUNT_ERROR_TAGS } from "./errors.mjs";
+import { SUI_FULL_COIN_TYPE } from "./funding.mjs";
+import { makeAccountProjectionContribution, makeAccountRegistryContribution } from "./registry.mjs";
+import { makeAccountSnapshotable } from "./snapshot.mjs";
+import { acquireAccount, assertAccountName } from "./service.mjs";
+import { Effect } from "effect";
+//#region src/plugins/account/index.ts
+const accountErrorContributions = pluginErrorContributions(ACCOUNT_ERROR_TAGS);
+const accountResource = (name) => resource(`account/${name}`);
+const isCoinFundingEntry = (entry) => typeof entry === "object" && entry.coin !== "sui";
+const fundingProviders = (provider) => {
+	if (provider === void 0) return [];
+	return Array.isArray(provider) ? provider : [provider];
+};
+const fundingAmountToBigInt = (amount) => {
+	if (typeof amount === "bigint") {
+		if (amount < 0n) throw new TypeError(`SUI funding amount must be a non-negative integer in MIST.`);
+		return amount;
+	}
+	if (!Number.isSafeInteger(amount) || amount < 0) throw new TypeError(`SUI funding amount must be a non-negative safe integer in MIST.`);
+	return BigInt(amount);
+};
+const coinLabelFor = (coin) => coin.symbol ?? coin.fullCoinType.split("::").at(-1) ?? coin.fullCoinType;
+const account = (name, opts) => {
+	assertAccountName(name);
+	const opts2 = opts === void 0 ? {
+		kind: "ephemeral",
+		name
+	} : {
+		...opts,
+		name
+	};
+	const accountRef = accountResource(name);
+	const fundingEntryList = opts?.funding ?? [];
+	const coinFundingEntries = fundingEntryList.filter(isCoinFundingEntry);
+	const fundingMembers = coinFundingEntries.map((e) => e.coin);
+	const strategyProviderMembers = coinFundingEntries.flatMap((entry) => fundingProviders(entry.via));
+	const dependencies = [
+		suiResource,
+		...fundingMembers,
+		...strategyProviderMembers
+	];
+	return definePlugin({
+		id: accountRef.id,
+		dependsOn: dependencies,
+		role: "task",
+		start: (deps) => Effect.gen(function* () {
+			const [sui, ...resolvedDeps] = deps;
+			const resolvedCoinValues = resolvedDeps.slice(0, coinFundingEntries.length);
+			const identity = yield* IdentityContext;
+			const paths = yield* StackPathsService;
+			let coinIndex = 0;
+			const projectedFunding = fundingEntryList.map((entry) => {
+				if (entry.coin === "sui") return {
+					coin: "SUI",
+					fullCoinType: SUI_FULL_COIN_TYPE,
+					amount: fundingAmountToBigInt(entry.amount)
+				};
+				const resolvedCoin = resolvedCoinValues[coinIndex];
+				coinIndex += 1;
+				return {
+					coin: coinLabelFor(resolvedCoin),
+					fullCoinType: resolvedCoin.fullCoinType,
+					amount: entry.amount
+				};
+			});
+			return yield* acquireAccount(opts2, {
+				sui: {
+					mode: sui.mode,
+					chain: sui.chain,
+					sdk: sui.sdk,
+					fork: sui.fork
+				},
+				runtimeRoot: paths.stackRoot,
+				app: identity.app,
+				stack: identity.stack,
+				emitAutoPromotionEvent: () => Effect.logWarning("account funding auto-promoted for fork mode").pipe(Effect.annotateLogs({
+					[SpanAttr.accountName]: name,
+					[SpanAttr.accountFundingFrom]: "faucet",
+					[SpanAttr.accountFundingTo]: "pay-from-seed-via-impersonate",
+					[SpanAttr.suiMode]: "fork"
+				})),
+				projectedFunding
+			});
+		}),
+		errorContributions: accountErrorContributions,
+		capabilities: ({ value: resolved, runtime: acquireCtx2 }) => {
+			const realEntry = {
+				name,
+				address: resolved.address,
+				scheme: resolved.scheme,
+				source: resolved.source,
+				funding: fundingProjectionForResult(resolved.funding)
+			};
+			const bindings = {
+				name,
+				address: resolved.address,
+				scheme: resolved.scheme,
+				source: resolved.source
+			};
+			return [
+				makeAccountSnapshotable({
+					accountName: name,
+					variant: opts2.kind,
+					app: acquireCtx2.identity.app,
+					stack: acquireCtx2.identity.stack
+				}),
+				makeAccountCodegen({
+					name,
+					resolved: bindings
+				}),
+				makeAccountRegistryContribution(realEntry),
+				makeAccountProjectionContribution(realEntry)
+			];
+		}
+	});
+};
+const fundingProjectionForResult = (funding) => {
+	if (funding.requested.length === 0) return {
+		status: "skipped",
+		balanceMist: null,
+		requestedMist: null,
+		entries: []
+	};
+	const appliedKeys = new Set(funding.applied.map(fundingEntryKey));
+	const entries = funding.requested.map((entry) => ({
+		coin: entry.coin,
+		fullCoinType: entry.fullCoinType,
+		amount: entry.amount.toString(),
+		status: appliedKeys.has(fundingEntryKey(entry)) ? "funded" : "skipped"
+	}));
+	const requestedMist = funding.requested.find((entry) => entry.fullCoinType === "0x2::sui::SUI")?.amount.toString() ?? null;
+	const fundedCount = entries.filter((entry) => entry.status === "funded").length;
+	return {
+		status: fundedCount === entries.length ? "funded" : fundedCount === 0 ? "skipped" : "unknown",
+		balanceMist: null,
+		requestedMist,
+		entries
+	};
+};
+const fundingEntryKey = (entry) => `${entry.fullCoinType}:${entry.amount}`;
+//#endregion
+export { account };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugins/account/index.ts"],"sourcesContent":["// Account plugin — barrel + `account(name, opts?)` factory.\n//\n// Architecture (12-account.md): Account is the named-identity layer\n// for devstack. It acquires a keypair (or impersonation slot), funds\n// it (default + cross-cutting), registers `{name, address}`, and\n// publishes a per-account resolved value via a unique resource id.\n//\n// User-facing factory shape:\n//\n//   account('alice')                                  // default ephemeral\n//   account('alice', { kind: 'ephemeral', funding: [{ coin: 'sui', amount: 5_000_000_000n }] })\n//   account('alice', { kind: 'keystore', path: '~/.sui/keystore', aliasOrAddress: 'alice' })\n//   account('alice', { kind: 'env',      key: 'ALICE_PRIVATE_KEY' })\n//   account('alice', { kind: 'inline',   privateKey: 'suiprivkey1...' })\n//   account('alice', { kind: 'signer',   signer: hardwareWallet })\n//   account('alice', { kind: 'impersonate', address: '0xabc...' })\n//\n// **Bare-form default**: `account('alice')` is shorthand for\n//\n//   { kind: 'ephemeral' } plus default SUI funding.\n//\n// Distilled-doc invariant (12-account.md \"Make the bare-form auto-\n// promotion to fork-impersonate funding discoverable\"): on fork-\n// runtime Sui, the default-funding pass internally promotes from\n// \"faucet POST\" to \"pay-from-seed-via-impersonate\" because no\n// faucet exists on a fork. The promotion is LOUD by default — we\n// emit a `log.appended` event the first time the promotion fires\n// (see `funding.ts`).\n//\n// The plugin emits THREE capability decls + an error-tag contribution:\n//\n//   1. Snapshotable        — secret-material subtree (ephemeral only).\n//   2. Codegenable         — `account-map` bindings (name → address).\n//   3. StrategyContributor — per-stack `account:<name>` registry entry.\n//\n// Plus `errorContributions: [{ errorTags: ACCOUNT_ERROR_TAGS }]` —\n// harvested by the supervisor into the FormatterRegistry so the\n// cascade formatter renders account-tagged failures with the right\n// taxonomy header.\n\nimport { Effect } from 'effect';\n\nimport { definePlugin, resource, type AnyResourceRef } from '../../api/define-plugin.ts';\nimport { pluginErrorContributions } from '../../api/plugin-errors.ts';\nimport { SpanAttr } from '../../substrate/runtime/observability/spans.ts';\nimport { IdentityContext, StackPathsService } from '../../substrate/runtime/paths.ts';\nimport { suiResource } from '../sui/index.ts';\n\nimport { makeAccountCodegen, type AccountBindings } from './codegen.ts';\nimport { ACCOUNT_ERROR_TAGS } from './errors.ts';\nimport {\n\tSUI_FULL_COIN_TYPE,\n\ttype AccountFunding,\n\ttype AccountFundingEntry,\n\ttype AccountFundingResult,\n\ttype CrossCuttingFundingEntry,\n\ttype CrossCuttingFundingProvider,\n\ttype CoinMember,\n\ttype ProjectedFundingEntry,\n} from './funding.ts';\nimport {\n\tmakeAccountProjectionContribution,\n\tmakeAccountRegistryContribution,\n\ttype AccountRegistryEntry,\n\ttype AccountRegistryFunding,\n} from './registry.ts';\nimport { makeAccountSnapshotable } from './snapshot.ts';\nimport {\n\tacquireAccount,\n\tassertAccountName,\n\ttype AccountAcquireContext,\n\ttype AccountOptions,\n\ttype ResolvedAccountOptions,\n\ttype AccountValue,\n} from './service.ts';\n\nconst accountErrorContributions = pluginErrorContributions(ACCOUNT_ERROR_TAGS);\n\n// ---------------------------------------------------------------------------\n// Resource construction\n// ---------------------------------------------------------------------------\n\n/** Per-account-instance resource. The substrate's resource id MUST be unique\n *  across the stack — we encode the account name as a literal-typed\n *  template literal so the compiler catches duplicate-name composes\n *  at the `defineDevstack` call site.\n *\n *  Distilled-doc invariant: resource id flows into the on-disk path, the\n *  manifest key, container labels, and generated TypeScript exports —\n *  the identifier-safe name validation (in `service.ts`) protects\n *  those call sites. */\nexport type AccountResourceId<Name extends string> = `account/${Name}`;\n\nconst accountResource = <Name extends string>(name: Name) =>\n\tresource<AccountResourceId<Name>, AccountValue>(`account/${name}` as AccountResourceId<Name>);\n\n// ---------------------------------------------------------------------------\n// User-facing factory\n// ---------------------------------------------------------------------------\n\n/** Construct the account plugin instance.\n *\n *  Variants — typed at the API boundary via the discriminated\n *  `AccountOptions` union. The factory's second arg is OPTIONAL —\n *  omitting it yields the bare-form default (ephemeral + default\n *  funding). Passing a non-matching `kind:` is a compile error\n *  thanks to the union's discriminator.\n *\n *  Distilled-doc invariant: the name is validated at the FACTORY\n *  boundary (not just at acquire time) so a typo surfaces\n *  immediately, not at runtime. */\ntype FundingCoinDependencies<Entries extends readonly unknown[]> = Entries extends readonly [\n\tinfer Head,\n\t...infer Tail,\n]\n\t? Head extends { readonly coin: infer Coin }\n\t\t? Coin extends CoinMember\n\t\t\t? readonly [Coin, ...FundingCoinDependencies<Tail>]\n\t\t\t: FundingCoinDependencies<Tail>\n\t\t: FundingCoinDependencies<Tail>\n\t: readonly [];\n\ntype FundingProviderDependenciesFor<Provider> = Provider extends readonly AnyResourceRef[]\n\t? Provider\n\t: Provider extends AnyResourceRef\n\t\t? readonly [Provider]\n\t\t: readonly [];\n\ntype FundingEntryProviderDependencies<Entry> = Entry extends { readonly coin: CoinMember }\n\t? 'via' extends keyof Entry\n\t\t? Entry extends { readonly via: infer Provider }\n\t\t\t? FundingProviderDependenciesFor<Provider>\n\t\t\t: readonly []\n\t\t: readonly []\n\t: readonly [];\n\ntype FundingProviderDependencies<Entries extends readonly unknown[]> = Entries extends readonly [\n\tinfer Head,\n\t...infer Tail,\n]\n\t? readonly [...FundingEntryProviderDependencies<Head>, ...FundingProviderDependencies<Tail>]\n\t: readonly [];\n\ntype AccountDependencyMembers<Funding extends AccountFunding> = readonly [\n\ttypeof suiResource,\n\t...FundingCoinDependencies<Funding>,\n\t...FundingProviderDependencies<Funding>,\n];\n\nconst isCoinFundingEntry = (entry: AccountFundingEntry): entry is CrossCuttingFundingEntry =>\n\ttypeof entry === 'object' && entry.coin !== 'sui';\n\nconst fundingProviders = (\n\tprovider: CrossCuttingFundingProvider | undefined,\n): ReadonlyArray<AnyResourceRef> => {\n\tif (provider === undefined) return [];\n\treturn Array.isArray(provider)\n\t\t? (provider as ReadonlyArray<AnyResourceRef>)\n\t\t: [provider as AnyResourceRef];\n};\n\nconst fundingAmountToBigInt = (amount: number | bigint): bigint => {\n\tif (typeof amount === 'bigint') {\n\t\tif (amount < 0n) {\n\t\t\tthrow new TypeError(`SUI funding amount must be a non-negative integer in MIST.`);\n\t\t}\n\t\treturn amount;\n\t}\n\tif (!Number.isSafeInteger(amount) || amount < 0) {\n\t\tthrow new TypeError(`SUI funding amount must be a non-negative safe integer in MIST.`);\n\t}\n\treturn BigInt(amount);\n};\n\nconst coinLabelFor = (coin: { readonly fullCoinType: string; readonly symbol?: string }): string =>\n\tcoin.symbol ?? coin.fullCoinType.split('::').at(-1) ?? coin.fullCoinType;\n\nexport const account = <const N extends string, const Funding extends AccountFunding = readonly []>(\n\tname: N,\n\topts?: AccountOptions<Funding>,\n) => {\n\tassertAccountName(name);\n\n\t// Normalize bare-form to ephemeral default. The user-facing\n\t// `AccountOptions` union does not include \"kind absent\" — we\n\t// inject the default here so the rest of the body sees a\n\t// fully-discriminated value.\n\tconst opts2: ResolvedAccountOptions =\n\t\topts === undefined\n\t\t\t? { kind: 'ephemeral', name }\n\t\t\t: ({ ...opts, name } as ResolvedAccountOptions);\n\n\tconst accountRef = accountResource(name);\n\n\t// Pull the funding resource tuple out of opts (may be undefined for\n\t// the bare form / variants without funding). The tuple preserves\n\t// plugin-valued refs when the caller passed coin plugins, so\n\t// recursive stack composition can include those publishers.\n\tconst fundingEntries = (opts?.funding ?? []) as unknown as Funding;\n\tconst fundingEntryList = fundingEntries as AccountFunding;\n\tconst coinFundingEntries = fundingEntryList.filter(isCoinFundingEntry);\n\tconst fundingMembers = coinFundingEntries.map((e) => e.coin);\n\tconst strategyProviderMembers = coinFundingEntries.flatMap((entry) =>\n\t\tfundingProviders(entry.via),\n\t);\n\tconst dependencies = [\n\t\tsuiResource,\n\t\t...fundingMembers,\n\t\t...strategyProviderMembers,\n\t] as unknown as AccountDependencyMembers<Funding>;\n\n\treturn definePlugin({\n\t\tid: accountRef.id,\n\t\tdependsOn: dependencies,\n\t\t// Account is a value-producer (no long-lived server / container);\n\t\t// tasks acquire their value, publish contributions, then reach\n\t\t// `done`.\n\t\trole: 'task',\n\t\tstart: (deps) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tconst [sui, ...resolvedDeps] = deps;\n\t\t\t\tconst resolvedCoinValues = resolvedDeps.slice(\n\t\t\t\t\t0,\n\t\t\t\t\tcoinFundingEntries.length,\n\t\t\t\t) as ReadonlyArray<{\n\t\t\t\t\treadonly fullCoinType: string;\n\t\t\t\t\treadonly symbol?: string;\n\t\t\t\t}>;\n\t\t\t\t// Identity + on-disk runtime root come from the\n\t\t\t\t// supervisor-provided substrate context.\n\t\t\t\tconst identity = yield* IdentityContext;\n\t\t\t\tconst paths = yield* StackPathsService;\n\n\t\t\t\t// Project each funding dependency value to a\n\t\t\t\t// `{fullCoinType, amount}` projection. Dependency order\n\t\t\t\t// mirrors `fundingEntries`, after the hard Sui upstream.\n\t\t\t\tlet coinIndex = 0;\n\t\t\t\tconst projectedFunding: ReadonlyArray<ProjectedFundingEntry> = fundingEntryList.map(\n\t\t\t\t\t(entry) => {\n\t\t\t\t\t\tif (entry.coin === 'sui') {\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tcoin: 'SUI',\n\t\t\t\t\t\t\t\tfullCoinType: SUI_FULL_COIN_TYPE,\n\t\t\t\t\t\t\t\tamount: fundingAmountToBigInt(entry.amount),\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst resolvedCoin = resolvedCoinValues[coinIndex]!;\n\t\t\t\t\t\tcoinIndex += 1;\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcoin: coinLabelFor(resolvedCoin),\n\t\t\t\t\t\t\tfullCoinType: resolvedCoin.fullCoinType,\n\t\t\t\t\t\t\tamount: entry.amount,\n\t\t\t\t\t\t};\n\t\t\t\t\t},\n\t\t\t\t);\n\n\t\t\t\tconst acquireCtx: AccountAcquireContext = {\n\t\t\t\t\tsui: {\n\t\t\t\t\t\tmode: sui.mode,\n\t\t\t\t\t\tchain: sui.chain,\n\t\t\t\t\t\tsdk: sui.sdk,\n\t\t\t\t\t\tfork: sui.fork,\n\t\t\t\t\t},\n\t\t\t\t\truntimeRoot: paths.stackRoot,\n\t\t\t\t\tapp: identity.app,\n\t\t\t\t\tstack: identity.stack,\n\t\t\t\t\temitAutoPromotionEvent: () =>\n\t\t\t\t\t\tEffect.logWarning('account funding auto-promoted for fork mode').pipe(\n\t\t\t\t\t\t\tEffect.annotateLogs({\n\t\t\t\t\t\t\t\t[SpanAttr.accountName]: name,\n\t\t\t\t\t\t\t\t[SpanAttr.accountFundingFrom]: 'faucet',\n\t\t\t\t\t\t\t\t[SpanAttr.accountFundingTo]: 'pay-from-seed-via-impersonate',\n\t\t\t\t\t\t\t\t[SpanAttr.suiMode]: 'fork',\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t),\n\t\t\t\t\tprojectedFunding,\n\t\t\t\t};\n\t\t\t\treturn yield* acquireAccount(opts2, acquireCtx);\n\t\t\t}),\n\t\t// Dynamic capability factory — receives the resolved\n\t\t// `AccountValue` + acquire context AFTER `acquire` succeeds.\n\t\t// Lets snapshot + codegen + registry decls reference the\n\t\t// REAL address (and identity app/stack) — the static form\n\t\t// would force placeholder values for fields only known at\n\t\t// acquire time.\n\t\terrorContributions: accountErrorContributions,\n\t\tcapabilities: ({ value: resolved, runtime: acquireCtx2 }) => {\n\t\t\tconst realEntry: AccountRegistryEntry = {\n\t\t\t\tname,\n\t\t\t\taddress: resolved.address,\n\t\t\t\tscheme: resolved.scheme,\n\t\t\t\tsource: resolved.source,\n\t\t\t\tfunding: fundingProjectionForResult(resolved.funding),\n\t\t\t};\n\t\t\tconst bindings: AccountBindings = {\n\t\t\t\tname,\n\t\t\t\taddress: resolved.address,\n\t\t\t\tscheme: resolved.scheme,\n\t\t\t\tsource: resolved.source,\n\t\t\t};\n\t\t\tconst snapshot = makeAccountSnapshotable({\n\t\t\t\taccountName: name,\n\t\t\t\tvariant: opts2.kind,\n\t\t\t\tapp: acquireCtx2.identity.app,\n\t\t\t\tstack: acquireCtx2.identity.stack,\n\t\t\t});\n\t\t\tconst codegen = makeAccountCodegen<N>({ name, resolved: bindings });\n\t\t\tconst registry = makeAccountRegistryContribution<N>(\n\t\t\t\trealEntry as AccountRegistryEntry & { readonly name: N },\n\t\t\t);\n\t\t\tconst projection = makeAccountProjectionContribution<N>(\n\t\t\t\trealEntry as AccountRegistryEntry & { readonly name: N },\n\t\t\t);\n\t\t\treturn [snapshot, codegen, registry, projection] as const;\n\t\t},\n\t});\n};\n\nconst fundingProjectionForResult = (funding: AccountFundingResult): AccountRegistryFunding => {\n\tif (funding.requested.length === 0) {\n\t\treturn { status: 'skipped', balanceMist: null, requestedMist: null, entries: [] };\n\t}\n\n\tconst appliedKeys = new Set(funding.applied.map(fundingEntryKey));\n\tconst entries = funding.requested.map((entry) => ({\n\t\tcoin: entry.coin,\n\t\tfullCoinType: entry.fullCoinType,\n\t\tamount: entry.amount.toString(),\n\t\tstatus: appliedKeys.has(fundingEntryKey(entry)) ? ('funded' as const) : ('skipped' as const),\n\t}));\n\tconst requestedMist =\n\t\tfunding.requested\n\t\t\t.find((entry) => entry.fullCoinType === SUI_FULL_COIN_TYPE)\n\t\t\t?.amount.toString() ?? null;\n\tconst fundedCount = entries.filter((entry) => entry.status === 'funded').length;\n\treturn {\n\t\tstatus: fundedCount === entries.length ? 'funded' : fundedCount === 0 ? 'skipped' : 'unknown',\n\t\tbalanceMist: null,\n\t\trequestedMist,\n\t\tentries,\n\t};\n};\n\nconst fundingEntryKey = (entry: ProjectedFundingEntry): string =>\n\t`${entry.fullCoinType}:${entry.amount}`;\n\n// ---------------------------------------------------------------------------\n// Re-exports for advanced callers (Coin, Wallet, Package)\n// ---------------------------------------------------------------------------\n\nexport type { AccountOptions, ResolvedAccountOptions, AccountValue, TxResult } from './service.ts';\nexport type {\n\tAccountError,\n\tAccountAcquireError,\n\tAccountAcquirePhase,\n\tAccountSignError,\n\tAccountSignPhase,\n\tAccountVariantKind,\n} from './errors.ts';\nexport { ACCOUNT_ERROR_TAGS } from './errors.ts';\nexport type {\n\tAccountFunding,\n\tAccountFundingEntry,\n\tAccountFundingCoinValue,\n\tAccountFundingResult,\n\tAccountFundingRequest,\n\tAccountFundingStrategy,\n\tCoinMember,\n\tCrossCuttingFundingEntry,\n\tCrossCuttingFundingProvider,\n\tProjectedFunding,\n\tProjectedFundingEntry,\n\tSuiFundingEntry,\n} from './funding.ts';\nexport { DEFAULT_EPHEMERAL_FUND_MIST, SUI_FULL_COIN_TYPE } from './funding.ts';\nexport type { AccountBindings } from './codegen.ts';\nexport type {\n\tAccountRegistryEntry,\n\tAccountRegistryFunding,\n\tAccountRegistryKey,\n} from './registry.ts';\nexport { accountRegistryKey } from './registry.ts';\nexport type { SyntheticImpersonationSigner } from './variants/impersonate.ts';\nexport type { SignatureScheme, ResolvedKeypair } from './keypair.ts';\n"],"mappings":"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"}

package/dist/plugins/account/keypair.d.mts

@@ -0,0 +1,32 @@
+import { Effect } from "effect";
+
+//#region src/plugins/account/keypair.d.ts
+/** Lowercased signature scheme — the canonical wire form. The SDK
+ *  occasionally hands us `'ED25519'` / `'Secp256k1'`; the boundary
+ *  conversion lives in `normalizeScheme`. */
+type SignatureScheme = 'ed25519' | 'secp256k1' | 'secp256r1';
+/** Resolved keypair shape — the variant resolvers all funnel into
+ *  this so the funding + register passes are variant-agnostic.
+ *
+ *  Note: impersonation accounts do NOT produce a `Keypair`; they
+ *  produce a `SyntheticImpersonationSigner` (see
+ *  `variants/impersonate.ts`). The discriminator lives on the
+ *  resolved `AccountValue` (architecture: distilled doc opportunity
+ *  "Tighten the resolved-account type"). */
+interface ResolvedKeypair {
+  readonly address: string;
+  readonly scheme: SignatureScheme;
+  readonly publicKey: Uint8Array;
+  /** Opaque signer handle — typed loosely here because the four
+   *  real variants (ed25519/secp256k1/secp256r1 + bring-your-own
+   *  Signer) share no narrow TS type beyond `Signer`. The wallet /
+   *  sign-and-execute capability narrows downstream. */
+  readonly signer: unknown;
+  /** Bech32-encoded secret. Only present for ephemeral / inline /
+   *  env / keystore variants — `null` for `signer` (we never ask
+   *  for it) and `impersonate` (no secret exists). */
+  readonly bech32Secret: string | null;
+}
+//#endregion
+export { ResolvedKeypair, SignatureScheme };
+//# sourceMappingURL=keypair.d.mts.map