@dynamic-labs/wallet-connector-core 5.4.0 → 5.4.1

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 
+### [5.4.1](https://github.com/dynamic-labs/dynamic-auth/compare/v5.4.0...v5.4.1) (2026-08-26)
+
+
+### Bug Fixes
+
+* **webview-controller:** resolve which keychain key a session belongs to ([#12246](https://github.com/dynamic-labs/dynamic-auth/issues/12246)) ([3d110db](https://github.com/dynamic-labs/dynamic-auth/commit/3d110db831c6e9d82d07d86841f5c7733924b17e))
+* **bitcoin:** forward the password through the BTC importPrivateKey override ([#12278](https://github.com/dynamic-labs/dynamic-auth/issues/12278)) ([21e1df3](https://github.com/dynamic-labs/dynamic-auth/commit/21e1df3e33e96e2efdb15ffa0fd29a441056202e))
+* **react-native-extension:** recover 4.x expo-secure-store sessions on keychain miss ([#12254](https://github.com/dynamic-labs/dynamic-auth/issues/12254)) ([217e991](https://github.com/dynamic-labs/dynamic-auth/commit/217e991838f3073c12e2d2fab7a2e12830faad9e)), closes [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12092](https://github.com/dynamic-labs/dynamic-auth/issues/12092) [#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242) [#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242)
+* **transaction-card:** use walletConnector prop for network/fee instead of primaryWallet ([#12063](https://github.com/dynamic-labs/dynamic-auth/issues/12063)) ([81314d2](https://github.com/dynamic-labs/dynamic-auth/commit/81314d25fba4b20ab89631bc2d9ceeb9e2b6b2ac))
+* **waas-svm:** instrument sponsorship retry attempts ([#12281](https://github.com/dynamic-labs/dynamic-auth/issues/12281)) ([7273a4b](https://github.com/dynamic-labs/dynamic-auth/commit/7273a4bc456cad512c0e9fbcd2abd66532a2f7df))
+* **webview-controller:** recover 4.x secure-storage sessions and surface init failures ([#12242](https://github.com/dynamic-labs/dynamic-auth/issues/12242)) ([b51605c](https://github.com/dynamic-labs/dynamic-auth/commit/b51605cc9bdbb5d695173192c502a58d899bbbdd)), closes [#12094](https://github.com/dynamic-labs/dynamic-auth/issues/12094) [#12095](https://github.com/dynamic-labs/dynamic-auth/issues/12095) [#12098](https://github.com/dynamic-labs/dynamic-auth/issues/12098) [dynamic-labs/flutter-sdk#256](https://github.com/dynamic-labs/flutter-sdk/issues/256)
+
 ## [5.4.0](https://github.com/dynamic-labs/dynamic-auth/compare/v5.3.2...v5.4.0) (2026-08-25)
 
 

package/package.cjs

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

package/package.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/wallet-connector-core",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "description": "Core package for utilities and types for handling multiple wallet/chain support Dynamic SDK",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -22,12 +22,12 @@
     "@dynamic-labs/sdk-api-core": "0.12.0",
     "@dynamic-labs-wallet/browser-wallet-client": "1.0.106",
     "@dynamic-labs-wallet/forward-mpc-client": "1.0.1",
-    "@dynamic-labs/assert-package-version": "5.4.0",
-    "@dynamic-labs/logger": "5.4.0",
-    "@dynamic-labs/rpc-providers": "5.4.0",
-    "@dynamic-labs/types": "5.4.0",
-    "@dynamic-labs/utils": "5.4.0",
-    "@dynamic-labs/wallet-book": "5.4.0",
+    "@dynamic-labs/assert-package-version": "5.4.1",
+    "@dynamic-labs/logger": "5.4.1",
+    "@dynamic-labs/rpc-providers": "5.4.1",
+    "@dynamic-labs/types": "5.4.1",
+    "@dynamic-labs/utils": "5.4.1",
+    "@dynamic-labs/wallet-book": "5.4.1",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {}

package/src/index.d.ts

@@ -1,5 +1,5 @@
 export { walletConnectorEvents, type ProviderReadyEventProps } from './events';
-export { type Attestation, type AuthenticatorRecoveryHandler, type AuthenticatorType, type BitcoinSignPsbtRequest, type BitcoinSignPsbtRequestSignature, type BitcoinSignPsbtResponse, type ExportHandler, type IAccountAbstractionWalletConnector, type IBitcoinWalletConnector, type IEmailOTPWalletConnector, type IEmailWalletConnector, type IHardwareWalletConnector, type IPasskeyWalletConnector, type IPhantomRedirectConnector, type IPhantomRedirectConnectorWithEvents, type ISendBalanceWalletConnector, type ISessionKeyCompatibleWalletConnector, type ISMSWalletConnector, type ITurnkeyWalletConnector, type ITurnkeyWalletConnectorStamper, type IWalletConnectConnector, type IZeroDevConnector, type Eip7702SignedAuthorization, type RecoveryEmailParams, type RecoveryWebAuthnAttestation, type SignAllTransactionsListener, type SignAndSendTransactionListener, type SignMessageListener, type SignTransactionListener, type WebAuthnAttestation, type IEthereumConnector, type IPublicClient, type ISolanaConnection, type IDynamicWaasConnector, type GetWalletPasswordFn, } from './interfaces';
+export { type Attestation, type AuthenticatorRecoveryHandler, type AuthenticatorType, type BitcoinSignPsbtRequest, type BitcoinSignPsbtRequestSignature, type BitcoinSignPsbtResponse, type ExportHandler, type IAccountAbstractionWalletConnector, type IBitcoinWalletConnector, type IEmailOTPWalletConnector, type IEmailWalletConnector, type IHardwareWalletConnector, type IPasskeyWalletConnector, type IPhantomRedirectConnector, type IPhantomRedirectConnectorWithEvents, type ISendBalanceWalletConnector, type ISessionKeyCompatibleWalletConnector, type ISMSWalletConnector, type ITurnkeyWalletConnector, type ITurnkeyWalletConnectorStamper, type IWalletConnectConnector, type IZeroDevConnector, type Eip7702SignedAuthorization, type RecoveryEmailParams, type RecoveryWebAuthnAttestation, type SignAllTransactionsListener, type SignAndSendTransactionListener, type SignMessageListener, type SignTransactionListener, type WebAuthnAttestation, type IEthereumConnector, type IPublicClient, type ISolanaConnection, type IDynamicWaasConnector, type GetWalletPasswordFn, type ImportPrivateKeyParams, type CreateWalletAccountParams, type ExportClientKeysharesParams, type UpdatePasswordParams, type ReshareWalletAccountSharesParams, type RefreshWalletAccountSharesParams, type BackupKeySharesToGoogleDriveParams, } from './interfaces';
 export type { AccountChangeEventHandler, ChainChangeEventHandler, DisconnectEventHandler, WalletConnectorCore, WalletMetadata, WalletDeepLinks, WalletDownloadLinks, WalletLimitations, WalletLinks, } from './types';
 export { addHexPrefix, bufferToHex, connectorRequiresDisconnectionForNewConnection, eventListenerHandlers, getChainInfo, getChainInfoWithOverrides, getDeepLink, getMobileExperience, getRpcUrlForChain, getWalletConnectorByKey, isAccountAbstractionConnector, isBitcoinConnector, getMidnightNetworkTag, isMidnightConnector, isMidnightWallet, type IMidnightWallet, type IMidnightWalletConnector, type MidnightFormattedBalances, isBloctoConnector, isEmailOTPWalletConnector, isEmailWalletConnector, isEmbeddedConnector, isHardwareWalletConnector, isHex, isMagicConnector, isPasskeyWalletConnector, isPhantomRedirectConnector, isSameAddress, isSendBalanceWalletConnector, isSessionKeyCompatibleWallet, isSessionKeyCompatibleWalletConnector, isSocialWalletConnector, isTurnkeyWalletConnector, isWalletConnectConnector, isConnectorMethodSupported, isConnectorEventSupported, getWalletProvider, getWalletMetadataFromWalletBook, getWalletLinks, logger, performPlatformSpecificConnectionMethod, ProviderLookup, setChainInfoOverrides, shouldLowercaseAddress, utf8ToHex, convertWalletToBaseWallet, convertWalletToBaseWalletPartial, type ChainDisplayOverrides, type DeepLinkVariant, type ProviderCondition, isDynamicWaasConnector, } from './utils';
 export { Wallet, type WalletConstructor, type WalletProps } from './Wallet';

package/src/interfaces/IDynamicWaasConnector.d.ts

@@ -1,4 +1,4 @@
-import { GetWalletResponse, WalletRecoveryState } from '@dynamic-labs-wallet/browser-wallet-client';
+import { BitcoinConfig, GetWalletResponse, WalletRecoveryState } from '@dynamic-labs-wallet/browser-wallet-client';
 import { MFAAction, SignMessageContext, TokenScope, WaasPolicyRule } from '@dynamic-labs/sdk-api-core';
 import { WalletConnectorBase } from '..';
 interface GetMfaTokenFunction {
@@ -13,6 +13,55 @@ export type GetWalletPasswordFn = (props: {
     accountAddress: string;
     chainName: string;
 }) => Promise<string | undefined>;
+/**
+ * The single source of truth for `importPrivateKey` parameters.
+ *
+ * Chain connectors that override `importPrivateKey` MUST type their parameter
+ * as this type and forward the whole object to `super`, never re-declaring a
+ * narrower inline shape. A narrower shape is a structurally valid override, so
+ * TypeScript accepts it silently — which is how the Bitcoin connector kept
+ * dropping `password` for six months after it was added to the base, failing
+ * every import on passcode-required environments while other chains worked.
+ */
+export type CreateWalletAccountParams = {
+    thresholdSignatureScheme?: string;
+    password?: string;
+    bitcoinConfig?: BitcoinConfig;
+    businessAccountId?: string;
+};
+export type ExportClientKeysharesParams = {
+    accountAddress: string;
+    password?: string;
+};
+export type UpdatePasswordParams = {
+    accountAddress: string;
+    existingPassword?: string;
+    newPassword: string;
+};
+export type ReshareWalletAccountSharesParams = {
+    accountAddress: string;
+    thresholdSignatureScheme: string;
+    password?: string;
+};
+export type RefreshWalletAccountSharesParams = {
+    accountAddress: string;
+    password?: string;
+};
+export type BackupKeySharesToGoogleDriveParams = {
+    accountAddress: string;
+    password?: string;
+    googleDriveAccessToken?: string;
+};
+export type ImportPrivateKeyParams = {
+    privateKey: string;
+    thresholdSignatureScheme?: string;
+    publicAddressCheck?: string;
+    addressType?: string;
+    legacyWalletId?: string;
+    password?: string;
+    /** ed25519 chains only: `privateKey` is a raw 32-byte scalar (hex). */
+    isRawScalarImport?: boolean;
+};
 export interface IDynamicWaasConnector extends WalletConnectorBase {
     setWaasAuthMode(authMode: 'cookie' | 'header'): void;
     setGetWalletPasswordFunction(getWalletPassword: GetWalletPasswordFn): void;
@@ -46,16 +95,8 @@ export interface IDynamicWaasConnector extends WalletConnectorBase {
     }): Promise<{
         shareSetId: string;
     }>;
-    importPrivateKey({ privateKey, chainName, thresholdSignatureScheme, publicAddressCheck, addressType, legacyWalletId, password, isRawScalarImport, }: {
-        privateKey: string;
+    importPrivateKey(params: ImportPrivateKeyParams & {
         chainName: string;
-        thresholdSignatureScheme?: string;
-        publicAddressCheck?: string;
-        addressType?: string;
-        legacyWalletId?: string;
-        password?: string;
-        /** ed25519 chains only: `privateKey` is a raw 32-byte scalar (hex). */
-        isRawScalarImport?: boolean;
     }): Promise<void>;
     migrateFromFireblocks({ deviceId, jwt, walletPassword, ncwStorage, expectedAddresses, coinTypes, password, }: {
         deviceId: string;