@usebutr/wallet-standard-shared 0.2.5 → 0.3.0

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import { Account, ChainBase, WalletAdapter } from "@usebutr/core";
-
+import { Account, ChainBase, ConnectorEvent, WalletAdapter, buildAccount } from "@usebutr/core";
 //#region src/types.d.ts
 /**
  * Minimal type surface for the Wallet Standard protocol that every
  * platform-specific package (`@usebutr/svm`, `@usebutr/sui`,
  * `@usebutr/bitcoin`) shares. Declared inline so butr stays
- * self-contained at the type level — the actual `@wallet-standard/app`
+ * self-contained at the type level; the actual `@wallet-standard/app`
  * package is dynamic-imported at runtime, and apps that don't enable
  * Wallet Standard discovery never resolve it.
  *
@@ -18,7 +17,8 @@ import { Account, ChainBase, WalletAdapter } from "@usebutr/core";
 type WalletStandardWalletAccount = {
   address: string;
   chains: ReadonlyArray<string>;
-  features: ReadonlyArray<string>; /** Public key bytes — Wallet Standard ships these as Uint8Array. */
+  features: ReadonlyArray<string>;
+  /** Public key bytes; Wallet Standard ships these as Uint8Array. */
   publicKey?: Uint8Array;
 };
 type WalletStandardWallet = {
@@ -72,17 +72,14 @@ type StandardEventsFeature = {
 declare const slugify: (platformPrefix: string, name: string) => string;
 /**
  * Read a Wallet Standard feature off a wallet, returning `undefined`
- * when absent. The caller narrows the unknown payload to the
- * platform-specific feature shape at use sites.
+ * when absent. `features` is a reverse-DNS-keyed registry typed
+ * `Record<string, unknown>` by the spec, so the caller declares the
+ * concrete feature shape it expects; this accessor is the single
+ * boundary where that dynamism is acknowledged. The `T` parameter is
+ * intentionally caller-supplied (not inferable) and the assertion is
+ * unavoidable for an untyped registry.
  */
 declare const getFeature: <T>(wallet: WalletStandardWallet, name: string) => T | undefined;
-/**
- * Build butr's `Account` shape from a Wallet Standard account address
- * and a resolved `ChainBase`. The composite id (`<chain>:<address>`)
- * is what butr's reducer uses to compare accounts across refreshes,
- * so keep this format identical across platforms.
- */
-declare const buildAccount: (address: string, chain: ChainBase) => Account;
 /**
  * Pick the first address out of a wallet's accounts array, returning
  * `null` when the wallet currently exposes none.
@@ -98,12 +95,81 @@ declare const pickFirstAddress: (accounts: ReadonlyArray<WalletStandardWalletAcc
  */
 declare const pickAccountByAddress: (accounts: ReadonlyArray<WalletStandardWalletAccount>, address: string) => WalletStandardWalletAccount | undefined;
 //#endregion
+//#region src/adapter-core.d.ts
+type WalletStandardCoreInput = {
+  /** CAIP-2 prefix including its colon (`solana:`, `sui:`, `bip122:`). */
+  chainPrefix: string;
+  /** Stable adapter id. Each platform package owns its own slug prefix. */
+  id: string;
+  /** How this adapter names itself in errors (`Bitcoin`, `SVM`, `Sui`). */
+  label: string;
+  /** CAIP-2 namespace without its colon. */
+  namespace: string;
+  /** How the chain family reads in errors (`Bitcoin`, `Solana`, `Sui`). */
+  platform: string;
+  /** Chain ids worth preferring over a bare prefix match. Matched against
+   *  the wallet's own ordering, so a wallet listing `mainnet-beta` before
+   *  `mainnet` keeps the chain it advertised first. */
+  preferredChainIds: ReadonlyArray<string>;
+  /** Called with a function that pushes a synthetic `disconnected` event
+   *  to all current subscribers. The discovery layer invokes it on Wallet
+   *  Standard `unregister`. */
+  registerDisconnector?: (emit: () => void) => void;
+  /** Re-point the active chain when the wallet reports a `chains` change.
+   *  Polkadot opts out: its wallets advertise a single relay chain, so a
+   *  re-point would only ever move the adapter off the chain it resolved. */
+  trackChainChanges: boolean;
+  wallet: WalletStandardWallet;
+};
+type WalletStandardCore = {
+  /** Chains the wallet advertises in this namespace; feeds capability gating. */
+  chainCount: number;
+  connect: (opts?: {
+    silent?: boolean;
+  }) => Promise<void>;
+  /** Active CAIP-2 chain id, for features that take a per-call `chain`. */
+  currentChainId: () => string;
+  disconnect: () => Promise<void>;
+  getAccount: () => Promise<Account | null>;
+  getAccounts: () => Promise<Array<Account>>;
+  getSigner: () => Promise<unknown>;
+  /** Whether the wallet advertises `standard:events`; feeds capability gating. */
+  hasEvents: boolean;
+  icon: string | undefined;
+  id: string;
+  name: string;
+  /** Wallet Standard account a call should route through: the one matching
+   *  `account`, else the wallet's first exposed account. */
+  resolveAccount: (account?: {
+    walletAddress: string;
+  }) => WalletStandardWalletAccount;
+  subscribe: (listener: (event: ConnectorEvent) => void) => () => void;
+  switchChain: (chain: ChainBase) => Promise<void>;
+  /** butr chain for the active chain id, for responses that mint their own
+   *  `Account` (Sign-In-With-Solana) rather than going through `getAccounts`. */
+  toChain: () => ChainBase;
+};
+/**
+ * Session plumbing every Wallet Standard platform adapter repeats: chain
+ * resolution, the connect/disconnect handshake, account reads, the local
+ * listener set that lets `switchChain` synthesise `accountChanged`, and
+ * the `standard:events` bridge. Returns `null` for wallets butr can't
+ * drive (no chain in this namespace, or no `standard:connect`), which is
+ * the same `null` each platform adapter returns to its caller.
+ *
+ * Platform packages keep what genuinely differs: which features they read
+ * off the wallet, how they encode transactions and messages, and their
+ * balance units. `getSigner` hands back the raw Wallet Standard wallet so
+ * consumers can wrap it in their own signing library.
+ */
+declare const createWalletStandardCore: ({ chainPrefix, id, label, namespace, platform, preferredChainIds, registerDisconnector, trackChainChanges, wallet }: WalletStandardCoreInput) => WalletStandardCore | null;
+//#endregion
 //#region src/discovery.d.ts
 /**
  * Callback supplied by per-platform discovery to build a `WalletAdapter`
  * out of a Wallet Standard wallet announcement.
  *
- * Returns `null` when the wallet doesn't advertise this platform — that
+ * Returns `null` when the wallet doesn't advertise this platform; that
  * lets a multi-chain wallet (e.g. Phantom: SVM + EVM + Sui + Bitcoin)
  * produce one adapter per platform without each builder needing to know
  * about the others.
@@ -119,7 +185,7 @@ type WalletStandardAdapterBuilder = (wallet: WalletStandardWallet, registerDisco
  * into butr `WalletAdapter`s using a per-platform `build` callback.
  *
  * **Shared machinery** every platform package needs:
- *  - Dynamic import of `@wallet-standard/app` (optional peer dep —
+ *  - Dynamic import of `@wallet-standard/app` (optional peer dep;
  *    failure to resolve quietly disables discovery so consumers who
  *    don't install it pay nothing).
  *  - Cancellation: the returned unsubscribe is safe to call before the
@@ -136,10 +202,10 @@ type WalletStandardAdapterBuilder = (wallet: WalletStandardWallet, registerDisco
  *  - The capability resolver, the feature decoding, the chain coercion.
  *
  * Disconnectors are keyed by the wallet object itself (identity equality),
- * not by adapter id — Wallet Standard's `register` / `unregister` emit
+ * not by adapter id; Wallet Standard's `register` / `unregister` emit
  * the same wallet object, so identity is the cheapest stable key.
  */
 declare const discoverWalletStandard: (onAdapter: (adapter: WalletAdapter) => void, build: WalletStandardAdapterBuilder) => (() => void);
 //#endregion
-export { type StandardConnectFeature, type StandardDisconnectFeature, type StandardEventsFeature, type StandardEventsListener, type WalletStandardAdapterBuilder, type WalletStandardAppModule, type WalletStandardWallet, type WalletStandardWalletAccount, type WalletsApp, buildAccount, discoverWalletStandard, getFeature, pickAccountByAddress, pickFirstAddress, slugify };
+export { type StandardConnectFeature, type StandardDisconnectFeature, type StandardEventsFeature, type StandardEventsListener, type WalletStandardAdapterBuilder, type WalletStandardAppModule, type WalletStandardCore, type WalletStandardWallet, type WalletStandardWalletAccount, type WalletsApp, buildAccount, createWalletStandardCore, discoverWalletStandard, getFeature, pickAccountByAddress, pickFirstAddress, slugify };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/primitives.ts","../src/discovery.ts"],"mappings":";;;;;;;;;;;;;;;;;KAeK,2BAAA;EACH,OAAA;EACA,MAAA,EAAQ,aAAA;EACR,QAAA,EAAU,aAAA,UAEY;EAAtB,SAAA,GAAY,UAAA;AAAA;AAAA,KAGT,oBAAA;EACH,QAAA,EAAU,aAAA,CAAc,2BAAA;EACxB,MAAA,EAAQ,aAAA;EADE;;EAIV,QAAA,EAAU,QAAA,CAAS,MAAA;EACnB,IAAA;EACA,IAAA;EACA,OAAA;AAAA;AAAA,KAGG,UAAA;EACH,GAAA,QAAW,aAAA,CAAc,oBAAA;EACzB,EAAA,GACE,KAAA,6BACA,QAAA,MAAc,OAAA,EAAS,aAAA,CAAc,oBAAA;AAAA;AAAA,KAIpC,uBAAA;EACH,UAAA,QAAkB,UAAU;AAAA;AAAA,KAGzB,sBAAA;EACH,OAAA,GAAU,KAAA;IAAU,MAAA;EAAA,MAAuB,OAAA;IACzC,QAAA,EAAU,aAAA,CAAc,2BAAA;EAAA;AAAA;AAAA,KAIvB,yBAAA;EACH,UAAA,QAAkB,OAAO;AAAA;AAAA,KAGtB,sBAAA,IAA0B,OAAA;EAC7B,QAAA,GAAW,aAAA,CAAc,2BAAA;EACzB,MAAA,GAAS,aAAA;EACT,QAAA,GAAW,aAAA;AAAA;AAAA,KAGR,qBAAA;EACH,EAAA,GAAK,KAAA,YAAiB,QAAA,EAAU,sBAAsB;AAAA;;;;;;;;;;;;;;cChDlD,OAAA,GAAW,cAAA,UAAwB,IAAY;;;;;;cAa/C,UAAA,MAAiB,MAAA,EAAQ,oBAAA,EAAsB,IAAA,aAAe,CAAC;ADR7C;;;;;;AAAA,cCmBlB,YAAA,GAAgB,OAAA,UAAiB,KAAA,EAAO,SAAA,KAAY,OAIxD;;;;;cAMI,gBAAA,GAAoB,QAAA,EAAU,aAAa,CAAC,2BAAA;;;;;;;;;cAa5C,oBAAA,GACJ,QAAA,EAAU,aAAA,CAAc,2BAAA,GACxB,OAAA,aACC,2BAAA;;;;;;;;;;;;;;;;;KC1CE,4BAAA,IACH,MAAA,EAAQ,oBAAA,EACR,oBAAA,GAAuB,IAAA,0BACpB,aAAa;;;AFNM;AAAA;;;;;;;;;;;;;;;;;;;;;;cEiClB,sBAAA,GACJ,SAAA,GAAY,OAAA,EAAS,aAAA,WACrB,KAAA,EAAO,4BAA4B"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/primitives.ts","../src/adapter-core.ts","../src/discovery.ts"],"mappings":";;;;;;;;;;;;;;;;KAeK;EACH;EACA,QAAQ;EACR,UAAU;;EAEV,YAAY;;KAGT;EACH,UAAU,cAAc;EACxB,QAAQ;;;EAGR,UAAU,SAAS;EACnB;EACA;EACA;;KAGG;EACH,WAAW,cAAc;EACzB,KACE,kCACA,cAAc,SAAS,cAAc;;KAIpC;EACH,kBAAkB;;KAGf;EACH,UAAU;IAAU;QAAuB;IACzC,UAAU,cAAc;;;KAIvB;EACH,kBAAkB;;KAGf,0BAA0B;EAC7B,WAAW,cAAc;EACzB,SAAS;EACT,WAAW;;KAGR;EACH,KAAK,iBAAiB,UAAU;;;;;;;;;;;;;;;cClD5B,UAAW,wBAAwB;;;;;;;;;;cAkBnC,aAAc,GAAG,QAAQ,sBAAsB,iBAAe;;;;;cAa9D,mBAAoB,UAAU,cAAc;;;;;;;;;cAa5C,uBACJ,UAAU,cAAc,8BACxB,oBACC;;;KChDE;;EAEH;;EAEA;;EAEA;;EAEA;;EAEA;;;;EAIA,mBAAmB;;;;EAInB,wBAAwB;;;;EAIxB;EACA,QAAQ;;KAGL;;EAEH;EACA,UAAU;IAAS;QAAuB;;EAE1C;EACA,kBAAkB;EAClB,kBAAkB,QAAQ;EAC1B,mBAAmB,QAAQ,MAAM;EACjC,iBAAiB;;EAEjB;EACA;EACA;EACA;;;EAGA,iBAAiB;IAAY;QAA4B;EACzD,YAAY,WAAW,OAAO;EAC9B,cAAc,OAAO,cAAc;;;EAGnC,eAAe;;;;;;;;;;;;;;;cAgBX,6BAA4B,aAAA,IAAA,OAAA,WAAA,UAAA,mBAAA,sBAAA,mBAAA,UAU/B,4BAA0B;;;;;;;;;;;;;;;;;KCjExB,gCACH,QAAQ,sBACR,uBAAuB,8BACpB;;;;;;;;;;;;;;;;;;;;;;;;;;cA2BC,yBACJ,YAAY,SAAS,wBACrB,OAAO"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { logWarn } from "@usebutr/core";
+import { buildAccount, buildAccount as buildAccount$1, logWarn, sanitizeIcon } from "@usebutr/core";
 
 //#region src/primitives.ts
 /**
@@ -17,31 +17,25 @@ const slugify = (platformPrefix, name) => {
 };
 /**
 * Read a Wallet Standard feature off a wallet, returning `undefined`
-* when absent. The caller narrows the unknown payload to the
-* platform-specific feature shape at use sites.
+* when absent. `features` is a reverse-DNS-keyed registry typed
+* `Record<string, unknown>` by the spec, so the caller declares the
+* concrete feature shape it expects; this accessor is the single
+* boundary where that dynamism is acknowledged. The `T` parameter is
+* intentionally caller-supplied (not inferable) and the assertion is
+* unavoidable for an untyped registry.
 */
 const getFeature = (wallet, name) => {
 	const feature = wallet.features[name];
-	return feature ? feature : void 0;
+	if (typeof feature !== "object" || feature === null) return;
+	return feature;
 };
 /**
-* Build butr's `Account` shape from a Wallet Standard account address
-* and a resolved `ChainBase`. The composite id (`<chain>:<address>`)
-* is what butr's reducer uses to compare accounts across refreshes,
-* so keep this format identical across platforms.
-*/
-const buildAccount = (address, chain) => ({
-	chain,
-	id: `${chain.id}:${address}`,
-	walletAddress: address
-});
-/**
 * Pick the first address out of a wallet's accounts array, returning
 * `null` when the wallet currently exposes none.
 */
 const pickFirstAddress = (accounts) => {
 	const first = accounts[0];
-	return first ? first.address : null;
+	return first === void 0 ? null : first.address;
 };
 /**
 * Look up a wallet account by address, falling back to the first
@@ -53,6 +47,130 @@ const pickFirstAddress = (accounts) => {
 */
 const pickAccountByAddress = (accounts, address) => accounts.find((a) => a.address === address) ?? accounts[0];
 
+//#endregion
+//#region src/adapter-core.ts
+/**
+* Session plumbing every Wallet Standard platform adapter repeats: chain
+* resolution, the connect/disconnect handshake, account reads, the local
+* listener set that lets `switchChain` synthesise `accountChanged`, and
+* the `standard:events` bridge. Returns `null` for wallets butr can't
+* drive (no chain in this namespace, or no `standard:connect`), which is
+* the same `null` each platform adapter returns to its caller.
+*
+* Platform packages keep what genuinely differs: which features they read
+* off the wallet, how they encode transactions and messages, and their
+* balance units. `getSigner` hands back the raw Wallet Standard wallet so
+* consumers can wrap it in their own signing library.
+*/
+const createWalletStandardCore = ({ chainPrefix, id, label, namespace, platform, preferredChainIds, registerDisconnector, trackChainChanges, wallet }) => {
+	const pickChain = (chains) => chains.find((c) => preferredChainIds.includes(c)) ?? chains.find((c) => c.startsWith(chainPrefix)) ?? null;
+	const initialChainId = pickChain(wallet.chains);
+	if (initialChainId === null) return null;
+	const connect = getFeature(wallet, "standard:connect");
+	if (connect === void 0) return null;
+	const disconnect = getFeature(wallet, "standard:disconnect");
+	const events = getFeature(wallet, "standard:events");
+	let currentChainId = initialChainId;
+	const toChain = () => ({
+		id: currentChainId,
+		name: wallet.name,
+		namespace,
+		reference: currentChainId.slice(chainPrefix.length)
+	});
+	const listeners = /* @__PURE__ */ new Set();
+	const notifyAccountChanged = () => {
+		if (wallet.accounts.length === 0) return;
+		const chain = toChain();
+		const built = wallet.accounts.map((a) => buildAccount$1(a.address, chain));
+		const first = built[0];
+		if (first === void 0) return;
+		for (const listener of listeners) listener({
+			account: first,
+			accounts: built,
+			type: "accountChanged"
+		});
+	};
+	registerDisconnector?.(() => {
+		for (const listener of listeners) listener({ type: "disconnected" });
+	});
+	return {
+		chainCount: wallet.chains.filter((c) => c.startsWith(chainPrefix)).length,
+		async connect(opts) {
+			await connect.connect(opts?.silent === true ? { silent: true } : void 0);
+		},
+		currentChainId: () => currentChainId,
+		async disconnect() {
+			if (disconnect !== void 0) try {
+				await disconnect.disconnect();
+			} catch (error) {
+				logWarn(`[butr] ${label} Wallet Standard disconnect threw:`, error);
+			}
+		},
+		getAccount: () => {
+			const address = pickFirstAddress(wallet.accounts);
+			return Promise.resolve(address === null ? null : buildAccount$1(address, toChain()));
+		},
+		getAccounts: () => {
+			const chain = toChain();
+			return Promise.resolve(wallet.accounts.map((a) => buildAccount$1(a.address, chain)));
+		},
+		getSigner: () => Promise.resolve(wallet),
+		hasEvents: Boolean(events),
+		icon: sanitizeIcon(wallet.icon),
+		id,
+		name: wallet.name,
+		resolveAccount: (account) => {
+			const wsAccount = account ? pickAccountByAddress(wallet.accounts, account.walletAddress) : wallet.accounts[0];
+			if (wsAccount === void 0) throw new Error("No connected account");
+			return wsAccount;
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			let unsubWallet = null;
+			if (events !== void 0) {
+				const unsub = events.on("change", (changes) => {
+					if (trackChainChanges && changes.chains !== void 0) {
+						const next = pickChain(changes.chains);
+						if (next !== null) currentChainId = next;
+					}
+					if (changes.accounts !== void 0) {
+						if (changes.accounts.length === 0) {
+							listener({ type: "disconnected" });
+							return;
+						}
+						const chain = toChain();
+						const built = changes.accounts.map((a) => buildAccount$1(a.address, chain));
+						const first = built[0];
+						if (first === void 0) return;
+						listener({
+							account: first,
+							accounts: built,
+							type: "accountChanged"
+						});
+						return;
+					}
+					if (trackChainChanges && changes.chains !== void 0) notifyAccountChanged();
+				});
+				unsubWallet = () => {
+					unsub();
+				};
+			}
+			return () => {
+				listeners.delete(listener);
+				unsubWallet?.();
+			};
+		},
+		switchChain: (chain) => {
+			if (chain.namespace !== namespace) throw new Error(`${label} adapter received non-${platform} chain "${chain.id}". Pass a chain with namespace "${namespace}".`);
+			if (!wallet.chains.includes(chain.id)) throw new Error(`Wallet ${wallet.name} does not advertise chain "${chain.id}". Available: ${wallet.chains.join(", ")}`);
+			currentChainId = chain.id;
+			notifyAccountChanged();
+			return Promise.resolve();
+		},
+		toChain
+	};
+};
+
 //#endregion
 //#region src/discovery.ts
 let warnedMissingApp = false;
@@ -61,7 +179,7 @@ let warnedMissingApp = false;
 * into butr `WalletAdapter`s using a per-platform `build` callback.
 *
 * **Shared machinery** every platform package needs:
-*  - Dynamic import of `@wallet-standard/app` (optional peer dep —
+*  - Dynamic import of `@wallet-standard/app` (optional peer dep;
 *    failure to resolve quietly disables discovery so consumers who
 *    don't install it pay nothing).
 *  - Cancellation: the returned unsubscribe is safe to call before the
@@ -78,7 +196,7 @@ let warnedMissingApp = false;
 *  - The capability resolver, the feature decoding, the chain coercion.
 *
 * Disconnectors are keyed by the wallet object itself (identity equality),
-* not by adapter id — Wallet Standard's `register` / `unregister` emit
+* not by adapter id; Wallet Standard's `register` / `unregister` emit
 * the same wallet object, so identity is the cheapest stable key.
 */
 const discoverWalletStandard = (onAdapter, build) => {
@@ -87,7 +205,9 @@ const discoverWalletStandard = (onAdapter, build) => {
 	(async () => {
 		let mod;
 		try {
-			mod = await import("@wallet-standard/app");
+			const imported = await import("@wallet-standard/app");
+			if (typeof imported !== "object" || imported === null || !("getWallets" in imported) || typeof imported.getWallets !== "function") throw new Error("@wallet-standard/app has no getWallets export");
+			mod = imported;
 		} catch (error) {
 			if (!warnedMissingApp) {
 				warnedMissingApp = true;
@@ -133,5 +253,5 @@ const discoverWalletStandard = (onAdapter, build) => {
 };
 
 //#endregion
-export { buildAccount, discoverWalletStandard, getFeature, pickAccountByAddress, pickFirstAddress, slugify };
+export { buildAccount, createWalletStandardCore, discoverWalletStandard, getFeature, pickAccountByAddress, pickFirstAddress, slugify };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/primitives.ts","../src/discovery.ts"],"sourcesContent":["import type { Account, ChainBase } from \"@usebutr/core\";\n\nimport type { WalletStandardWallet, WalletStandardWalletAccount } from \"./types\";\n\n/**\n * Convert a wallet name into a stable kebab-case adapter id, scoped by\n * a platform prefix so adapters from different platforms (Phantom SVM,\n * Phantom Sui, Phantom BTC) coexist in the pool without colliding on\n * the shared `getWallets()` bus.\n *\n * @example\n * slugify(\"svm\", \"Phantom\")    // \"wallet-standard:svm-phantom\"\n * slugify(\"sui\", \"Sui Wallet\") // \"wallet-standard:sui-sui-wallet\"\n * slugify(\"btc\", \"Phantom\")    // \"wallet-standard:btc-phantom\"\n */\nconst slugify = (platformPrefix: string, name: string): string => {\n  const slug = name\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[^a-z0-9]+/gv, \"-\");\n  return `wallet-standard:${platformPrefix}-${slug}`;\n};\n\n/**\n * Read a Wallet Standard feature off a wallet, returning `undefined`\n * when absent. The caller narrows the unknown payload to the\n * platform-specific feature shape at use sites.\n */\nconst getFeature = <T>(wallet: WalletStandardWallet, name: string): T | undefined => {\n  const feature = wallet.features[name];\n  return feature ? (feature as T) : undefined;\n};\n\n/**\n * Build butr's `Account` shape from a Wallet Standard account address\n * and a resolved `ChainBase`. The composite id (`<chain>:<address>`)\n * is what butr's reducer uses to compare accounts across refreshes,\n * so keep this format identical across platforms.\n */\nconst buildAccount = (address: string, chain: ChainBase): Account => ({\n  chain,\n  id: `${chain.id}:${address}`,\n  walletAddress: address,\n});\n\n/**\n * Pick the first address out of a wallet's accounts array, returning\n * `null` when the wallet currently exposes none.\n */\nconst pickFirstAddress = (accounts: ReadonlyArray<WalletStandardWalletAccount>): string | null => {\n  const first = accounts[0];\n  return first ? first.address : null;\n};\n\n/**\n * Look up a wallet account by address, falling back to the first\n * exposed account when the requested address isn't present.\n *\n * Used by per-call routing in `sendTx` / `signMessage`: callers pass\n * an `account` from `ConnectedWallet.accounts` to sign with a non-\n * active address; the wallet's `accounts[]` is the source of truth.\n */\nconst pickAccountByAddress = (\n  accounts: ReadonlyArray<WalletStandardWalletAccount>,\n  address: string,\n): WalletStandardWalletAccount | undefined =>\n  accounts.find((a) => a.address === address) ?? accounts[0];\n\nexport { buildAccount, getFeature, pickAccountByAddress, pickFirstAddress, slugify };\n","import type { WalletAdapter } from \"@usebutr/core\";\nimport { logWarn } from \"@usebutr/core\";\n\nimport type { WalletStandardAppModule, WalletStandardWallet } from \"./types\";\n\n// Warn once per process: every platform calls this, so a missing optional peer\n// dep would otherwise log one identical line per chain.\nlet warnedMissingApp = false;\n\n/**\n * Callback supplied by per-platform discovery to build a `WalletAdapter`\n * out of a Wallet Standard wallet announcement.\n *\n * Returns `null` when the wallet doesn't advertise this platform — that\n * lets a multi-chain wallet (e.g. Phantom: SVM + EVM + Sui + Bitcoin)\n * produce one adapter per platform without each builder needing to know\n * about the others.\n *\n * The second argument is a hook the builder calls during construction\n * to wire a synthetic `disconnected` event into its subscriber set.\n * The discovery loop fires the registered emitter when Wallet Standard\n * announces `unregister` for that wallet.\n */\ntype WalletStandardAdapterBuilder = (\n  wallet: WalletStandardWallet,\n  registerDisconnector: (emit: () => void) => void,\n) => WalletAdapter | null;\n\n/**\n * Subscribe to Wallet Standard announcements and turn matching wallets\n * into butr `WalletAdapter`s using a per-platform `build` callback.\n *\n * **Shared machinery** every platform package needs:\n *  - Dynamic import of `@wallet-standard/app` (optional peer dep —\n *    failure to resolve quietly disables discovery so consumers who\n *    don't install it pay nothing).\n *  - Cancellation: the returned unsubscribe is safe to call before the\n *    dynamic import has resolved.\n *  - Dedupe by adapter id, so re-announcements don't double-emit.\n *  - `unregister` integration: when an extension is removed mid-session,\n *    fire the disconnector the builder registered so connected pool\n *    entries on the consumer side tear down cleanly.\n *\n * **What's platform-specific** lives entirely in `build`:\n *  - Which `wallet.chains` to accept.\n *  - Which features to gate on.\n *  - The `id` slug prefix (use `slugify(prefix, wallet.name)`).\n *  - The capability resolver, the feature decoding, the chain coercion.\n *\n * Disconnectors are keyed by the wallet object itself (identity equality),\n * not by adapter id — Wallet Standard's `register` / `unregister` emit\n * the same wallet object, so identity is the cheapest stable key.\n */\nconst discoverWalletStandard = (\n  onAdapter: (adapter: WalletAdapter) => void,\n  build: WalletStandardAdapterBuilder,\n): (() => void) => {\n  let cancelled = false;\n  let internalUnsub: (() => void) | null = null;\n\n  void (async () => {\n    let mod: WalletStandardAppModule;\n    try {\n      mod = (await import(\"@wallet-standard/app\")) as unknown as WalletStandardAppModule;\n    } catch (error) {\n      if (!warnedMissingApp) {\n        warnedMissingApp = true;\n        logWarn(\n          \"[butr] Wallet Standard wallet discovery is disabled: `@wallet-standard/app` could not be loaded. Install it (`npm i @wallet-standard/app`) to detect Wallet Standard wallets.\",\n          error,\n        );\n      }\n      return;\n    }\n    if (cancelled) {\n      return;\n    }\n\n    const seenIds = new Set<string>();\n    // wallet object → emitter that pushes synthetic `disconnected` to\n    // this wallet's adapter's subscribers. Identity-keyed so the\n    // unregister handler can find the right emitter cheaply.\n    const disconnectors = new Map<WalletStandardWallet, () => void>();\n\n    const tryAdd = (wallet: WalletStandardWallet) => {\n      const adapter = build(wallet, (emit) => {\n        disconnectors.set(wallet, emit);\n      });\n      if (!adapter || seenIds.has(adapter.id)) {\n        return;\n      }\n      seenIds.add(adapter.id);\n      onAdapter(adapter);\n    };\n\n    const app = mod.getWallets();\n    for (const wallet of app.get()) {\n      tryAdd(wallet);\n    }\n\n    const offRegister = app.on(\"register\", (...wallets) => {\n      for (const wallet of wallets) {\n        tryAdd(wallet);\n      }\n    });\n    const offUnregister = app.on(\"unregister\", (...wallets) => {\n      for (const wallet of wallets) {\n        const emit = disconnectors.get(wallet);\n        if (emit) {\n          emit();\n          disconnectors.delete(wallet);\n        }\n      }\n    });\n    internalUnsub = () => {\n      offRegister();\n      offUnregister();\n    };\n  })();\n\n  return () => {\n    cancelled = true;\n    internalUnsub?.();\n    internalUnsub = null;\n  };\n};\n\nexport type { WalletStandardAdapterBuilder };\nexport { discoverWalletStandard };\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAM,WAAW,gBAAwB,SAAyB;CAKhE,OAAO,mBAAmB,eAAe,GAJ5B,KACV,KAAK,CAAC,CACN,YAAY,CAAC,CACb,2BAAW,6BAAa,GAAG,GACiB;AACjD;;;;;;AAOA,MAAM,cAAiB,QAA8B,SAAgC;CACnF,MAAM,UAAU,OAAO,SAAS;CAChC,OAAO,UAAW,UAAgB;AACpC;;;;;;;AAQA,MAAM,gBAAgB,SAAiB,WAA+B;CACpE;CACA,IAAI,GAAG,MAAM,GAAG,GAAG;CACnB,eAAe;AACjB;;;;;AAMA,MAAM,oBAAoB,aAAwE;CAChG,MAAM,QAAQ,SAAS;CACvB,OAAO,QAAQ,MAAM,UAAU;AACjC;;;;;;;;;AAUA,MAAM,wBACJ,UACA,YAEA,SAAS,MAAM,MAAM,EAAE,YAAY,OAAO,KAAK,SAAS;;;;AC3D1D,IAAI,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CvB,MAAM,0BACJ,WACA,UACiB;CACjB,IAAI,YAAY;CAChB,IAAI,gBAAqC;CAEzC,CAAM,YAAY;EAChB,IAAI;EACJ,IAAI;GACF,MAAO,MAAM,OAAO;EACtB,SAAS,OAAO;GACd,IAAI,CAAC,kBAAkB;IACrB,mBAAmB;IACnB,QACE,iLACA,KACF;GACF;GACA;EACF;EACA,IAAI,WACF;EAGF,MAAM,0BAAU,IAAI,IAAY;EAIhC,MAAM,gCAAgB,IAAI,IAAsC;EAEhE,MAAM,UAAU,WAAiC;GAC/C,MAAM,UAAU,MAAM,SAAS,SAAS;IACtC,cAAc,IAAI,QAAQ,IAAI;GAChC,CAAC;GACD,IAAI,CAAC,WAAW,QAAQ,IAAI,QAAQ,EAAE,GACpC;GAEF,QAAQ,IAAI,QAAQ,EAAE;GACtB,UAAU,OAAO;EACnB;EAEA,MAAM,MAAM,IAAI,WAAW;EAC3B,KAAK,MAAM,UAAU,IAAI,IAAI,GAC3B,OAAO,MAAM;EAGf,MAAM,cAAc,IAAI,GAAG,aAAa,GAAG,YAAY;GACrD,KAAK,MAAM,UAAU,SACnB,OAAO,MAAM;EAEjB,CAAC;EACD,MAAM,gBAAgB,IAAI,GAAG,eAAe,GAAG,YAAY;GACzD,KAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,OAAO,cAAc,IAAI,MAAM;IACrC,IAAI,MAAM;KACR,KAAK;KACL,cAAc,OAAO,MAAM;IAC7B;GACF;EACF,CAAC;EACD,sBAAsB;GACpB,YAAY;GACZ,cAAc;EAChB;CACF,EAAC,CAAE;CAEH,aAAa;EACX,YAAY;EACZ,gBAAgB;EAChB,gBAAgB;CAClB;AACF"}
+{"version":3,"file":"index.js","names":["buildAccount"],"sources":["../src/primitives.ts","../src/adapter-core.ts","../src/discovery.ts"],"sourcesContent":["import type { WalletStandardWallet, WalletStandardWalletAccount } from \"./types\";\n\n/**\n * Convert a wallet name into a stable kebab-case adapter id, scoped by\n * a platform prefix so adapters from different platforms (Phantom SVM,\n * Phantom Sui, Phantom BTC) coexist in the pool without colliding on\n * the shared `getWallets()` bus.\n *\n * @example\n * slugify(\"svm\", \"Phantom\")    // \"wallet-standard:svm-phantom\"\n * slugify(\"sui\", \"Sui Wallet\") // \"wallet-standard:sui-sui-wallet\"\n * slugify(\"btc\", \"Phantom\")    // \"wallet-standard:btc-phantom\"\n */\nconst slugify = (platformPrefix: string, name: string): string => {\n  const slug = name\n    .trim()\n    .toLowerCase()\n    .replaceAll(/[^a-z0-9]+/gv, \"-\");\n  return `wallet-standard:${platformPrefix}-${slug}`;\n};\n\n/**\n * Read a Wallet Standard feature off a wallet, returning `undefined`\n * when absent. `features` is a reverse-DNS-keyed registry typed\n * `Record<string, unknown>` by the spec, so the caller declares the\n * concrete feature shape it expects; this accessor is the single\n * boundary where that dynamism is acknowledged. The `T` parameter is\n * intentionally caller-supplied (not inferable) and the assertion is\n * unavoidable for an untyped registry.\n */\n// oxlint-disable-next-line typescript/no-unnecessary-type-parameters -- caller-supplied feature shape; not inferable from args\nconst getFeature = <T>(wallet: WalletStandardWallet, name: string): T | undefined => {\n  const feature: unknown = wallet.features[name];\n  if (typeof feature !== \"object\" || feature === null) {\n    return undefined;\n  }\n  // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- untyped Wallet Standard feature registry; caller declares the shape\n  return feature as T;\n};\n\n/**\n * Pick the first address out of a wallet's accounts array, returning\n * `null` when the wallet currently exposes none.\n */\nconst pickFirstAddress = (accounts: ReadonlyArray<WalletStandardWalletAccount>): string | null => {\n  const first = accounts[0];\n  return first === undefined ? null : first.address;\n};\n\n/**\n * Look up a wallet account by address, falling back to the first\n * exposed account when the requested address isn't present.\n *\n * Used by per-call routing in `sendTx` / `signMessage`: callers pass\n * an `account` from `ConnectedWallet.accounts` to sign with a non-\n * active address; the wallet's `accounts[]` is the source of truth.\n */\nconst pickAccountByAddress = (\n  accounts: ReadonlyArray<WalletStandardWalletAccount>,\n  address: string,\n): WalletStandardWalletAccount | undefined =>\n  accounts.find((a) => a.address === address) ?? accounts[0];\n\n// Re-exported so this package's public surface keeps offering the shared\n// account builder now that the implementation lives in @usebutr/core\n// (next to `Account` and the reducer that relies on its id format).\nexport { buildAccount } from \"@usebutr/core\";\nexport { getFeature, pickAccountByAddress, pickFirstAddress, slugify };\n","import type { Account, ChainBase, ConnectorEvent } from \"@usebutr/core\";\nimport { buildAccount, logWarn, sanitizeIcon } from \"@usebutr/core\";\n\nimport { getFeature, pickAccountByAddress, pickFirstAddress } from \"./primitives\";\nimport type {\n  StandardConnectFeature,\n  StandardDisconnectFeature,\n  StandardEventsFeature,\n  WalletStandardWallet,\n  WalletStandardWalletAccount,\n} from \"./types\";\n\ntype WalletStandardCoreInput = {\n  /** CAIP-2 prefix including its colon (`solana:`, `sui:`, `bip122:`). */\n  chainPrefix: string;\n  /** Stable adapter id. Each platform package owns its own slug prefix. */\n  id: string;\n  /** How this adapter names itself in errors (`Bitcoin`, `SVM`, `Sui`). */\n  label: string;\n  /** CAIP-2 namespace without its colon. */\n  namespace: string;\n  /** How the chain family reads in errors (`Bitcoin`, `Solana`, `Sui`). */\n  platform: string;\n  /** Chain ids worth preferring over a bare prefix match. Matched against\n   *  the wallet's own ordering, so a wallet listing `mainnet-beta` before\n   *  `mainnet` keeps the chain it advertised first. */\n  preferredChainIds: ReadonlyArray<string>;\n  /** Called with a function that pushes a synthetic `disconnected` event\n   *  to all current subscribers. The discovery layer invokes it on Wallet\n   *  Standard `unregister`. */\n  registerDisconnector?: (emit: () => void) => void;\n  /** Re-point the active chain when the wallet reports a `chains` change.\n   *  Polkadot opts out: its wallets advertise a single relay chain, so a\n   *  re-point would only ever move the adapter off the chain it resolved. */\n  trackChainChanges: boolean;\n  wallet: WalletStandardWallet;\n};\n\ntype WalletStandardCore = {\n  /** Chains the wallet advertises in this namespace; feeds capability gating. */\n  chainCount: number;\n  connect: (opts?: { silent?: boolean }) => Promise<void>;\n  /** Active CAIP-2 chain id, for features that take a per-call `chain`. */\n  currentChainId: () => string;\n  disconnect: () => Promise<void>;\n  getAccount: () => Promise<Account | null>;\n  getAccounts: () => Promise<Array<Account>>;\n  getSigner: () => Promise<unknown>;\n  /** Whether the wallet advertises `standard:events`; feeds capability gating. */\n  hasEvents: boolean;\n  icon: string | undefined;\n  id: string;\n  name: string;\n  /** Wallet Standard account a call should route through: the one matching\n   *  `account`, else the wallet's first exposed account. */\n  resolveAccount: (account?: { walletAddress: string }) => WalletStandardWalletAccount;\n  subscribe: (listener: (event: ConnectorEvent) => void) => () => void;\n  switchChain: (chain: ChainBase) => Promise<void>;\n  /** butr chain for the active chain id, for responses that mint their own\n   *  `Account` (Sign-In-With-Solana) rather than going through `getAccounts`. */\n  toChain: () => ChainBase;\n};\n\n/**\n * Session plumbing every Wallet Standard platform adapter repeats: chain\n * resolution, the connect/disconnect handshake, account reads, the local\n * listener set that lets `switchChain` synthesise `accountChanged`, and\n * the `standard:events` bridge. Returns `null` for wallets butr can't\n * drive (no chain in this namespace, or no `standard:connect`), which is\n * the same `null` each platform adapter returns to its caller.\n *\n * Platform packages keep what genuinely differs: which features they read\n * off the wallet, how they encode transactions and messages, and their\n * balance units. `getSigner` hands back the raw Wallet Standard wallet so\n * consumers can wrap it in their own signing library.\n */\nconst createWalletStandardCore = ({\n  chainPrefix,\n  id,\n  label,\n  namespace,\n  platform,\n  preferredChainIds,\n  registerDisconnector,\n  trackChainChanges,\n  wallet,\n}: WalletStandardCoreInput): WalletStandardCore | null => {\n  const pickChain = (chains: ReadonlyArray<string>): string | null =>\n    chains.find((c) => preferredChainIds.includes(c)) ??\n    chains.find((c) => c.startsWith(chainPrefix)) ??\n    null;\n\n  const initialChainId = pickChain(wallet.chains);\n  if (initialChainId === null) {\n    return null;\n  }\n  const connect = getFeature<StandardConnectFeature>(wallet, \"standard:connect\");\n  if (connect === undefined) {\n    return null;\n  }\n\n  const disconnect = getFeature<StandardDisconnectFeature>(wallet, \"standard:disconnect\");\n  const events = getFeature<StandardEventsFeature>(wallet, \"standard:events\");\n\n  let currentChainId = initialChainId;\n  const toChain = (): ChainBase => ({\n    id: currentChainId,\n    // butr ships no chain-id → display-name table; the wallet name stands\n    // in and consumers overlay their own labels via structural typing.\n    name: wallet.name,\n    namespace,\n    reference: currentChainId.slice(chainPrefix.length),\n  });\n\n  const listeners = new Set<(event: ConnectorEvent) => void>();\n  const notifyAccountChanged = () => {\n    if (wallet.accounts.length === 0) {\n      return;\n    }\n    const chain = toChain();\n    const built = wallet.accounts.map((a) => buildAccount(a.address, chain));\n    const first = built[0];\n    if (first === undefined) {\n      return;\n    }\n    for (const listener of listeners) {\n      listener({ account: first, accounts: built, type: \"accountChanged\" });\n    }\n  };\n\n  registerDisconnector?.(() => {\n    for (const listener of listeners) {\n      listener({ type: \"disconnected\" });\n    }\n  });\n\n  return {\n    chainCount: wallet.chains.filter((c) => c.startsWith(chainPrefix)).length,\n\n    async connect(opts) {\n      // Forward `silent` so eager hydration restores already-authorized\n      // accounts without re-opening the wallet's approval UI. Wallets\n      // that don't honour `silent` fall back to their normal behaviour.\n      await connect.connect(opts?.silent === true ? { silent: true } : undefined);\n    },\n\n    currentChainId: () => currentChainId,\n\n    async disconnect() {\n      if (disconnect !== undefined) {\n        try {\n          await disconnect.disconnect();\n        } catch (error) {\n          logWarn(`[butr] ${label} Wallet Standard disconnect threw:`, error);\n        }\n      }\n    },\n\n    getAccount: () => {\n      const address = pickFirstAddress(wallet.accounts);\n      return Promise.resolve(address === null ? null : buildAccount(address, toChain()));\n    },\n\n    getAccounts: () => {\n      const chain = toChain();\n      return Promise.resolve(wallet.accounts.map((a) => buildAccount(a.address, chain)));\n    },\n\n    getSigner: () => Promise.resolve(wallet),\n\n    hasEvents: Boolean(events),\n\n    icon: sanitizeIcon(wallet.icon),\n    id,\n    name: wallet.name,\n\n    resolveAccount: (account) => {\n      const wsAccount = account\n        ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n        : wallet.accounts[0];\n      if (wsAccount === undefined) {\n        throw new Error(\"No connected account\");\n      }\n      return wsAccount;\n    },\n\n    subscribe(listener) {\n      listeners.add(listener);\n      let unsubWallet: (() => void) | null = null;\n      if (events !== undefined) {\n        const unsub = events.on(\"change\", (changes) => {\n          // Chain change: the wallet switched network. Re-point\n          // currentChainId so subsequent per-call `chain` inputs route\n          // through it, mirroring `switchChain`'s local-state model.\n          if (trackChainChanges && changes.chains !== undefined) {\n            const next = pickChain(changes.chains);\n            if (next !== null) {\n              currentChainId = next;\n            }\n          }\n\n          if (changes.accounts !== undefined) {\n            if (changes.accounts.length === 0) {\n              listener({ type: \"disconnected\" });\n              return;\n            }\n            // Forward the FULL accounts list; Wallet Standard's\n            // change.accounts reflects the wallet's current exposure\n            // set. Mirroring it into the pool entry keeps the array in\n            // sync with what the wallet actually allows us to sign with,\n            // so single-account-exposure wallets (Phantom Solana,\n            // MetaMask Snap) don't accumulate stale addresses.\n            const chain = toChain();\n            const built = changes.accounts.map((a) => buildAccount(a.address, chain));\n            const first = built[0];\n            if (first === undefined) {\n              return;\n            }\n            listener({ account: first, accounts: built, type: \"accountChanged\" });\n            return;\n          }\n\n          if (trackChainChanges && changes.chains !== undefined) {\n            notifyAccountChanged();\n          }\n        });\n        unsubWallet = () => {\n          unsub();\n        };\n      }\n      return () => {\n        listeners.delete(listener);\n        unsubWallet?.();\n      };\n    },\n\n    switchChain: (chain) => {\n      if (chain.namespace !== namespace) {\n        throw new Error(\n          `${label} adapter received non-${platform} chain \"${chain.id}\". Pass a chain with namespace \"${namespace}\".`,\n        );\n      }\n      // The wallet must advertise this chain; otherwise the per-call\n      // `chain` input would be rejected by the wallet later.\n      if (!wallet.chains.includes(chain.id)) {\n        throw new Error(\n          `Wallet ${wallet.name} does not advertise chain \"${chain.id}\". Available: ${wallet.chains.join(\", \")}`,\n        );\n      }\n      currentChainId = chain.id;\n      // Synthesise an `accountChanged` so butr's reducer updates the pool\n      // entry's chain; the wallet itself has no event to fire here.\n      notifyAccountChanged();\n      return Promise.resolve();\n    },\n\n    toChain,\n  };\n};\n\nexport type { WalletStandardCore };\nexport { createWalletStandardCore };\n","import type { WalletAdapter } from \"@usebutr/core\";\nimport { logWarn } from \"@usebutr/core\";\n\nimport type { WalletStandardAppModule, WalletStandardWallet } from \"./types\";\n\nlet warnedMissingApp = false;\n\n/**\n * Callback supplied by per-platform discovery to build a `WalletAdapter`\n * out of a Wallet Standard wallet announcement.\n *\n * Returns `null` when the wallet doesn't advertise this platform; that\n * lets a multi-chain wallet (e.g. Phantom: SVM + EVM + Sui + Bitcoin)\n * produce one adapter per platform without each builder needing to know\n * about the others.\n *\n * The second argument is a hook the builder calls during construction\n * to wire a synthetic `disconnected` event into its subscriber set.\n * The discovery loop fires the registered emitter when Wallet Standard\n * announces `unregister` for that wallet.\n */\ntype WalletStandardAdapterBuilder = (\n  wallet: WalletStandardWallet,\n  registerDisconnector: (emit: () => void) => void,\n) => WalletAdapter | null;\n\n/**\n * Subscribe to Wallet Standard announcements and turn matching wallets\n * into butr `WalletAdapter`s using a per-platform `build` callback.\n *\n * **Shared machinery** every platform package needs:\n *  - Dynamic import of `@wallet-standard/app` (optional peer dep;\n *    failure to resolve quietly disables discovery so consumers who\n *    don't install it pay nothing).\n *  - Cancellation: the returned unsubscribe is safe to call before the\n *    dynamic import has resolved.\n *  - Dedupe by adapter id, so re-announcements don't double-emit.\n *  - `unregister` integration: when an extension is removed mid-session,\n *    fire the disconnector the builder registered so connected pool\n *    entries on the consumer side tear down cleanly.\n *\n * **What's platform-specific** lives entirely in `build`:\n *  - Which `wallet.chains` to accept.\n *  - Which features to gate on.\n *  - The `id` slug prefix (use `slugify(prefix, wallet.name)`).\n *  - The capability resolver, the feature decoding, the chain coercion.\n *\n * Disconnectors are keyed by the wallet object itself (identity equality),\n * not by adapter id; Wallet Standard's `register` / `unregister` emit\n * the same wallet object, so identity is the cheapest stable key.\n */\nconst discoverWalletStandard = (\n  onAdapter: (adapter: WalletAdapter) => void,\n  build: WalletStandardAdapterBuilder,\n): (() => void) => {\n  let cancelled = false;\n  let internalUnsub: (() => void) | null = null;\n\n  void (async () => {\n    let mod: WalletStandardAppModule;\n    try {\n      const imported: unknown = await import(\"@wallet-standard/app\");\n      if (\n        typeof imported !== \"object\" ||\n        imported === null ||\n        !(\"getWallets\" in imported) ||\n        typeof imported.getWallets !== \"function\"\n      ) {\n        throw new Error(\"@wallet-standard/app has no getWallets export\");\n      }\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- validated getWallets export above; the rest of the untyped module is trusted\n      mod = imported as WalletStandardAppModule;\n    } catch (error) {\n      if (!warnedMissingApp) {\n        warnedMissingApp = true;\n        logWarn(\n          \"[butr] Wallet Standard wallet discovery is disabled: `@wallet-standard/app` could not be loaded. Install it (`npm i @wallet-standard/app`) to detect Wallet Standard wallets.\",\n          error,\n        );\n      }\n      return;\n    }\n    if (cancelled) {\n      return;\n    }\n\n    const seenIds = new Set<string>();\n    // wallet object → emitter that pushes synthetic `disconnected` to\n    // this wallet's adapter's subscribers. Identity-keyed so the\n    // unregister handler can find the right emitter cheaply.\n    const disconnectors = new Map<WalletStandardWallet, () => void>();\n\n    const tryAdd = (wallet: WalletStandardWallet) => {\n      const adapter = build(wallet, (emit) => {\n        disconnectors.set(wallet, emit);\n      });\n      if (!adapter || seenIds.has(adapter.id)) {\n        return;\n      }\n      seenIds.add(adapter.id);\n      onAdapter(adapter);\n    };\n\n    const app = mod.getWallets();\n    for (const wallet of app.get()) {\n      tryAdd(wallet);\n    }\n\n    const offRegister = app.on(\"register\", (...wallets) => {\n      for (const wallet of wallets) {\n        tryAdd(wallet);\n      }\n    });\n    const offUnregister = app.on(\"unregister\", (...wallets) => {\n      for (const wallet of wallets) {\n        const emit = disconnectors.get(wallet);\n        if (emit) {\n          emit();\n          disconnectors.delete(wallet);\n        }\n      }\n    });\n    internalUnsub = () => {\n      offRegister();\n      offUnregister();\n    };\n  })();\n\n  return () => {\n    cancelled = true;\n    internalUnsub?.();\n    internalUnsub = null;\n  };\n};\n\nexport type { WalletStandardAdapterBuilder };\nexport { discoverWalletStandard };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usebutr/wallet-standard-shared",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Shared Wallet Standard discovery primitives used by @usebutr/svm, @usebutr/sui, @usebutr/bitcoin.",
   "license": "MIT",
   "author": "Pedro Filho <pedro@filho.me>",
@@ -22,12 +22,12 @@
     }
   },
   "dependencies": {
-    "@usebutr/core": "0.4.1"
+    "@usebutr/core": "0.5.0"
   },
   "devDependencies": {
     "@wallet-standard/app": "^1.1.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.9",
+    "vitest": "^4.1.10",
     "@repo/config-vitest": "0.0.0",
     "@repo/typescript-config": "0.0.0"
   },