@dynamic-labs/wallet-book 5.0.0-rc.4 → 5.1.0

package/CHANGELOG.md

@@ -1,4 +1,98 @@
 
+## [5.1.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.0.0...v5.1.0) (2026-08-04)
+
+
+### Features
+
+* **midnight:** expose contract wallet provider ([#12120](https://github.com/dynamic-labs/dynamic-auth/issues/12120)) ([2cecf23](https://github.com/dynamic-labs/dynamic-auth/commit/2cecf23f1f51819b99dfde4afd20264ea1abebf8))
+* **webview-messages,webview-controller:** add waas_backupKeySharesToICloud webview message ([#12147](https://github.com/dynamic-labs/dynamic-auth/issues/12147)) ([ca4edda](https://github.com/dynamic-labs/dynamic-auth/commit/ca4edda54adf0673a9fe41c17d861a739f1b8f2e))
+* **webview:** add business accounts message contract and controller ([#12144](https://github.com/dynamic-labs/dynamic-auth/issues/12144)) ([d9f80c1](https://github.com/dynamic-labs/dynamic-auth/commit/d9f80c10bb3c332c2f3e3dc401b95025b930fa4e))
+
+
+### Bug Fixes
+
+* bump brace-expansion to latest patched maintenance releases ([#12130](https://github.com/dynamic-labs/dynamic-auth/issues/12130)) ([1b26671](https://github.com/dynamic-labs/dynamic-auth/commit/1b26671ad8e62025904e04f9dfed8b3faafb9c19))
+* **ethereum-aa:** resolve chainId from network for ZeroDev v2 multichain projects ([#12105](https://github.com/dynamic-labs/dynamic-auth/issues/12105)) ([fe2c5d2](https://github.com/dynamic-labs/dynamic-auth/commit/fe2c5d239758ea79e8647006d9d77cc27c2ab647))
+* **midnight:** name the missing RPCs when the wallet client is too old ([#12121](https://github.com/dynamic-labs/dynamic-auth/issues/12121)) ([3a8a77f](https://github.com/dynamic-labs/dynamic-auth/commit/3a8a77f89d368d8634497a5b49ff345b004cdffa))
+* **midnight:** return the submission identifier from the contract provider ([#12122](https://github.com/dynamic-labs/dynamic-auth/issues/12122)) ([8aa5289](https://github.com/dynamic-labs/dynamic-auth/commit/8aa52895fbdf09a3cf481049009a95f03cddda54))
+* remediate high-severity dependency vulnerabilities ([#12149](https://github.com/dynamic-labs/dynamic-auth/issues/12149)) ([14058ee](https://github.com/dynamic-labs/dynamic-auth/commit/14058eeed34351791ad7ab7ac1fa720eb2cf9948))
+* **starknet:** restore Braavos L2 session after lock and unlock ([#12124](https://github.com/dynamic-labs/dynamic-auth/issues/12124)) ([ab3b11b](https://github.com/dynamic-labs/dynamic-auth/commit/ab3b11bd71fbca8d32d4f2badfa49e3b9641eecf))
+* **wallet-book:** add App Store id for Robinhood Wallet iOS install link ([#11877](https://github.com/dynamic-labs/dynamic-auth/issues/11877)) ([ef28619](https://github.com/dynamic-labs/dynamic-auth/commit/ef28619ba4396e01046717ea7ad560870a56c78f))
+* **wallet-book:** add universal deep link for Exodus Solana WalletConnect ([#12123](https://github.com/dynamic-labs/dynamic-auth/issues/12123)) ([cd7223e](https://github.com/dynamic-labs/dynamic-auth/commit/cd7223eb2dc21314f351b96d9a06d795d282c35d))
+
+## [5.0.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.0.0-rc.4...v5.0.0) (2026-07-29)
+
+## 🚀 Dynamic SDK v5 is live
+
+This release has been a long time coming. We've cleaned up the architecture, cut support for v1 and v2 embedded wallets from core, shipped a migration path for legacy wallets, and made the SDK story a lot cleaner for both web and mobile devs.
+
+### 🔥 Embedded Wallet clean up
+
+V1/V2 embedded wallets support has been removed from `@dynamic-labs/sdk-react-core`. Dynamic WaaS (V3) is now the one and only embedded wallet type, all new embedded wallets are V3.
+
+### 📦 New: `@dynamic-labs/legacy-embedded-wallet-migration`
+
+For users still on V1/V2 embedded wallets, we've got you covered with a dedicated migration package. It owns all the logic for upgrading to V3. This includes recovery flow, session keys, private key export, and the migration UI.
+
+Two paths available:
+
+- **UI-based** (recommended): Mount `LegacyWalletMigrationProvider` and the upgrade modal opens automatically when a legacy wallet is detected at login. It handles the full flow end-to-end.
+- **Headless**: Call `upgradeToDynamicWaas()` directly if you want a custom migration UX.
+
+### 📱 JS SDK for web and React Native are the new default
+
+Going forward, we're encouraging all developers building for web and React Native to use the JS SDK. It's the direction we're investing in. Ideally v5 is our final version of the old React SDK. To be clear: **no new features will be added to the old SDKs, including v5. All new feature development is happening in the JS SDK.**
+
+### ✏️ Legacy package renames
+
+The old packages have been renamed to make their status explicit. Update your `package.json` accordingly:
+
+```
+@dynamic-labs/client                 → @dynamic-labs/legacy-client
+@dynamic-labs/react-hooks            → @dynamic-labs/legacy-react-hooks
+@dynamic-labs/react-native-extension → @dynamic-labs/legacy-react-native-extension
+@dynamic-labs/web-extension          → @dynamic-labs/legacy-web-extension
+@dynamic-labs/solana-extension       → @dynamic-labs/legacy-solana-extension
+@dynamic-labs/sui-extension          → @dynamic-labs/legacy-sui-extension
+@dynamic-labs/viem-extension         → @dynamic-labs/legacy-viem-extension
+@dynamic-labs/zerodev-extension      → @dynamic-labs/legacy-zerodev-extension
+```
+
+### :book: Full migration guide
+
+Everything you need to upgrade from v4 → v5: [Upgrade SDK from V4 to V5 - Dynamic](https://www.dynamic.xyz/docs/react/reference/upgrade/v5)
+
+Huge props to everyone who contributed to this.  :tada:
+
+------------------------------------------
+
+### ⚠ BREAKING CHANGES
+
+* **waas:** move the client key-share store onto the core storage API (#12096)
+* **react-native-extension:** store sensitive information with react-native-keychain (#12092)
+
+### Features
+
+* **bitcoin:** add sendBitcoinWithConfirmation to show confirm modal on BTC sends ([#12025](https://github.com/dynamic-labs/dynamic-auth/issues/12025)) ([5f992f5](https://github.com/dynamic-labs/dynamic-auth/commit/5f992f5fdaf805f07870ab9248ea2fe06a2fd3bf))
+* **waas:** delegate key shares with initial signer rules [DYNT-1675] ([#12028](https://github.com/dynamic-labs/dynamic-auth/issues/12028)) ([6b1ffc5](https://github.com/dynamic-labs/dynamic-auth/commit/6b1ffc5ee7070d639916a65b6a0aa6ada0167cb8)), closes [dynamic-labs/dynamic-waas-sdk#1500](https://github.com/dynamic-labs/dynamic-waas-sdk/issues/1500) [#10754](https://github.com/dynamic-labs/dynamic-auth/issues/10754) [#10772](https://github.com/dynamic-labs/dynamic-auth/issues/10772) [#646](https://github.com/dynamic-labs/dynamic-auth/issues/646) [#649](https://github.com/dynamic-labs/dynamic-auth/issues/649) [#1500](https://github.com/dynamic-labs/dynamic-auth/issues/1500) [dynamic-labs/dynamic-waas-sdk#1500](https://github.com/dynamic-labs/dynamic-waas-sdk/issues/1500)
+* **waas:** expose rawSign sha256/blake2b in SignMessageContext ([#12075](https://github.com/dynamic-labs/dynamic-auth/issues/12075)) ([20e3d2f](https://github.com/dynamic-labs/dynamic-auth/commit/20e3d2f40d18aa0bdb77e9b00fa4a5dc5dd6e9de))
+
+
+### Bug Fixes
+
+* **bitcoin:** resolve the public key of the active wallet, not the first ([#12091](https://github.com/dynamic-labs/dynamic-auth/issues/12091)) ([ebad70c](https://github.com/dynamic-labs/dynamic-auth/commit/ebad70c37ab9a771ad7051ca8f3c68d52c1d32fa)), closes [#11970](https://github.com/dynamic-labs/dynamic-auth/issues/11970) [#11970](https://github.com/dynamic-labs/dynamic-auth/issues/11970) [#11970](https://github.com/dynamic-labs/dynamic-auth/issues/11970)
+* fallback to local wallet balance when token balances API returns no tokens ([#12059](https://github.com/dynamic-labs/dynamic-auth/issues/12059)) ([26c9022](https://github.com/dynamic-labs/dynamic-auth/commit/26c9022da3371b0da0498ec641157aa9fed356aa))
+* security updates ([#12114](https://github.com/dynamic-labs/dynamic-auth/issues/12114)) ([a4f9bc1](https://github.com/dynamic-labs/dynamic-auth/commit/a4f9bc19870156903b76996c55ecd46a3417f004)) ([#12050](https://github.com/dynamic-labs/dynamic-auth/issues/12050)) ([8eeec92](https://github.com/dynamic-labs/dynamic-auth/commit/8eeec923d0f2f688ade60440e1f92bb1fd646201)) ([#12088](https://github.com/dynamic-labs/dynamic-auth/issues/12088)) ([f11f1f3](https://github.com/dynamic-labs/dynamic-auth/commit/f11f1f384201fa31f58753c0854eaf17f420fb09))
+* replace deprecated polygon-rpc.com RPC with polygon.drpc.org ([#12032](https://github.com/dynamic-labs/dynamic-auth/issues/12032)) ([e1ece53](https://github.com/dynamic-labs/dynamic-auth/commit/e1ece538aedf6127048ca64daf9f9f3cf3a7026e))
+* **sui:** stop using Sui Foundation fullnode URLs in WaaS and extension connectors ([#12108](https://github.com/dynamic-labs/dynamic-auth/issues/12108)) ([b23c85b](https://github.com/dynamic-labs/dynamic-auth/commit/b23c85b7c06f3147705a026ba23f5e8ae1f03b68))
+* **wallet-book:** use Backpack universal link for iOS in-app browser ([#12053](https://github.com/dynamic-labs/dynamic-auth/issues/12053)) ([afba6b1](https://github.com/dynamic-labs/dynamic-auth/commit/afba6b192e4be50aaeca9f5fad88b44808a034a0))
+* **wallet-connect:** recover WalletConnect IndexedDB store when object store is missing ([#12048](https://github.com/dynamic-labs/dynamic-auth/issues/12048)) ([96ff80e](https://github.com/dynamic-labs/dynamic-auth/commit/96ff80e40b28740de15b1702b85f954100fd5f25))
+
+
+* **react-native-extension:** store sensitive information with react-native-keychain ([#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092)) ([10c0f2f](https://github.com/dynamic-labs/dynamic-auth/commit/10c0f2f6c281e300e4a0455aaaa0d452808dcb87))
+* **waas:** move the client key-share store onto the core storage API ([#12096](https://github.com/dynamic-labs/dynamic-auth/issues/12096)) ([778f993](https://github.com/dynamic-labs/dynamic-auth/commit/778f993c5528ec03a7f1446dcb81a041a22db89b)), closes [#12094](https://github.com/dynamic-labs/dynamic-auth/issues/12094) [#12094](https://github.com/dynamic-labs/dynamic-auth/issues/12094) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12094](https://github.com/dynamic-labs/dynamic-auth/issues/12094)
+
+
 ## [5.0.0-rc.4](https://github.com/dynamic-labs/dynamic-auth/compare/v5.0.0-rc.3...v5.0.0-rc.4) (2026-07-20)
 
 

package/package.cjs

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

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "5.0.0-rc.4";
+var version = "5.1.0";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/wallet-book",
-  "version": "5.0.0-rc.4",
+  "version": "5.1.0",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
   "main": "./src/index.cjs",
@@ -17,10 +17,10 @@
   },
   "dependencies": {
     "zod": "4.0.5",
-    "@dynamic-labs/assert-package-version": "5.0.0-rc.4",
-    "@dynamic-labs/iconic": "5.0.0-rc.4",
-    "@dynamic-labs/logger": "5.0.0-rc.4",
-    "@dynamic-labs/utils": "5.0.0-rc.4",
+    "@dynamic-labs/assert-package-version": "5.1.0",
+    "@dynamic-labs/iconic": "5.1.0",
+    "@dynamic-labs/logger": "5.1.0",
+    "@dynamic-labs/utils": "5.1.0",
     "eventemitter3": "5.0.1",
     "util": "0.12.5"
   },

package/src/build/sources/index.d.ts

@@ -1,4 +1,5 @@
 export * from './firstParty';
+export * from './priorityWalletKeys';
 export * from './walletConnect';
 export * from './walletConnectOverrides';
 export * from './walletGroups';

package/src/build/sources/priorityWalletKeys/index.d.ts

@@ -0,0 +1,2 @@
+import priorityWalletKeys from './priority-keys.json';
+export { priorityWalletKeys };

package/src/build/sources/walletConnectOverrides/index.d.ts

@@ -72,6 +72,7 @@ export declare const walletConnectOverrides: {
                 androidId: string;
                 iosId: string;
                 native: string;
+                universal: string;
             };
         };
         walletConnect: {
@@ -92,6 +93,7 @@ export declare const walletConnectOverrides: {
                 androidId: string;
                 iosId: string;
                 native: string;
+                universal: string;
             };
         };
         walletConnect: {
@@ -204,6 +206,16 @@ export declare const walletConnectOverrides: {
             };
         };
     };
+    robinhoodwallet: {
+        mobile: {
+            action: string;
+            value: {
+                androidId: string;
+                iosId: string;
+                native: string;
+            };
+        };
+    };
     safepal: {
         eip6963Config: {
             action: string;

package/src/hooks/fetchWalletBook/fetchWalletBook.d.ts

@@ -91,6 +91,7 @@ export declare const walletBookCache: {
                 } | undefined;
             } | undefined;
         }>;
+        priority?: string[] | undefined;
     };
 };
 export declare const walletBookEmitter: EventEmitter<{

package/src/hooks/useWalletBookCdn.d.ts

@@ -88,4 +88,5 @@ export declare const useWalletBookCdn: () => {
             } | undefined;
         } | undefined;
     }>;
+    priority?: string[] | undefined;
 };

package/src/schemas/walletBookSchema.cjs

@@ -31,6 +31,7 @@ var z__namespace = /*#__PURE__*/_interopNamespace(z);
 z__namespace.record(z__namespace.string(), walletSchema.walletSchema);
 const walletBookSchema = z__namespace.pipe(z__namespace.transform((val) => val), z__namespace.object({
     groups: z__namespace.record(z__namespace.string(), walletGroup.walletGroupSchema),
+    priority: z__namespace.optional(z__namespace.array(z__namespace.string())),
     wallets: z__namespace.record(z__namespace.string(), walletSchema.walletSchema),
 }));
 z__namespace.record(z__namespace.string(), walletGroup.walletGroupSchema);

package/src/schemas/walletBookSchema.d.ts

@@ -272,6 +272,7 @@ export declare const walletBookSchema: z.ZodMiniPipe<z.ZodMiniTransform<unknown,
             name: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTransform<{} | undefined, unknown>, z.ZodMiniOptional<z.ZodMiniString<string>>>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
+    priority: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     wallets: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniTransform<unknown, unknown>, z.ZodMiniObject<{
         brand: z.ZodMiniOptional<z.ZodMiniObject<{
             alt: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTransform<{} | undefined, unknown>, z.ZodMiniOptional<z.ZodMiniString<string>>>>;

package/src/schemas/walletBookSchema.js

@@ -7,6 +7,7 @@ import { walletSchema } from './walletSchema.js';
 z.record(z.string(), walletSchema);
 const walletBookSchema = z.pipe(z.transform((val) => val), z.object({
     groups: z.record(z.string(), walletGroupSchema),
+    priority: z.optional(z.array(z.string())),
     wallets: z.record(z.string(), walletSchema),
 }));
 z.record(z.string(), walletGroupSchema);

package/wallet-book-fallbacks.cjs

@@ -216,6 +216,27 @@ var groups = {
 		name: "Zerion"
 	}
 };
+var priority = [
+	"metamask",
+	"coinbase",
+	"fireblocks",
+	"baseaccount",
+	"phantom",
+	"magiceden",
+	"trust",
+	"okxwallet",
+	"rainbow",
+	"argentx",
+	"backpack",
+	"xverse",
+	"onekey",
+	"solflare",
+	"braavos",
+	"brave",
+	"unisat",
+	"bitgetwallet",
+	"coin98"
+];
 var wallets = {
 	metamask: {
 		brand: {
@@ -1198,7 +1219,8 @@ var wallets = {
 		mobile: {
 			androidId: "exodusmovement.exodus",
 			iosId: "id1414384820",
-			native: "exodus://wc"
+			native: "exodus://wc",
+			universal: "https://exodus.com/m/wc"
 		},
 		name: "Exodus",
 		shortName: "Exodus Wallet (EVM)",
@@ -1243,7 +1265,8 @@ var wallets = {
 		mobile: {
 			androidId: "exodusmovement.exodus",
 			iosId: "id1414384820",
-			native: "exodus://wc"
+			native: "exodus://wc",
+			universal: "https://exodus.com/m/wc"
 		},
 		name: "Exodus",
 		shortName: "Exodus Wallet (Solana)",
@@ -1744,8 +1767,8 @@ var wallets = {
 		],
 		mobile: {
 			androidId: "app.backpack.mobile",
-			inAppBrowser: "backpack://ul/v1/browse/{{encodedDappURI}}",
-			inAppBrowserV2: "backpack://ul/v1/browse/{{encodedDappURI}}",
+			inAppBrowser: "https://backpack.app/ul/browse/?url={{encodedDappURI}}&ref={{encodedDappURI}}",
+			inAppBrowserV2: "https://backpack.app/ul/browse/?url={{encodedDappURI}}&ref={{encodedDappURI}}",
 			iosId: "id6445964121"
 		},
 		mobileExperience: "in-app-browser",
@@ -1862,9 +1885,11 @@ var wallets = {
 };
 var walletBookFallbacks = {
 	groups: groups,
+	priority: priority,
 	wallets: wallets
 };
 
 exports["default"] = walletBookFallbacks;
 exports.groups = groups;
+exports.priority = priority;
 exports.wallets = wallets;

package/wallet-book-fallbacks.js

@@ -212,6 +212,27 @@ var groups = {
 		name: "Zerion"
 	}
 };
+var priority = [
+	"metamask",
+	"coinbase",
+	"fireblocks",
+	"baseaccount",
+	"phantom",
+	"magiceden",
+	"trust",
+	"okxwallet",
+	"rainbow",
+	"argentx",
+	"backpack",
+	"xverse",
+	"onekey",
+	"solflare",
+	"braavos",
+	"brave",
+	"unisat",
+	"bitgetwallet",
+	"coin98"
+];
 var wallets = {
 	metamask: {
 		brand: {
@@ -1194,7 +1215,8 @@ var wallets = {
 		mobile: {
 			androidId: "exodusmovement.exodus",
 			iosId: "id1414384820",
-			native: "exodus://wc"
+			native: "exodus://wc",
+			universal: "https://exodus.com/m/wc"
 		},
 		name: "Exodus",
 		shortName: "Exodus Wallet (EVM)",
@@ -1239,7 +1261,8 @@ var wallets = {
 		mobile: {
 			androidId: "exodusmovement.exodus",
 			iosId: "id1414384820",
-			native: "exodus://wc"
+			native: "exodus://wc",
+			universal: "https://exodus.com/m/wc"
 		},
 		name: "Exodus",
 		shortName: "Exodus Wallet (Solana)",
@@ -1740,8 +1763,8 @@ var wallets = {
 		],
 		mobile: {
 			androidId: "app.backpack.mobile",
-			inAppBrowser: "backpack://ul/v1/browse/{{encodedDappURI}}",
-			inAppBrowserV2: "backpack://ul/v1/browse/{{encodedDappURI}}",
+			inAppBrowser: "https://backpack.app/ul/browse/?url={{encodedDappURI}}&ref={{encodedDappURI}}",
+			inAppBrowserV2: "https://backpack.app/ul/browse/?url={{encodedDappURI}}&ref={{encodedDappURI}}",
 			iosId: "id6445964121"
 		},
 		mobileExperience: "in-app-browser",
@@ -1858,7 +1881,8 @@ var wallets = {
 };
 var walletBookFallbacks = {
 	groups: groups,
+	priority: priority,
 	wallets: wallets
 };
 
-export { walletBookFallbacks as default, groups, wallets };
+export { walletBookFallbacks as default, groups, priority, wallets };