@usebutr/core 0.4.2 → 1.0.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types/chain.ts","../src/storage/persistence.ts","../src/storage/snapshot.ts","../src/types/errors.ts","../src/types/wallet.ts","../src/types/chains-by-platform.ts","../src/types/discoverer.ts","../src/types/signer.ts","../src/wallet-source.ts","../src/store/reducer.ts","../src/storage/browser-storage-driver.ts","../src/storage/cookie-storage-driver.ts","../src/storage/wallet-storage.ts","../src/store/wallet-store.ts","../src/wallet-equal.ts","../src/logger.ts","../src/sanitize-icon.ts","../src/encoding/bytes.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types/chain.ts","../src/types/account.ts","../src/types/capabilities.ts","../src/types/platform.ts","../src/types/chains-by-platform.ts","../src/types/connector.ts","../src/types/wallet.ts","../src/types/discoverer.ts","../src/types/errors.ts","../src/storage/persistence.ts","../src/storage/snapshot.ts","../src/types/manager.ts","../src/types/signer.ts","../src/wallet-source.ts","../src/store/reducer.ts","../src/store/shadow-adapter.ts","../src/storage/browser-storage-driver.ts","../src/storage/cookie-storage-driver.ts","../src/storage/wallet-storage.ts","../src/store/wallet-store.ts","../src/wallet-equal.ts","../src/logger.ts","../src/sanitize-icon.ts","../src/encoding/bytes.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,21 @@
 import { createStore } from "zustand/vanilla";
 import { z } from "zod";
 
+//#region src/types/account.ts
+/**
+* Build butr's `Account` shape from a wallet address and a resolved
+* `ChainBase`. The composite id (`<chain>:<address>`) is what the
+* reducer uses to compare accounts across refreshes, so every adapter
+* must build accounts through this helper (or keep the format
+* byte-identical).
+*/
+const buildAccount = (address, chain) => ({
+	chain,
+	id: `${chain.id}:${address}`,
+	walletAddress: address
+});
+
+//#endregion
 //#region src/types/chains-by-platform.ts
 /**
 * Build a fully-populated `ChainsByPlatform` from a partial. Platforms
@@ -106,7 +121,7 @@ const mapConnectionError = (raw) => {
 };
 
 //#endregion
-//#region src/types/wallet.ts
+//#region src/types/platform.ts
 /**
 * Canonical list of supported chain platforms. The single runtime source
 * of truth: `ChainPlatform` is derived from it, and storage validators
@@ -121,18 +136,6 @@ const CHAIN_PLATFORMS = [
 	"bitcoin",
 	"polkadot"
 ];
-/**
-* Build butr's `Account` shape from a wallet address and a resolved
-* `ChainBase`. The composite id (`<chain>:<address>`) is what the
-* reducer uses to compare accounts across refreshes, so every adapter
-* must build accounts through this helper (or keep the format
-* byte-identical).
-*/
-const buildAccount = (address, chain) => ({
-	chain,
-	id: `${chain.id}:${address}`,
-	walletAddress: address
-});
 
 //#endregion
 //#region src/wallet-source.ts
@@ -145,6 +148,134 @@ const buildAccount = (address, chain) => ({
 */
 const createWalletSource = (subscribe) => ({ subscribe });
 
+//#endregion
+//#region src/store/shadow-adapter.ts
+/**
+* Error thrown when a method is called on a shadow adapter; the
+* placeholder `WalletAdapter` that the store seeds into the pool when
+* an `initialState` is provided (e.g. from a server-rendered cookie
+* snapshot). Shadow adapters carry the identity and account data of a
+* previously-connected wallet, but the live wallet extension hasn't
+* been verified yet; the silent reconnect happens asynchronously
+* after mount.
+*
+* UI code that gates affordances on `wallet.connector.capabilities.*`
+* never reaches a shadow method (capabilities are all `false`). Code
+* that calls through anyway hits this typed error, which is the
+* correct loud failure: the consumer ignored the capability gate.
+*
+* Consumers wanting to wait out the reconnecting window should branch
+* on whether `connectorId` is in `state.reconnectingIds`.
+*/
+var ShadowConnectorError = class extends Error {
+	code = "BUTR_RECONNECTING";
+	connectorId;
+	method;
+	constructor(method, connectorId) {
+		super(`[butr] ${method} called on shadow connector "${connectorId}". Wait for silent reconnect to complete (check reconnectingIds.has(id) before calling).`);
+		this.name = "ShadowConnectorError";
+		this.connectorId = connectorId;
+		this.method = method;
+	}
+};
+const ALL_FALSE_CAPABILITIES = Object.freeze({
+	getBalance: false,
+	getTransactionReceipt: false,
+	requestAccounts: false,
+	sendTransaction: false,
+	signIn: false,
+	signMessage: false,
+	signTransaction: false,
+	subscribe: false,
+	switchAccount: false,
+	switchChain: false
+});
+/**
+* Builds a placeholder `WalletAdapter` from a persisted pool entry.
+*
+* Used by `createWalletStore` when `WalletManagerConfig.initialState`
+* is provided: each stored entry becomes a `ConnectedWallet` whose
+* `connector` is one of these. The store flips `isHydrated` true
+* synchronously and exposes the data through the usual hooks
+* (`useActiveWallet`, `useConnectedWallets`, …), but the connector
+* can't actually talk to a wallet yet, so its capabilities are all
+* `false` and its methods throw `ShadowConnectorError` if called.
+*
+* The hydration coordinator's silent-reconnect pass upgrades each
+* shadow to a live `WalletAdapter` by calling `createConnector(id)`
+* (which only succeeds once the live adapter has been announced via
+* discovery or registered explicitly) and replacing the pool entry.
+* On success the connector id is removed from `reconnectingIds`; on
+* failure the entry is dropped from the pool and storage.
+*
+* The entry's `name` is required (the storage validator rejects
+* entries without it); `icon` is optional only because some live
+* adapters genuinely have no icon to begin with.
+*/
+const createShadowAdapter = (entry) => {
+	const id = entry.connectorId;
+	const name = entry.name;
+	const icon = entry.icon;
+	const reject = (method) => Promise.reject(new ShadowConnectorError(method, id));
+	const base = {
+		capabilities: ALL_FALSE_CAPABILITIES,
+		connect: () => reject("connect"),
+		disconnect: () => reject("disconnect"),
+		getAccount: () => reject("getAccount"),
+		getBalance: () => reject("getBalance"),
+		getSigner: () => reject("getSigner"),
+		getTransactionReceipt: () => reject("getTransactionReceipt"),
+		icon,
+		id,
+		name,
+		sendTx: () => reject("sendTx"),
+		sendTxToChain: () => reject("sendTxToChain"),
+		signMessage: () => reject("signMessage"),
+		switchChain: () => reject("switchChain")
+	};
+	switch (entry.chainPlatform) {
+		case "bitcoin": return {
+			...base,
+			chainPlatform: "bitcoin"
+		};
+		case "evm": return {
+			...base,
+			chainPlatform: "evm"
+		};
+		case "sui": return {
+			...base,
+			chainPlatform: "sui"
+		};
+		case "svm": return {
+			...base,
+			chainPlatform: "svm"
+		};
+		case "polkadot": return {
+			...base,
+			chainPlatform: "polkadot"
+		};
+		default:
+			entry.chainPlatform;
+			throw new Error(`[butr] unknown chainPlatform: ${entry.chainPlatform}`);
+	}
+};
+/**
+* Type guard. Returns true when an adapter is a placeholder created
+* by `createShadowAdapter`. Useful for the hydration coordinator
+* (which needs to know which pool entries still need upgrading) and
+* for consumers writing wagmi-style "is this connection verified yet"
+* checks without subscribing to `reconnectingIds` directly.
+*
+* Detection is structural: a shadow has all capabilities set to false.
+* Live adapters always advertise at least one capability (every wallet
+* surface includes `getBalance`, `signMessage`, `switchChain` as
+* required methods, and adapter constructors set their flags
+* accordingly).
+*/
+const isShadowAdapter = (adapter) => {
+	return Object.values(adapter.capabilities).every((flag) => !flag);
+};
+
 //#endregion
 //#region src/logger.ts
 const logWarn = (...args) => {
@@ -749,118 +880,6 @@ const reducer = (state, event) => {
 	}
 };
 
-//#endregion
-//#region src/store/shadow-adapter.ts
-/**
-* Error thrown when a method is called on a shadow adapter; the
-* placeholder `WalletAdapter` that the store seeds into the pool when
-* an `initialState` is provided (e.g. from a server-rendered cookie
-* snapshot). Shadow adapters carry the identity and account data of a
-* previously-connected wallet, but the live wallet extension hasn't
-* been verified yet; the silent reconnect happens asynchronously
-* after mount.
-*
-* UI code that gates affordances on `wallet.connector.capabilities.*`
-* never reaches a shadow method (capabilities are all `false`). Code
-* that calls through anyway hits this typed error, which is the
-* correct loud failure: the consumer ignored the capability gate.
-*
-* Consumers wanting to wait out the reconnecting window should branch
-* on whether `connectorId` is in `state.reconnectingIds`.
-*/
-var ShadowConnectorError = class extends Error {
-	code = "BUTR_RECONNECTING";
-	connectorId;
-	method;
-	constructor(method, connectorId) {
-		super(`[butr] ${method} called on shadow connector "${connectorId}" — wait for silent reconnect to complete (check reconnectingIds.has(id) before calling).`);
-		this.name = "ShadowConnectorError";
-		this.connectorId = connectorId;
-		this.method = method;
-	}
-};
-const ALL_FALSE_CAPABILITIES = Object.freeze({
-	getBalance: false,
-	getTransactionReceipt: false,
-	requestAccounts: false,
-	sendTransaction: false,
-	signIn: false,
-	signMessage: false,
-	signTransaction: false,
-	subscribe: false,
-	switchAccount: false,
-	switchChain: false
-});
-/**
-* Builds a placeholder `WalletAdapter` from a persisted pool entry.
-*
-* Used by `createWalletStore` when `WalletManagerConfig.initialState`
-* is provided: each stored entry becomes a `ConnectedWallet` whose
-* `connector` is one of these. The store flips `isHydrated` true
-* synchronously and exposes the data through the usual hooks
-* (`useActiveWallet`, `useConnectedWallets`, …), but the connector
-* can't actually talk to a wallet yet, so its capabilities are all
-* `false` and its methods throw `ShadowConnectorError` if called.
-*
-* The hydration coordinator's silent-reconnect pass upgrades each
-* shadow to a live `WalletAdapter` by calling `createConnector(id)`
-* (which only succeeds once the live adapter has been announced via
-* discovery or registered explicitly) and replacing the pool entry.
-* On success the connector id is removed from `reconnectingIds`; on
-* failure the entry is dropped from the pool and storage.
-*
-* The entry's `name` is required (the storage validator rejects
-* entries without it); `icon` is optional only because some live
-* adapters genuinely have no icon to begin with.
-*/
-const createShadowAdapter = (entry) => {
-	const id = entry.connectorId;
-	const name = entry.name;
-	const icon = entry.icon;
-	const reject = (method) => Promise.reject(new ShadowConnectorError(method, id));
-	const base = {
-		capabilities: ALL_FALSE_CAPABILITIES,
-		connect: () => reject("connect"),
-		disconnect: () => reject("disconnect"),
-		getAccount: () => reject("getAccount"),
-		getBalance: () => reject("getBalance"),
-		getSigner: () => reject("getSigner"),
-		getTransactionReceipt: () => reject("getTransactionReceipt"),
-		icon,
-		id,
-		name,
-		sendTx: () => reject("sendTx"),
-		sendTxToChain: () => reject("sendTxToChain"),
-		signMessage: () => reject("signMessage"),
-		switchChain: () => reject("switchChain")
-	};
-	switch (entry.chainPlatform) {
-		case "bitcoin": return {
-			...base,
-			chainPlatform: "bitcoin"
-		};
-		case "evm": return {
-			...base,
-			chainPlatform: "evm"
-		};
-		case "sui": return {
-			...base,
-			chainPlatform: "sui"
-		};
-		case "svm": return {
-			...base,
-			chainPlatform: "svm"
-		};
-		case "polkadot": return {
-			...base,
-			chainPlatform: "polkadot"
-		};
-		default:
-			entry.chainPlatform;
-			throw new Error(`[butr] unknown chainPlatform: ${entry.chainPlatform}`);
-	}
-};
-
 //#endregion
 //#region src/store/wallet-store-helpers.ts
 /** Run an async operation fire-and-forget, calling onError if it throws. */
@@ -1370,10 +1389,16 @@ const readWalletSnapshot = (source, options = {}) => {
 //#region src/wallet-equal.ts
 /**
 * Two wallet snapshots are equivalent for selector purposes iff they
-* share connectorId, active account address, and active account chain
-* id. Used by `useStoreWithEqualityFn` consumers (active-wallet,
-* selected-wallet, useWalletEntry) to suppress spurious re-renders
-* when the underlying Map churns but the resolved entry hasn't changed.
+* share the same adapter instance, active account address, and active
+* account chain id. Used by `useStoreWithEqualityFn` consumers
+* (active-wallet, selected-wallet, useWalletEntry) to suppress spurious
+* re-renders when the underlying Map churns but the resolved entry
+* hasn't changed.
+*
+* The adapter is compared by reference, not by `connector.id`: hydration
+* replaces a shadow adapter with the live one under an unchanged id and
+* address, so an id comparison reports "equal" and leaves consumers
+* holding a placeholder whose every method throws ShadowConnectorError.
 *
 * Hoisted to its own module so the equivalence rule lives in one place;
 * if we ever extend the snapshot (e.g. to consider `accounts.length`),
@@ -1382,7 +1407,7 @@ const readWalletSnapshot = (source, options = {}) => {
 const walletEqual = (a, b) => {
 	if (a === b) return true;
 	if (!a || !b) return false;
-	return a.connector.id === b.connector.id && a.account.walletAddress === b.account.walletAddress && a.account.chain.id === b.account.chain.id;
+	return a.connector === b.connector && a.account.walletAddress === b.account.walletAddress && a.account.chain.id === b.account.chain.id;
 };
 
 //#endregion
@@ -1426,6 +1451,10 @@ const sanitizeIcon = (icon) => {
 * - {@link bytesToHexPrefixed} returns `0x`-prefixed hex (EVM, Polkadot).
 * - {@link hexToBytes} tolerantly strips an optional `0x` (all callers).
 */
+/** Bitcoin/Solana alphabet; omits the visually ambiguous `0`, `O`, `I`, `l`. */
+const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+const BASE58_INDEX = /* @__PURE__ */ new Map();
+for (let i = 0; i < 58; i += 1) BASE58_INDEX.set(BASE58_ALPHABET[i] ?? "", i);
 /** Bare lowercase hex, no `0x` prefix (Bitcoin, Ledger). */
 const bytesToHex = (bytes) => {
 	let hex = "";
@@ -1466,7 +1495,49 @@ const bytesToBase64 = (bytes) => {
 	for (const byte of bytes) binary += String.fromCodePoint(byte);
 	return btoa(binary);
 };
+/**
+* `Uint8Array` → base58 (Solana addresses and signatures). Leading zero
+* bytes are significant in base58 and survive the BigInt round-trip only
+* because they're re-prefixed as `1`s afterwards.
+*/
+const bytesToBase58 = (bytes) => {
+	let intVal = 0n;
+	for (const byte of bytes) intVal = intVal << 8n | BigInt(byte);
+	let out = "";
+	while (intVal > 0n) {
+		const remainder = intVal % 58n;
+		intVal /= 58n;
+		out = BASE58_ALPHABET[Number(remainder)] + out;
+	}
+	for (const byte of bytes) {
+		if (byte !== 0) break;
+		out = `1${out}`;
+	}
+	return out;
+};
+/** Decode base58 into raw bytes. Throws on characters outside the alphabet
+*  rather than silently dropping them. */
+const base58ToBytes = (input) => {
+	let intVal = 0n;
+	let leadingZeros = 0;
+	let stillLeading = true;
+	for (const char of input) {
+		if (stillLeading && char === "1") leadingZeros += 1;
+		else stillLeading = false;
+		const digit = BASE58_INDEX.get(char);
+		if (digit === void 0) throw new Error(`Invalid base58 character "${char}"`);
+		intVal = intVal * 58n + BigInt(digit);
+	}
+	const bytes = [];
+	const byteMask = 255n;
+	while (intVal > 0n) {
+		bytes.unshift(Number(intVal & byteMask));
+		intVal >>= 8n;
+	}
+	for (let i = 0; i < leadingZeros; i += 1) bytes.unshift(0);
+	return Uint8Array.from(bytes);
+};
 
 //#endregion
-export { CHAIN_PLATFORMS, EMPTY_SNAPSHOT, WalletStorage, base64ToBytes, buildAccount, buildChainsByPlatform, bytesToBase64, bytesToHex, bytesToHexPrefixed, createBrowserStorageDriver, createCookieStorageDriver, createMemoryStorageDriver, createWalletSource, createWalletStore, hexToBytes, logError, logWarn, mapConnectionError, readWalletSnapshot, sanitizeIcon, walletEqual };
+export { CHAIN_PLATFORMS, EMPTY_SNAPSHOT, ShadowConnectorError, WalletStorage, base58ToBytes, base64ToBytes, buildAccount, buildChainsByPlatform, bytesToBase58, bytesToBase64, bytesToHex, bytesToHexPrefixed, createBrowserStorageDriver, createCookieStorageDriver, createMemoryStorageDriver, createWalletSource, createWalletStore, hexToBytes, isShadowAdapter, logError, logWarn, mapConnectionError, readWalletSnapshot, sanitizeIcon, walletEqual };
 //# sourceMappingURL=index.js.map