@dynamic-labs/wallet-connect 4.93.0 → 4.93.1

package/CHANGELOG.md

@@ -1,4 +1,11 @@
 
+### [4.93.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.93.0...v4.93.1) (2026-07-22)
+
+
+### Bug Fixes
+
+* **wallet-connect:** recover WalletConnect IndexedDB store when object store is missing ([#12048](https://github.com/dynamic-labs/dynamic-auth/issues/12048)) ([#12052](https://github.com/dynamic-labs/dynamic-auth/issues/12052)) ([48286d2](https://github.com/dynamic-labs/dynamic-auth/commit/48286d2beecb11ebe53489a25b83fbf73c9dd5f1))
+
 ## [4.93.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.92.4...v4.93.0) (2026-07-20)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.93.0";
+var version = "4.93.1";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.93.0";
+var version = "4.93.1";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/wallet-connect",
-  "version": "4.93.0",
+  "version": "4.93.1",
   "description": "A React SDK for implementing wallet web3 authentication and authorization to your website.",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,9 +18,9 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/logger": "4.93.0",
+    "@dynamic-labs/logger": "4.93.1",
     "@walletconnect/sign-client": "2.21.5",
-    "@dynamic-labs/assert-package-version": "4.93.0"
+    "@dynamic-labs/assert-package-version": "4.93.1"
   },
   "peerDependencies": {}
 }

package/src/getSignClientSingleton/ensureWalletConnectStore.cjs

@@ -0,0 +1,101 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../_virtual/_tslib.cjs');
+
+// WalletConnect persists its pairing and session data in this IndexedDB
+// database and object store (see the browser build of
+// @walletconnect/keyvaluestorage). We reference them here so we can repair a
+// missing object store before SignClient opens the connection.
+const WALLET_CONNECT_DB_NAME = 'WALLET_CONNECT_V2_INDEXED_DB';
+const WALLET_CONNECT_STORE_NAME = 'keyvaluestorage';
+// WalletConnect's storage uses an out-of-line object store (idb-keyval's
+// createObjectStore with no keyPath). We must recreate it with the same shape
+// so WalletConnect keeps reading and writing it exactly as before.
+const createStoreIfMissing = (db) => {
+    if (!db.objectStoreNames.contains(WALLET_CONNECT_STORE_NAME)) {
+        db.createObjectStore(WALLET_CONNECT_STORE_NAME);
+    }
+};
+const openConnection = (version) => new Promise((resolve, reject) => {
+    const shouldUseCurrentVersion = version === undefined;
+    let request;
+    if (shouldUseCurrentVersion) {
+        request = indexedDB.open(WALLET_CONNECT_DB_NAME);
+    }
+    else {
+        request = indexedDB.open(WALLET_CONNECT_DB_NAME, version);
+    }
+    // A blocked upgrade rejects the promise, but the open request stays live: if
+    // the blocking connection later closes, onsuccess still fires with a real
+    // database. We track settlement so that a late success closes that database
+    // instead of leaking the connection for the life of the page. A late error
+    // or blocked event just rejects an already-settled promise, which is a no-op.
+    let hasSettled = false;
+    request.onupgradeneeded = () => createStoreIfMissing(request.result);
+    request.onsuccess = () => {
+        if (hasSettled) {
+            request.result.close();
+            return;
+        }
+        hasSettled = true;
+        resolve(request.result);
+    };
+    request.onerror = () => {
+        hasSettled = true;
+        reject(new Error('Failed to open WalletConnect IndexedDB'));
+    };
+    // A version-bump upgrade is blocked when another connection (another tab, or
+    // WalletConnect's own cached idb-keyval connection) still holds the database
+    // open. IndexedDB then fires neither success nor error, so we reject to keep
+    // the promise from hanging; the caller swallows it and lets SignClient.init
+    // proceed exactly as it would without this repair step.
+    request.onblocked = () => {
+        hasSettled = true;
+        reject(new Error('WalletConnect IndexedDB store upgrade was blocked by another open connection'));
+    };
+});
+const repairMissingStore = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    const db = yield openConnection();
+    const hasStore = db.objectStoreNames.contains(WALLET_CONNECT_STORE_NAME);
+    const currentVersion = db.version;
+    db.close();
+    if (hasStore) {
+        return;
+    }
+    // Reopening at the same version won't re-run onupgradeneeded, so the store
+    // would stay missing. Bumping the version triggers an upgrade that recreates
+    // only the missing store, leaving any other stored data intact.
+    const upgradedDb = yield openConnection(currentVersion + 1);
+    upgradedDb.close();
+});
+/**
+ * Ensures WalletConnect's IndexedDB object store exists before SignClient opens
+ * the connection. On iOS WebKit an upgrade interrupted by a webview reload can
+ * leave the `WALLET_CONNECT_V2_INDEXED_DB` database committed at its version
+ * with the object store never created; every subsequent WalletConnect read or
+ * write then throws NotFoundError ("one of the specified object stores was not
+ * found") until the store is recreated.
+ *
+ * The store is recreated with a version bump — the database is never deleted,
+ * so no session data is lost. This is a best-effort no-op for healthy databases
+ * and for environments without IndexedDB (SSR, React Native), so it cannot
+ * regress the default WalletConnect behaviour: on any failure SignClient.init
+ * proceeds exactly as it would without this step.
+ */
+const ensureWalletConnectStore = () => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    if (typeof indexedDB === 'undefined') {
+        return;
+    }
+    try {
+        yield repairMissingStore();
+    }
+    catch (_a) {
+        // Best-effort pre-flight repair. Swallowing lets SignClient.init proceed as
+        // it would without this step, so WalletConnect is never left worse off.
+    }
+});
+
+exports.ensureWalletConnectStore = ensureWalletConnectStore;

package/src/getSignClientSingleton/ensureWalletConnectStore.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ensures WalletConnect's IndexedDB object store exists before SignClient opens
+ * the connection. On iOS WebKit an upgrade interrupted by a webview reload can
+ * leave the `WALLET_CONNECT_V2_INDEXED_DB` database committed at its version
+ * with the object store never created; every subsequent WalletConnect read or
+ * write then throws NotFoundError ("one of the specified object stores was not
+ * found") until the store is recreated.
+ *
+ * The store is recreated with a version bump — the database is never deleted,
+ * so no session data is lost. This is a best-effort no-op for healthy databases
+ * and for environments without IndexedDB (SSR, React Native), so it cannot
+ * regress the default WalletConnect behaviour: on any failure SignClient.init
+ * proceeds exactly as it would without this step.
+ */
+export declare const ensureWalletConnectStore: () => Promise<void>;

package/src/getSignClientSingleton/ensureWalletConnectStore.js

@@ -0,0 +1,97 @@
+'use client'
+import { __awaiter } from '../../_virtual/_tslib.js';
+
+// WalletConnect persists its pairing and session data in this IndexedDB
+// database and object store (see the browser build of
+// @walletconnect/keyvaluestorage). We reference them here so we can repair a
+// missing object store before SignClient opens the connection.
+const WALLET_CONNECT_DB_NAME = 'WALLET_CONNECT_V2_INDEXED_DB';
+const WALLET_CONNECT_STORE_NAME = 'keyvaluestorage';
+// WalletConnect's storage uses an out-of-line object store (idb-keyval's
+// createObjectStore with no keyPath). We must recreate it with the same shape
+// so WalletConnect keeps reading and writing it exactly as before.
+const createStoreIfMissing = (db) => {
+    if (!db.objectStoreNames.contains(WALLET_CONNECT_STORE_NAME)) {
+        db.createObjectStore(WALLET_CONNECT_STORE_NAME);
+    }
+};
+const openConnection = (version) => new Promise((resolve, reject) => {
+    const shouldUseCurrentVersion = version === undefined;
+    let request;
+    if (shouldUseCurrentVersion) {
+        request = indexedDB.open(WALLET_CONNECT_DB_NAME);
+    }
+    else {
+        request = indexedDB.open(WALLET_CONNECT_DB_NAME, version);
+    }
+    // A blocked upgrade rejects the promise, but the open request stays live: if
+    // the blocking connection later closes, onsuccess still fires with a real
+    // database. We track settlement so that a late success closes that database
+    // instead of leaking the connection for the life of the page. A late error
+    // or blocked event just rejects an already-settled promise, which is a no-op.
+    let hasSettled = false;
+    request.onupgradeneeded = () => createStoreIfMissing(request.result);
+    request.onsuccess = () => {
+        if (hasSettled) {
+            request.result.close();
+            return;
+        }
+        hasSettled = true;
+        resolve(request.result);
+    };
+    request.onerror = () => {
+        hasSettled = true;
+        reject(new Error('Failed to open WalletConnect IndexedDB'));
+    };
+    // A version-bump upgrade is blocked when another connection (another tab, or
+    // WalletConnect's own cached idb-keyval connection) still holds the database
+    // open. IndexedDB then fires neither success nor error, so we reject to keep
+    // the promise from hanging; the caller swallows it and lets SignClient.init
+    // proceed exactly as it would without this repair step.
+    request.onblocked = () => {
+        hasSettled = true;
+        reject(new Error('WalletConnect IndexedDB store upgrade was blocked by another open connection'));
+    };
+});
+const repairMissingStore = () => __awaiter(void 0, void 0, void 0, function* () {
+    const db = yield openConnection();
+    const hasStore = db.objectStoreNames.contains(WALLET_CONNECT_STORE_NAME);
+    const currentVersion = db.version;
+    db.close();
+    if (hasStore) {
+        return;
+    }
+    // Reopening at the same version won't re-run onupgradeneeded, so the store
+    // would stay missing. Bumping the version triggers an upgrade that recreates
+    // only the missing store, leaving any other stored data intact.
+    const upgradedDb = yield openConnection(currentVersion + 1);
+    upgradedDb.close();
+});
+/**
+ * Ensures WalletConnect's IndexedDB object store exists before SignClient opens
+ * the connection. On iOS WebKit an upgrade interrupted by a webview reload can
+ * leave the `WALLET_CONNECT_V2_INDEXED_DB` database committed at its version
+ * with the object store never created; every subsequent WalletConnect read or
+ * write then throws NotFoundError ("one of the specified object stores was not
+ * found") until the store is recreated.
+ *
+ * The store is recreated with a version bump — the database is never deleted,
+ * so no session data is lost. This is a best-effort no-op for healthy databases
+ * and for environments without IndexedDB (SSR, React Native), so it cannot
+ * regress the default WalletConnect behaviour: on any failure SignClient.init
+ * proceeds exactly as it would without this step.
+ */
+const ensureWalletConnectStore = () => __awaiter(void 0, void 0, void 0, function* () {
+    if (typeof indexedDB === 'undefined') {
+        return;
+    }
+    try {
+        yield repairMissingStore();
+    }
+    catch (_a) {
+        // Best-effort pre-flight repair. Swallowing lets SignClient.init proceed as
+        // it would without this step, so WalletConnect is never left worse off.
+    }
+});
+
+export { ensureWalletConnectStore };

package/src/getSignClientSingleton/getSignClientSingleton.cjs

@@ -5,6 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../_virtual/_tslib.cjs');
 var SignClient = require('@walletconnect/sign-client');
+var ensureWalletConnectStore = require('./ensureWalletConnectStore.cjs');
 var reconcileOrphanedPairings = require('./reconcileOrphanedPairings.cjs');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -21,6 +22,10 @@ let signClientSingleton = undefined;
 const getSignClientSingleton = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ projectId, appIcon, appName, redirectUrl, }) {
     if (!signClientSingleton) {
         const redirect = redirectUrl ? { native: redirectUrl } : undefined;
+        // Repair WalletConnect's IndexedDB object store before SignClient opens it,
+        // so an interrupted upgrade (iOS WebKit reload) that left the store missing
+        // can't make every subsequent read/write throw NotFoundError.
+        yield ensureWalletConnectStore.ensureWalletConnectStore();
         signClientSingleton = yield SignClient__default["default"].init({
             customStoragePrefix: `dynamicauth_${projectId}_walletconnect`,
             metadata: {

package/src/getSignClientSingleton/getSignClientSingleton.js

@@ -1,6 +1,7 @@
 'use client'
 import { __awaiter } from '../../_virtual/_tslib.js';
 import SignClient from '@walletconnect/sign-client';
+import { ensureWalletConnectStore } from './ensureWalletConnectStore.js';
 import { reconcileOrphanedPairings } from './reconcileOrphanedPairings.js';
 
 /**
@@ -13,6 +14,10 @@ let signClientSingleton = undefined;
 const getSignClientSingleton = (_a) => __awaiter(void 0, [_a], void 0, function* ({ projectId, appIcon, appName, redirectUrl, }) {
     if (!signClientSingleton) {
         const redirect = redirectUrl ? { native: redirectUrl } : undefined;
+        // Repair WalletConnect's IndexedDB object store before SignClient opens it,
+        // so an interrupted upgrade (iOS WebKit reload) that left the store missing
+        // can't make every subsequent read/write throw NotFoundError.
+        yield ensureWalletConnectStore();
         signClientSingleton = yield SignClient.init({
             customStoragePrefix: `dynamicauth_${projectId}_walletconnect`,
             metadata: {