@dynamic-labs/legacy-embedded-wallet-migration 0.0.0 → 5.0.0-rc.2

package/src/lib/ui/recovery/LegacyPasskeyBundleRecoveryView/LegacyPasskeyBundleRecoveryView.js

@@ -0,0 +1,36 @@
+'use client'
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { IconButton, ModalHeader, Typography, Input, TypographyButton } from '@dynamic-labs/sdk-react-core/components';
+import { CloseIcon } from '@dynamic-labs/sdk-react-core/icons';
+
+const containerStyle = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 24,
+    padding: 24,
+};
+// eslint-disable-next-line no-useless-escape
+const bundleRegex = /^([A-Za-z0-9\s_+@\.-]+)$/;
+const BUNDLE_MIN_LENGTH = 100;
+const BUNDLE_MAX_LENGTH = 256;
+const isValidBundle = (bundle) => bundle.length >= BUNDLE_MIN_LENGTH &&
+    bundle.length < BUNDLE_MAX_LENGTH &&
+    bundleRegex.test(bundle);
+const LegacyPasskeyBundleRecoveryView = ({ email, onSubmit, onResend, onCancel, isSubmitting, errorMessage }) => {
+    const { t } = useTranslation();
+    const [bundleInput, setBundleInput] = useState('');
+    const closeButton = (jsx(IconButton, { onClick: onCancel, type: 'button', children: jsx(CloseIcon, {}) }));
+    const handleBundleChange = (event) => {
+        const next = event.target.value.trim();
+        setBundleInput(next);
+        if (isValidBundle(next)) {
+            onSubmit(next);
+        }
+    };
+    const resendDisabled = Boolean(isSubmitting) || (bundleInput.length > 0 && !errorMessage);
+    return (jsxs(Fragment, { children: [jsx(ModalHeader, { trailing: closeButton, children: jsx(Typography, { variant: 'title', color: 'primary', children: t('dyn_passkey_recovery.code.title') }) }), jsxs("div", { style: containerStyle, children: [jsx(Typography, { variant: 'body_normal', color: 'secondary', children: t('dyn_passkey_recovery.code.description', { email: email !== null && email !== void 0 ? email : '' }) }), jsx(Input, { id: 'legacy-passkey-recovery-bundle', "data-testid": 'legacy-passkey-bundle-input', value: bundleInput, onChange: handleBundleChange, label: t('dyn_passkey_recovery.code.input_label'), disabled: isSubmitting, error: Boolean(errorMessage), message: errorMessage, autoFocus: true }), jsx(TypographyButton, { dataTestId: 'legacy-passkey-bundle-resend', onClick: () => onResend(), buttonVariant: 'primary', expanded: true, disabled: resendDisabled, children: t('dyn_passkey_recovery.code.resend.button') })] })] }));
+};
+
+export { LegacyPasskeyBundleRecoveryView };

package/src/lib/ui/recovery/LegacyPasskeyBundleRecoveryView/index.d.ts

@@ -0,0 +1 @@
+export { LegacyPasskeyBundleRecoveryView, type LegacyPasskeyBundleRecoveryViewProps, } from './LegacyPasskeyBundleRecoveryView';

package/src/lib/ui/recovery/LegacyPasskeyCompleteRecoveryView/LegacyPasskeyCompleteRecoveryView.d.ts

@@ -0,0 +1,8 @@
+import { FC } from 'react';
+export type LegacyPasskeyCompleteRecoveryViewProps = {
+    onSubmit: () => Promise<void> | void;
+    onCancel: () => void;
+    isSubmitting?: boolean;
+    errorMessage?: string;
+};
+export declare const LegacyPasskeyCompleteRecoveryView: FC<LegacyPasskeyCompleteRecoveryViewProps>;

package/src/lib/ui/recovery/LegacyPasskeyCompleteRecoveryView/LegacyPasskeyCompleteRecoveryView.js

@@ -0,0 +1,22 @@
+'use client'
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { useTranslation } from 'react-i18next';
+import { IconButton, ModalHeader, Typography, TypographyButton } from '@dynamic-labs/sdk-react-core/components';
+import { CloseIcon } from '@dynamic-labs/sdk-react-core/icons';
+
+const containerStyle = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 24,
+    padding: 24,
+};
+// Stub — the WebAuthn-attestation prompt is wired in PR C.2 alongside the
+// usePasskeyRecovery hook integration. For now this view exposes the modal
+// header + submit hook so the step machine can be exercised.
+const LegacyPasskeyCompleteRecoveryView = ({ onSubmit, onCancel, isSubmitting, errorMessage }) => {
+    const { t } = useTranslation();
+    const closeButton = (jsx(IconButton, { onClick: onCancel, type: 'button', children: jsx(CloseIcon, {}) }));
+    return (jsxs(Fragment, { children: [jsx(ModalHeader, { trailing: closeButton, children: jsx(Typography, { variant: 'title', color: 'primary', children: t('dyn_passkey_recovery.complete.title') }) }), jsxs("div", { style: containerStyle, children: [jsx(Typography, { variant: 'body_normal', color: 'secondary', children: t('dyn_passkey_recovery.complete.description') }), errorMessage && (jsx(Typography, { variant: 'body_small', color: 'error-1', children: errorMessage })), jsx(TypographyButton, { dataTestId: 'legacy-passkey-complete-submit', onClick: () => onSubmit(), buttonVariant: 'brand-primary', expanded: true, disabled: isSubmitting, typographyProps: { color: 'white' }, children: t('dyn_passkey_recovery.complete.complete_button') })] })] }));
+};
+
+export { LegacyPasskeyCompleteRecoveryView };

package/src/lib/ui/recovery/LegacyPasskeyCompleteRecoveryView/index.d.ts

@@ -0,0 +1 @@
+export { LegacyPasskeyCompleteRecoveryView, type LegacyPasskeyCompleteRecoveryViewProps, } from './LegacyPasskeyCompleteRecoveryView';

package/src/lib/ui/recovery/index.d.ts

@@ -0,0 +1,4 @@
+export { LegacyAddRecoveryEmailView, type LegacyAddRecoveryEmailViewProps, } from './LegacyAddRecoveryEmailView';
+export { LegacyPasskeyBundleRecoveryView, type LegacyPasskeyBundleRecoveryViewProps, } from './LegacyPasskeyBundleRecoveryView';
+export { LegacyPasskeyCompleteRecoveryView, type LegacyPasskeyCompleteRecoveryViewProps, } from './LegacyPasskeyCompleteRecoveryView';
+export { LegacyEmbeddedAuthChoiceView, type LegacyEmbeddedAuthChoiceViewProps, } from './LegacyEmbeddedAuthChoiceView';

package/src/lib/ui/useLegacyWalletExport/index.d.ts

@@ -0,0 +1 @@
+export { useLegacyWalletExport, type RevealLegacyWalletKeyParams, } from './useLegacyWalletExport';

package/src/lib/ui/useLegacyWalletExport/useLegacyWalletExport.d.ts

@@ -0,0 +1,9 @@
+import { Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
+export type RevealLegacyWalletKeyParams = {
+    type?: 'privateKey' | 'recoveryPhrase';
+    htmlContainerId?: string;
+    wallet?: Wallet<WalletConnectorCore.WalletConnector>;
+};
+export declare const useLegacyWalletExport: () => {
+    readonly revealWalletKey: (params?: RevealLegacyWalletKeyParams) => Promise<boolean>;
+};

package/src/lib/ui/useLegacyWalletExport/useLegacyWalletExport.js

@@ -0,0 +1,75 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { useRef, useCallback } from 'react';
+import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
+import { isSessionKeyCompatibleWalletConnector, isTurnkeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { iframeContainerId, iframeElementId } from '../../constants.js';
+import { cleanupExport } from '../../export/cleanupExport/cleanupExport.js';
+import { exportTurnkeyWalletCredential } from '../../export/exportTurnkeyWalletCredential/exportTurnkeyWalletCredential.js';
+import { initExport } from '../../export/initExport/initExport.js';
+import { useSetTurnkeyConnectorFetchers } from '../../sessionKeys/useSetTurnkeyConnectorFetchers/useSetTurnkeyConnectorFetchers.js';
+import { useLegacyWalletsToMigrate } from '../../useLegacyWalletsToMigrate/useLegacyWalletsToMigrate.js';
+
+const createOrFindContainer = (elementId, parentElementId) => {
+    const existing = document.getElementById(elementId);
+    if (existing)
+        return existing;
+    const container = document.createElement('div');
+    container.setAttribute('id', elementId);
+    container.setAttribute('data-testid', elementId);
+    container.style.pointerEvents = 'auto';
+    const parent = parentElementId
+        ? document.getElementById(parentElementId)
+        : undefined;
+    if (parent) {
+        parent.appendChild(container);
+    }
+    else {
+        document.body.appendChild(container);
+    }
+    return container;
+};
+const useLegacyWalletExport = () => {
+    var _a;
+    const { user } = useDynamicContext();
+    const legacyWallets = useLegacyWalletsToMigrate();
+    const firstWallet = (_a = legacyWallets[0]) !== null && _a !== void 0 ? _a : null;
+    const setTurnkeyConnectorFetchers = useSetTurnkeyConnectorFetchers({
+        wallet: firstWallet,
+    });
+    const userRef = useRef(user);
+    userRef.current = user;
+    const revealWalletKey = useCallback((params) => __awaiter(void 0, void 0, void 0, function* () {
+        var _b, _c;
+        const wallet = (_b = params === null || params === void 0 ? void 0 : params.wallet) !== null && _b !== void 0 ? _b : firstWallet;
+        if (!wallet) {
+            throw new Error('No legacy Turnkey wallet available for export');
+        }
+        yield cleanupExport({ wallet });
+        const iframeContainer = createOrFindContainer(iframeContainerId, params === null || params === void 0 ? void 0 : params.htmlContainerId);
+        iframeContainer.style.display = 'none';
+        setTurnkeyConnectorFetchers();
+        if (isSessionKeyCompatibleWalletConnector(wallet.connector)) {
+            yield wallet.connector.createOrRestoreSession();
+        }
+        if (isTurnkeyWalletConnector(wallet.connector)) {
+            yield wallet.connector.getTurnkeyClient();
+        }
+        (_c = iframeContainer.querySelector(`#${iframeElementId}`)) === null || _c === void 0 ? void 0 : _c.remove();
+        yield initExport({
+            iframeContainer,
+            iframeElementId,
+            wallet,
+        });
+        yield exportTurnkeyWalletCredential({
+            exportPrivateKey: (params === null || params === void 0 ? void 0 : params.type) !== 'recoveryPhrase',
+            user: userRef.current,
+            wallet,
+        });
+        iframeContainer.style.display = 'block';
+        return true;
+    }), [firstWallet, setTurnkeyConnectorFetchers]);
+    return { revealWalletKey };
+};
+
+export { useLegacyWalletExport };

package/src/lib/upgradeToDynamicWaas/index.d.ts

@@ -0,0 +1 @@
+export { upgradeToDynamicWaas } from './upgradeToDynamicWaas';

package/src/lib/upgradeToDynamicWaas/upgradeToDynamicWaas.d.ts

@@ -0,0 +1,13 @@
+import { ChainEnum } from '@dynamic-labs/sdk-api-core';
+import { IDynamicWaasConnector } from '@dynamic-labs/wallet-connector-core';
+type UpgradeToDynamicWaasProps = {
+    walletId: string;
+    chainName: ChainEnum;
+    privateKey: string;
+    password?: string;
+    publicAddressCheck?: string;
+    walletConnector: IDynamicWaasConnector;
+    onRestore: () => Promise<unknown> | unknown;
+};
+export declare const upgradeToDynamicWaas: ({ walletId, chainName, privateKey, password, publicAddressCheck, walletConnector, onRestore, }: UpgradeToDynamicWaasProps) => Promise<void>;
+export {};

package/src/lib/upgradeToDynamicWaas/upgradeToDynamicWaas.js

@@ -0,0 +1,72 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { DynamicError } from '@dynamic-labs/utils';
+import { logger } from '@dynamic-labs/wallet-connector-core';
+import { restoreEmbeddedWallet } from '../restoreEmbeddedWallet/restoreEmbeddedWallet.js';
+import { softDeleteEmbeddedWallet } from '../softDeleteEmbeddedWallet/softDeleteEmbeddedWallet.js';
+
+const ZERODEV_SUFFIX = '-zerodev';
+const PUBLIC_ADDRESS_MISMATCH = 'Public address mismatch';
+const upgradeToDynamicWaas = (_a) => __awaiter(void 0, [_a], void 0, function* ({ walletId, chainName, privateKey, password, publicAddressCheck, walletConnector, onRestore, }) {
+    // Guard before any destructive work: an empty/whitespace private key
+    // would otherwise soft-delete the legacy wallet and only fail on import.
+    if (!(privateKey === null || privateKey === void 0 ? void 0 : privateKey.trim())) {
+        throw new DynamicError('Private key is required', 'private_key_is_required');
+    }
+    // 7702 wallets have a -zerodev suffix because it's a credential created on the fly
+    const normalizedWalletId = walletId.replace(ZERODEV_SUFFIX, '');
+    let softDeleteSucceeded = false;
+    logger.debug('Upgrade to WaaS - migration started', {
+        chain: chainName,
+        key: 'upgradeToWaasStarted',
+        walletId: normalizedWalletId,
+    });
+    try {
+        yield softDeleteEmbeddedWallet({ walletId: normalizedWalletId });
+        softDeleteSucceeded = true;
+        logger.debug('Upgrade to WaaS - legacy wallet soft deleted', {
+            chain: chainName,
+            key: 'upgradeToWaasSoftDeleted',
+            walletId: normalizedWalletId,
+        });
+        yield walletConnector.importPrivateKey({
+            chainName,
+            legacyWalletId: normalizedWalletId,
+            password,
+            privateKey,
+            publicAddressCheck,
+        });
+        logger.info('Upgrade to WaaS - migration completed', {
+            chain: chainName,
+            key: 'upgradeToWaasCompleted',
+            walletId: normalizedWalletId,
+        });
+    }
+    catch (error) {
+        logger.error('Upgrade to WaaS - migration failed', {
+            chain: chainName,
+            error,
+            softDeleteSucceeded,
+            walletId: normalizedWalletId,
+        });
+        if (softDeleteSucceeded) {
+            logger.debug('Upgrade to WaaS - restoring legacy wallet after failed import', {
+                chain: chainName,
+                key: 'upgradeToWaasRestore',
+                walletId: normalizedWalletId,
+            });
+            yield restoreEmbeddedWallet({ walletId: normalizedWalletId });
+            yield onRestore();
+        }
+        if (error instanceof DynamicError) {
+            throw error;
+        }
+        const errorMessage = (error === null || error === void 0 ? void 0 : error.message) || '';
+        if (errorMessage.includes(PUBLIC_ADDRESS_MISMATCH)) {
+            throw new DynamicError('Public address mismatch. Ensure the private key is copied correctly.', 'public_address_mismatch');
+        }
+        throw new DynamicError('Upgrade failed, please try again.', 'upgrade_failed');
+    }
+});
+
+export { upgradeToDynamicWaas };

package/src/lib/useLegacyWalletsToMigrate/index.d.ts

@@ -0,0 +1,2 @@
+export { useHasLegacyWalletsToMigrate } from './useHasLegacyWalletsToMigrate';
+export { useLegacyWalletsToMigrate } from './useLegacyWalletsToMigrate';

package/src/lib/useLegacyWalletsToMigrate/useHasLegacyWalletsToMigrate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns `true` if the current user has any legacy V1/V2 Turnkey wallets
+ * that need to be migrated to V3 WaaS. Convenience wrapper around
+ * `useLegacyWalletsToMigrate()`.
+ */
+export declare const useHasLegacyWalletsToMigrate: () => boolean;

package/src/lib/useLegacyWalletsToMigrate/useHasLegacyWalletsToMigrate.js

@@ -0,0 +1,14 @@
+'use client'
+import { useLegacyWalletsToMigrate } from './useLegacyWalletsToMigrate.js';
+
+/**
+ * Returns `true` if the current user has any legacy V1/V2 Turnkey wallets
+ * that need to be migrated to V3 WaaS. Convenience wrapper around
+ * `useLegacyWalletsToMigrate()`.
+ */
+const useHasLegacyWalletsToMigrate = () => {
+    const wallets = useLegacyWalletsToMigrate();
+    return wallets.length > 0;
+};
+
+export { useHasLegacyWalletsToMigrate };

package/src/lib/useLegacyWalletsToMigrate/useLegacyWalletsToMigrate.d.ts

@@ -0,0 +1,10 @@
+import { Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
+/**
+ * Returns the list of legacy V1/V2 Turnkey wallets on the current user that
+ * need to be migrated to V3 WaaS. Returns an empty array if there are none.
+ *
+ * Useful when you're building your own migration UI (headless mode) — wire
+ * the returned wallets through `useUpgradeToDynamicWaas` to perform the
+ * upgrade.
+ */
+export declare const useLegacyWalletsToMigrate: () => Wallet<WalletConnectorCore.WalletConnector>[];

package/src/lib/useLegacyWalletsToMigrate/useLegacyWalletsToMigrate.js

@@ -0,0 +1,32 @@
+'use client'
+import { useMemo } from 'react';
+import { useUserWallets, useSmartWallets } from '@dynamic-labs/sdk-react-core';
+
+const isLegacyWallet = (wallet) => Boolean(wallet === null || wallet === void 0 ? void 0 : wallet.connector.key.startsWith('turnkey'));
+/**
+ * Returns the list of legacy V1/V2 Turnkey wallets on the current user that
+ * need to be migrated to V3 WaaS. Returns an empty array if there are none.
+ *
+ * Useful when you're building your own migration UI (headless mode) — wire
+ * the returned wallets through `useUpgradeToDynamicWaas` to perform the
+ * upgrade.
+ */
+const useLegacyWalletsToMigrate = () => {
+    const userWallets = useUserWallets();
+    const { getEOAWallet } = useSmartWallets();
+    return useMemo(() => {
+        const legacyWallets = new Map();
+        (userWallets !== null && userWallets !== void 0 ? userWallets : []).forEach((wallet) => {
+            if (isLegacyWallet(wallet)) {
+                legacyWallets.set(wallet.id, wallet);
+            }
+            const eoaWallet = getEOAWallet(wallet);
+            if (isLegacyWallet(eoaWallet)) {
+                legacyWallets.set(eoaWallet.id, eoaWallet);
+            }
+        });
+        return Array.from(legacyWallets.values());
+    }, [getEOAWallet, userWallets]);
+};
+
+export { useLegacyWalletsToMigrate };

package/src/lib/useUpgradeToDynamicWaas/index.d.ts

@@ -0,0 +1 @@
+export { useUpgradeToDynamicWaas } from './useUpgradeToDynamicWaas';

package/src/lib/useUpgradeToDynamicWaas/useUpgradeToDynamicWaas.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+import { Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
+type UpgradeToDynamicWaasArgs = {
+    privateKey: string;
+    wallet: Wallet<WalletConnectorCore.WalletConnector>;
+    password?: string;
+};
+type UseUpgradeToDynamicWaasProps = {
+    /**
+     * Called when the upgrade fails *after* the legacy wallet has been
+     * soft-deleted, to restore client-side auth state. Defaults to
+     * `useRefreshAuth()` — override only if you need custom rollback behavior.
+     */
+    onRestore?: () => Promise<unknown> | unknown;
+};
+export declare const useUpgradeToDynamicWaas: (props?: UseUpgradeToDynamicWaasProps) => {
+    isUpgrading: import("react").MutableRefObject<boolean>;
+    upgradeToDynamicWaas: ({ privateKey, wallet, password }: UpgradeToDynamicWaasArgs) => Promise<void>;
+};
+export {};

package/src/lib/useUpgradeToDynamicWaas/useUpgradeToDynamicWaas.js

@@ -0,0 +1,44 @@
+'use client'
+import { __awaiter } from '../../../_virtual/_tslib.js';
+import { useRef, useCallback } from 'react';
+import { useDynamicWaas, useRefreshAuth } from '@dynamic-labs/sdk-react-core';
+import { DynamicError } from '@dynamic-labs/utils';
+import { upgradeToDynamicWaas } from '../upgradeToDynamicWaas/upgradeToDynamicWaas.js';
+
+const useUpgradeToDynamicWaas = (props = {}) => {
+    var _a;
+    const { getWaasWalletConnector } = useDynamicWaas();
+    const refreshAuth = useRefreshAuth();
+    const onRestore = (_a = props.onRestore) !== null && _a !== void 0 ? _a : refreshAuth;
+    const isUpgrading = useRef(false);
+    const upgrade = useCallback((_b) => __awaiter(void 0, [_b], void 0, function* ({ privateKey, wallet, password }) {
+        isUpgrading.current = true;
+        try {
+            const chainName = wallet.chain;
+            const walletConnector = getWaasWalletConnector(chainName);
+            if (!walletConnector) {
+                throw new DynamicError('Wallet connector not found', 'wallet_connector_not_found');
+            }
+            yield upgradeToDynamicWaas({
+                chainName,
+                onRestore,
+                password,
+                privateKey,
+                publicAddressCheck: wallet.address,
+                walletConnector,
+                walletId: wallet.id,
+            });
+            // The legacy wallet is now soft-deleted server-side and a fresh WaaS
+            // wallet has taken its place — refresh client-side auth so consumers
+            // (e.g. `useUserWallets`) see the new state instead of the stale
+            // Turnkey entry.
+            yield refreshAuth();
+        }
+        finally {
+            isUpgrading.current = false;
+        }
+    }), [getWaasWalletConnector, onRestore, refreshAuth]);
+    return { isUpgrading, upgradeToDynamicWaas: upgrade };
+};
+
+export { useUpgradeToDynamicWaas };