@thru/wallet-store 0.2.1

package/README.md

@@ -0,0 +1,112 @@
+# @thru/wallet-store
+
+Browser-side IndexedDB storage layer for the Thru wallet. Provides typed helpers for persisting accounts, connected dApps, and passkey profiles in a single unified database. Replaces the legacy `@thru/indexed-db-stamper` package.
+
+## Installation
+
+```bash
+pnpm add @thru/wallet-store
+```
+
+## Basic Usage
+
+```typescript
+import {
+  AccountStorage,
+  ConnectedAppsStorage,
+  loadPasskeyProfiles,
+  savePasskeyProfiles,
+} from '@thru/wallet-store';
+
+// Save and retrieve accounts
+await AccountStorage.saveAccount({
+  index: 0,
+  label: 'Main',
+  publicKey: '...',
+  path: "m/44'/501'/0'/0'",
+  createdAt: new Date(),
+});
+const accounts = await AccountStorage.getAccounts();
+
+// Track connected dApps per account
+await ConnectedAppsStorage.upsert({
+  accountId: 0,
+  appId: 'my-dapp',
+  origin: 'https://my-dapp.example',
+  metadata: { name: 'My dApp', icon: '...' },
+});
+const apps = await ConnectedAppsStorage.listByAccount(0);
+
+// Manage passkey profiles
+const store = await loadPasskeyProfiles();
+if (store) {
+  await savePasskeyProfiles(store);
+}
+```
+
+### Key Capabilities
+
+- Single shared IndexedDB database (`thru-wallet` v1) with lazy singleton connection
+- **AccountStorage** -- CRUD for HD-derived account metadata (does not store private keys)
+- **ConnectedAppsStorage** -- track which dApps are authorized per account, with upsert and indexed lookups
+- **Passkey profiles** -- load, save, create, and update WebAuthn passkey profiles with built-in schema migration support
+- Pure in-memory transform helpers (`updateProfilePasskey`, `updatePasskeyLastUsed`) that separate mutation from persistence
+- SSR-safe: passkey helpers return `null` / `false` when `window` is undefined
+
+## Database Schema
+
+The package opens a single IndexedDB database named `thru-wallet` at version 1 with three object stores:
+
+| Store | Key | Indexes | Purpose |
+|---|---|---|---|
+| `accounts` | `index` | `by-created` | HD wallet account metadata |
+| `connectedApps` | `accountId:appId` | `by-account`, `by-updated` | Authorized dApp connections |
+| `passkeyProfiles` | `id` | -- | WebAuthn passkey profiles and settings |
+
+Access the raw database connection when needed:
+
+```typescript
+import { getUnifiedDB } from '@thru/wallet-store';
+
+const db = await getUnifiedDB();
+```
+
+## API Reference
+
+### AccountStorage
+
+| Method | Description |
+|---|---|
+| `saveAccount(account)` | Insert or update an account record |
+| `getAccounts()` | List all accounts sorted by index |
+| `getAccount(index)` | Fetch a single account by its BIP-44 index |
+| `updateAccountLabel(index, label)` | Rename an account |
+| `getNextAccountIndex()` | Return the next unused account index |
+| `hasAccounts()` | Check whether any accounts exist |
+| `getAccountCount()` | Return total account count |
+| `clearAccounts()` | Delete all account records |
+
+### ConnectedAppsStorage
+
+| Method | Description |
+|---|---|
+| `upsert(app)` | Insert or update a connected app record |
+| `listByAccount(accountId)` | List apps for an account, most recently updated first |
+| `get(accountId, appId)` | Fetch a single connection record |
+| `remove(accountId, appId)` | Delete a connection |
+| `clear()` | Delete all connected app records |
+
+### Passkey Profiles
+
+| Function | Description |
+|---|---|
+| `loadPasskeyProfiles()` | Load all profiles and settings from IndexedDB |
+| `savePasskeyProfiles(store)` | Persist the full profile store (replaces all records) |
+| `createDefaultProfileStore()` | Create an in-memory store with one empty default profile |
+| `updateProfilePasskey(store, index, passkey)` | Pure transform: attach passkey metadata to a profile |
+| `updatePasskeyLastUsed(store, index)` | Pure transform: bump `lastUsedAt` timestamp |
+
+## Dependencies
+
+- [`idb`](https://github.com/jakearchibald/idb) -- Promise-based IndexedDB wrapper
+- `@thru/chain-interfaces` -- shared type definitions

package/dist/index.d.ts

@@ -0,0 +1,139 @@
+import { AddressType, AppMetadata, ConnectedApp } from '@thru/chain-interfaces';
+import { IDBPDatabase } from 'idb';
+
+/**
+ * Stored account representation in IndexedDB
+ */
+interface StoredAccount {
+    index: number;
+    label: string;
+    publicKey: string;
+    path: string;
+    createdAt: Date;
+    addressType?: AddressType;
+    publicKeyRawBase64?: string;
+}
+
+/**
+ * Account storage management using the unified IndexedDB.
+ * Stores metadata for each derived account (but NOT private keys).
+ */
+declare class AccountStorage {
+    /**
+     * Save a new account to storage
+     */
+    static saveAccount(account: StoredAccount): Promise<void>;
+    /**
+     * Get all accounts, sorted by index (ascending)
+     */
+    static getAccounts(): Promise<StoredAccount[]>;
+    /**
+     * Get a specific account by index
+     */
+    static getAccount(index: number): Promise<StoredAccount | null>;
+    /**
+     * Update an account's label
+     */
+    static updateAccountLabel(index: number, label: string): Promise<void>;
+    /**
+     * Get the next available account index
+     */
+    static getNextAccountIndex(): Promise<number>;
+    /**
+     * Check if any accounts exist
+     */
+    static hasAccounts(): Promise<boolean>;
+    /**
+     * Get total number of accounts
+     */
+    static getAccountCount(): Promise<number>;
+    /**
+     * Clear all accounts (use with caution!)
+     */
+    static clearAccounts(): Promise<void>;
+}
+
+interface ConnectedAppUpsert {
+    accountId: number;
+    appId: string;
+    origin: string;
+    metadata: AppMetadata;
+}
+/**
+ * Storage helper for connected dApps per account
+ */
+declare class ConnectedAppsStorage {
+    private static getDB;
+    static upsert(app: ConnectedAppUpsert): Promise<ConnectedApp>;
+    static listByAccount(accountId: number): Promise<ConnectedApp[]>;
+    static remove(accountId: number, appId: string): Promise<void>;
+    static clear(): Promise<void>;
+    static get(accountId: number, appId: string): Promise<ConnectedApp | null>;
+}
+
+/**
+ * Returns the shared unified database connection.
+ */
+declare function getUnifiedDB(): Promise<IDBPDatabase>;
+
+declare const DB_NAME = "thru-wallet";
+declare const DB_VERSION = 1;
+declare enum StoreName {
+    CONNECTED_APPS = "connectedApps",
+    ACCOUNTS = "accounts",
+    PASSKEY_PROFILES = "passkeyProfiles"
+}
+interface ConnectedAppData {
+    key: string;
+    accountId: number;
+    appId: string;
+    origin: string;
+    metadata: AppMetadata;
+    connectedAt: number;
+    updatedAt: number;
+}
+
+interface PasskeyMetadata {
+    credentialId: string;
+    publicKeyX: string;
+    publicKeyY: string;
+    rpId: string;
+    label?: string;
+    createdAt: string;
+    lastUsedAt: string;
+}
+interface PasskeyProfile {
+    id: string;
+    label: string;
+    passkey: PasskeyMetadata | null;
+    createdAt: string;
+    lastUsedAt: string | null;
+}
+interface PasskeyProfileStore {
+    profiles: PasskeyProfile[];
+    selectedIndex: number;
+}
+/**
+ * Load all passkey profiles and settings from IndexedDB.
+ * Returns null if no profiles exist or if the DB is unavailable.
+ */
+declare function loadPasskeyProfiles(): Promise<PasskeyProfileStore | null>;
+/**
+ * Save all passkey profiles and settings to IndexedDB.
+ * Returns true on success, false on failure.
+ */
+declare function savePasskeyProfiles(store: PasskeyProfileStore): Promise<boolean>;
+/**
+ * Create a default profile store with one empty profile.
+ */
+declare function createDefaultProfileStore(): PasskeyProfileStore;
+/**
+ * Update a profile's passkey metadata (pure in-memory transform).
+ */
+declare function updateProfilePasskey(store: PasskeyProfileStore, profileIndex: number, passkey: PasskeyMetadata): PasskeyProfileStore;
+/**
+ * Update lastUsedAt timestamp for a profile's passkey (pure in-memory transform).
+ */
+declare function updatePasskeyLastUsed(store: PasskeyProfileStore, profileIndex: number): PasskeyProfileStore;
+
+export { AccountStorage, type ConnectedAppData, ConnectedAppsStorage, DB_NAME, DB_VERSION, type PasskeyMetadata, type PasskeyProfile, type PasskeyProfileStore, StoreName, type StoredAccount, createDefaultProfileStore, getUnifiedDB, loadPasskeyProfiles, savePasskeyProfiles, updatePasskeyLastUsed, updateProfilePasskey };

package/dist/index.js

@@ -0,0 +1,274 @@
+import { openDB } from 'idb';
+
+// src/db.ts
+
+// src/schema.ts
+var DB_NAME = "thru-wallet";
+var DB_VERSION = 1;
+var StoreName = /* @__PURE__ */ ((StoreName2) => {
+  StoreName2["CONNECTED_APPS"] = "connectedApps";
+  StoreName2["ACCOUNTS"] = "accounts";
+  StoreName2["PASSKEY_PROFILES"] = "passkeyProfiles";
+  return StoreName2;
+})(StoreName || {});
+function initializeSchema(db) {
+  const connectedApps = db.createObjectStore("connectedApps" /* CONNECTED_APPS */, { keyPath: "key" });
+  connectedApps.createIndex("by-account", "accountId", { unique: false });
+  connectedApps.createIndex("by-updated", "updatedAt", { unique: false });
+  const accounts = db.createObjectStore("accounts" /* ACCOUNTS */, { keyPath: "index" });
+  accounts.createIndex("by-created", "createdAt", { unique: false });
+  db.createObjectStore("passkeyProfiles" /* PASSKEY_PROFILES */, { keyPath: "id" });
+}
+
+// src/db.ts
+var dbPromise = null;
+function getUnifiedDB() {
+  if (!dbPromise) {
+    dbPromise = openDB(DB_NAME, DB_VERSION, {
+      upgrade(db) {
+        initializeSchema(db);
+      }
+    });
+  }
+  return dbPromise;
+}
+
+// src/account-store.ts
+var STORE_NAME = "accounts" /* ACCOUNTS */;
+var AccountStorage = class {
+  /**
+   * Save a new account to storage
+   */
+  static async saveAccount(account) {
+    const db = await getUnifiedDB();
+    await db.put(STORE_NAME, account);
+  }
+  /**
+   * Get all accounts, sorted by index (ascending)
+   */
+  static async getAccounts() {
+    const db = await getUnifiedDB();
+    const accounts = await db.getAll(STORE_NAME);
+    return accounts.sort((a, b) => a.index - b.index);
+  }
+  /**
+   * Get a specific account by index
+   */
+  static async getAccount(index) {
+    const db = await getUnifiedDB();
+    const account = await db.get(STORE_NAME, index);
+    return account || null;
+  }
+  /**
+   * Update an account's label
+   */
+  static async updateAccountLabel(index, label) {
+    const db = await getUnifiedDB();
+    const account = await db.get(STORE_NAME, index);
+    if (!account) {
+      throw new Error(`Account ${index} not found`);
+    }
+    account.label = label;
+    await db.put(STORE_NAME, account);
+  }
+  /**
+   * Get the next available account index
+   */
+  static async getNextAccountIndex() {
+    const accounts = await this.getAccounts();
+    if (accounts.length === 0) {
+      return 0;
+    }
+    const maxIndex = Math.max(...accounts.map((a) => a.index));
+    return maxIndex + 1;
+  }
+  /**
+   * Check if any accounts exist
+   */
+  static async hasAccounts() {
+    const db = await getUnifiedDB();
+    const count = await db.count(STORE_NAME);
+    return count > 0;
+  }
+  /**
+   * Get total number of accounts
+   */
+  static async getAccountCount() {
+    const db = await getUnifiedDB();
+    return await db.count(STORE_NAME);
+  }
+  /**
+   * Clear all accounts (use with caution!)
+   */
+  static async clearAccounts() {
+    const db = await getUnifiedDB();
+    await db.clear(STORE_NAME);
+  }
+};
+
+// src/connected-apps-store.ts
+var STORE_NAME2 = "connectedApps" /* CONNECTED_APPS */;
+function createKey(accountId, appId) {
+  return `${accountId}:${appId}`;
+}
+function toDomain(record) {
+  return {
+    accountId: record.accountId,
+    appId: record.appId,
+    origin: record.origin,
+    metadata: record.metadata,
+    connectedAt: record.connectedAt,
+    updatedAt: record.updatedAt
+  };
+}
+var ConnectedAppsStorage = class {
+  static async getDB() {
+    return getUnifiedDB();
+  }
+  static async upsert(app) {
+    const db = await this.getDB();
+    const key = createKey(app.accountId, app.appId);
+    const existing = await db.get(STORE_NAME2, key);
+    const now = Date.now();
+    const record = {
+      key,
+      accountId: app.accountId,
+      appId: app.appId,
+      origin: app.origin,
+      metadata: app.metadata,
+      connectedAt: existing?.connectedAt ?? now,
+      updatedAt: now
+    };
+    await db.put(STORE_NAME2, record);
+    return toDomain(record);
+  }
+  static async listByAccount(accountId) {
+    const db = await this.getDB();
+    const records = await db.getAllFromIndex(STORE_NAME2, "by-account", IDBKeyRange.only(accountId));
+    return records.sort((a, b) => b.updatedAt - a.updatedAt).map(toDomain);
+  }
+  static async remove(accountId, appId) {
+    const db = await this.getDB();
+    await db.delete(STORE_NAME2, createKey(accountId, appId));
+  }
+  static async clear() {
+    const db = await this.getDB();
+    await db.clear(STORE_NAME2);
+  }
+  static async get(accountId, appId) {
+    const db = await this.getDB();
+    const record = await db.get(STORE_NAME2, createKey(accountId, appId));
+    return record ? toDomain(record) : null;
+  }
+};
+
+// src/passkey-profiles.ts
+var CURRENT_PROFILE_VERSION = 1;
+var SETTINGS_KEY = "settings";
+async function loadPasskeyProfiles() {
+  if (typeof window === "undefined") return null;
+  try {
+    const db = await getUnifiedDB();
+    const allRecords = await db.getAll("passkeyProfiles" /* PASSKEY_PROFILES */);
+    let settings = null;
+    const profiles = [];
+    for (const record of allRecords) {
+      if (record.id === SETTINGS_KEY) {
+        settings = record;
+      } else if (record.id) {
+        profiles.push(record);
+      }
+    }
+    if (profiles.length === 0) return null;
+    if (settings && settings.version < CURRENT_PROFILE_VERSION) {
+      migrateProfiles(profiles, settings.version);
+      settings = { ...settings, version: CURRENT_PROFILE_VERSION };
+      await db.put("passkeyProfiles" /* PASSKEY_PROFILES */, settings);
+    }
+    return {
+      profiles,
+      selectedIndex: settings?.selectedIndex ?? 0
+    };
+  } catch {
+    return null;
+  }
+}
+async function savePasskeyProfiles(store) {
+  if (typeof window === "undefined") return false;
+  try {
+    const db = await getUnifiedDB();
+    const tx = db.transaction("passkeyProfiles" /* PASSKEY_PROFILES */, "readwrite");
+    await tx.store.clear();
+    for (const profile of store.profiles) {
+      await tx.store.put(profile);
+    }
+    const settings = {
+      id: SETTINGS_KEY,
+      selectedIndex: store.selectedIndex,
+      version: CURRENT_PROFILE_VERSION
+    };
+    await tx.store.put(settings);
+    await tx.done;
+    return true;
+  } catch {
+    return false;
+  }
+}
+function createDefaultProfileStore() {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const profileId = typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : String(Date.now());
+  return {
+    profiles: [
+      {
+        id: profileId,
+        label: "Default Profile",
+        passkey: null,
+        createdAt: now,
+        lastUsedAt: null
+      }
+    ],
+    selectedIndex: 0
+  };
+}
+function updateProfilePasskey(store, profileIndex, passkey) {
+  const updatedProfiles = [...store.profiles];
+  const current = updatedProfiles[profileIndex];
+  if (!current) {
+    return store;
+  }
+  updatedProfiles[profileIndex] = {
+    ...current,
+    passkey,
+    lastUsedAt: passkey.lastUsedAt
+  };
+  return {
+    ...store,
+    profiles: updatedProfiles
+  };
+}
+function updatePasskeyLastUsed(store, profileIndex) {
+  const updatedProfiles = [...store.profiles];
+  const current = updatedProfiles[profileIndex];
+  if (!current?.passkey) {
+    return store;
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  updatedProfiles[profileIndex] = {
+    ...current,
+    passkey: {
+      ...current.passkey,
+      lastUsedAt: now
+    },
+    lastUsedAt: now
+  };
+  return {
+    ...store,
+    profiles: updatedProfiles
+  };
+}
+function migrateProfiles(_profiles, _fromVersion) {
+}
+
+export { AccountStorage, ConnectedAppsStorage, DB_NAME, DB_VERSION, StoreName, createDefaultProfileStore, getUnifiedDB, loadPasskeyProfiles, savePasskeyProfiles, updatePasskeyLastUsed, updateProfilePasskey };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/db.ts","../src/account-store.ts","../src/connected-apps-store.ts","../src/passkey-profiles.ts"],"names":["StoreName","STORE_NAME"],"mappings":"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","file":"index.js","sourcesContent":["import type { AppMetadata } from '@thru/chain-interfaces';\n\nexport const DB_NAME = 'thru-wallet';\nexport const DB_VERSION = 1;\n\nexport enum StoreName {\n  CONNECTED_APPS = 'connectedApps',\n  ACCOUNTS = 'accounts',\n  PASSKEY_PROFILES = 'passkeyProfiles',\n}\n\nexport interface ConnectedAppData {\n  key: string; // `${accountId}:${appId}`\n  accountId: number;\n  appId: string;\n  origin: string;\n  metadata: AppMetadata;\n  connectedAt: number;\n  updatedAt: number;\n}\n\n/**\n * Initialize database schema.\n */\nexport function initializeSchema(db: IDBDatabase): void {\n  const connectedApps = db.createObjectStore(StoreName.CONNECTED_APPS, { keyPath: 'key' });\n  connectedApps.createIndex('by-account', 'accountId', { unique: false });\n  connectedApps.createIndex('by-updated', 'updatedAt', { unique: false });\n\n  const accounts = db.createObjectStore(StoreName.ACCOUNTS, { keyPath: 'index' });\n  accounts.createIndex('by-created', 'createdAt', { unique: false });\n\n  db.createObjectStore(StoreName.PASSKEY_PROFILES, { keyPath: 'id' });\n}\n","import { openDB, type IDBPDatabase } from 'idb';\nimport { DB_NAME, DB_VERSION, initializeSchema } from './schema';\n\nlet dbPromise: Promise<IDBPDatabase> | null = null;\n\n/**\n * Returns the shared unified database connection.\n */\nexport function getUnifiedDB(): Promise<IDBPDatabase> {\n  if (!dbPromise) {\n    dbPromise = openDB(DB_NAME, DB_VERSION, {\n      upgrade(db) {\n        initializeSchema(db as unknown as IDBDatabase);\n      },\n    });\n  }\n  return dbPromise;\n}\n","import { getUnifiedDB } from './db';\nimport { StoreName } from './schema';\nimport { StoredAccount } from './types';\n\nconst STORE_NAME = StoreName.ACCOUNTS;\n\n/**\n * Account storage management using the unified IndexedDB.\n * Stores metadata for each derived account (but NOT private keys).\n */\nexport class AccountStorage {\n  /**\n   * Save a new account to storage\n   */\n  static async saveAccount(account: StoredAccount): Promise<void> {\n    const db = await getUnifiedDB();\n    await db.put(STORE_NAME, account);\n  }\n\n  /**\n   * Get all accounts, sorted by index (ascending)\n   */\n  static async getAccounts(): Promise<StoredAccount[]> {\n    const db = await getUnifiedDB();\n    const accounts = await db.getAll(STORE_NAME) as StoredAccount[];\n    return accounts.sort((a, b) => a.index - b.index);\n  }\n\n  /**\n   * Get a specific account by index\n   */\n  static async getAccount(index: number): Promise<StoredAccount | null> {\n    const db = await getUnifiedDB();\n    const account = await db.get(STORE_NAME, index) as StoredAccount | undefined;\n    return account || null;\n  }\n\n  /**\n   * Update an account's label\n   */\n  static async updateAccountLabel(index: number, label: string): Promise<void> {\n    const db = await getUnifiedDB();\n    const account = await db.get(STORE_NAME, index) as StoredAccount | undefined;\n\n    if (!account) {\n      throw new Error(`Account ${index} not found`);\n    }\n\n    account.label = label;\n    await db.put(STORE_NAME, account);\n  }\n\n  /**\n   * Get the next available account index\n   */\n  static async getNextAccountIndex(): Promise<number> {\n    const accounts = await this.getAccounts();\n\n    if (accounts.length === 0) {\n      return 0;\n    }\n\n    const maxIndex = Math.max(...accounts.map(a => a.index));\n    return maxIndex + 1;\n  }\n\n  /**\n   * Check if any accounts exist\n   */\n  static async hasAccounts(): Promise<boolean> {\n    const db = await getUnifiedDB();\n    const count = await db.count(STORE_NAME);\n    return count > 0;\n  }\n\n  /**\n   * Get total number of accounts\n   */\n  static async getAccountCount(): Promise<number> {\n    const db = await getUnifiedDB();\n    return await db.count(STORE_NAME);\n  }\n\n  /**\n   * Clear all accounts (use with caution!)\n   */\n  static async clearAccounts(): Promise<void> {\n    const db = await getUnifiedDB();\n    await db.clear(STORE_NAME);\n  }\n}\n","import { getUnifiedDB } from './db';\nimport {\n  StoreName,\n  type ConnectedAppData,\n} from './schema';\nimport type { ConnectedApp, AppMetadata } from '@thru/chain-interfaces';\n\nconst STORE_NAME = StoreName.CONNECTED_APPS;\n\nfunction createKey(accountId: number, appId: string): string {\n  return `${accountId}:${appId}`;\n}\n\nfunction toDomain(record: ConnectedAppData): ConnectedApp {\n  return {\n    accountId: record.accountId,\n    appId: record.appId,\n    origin: record.origin,\n    metadata: record.metadata,\n    connectedAt: record.connectedAt,\n    updatedAt: record.updatedAt,\n  };\n}\n\nexport interface ConnectedAppUpsert {\n  accountId: number;\n  appId: string;\n  origin: string;\n  metadata: AppMetadata;\n}\n\n/**\n * Storage helper for connected dApps per account\n */\nexport class ConnectedAppsStorage {\n  private static async getDB() {\n    return getUnifiedDB();\n  }\n\n  static async upsert(app: ConnectedAppUpsert): Promise<ConnectedApp> {\n    const db = await this.getDB();\n    const key = createKey(app.accountId, app.appId);\n    const existing = (await db.get(STORE_NAME, key)) as ConnectedAppData | undefined;\n    const now = Date.now();\n\n    const record: ConnectedAppData = {\n      key,\n      accountId: app.accountId,\n      appId: app.appId,\n      origin: app.origin,\n      metadata: app.metadata,\n      connectedAt: existing?.connectedAt ?? now,\n      updatedAt: now,\n    };\n\n    await db.put(STORE_NAME, record);\n    return toDomain(record);\n  }\n\n  static async listByAccount(accountId: number): Promise<ConnectedApp[]> {\n    const db = await this.getDB();\n    const records = (await db.getAllFromIndex(STORE_NAME, 'by-account', IDBKeyRange.only(accountId))) as ConnectedAppData[];\n    return records\n      .sort((a, b) => b.updatedAt - a.updatedAt)\n      .map(toDomain);\n  }\n\n  static async remove(accountId: number, appId: string): Promise<void> {\n    const db = await this.getDB();\n    await db.delete(STORE_NAME, createKey(accountId, appId));\n  }\n\n  static async clear(): Promise<void> {\n    const db = await this.getDB();\n    await db.clear(STORE_NAME);\n  }\n\n  static async get(accountId: number, appId: string): Promise<ConnectedApp | null> {\n    const db = await this.getDB();\n    const record = (await db.get(STORE_NAME, createKey(accountId, appId))) as ConnectedAppData | undefined;\n    return record ? toDomain(record) : null;\n  }\n}\n","import { getUnifiedDB } from './db';\nimport { StoreName } from './schema';\nimport type { PasskeyProfileRecord, PasskeyStoreSettings } from './types';\n\nconst CURRENT_PROFILE_VERSION = 1;\nconst SETTINGS_KEY = 'settings';\n\nexport interface PasskeyMetadata {\n  credentialId: string;\n  publicKeyX: string;\n  publicKeyY: string;\n  rpId: string;\n  label?: string;\n  createdAt: string;\n  lastUsedAt: string;\n}\n\nexport interface PasskeyProfile {\n  id: string;\n  label: string;\n  passkey: PasskeyMetadata | null;\n  createdAt: string;\n  lastUsedAt: string | null;\n}\n\nexport interface PasskeyProfileStore {\n  profiles: PasskeyProfile[];\n  selectedIndex: number;\n}\n\n/**\n * Load all passkey profiles and settings from IndexedDB.\n * Returns null if no profiles exist or if the DB is unavailable.\n */\nexport async function loadPasskeyProfiles(): Promise<PasskeyProfileStore | null> {\n  if (typeof window === 'undefined') return null;\n\n  try {\n    const db = await getUnifiedDB();\n    const allRecords = await db.getAll(StoreName.PASSKEY_PROFILES);\n\n    let settings: PasskeyStoreSettings | null = null;\n    const profiles: PasskeyProfile[] = [];\n\n    for (const record of allRecords) {\n      if (record.id === SETTINGS_KEY) {\n        settings = record as PasskeyStoreSettings;\n      } else if (record.id) {\n        profiles.push(record as PasskeyProfile);\n      }\n    }\n\n    if (profiles.length === 0) return null;\n\n    // Run schema migration if needed\n    if (settings && settings.version < CURRENT_PROFILE_VERSION) {\n      migrateProfiles(profiles, settings.version);\n      settings = { ...settings, version: CURRENT_PROFILE_VERSION };\n      await db.put(StoreName.PASSKEY_PROFILES, settings);\n    }\n\n    return {\n      profiles,\n      selectedIndex: settings?.selectedIndex ?? 0,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Save all passkey profiles and settings to IndexedDB.\n * Returns true on success, false on failure.\n */\nexport async function savePasskeyProfiles(store: PasskeyProfileStore): Promise<boolean> {\n  if (typeof window === 'undefined') return false;\n\n  try {\n    const db = await getUnifiedDB();\n    const tx = db.transaction(StoreName.PASSKEY_PROFILES, 'readwrite');\n\n    // Clear all existing records\n    await tx.store.clear();\n\n    // Write profiles\n    for (const profile of store.profiles) {\n      await tx.store.put(profile as PasskeyProfileRecord);\n    }\n\n    // Write settings\n    const settings: PasskeyStoreSettings = {\n      id: SETTINGS_KEY,\n      selectedIndex: store.selectedIndex,\n      version: CURRENT_PROFILE_VERSION,\n    };\n    await tx.store.put(settings);\n\n    await tx.done;\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Create a default profile store with one empty profile.\n */\nexport function createDefaultProfileStore(): PasskeyProfileStore {\n  const now = new Date().toISOString();\n  const profileId = typeof crypto !== 'undefined' && 'randomUUID' in crypto\n    ? crypto.randomUUID()\n    : String(Date.now());\n\n  return {\n    profiles: [\n      {\n        id: profileId,\n        label: 'Default Profile',\n        passkey: null,\n        createdAt: now,\n        lastUsedAt: null,\n      },\n    ],\n    selectedIndex: 0,\n  };\n}\n\n/**\n * Update a profile's passkey metadata (pure in-memory transform).\n */\nexport function updateProfilePasskey(\n  store: PasskeyProfileStore,\n  profileIndex: number,\n  passkey: PasskeyMetadata\n): PasskeyProfileStore {\n  const updatedProfiles = [...store.profiles];\n  const current = updatedProfiles[profileIndex];\n  if (!current) {\n    return store;\n  }\n\n  updatedProfiles[profileIndex] = {\n    ...current,\n    passkey,\n    lastUsedAt: passkey.lastUsedAt,\n  };\n\n  return {\n    ...store,\n    profiles: updatedProfiles,\n  };\n}\n\n/**\n * Update lastUsedAt timestamp for a profile's passkey (pure in-memory transform).\n */\nexport function updatePasskeyLastUsed(\n  store: PasskeyProfileStore,\n  profileIndex: number\n): PasskeyProfileStore {\n  const updatedProfiles = [...store.profiles];\n  const current = updatedProfiles[profileIndex];\n  if (!current?.passkey) {\n    return store;\n  }\n\n  const now = new Date().toISOString();\n  updatedProfiles[profileIndex] = {\n    ...current,\n    passkey: {\n      ...current.passkey,\n      lastUsedAt: now,\n    },\n    lastUsedAt: now,\n  };\n\n  return {\n    ...store,\n    profiles: updatedProfiles,\n  };\n}\n\n/**\n * Migrate profile data from an older schema version to current.\n * Mutates profiles in-place for efficiency.\n */\nfunction migrateProfiles(_profiles: PasskeyProfile[], _fromVersion: number): void {\n  // Currently at version 1, no migrations needed yet.\n  // Future migrations would go here:\n  // if (fromVersion < 2) { ... }\n}\n"]}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@thru/wallet-store",
+  "version": "0.2.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "idb": "^8.0.3",
+    "@thru/chain-interfaces": "0.2.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}

package/src/account-store.ts

@@ -0,0 +1,91 @@
+import { getUnifiedDB } from './db';
+import { StoreName } from './schema';
+import { StoredAccount } from './types';
+
+const STORE_NAME = StoreName.ACCOUNTS;
+
+/**
+ * Account storage management using the unified IndexedDB.
+ * Stores metadata for each derived account (but NOT private keys).
+ */
+export class AccountStorage {
+  /**
+   * Save a new account to storage
+   */
+  static async saveAccount(account: StoredAccount): Promise<void> {
+    const db = await getUnifiedDB();
+    await db.put(STORE_NAME, account);
+  }
+
+  /**
+   * Get all accounts, sorted by index (ascending)
+   */
+  static async getAccounts(): Promise<StoredAccount[]> {
+    const db = await getUnifiedDB();
+    const accounts = await db.getAll(STORE_NAME) as StoredAccount[];
+    return accounts.sort((a, b) => a.index - b.index);
+  }
+
+  /**
+   * Get a specific account by index
+   */
+  static async getAccount(index: number): Promise<StoredAccount | null> {
+    const db = await getUnifiedDB();
+    const account = await db.get(STORE_NAME, index) as StoredAccount | undefined;
+    return account || null;
+  }
+
+  /**
+   * Update an account's label
+   */
+  static async updateAccountLabel(index: number, label: string): Promise<void> {
+    const db = await getUnifiedDB();
+    const account = await db.get(STORE_NAME, index) as StoredAccount | undefined;
+
+    if (!account) {
+      throw new Error(`Account ${index} not found`);
+    }
+
+    account.label = label;
+    await db.put(STORE_NAME, account);
+  }
+
+  /**
+   * Get the next available account index
+   */
+  static async getNextAccountIndex(): Promise<number> {
+    const accounts = await this.getAccounts();
+
+    if (accounts.length === 0) {
+      return 0;
+    }
+
+    const maxIndex = Math.max(...accounts.map(a => a.index));
+    return maxIndex + 1;
+  }
+
+  /**
+   * Check if any accounts exist
+   */
+  static async hasAccounts(): Promise<boolean> {
+    const db = await getUnifiedDB();
+    const count = await db.count(STORE_NAME);
+    return count > 0;
+  }
+
+  /**
+   * Get total number of accounts
+   */
+  static async getAccountCount(): Promise<number> {
+    const db = await getUnifiedDB();
+    return await db.count(STORE_NAME);
+  }
+
+  /**
+   * Clear all accounts (use with caution!)
+   */
+  static async clearAccounts(): Promise<void> {
+    const db = await getUnifiedDB();
+    await db.clear(STORE_NAME);
+  }
+}

package/src/connected-apps-store.ts

@@ -0,0 +1,83 @@
+import { getUnifiedDB } from './db';
+import {
+  StoreName,
+  type ConnectedAppData,
+} from './schema';
+import type { ConnectedApp, AppMetadata } from '@thru/chain-interfaces';
+
+const STORE_NAME = StoreName.CONNECTED_APPS;
+
+function createKey(accountId: number, appId: string): string {
+  return `${accountId}:${appId}`;
+}
+
+function toDomain(record: ConnectedAppData): ConnectedApp {
+  return {
+    accountId: record.accountId,
+    appId: record.appId,
+    origin: record.origin,
+    metadata: record.metadata,
+    connectedAt: record.connectedAt,
+    updatedAt: record.updatedAt,
+  };
+}
+
+export interface ConnectedAppUpsert {
+  accountId: number;
+  appId: string;
+  origin: string;
+  metadata: AppMetadata;
+}
+
+/**
+ * Storage helper for connected dApps per account
+ */
+export class ConnectedAppsStorage {
+  private static async getDB() {
+    return getUnifiedDB();
+  }
+
+  static async upsert(app: ConnectedAppUpsert): Promise<ConnectedApp> {
+    const db = await this.getDB();
+    const key = createKey(app.accountId, app.appId);
+    const existing = (await db.get(STORE_NAME, key)) as ConnectedAppData | undefined;
+    const now = Date.now();
+
+    const record: ConnectedAppData = {
+      key,
+      accountId: app.accountId,
+      appId: app.appId,
+      origin: app.origin,
+      metadata: app.metadata,
+      connectedAt: existing?.connectedAt ?? now,
+      updatedAt: now,
+    };
+
+    await db.put(STORE_NAME, record);
+    return toDomain(record);
+  }
+
+  static async listByAccount(accountId: number): Promise<ConnectedApp[]> {
+    const db = await this.getDB();
+    const records = (await db.getAllFromIndex(STORE_NAME, 'by-account', IDBKeyRange.only(accountId))) as ConnectedAppData[];
+    return records
+      .sort((a, b) => b.updatedAt - a.updatedAt)
+      .map(toDomain);
+  }
+
+  static async remove(accountId: number, appId: string): Promise<void> {
+    const db = await this.getDB();
+    await db.delete(STORE_NAME, createKey(accountId, appId));
+  }
+
+  static async clear(): Promise<void> {
+    const db = await this.getDB();
+    await db.clear(STORE_NAME);
+  }
+
+  static async get(accountId: number, appId: string): Promise<ConnectedApp | null> {
+    const db = await this.getDB();
+    const record = (await db.get(STORE_NAME, createKey(accountId, appId))) as ConnectedAppData | undefined;
+    return record ? toDomain(record) : null;
+  }
+}

package/src/db.ts

@@ -0,0 +1,18 @@
+import { openDB, type IDBPDatabase } from 'idb';
+import { DB_NAME, DB_VERSION, initializeSchema } from './schema';
+
+let dbPromise: Promise<IDBPDatabase> | null = null;
+
+/**
+ * Returns the shared unified database connection.
+ */
+export function getUnifiedDB(): Promise<IDBPDatabase> {
+  if (!dbPromise) {
+    dbPromise = openDB(DB_NAME, DB_VERSION, {
+      upgrade(db) {
+        initializeSchema(db as unknown as IDBDatabase);
+      },
+    });
+  }
+  return dbPromise;
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+export { AccountStorage } from './account-store';
+export { ConnectedAppsStorage } from './connected-apps-store';
+export { getUnifiedDB } from './db';
+export {
+  type ConnectedAppData,
+  StoreName,
+  DB_NAME,
+  DB_VERSION,
+} from './schema';
+export { type StoredAccount } from './types';
+export {
+  loadPasskeyProfiles,
+  savePasskeyProfiles,
+  createDefaultProfileStore,
+  updateProfilePasskey,
+  updatePasskeyLastUsed,
+  type PasskeyMetadata,
+  type PasskeyProfile,
+  type PasskeyProfileStore,
+} from './passkey-profiles';

package/src/passkey-profiles.ts

@@ -0,0 +1,191 @@
+import { getUnifiedDB } from './db';
+import { StoreName } from './schema';
+import type { PasskeyProfileRecord, PasskeyStoreSettings } from './types';
+
+const CURRENT_PROFILE_VERSION = 1;
+const SETTINGS_KEY = 'settings';
+
+export interface PasskeyMetadata {
+  credentialId: string;
+  publicKeyX: string;
+  publicKeyY: string;
+  rpId: string;
+  label?: string;
+  createdAt: string;
+  lastUsedAt: string;
+}
+
+export interface PasskeyProfile {
+  id: string;
+  label: string;
+  passkey: PasskeyMetadata | null;
+  createdAt: string;
+  lastUsedAt: string | null;
+}
+
+export interface PasskeyProfileStore {
+  profiles: PasskeyProfile[];
+  selectedIndex: number;
+}
+
+/**
+ * Load all passkey profiles and settings from IndexedDB.
+ * Returns null if no profiles exist or if the DB is unavailable.
+ */
+export async function loadPasskeyProfiles(): Promise<PasskeyProfileStore | null> {
+  if (typeof window === 'undefined') return null;
+
+  try {
+    const db = await getUnifiedDB();
+    const allRecords = await db.getAll(StoreName.PASSKEY_PROFILES);
+
+    let settings: PasskeyStoreSettings | null = null;
+    const profiles: PasskeyProfile[] = [];
+
+    for (const record of allRecords) {
+      if (record.id === SETTINGS_KEY) {
+        settings = record as PasskeyStoreSettings;
+      } else if (record.id) {
+        profiles.push(record as PasskeyProfile);
+      }
+    }
+
+    if (profiles.length === 0) return null;
+
+    // Run schema migration if needed
+    if (settings && settings.version < CURRENT_PROFILE_VERSION) {
+      migrateProfiles(profiles, settings.version);
+      settings = { ...settings, version: CURRENT_PROFILE_VERSION };
+      await db.put(StoreName.PASSKEY_PROFILES, settings);
+    }
+
+    return {
+      profiles,
+      selectedIndex: settings?.selectedIndex ?? 0,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Save all passkey profiles and settings to IndexedDB.
+ * Returns true on success, false on failure.
+ */
+export async function savePasskeyProfiles(store: PasskeyProfileStore): Promise<boolean> {
+  if (typeof window === 'undefined') return false;
+
+  try {
+    const db = await getUnifiedDB();
+    const tx = db.transaction(StoreName.PASSKEY_PROFILES, 'readwrite');
+
+    // Clear all existing records
+    await tx.store.clear();
+
+    // Write profiles
+    for (const profile of store.profiles) {
+      await tx.store.put(profile as PasskeyProfileRecord);
+    }
+
+    // Write settings
+    const settings: PasskeyStoreSettings = {
+      id: SETTINGS_KEY,
+      selectedIndex: store.selectedIndex,
+      version: CURRENT_PROFILE_VERSION,
+    };
+    await tx.store.put(settings);
+
+    await tx.done;
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Create a default profile store with one empty profile.
+ */
+export function createDefaultProfileStore(): PasskeyProfileStore {
+  const now = new Date().toISOString();
+  const profileId = typeof crypto !== 'undefined' && 'randomUUID' in crypto
+    ? crypto.randomUUID()
+    : String(Date.now());
+
+  return {
+    profiles: [
+      {
+        id: profileId,
+        label: 'Default Profile',
+        passkey: null,
+        createdAt: now,
+        lastUsedAt: null,
+      },
+    ],
+    selectedIndex: 0,
+  };
+}
+
+/**
+ * Update a profile's passkey metadata (pure in-memory transform).
+ */
+export function updateProfilePasskey(
+  store: PasskeyProfileStore,
+  profileIndex: number,
+  passkey: PasskeyMetadata
+): PasskeyProfileStore {
+  const updatedProfiles = [...store.profiles];
+  const current = updatedProfiles[profileIndex];
+  if (!current) {
+    return store;
+  }
+
+  updatedProfiles[profileIndex] = {
+    ...current,
+    passkey,
+    lastUsedAt: passkey.lastUsedAt,
+  };
+
+  return {
+    ...store,
+    profiles: updatedProfiles,
+  };
+}
+
+/**
+ * Update lastUsedAt timestamp for a profile's passkey (pure in-memory transform).
+ */
+export function updatePasskeyLastUsed(
+  store: PasskeyProfileStore,
+  profileIndex: number
+): PasskeyProfileStore {
+  const updatedProfiles = [...store.profiles];
+  const current = updatedProfiles[profileIndex];
+  if (!current?.passkey) {
+    return store;
+  }
+
+  const now = new Date().toISOString();
+  updatedProfiles[profileIndex] = {
+    ...current,
+    passkey: {
+      ...current.passkey,
+      lastUsedAt: now,
+    },
+    lastUsedAt: now,
+  };
+
+  return {
+    ...store,
+    profiles: updatedProfiles,
+  };
+}
+
+/**
+ * Migrate profile data from an older schema version to current.
+ * Mutates profiles in-place for efficiency.
+ */
+function migrateProfiles(_profiles: PasskeyProfile[], _fromVersion: number): void {
+  // Currently at version 1, no migrations needed yet.
+  // Future migrations would go here:
+  // if (fromVersion < 2) { ... }
+}

package/src/schema.ts

@@ -0,0 +1,34 @@
+import type { AppMetadata } from '@thru/chain-interfaces';
+
+export const DB_NAME = 'thru-wallet';
+export const DB_VERSION = 1;
+
+export enum StoreName {
+  CONNECTED_APPS = 'connectedApps',
+  ACCOUNTS = 'accounts',
+  PASSKEY_PROFILES = 'passkeyProfiles',
+}
+
+export interface ConnectedAppData {
+  key: string; // `${accountId}:${appId}`
+  accountId: number;
+  appId: string;
+  origin: string;
+  metadata: AppMetadata;
+  connectedAt: number;
+  updatedAt: number;
+}
+
+/**
+ * Initialize database schema.
+ */
+export function initializeSchema(db: IDBDatabase): void {
+  const connectedApps = db.createObjectStore(StoreName.CONNECTED_APPS, { keyPath: 'key' });
+  connectedApps.createIndex('by-account', 'accountId', { unique: false });
+  connectedApps.createIndex('by-updated', 'updatedAt', { unique: false });
+
+  const accounts = db.createObjectStore(StoreName.ACCOUNTS, { keyPath: 'index' });
+  accounts.createIndex('by-created', 'createdAt', { unique: false });
+
+  db.createObjectStore(StoreName.PASSKEY_PROFILES, { keyPath: 'id' });
+}

package/src/types.ts

@@ -0,0 +1,47 @@
+import type { AddressType } from '@thru/chain-interfaces';
+
+/**
+ * Stored account representation in IndexedDB
+ */
+export interface StoredAccount {
+  index: number;              // BIP44 account index (0, 1, 2, ...)
+  label: string;              // User-defined name (e.g., "Trading", "NFTs")
+  publicKey: string;          // Encoded address string (currently base58 SOL; will migrate to Thru)
+  path: string;               // Full derivation path (m/44'/<coin>'/index'/0')
+  createdAt: Date;            // Timestamp of account creation
+  addressType?: AddressType;  // Chain identifier (e.g., 'thru')
+  publicKeyRawBase64?: string; // Optional raw 32-byte public key as base64 (for Thru migration)
+}
+
+/**
+ * A single passkey profile record stored in IndexedDB.
+ */
+export interface PasskeyProfileRecord {
+  id: string;
+  label: string;
+  passkey: PasskeyMetadataRecord | null;
+  createdAt: string;
+  lastUsedAt: string | null;
+}
+
+/**
+ * Passkey metadata stored alongside a profile.
+ */
+export interface PasskeyMetadataRecord {
+  credentialId: string;
+  publicKeyX: string;
+  publicKeyY: string;
+  rpId: string;
+  label?: string;
+  createdAt: string;
+  lastUsedAt: string;
+}
+
+/**
+ * Settings singleton stored in the passkeyProfiles store with id='settings'.
+ */
+export interface PasskeyStoreSettings {
+  id: 'settings';
+  selectedIndex: number;
+  version: number;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+});