@dynamic-labs/multi-wallet 4.33.0 → 4.35.0

package/CHANGELOG.md

@@ -1,4 +1,23 @@
 
+## [4.35.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.34.0...v4.35.0) (2025-10-02)
+
+
+### Features
+
+* update Bitget wallet logo with new SVG design ([#9615](https://github.com/dynamic-labs/dynamic-auth/issues/9615)) ([3b84f92](https://github.com/dynamic-labs/dynamic-auth/commit/3b84f9237d9a85ca334576aa9e986c73c7fa5973))
+
+
+### Bug Fixes
+
+* connecting global wallets via wallet connect ([#9608](https://github.com/dynamic-labs/dynamic-auth/issues/9608)) ([7b7767d](https://github.com/dynamic-labs/dynamic-auth/commit/7b7767dc322756edfe51f935155b0af2ebc52b6e))
+
+## [4.34.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.33.0...v4.34.0) (2025-09-30)
+
+
+### Features
+
+* add getMultichainBalances to react-native ([#9593](https://github.com/dynamic-labs/dynamic-auth/issues/9593)) ([2e482c3](https://github.com/dynamic-labs/dynamic-auth/commit/2e482c3a3d17e4570173c3ca6e27d83c9fac7265))
+
 ## [4.33.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.32.1...v4.33.0) (2025-09-26)
 
 

package/README.md

@@ -1,7 +1,94 @@
-# multi-wallet
+# @dynamic-labs/multi-wallet
 
-This library was generated with [Nx](https://nx.dev).
+## Overview
 
-## Running unit tests
+The multi-wallet package provides utility functions for filtering and configuring wallet connectors in the Dynamic Labs SDK. It contains helper functions used by the main SDK to determine which wallets should be available based on project settings and enabled chains.
 
-Run `nx test multi-wallet` to execute the unit tests via [Jest](https://jestjs.io).
+## Key Features
+
+- **Wallet filtering**: Filters wallet connectors based on enabled chains and project settings
+- **Configuration building**: Creates configuration objects needed to instantiate wallet connectors
+- **Message generation**: Generates standardized messages for wallet signature operations
+- **Provider filtering**: Determines which authentication providers are enabled
+
+## Core Functions
+
+### `getSupportedWallets(opts)`
+
+Main function that returns a filtered list of available wallet connectors based on:
+
+- Project settings and enabled providers
+- Platform compatibility (mobile/desktop)
+- Wallet availability and installation status
+- User preferences and disabled connectors
+
+### `getWalletConnectorConstructorOptions(params)`
+
+Builds configuration options for wallet connector constructors, including:
+
+- Network configurations for all supported chains
+- API providers and RPC configurations
+- Authentication modes and UI utilities
+- WalletConnect project settings
+
+### `getEnabledWallets(props)`
+
+Filters wallet connectors based on enabled chains. Takes an object with:
+
+- `enabledChains`: Array of Chain types that are enabled
+- `getSupportedWalletOpts`: Configuration options for getting supported wallets
+
+### `generateMessageToSign(params)`
+
+Creates standardized messages for wallet signing operations. Takes a `MessageParameters` object with fields like:
+
+- `blockchain`: The blockchain type (Chain)
+- `domain`: The domain requesting the signature
+- `nonce`: Unique nonce for the request
+- `publicKey`: User's public key
+- `uri`: URI of the requesting application
+- Additional optional fields for chainId, statement, resources, etc.
+
+### `getEnabledProviders(providers)`
+
+Filters providers to return only those that are enabled (have `enabledAt` set, or are MagicLink with `providerProjectId`, or are Turnkey).
+
+### `getSupportedChainsForWalletConnector(walletBook, walletConnector)`
+
+Returns the supported chains for a specific wallet connector by combining information from the wallet book and the connector's native supported chains.
+
+## Usage
+
+```typescript
+import { getSupportedWallets } from '@dynamic-labs/multi-wallet';
+
+const wallets = getSupportedWallets({
+  settings: projectSettings,
+  walletConnectorsProp: walletConnectors,
+  walletBook: walletBookData,
+  chainRpcProviders: rpcProviders,
+  // ... other options
+});
+```
+
+## Usage in Dynamic SDK
+
+This package is primarily used internally by the Dynamic SDK React Core package. The main usage patterns are:
+
+- **Wallet List Building**: `getEnabledWallets` is used to filter available wallets based on enabled chains
+- **Configuration Setup**: `getWalletConnectorConstructorOptions` builds the options needed to create wallet connector instances
+- **Message Signing**: `generateMessageToSign` creates SIWE-compliant messages for wallet authentication
+
+## Development
+
+### Running unit tests
+
+```bash
+npx nx test multi-wallet
+```
+
+### Building the package
+
+```bash
+npx nx build multi-wallet
+```

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@dynamic-labs/multi-wallet",
-  "version": "4.33.0",
+  "version": "4.35.0",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.762",
+    "@dynamic-labs/sdk-api-core": "0.0.791",
     "tslib": "2.4.1",
-    "@dynamic-labs/assert-package-version": "4.33.0",
-    "@dynamic-labs/rpc-providers": "4.33.0",
-    "@dynamic-labs/types": "4.33.0",
-    "@dynamic-labs/utils": "4.33.0",
-    "@dynamic-labs/wallet-book": "4.33.0",
-    "@dynamic-labs/wallet-connector-core": "4.33.0"
+    "@dynamic-labs/assert-package-version": "4.35.0",
+    "@dynamic-labs/rpc-providers": "4.35.0",
+    "@dynamic-labs/types": "4.35.0",
+    "@dynamic-labs/utils": "4.35.0",
+    "@dynamic-labs/wallet-book": "4.35.0",
+    "@dynamic-labs/wallet-connector-core": "4.35.0"
   },
   "devDependencies": {
     "@walletconnect/types": "2.21.5"

package/src/utils/getApiProviders/getApiProviders.d.ts

@@ -20,6 +20,7 @@ export declare const getApiProviders: (providers: Provider[]) => {
     blocto?: Provider | undefined;
     banxa?: Provider | undefined;
     coinbaseOnramp?: Provider | undefined;
+    cryptoDotCom?: Provider | undefined;
     dynamic?: Provider | undefined;
     alchemy?: Provider | undefined;
     zerodev?: Provider | undefined;
@@ -36,4 +37,5 @@ export declare const getApiProviders: (providers: Provider[]) => {
     kraken?: Provider | undefined;
     blockaid?: Provider | undefined;
     passkey?: Provider | undefined;
+    okta?: Provider | undefined;
 };

package/src/utils/getWalletConnectorConstructorOptions/getWalletConnectorConstructorOptions.cjs

@@ -15,6 +15,7 @@ const getWalletConnectorConstructorOptions = ({ appLogoUrl, appName, authMode, c
     const cosmosNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.cosmos) || [];
     const starknetNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.starknet) || [];
     const suiNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.sui) || [];
+    const tronNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.tron) || [];
     const apiProviders = getApiProviders.getApiProviders(getEnabledProviders.getEnabledProviders(settings.providers));
     const opts = {
         apiProviders,
@@ -34,6 +35,7 @@ const getWalletConnectorConstructorOptions = ({ appLogoUrl, appName, authMode, c
         solNetworks: solanaNetworkConfigs,
         starknetNetworks: starknetNetworkConfigs,
         suiNetworks: suiNetworkConfigs,
+        tronNetworks: tronNetworkConfigs,
         useMetamaskSdk,
         walletBook,
         walletConnectPreferredChains,

package/src/utils/getWalletConnectorConstructorOptions/getWalletConnectorConstructorOptions.d.ts

@@ -42,6 +42,7 @@ export declare const getWalletConnectorConstructorOptions: ({ appLogoUrl, appNam
         blocto?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         banxa?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         coinbaseOnramp?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
+        cryptoDotCom?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         dynamic?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         alchemy?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         zerodev?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
@@ -58,6 +59,7 @@ export declare const getWalletConnectorConstructorOptions: ({ appLogoUrl, appNam
         kraken?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         blockaid?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
         passkey?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
+        okta?: import("@dynamic-labs/sdk-api-core").Provider | undefined;
     };
     appLogoUrl: string | undefined;
     appName: string | undefined;
@@ -75,6 +77,7 @@ export declare const getWalletConnectorConstructorOptions: ({ appLogoUrl, appNam
     solNetworks: import("@dynamic-labs/types").GenericNetwork[];
     starknetNetworks: import("@dynamic-labs/types").GenericNetwork[];
     suiNetworks: import("@dynamic-labs/types").GenericNetwork[];
+    tronNetworks: import("@dynamic-labs/types").GenericNetwork[];
     useMetamaskSdk: boolean;
     walletBook: {
         groups: Record<string, {

package/src/utils/getWalletConnectorConstructorOptions/getWalletConnectorConstructorOptions.js

@@ -11,6 +11,7 @@ const getWalletConnectorConstructorOptions = ({ appLogoUrl, appName, authMode, c
     const cosmosNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.cosmos) || [];
     const starknetNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.starknet) || [];
     const suiNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.sui) || [];
+    const tronNetworkConfigs = (networkConfigurations === null || networkConfigurations === void 0 ? void 0 : networkConfigurations.tron) || [];
     const apiProviders = getApiProviders(getEnabledProviders(settings.providers));
     const opts = {
         apiProviders,
@@ -30,6 +31,7 @@ const getWalletConnectorConstructorOptions = ({ appLogoUrl, appName, authMode, c
         solNetworks: solanaNetworkConfigs,
         starknetNetworks: starknetNetworkConfigs,
         suiNetworks: suiNetworkConfigs,
+        tronNetworks: tronNetworkConfigs,
         useMetamaskSdk,
         walletBook,
         walletConnectPreferredChains,