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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Dynamic Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @dynamic-labs/legacy-embedded-wallet-migration
+
+Utilities for migrating legacy Turnkey embedded wallets to Dynamic WaaS wallets.
+
+In v5, Turnkey-specific embedded wallet logic no longer ships in `@dynamic-labs/sdk-react-core`. Applications that still have users on legacy Turnkey embedded wallets should import the migration helpers from this package to upgrade those users to WaaS wallets.

package/_virtual/_tslib.js

@@ -0,0 +1,32 @@
+'use client'
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+export { __awaiter };

package/package.js

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

package/package.json

@@ -1 +1,31 @@
-{ "name": "@dynamic-labs/legacy-embedded-wallet-migration", "version": "0.0.0" }
+{
+  "name": "@dynamic-labs/legacy-embedded-wallet-migration",
+  "version": "5.0.0-rc.2",
+  "license": "MIT",
+  "main": "./src/index.js",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "type": "module",
+  "homepage": "https://www.dynamic.xyz/",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@dynamic-labs-sdk/client": "1.18.0",
+    "@dynamic-labs/assert-package-version": "5.0.0-rc.2",
+    "@dynamic-labs/sdk-api-core": "0.0.1082",
+    "@dynamic-labs/utils": "5.0.0-rc.2",
+    "@dynamic-labs/wallet-connector-core": "5.0.0-rc.2"
+  },
+  "peerDependencies": {
+    "@dynamic-labs/sdk-react-core": "5.0.0-rc.2",
+    "react": ">=18.0.0 <20.0.0",
+    "react-i18next": ">=13.0.0",
+    "@dynamic-labs/types": "5.0.0-rc.2"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,11 @@
+export { restoreEmbeddedWallet } from './lib/restoreEmbeddedWallet';
+export { softDeleteEmbeddedWallet } from './lib/softDeleteEmbeddedWallet';
+export { upgradeToDynamicWaas } from './lib/upgradeToDynamicWaas';
+export { useUpgradeToDynamicWaas } from './lib/useUpgradeToDynamicWaas';
+export { useHasLegacyWalletsToMigrate } from './lib/useLegacyWalletsToMigrate';
+export { useLegacyWalletsToMigrate } from './lib/useLegacyWalletsToMigrate';
+export { LegacyEmbeddedWalletExport, type LegacyEmbeddedWalletExportProps, } from './lib/ui/LegacyEmbeddedWalletExport';
+export { LegacyWalletExportSheet, type LegacyWalletExportSheetProps, } from './lib/ui/LegacyWalletExportSheet';
+export { useLegacyWalletExport, type RevealLegacyWalletKeyParams, } from './lib/ui/useLegacyWalletExport';
+export { LegacyWalletMigrationProvider, useLegacyWalletMigration, type LegacyWalletMigrationContextType, type LegacyWalletMigrationProviderProps, } from './lib/ui/LegacyWalletMigrationContext';
+export { LegacyWalletMigrationModal, type LegacyWalletMigrationModalProps, type LegacyWalletMigrationOnUpgrade, type LegacyWalletMigrationStep, } from './lib/ui/LegacyWalletMigrationModal';

package/src/index.js

@@ -0,0 +1,16 @@
+'use client'
+import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
+import { version } from '../package.js';
+export { restoreEmbeddedWallet } from './lib/restoreEmbeddedWallet/restoreEmbeddedWallet.js';
+export { softDeleteEmbeddedWallet } from './lib/softDeleteEmbeddedWallet/softDeleteEmbeddedWallet.js';
+export { upgradeToDynamicWaas } from './lib/upgradeToDynamicWaas/upgradeToDynamicWaas.js';
+export { useUpgradeToDynamicWaas } from './lib/useUpgradeToDynamicWaas/useUpgradeToDynamicWaas.js';
+export { useHasLegacyWalletsToMigrate } from './lib/useLegacyWalletsToMigrate/useHasLegacyWalletsToMigrate.js';
+export { useLegacyWalletsToMigrate } from './lib/useLegacyWalletsToMigrate/useLegacyWalletsToMigrate.js';
+export { LegacyEmbeddedWalletExport } from './lib/ui/LegacyEmbeddedWalletExport/LegacyEmbeddedWalletExport.js';
+export { LegacyWalletExportSheet } from './lib/ui/LegacyWalletExportSheet/LegacyWalletExportSheet.js';
+export { useLegacyWalletExport } from './lib/ui/useLegacyWalletExport/useLegacyWalletExport.js';
+export { LegacyWalletMigrationProvider, useLegacyWalletMigration } from './lib/ui/LegacyWalletMigrationContext/LegacyWalletMigrationContext.js';
+export { LegacyWalletMigrationModal } from './lib/ui/LegacyWalletMigrationModal/LegacyWalletMigrationModal.js';
+
+assertPackageVersion('@dynamic-labs/legacy-embedded-wallet-migration', version);

package/src/lib/constants.d.ts

@@ -0,0 +1,8 @@
+import type { StorageOptions } from '@dynamic-labs/utils';
+export declare const iframeContainerId = "dyn-turnkey-export-container-id";
+export declare const iframeElementId = "dyn-turnkey-export-element-id";
+export declare const ERROR_PROCESSING_REVEAL_REQUEST = "error_processing_reveal_request";
+export declare const INVALID_WALLET_DATA = "invalid_wallet";
+export declare const USER_NOT_LOGGED_IN = "user_not_logged_in";
+export declare const SECURE_ENCLAVE_WALLET_SESSION_KEYS = "dynamic_secure_enclave_session_keys";
+export declare const SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS: StorageOptions;

package/src/lib/constants.js

@@ -0,0 +1,12 @@
+'use client'
+const iframeContainerId = 'dyn-turnkey-export-container-id';
+const iframeElementId = 'dyn-turnkey-export-element-id';
+const ERROR_PROCESSING_REVEAL_REQUEST = 'error_processing_reveal_request';
+const INVALID_WALLET_DATA = 'invalid_wallet';
+const USER_NOT_LOGGED_IN = 'user_not_logged_in';
+const SECURE_ENCLAVE_WALLET_SESSION_KEYS = 'dynamic_secure_enclave_session_keys';
+const SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS = {
+    priority: ['secureStorage', 'localStorage'],
+};
+
+export { ERROR_PROCESSING_REVEAL_REQUEST, INVALID_WALLET_DATA, SECURE_ENCLAVE_WALLET_SESSION_KEYS, SECURE_ENCLAVE_WALLET_SESSION_KEYS_STORAGE_OPTIONS, USER_NOT_LOGGED_IN, iframeContainerId, iframeElementId };

package/src/lib/export/cleanupExport/cleanupExport.d.ts

@@ -0,0 +1,4 @@
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const cleanupExport: ({ wallet }: {
+    wallet: Wallet | null;
+}) => Promise<void>;

package/src/lib/export/cleanupExport/cleanupExport.js

@@ -0,0 +1,11 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+
+const cleanupExport = (_a) => __awaiter(void 0, [_a], void 0, function* ({ wallet }) {
+    var _b;
+    const connector = wallet === null || wallet === void 0 ? void 0 : wallet.connector;
+    // clear iframeStamper and its reference
+    (_b = connector === null || connector === void 0 ? void 0 : connector.getExportHandler()) === null || _b === void 0 ? void 0 : _b.clear();
+});
+
+export { cleanupExport };

package/src/lib/export/cleanupExport/index.d.ts

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

package/src/lib/export/exportCredential/exportCredential.d.ts

@@ -0,0 +1,7 @@
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+import type { UserProfile } from '@dynamic-labs/sdk-react-core';
+export declare const exportCredential: ({ user, wallet, address, }: {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+    address?: string;
+}) => Promise<boolean>;

package/src/lib/export/exportCredential/exportCredential.js

@@ -0,0 +1,63 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { DynamicError } from '@dynamic-labs/utils';
+import { exportEmbeddedWallet } from '../exportEmbeddedWallet/exportEmbeddedWallet.js';
+import { ERROR_PROCESSING_REVEAL_REQUEST } from '../../constants.js';
+import { extractExportBundle } from '../extractExportBundle/extractExportBundle.js';
+import { handleExportInitCheck } from '../handleExportInitCheck/handleExportInitCheck.js';
+
+const exportCredential = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, wallet, address, }) {
+    const { connector, turnkeyHDWalletId, privateKeyId, organizationId } = handleExportInitCheck({ user, wallet });
+    const turnkeyExportHandler = connector.getExportHandler();
+    const targetPublicKey = turnkeyExportHandler.publicKey;
+    if (!targetPublicKey) {
+        throw new DynamicError('Must initialize export first', ERROR_PROCESSING_REVEAL_REQUEST);
+    }
+    let newActivity;
+    if (turnkeyHDWalletId) {
+        newActivity = yield turnkeyExportHandler.exportWallet({
+            address,
+            organizationId,
+            walletId: turnkeyHDWalletId,
+        });
+    }
+    else if (privateKeyId) {
+        newActivity = yield turnkeyExportHandler.exportPrivateKey({
+            organizationId,
+            privateKeyId,
+        });
+    }
+    const activityId = newActivity.id;
+    const activityStatus = newActivity.status;
+    let exportBundle;
+    if (activityStatus === 'ACTIVITY_STATUS_COMPLETED') {
+        exportBundle = extractExportBundle({
+            activity: newActivity,
+            address,
+            privateKeyId: privateKeyId !== null && privateKeyId !== void 0 ? privateKeyId : undefined,
+        });
+    }
+    else {
+        const res = yield exportEmbeddedWallet({
+            activityId,
+            walletId: (wallet === null || wallet === void 0 ? void 0 : wallet.id) || '',
+        });
+        exportBundle = res === null || res === void 0 ? void 0 : res.exportBundle;
+    }
+    if (!exportBundle) {
+        throw new DynamicError('Invalid export response', ERROR_PROCESSING_REVEAL_REQUEST);
+    }
+    if (address || privateKeyId) {
+        return turnkeyExportHandler.verifyExportPrivateKey({
+            chain: wallet === null || wallet === void 0 ? void 0 : wallet.chain,
+            exportBundle,
+            organizationId,
+        });
+    }
+    return turnkeyExportHandler.verifyExportWallet({
+        exportBundle,
+        organizationId,
+    });
+});
+
+export { exportCredential };

package/src/lib/export/exportCredential/index.d.ts

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

package/src/lib/export/exportEmbeddedWallet/exportEmbeddedWallet.d.ts

@@ -0,0 +1,7 @@
+import type { ExportEmbeddedWalletResponse } from '@dynamic-labs/sdk-api-core';
+type ExportEmbeddedWalletProps = {
+    activityId: string;
+    walletId: string;
+};
+export declare const exportEmbeddedWallet: ({ activityId, walletId, }: ExportEmbeddedWalletProps) => Promise<ExportEmbeddedWalletResponse>;
+export {};

package/src/lib/export/exportEmbeddedWallet/exportEmbeddedWallet.js

@@ -0,0 +1,21 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { getDefaultClient, getCore, createApiClient } from '@dynamic-labs-sdk/client/core';
+
+const exportEmbeddedWallet = (_a) => __awaiter(void 0, [_a], void 0, function* ({ activityId, walletId, }) {
+    const client = getDefaultClient();
+    const core = getCore(client);
+    const apiClient = createApiClient({}, client);
+    try {
+        return yield apiClient.embeddedWalletExport({
+            activityId,
+            environmentId: core.environmentId,
+            walletId,
+        });
+    }
+    catch (_b) {
+        return { exportBundle: '' };
+    }
+});
+
+export { exportEmbeddedWallet };

package/src/lib/export/exportEmbeddedWallet/index.d.ts

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

package/src/lib/export/exportTurnkeyWalletCredential/exportTurnkeyWalletCredential.d.ts

@@ -0,0 +1,9 @@
+import { Wallet, WalletConnectorCore } from '@dynamic-labs/wallet-connector-core';
+import type { UserProfile } from '@dynamic-labs/sdk-react-core';
+export type ExportTurnkeyWalletCredentialParams = {
+    wallet: Wallet<WalletConnectorCore.WalletConnector>;
+    user: UserProfile | undefined;
+    exportPrivateKey?: boolean;
+    handleAcknowledgeExportPrompt?: () => void;
+};
+export declare const exportTurnkeyWalletCredential: ({ wallet, user, exportPrivateKey, handleAcknowledgeExportPrompt, }: ExportTurnkeyWalletCredentialParams) => Promise<boolean | undefined>;

package/src/lib/export/exportTurnkeyWalletCredential/exportTurnkeyWalletCredential.js

@@ -0,0 +1,30 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { isSessionKeyCompatibleWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { exportCredential } from '../exportCredential/exportCredential.js';
+
+const exportTurnkeyWalletCredential = (_a) => __awaiter(void 0, [_a], void 0, function* ({ wallet, user, exportPrivateKey, handleAcknowledgeExportPrompt, }) {
+    var _b;
+    handleAcknowledgeExportPrompt === null || handleAcknowledgeExportPrompt === void 0 ? void 0 : handleAcknowledgeExportPrompt();
+    try {
+        return yield exportCredential({
+            address: exportPrivateKey ? wallet === null || wallet === void 0 ? void 0 : wallet.address : undefined,
+            user,
+            wallet,
+        });
+    }
+    catch (_c) {
+        if (isSessionKeyCompatibleWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector) &&
+            ((_b = wallet === null || wallet === void 0 ? void 0 : wallet.connector) === null || _b === void 0 ? void 0 : _b.removeSessionKeys)) {
+            yield wallet.connector.removeSessionKeys();
+            yield wallet.connector.createOrRestoreSession({ ignoreRestore: true });
+        }
+        return exportCredential({
+            address: exportPrivateKey ? wallet === null || wallet === void 0 ? void 0 : wallet.address : undefined,
+            user,
+            wallet,
+        });
+    }
+});
+
+export { exportTurnkeyWalletCredential };

package/src/lib/export/exportTurnkeyWalletCredential/index.d.ts

@@ -0,0 +1 @@
+export { exportTurnkeyWalletCredential, type ExportTurnkeyWalletCredentialParams, } from './exportTurnkeyWalletCredential';

package/src/lib/export/extractExportBundle/extractExportBundle.d.ts

@@ -0,0 +1,5 @@
+export declare const extractExportBundle: ({ address, privateKeyId, activity, }: {
+    address?: string;
+    privateKeyId?: string;
+    activity: any;
+}) => string | undefined;

package/src/lib/export/extractExportBundle/extractExportBundle.js

@@ -0,0 +1,13 @@
+'use client'
+const extractExportBundle = ({ address, privateKeyId, activity, }) => {
+    var _a, _b, _c;
+    const exportWalletResult = address
+        ? (_a = activity.result) === null || _a === void 0 ? void 0 : _a.exportWalletAccountResult
+        : (_b = activity.result) === null || _b === void 0 ? void 0 : _b.exportWalletResult;
+    const result = privateKeyId
+        ? (_c = activity.result) === null || _c === void 0 ? void 0 : _c.exportPrivateKeyResult
+        : exportWalletResult;
+    return result === null || result === void 0 ? void 0 : result.exportBundle;
+};
+
+export { extractExportBundle };

package/src/lib/export/extractExportBundle/index.d.ts

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

package/src/lib/export/handleExportInitCheck/handleExportInitCheck.d.ts

@@ -0,0 +1,12 @@
+import { IEmailWalletConnector, IPasskeyWalletConnector, Wallet } from '@dynamic-labs/wallet-connector-core';
+import type { UserProfile } from '@dynamic-labs/sdk-react-core';
+export type HandleExportInitCheckResult = {
+    connector: IEmailWalletConnector & IPasskeyWalletConnector;
+    organizationId: string;
+    privateKeyId: string | undefined;
+    turnkeyHDWalletId: string | undefined;
+};
+export declare const handleExportInitCheck: ({ user, wallet, }: {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+}) => HandleExportInitCheckResult;

package/src/lib/export/handleExportInitCheck/handleExportInitCheck.js

@@ -0,0 +1,34 @@
+'use client'
+import { DynamicError, InvalidPrimaryWalletOrConnectorError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+
+const handleExportInitCheck = ({ user, wallet, }) => {
+    var _a, _b, _c, _d, _e;
+    if (!user) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const connector = wallet.connector;
+    connector.setEmail(user.email);
+    const walletProperties = (_b = (_a = user.verifiedCredentials) === null || _a === void 0 ? void 0 : _a.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === wallet.id)) === null || _b === void 0 ? void 0 : _b.walletProperties;
+    const turnkeyHDWalletId = (_c = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.turnkeyHDWalletId) !== null && _c !== void 0 ? _c : undefined;
+    const privateKeyId = (_d = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.turnkeyPrivateKeyId) !== null && _d !== void 0 ? _d : undefined;
+    const organizationId = (_e = walletProperties === null || walletProperties === void 0 ? void 0 : walletProperties.turnkeySubOrganizationId) !== null && _e !== void 0 ? _e : undefined;
+    if (!organizationId ||
+        (turnkeyHDWalletId === undefined && privateKeyId === undefined)) {
+        throw new DynamicError('Invalid token!', 'invalid_token');
+    }
+    return {
+        connector,
+        organizationId,
+        privateKeyId,
+        turnkeyHDWalletId,
+    };
+};
+
+export { handleExportInitCheck };

package/src/lib/export/handleExportInitCheck/index.d.ts

@@ -0,0 +1 @@
+export { handleExportInitCheck, type HandleExportInitCheckResult, } from './handleExportInitCheck';

package/src/lib/export/initExport/index.d.ts

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

package/src/lib/export/initExport/initExport.d.ts

@@ -0,0 +1,6 @@
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const initExport: ({ iframeContainer, iframeElementId, wallet, }: {
+    iframeContainer: HTMLElement;
+    iframeElementId: string;
+    wallet: Wallet | null;
+}) => Promise<import("@dynamic-labs/wallet-connector-core").ExportHandler>;

package/src/lib/export/initExport/initExport.js

@@ -0,0 +1,22 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { InvalidPrimaryWalletOrConnectorError, DynamicError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { INVALID_WALLET_DATA, ERROR_PROCESSING_REVEAL_REQUEST } from '../../constants.js';
+
+const initExport = (_a) => __awaiter(void 0, [_a], void 0, function* ({ iframeContainer, iframeElementId, wallet, }) {
+    var _b;
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError(INVALID_WALLET_DATA);
+    }
+    const turnkeyExportHandler = (_b = wallet.connector) === null || _b === void 0 ? void 0 : _b.getExportHandler();
+    const publicKey = yield turnkeyExportHandler.initExport(iframeContainer, iframeElementId);
+    if (!publicKey) {
+        throw new DynamicError('Something went wrong', ERROR_PROCESSING_REVEAL_REQUEST);
+    }
+    return turnkeyExportHandler;
+});
+
+export { initExport };

package/src/lib/getTurnkeyWalletId/getTurnkeyWalletId.d.ts

@@ -0,0 +1,8 @@
+import { JwtVerifiedCredential } from '@dynamic-labs/sdk-api-core';
+/**
+ * Returns the id of the Turnkey wallet for a given wallet id, walking the
+ * user's verified credentials. If the credential itself is a Turnkey wallet,
+ * its id is returned; if it's a smart wallet whose signer is a Turnkey
+ * wallet, the signer's id is returned.
+ */
+export declare const getTurnkeyWalletId: (turnkeyWalletId: string, verifiedCredentials: JwtVerifiedCredential[]) => string;

package/src/lib/getTurnkeyWalletId/getTurnkeyWalletId.js

@@ -0,0 +1,27 @@
+'use client'
+/**
+ * Returns the id of the Turnkey wallet for a given wallet id, walking the
+ * user's verified credentials. If the credential itself is a Turnkey wallet,
+ * its id is returned; if it's a smart wallet whose signer is a Turnkey
+ * wallet, the signer's id is returned.
+ */
+const getTurnkeyWalletId = (turnkeyWalletId, verifiedCredentials) => {
+    var _a;
+    const turnkeyWallet = verifiedCredentials === null || verifiedCredentials === void 0 ? void 0 : verifiedCredentials.find(({ id }) => id === turnkeyWalletId);
+    if (!turnkeyWallet) {
+        throw new Error('Dynamic v2 wallet not found');
+    }
+    let walletId = undefined;
+    if ((_a = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.walletName) === null || _a === void 0 ? void 0 : _a.startsWith('turnkey')) {
+        walletId = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.id;
+    }
+    else if (turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.signerRefId) {
+        walletId = turnkeyWallet === null || turnkeyWallet === void 0 ? void 0 : turnkeyWallet.signerRefId;
+    }
+    if (!walletId) {
+        throw new Error("Invalid wallet type: expecting 'turnkey' wallet, or a wallet with a 'signerRefId'");
+    }
+    return walletId;
+};
+
+export { getTurnkeyWalletId };

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

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

package/src/lib/recovery/addEmailRecovery/addEmailRecovery.d.ts

@@ -0,0 +1,7 @@
+import { SdkUser } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const addEmailRecovery: ({ user, wallet, }: {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+}) => Promise<SdkUser | undefined>;

package/src/lib/recovery/addEmailRecovery/addEmailRecovery.js

@@ -0,0 +1,50 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { getDefaultClient, getCore, createApiClient, updateAuthFromVerifyResponse } from '@dynamic-labs-sdk/client/core';
+import { DynamicError, InvalidPrimaryWalletOrConnectorError } from '@dynamic-labs/utils';
+import { isPasskeyWalletConnector, isEmailWalletConnector } from '@dynamic-labs/wallet-connector-core';
+import { USER_NOT_LOGGED_IN } from '../../constants.js';
+
+const addEmailRecovery = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, wallet, }) {
+    var _b, _c;
+    if (!(user === null || user === void 0 ? void 0 : user.email)) {
+        throw new DynamicError(USER_NOT_LOGGED_IN, USER_NOT_LOGGED_IN);
+    }
+    if (!(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !(wallet === null || wallet === void 0 ? void 0 : wallet.id) ||
+        !isPasskeyWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector) ||
+        !isEmailWalletConnector(wallet === null || wallet === void 0 ? void 0 : wallet.connector)) {
+        throw new InvalidPrimaryWalletOrConnectorError();
+    }
+    const turnkeyCredential = (_b = user.verifiedCredentials) === null || _b === void 0 ? void 0 : _b.find(({ walletName, id }) => (walletName === null || walletName === void 0 ? void 0 : walletName.startsWith('turnkey')) && id === wallet.id);
+    const { turnkeySubOrganizationId, turnkeyUserId } = (_c = turnkeyCredential === null || turnkeyCredential === void 0 ? void 0 : turnkeyCredential.walletProperties) !== null && _c !== void 0 ? _c : {};
+    if (!turnkeySubOrganizationId || !turnkeyUserId) {
+        throw new DynamicError('The authentication token is invalid - turnkeySubOrganizationId or turnkeyUserID is missing', 'invalid_authentication_token');
+    }
+    const turnkeyRecoveryHandler = wallet.connector.getAuthenticatorHandler();
+    const { signedRequest } = (yield turnkeyRecoveryHandler.addEmailRecovery({
+        email: user.email,
+        organizationId: turnkeySubOrganizationId,
+        turnkeyUserId,
+    }));
+    const client = getDefaultClient();
+    const core = getCore(client);
+    const apiClient = createApiClient({}, client);
+    try {
+        yield apiClient.updateEmbeddedWalletRecoveryEmail({
+            environmentId: core.environmentId,
+            updateRecoveryEmailRequest: { turnkeySignedRequest: signedRequest },
+        });
+    }
+    catch (_d) {
+        throw new DynamicError('Error updating recovery email', 'update_recovery_email_failed');
+    }
+    wallet.connector.setEmail(user.email);
+    const response = yield apiClient.refreshAuth({
+        environmentId: core.environmentId,
+    });
+    updateAuthFromVerifyResponse({ response }, client);
+    return response.user;
+});
+
+export { addEmailRecovery };

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

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

package/src/lib/recovery/addNewPasskeyAuthenticator/addNewPasskeyAuthenticator.d.ts

@@ -0,0 +1,7 @@
+import { SdkUser } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const addNewPasskeyAuthenticator: ({ user, wallet, }: {
+    user: UserProfile | undefined;
+    wallet: Wallet | null;
+}) => Promise<SdkUser>;

package/src/lib/recovery/addNewPasskeyAuthenticator/addNewPasskeyAuthenticator.js

@@ -0,0 +1,14 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { recoverTurnkeyWallet } from '../recoverTurnkeyWallet/recoverTurnkeyWallet.js';
+
+const addNewPasskeyAuthenticator = (_a) => __awaiter(void 0, [_a], void 0, function* ({ user, wallet, }) {
+    const { user: updatedUser } = yield recoverTurnkeyWallet({
+        addPasskeyAuthenticator: true,
+        user,
+        wallet,
+    });
+    return updatedUser;
+});
+
+export { addNewPasskeyAuthenticator };

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

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

package/src/lib/recovery/canRestoreEmbeddedWalletSession/canRestoreEmbeddedWalletSession.d.ts

@@ -0,0 +1,2 @@
+import { Duration } from '@dynamic-labs/sdk-api-core';
+export declare const canRestoreEmbeddedWalletSession: (sessionExpirationTime: Duration | undefined) => boolean;

package/src/lib/recovery/canRestoreEmbeddedWalletSession/canRestoreEmbeddedWalletSession.js

@@ -0,0 +1,24 @@
+'use client'
+import { StorageService } from '@dynamic-labs/utils';
+import { EMBEDDED_WALLET_SESSION_SETTINGS } from '../constants.js';
+
+const canRestoreEmbeddedWalletSession = (sessionExpirationTime) => {
+    if (!(sessionExpirationTime === null || sessionExpirationTime === void 0 ? void 0 : sessionExpirationTime.amount)) {
+        return false;
+    }
+    const sessionSettings = StorageService.getItem(EMBEDDED_WALLET_SESSION_SETTINGS);
+    if (!sessionSettings) {
+        return false;
+    }
+    const sessionExpiration = sessionExpirationTime.amount *
+        (sessionExpirationTime.unit === 'minutes' ? 60 : 3600);
+    const recoveryExpirationSeconds = (sessionSettings === null || sessionSettings === void 0 ? void 0 : sessionSettings.createdAt) + sessionExpiration * 1000;
+    const expirationTime = new Date(recoveryExpirationSeconds);
+    if (new Date() >= expirationTime) {
+        StorageService.removeItem(EMBEDDED_WALLET_SESSION_SETTINGS);
+        return false;
+    }
+    return true;
+};
+
+export { canRestoreEmbeddedWalletSession };

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

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

package/src/lib/recovery/completePasskeyRecovery/completePasskeyRecovery.d.ts

@@ -0,0 +1,7 @@
+import { SdkUser } from '@dynamic-labs/sdk-api-core';
+import { UserProfile } from '@dynamic-labs/types';
+import { Wallet } from '@dynamic-labs/wallet-connector-core';
+export declare const completePasskeyRecovery: ({ user, wallet, }: {
+    wallet: Wallet | null;
+    user: UserProfile | undefined;
+}) => Promise<SdkUser>;