npm - otx-btc-wallet-core - Versions diffs - 0.1.0 - Mend

otx-btc-wallet-core 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/store/index.ts","../src/createConfig.ts","../src/utils/psbt.ts"],"names":[],"mappings":"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","sourcesContent":["import { createStore as createZustandStore } from 'zustand/vanilla';\nimport { persist, subscribeWithSelector } from 'zustand/middleware';\nimport type { PersistOptions } from 'zustand/middleware';\nimport type { BitcoinConnector } from '../types/connector';\nimport type { WalletAccount } from '../types/account';\nimport type { BtcWalletState, ConnectionStatus } from '../types/state';\nimport type { BitcoinNetwork } from '../types/network';\nimport type { Config } from '../types/config';\n\n/**\n * Store actions\n */\nexport type StoreActions = {\n /** Connect to a wallet */\n connect: (\n connector: BitcoinConnector,\n network?: BitcoinNetwork\n ) => Promise<WalletAccount>;\n\n /** Disconnect from current wallet */\n disconnect: () => Promise<void>;\n\n /** Reconnect to previously connected wallet */\n reconnect: (connectors: BitcoinConnector[]) => Promise<void>;\n\n /** Set account */\n setAccount: (account: WalletAccount | null) => void;\n\n /** Set connection status */\n setStatus: (status: ConnectionStatus) => void;\n\n /** Set error */\n setError: (error: Error | null) => void;\n\n /** Reset store to initial state */\n reset: () => void;\n};\n\nexport type Store = BtcWalletState & StoreActions;\n\n/** Persisted state shape - only these fields are saved to storage */\ntype PersistedState = {\n connectorId: string | null;\n network: string;\n};\n\nconst initialState: BtcWalletState = {\n status: 'disconnected',\n account: null,\n connector: null,\n connectorId: null,\n network: 'mainnet',\n error: null,\n};\n\n/**\n * Create the btc-wallet store\n */\nexport function createStore(config: Config) {\n // Track cleanup functions for event listeners to prevent memory leaks\n let unsubscribeAccounts: (() => void) | null = null;\n let unsubscribeNetwork: (() => void) | null = null;\n\n /**\n * Cleanup all event listeners\n */\n const cleanupListeners = () => {\n if (unsubscribeAccounts) {\n unsubscribeAccounts();\n unsubscribeAccounts = null;\n }\n if (unsubscribeNetwork) {\n unsubscribeNetwork();\n unsubscribeNetwork = null;\n }\n };\n\n /**\n * Setup event listeners for a connector\n * This is shared between connect and reconnect to avoid code duplication\n */\n const setupConnectorListeners = (\n connector: BitcoinConnector,\n get: () => Store,\n set: (partial: Partial<Store>) => void\n ) => {\n // Clean up any existing listeners first\n cleanupListeners();\n\n // Subscribe to account changes\n unsubscribeAccounts = connector.onAccountsChanged((accounts) => {\n const currentState = get();\n\n // Only handle if this connector is still the active one\n if (currentState.connector?.id !== connector.id) {\n return;\n }\n\n if (accounts.length === 0) {\n // Wallet disconnected from extension side\n // Use catch to handle any errors silently\n get().disconnect().catch(() => {\n // Disconnect failed, but we should still clean up state\n set({\n status: 'disconnected',\n account: null,\n connector: null,\n connectorId: null,\n error: null,\n });\n });\n } else if (accounts[0]) {\n set({ account: accounts[0] });\n }\n });\n\n // Subscribe to network changes\n unsubscribeNetwork = connector.onNetworkChanged((network) => {\n const currentState = get();\n\n // Only handle if this connector is still the active one\n if (currentState.connector?.id !== connector.id) {\n return;\n }\n\n set({ network });\n });\n };\n\n // Define persist options with proper typing\n const persistOptions: PersistOptions<Store, PersistedState> = {\n name: config.storageKey,\n storage: config.storage\n ? {\n getItem: (name) => {\n const value = config.storage?.getItem(name);\n if (!value) return null;\n try {\n return JSON.parse(value) as { state: PersistedState };\n } catch {\n return null;\n }\n },\n setItem: (name, value) => {\n config.storage?.setItem(name, JSON.stringify(value));\n },\n removeItem: (name) => {\n config.storage?.removeItem(name);\n },\n }\n : undefined,\n // Only persist connectorId and network\n partialize: (state): PersistedState => ({\n connectorId: state.connectorId,\n network: state.network,\n }),\n };\n\n const store = createZustandStore<Store>()(\n subscribeWithSelector(\n persist(\n (set, get) => ({\n // Initial state\n ...initialState,\n\n // Actions\n connect: async (\n connector: BitcoinConnector,\n networkParam?: BitcoinNetwork\n ) => {\n const { status, network: storeNetwork } = get();\n const network = networkParam ?? storeNetwork;\n\n // Prevent duplicate connection attempts\n if (status === 'connecting') {\n throw new Error('Connection already in progress');\n }\n\n // Clean up any existing connection first\n cleanupListeners();\n\n set({ status: 'connecting', error: null, network });\n\n try {\n // Check if wallet is ready\n if (!connector.ready) {\n throw new Error(`${connector.name} wallet is not available`);\n }\n\n // Connect to wallet with network\n const account = await connector.connect(network);\n\n set({\n status: 'connected',\n account,\n connector,\n connectorId: connector.id,\n error: null,\n });\n\n // Setup event listeners\n setupConnectorListeners(connector, get, set);\n\n return account;\n } catch (error) {\n const err = error instanceof Error ? error : new Error(String(error));\n set({\n status: 'disconnected',\n error: err,\n });\n throw error;\n }\n },\n\n disconnect: async () => {\n const { connector } = get();\n\n // Clean up listeners first\n cleanupListeners();\n\n try {\n if (connector) {\n await connector.disconnect();\n }\n } catch {\n // Ignore disconnect errors (wallet might already be locked)\n } finally {\n set({\n status: 'disconnected',\n account: null,\n connector: null,\n connectorId: null,\n error: null,\n });\n }\n },\n\n reconnect: async (connectors: BitcoinConnector[]) => {\n const { connectorId, status, network } = get();\n\n // Only reconnect if we have a saved connector and not already connected\n if (!connectorId || status === 'connected') {\n return;\n }\n\n // Find the connector\n const connector = connectors.find((c) => c.id === connectorId);\n if (!connector?.ready) {\n // Clear saved connector if not available\n set({ connectorId: null });\n return;\n }\n\n set({ status: 'reconnecting' });\n\n try {\n const account = await connector.connect(network);\n\n set({\n status: 'connected',\n account,\n connector,\n error: null,\n });\n\n // Setup event listeners (reusing shared function)\n setupConnectorListeners(connector, get, set);\n } catch {\n // Reconnect failed silently, clear state\n set({\n status: 'disconnected',\n connectorId: null,\n });\n }\n },\n\n setAccount: (account) => set({ account }),\n\n setStatus: (status) => set({ status }),\n\n setError: (error) => set({ error }),\n\n reset: () => {\n cleanupListeners();\n set(initialState);\n },\n }),\n persistOptions\n )\n )\n );\n\n return store;\n}\n\nexport type BtcWalletStore = ReturnType<typeof createStore>;\n","import type { BtcWalletConfig, Config } from './types/config';\nimport { createStore, type BtcWalletStore } from './store';\n\n/**\n * Resolved config with store instance\n */\nexport type ResolvedConfig = Config & {\n store: BtcWalletStore;\n};\n\n/**\n * Create otx-btc-wallet configuration\n *\n * @example\n * ```ts\n * import { createConfig } from 'otx-btc-wallet-core';\n * import { UnisatConnector } from 'otx-btc-wallet-connectors/unisat';\n *\n * const config = createConfig({\n * connectors: [new UnisatConnector()],\n * autoConnect: true,\n * });\n * ```\n */\nexport function createConfig(options: BtcWalletConfig): ResolvedConfig {\n // Validate connectors\n if (!options.connectors || options.connectors.length === 0) {\n throw new Error('At least one connector is required');\n }\n\n // Check for duplicate connector IDs\n const connectorIds = new Set<string>();\n for (const connector of options.connectors) {\n if (connectorIds.has(connector.id)) {\n throw new Error(`Duplicate connector ID: ${connector.id}`);\n }\n connectorIds.add(connector.id);\n }\n\n // Resolve defaults\n const config: Config = {\n connectors: options.connectors,\n autoConnect: options.autoConnect ?? true,\n storage: getStorage(options.storage),\n storageKey: options.storageKey ?? 'optimex-btc-wallet.store',\n };\n\n // Create store\n const store = createStore(config);\n\n // Auto-connect if enabled\n if (config.autoConnect) {\n // Use setTimeout to ensure this runs after store is fully initialized\n setTimeout(() => {\n void store.getState().reconnect(config.connectors);\n }, 0);\n }\n\n return {\n ...config,\n store,\n };\n}\n\n/**\n * Get storage implementation\n */\nfunction getStorage(storage?: Storage): Storage | null {\n // If explicitly provided, use it\n if (storage !== undefined) {\n return storage;\n }\n\n // Default to localStorage if available\n if (typeof window !== 'undefined' && window.localStorage) {\n return window.localStorage;\n }\n\n return null;\n}\n","/**\n * PSBT (Partially Signed Bitcoin Transaction) utilities\n */\n\n/**\n * Convert PSBT hex to base64\n */\nexport function psbtHexToBase64(hex: string): string {\n // Remove any whitespace\n const cleanHex = hex.replace(/\\s/g, '');\n\n // Validate hex string\n if (!/^[0-9a-fA-F]*$/.test(cleanHex)) {\n throw new Error('Invalid hex string');\n }\n\n if (cleanHex.length % 2 !== 0) {\n throw new Error('Hex string must have even length');\n }\n\n // Convert hex to bytes then to base64\n const bytes = new Uint8Array(cleanHex.length / 2);\n for (let i = 0; i < cleanHex.length; i += 2) {\n bytes[i / 2] = parseInt(cleanHex.substring(i, i + 2), 16);\n }\n\n // Use Buffer in Node.js or btoa in browser\n if (typeof Buffer !== 'undefined') {\n return Buffer.from(bytes).toString('base64');\n }\n\n // Browser fallback\n let binary = '';\n for (let i = 0; i < bytes.length; i++) {\n binary += String.fromCharCode(bytes[i]!);\n }\n return btoa(binary);\n}\n\n/**\n * Convert PSBT base64 to hex\n */\nexport function psbtBase64ToHex(base64: string): string {\n // Decode base64 to bytes\n let bytes: Uint8Array;\n\n if (typeof Buffer !== 'undefined') {\n bytes = Buffer.from(base64, 'base64');\n } else {\n // Browser fallback\n const binary = atob(base64);\n bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n }\n\n // Convert bytes to hex\n return Array.from(bytes)\n .map((b) => b.toString(16).padStart(2, '0'))\n .join('');\n}\n\n/**\n * Validate PSBT hex format\n * PSBT magic bytes: 0x70736274ff (psbt\\xff)\n */\nexport function isValidPsbtHex(hex: string): boolean {\n const cleanHex = hex.replace(/\\s/g, '').toLowerCase();\n\n // Check minimum length (magic bytes = 5 bytes = 10 hex chars)\n if (cleanHex.length < 10) {\n return false;\n }\n\n // Check magic bytes\n return cleanHex.startsWith('70736274ff');\n}\n\n/**\n * Validate PSBT base64 format\n */\nexport function isValidPsbtBase64(base64: string): boolean {\n try {\n const hex = psbtBase64ToHex(base64);\n return isValidPsbtHex(hex);\n } catch {\n return false;\n }\n}\n\n/**\n * Extract basic info from PSBT hex (without full parsing)\n * This is a lightweight check - for full parsing use a library like bitcoinjs-lib\n */\nexport function getPsbtInfo(psbtHex: string): {\n isValid: boolean;\n version: number | null;\n inputCount: number | null;\n outputCount: number | null;\n} {\n if (!isValidPsbtHex(psbtHex)) {\n return {\n isValid: false,\n version: null,\n inputCount: null,\n outputCount: null,\n };\n }\n\n // PSBT structure is complex, return basic validation only\n // For full parsing, use bitcoinjs-lib or similar\n return {\n isValid: true,\n version: null, // Would need full parsing\n inputCount: null, // Would need full parsing\n outputCount: null, // Would need full parsing\n };\n}\n\n/**\n * Combine multiple signed PSBTs into one\n * Note: This is a basic implementation. For complex cases, use bitcoinjs-lib.\n *\n * @param psbts - Array of PSBT hex strings to combine\n * @returns Combined PSBT hex\n */\nexport function combinePsbts(psbts: string[]): string {\n if (psbts.length === 0) {\n throw new Error('No PSBTs provided');\n }\n\n if (psbts.length === 1) {\n return psbts[0]!;\n }\n\n // For proper PSBT combination, you need bitcoinjs-lib\n // This is just a placeholder that returns the first PSBT\n // In production, use: bitcoin.Psbt.combine([psbt1, psbt2, ...])\n console.warn(\n 'combinePsbts: For proper PSBT combination, use bitcoinjs-lib. ' +\n 'This function returns the first PSBT as a fallback.'\n );\n\n return psbts[0]!;\n}\n\n/**\n * Sighash types for Bitcoin transactions\n */\nexport const SighashType = {\n ALL: 0x01,\n NONE: 0x02,\n SINGLE: 0x03,\n ANYONECANPAY: 0x80,\n ALL_ANYONECANPAY: 0x81,\n NONE_ANYONECANPAY: 0x82,\n SINGLE_ANYONECANPAY: 0x83,\n} as const;\n\nexport type SighashType = (typeof SighashType)[keyof typeof SighashType];\n\n/**\n * Get human-readable name for sighash type\n */\nexport function getSighashTypeName(sighash: number): string {\n switch (sighash) {\n case SighashType.ALL:\n return 'SIGHASH_ALL';\n case SighashType.NONE:\n return 'SIGHASH_NONE';\n case SighashType.SINGLE:\n return 'SIGHASH_SINGLE';\n case SighashType.ANYONECANPAY:\n return 'SIGHASH_ANYONECANPAY';\n case SighashType.ALL_ANYONECANPAY:\n return 'SIGHASH_ALL|ANYONECANPAY';\n case SighashType.NONE_ANYONECANPAY:\n return 'SIGHASH_NONE|ANYONECANPAY';\n case SighashType.SINGLE_ANYONECANPAY:\n return 'SIGHASH_SINGLE|ANYONECANPAY';\n default:\n return `UNKNOWN(${sighash})`;\n }\n}\n"]}

package/dist/index.mjs ADDED Viewed

@@ -0,0 +1,331 @@
+import { createStore as createStore$1 } from 'zustand/vanilla';
+import { subscribeWithSelector, persist } from 'zustand/middleware';
+// src/store/index.ts
+var initialState = {
+  status: "disconnected",
+  account: null,
+  connector: null,
+  connectorId: null,
+  network: "mainnet",
+  error: null
+};
+function createStore(config) {
+  let unsubscribeAccounts = null;
+  let unsubscribeNetwork = null;
+  const cleanupListeners = () => {
+    if (unsubscribeAccounts) {
+      unsubscribeAccounts();
+      unsubscribeAccounts = null;
+    }
+    if (unsubscribeNetwork) {
+      unsubscribeNetwork();
+      unsubscribeNetwork = null;
+    }
+  };
+  const setupConnectorListeners = (connector, get, set) => {
+    cleanupListeners();
+    unsubscribeAccounts = connector.onAccountsChanged((accounts) => {
+      const currentState = get();
+      if (currentState.connector?.id !== connector.id) {
+        return;
+      }
+      if (accounts.length === 0) {
+        get().disconnect().catch(() => {
+          set({
+            status: "disconnected",
+            account: null,
+            connector: null,
+            connectorId: null,
+            error: null
+          });
+        });
+      } else if (accounts[0]) {
+        set({ account: accounts[0] });
+      }
+    });
+    unsubscribeNetwork = connector.onNetworkChanged((network) => {
+      const currentState = get();
+      if (currentState.connector?.id !== connector.id) {
+        return;
+      }
+      set({ network });
+    });
+  };
+  const persistOptions = {
+    name: config.storageKey,
+    storage: config.storage ? {
+      getItem: (name) => {
+        const value = config.storage?.getItem(name);
+        if (!value)
+          return null;
+        try {
+          return JSON.parse(value);
+        } catch {
+          return null;
+        }
+      },
+      setItem: (name, value) => {
+        config.storage?.setItem(name, JSON.stringify(value));
+      },
+      removeItem: (name) => {
+        config.storage?.removeItem(name);
+      }
+    } : void 0,
+    // Only persist connectorId and network
+    partialize: (state) => ({
+      connectorId: state.connectorId,
+      network: state.network
+    })
+  };
+  const store = createStore$1()(
+    subscribeWithSelector(
+      persist(
+        (set, get) => ({
+          // Initial state
+          ...initialState,
+          // Actions
+          connect: async (connector, networkParam) => {
+            const { status, network: storeNetwork } = get();
+            const network = networkParam ?? storeNetwork;
+            if (status === "connecting") {
+              throw new Error("Connection already in progress");
+            }
+            cleanupListeners();
+            set({ status: "connecting", error: null, network });
+            try {
+              if (!connector.ready) {
+                throw new Error(`${connector.name} wallet is not available`);
+              }
+              const account = await connector.connect(network);
+              set({
+                status: "connected",
+                account,
+                connector,
+                connectorId: connector.id,
+                error: null
+              });
+              setupConnectorListeners(connector, get, set);
+              return account;
+            } catch (error) {
+              const err = error instanceof Error ? error : new Error(String(error));
+              set({
+                status: "disconnected",
+                error: err
+              });
+              throw error;
+            }
+          },
+          disconnect: async () => {
+            const { connector } = get();
+            cleanupListeners();
+            try {
+              if (connector) {
+                await connector.disconnect();
+              }
+            } catch {
+            } finally {
+              set({
+                status: "disconnected",
+                account: null,
+                connector: null,
+                connectorId: null,
+                error: null
+              });
+            }
+          },
+          reconnect: async (connectors) => {
+            const { connectorId, status, network } = get();
+            if (!connectorId || status === "connected") {
+              return;
+            }
+            const connector = connectors.find((c) => c.id === connectorId);
+            if (!connector?.ready) {
+              set({ connectorId: null });
+              return;
+            }
+            set({ status: "reconnecting" });
+            try {
+              const account = await connector.connect(network);
+              set({
+                status: "connected",
+                account,
+                connector,
+                error: null
+              });
+              setupConnectorListeners(connector, get, set);
+            } catch {
+              set({
+                status: "disconnected",
+                connectorId: null
+              });
+            }
+          },
+          setAccount: (account) => set({ account }),
+          setStatus: (status) => set({ status }),
+          setError: (error) => set({ error }),
+          reset: () => {
+            cleanupListeners();
+            set(initialState);
+          }
+        }),
+        persistOptions
+      )
+    )
+  );
+  return store;
+}
+// src/createConfig.ts
+function createConfig(options) {
+  if (!options.connectors || options.connectors.length === 0) {
+    throw new Error("At least one connector is required");
+  }
+  const connectorIds = /* @__PURE__ */ new Set();
+  for (const connector of options.connectors) {
+    if (connectorIds.has(connector.id)) {
+      throw new Error(`Duplicate connector ID: ${connector.id}`);
+    }
+    connectorIds.add(connector.id);
+  }
+  const config = {
+    connectors: options.connectors,
+    autoConnect: options.autoConnect ?? true,
+    storage: getStorage(options.storage),
+    storageKey: options.storageKey ?? "optimex-btc-wallet.store"
+  };
+  const store = createStore(config);
+  if (config.autoConnect) {
+    setTimeout(() => {
+      void store.getState().reconnect(config.connectors);
+    }, 0);
+  }
+  return {
+    ...config,
+    store
+  };
+}
+function getStorage(storage) {
+  if (storage !== void 0) {
+    return storage;
+  }
+  if (typeof window !== "undefined" && window.localStorage) {
+    return window.localStorage;
+  }
+  return null;
+}
+// src/utils/psbt.ts
+function psbtHexToBase64(hex) {
+  const cleanHex = hex.replace(/\s/g, "");
+  if (!/^[0-9a-fA-F]*$/.test(cleanHex)) {
+    throw new Error("Invalid hex string");
+  }
+  if (cleanHex.length % 2 !== 0) {
+    throw new Error("Hex string must have even length");
+  }
+  const bytes = new Uint8Array(cleanHex.length / 2);
+  for (let i = 0; i < cleanHex.length; i += 2) {
+    bytes[i / 2] = parseInt(cleanHex.substring(i, i + 2), 16);
+  }
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(bytes).toString("base64");
+  }
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}
+function psbtBase64ToHex(base64) {
+  let bytes;
+  if (typeof Buffer !== "undefined") {
+    bytes = Buffer.from(base64, "base64");
+  } else {
+    const binary = atob(base64);
+    bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+  }
+  return Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+function isValidPsbtHex(hex) {
+  const cleanHex = hex.replace(/\s/g, "").toLowerCase();
+  if (cleanHex.length < 10) {
+    return false;
+  }
+  return cleanHex.startsWith("70736274ff");
+}
+function isValidPsbtBase64(base64) {
+  try {
+    const hex = psbtBase64ToHex(base64);
+    return isValidPsbtHex(hex);
+  } catch {
+    return false;
+  }
+}
+function getPsbtInfo(psbtHex) {
+  if (!isValidPsbtHex(psbtHex)) {
+    return {
+      isValid: false,
+      version: null,
+      inputCount: null,
+      outputCount: null
+    };
+  }
+  return {
+    isValid: true,
+    version: null,
+    // Would need full parsing
+    inputCount: null,
+    // Would need full parsing
+    outputCount: null
+    // Would need full parsing
+  };
+}
+function combinePsbts(psbts) {
+  if (psbts.length === 0) {
+    throw new Error("No PSBTs provided");
+  }
+  if (psbts.length === 1) {
+    return psbts[0];
+  }
+  console.warn(
+    "combinePsbts: For proper PSBT combination, use bitcoinjs-lib. This function returns the first PSBT as a fallback."
+  );
+  return psbts[0];
+}
+var SighashType = {
+  ALL: 1,
+  NONE: 2,
+  SINGLE: 3,
+  ANYONECANPAY: 128,
+  ALL_ANYONECANPAY: 129,
+  NONE_ANYONECANPAY: 130,
+  SINGLE_ANYONECANPAY: 131
+};
+function getSighashTypeName(sighash) {
+  switch (sighash) {
+    case SighashType.ALL:
+      return "SIGHASH_ALL";
+    case SighashType.NONE:
+      return "SIGHASH_NONE";
+    case SighashType.SINGLE:
+      return "SIGHASH_SINGLE";
+    case SighashType.ANYONECANPAY:
+      return "SIGHASH_ANYONECANPAY";
+    case SighashType.ALL_ANYONECANPAY:
+      return "SIGHASH_ALL|ANYONECANPAY";
+    case SighashType.NONE_ANYONECANPAY:
+      return "SIGHASH_NONE|ANYONECANPAY";
+    case SighashType.SINGLE_ANYONECANPAY:
+      return "SIGHASH_SINGLE|ANYONECANPAY";
+    default:
+      return `UNKNOWN(${sighash})`;
+  }
+}
+export { SighashType, combinePsbts, createConfig, createStore, getPsbtInfo, getSighashTypeName, isValidPsbtBase64, isValidPsbtHex, psbtBase64ToHex, psbtHexToBase64 };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map ADDED Viewed

@@ -0,0 +1 @@

package/package.json ADDED Viewed

@@ -0,0 +1,41 @@
+{
+  "name": "otx-btc-wallet-core",
+  "version": "0.1.0",
+  "description": "Core state management and types for otx-btc-wallet",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "zustand": "^4.4.7"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.2",
+    "tsup": "^8.0.1"
+  },
+  "peerDependencies": {},
+  "keywords": [
+    "bitcoin",
+    "wallet",
+    "btc",
+    "web3"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/createConfig.ts ADDED Viewed

@@ -0,0 +1,80 @@
+import type { BtcWalletConfig, Config } from './types/config';
+import { createStore, type BtcWalletStore } from './store';
+/**
+ * Resolved config with store instance
+ */
+export type ResolvedConfig = Config & {
+  store: BtcWalletStore;
+};
+/**
+ * Create otx-btc-wallet configuration
+ *
+ * @example
+ * ```ts
+ * import { createConfig } from 'otx-btc-wallet-core';
+ * import { UnisatConnector } from 'otx-btc-wallet-connectors/unisat';
+ *
+ * const config = createConfig({
+ *   connectors: [new UnisatConnector()],
+ *   autoConnect: true,
+ * });
+ * ```
+ */
+export function createConfig(options: BtcWalletConfig): ResolvedConfig {
+  // Validate connectors
+  if (!options.connectors || options.connectors.length === 0) {
+    throw new Error('At least one connector is required');
+  }
+  // Check for duplicate connector IDs
+  const connectorIds = new Set<string>();
+  for (const connector of options.connectors) {
+    if (connectorIds.has(connector.id)) {
+      throw new Error(`Duplicate connector ID: ${connector.id}`);
+    }
+    connectorIds.add(connector.id);
+  }
+  // Resolve defaults
+  const config: Config = {
+    connectors: options.connectors,
+    autoConnect: options.autoConnect ?? true,
+    storage: getStorage(options.storage),
+    storageKey: options.storageKey ?? 'optimex-btc-wallet.store',
+  };
+  // Create store
+  const store = createStore(config);
+  // Auto-connect if enabled
+  if (config.autoConnect) {
+    // Use setTimeout to ensure this runs after store is fully initialized
+    setTimeout(() => {
+      void store.getState().reconnect(config.connectors);
+    }, 0);
+  }
+  return {
+    ...config,
+    store,
+  };
+}
+/**
+ * Get storage implementation
+ */
+function getStorage(storage?: Storage): Storage | null {
+  // If explicitly provided, use it
+  if (storage !== undefined) {
+    return storage;
+  }
+  // Default to localStorage if available
+  if (typeof window !== 'undefined' && window.localStorage) {
+    return window.localStorage;
+  }
+  return null;
+}

package/src/index.ts ADDED Viewed

@@ -0,0 +1,40 @@
+// otx-btc-wallet-core - Core state management and types
+// Types
+export type {
+  BitcoinConnector,
+  WalletAccount,
+  AddressType,
+  MultiAddressAccount,
+  BitcoinNetwork,
+  SignPsbtOptions,
+  SignInput,
+  BtcWalletConfig,
+  Config,
+  BtcWalletState,
+  ConnectionStatus,
+} from './types';
+// Config
+export { createConfig, type ResolvedConfig } from './createConfig';
+// Store
+export {
+  createStore,
+  type BtcWalletStore,
+  type Store,
+  type StoreActions,
+} from './store';
+// PSBT Utilities
+export {
+  psbtHexToBase64,
+  psbtBase64ToHex,
+  isValidPsbtHex,
+  isValidPsbtBase64,
+  getPsbtInfo,
+  combinePsbts,
+  SighashType,
+  getSighashTypeName,
+} from './utils/psbt';