@thru/indexed-db-stamper 0.0.4

package/dist/index.d.ts

@@ -0,0 +1,182 @@
+import { EncryptedData } from '@thru/crypto';
+import { AddressType, AppMetadata, ConnectedApp } from '@thru/chain-interfaces';
+
+/**
+ * IndexedDB storage for wallet data
+ */
+declare class WalletStorage {
+    private static dbPromise;
+    /**
+     * Get or create database connection
+     */
+    private static getDB;
+    /**
+     * Save encrypted seed to storage
+     * @param encryptedSeed - Encrypted seed data
+     * @param walletId - Optional wallet ID (defaults to 'default')
+     */
+    static saveEncryptedSeed(encryptedSeed: EncryptedData, walletId?: string): Promise<void>;
+    /**
+     * Get encrypted seed from storage
+     * @param walletId - Wallet ID (defaults to 'default')
+     * @returns Encrypted seed data or null if not found
+     */
+    static getEncryptedSeed(walletId?: string): Promise<EncryptedData | null>;
+    /**
+     * Check if wallet exists
+     * @param walletId - Wallet ID (defaults to 'default')
+     */
+    static walletExists(walletId?: string): Promise<boolean>;
+    /**
+     * Delete wallet from storage
+     * @param walletId - Wallet ID (defaults to 'default')
+     */
+    static deleteWallet(walletId?: string): Promise<void>;
+    /**
+     * Clear all wallet data (use with caution!)
+     */
+    static clearAll(): Promise<void>;
+    /**
+     * Get storage quota information
+     */
+    static getStorageInfo(): Promise<{
+        usage: number;
+        quota: number;
+        available: number;
+    } | null>;
+    /**
+     * Request persistent storage (prevents data from being cleared)
+     */
+    static requestPersistentStorage(): Promise<boolean>;
+    /**
+     * Check if storage is persistent
+     */
+    static isPersistent(): Promise<boolean>;
+}
+
+/**
+ * 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 IndexedDB
+ * Stores metadata for each derived account (but NOT private keys)
+ */
+declare class AccountStorage {
+    private static dbPromise;
+    /**
+     * Initialize or get existing database connection
+     */
+    private static getDB;
+    /**
+     * Save a new account to storage
+     * @param account - Account metadata to save
+     */
+    static saveAccount(account: StoredAccount): Promise<void>;
+    /**
+     * Get all accounts, sorted by index (ascending)
+     * @returns Array of stored accounts
+     */
+    static getAccounts(): Promise<StoredAccount[]>;
+    /**
+     * Get a specific account by index
+     * @param index - Account index
+     * @returns Account or null if not found
+     */
+    static getAccount(index: number): Promise<StoredAccount | null>;
+    /**
+     * Update an account's label
+     * @param index - Account index
+     * @param label - New label
+     */
+    static updateAccountLabel(index: number, label: string): Promise<void>;
+    /**
+     * Get the next available account index
+     * @returns Next index (0 if no accounts exist)
+     */
+    static getNextAccountIndex(): Promise<number>;
+    /**
+     * Check if any accounts exist
+     * @returns true if at least one account exists
+     */
+    static hasAccounts(): Promise<boolean>;
+    /**
+     * Get total number of accounts
+     * @returns Account count
+     */
+    static getAccountCount(): Promise<number>;
+    /**
+     * Clear all accounts (use with caution!)
+     * Used primarily for testing or wallet reset
+     */
+    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 dbPromise;
+    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>;
+}
+
+/**
+ * IndexedDB schema for wallet storage
+ */
+declare const DB_NAME = "thru-wallet";
+declare const DB_VERSION = 2;
+/**
+ * Object store names
+ */
+declare enum StoreName {
+    WALLET = "wallet",
+    SETTINGS = "settings",
+    CONNECTED_APPS = "connectedApps"
+}
+/**
+ * Wallet data stored in IndexedDB
+ */
+interface WalletData {
+    id: string;
+    encryptedSeed: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Settings data
+ */
+interface SettingsData {
+    key: string;
+    value: any;
+}
+interface ConnectedAppData {
+    key: string;
+    accountId: number;
+    appId: string;
+    origin: string;
+    metadata: AppMetadata;
+    connectedAt: number;
+    updatedAt: number;
+}
+
+export { AccountStorage, type ConnectedAppData, ConnectedAppsStorage, DB_NAME, DB_VERSION, type SettingsData, StoreName, type StoredAccount, type WalletData, WalletStorage };

package/dist/index.js

@@ -0,0 +1,299 @@
+import { openDB } from 'idb';
+import { EncryptionService } from '@thru/crypto';
+
+// src/wallet-store.ts
+
+// src/schema.ts
+var DB_NAME = "thru-wallet";
+var DB_VERSION = 2;
+var StoreName = /* @__PURE__ */ ((StoreName2) => {
+  StoreName2["WALLET"] = "wallet";
+  StoreName2["SETTINGS"] = "settings";
+  StoreName2["CONNECTED_APPS"] = "connectedApps";
+  return StoreName2;
+})(StoreName || {});
+function initializeSchema(db) {
+  if (!db.objectStoreNames.contains("wallet" /* WALLET */)) {
+    const walletStore = db.createObjectStore("wallet" /* WALLET */, { keyPath: "id" });
+    walletStore.createIndex("createdAt", "createdAt", { unique: false });
+  }
+  if (!db.objectStoreNames.contains("settings" /* SETTINGS */)) {
+    db.createObjectStore("settings" /* SETTINGS */, { keyPath: "key" });
+  }
+  if (!db.objectStoreNames.contains("connectedApps" /* CONNECTED_APPS */)) {
+    const store = db.createObjectStore("connectedApps" /* CONNECTED_APPS */, { keyPath: "key" });
+    store.createIndex("by-account", "accountId", { unique: false });
+    store.createIndex("by-updated", "updatedAt", { unique: false });
+  }
+}
+var WalletStorage = class {
+  /**
+   * Get or create database connection
+   */
+  static async getDB() {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB(DB_NAME, DB_VERSION, {
+        upgrade(db) {
+          initializeSchema(db);
+        }
+      });
+    }
+    return this.dbPromise;
+  }
+  /**
+   * Save encrypted seed to storage
+   * @param encryptedSeed - Encrypted seed data
+   * @param walletId - Optional wallet ID (defaults to 'default')
+   */
+  static async saveEncryptedSeed(encryptedSeed, walletId = "default") {
+    const db = await this.getDB();
+    const serialized = EncryptionService.serialize(encryptedSeed);
+    const now = Date.now();
+    const walletData = {
+      id: walletId,
+      encryptedSeed: serialized,
+      createdAt: now,
+      updatedAt: now
+    };
+    await db.put("wallet" /* WALLET */, walletData);
+  }
+  /**
+   * Get encrypted seed from storage
+   * @param walletId - Wallet ID (defaults to 'default')
+   * @returns Encrypted seed data or null if not found
+   */
+  static async getEncryptedSeed(walletId = "default") {
+    const db = await this.getDB();
+    const walletData = await db.get("wallet" /* WALLET */, walletId);
+    if (!walletData) {
+      return null;
+    }
+    return EncryptionService.deserialize(walletData.encryptedSeed);
+  }
+  /**
+   * Check if wallet exists
+   * @param walletId - Wallet ID (defaults to 'default')
+   */
+  static async walletExists(walletId = "default") {
+    const db = await this.getDB();
+    const walletData = await db.get("wallet" /* WALLET */, walletId);
+    return walletData !== void 0;
+  }
+  /**
+   * Delete wallet from storage
+   * @param walletId - Wallet ID (defaults to 'default')
+   */
+  static async deleteWallet(walletId = "default") {
+    const db = await this.getDB();
+    await db.delete("wallet" /* WALLET */, walletId);
+  }
+  /**
+   * Clear all wallet data (use with caution!)
+   */
+  static async clearAll() {
+    const db = await this.getDB();
+    await db.clear("wallet" /* WALLET */);
+    await db.clear("settings" /* SETTINGS */);
+  }
+  /**
+   * Get storage quota information
+   */
+  static async getStorageInfo() {
+    if (!navigator.storage || !navigator.storage.estimate) {
+      return null;
+    }
+    const estimate = await navigator.storage.estimate();
+    const usage = estimate.usage || 0;
+    const quota = estimate.quota || 0;
+    return {
+      usage,
+      quota,
+      available: quota - usage
+    };
+  }
+  /**
+   * Request persistent storage (prevents data from being cleared)
+   */
+  static async requestPersistentStorage() {
+    if (!navigator.storage || !navigator.storage.persist) {
+      return false;
+    }
+    return await navigator.storage.persist();
+  }
+  /**
+   * Check if storage is persistent
+   */
+  static async isPersistent() {
+    if (!navigator.storage || !navigator.storage.persisted) {
+      return false;
+    }
+    return await navigator.storage.persisted();
+  }
+};
+WalletStorage.dbPromise = null;
+var DB_NAME2 = "thru-wallet-accounts";
+var DB_VERSION2 = 1;
+var STORE_NAME = "accounts";
+var AccountStorage = class {
+  /**
+   * Initialize or get existing database connection
+   */
+  static async getDB() {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB(DB_NAME2, DB_VERSION2, {
+        upgrade(db) {
+          const store = db.createObjectStore(STORE_NAME, {
+            keyPath: "index"
+          });
+          store.createIndex("by-created", "createdAt");
+        }
+      });
+    }
+    return this.dbPromise;
+  }
+  /**
+   * Save a new account to storage
+   * @param account - Account metadata to save
+   */
+  static async saveAccount(account) {
+    const db = await this.getDB();
+    await db.put(STORE_NAME, account);
+  }
+  /**
+   * Get all accounts, sorted by index (ascending)
+   * @returns Array of stored accounts
+   */
+  static async getAccounts() {
+    const db = await this.getDB();
+    const accounts = await db.getAll(STORE_NAME);
+    return accounts.sort((a, b) => a.index - b.index);
+  }
+  /**
+   * Get a specific account by index
+   * @param index - Account index
+   * @returns Account or null if not found
+   */
+  static async getAccount(index) {
+    const db = await this.getDB();
+    const account = await db.get(STORE_NAME, index);
+    return account || null;
+  }
+  /**
+   * Update an account's label
+   * @param index - Account index
+   * @param label - New label
+   */
+  static async updateAccountLabel(index, label) {
+    const db = await this.getDB();
+    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
+   * @returns Next index (0 if no accounts exist)
+   */
+  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
+   * @returns true if at least one account exists
+   */
+  static async hasAccounts() {
+    const db = await this.getDB();
+    const count = await db.count(STORE_NAME);
+    return count > 0;
+  }
+  /**
+   * Get total number of accounts
+   * @returns Account count
+   */
+  static async getAccountCount() {
+    const db = await this.getDB();
+    return await db.count(STORE_NAME);
+  }
+  /**
+   * Clear all accounts (use with caution!)
+   * Used primarily for testing or wallet reset
+   */
+  static async clearAccounts() {
+    const db = await this.getDB();
+    await db.clear(STORE_NAME);
+  }
+};
+AccountStorage.dbPromise = null;
+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() {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB(DB_NAME, DB_VERSION, {
+        upgrade(db) {
+          initializeSchema(db);
+        }
+      });
+    }
+    return this.dbPromise;
+  }
+  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;
+  }
+};
+ConnectedAppsStorage.dbPromise = null;
+
+export { AccountStorage, ConnectedAppsStorage, DB_NAME, DB_VERSION, StoreName, WalletStorage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/wallet-store.ts","../src/account-store.ts","../src/connected-apps-store.ts"],"names":["StoreName","DB_NAME","DB_VERSION","openDB","STORE_NAME"],"mappings":"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","file":"index.js","sourcesContent":["import type { AppMetadata } from '@thru/chain-interfaces';\n\n/**\n * IndexedDB schema for wallet storage\n */\n\nexport const DB_NAME = 'thru-wallet';\nexport const DB_VERSION = 2;\n\n/**\n * Object store names\n */\nexport enum StoreName {\n  WALLET = 'wallet',\n  SETTINGS = 'settings',\n  CONNECTED_APPS = 'connectedApps',\n}\n\n/**\n * Wallet data stored in IndexedDB\n */\nexport interface WalletData {\n  id: string;\n  encryptedSeed: string; // Serialized EncryptedData\n  createdAt: number; // Timestamp\n  updatedAt: number; // Timestamp\n}\n\n/**\n * Settings data\n */\nexport interface SettingsData {\n  key: string;\n  value: any;\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  // Wallet store\n  if (!db.objectStoreNames.contains(StoreName.WALLET)) {\n    const walletStore = db.createObjectStore(StoreName.WALLET, { keyPath: 'id' });\n    walletStore.createIndex('createdAt', 'createdAt', { unique: false });\n  }\n\n  // Settings store\n  if (!db.objectStoreNames.contains(StoreName.SETTINGS)) {\n    db.createObjectStore(StoreName.SETTINGS, { keyPath: 'key' });\n  }\n\n  // Connected apps store\n  if (!db.objectStoreNames.contains(StoreName.CONNECTED_APPS)) {\n    const store = db.createObjectStore(StoreName.CONNECTED_APPS, { keyPath: 'key' });\n    store.createIndex('by-account', 'accountId', { unique: false });\n    store.createIndex('by-updated', 'updatedAt', { unique: false });\n  }\n}\n","import { openDB, IDBPDatabase } from 'idb';\nimport { DB_NAME, DB_VERSION, StoreName, WalletData, initializeSchema } from './schema';\nimport { EncryptedData, EncryptionService } from '@thru/crypto';\n\n/**\n * IndexedDB storage for wallet data\n */\nexport class WalletStorage {\n  private static dbPromise: Promise<IDBPDatabase> | null = null;\n\n  /**\n   * Get or create database connection\n   */\n  private static async getDB(): Promise<IDBPDatabase> {\n    if (!this.dbPromise) {\n      this.dbPromise = openDB(DB_NAME, DB_VERSION, {\n        upgrade(db) {\n          initializeSchema(db as any);\n        },\n      });\n    }\n    return this.dbPromise;\n  }\n\n  /**\n   * Save encrypted seed to storage\n   * @param encryptedSeed - Encrypted seed data\n   * @param walletId - Optional wallet ID (defaults to 'default')\n   */\n  static async saveEncryptedSeed(\n    encryptedSeed: EncryptedData,\n    walletId: string = 'default'\n  ): Promise<void> {\n    const db = await this.getDB();\n\n    // Serialize encrypted data\n    const serialized = EncryptionService.serialize(encryptedSeed);\n\n    const now = Date.now();\n    const walletData: WalletData = {\n      id: walletId,\n      encryptedSeed: serialized,\n      createdAt: now,\n      updatedAt: now,\n    };\n\n    await db.put(StoreName.WALLET, walletData);\n  }\n\n  /**\n   * Get encrypted seed from storage\n   * @param walletId - Wallet ID (defaults to 'default')\n   * @returns Encrypted seed data or null if not found\n   */\n  static async getEncryptedSeed(walletId: string = 'default'): Promise<EncryptedData | null> {\n    const db = await this.getDB();\n    const walletData = await db.get(StoreName.WALLET, walletId);\n\n    if (!walletData) {\n      return null;\n    }\n\n    // Deserialize encrypted data\n    return EncryptionService.deserialize(walletData.encryptedSeed);\n  }\n\n  /**\n   * Check if wallet exists\n   * @param walletId - Wallet ID (defaults to 'default')\n   */\n  static async walletExists(walletId: string = 'default'): Promise<boolean> {\n    const db = await this.getDB();\n    const walletData = await db.get(StoreName.WALLET, walletId);\n    return walletData !== undefined;\n  }\n\n  /**\n   * Delete wallet from storage\n   * @param walletId - Wallet ID (defaults to 'default')\n   */\n  static async deleteWallet(walletId: string = 'default'): Promise<void> {\n    const db = await this.getDB();\n    await db.delete(StoreName.WALLET, walletId);\n  }\n\n  /**\n   * Clear all wallet data (use with caution!)\n   */\n  static async clearAll(): Promise<void> {\n    const db = await this.getDB();\n    await db.clear(StoreName.WALLET);\n    await db.clear(StoreName.SETTINGS);\n  }\n\n  /**\n   * Get storage quota information\n   */\n  static async getStorageInfo(): Promise<{\n    usage: number;\n    quota: number;\n    available: number;\n  } | null> {\n    if (!navigator.storage || !navigator.storage.estimate) {\n      return null;\n    }\n\n    const estimate = await navigator.storage.estimate();\n    const usage = estimate.usage || 0;\n    const quota = estimate.quota || 0;\n\n    return {\n      usage,\n      quota,\n      available: quota - usage,\n    };\n  }\n\n  /**\n   * Request persistent storage (prevents data from being cleared)\n   */\n  static async requestPersistentStorage(): Promise<boolean> {\n    if (!navigator.storage || !navigator.storage.persist) {\n      return false;\n    }\n\n    return await navigator.storage.persist();\n  }\n\n  /**\n   * Check if storage is persistent\n   */\n  static async isPersistent(): Promise<boolean> {\n    if (!navigator.storage || !navigator.storage.persisted) {\n      return false;\n    }\n\n    return await navigator.storage.persisted();\n  }\n}\n","import { openDB, DBSchema, IDBPDatabase } from 'idb';\nimport { StoredAccount } from './types';\n\n/**\n * IndexedDB schema for account storage\n */\ninterface AccountDB extends DBSchema {\n  accounts: {\n    key: number; // account index\n    value: StoredAccount;\n    indexes: {\n      'by-created': Date;\n    };\n  };\n}\n\nconst DB_NAME = 'thru-wallet-accounts';\nconst DB_VERSION = 1;\nconst STORE_NAME = 'accounts';\n\n/**\n * Account storage management using IndexedDB\n * Stores metadata for each derived account (but NOT private keys)\n */\nexport class AccountStorage {\n  private static dbPromise: Promise<IDBPDatabase<AccountDB>> | null = null;\n\n  /**\n   * Initialize or get existing database connection\n   */\n  private static async getDB(): Promise<IDBPDatabase<AccountDB>> {\n    if (!this.dbPromise) {\n      this.dbPromise = openDB<AccountDB>(DB_NAME, DB_VERSION, {\n        upgrade(db) {\n          // Create accounts object store\n          const store = db.createObjectStore(STORE_NAME, {\n            keyPath: 'index',\n          });\n\n          // Create index for sorting by creation date\n          store.createIndex('by-created', 'createdAt');\n        },\n      });\n    }\n    return this.dbPromise;\n  }\n\n  /**\n   * Save a new account to storage\n   * @param account - Account metadata to save\n   */\n  static async saveAccount(account: StoredAccount): Promise<void> {\n    const db = await this.getDB();\n    await db.put(STORE_NAME, account);\n  }\n\n  /**\n   * Get all accounts, sorted by index (ascending)\n   * @returns Array of stored accounts\n   */\n  static async getAccounts(): Promise<StoredAccount[]> {\n    const db = await this.getDB();\n    const accounts = await db.getAll(STORE_NAME);\n\n    // Sort by index (0, 1, 2, ...)\n    return accounts.sort((a, b) => a.index - b.index);\n  }\n\n  /**\n   * Get a specific account by index\n   * @param index - Account index\n   * @returns Account or null if not found\n   */\n  static async getAccount(index: number): Promise<StoredAccount | null> {\n    const db = await this.getDB();\n    const account = await db.get(STORE_NAME, index);\n    return account || null;\n  }\n\n  /**\n   * Update an account's label\n   * @param index - Account index\n   * @param label - New label\n   */\n  static async updateAccountLabel(index: number, label: string): Promise<void> {\n    const db = await this.getDB();\n    const account = await db.get(STORE_NAME, index);\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   * @returns Next index (0 if no accounts exist)\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    // Return highest index + 1\n    const maxIndex = Math.max(...accounts.map(a => a.index));\n    return maxIndex + 1;\n  }\n\n  /**\n   * Check if any accounts exist\n   * @returns true if at least one account exists\n   */\n  static async hasAccounts(): Promise<boolean> {\n    const db = await this.getDB();\n    const count = await db.count(STORE_NAME);\n    return count > 0;\n  }\n\n  /**\n   * Get total number of accounts\n   * @returns Account count\n   */\n  static async getAccountCount(): Promise<number> {\n    const db = await this.getDB();\n    return await db.count(STORE_NAME);\n  }\n\n  /**\n   * Clear all accounts (use with caution!)\n   * Used primarily for testing or wallet reset\n   */\n  static async clearAccounts(): Promise<void> {\n    const db = await this.getDB();\n    await db.clear(STORE_NAME);\n  }\n}\n","import { openDB, IDBPDatabase } from 'idb';\nimport {\n  DB_NAME,\n  DB_VERSION,\n  StoreName,\n  initializeSchema,\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 dbPromise: Promise<IDBPDatabase> | null = null;\n\n  private static async getDB(): Promise<IDBPDatabase> {\n    if (!this.dbPromise) {\n      this.dbPromise = openDB(DB_NAME, DB_VERSION, {\n        upgrade(db) {\n          initializeSchema(db as any);\n        },\n      });\n    }\n    return this.dbPromise;\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"]}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@thru/indexed-db-stamper",
+  "version": "0.0.4",
+  "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.0.4",
+    "@thru/crypto": "0.0.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist"
+  }
+}

package/src/account-store.ts

@@ -0,0 +1,140 @@
+import { openDB, DBSchema, IDBPDatabase } from 'idb';
+import { StoredAccount } from './types';
+
+/**
+ * IndexedDB schema for account storage
+ */
+interface AccountDB extends DBSchema {
+  accounts: {
+    key: number; // account index
+    value: StoredAccount;
+    indexes: {
+      'by-created': Date;
+    };
+  };
+}
+
+const DB_NAME = 'thru-wallet-accounts';
+const DB_VERSION = 1;
+const STORE_NAME = 'accounts';
+
+/**
+ * Account storage management using IndexedDB
+ * Stores metadata for each derived account (but NOT private keys)
+ */
+export class AccountStorage {
+  private static dbPromise: Promise<IDBPDatabase<AccountDB>> | null = null;
+
+  /**
+   * Initialize or get existing database connection
+   */
+  private static async getDB(): Promise<IDBPDatabase<AccountDB>> {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB<AccountDB>(DB_NAME, DB_VERSION, {
+        upgrade(db) {
+          // Create accounts object store
+          const store = db.createObjectStore(STORE_NAME, {
+            keyPath: 'index',
+          });
+
+          // Create index for sorting by creation date
+          store.createIndex('by-created', 'createdAt');
+        },
+      });
+    }
+    return this.dbPromise;
+  }
+
+  /**
+   * Save a new account to storage
+   * @param account - Account metadata to save
+   */
+  static async saveAccount(account: StoredAccount): Promise<void> {
+    const db = await this.getDB();
+    await db.put(STORE_NAME, account);
+  }
+
+  /**
+   * Get all accounts, sorted by index (ascending)
+   * @returns Array of stored accounts
+   */
+  static async getAccounts(): Promise<StoredAccount[]> {
+    const db = await this.getDB();
+    const accounts = await db.getAll(STORE_NAME);
+
+    // Sort by index (0, 1, 2, ...)
+    return accounts.sort((a, b) => a.index - b.index);
+  }
+
+  /**
+   * Get a specific account by index
+   * @param index - Account index
+   * @returns Account or null if not found
+   */
+  static async getAccount(index: number): Promise<StoredAccount | null> {
+    const db = await this.getDB();
+    const account = await db.get(STORE_NAME, index);
+    return account || null;
+  }
+
+  /**
+   * Update an account's label
+   * @param index - Account index
+   * @param label - New label
+   */
+  static async updateAccountLabel(index: number, label: string): Promise<void> {
+    const db = await this.getDB();
+    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
+   * @returns Next index (0 if no accounts exist)
+   */
+  static async getNextAccountIndex(): Promise<number> {
+    const accounts = await this.getAccounts();
+
+    if (accounts.length === 0) {
+      return 0;
+    }
+
+    // Return highest index + 1
+    const maxIndex = Math.max(...accounts.map(a => a.index));
+    return maxIndex + 1;
+  }
+
+  /**
+   * Check if any accounts exist
+   * @returns true if at least one account exists
+   */
+  static async hasAccounts(): Promise<boolean> {
+    const db = await this.getDB();
+    const count = await db.count(STORE_NAME);
+    return count > 0;
+  }
+
+  /**
+   * Get total number of accounts
+   * @returns Account count
+   */
+  static async getAccountCount(): Promise<number> {
+    const db = await this.getDB();
+    return await db.count(STORE_NAME);
+  }
+
+  /**
+   * Clear all accounts (use with caution!)
+   * Used primarily for testing or wallet reset
+   */
+  static async clearAccounts(): Promise<void> {
+    const db = await this.getDB();
+    await db.clear(STORE_NAME);
+  }
+}

package/src/connected-apps-store.ts

@@ -0,0 +1,95 @@
+import { openDB, IDBPDatabase } from 'idb';
+import {
+  DB_NAME,
+  DB_VERSION,
+  StoreName,
+  initializeSchema,
+  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 dbPromise: Promise<IDBPDatabase> | null = null;
+
+  private static async getDB(): Promise<IDBPDatabase> {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB(DB_NAME, DB_VERSION, {
+        upgrade(db) {
+          initializeSchema(db as any);
+        },
+      });
+    }
+    return this.dbPromise;
+  }
+
+  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/index.ts

@@ -0,0 +1,12 @@
+export { WalletStorage } from './wallet-store';
+export { AccountStorage } from './account-store';
+export { ConnectedAppsStorage } from './connected-apps-store';
+export {
+  type WalletData,
+  type SettingsData,
+  type ConnectedAppData,
+  StoreName,
+  DB_NAME,
+  DB_VERSION,
+} from './schema';
+export { type StoredAccount } from './types';

package/src/schema.ts

@@ -0,0 +1,68 @@
+import type { AppMetadata } from '@thru/chain-interfaces';
+
+/**
+ * IndexedDB schema for wallet storage
+ */
+
+export const DB_NAME = 'thru-wallet';
+export const DB_VERSION = 2;
+
+/**
+ * Object store names
+ */
+export enum StoreName {
+  WALLET = 'wallet',
+  SETTINGS = 'settings',
+  CONNECTED_APPS = 'connectedApps',
+}
+
+/**
+ * Wallet data stored in IndexedDB
+ */
+export interface WalletData {
+  id: string;
+  encryptedSeed: string; // Serialized EncryptedData
+  createdAt: number; // Timestamp
+  updatedAt: number; // Timestamp
+}
+
+/**
+ * Settings data
+ */
+export interface SettingsData {
+  key: string;
+  value: any;
+}
+
+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 {
+  // Wallet store
+  if (!db.objectStoreNames.contains(StoreName.WALLET)) {
+    const walletStore = db.createObjectStore(StoreName.WALLET, { keyPath: 'id' });
+    walletStore.createIndex('createdAt', 'createdAt', { unique: false });
+  }
+
+  // Settings store
+  if (!db.objectStoreNames.contains(StoreName.SETTINGS)) {
+    db.createObjectStore(StoreName.SETTINGS, { keyPath: 'key' });
+  }
+
+  // Connected apps store
+  if (!db.objectStoreNames.contains(StoreName.CONNECTED_APPS)) {
+    const store = db.createObjectStore(StoreName.CONNECTED_APPS, { keyPath: 'key' });
+    store.createIndex('by-account', 'accountId', { unique: false });
+    store.createIndex('by-updated', 'updatedAt', { unique: false });
+  }
+}

package/src/types.ts

@@ -0,0 +1,14 @@
+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)
+}

package/src/wallet-store.ts

@@ -0,0 +1,139 @@
+import { openDB, IDBPDatabase } from 'idb';
+import { DB_NAME, DB_VERSION, StoreName, WalletData, initializeSchema } from './schema';
+import { EncryptedData, EncryptionService } from '@thru/crypto';
+
+/**
+ * IndexedDB storage for wallet data
+ */
+export class WalletStorage {
+  private static dbPromise: Promise<IDBPDatabase> | null = null;
+
+  /**
+   * Get or create database connection
+   */
+  private static async getDB(): Promise<IDBPDatabase> {
+    if (!this.dbPromise) {
+      this.dbPromise = openDB(DB_NAME, DB_VERSION, {
+        upgrade(db) {
+          initializeSchema(db as any);
+        },
+      });
+    }
+    return this.dbPromise;
+  }
+
+  /**
+   * Save encrypted seed to storage
+   * @param encryptedSeed - Encrypted seed data
+   * @param walletId - Optional wallet ID (defaults to 'default')
+   */
+  static async saveEncryptedSeed(
+    encryptedSeed: EncryptedData,
+    walletId: string = 'default'
+  ): Promise<void> {
+    const db = await this.getDB();
+
+    // Serialize encrypted data
+    const serialized = EncryptionService.serialize(encryptedSeed);
+
+    const now = Date.now();
+    const walletData: WalletData = {
+      id: walletId,
+      encryptedSeed: serialized,
+      createdAt: now,
+      updatedAt: now,
+    };
+
+    await db.put(StoreName.WALLET, walletData);
+  }
+
+  /**
+   * Get encrypted seed from storage
+   * @param walletId - Wallet ID (defaults to 'default')
+   * @returns Encrypted seed data or null if not found
+   */
+  static async getEncryptedSeed(walletId: string = 'default'): Promise<EncryptedData | null> {
+    const db = await this.getDB();
+    const walletData = await db.get(StoreName.WALLET, walletId);
+
+    if (!walletData) {
+      return null;
+    }
+
+    // Deserialize encrypted data
+    return EncryptionService.deserialize(walletData.encryptedSeed);
+  }
+
+  /**
+   * Check if wallet exists
+   * @param walletId - Wallet ID (defaults to 'default')
+   */
+  static async walletExists(walletId: string = 'default'): Promise<boolean> {
+    const db = await this.getDB();
+    const walletData = await db.get(StoreName.WALLET, walletId);
+    return walletData !== undefined;
+  }
+
+  /**
+   * Delete wallet from storage
+   * @param walletId - Wallet ID (defaults to 'default')
+   */
+  static async deleteWallet(walletId: string = 'default'): Promise<void> {
+    const db = await this.getDB();
+    await db.delete(StoreName.WALLET, walletId);
+  }
+
+  /**
+   * Clear all wallet data (use with caution!)
+   */
+  static async clearAll(): Promise<void> {
+    const db = await this.getDB();
+    await db.clear(StoreName.WALLET);
+    await db.clear(StoreName.SETTINGS);
+  }
+
+  /**
+   * Get storage quota information
+   */
+  static async getStorageInfo(): Promise<{
+    usage: number;
+    quota: number;
+    available: number;
+  } | null> {
+    if (!navigator.storage || !navigator.storage.estimate) {
+      return null;
+    }
+
+    const estimate = await navigator.storage.estimate();
+    const usage = estimate.usage || 0;
+    const quota = estimate.quota || 0;
+
+    return {
+      usage,
+      quota,
+      available: quota - usage,
+    };
+  }
+
+  /**
+   * Request persistent storage (prevents data from being cleared)
+   */
+  static async requestPersistentStorage(): Promise<boolean> {
+    if (!navigator.storage || !navigator.storage.persist) {
+      return false;
+    }
+
+    return await navigator.storage.persist();
+  }
+
+  /**
+   * Check if storage is persistent
+   */
+  static async isPersistent(): Promise<boolean> {
+    if (!navigator.storage || !navigator.storage.persisted) {
+      return false;
+    }
+
+    return await navigator.storage.persisted();
+  }
+}

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,
+});