@spacesops/wdk-react-native-core 1.0.0-beta.40

package/dist/store/walletStore.js

@@ -0,0 +1,204 @@
+/**
+ * Wallet Store - Source of Truth for Wallet Data
+ *
+ * IMPORTANT: This is the ONLY place where addresses and balances are actually stored.
+ *
+ * ## Store Boundaries
+ *
+ * **walletStore** (this file):
+ * - Wallet addresses: { [walletId]: { [network]: { [accountIndex]: address } } }
+ * - Wallet balances: { [walletId]: { [network]: { [accountIndex]: { [tokenAddress]: balance } } } }
+ * - Address loading states: { [walletId]: { [network-accountIndex]: boolean } }
+ * - Balance loading states: { [walletId]: { [network-accountIndex-tokenAddress]: boolean } }
+ * - Last balance update timestamps: { [walletId]: { [network]: { [accountIndex]: timestamp } } }
+ * - Account list: { [walletId]: Array of account info }
+ * - Wallet list: Array of wallet info (multiple wallets)
+ * - Active wallet ID: Currently active wallet identifier
+ *
+ * Note: Loading states for wallet list operations are managed locally in hooks
+ * (useWalletManager) since they're ephemeral and only used within those hooks.
+ *
+ * **workletStore** (workletStore.ts):
+ * - Worklet lifecycle state (isWorkletStarted, isInitialized, etc.)
+ * - Worklet runtime instances (worklet, hrpc, ipc)
+ * - Worklet configuration
+ *
+ * ## Separation of Concerns
+ *
+ * - **walletStore**: Manages wallet data (addresses, balances) - derived/computed from worklet
+ * - **workletStore**: Manages worklet runtime and lifecycle
+ *
+ * These stores are intentionally separate to:
+ * 1. Prevent cross-contamination of lifecycle and data concerns
+ * 2. Allow independent persistence strategies
+ * 3. Enable clear boundaries for testing and debugging
+ *
+ * ## Important Notes
+ *
+ * - Addresses: Stored in Zustand (derived/computed state, deterministic, no refetching needed)
+ * - Balances: Stored in Zustand (single source of truth), use TanStack Query via useBalance() hook for fetching
+ *   - Zustand is the single source of truth for balances
+ *   - TanStack Query reads from Zustand (initialData) and updates Zustand after fetch
+ *   - No sync logic needed - TanStack Query directly updates the source of truth
+ * - NEVER store worklet lifecycle state in walletStore
+ * - NEVER store worklet runtime instances in walletStore
+ * - All operations are handled by focused services (AddressService, BalanceService), not the store itself
+ */
+// External packages
+import { create } from 'zustand';
+import { persist, createJSONStorage, devtools } from 'zustand/middleware';
+import { createMMKVStorageAdapter } from '../storage/mmkvStorage';
+import { log, logError } from '../utils/logger';
+const initialState = {
+    addresses: {}, // walletId -> addresses
+    walletLoading: {}, // walletId -> loading states
+    balances: {}, // walletId -> balances
+    balanceLoading: {}, // walletId -> loading states
+    lastBalanceUpdate: {}, // walletId -> network -> accountIndex -> timestamp
+    accountList: {}, // walletId -> account list
+    walletList: [],
+    activeWalletId: null,
+    walletLoadingState: { type: 'not_loaded' },
+    isOperationInProgress: false,
+    currentOperation: null,
+};
+const defaultStorageAdapter = createMMKVStorageAdapter();
+let walletStoreInstance = null;
+/**
+ * Creates singleton wallet store instance.
+ * All operations are handled by focused services (AddressService, BalanceService), not the store itself.
+ */
+export function createWalletStore() {
+    if (walletStoreInstance) {
+        return walletStoreInstance;
+    }
+    const store = create()(devtools(persist((set, get) => ({
+        ...initialState,
+    }), {
+        name: 'wallet-storage',
+        storage: createJSONStorage(() => defaultStorageAdapter),
+        partialize: (state) => ({
+            addresses: state.addresses,
+            balances: state.balances,
+            balanceLoading: {},
+            lastBalanceUpdate: state.lastBalanceUpdate,
+            accountList: state.accountList,
+            walletList: state.walletList,
+            activeWalletId: state.activeWalletId,
+            // Don't persist loading state or operation mutex - these are runtime-only
+        }),
+        onRehydrateStorage: () => {
+            return (state) => {
+                if (state) {
+                    log('🔄 Rehydrating wallet state - resetting loading states');
+                    state.walletLoading = {};
+                    state.balanceLoading = {};
+                    // Reset runtime-only state
+                    state.walletLoadingState = { type: 'not_loaded' };
+                    state.isOperationInProgress = false;
+                    state.currentOperation = null;
+                }
+            };
+        },
+    }), { name: 'WalletStore' }));
+    walletStoreInstance = store;
+    return store;
+}
+export function getWalletStore() {
+    return createWalletStore();
+}
+/**
+ * Wallet state actions - helper functions for updating wallet loading state
+ * These provide a clean API for state transitions with validation
+ */
+/**
+ * Validate state transition
+ * Returns true if transition is valid, false otherwise
+ */
+function isValidStateTransition(current, next) {
+    // Allow reset from any state
+    if (next === 'not_loaded')
+        return true;
+    // Allow error from any state
+    if (next === 'error')
+        return true;
+    // After early returns, TypeScript narrows the type, but we need to check all transitions
+    // Use type assertion to tell TypeScript that 'not_loaded' and 'error' are still possible
+    // (even though they're handled by early returns, they're valid from all states)
+    const nextType = next;
+    switch (current.type) {
+        case 'not_loaded':
+            return nextType === 'checking' || nextType === 'loading';
+        case 'checking':
+            return nextType === 'loading' || nextType === 'error';
+        case 'loading':
+            return nextType === 'ready' || nextType === 'error';
+        case 'ready':
+            return nextType === 'not_loaded' || nextType === 'loading' || nextType === 'checking';
+        case 'error':
+            return nextType === 'not_loaded' || nextType === 'checking' || nextType === 'loading';
+        default:
+            return false;
+    }
+}
+/**
+ * Update wallet loading state with validation
+ * Throws error if transition is invalid
+ * Logs state transitions for debugging
+ */
+export function updateWalletLoadingState(state, newState) {
+    // Log state transition for debugging
+    if (state.walletLoadingState.type !== newState.type) {
+        log(`[WalletState] Transition: ${state.walletLoadingState.type} -> ${newState.type}`, {
+            from: state.walletLoadingState,
+            to: newState,
+        });
+    }
+    if (!isValidStateTransition(state.walletLoadingState, newState.type)) {
+        const error = new Error(`Invalid state transition from ${state.walletLoadingState.type} to ${newState.type}`);
+        logError(`⚠️ Invalid state transition: ${error.message}`, {
+            currentState: state.walletLoadingState,
+            attemptedState: newState,
+        });
+        // In development, throw error. In production, log and allow transition
+        // Note: __DEV__ is a React Native global, may not be available in all environments
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+            throw error;
+        }
+    }
+    return { walletLoadingState: newState };
+}
+/**
+ * Get wallet identifier from loading state
+ */
+export function getWalletIdFromLoadingState(state) {
+    switch (state.type) {
+        case 'checking':
+        case 'loading':
+        case 'ready':
+            return state.identifier;
+        case 'error':
+            return state.identifier;
+        case 'not_loaded':
+            return null;
+    }
+}
+/**
+ * Check if wallet is in a loading state
+ */
+export function isWalletLoadingState(state) {
+    return state.type === 'checking' || state.type === 'loading';
+}
+/**
+ * Check if wallet is ready
+ */
+export function isWalletReadyState(state) {
+    return state.type === 'ready';
+}
+/**
+ * Check if wallet is in error state
+ */
+export function isWalletErrorState(state) {
+    return state.type === 'error';
+}
+//# sourceMappingURL=walletStore.js.map

package/dist/store/walletStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletStore.js","sourceRoot":"","sources":["../../src/store/walletStore.ts"],"names":[],"mappings":"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"}

package/dist/store/workletStore.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Worklet Store - Source of Truth for Worklet Lifecycle
+ *
+ * This store manages worklet lifecycle state (initialization, configuration, runtime instances).
+ *
+ * ## Store Boundaries
+ *
+ * **workletStore** (this file):
+ * - Worklet lifecycle state (isWorkletStarted, isInitialized, isLoading)
+ * - Worklet runtime instances (worklet, hrpc, ipc)
+ * - Worklet configuration (networkConfigs)
+ * - Worklet initialization results (workletStartResult, wdkInitResult)
+ * - Encrypted credentials in memory (encryptedSeed, encryptionKey) - for active wallet
+ * - Multi-wallet credential cache (credentialsCache) - for multiple wallets
+ *
+ * **walletStore** (walletStore.ts):
+ * - Wallet data (addresses, balances)
+ * - Wallet loading states
+ * - Balance loading states
+ * - Last balance update timestamps
+ *
+ * ## Separation of Concerns
+ *
+ * - **workletStore**: Manages the worklet runtime and its lifecycle
+ * - **walletStore**: Manages wallet data derived from the worklet
+ *
+ * These stores are intentionally separate to:
+ * 1. Prevent cross-contamination of lifecycle and data concerns
+ * 2. Allow independent persistence strategies
+ * 3. Enable clear boundaries for testing and debugging
+ *
+ * ## Important Notes
+ *
+ * - NEVER store wallet data (addresses, balances) in workletStore
+ * - NEVER store worklet lifecycle state in walletStore
+ * - All worklet state is runtime-only - state resets completely on app restart
+ * - Worklets must be recreated when the app restarts
+ * - Encrypted credentials are runtime-only (loaded from secure storage when needed)
+ * - All operations are handled by WorkletLifecycleService, not the store itself
+ */
+import { create } from 'zustand';
+import { Worklet } from '@spacesops/react-native-bare-kit';
+import { HRPC } from '@spacesops/pear-wrk-wdk';
+import type { WorkletStartResponse } from '@spacesops/pear-wrk-wdk/types/rpc';
+import type { NetworkConfigs } from '../types';
+/**
+ * Cached credentials interface for multi-wallet support
+ * Credentials are cached in workletStore to avoid repeated biometric prompts
+ */
+export interface CachedCredentials {
+    encryptionKey?: string;
+    encryptedSeed?: string;
+    encryptedEntropy?: string;
+    expiresAt: number;
+}
+export interface WorkletState {
+    worklet: Worklet | null;
+    hrpc: HRPC | null;
+    ipc: unknown | null;
+    isWorkletStarted: boolean;
+    isInitialized: boolean;
+    isLoading: boolean;
+    error: string | null;
+    encryptedSeed: string | null;
+    encryptionKey: string | null;
+    networkConfigs: NetworkConfigs | null;
+    workletStartResult: WorkletStartResponse | null;
+    wdkInitResult: {
+        status?: string | null;
+    } | null;
+    credentialsCache: Record<string, CachedCredentials>;
+    credentialsCacheTTL: number;
+}
+export type WorkletStore = WorkletState;
+type WorkletStoreInstance = ReturnType<ReturnType<typeof create<WorkletStore>>>;
+/**
+ * Creates singleton worklet store instance.
+ *
+ * This store is runtime-only - all state resets on app restart.
+ * All operations are handled by WorkletLifecycleService, not the store itself.
+ */
+export declare function createWorkletStore(): WorkletStoreInstance;
+export declare function getWorkletStore(): import("zustand").UseBoundStore<import("zustand").StoreApi<WorkletState>>;
+/**
+ * Get cached credentials for a wallet identifier
+ * Returns null if not cached or expired
+ * Updates access time for LRU tracking
+ */
+export declare function getCachedCredentials(identifier: string): CachedCredentials | null;
+/**
+ * Set cached credentials for a wallet identifier
+ * Evicts LRU entries if cache size limit is reached
+ * Logs cache size for monitoring
+ */
+export declare function setCachedCredentials(identifier: string, credentials: Partial<CachedCredentials>): void;
+/**
+ * Clear credentials cache for a specific wallet or all wallets
+ * Also clears access tracking
+ */
+export declare function clearCredentialsCache(identifier?: string): void;
+/**
+ * Clear all sensitive data from memory (active wallet credentials + cache)
+ * This should be called when sensitive data is no longer needed
+ * to minimize exposure in memory dumps or debugging
+ *
+ * Note: In JavaScript, we cannot overwrite memory. Setting to null and clearing
+ * references allows garbage collection, but the old values may remain in memory
+ * until GC runs. This is a JavaScript limitation.
+ */
+export declare function clearAllSensitiveData(): void;
+/**
+ * Reset the worklet store instance (useful for testing)
+ * Also resets access tracking
+ */
+export declare function resetWorkletStore(): void;
+/**
+ * Get current credentials cache size
+ * Useful for monitoring and debugging
+ */
+export declare function getCredentialsCacheSize(): number;
+export {};

package/dist/store/workletStore.js

@@ -0,0 +1,256 @@
+/**
+ * Worklet Store - Source of Truth for Worklet Lifecycle
+ *
+ * This store manages worklet lifecycle state (initialization, configuration, runtime instances).
+ *
+ * ## Store Boundaries
+ *
+ * **workletStore** (this file):
+ * - Worklet lifecycle state (isWorkletStarted, isInitialized, isLoading)
+ * - Worklet runtime instances (worklet, hrpc, ipc)
+ * - Worklet configuration (networkConfigs)
+ * - Worklet initialization results (workletStartResult, wdkInitResult)
+ * - Encrypted credentials in memory (encryptedSeed, encryptionKey) - for active wallet
+ * - Multi-wallet credential cache (credentialsCache) - for multiple wallets
+ *
+ * **walletStore** (walletStore.ts):
+ * - Wallet data (addresses, balances)
+ * - Wallet loading states
+ * - Balance loading states
+ * - Last balance update timestamps
+ *
+ * ## Separation of Concerns
+ *
+ * - **workletStore**: Manages the worklet runtime and its lifecycle
+ * - **walletStore**: Manages wallet data derived from the worklet
+ *
+ * These stores are intentionally separate to:
+ * 1. Prevent cross-contamination of lifecycle and data concerns
+ * 2. Allow independent persistence strategies
+ * 3. Enable clear boundaries for testing and debugging
+ *
+ * ## Important Notes
+ *
+ * - NEVER store wallet data (addresses, balances) in workletStore
+ * - NEVER store worklet lifecycle state in walletStore
+ * - All worklet state is runtime-only - state resets completely on app restart
+ * - Worklets must be recreated when the app restarts
+ * - Encrypted credentials are runtime-only (loaded from secure storage when needed)
+ * - All operations are handled by WorkletLifecycleService, not the store itself
+ */
+// External packages
+import { create } from 'zustand';
+import { devtools } from 'zustand/middleware';
+import { log } from '../utils/logger';
+/**
+ * Maximum number of credentials to cache before evicting least recently used
+ * This prevents unbounded memory growth while maintaining performance
+ * Recommended: 10-20 wallets for typical use cases
+ *
+ * Cache Management:
+ * - Size Limit: When cache exceeds MAX_CREDENTIALS_CACHE_SIZE, LRU entries are evicted
+ * - TTL (Time To Live): Each credential has an expiration timestamp (default: 5 minutes)
+ * - Automatic Expiration: Expired credentials are removed on access
+ * - LRU Eviction: Least recently used credentials are evicted when size limit is reached
+ *
+ * These safeguards ensure:
+ * 1. Memory usage remains bounded
+ * 2. Credentials don't persist indefinitely in memory
+ * 3. Frequently used wallets remain cached for better UX
+ */
+const MAX_CREDENTIALS_CACHE_SIZE = 15;
+/**
+ * Access tracking for LRU eviction
+ * Tracks when each credential was last accessed
+ */
+const credentialsAccessOrder = new Map();
+let credentialsAccessCounter = 0;
+const initialState = {
+    worklet: null,
+    hrpc: null,
+    ipc: null,
+    isWorkletStarted: false,
+    isInitialized: false,
+    isLoading: false,
+    error: null,
+    encryptedSeed: null,
+    encryptionKey: null,
+    networkConfigs: null,
+    workletStartResult: null,
+    wdkInitResult: null,
+    credentialsCache: {},
+    credentialsCacheTTL: 5 * 60 * 1000, // 5 minutes
+};
+let workletStoreInstance = null;
+/**
+ * Creates singleton worklet store instance.
+ *
+ * This store is runtime-only - all state resets on app restart.
+ * All operations are handled by WorkletLifecycleService, not the store itself.
+ */
+export function createWorkletStore() {
+    if (workletStoreInstance) {
+        return workletStoreInstance;
+    }
+    const store = create()(devtools(() => ({
+        ...initialState,
+    }), { name: 'WorkletStore' }));
+    workletStoreInstance = store;
+    return store;
+}
+export function getWorkletStore() {
+    return createWorkletStore();
+}
+/**
+ * Evict least recently used credentials from cache when limit is reached
+ * Logs eviction for monitoring
+ */
+function evictLRUCredentials() {
+    const store = getWorkletStore();
+    const state = store.getState();
+    const cacheSize = Object.keys(state.credentialsCache).length;
+    if (cacheSize < MAX_CREDENTIALS_CACHE_SIZE) {
+        return;
+    }
+    // Find the least recently used credential
+    let oldestIdentifier = null;
+    let oldestAccess = Infinity;
+    for (const [identifier, accessTime] of credentialsAccessOrder.entries()) {
+        if (accessTime < oldestAccess && state.credentialsCache[identifier]) {
+            oldestAccess = accessTime;
+            oldestIdentifier = identifier;
+        }
+    }
+    // Remove the least recently used credential
+    if (oldestIdentifier !== null) {
+        const { [oldestIdentifier]: _, ...rest } = state.credentialsCache;
+        credentialsAccessOrder.delete(oldestIdentifier);
+        store.setState({ credentialsCache: rest });
+        log(`[WorkletStore] Evicted LRU credentials cache entry: ${oldestIdentifier} (cache size: ${cacheSize}/${MAX_CREDENTIALS_CACHE_SIZE})`);
+    }
+}
+/**
+ * Log cache size if it exceeds warning threshold (50% of max)
+ * Useful for monitoring cache growth in production
+ */
+function logCacheSizeIfNeeded(cacheSize) {
+    const warningThreshold = Math.ceil(MAX_CREDENTIALS_CACHE_SIZE * 0.5);
+    if (cacheSize >= warningThreshold) {
+        log(`[WorkletStore] Credentials cache size: ${cacheSize}/${MAX_CREDENTIALS_CACHE_SIZE} (${Math.round(cacheSize / MAX_CREDENTIALS_CACHE_SIZE * 100)}% full)`);
+    }
+}
+/**
+ * Get cached credentials for a wallet identifier
+ * Returns null if not cached or expired
+ * Updates access time for LRU tracking
+ */
+export function getCachedCredentials(identifier) {
+    const store = getWorkletStore();
+    const state = store.getState();
+    const cached = state.credentialsCache[identifier];
+    if (!cached)
+        return null;
+    // Check expiration
+    if (Date.now() > cached.expiresAt) {
+        // Remove expired entry
+        const { [identifier]: _, ...rest } = state.credentialsCache;
+        credentialsAccessOrder.delete(identifier);
+        store.setState({
+            credentialsCache: rest,
+        });
+        return null;
+    }
+    // Update access time for LRU tracking
+    credentialsAccessCounter++;
+    credentialsAccessOrder.set(identifier, credentialsAccessCounter);
+    return cached;
+}
+/**
+ * Set cached credentials for a wallet identifier
+ * Evicts LRU entries if cache size limit is reached
+ * Logs cache size for monitoring
+ */
+export function setCachedCredentials(identifier, credentials) {
+    const store = getWorkletStore();
+    const state = store.getState();
+    const existing = state.credentialsCache[identifier] || {};
+    // Evict LRU credentials if needed before adding new entry
+    // Check if we're adding a new entry (not just updating existing)
+    const isNewEntry = !state.credentialsCache[identifier];
+    if (isNewEntry) {
+        evictLRUCredentials();
+    }
+    // Update access time for LRU tracking
+    credentialsAccessCounter++;
+    credentialsAccessOrder.set(identifier, credentialsAccessCounter);
+    store.setState({
+        credentialsCache: {
+            ...state.credentialsCache,
+            [identifier]: {
+                ...existing,
+                ...credentials,
+                expiresAt: Date.now() + state.credentialsCacheTTL,
+            }
+        }
+    });
+    // Log cache size for monitoring (after state update)
+    const newCacheSize = Object.keys(store.getState().credentialsCache).length;
+    logCacheSizeIfNeeded(newCacheSize);
+}
+/**
+ * Clear credentials cache for a specific wallet or all wallets
+ * Also clears access tracking
+ */
+export function clearCredentialsCache(identifier) {
+    const store = getWorkletStore();
+    const state = store.getState();
+    if (identifier) {
+        // Clear specific wallet
+        const { [identifier]: _, ...rest } = state.credentialsCache;
+        credentialsAccessOrder.delete(identifier);
+        store.setState({ credentialsCache: rest });
+    }
+    else {
+        // Clear all
+        credentialsAccessOrder.clear();
+        credentialsAccessCounter = 0;
+        store.setState({ credentialsCache: {} });
+    }
+}
+/**
+ * Clear all sensitive data from memory (active wallet credentials + cache)
+ * This should be called when sensitive data is no longer needed
+ * to minimize exposure in memory dumps or debugging
+ *
+ * Note: In JavaScript, we cannot overwrite memory. Setting to null and clearing
+ * references allows garbage collection, but the old values may remain in memory
+ * until GC runs. This is a JavaScript limitation.
+ */
+export function clearAllSensitiveData() {
+    const store = getWorkletStore();
+    credentialsAccessOrder.clear();
+    credentialsAccessCounter = 0;
+    store.setState({
+        encryptedSeed: null,
+        encryptionKey: null,
+        credentialsCache: {},
+    });
+}
+/**
+ * Reset the worklet store instance (useful for testing)
+ * Also resets access tracking
+ */
+export function resetWorkletStore() {
+    credentialsAccessOrder.clear();
+    credentialsAccessCounter = 0;
+    workletStoreInstance = null;
+}
+/**
+ * Get current credentials cache size
+ * Useful for monitoring and debugging
+ */
+export function getCredentialsCacheSize() {
+    const store = getWorkletStore();
+    return Object.keys(store.getState().credentialsCache).length;
+}
+//# sourceMappingURL=workletStore.js.map

package/dist/store/workletStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workletStore.js","sourceRoot":"","sources":["../../src/store/workletStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,oBAAoB;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAS7C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAarC;;;GAGG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAkB,CAAA;AACxD,IAAI,wBAAwB,GAAG,CAAC,CAAA;AAgChC,MAAM,YAAY,GAAiB;IACjC,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,IAAI;IACT,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,IAAI;IACX,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,IAAI;IACnB,gBAAgB,EAAE,EAAE;IACpB,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;CACjD,CAAA;AAED,IAAI,oBAAoB,GAAgC,IAAI,CAAA;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAA;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,EAAgB,CAClC,QAAQ,CACN,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,YAAY;KAChB,CAAC,EACF,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CACF,CAAA;IAED,oBAAoB,GAAG,KAAK,CAAA;IAC5B,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,kBAAkB,EAAE,CAAA;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAA;IAE5D,IAAI,SAAS,GAAG,0BAA0B,EAAE,CAAC;QAC3C,OAAM;IACR,CAAC;IAED,0CAA0C;IAC1C,IAAI,gBAAgB,GAAkB,IAAI,CAAA;IAC1C,IAAI,YAAY,GAAG,QAAQ,CAAA;IAE3B,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC;QACxE,IAAI,UAAU,GAAG,YAAY,IAAI,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YACpE,YAAY,GAAG,UAAU,CAAA;YACzB,gBAAgB,GAAG,UAAU,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,gBAAgB,CAAA;QACjE,sBAAsB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAC/C,KAAK,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,GAAG,CAAC,uDAAuD,gBAAgB,iBAAiB,SAAS,IAAI,0BAA0B,GAAG,CAAC,CAAA;IACzI,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAA;IACpE,IAAI,SAAS,IAAI,gBAAgB,EAAE,CAAC;QAClC,GAAG,CAAC,0CAA0C,SAAS,IAAI,0BAA0B,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,0BAA0B,GAAG,GAAG,CAAC,SAAS,CAAC,CAAA;IAC9J,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAEjD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,mBAAmB;IACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,uBAAuB;QACvB,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,gBAAgB,CAAA;QAC3D,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACzC,KAAK,CAAC,QAAQ,CAAC;YACb,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sCAAsC;IACtC,wBAAwB,EAAE,CAAA;IAC1B,sBAAsB,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAA;IAEhE,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,WAAuC;IAEvC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAA;IAEzD,0DAA0D;IAC1D,iEAAiE;IACjE,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,mBAAmB,EAAE,CAAA;IACvB,CAAC;IAED,sCAAsC;IACtC,wBAAwB,EAAE,CAAA;IAC1B,sBAAsB,CAAC,GAAG,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAA;IAEhE,KAAK,CAAC,QAAQ,CAAC;QACb,gBAAgB,EAAE;YAChB,GAAG,KAAK,CAAC,gBAAgB;YACzB,CAAC,UAAU,CAAC,EAAE;gBACZ,GAAG,QAAQ;gBACX,GAAG,WAAW;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,mBAAmB;aAClD;SACF;KACF,CAAC,CAAA;IAEF,qDAAqD;IACrD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAA;IAC1E,oBAAoB,CAAC,YAAY,CAAC,CAAA;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAmB;IACvD,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAE9B,IAAI,UAAU,EAAE,CAAC;QACf,wBAAwB;QACxB,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,gBAAgB,CAAA;QAC3D,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACzC,KAAK,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;SAAM,CAAC;QACN,YAAY;QACZ,sBAAsB,CAAC,KAAK,EAAE,CAAA;QAC9B,wBAAwB,GAAG,CAAC,CAAA;QAC5B,KAAK,CAAC,QAAQ,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,sBAAsB,CAAC,KAAK,EAAE,CAAA;IAC9B,wBAAwB,GAAG,CAAC,CAAA;IAC5B,KAAK,CAAC,QAAQ,CAAC;QACb,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE,EAAE;KACrB,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,sBAAsB,CAAC,KAAK,EAAE,CAAA;IAC9B,wBAAwB,GAAG,CAAC,CAAA;IAC5B,oBAAoB,GAAG,IAAI,CAAA;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAA;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAA;AAC9D,CAAC"}

package/dist/types/hrpc.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HRPC Type Extensions
+ *
+ * Type definitions for HRPC methods that may not be in the @spacesops/pear-wrk-wdk types yet.
+ * These types extend the HRPC interface to provide proper type safety.
+ */
+import type { HRPC } from '@spacesops/pear-wrk-wdk';
+/**
+ * Extended HRPC interface with additional methods
+ */
+export interface ExtendedHRPC extends HRPC {
+    /**
+     * Initialize WDK with encrypted seed
+     */
+    initializeWDK: (options: {
+        encryptionKey: string;
+        encryptedSeed: string;
+        config: string;
+    }) => Promise<{
+        status?: string | null;
+    }>;
+    /**
+     * Generate entropy and encrypt it
+     */
+    generateEntropyAndEncrypt: (options: {
+        wordCount: number;
+    }) => Promise<{
+        encryptionKey: string;
+        encryptedSeedBuffer: string;
+        encryptedEntropyBuffer: string;
+    }>;
+    /**
+     * Get mnemonic from encrypted entropy
+     */
+    getMnemonicFromEntropy: (options: {
+        encryptedEntropy: string;
+        encryptionKey: string;
+    }) => Promise<{
+        mnemonic: string;
+    }>;
+    /**
+     * Get seed and entropy from mnemonic phrase
+     */
+    getSeedAndEntropyFromMnemonic: (options: {
+        mnemonic: string;
+    }) => Promise<{
+        encryptionKey: string;
+        encryptedSeedBuffer: string;
+        encryptedEntropyBuffer: string;
+    }>;
+}
+/**
+ * Type guard to check if HRPC instance has extended methods
+ */
+export declare function isExtendedHRPC(hrpc: HRPC): hrpc is ExtendedHRPC;
+/**
+ * Safely cast HRPC to ExtendedHRPC
+ * Throws if the HRPC instance doesn't have the required methods
+ */
+export declare function asExtendedHRPC(hrpc: HRPC): ExtendedHRPC;

package/dist/types/hrpc.js

@@ -0,0 +1,26 @@
+/**
+ * HRPC Type Extensions
+ *
+ * Type definitions for HRPC methods that may not be in the @spacesops/pear-wrk-wdk types yet.
+ * These types extend the HRPC interface to provide proper type safety.
+ */
+/**
+ * Type guard to check if HRPC instance has extended methods
+ */
+export function isExtendedHRPC(hrpc) {
+    return (typeof hrpc.initializeWDK === 'function' &&
+        typeof hrpc.generateEntropyAndEncrypt === 'function' &&
+        typeof hrpc.getMnemonicFromEntropy === 'function' &&
+        typeof hrpc.getSeedAndEntropyFromMnemonic === 'function');
+}
+/**
+ * Safely cast HRPC to ExtendedHRPC
+ * Throws if the HRPC instance doesn't have the required methods
+ */
+export function asExtendedHRPC(hrpc) {
+    if (!isExtendedHRPC(hrpc)) {
+        throw new Error('HRPC instance does not have required extended methods');
+    }
+    return hrpc;
+}
+//# sourceMappingURL=hrpc.js.map