@dynamic-labs-sdk/client 1.10.0 → 1.12.0

package/dist/index.esm.js

@@ -1,9 +1,10 @@
-import { $ as extractSessionId, A as createApiClient, B as InvalidExternalAuthError, D as onceEvent, E as onEvent, F as getNonce, G as ValueMustBeDefinedError, I as SandboxMaximumThresholdReachedError, J as scrubParameters, K as __getElevatedAccessToken_wrapped, L as MfaRateLimitedError, Q as getOperatingSystem, R as MfaInvalidOtpError, S as splitWalletProviderKey, T as offEvent, U as isCookieEnabled, V as APIError, W as assertDefined, X as getUserAgent, Y as DEFAULT_PII_FIELDS, Z as getPlatform, at as setDefaultClient, b as formatWalletAccountId, ct as getCore, d as getWalletProviderRegistry, et as randomString, it as getDefaultClient, j as UnauthorizedError, k as fetchAndStoreNonces, l as getWalletProviderFromWalletAccount, lt as name, m as getWalletAccounts, o as DYNAMIC_ICONIC_SPRITE_URL, p as NoWalletProviderFoundError, q as instrumentFunction, rt as NONCE_POOL_SIZE, s as SDK_API_CORE_VERSION, st as BaseError, t as InvalidParamError, u as WalletProviderPriority, ut as version, v as getChainFromVerifiedCredentialChain, w as emitEvent, x as normalizeAddress, y as CHAINS_INFO_MAP, z as LinkCredentialError } from "./InvalidParamError-BmFmxeXx.esm.js";
-import { A as GENERATE_SESSION_KEYS_TRACKER_KEY, B as isEqualShallow, C as createKeychainService, D as CannotTrackError, F as getBuffer, I as createStorage, M as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, N as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, O as createDeferredPromise, P as isServerSideRendering, R as createLocalStorageAdapter, S as createRealtimeService, T as createCrossTabBroadcast, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as NoNetworkProvidersError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, j as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, k as FETCH_PROJECT_SETTINGS_TRACKER_KEY, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createLogger, x as getKeychainIndexedDBName, y as WalletAlreadyLinkedToAnotherUserError, z as subscribeWithSelector } from "./getNetworkProviderFromNetworkId-CsAg0JU7.esm.js";
-import { a as generateSessionKeys, c as isSignedIn, i as __logoutWithReason_wrapped, l as retryOnFail, n as getMfaMethods, o as fetchProjectSettings, r as __consumeMfaToken_wrapped, s as createStorageKeySchema, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-BNgq1huY.esm.js";
-import { a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, i as upsertElevatedAccessToken, l as getWalletProviders, n as getVerifiedCredentialForWalletAccount, o as restoreUserSharesForAllWalletAccounts, r as updateAuthFromVerifyResponse, t as getWalletProviderByKey, u as isUserMissingMfaAuth } from "./getWalletProviderByKey-AQmQQpmk.esm.js";
-import { t as __refreshAuth_wrapped } from "./refreshAuth-D8dU3BLP.esm.js";
-import { t as NotWaasWalletAccountError } from "./NotWaasWalletAccountError-DO313zza.esm.js";
+import { $ as extractSessionId, A as createApiClient, B as InvalidExternalAuthError, D as onceEvent, E as onEvent, F as getNonce, G as ValueMustBeDefinedError, I as SandboxMaximumThresholdReachedError, J as scrubParameters, K as __getElevatedAccessToken_wrapped, L as MfaRateLimitedError, Q as getOperatingSystem, R as MfaInvalidOtpError, S as splitWalletProviderKey, T as offEvent, U as isCookieEnabled, V as APIError, W as assertDefined, X as getUserAgent, Y as DEFAULT_PII_FIELDS, Z as getPlatform, at as setDefaultClient, b as formatWalletAccountId, ct as getCore, d as getWalletProviderRegistry, et as randomString, it as getDefaultClient, j as UnauthorizedError, k as fetchAndStoreNonces, l as getWalletProviderFromWalletAccount, lt as name, m as getWalletAccounts, o as DYNAMIC_ICONIC_SPRITE_URL, p as NoWalletProviderFoundError, q as instrumentFunction, rt as NONCE_POOL_SIZE, s as SDK_API_CORE_VERSION, st as BaseError, t as InvalidParamError, u as WalletProviderPriority, ut as version, v as getChainFromVerifiedCredentialChain, w as emitEvent, x as normalizeAddress, y as CHAINS_INFO_MAP, z as LinkCredentialError } from "./InvalidParamError-6N66SLG8.esm.js";
+import { A as GENERATE_SESSION_KEYS_TRACKER_KEY, B as isEqualShallow, C as createKeychainService, D as CannotTrackError, F as getBuffer, I as createStorage, M as REFRESH_USER_STATE_FROM_COOKIE_TRACKER_KEY, N as REFRESH_USER_STATE_FROM_VALID_TOKEN_TRACKER_KEY, O as createDeferredPromise, P as isServerSideRendering, R as createLocalStorageAdapter, S as createRealtimeService, T as createCrossTabBroadcast, _ as consumeCaptchaToken, a as verifyMessageSignatureOwnership, b as NoNetworkProvidersError, c as formatSignInMessage, d as updateWalletProviderKeysForVerifiedCredentials, f as setUnverifiedWalletAccounts, g as MethodNotImplementedError, h as __setCaptchaToken_wrapped, i as getNetworksData, j as INITIALIZE_STORAGE_SYNC_TRACKER_KEY, k as FETCH_PROJECT_SETTINGS_TRACKER_KEY, l as getAppMetadata, m as hasExtension, o as removeUnverifiedWalletAccount, p as createVisit, s as createSignInMessageStatement, t as getNetworkProviderFromNetworkId, u as reconcileWalletAccountsAgainstClient, v as isCaptchaRequired, w as createLogger, x as getKeychainIndexedDBName, y as WalletAlreadyLinkedToAnotherUserError, z as subscribeWithSelector } from "./getNetworkProviderFromNetworkId--egxmnKm.esm.js";
+import { a as generateSessionKeys, c as isSignedIn, i as __logoutWithReason_wrapped, l as retryOnFail, n as getMfaMethods, o as fetchProjectSettings, r as __consumeMfaToken_wrapped, s as createStorageKeySchema, t as isMfaRequiredForAction } from "./isMfaRequiredForAction-BnAV59o-.esm.js";
+import { a as parseElevatedAccessToken, d as checkAndRaiseWalletAccountsChangedEvent, i as upsertElevatedAccessToken, l as getWalletProviders, n as getVerifiedCredentialForWalletAccount, o as restoreUserSharesForAllWalletAccounts, r as updateAuthFromVerifyResponse, t as getWalletProviderByKey, u as isUserMissingMfaAuth } from "./getWalletProviderByKey-OC_h7kSB.esm.js";
+import { t as __refreshAuth_wrapped } from "./refreshAuth-DwYi8x0J.esm.js";
+import { n as NotWaasWalletAccountError } from "./isDynamicWaasEnabled-Di2FwljM.esm.js";
+import { t as preconnectWaasIframe } from "./preconnectWaasIframe-D2S_A0QT.esm.js";
 import { assertPackageVersion } from "@dynamic-labs-sdk/assert-package-version";
 import { AuthModeEnum, ExchangeKeyEnum, JwtVerifiedCredentialFormatEnum, MFAAction, MfaBackupCodeAcknowledgement, ProviderEnum, TokenScope, WaasBackupOptionsEnum, WalletProviderEnum } from "@dynamic-labs/sdk-api-core";
 import * as z from "zod/mini";
@@ -361,6 +362,7 @@ const initializeStorageSync = async (client) => {
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the authenticated user.
 * @instrumented
+* @noHook Low-level refresh primitive that is not exposed as a React hook.
 */
 const refreshUser = async (client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -413,6 +415,7 @@ var ClientAlreadyInitializedError = class extends BaseError {
 * @returns A promise that resolves when initialization is complete.
 * @throws ClientAlreadyInitializedError If the client is already initialized.
 * @instrumented
+* @noHook Client lifecycle management is not exposed as a React hook.
 */
 const initializeClient = async (client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -1855,6 +1858,7 @@ const __signInWithPasskey_wrapped = instrumentFunction({
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns An array of `SocialAccount` objects associated with the user.
 * @not-instrumented
+* @hook Exposed as a hook so consumers get the reactive list of social accounts, updated when the user changes.
 */
 const getUserSocialAccounts = (client = getDefaultClient()) => {
 	const { user } = client;
@@ -2106,6 +2110,7 @@ const processSocialCallback = async ({ url, requestedScopes }, client) => {
 	if (storedSocialRedirectState.state !== dynamicOauthState) throw new InvalidRedirectStorageStateError();
 	const { provider, codeVerifier } = storedSocialRedirectState;
 	await core.storage.removeItem(redirectStateStorageKeySchema);
+	preconnectWaasIframe(client);
 	let response;
 	if (client.user) response = await apiClient.oauthVerify({
 		environmentId: core.environmentId,
@@ -2184,6 +2189,7 @@ const __completeSocialRedirect_wrapped = instrumentFunction({
 * removed in a future major version.
 *
 * @instrumented
+* @noHook Deprecated alias; the replacement is exposed via its own hook.
 */
 const completeSocialAuthentication = (params, client = getDefaultClient()) => __completeSocialRedirect_wrapped(params, client);
 const __completeSocialAuthentication_impl = completeSocialAuthentication;
@@ -2229,6 +2235,7 @@ const detectSocialRedirectUrl = async ({ url }, client = getDefaultClient()) =>
 * removed in a future major version.
 *
 * @not-instrumented
+* @noHook Deprecated alias; the replacement is exposed via its own hook.
 */
 const detectOAuthRedirect = (params, client = getDefaultClient()) => detectSocialRedirectUrl(params, client);
 
@@ -2373,6 +2380,7 @@ const getTokenBalances = async ({ walletAccount, networkId, networkIds, includeP
 * multi-chain `getMultichainTokenBalances`.
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getBalances = (params, client = getDefaultClient()) => getTokenBalances(params, client);
 
@@ -2408,6 +2416,7 @@ const getMultichainTokenBalances = async ({ balanceRequest }, client = getDefaul
 * token balances (not native-only) across multiple chains.
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getMultichainBalances = (params, client = getDefaultClient()) => getMultichainTokenBalances(params, client);
 
@@ -2491,6 +2500,8 @@ const withCheckoutSessionTokenCleanupOn401 = async ({ call, transactionId }, cli
 * exchange source record. The response includes `exchangeSource.metadata.url`
 * which can be embedded in an iframe for the user to complete payment.
 *
+* @deprecated Use {@link attachFlowSource} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params AttachCheckoutTransactionSourceParams - The source details to attach.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction (with exchangeSource if sourceType is 'exchange')
@@ -2538,6 +2549,8 @@ const __attachCheckoutTransactionSource_wrapped = instrumentFunction({
 * For exchange sources, `txHash` can be omitted — the user confirms
 * they completed the payment and the transaction moves to `broadcasted`.
 *
+* @deprecated Use {@link broadcastFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params BroadcastCheckoutTransactionParams - The transaction ID and optional tx hash.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction
@@ -2573,6 +2586,8 @@ const __broadcastCheckoutTransaction_wrapped = instrumentFunction({
 /**
 * Cancels a checkout transaction before it has been broadcasted
 *
+* @deprecated Use {@link cancelFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params CancelCheckoutTransactionParams - The transaction to cancel.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The cancelled checkout transaction
@@ -2618,6 +2633,8 @@ const getCheckouts = async (client) => {
 /**
 * Creates a new checkout transaction and stores the session token for subsequent calls
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params CreateCheckoutTransactionParams - The parameters for the checkout transaction.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The created transaction with session token
@@ -2664,6 +2681,8 @@ const __createCheckoutTransaction_wrapped = instrumentFunction({
 /**
 * Fetches the current state of a checkout transaction
 *
+* @deprecated Use {@link getFlow} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params GetCheckoutTransactionParams - The parameters for fetching the transaction.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The checkout transaction
@@ -2682,6 +2701,8 @@ const getCheckoutTransaction = async ({ transactionId }, client = getDefaultClie
 /**
 * Fetches a quote for a checkout transaction
 *
+* @deprecated Use {@link getFlowQuote} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params GetCheckoutTransactionQuoteParams - The quote parameters.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction with quote data
@@ -2711,6 +2732,8 @@ const getCheckoutTransactionQuote = async ({ fromChainId, fromTokenAddress, slip
 * This should be called immediately before triggering the transaction signing.
 * It will confirm the quote is still valid, the risk state is cleared, and the transaction is ready to be signed.
 *
+* @deprecated Use {@link prepareFlowSigning} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params PrepareCheckoutTransactionParams - The transaction to prepare.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The updated checkout transaction
@@ -2858,6 +2881,8 @@ const __executeSwapTransaction_wrapped = instrumentFunction({
 * 3. Delegates on-chain signing to the wallet provider's executeSwapTransaction method
 * 4. Calls broadcastCheckoutTransaction with the resulting txHash
 *
+* @deprecated Use {@link submitFlowTransaction} instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params SubmitCheckoutTransactionParams - The transaction ID, wallet account, and optional step callback.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns The broadcasted checkout transaction
@@ -2909,6 +2934,8 @@ const __submitCheckoutTransaction_wrapped = instrumentFunction({
 * the realtime checkout transaction channel. Will be re-enabled once the
 * dashboard-api environment has the Ably wiring in place.
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params.transactionId - The ID of the checkout transaction to track.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @not-instrumented
@@ -2928,6 +2955,8 @@ const trackCheckoutTransaction = (_params, client = getDefaultClient()) => {
 * Returns `false` when the from token already matches a settlement token, so no
 * conversion is needed.
 *
+* @deprecated Use the Flow API instead. See https://www.dynamic.xyz/docs/javascript/reference/flow-getting-started
+*
 * @param params - The from token details and the checkout's settlement config.
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns Whether a token conversion is required
@@ -3191,6 +3220,96 @@ const __attachFlowSource_wrapped = instrumentFunction({
 	}
 });
 
+//#endregion
+//#region src/modules/flow/utils/createFlowApiClient/createFlowApiClient.ts
+/** @not-instrumented */
+const createFlowApiClient = async ({ flowId }, client) => {
+	const core = getCore(client);
+	const apiClient = createApiClient({}, client);
+	const sessionToken = await core.storage.getItem(createFlowSessionTokenStorageKey(flowId));
+	if (!sessionToken) throw new FlowSessionTokenMissingError({ flowId });
+	return {
+		apiClient,
+		environmentId: core.environmentId,
+		sessionToken
+	};
+};
+
+//#endregion
+//#region src/modules/flow/broadcastFlow/broadcastFlow.ts
+/**
+* Records that a flow transaction has been broadcasted.
+*
+* For wallet sources, pass the `txHash` from the on-chain transaction.
+* For exchange sources, `txHash` can be omitted — the user confirms
+* they completed the payment and the flow moves to `broadcasted`.
+*
+* @param params BroadcastFlowParams - The flow ID and optional tx hash.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The updated flow
+* @instrumented
+*/
+const broadcastFlow = async ({ flowId, txHash }, client = getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createFlowApiClient({ flowId }, client);
+	return withFlowSessionTokenCleanupOn401({
+		call: () => apiClient.broadcastFlow({
+			environmentId,
+			flowId,
+			flowRecordBroadcastRequest: { txHash },
+			xDynamicFlowSessionToken: sessionToken
+		}),
+		flowId
+	}, client);
+};
+const __broadcastFlow_impl = broadcastFlow;
+const __broadcastFlow_wrapped = instrumentFunction({
+	fn: __broadcastFlow_impl,
+	functionName: "broadcastFlow",
+	getCore: () => {
+		try {
+			return getCore(getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
+//#endregion
+//#region src/modules/flow/cancelFlow/cancelFlow.ts
+/**
+* Cancels a flow before it has been broadcasted
+*
+* @param params CancelFlowParams - The flow to cancel.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The cancelled flow
+* @instrumented
+*/
+const cancelFlow = async ({ flowId }, client = getDefaultClient()) => {
+	const { apiClient, environmentId, sessionToken } = await createFlowApiClient({ flowId }, client);
+	const result = await withFlowSessionTokenCleanupOn401({
+		call: () => apiClient.cancelFlow({
+			environmentId,
+			flowId,
+			xDynamicFlowSessionToken: sessionToken
+		}),
+		flowId
+	}, client);
+	await clearFlowSessionToken({ flowId }, client);
+	return result;
+};
+const __cancelFlow_impl = cancelFlow;
+const __cancelFlow_wrapped = instrumentFunction({
+	fn: __cancelFlow_impl,
+	functionName: "cancelFlow",
+	getCore: () => {
+		try {
+			return getCore(getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/flow/getFlow/getFlow.ts
 /**
@@ -3209,21 +3328,6 @@ const getFlow = async ({ flowId }, client = getDefaultClient()) => {
 	});
 };
 
-//#endregion
-//#region src/modules/flow/utils/createFlowApiClient/createFlowApiClient.ts
-/** @not-instrumented */
-const createFlowApiClient = async ({ flowId }, client) => {
-	const core = getCore(client);
-	const apiClient = createApiClient({}, client);
-	const sessionToken = await core.storage.getItem(createFlowSessionTokenStorageKey(flowId));
-	if (!sessionToken) throw new FlowSessionTokenMissingError({ flowId });
-	return {
-		apiClient,
-		environmentId: core.environmentId,
-		sessionToken
-	};
-};
-
 //#endregion
 //#region src/modules/flow/getFlowQuote/getFlowQuote.ts
 /**
@@ -3291,6 +3395,52 @@ const __prepareFlowSigning_wrapped = instrumentFunction({
 	}
 });
 
+//#endregion
+//#region src/modules/flow/submitFlowTransaction/submitFlowTransaction.ts
+/**
+* Prepares, signs, and broadcasts a flow transaction in one call.
+*
+* Orchestrates the full submission flow:
+* 1. Calls prepareFlowSigning to advance to signing state and lock the quote
+* 2. Ensures the wallet is on the correct network for the transaction
+* 3. Delegates on-chain signing to the wallet provider's executeSwapTransaction method
+* 4. Calls broadcastFlow with the resulting txHash
+*
+* @param params SubmitFlowTransactionParams - The flow ID, wallet account, and optional step callback.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns The broadcasted flow
+* @instrumented
+*/
+const submitFlowTransaction = async ({ onStepChange, flowId, walletAccount, assertBalanceForGasCost, assertBalanceForTransferAmount }, client = getDefaultClient()) => {
+	const signingPayload = (await __prepareFlowSigning_wrapped({
+		assertBalanceForGasCost,
+		assertBalanceForTransferAmount,
+		flowId
+	}, client)).quote?.signingPayload;
+	assertDefined(signingPayload, "No signing payload returned from prepare — quote may be missing transaction data");
+	const { transactionHash } = await __executeSwapTransaction_wrapped({
+		onStepChange,
+		signingPayload,
+		walletAccount
+	}, client);
+	return __broadcastFlow_wrapped({
+		flowId,
+		txHash: transactionHash
+	}, client);
+};
+const __submitFlowTransaction_impl = submitFlowTransaction;
+const __submitFlowTransaction_wrapped = instrumentFunction({
+	fn: __submitFlowTransaction_impl,
+	functionName: "submitFlowTransaction",
+	getCore: () => {
+		try {
+			return getCore(getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/funding/coinbase/addCoinbaseOnrampOrderEventListener/addCoinbaseOnrampOrderEventListener.ts
 /**
@@ -3302,6 +3452,7 @@ const __prepareFlowSigning_wrapped = instrumentFunction({
 * @throws {ValueMustBeDefinedError} If the window is not available.
 * @docs https://docs.cdp.coinbase.com/onramp-&-offramp/onramp-apis/apple-pay-onramp-api#events-names
 * @not-instrumented
+* @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const addCoinbaseOnrampOrderEventListener = ({ listener }, client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -3686,6 +3837,7 @@ const __getMoonPayUrl_wrapped = instrumentFunction({
 *
 * @returns a promise that resolves once the client is fully initialized.
 * @not-instrumented
+* @noHook Client lifecycle management is not exposed as a hook; use useInitStatus.
 */
 const waitForClientInitialized = async (client = getDefaultClient()) => {
 	await getCore(client).initTrack.waitForAll();
@@ -4700,7 +4852,9 @@ const __setDefaultMfaDevice_wrapped = instrumentFunction({
 */
 const sendEmailOTP = async ({ email }, client = getDefaultClient()) => {
 	const core = getCore(client);
-	const { verificationUUID } = await createApiClient({}, client).createEmailVerification({
+	const apiClient = createApiClient({}, client);
+	preconnectWaasIframe(client);
+	const { verificationUUID } = await apiClient.createEmailVerification({
 		emailVerificationCreateRequest: {
 			captchaToken: consumeCaptchaToken(client),
 			email
@@ -5663,6 +5817,7 @@ const sendSmsOTP = async ({ isoCountryCode, phoneNumber }, client = getDefaultCl
 	const core = getCore(client);
 	const apiClient = createApiClient({}, client);
 	const phoneCountryCode = supportedCountries[isoCountryCode].code;
+	preconnectWaasIframe(client);
 	const { verificationUUID } = await apiClient.createSmsVerification({
 		environmentId: core.environmentId,
 		smsVerificationCreateRequest: {
@@ -5750,6 +5905,7 @@ const verifyOTPForUserUpdate = async ({ otpVerification, verificationToken, requ
 * @redact-params
 */
 const verifyOTP = async ({ otpVerification, verificationToken, requestedScopes }, client = getDefaultClient()) => {
+	preconnectWaasIframe(client);
 	let response;
 	if (client.user) response = await verifyOTPForUserUpdate({
 		otpVerification,
@@ -7772,6 +7928,7 @@ const getNativeBalance = async ({ walletAccount }, client = getDefaultClient())
 * `getMultichainTokenBalances`).
 *
 * @not-instrumented
+* @noHook Deprecated; the replacement is exposed via its own hook.
 */
 const getBalance = (params, client = getDefaultClient()) => getNativeBalance(params, client);
 
@@ -7889,6 +8046,7 @@ const __switchActiveNetwork_wrapped = instrumentFunction({
 /**
 * Make the wallet account provided as the primary wallet account.
 * @instrumented
+* @noHook The primary-wallet concept is discouraged and not exposed as a hook.
 */
 const selectPrimaryWalletAccount = async ({ walletAccount }, client = getDefaultClient()) => {
 	const core = getCore(client);
@@ -8133,6 +8291,7 @@ const offWalletProviderEvent = ({ callback, event, walletProviderKey }, client =
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A function that can be called to remove the listener.
 * @not-instrumented
+* @hook Event listeners are error-prone to wire up by hand with useEffect.
 */
 const onWalletProviderEvent = ({ callback, event, walletProviderKey }, client = getDefaultClient()) => {
 	const walletProvider = getWalletProviderByKey({ walletProviderKey }, client);
@@ -8254,5 +8413,5 @@ const parseUserAgent = ({ userAgent }) => {
 assertPackageVersion(name, version);
 
 //#endregion
-export { BaseError, CheckoutSessionTokenMissingError, ClientAlreadyInitializedError, DeeplinkConnectAndVerifyUnsupportedError, FeeEstimationFailedError, FlowSessionTokenMissingError, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, InvalidDeviceRegistrationRedirectError, InvalidExternalAuthError, InvalidParamError, InvalidRedirectStorageStateError, InvalidSocialCallbackOriginError, LinkCredentialError, MFAAction, MfaInvalidOtpError, MfaRateLimitedError, MissingRedirectStorageStateError, MissingSocialUrlParamError, MissingUserVerificationError, NetworkAddingUnavailableError, NetworkNotAddedError, NetworkSwitchingUnavailableError, NoAddressFoundError, NoNetworkProvidersError, NoPasskeyCredentialsFoundError, NoSmartWalletAccountSignerFoundError, NoWebAuthNSupportError, NotWaasWalletAccountError, SandboxMaximumThresholdReachedError, SimulationFailedError, TokenSwapError, UnauthorizedError, UnavailableInServerSideError, UnrecognizedNetworkError, UserCancelledSocialPopUpError, UserNotAuthenticatedError, UserRejectedError, WalletAccountAlreadyVerifiedError, WalletAccountNotSelectedError, WalletAlreadyLinkedToAnotherUserError, WalletProviderMethodUnavailableError, __acknowledgeRecoveryCodes_wrapped as acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, __addNetwork_wrapped as addNetwork, appendConnectionUriToDeeplink, assertWalletAccountSigningAvailability, assertWalletProviderMethodDefined, __attachCheckoutTransactionSource_wrapped as attachCheckoutTransactionSource, __attachFlowSource_wrapped as attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, __authenticateWithSocial_wrapped as authenticateWithSocial, __broadcastCheckoutTransaction_wrapped as broadcastCheckoutTransaction, canConnectWithHardwareWallet, __cancelCheckoutTransaction_wrapped as cancelCheckoutTransaction, __checkStepUpAuth_wrapped as checkStepUpAuth, __completeDeviceRegistration_wrapped as completeDeviceRegistration, __completeSocialAuthentication_wrapped as completeSocialAuthentication, __completeSocialRedirect_wrapped as completeSocialRedirect, __confirmTransaction_wrapped as confirmTransaction, __connectAndVerifyWithWalletProvider_wrapped as connectAndVerifyWithWalletProvider, __connectWithWalletProvider_wrapped as connectWithWalletProvider, __consumeMfaToken_wrapped as consumeMfaToken, __createCheckoutTransaction_wrapped as createCheckoutTransaction, __createCoinbaseOnrampOrder_wrapped as createCoinbaseOnrampOrder, __createCryptoDotComPayment_wrapped as createCryptoDotComPayment, __createDynamicClient_wrapped as createDynamicClient, __createKrakenExchangeTransfer_wrapped as createKrakenExchangeTransfer, __createNewMfaRecoveryCodes_wrapped as createNewMfaRecoveryCodes, __deleteMfaDevice_wrapped as deleteMfaDevice, __deletePasskey_wrapped as deletePasskey, __deleteUser_wrapped as deleteUser, detectDeviceRegistrationRedirect, detectOAuthRedirect, detectSocialRedirectUrl, excludeInstalledFromCatalog, __executeSwapTransaction_wrapped as executeSwapTransaction, fetchProjectSettings, findMissingGoogleDriveBackupScopes, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalance, getBalanceForAddress, getBalances, getCheckoutTransaction, getCheckoutTransactionQuote, getCoinbaseBuyUrl, getConnectedAddresses, getDefaultClient, getDeviceRegistrationTokenFromUrl, __getElevatedAccessToken_wrapped as getElevatedAccessToken, getFlow, getFlowQuote, __getGoogleDriveBackupReadiness_wrapped as getGoogleDriveBackupReadiness, getInstallationLinkForCurrentPlatform, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMissingVerificationForCoinbaseOnrampOrder, __getMoonPayCurrencies_wrapped as getMoonPayCurrencies, __getMoonPayUrl_wrapped as getMoonPayUrl, getMultichainBalances, getMultichainTokenBalances, getNativeBalance, getNetworksData, getOwnerWalletAccountForSmartWalletAccount, getPasskeys, getPrimaryWalletAccount, getRegisteredDevices, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccountAddressByType, getWalletAccountFromAddress, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, getWalletProviderDataByKey, hasAllGoogleDriveBackupScopes, hasExtension, __initializeClient_wrapped as initializeClient, isAnyWalletAccountConnected, isCaptchaRequired, isDeeplinkWalletProvider, isDeviceRegistrationRequired, isHardwareWalletAccount, isInsufficientGoogleDriveScopesError, isMfaRequiredForAction, isMobile, isPendingRecoveryCodesAcknowledgment, isProgrammaticNetworkSwitchAvailable, isSignedIn, isUserMissingMfaAuth, isUserOnboardingComplete, isWalletAccountVerified, logout, matchWalletProvidersToCatalogGroup, offEvent, offWalletProviderEvent, onEvent, onWalletProviderEvent, onceEvent, parseUserAgent, __prepareCheckoutTransaction_wrapped as prepareCheckoutTransaction, __prepareFlowSigning_wrapped as prepareFlowSigning, __proveWalletAccountOwnership_wrapped as proveWalletAccountOwnership, __refreshAuth_wrapped as refreshAuth, __refreshUser_wrapped as refreshUser, __registerPasskey_wrapped as registerPasskey, __registerTotpMfaDevice_wrapped as registerTotpMfaDevice, __removeWalletAccount_wrapped as removeWalletAccount, __requestExternalAuthElevatedToken_wrapped as requestExternalAuthElevatedToken, requiresConversion, __revokeAllRegisteredDevices_wrapped as revokeAllRegisteredDevices, __revokeRegisteredDevice_wrapped as revokeRegisteredDevice, __selectPrimaryWalletAccount_wrapped as selectPrimaryWalletAccount, __sendEmailOTP_wrapped as sendEmailOTP, __sendSmsOTP_wrapped as sendSmsOTP, __setCaptchaToken_wrapped as setCaptchaToken, __setDefaultMfaDevice_wrapped as setDefaultMfaDevice, __setInstrumentationEnabled_wrapped as setInstrumentationEnabled, __signInWithExternalJwt_wrapped as signInWithExternalJwt, __signInWithPasskey_wrapped as signInWithPasskey, __signInWithSocialPopUp_wrapped as signInWithSocialPopUp, __signInWithSocialRedirect_wrapped as signInWithSocialRedirect, __signMessage_wrapped as signMessage, __submitCheckoutTransaction_wrapped as submitCheckoutTransaction, supportedCountries, __switchActiveNetwork_wrapped as switchActiveNetwork, trackCheckoutTransaction, __transferAmount_wrapped as transferAmount, __transferWalletAccount_wrapped as transferWalletAccount, __unlinkSocialAccount_wrapped as unlinkSocialAccount, __updateUser_wrapped as updateUser, __verifyOTP_wrapped as verifyOTP, __verifyWalletAccount_wrapped as verifyWalletAccount, waitForClientInitialized };
+export { BaseError, CheckoutSessionTokenMissingError, ClientAlreadyInitializedError, DeeplinkConnectAndVerifyUnsupportedError, FeeEstimationFailedError, FlowSessionTokenMissingError, GOOGLE_DRIVE_BACKUP_REQUIRED_SCOPES, InvalidDeviceRegistrationRedirectError, InvalidExternalAuthError, InvalidParamError, InvalidRedirectStorageStateError, InvalidSocialCallbackOriginError, LinkCredentialError, MFAAction, MfaInvalidOtpError, MfaRateLimitedError, MissingRedirectStorageStateError, MissingSocialUrlParamError, MissingUserVerificationError, NetworkAddingUnavailableError, NetworkNotAddedError, NetworkSwitchingUnavailableError, NoAddressFoundError, NoNetworkProvidersError, NoPasskeyCredentialsFoundError, NoSmartWalletAccountSignerFoundError, NoWebAuthNSupportError, NotWaasWalletAccountError, SandboxMaximumThresholdReachedError, SimulationFailedError, TokenSwapError, UnauthorizedError, UnavailableInServerSideError, UnrecognizedNetworkError, UserCancelledSocialPopUpError, UserNotAuthenticatedError, UserRejectedError, WalletAccountAlreadyVerifiedError, WalletAccountNotSelectedError, WalletAlreadyLinkedToAnotherUserError, WalletProviderMethodUnavailableError, __acknowledgeRecoveryCodes_wrapped as acknowledgeRecoveryCodes, addCoinbaseOnrampOrderEventListener, __addNetwork_wrapped as addNetwork, appendConnectionUriToDeeplink, assertWalletAccountSigningAvailability, assertWalletProviderMethodDefined, __attachCheckoutTransactionSource_wrapped as attachCheckoutTransactionSource, __attachFlowSource_wrapped as attachFlowSource, authenticateMfaRecoveryCode, authenticatePasskeyMFA, authenticateTotpMfaDevice, __authenticateWithSocial_wrapped as authenticateWithSocial, __broadcastCheckoutTransaction_wrapped as broadcastCheckoutTransaction, __broadcastFlow_wrapped as broadcastFlow, canConnectWithHardwareWallet, __cancelCheckoutTransaction_wrapped as cancelCheckoutTransaction, __cancelFlow_wrapped as cancelFlow, __checkStepUpAuth_wrapped as checkStepUpAuth, __completeDeviceRegistration_wrapped as completeDeviceRegistration, __completeSocialAuthentication_wrapped as completeSocialAuthentication, __completeSocialRedirect_wrapped as completeSocialRedirect, __confirmTransaction_wrapped as confirmTransaction, __connectAndVerifyWithWalletProvider_wrapped as connectAndVerifyWithWalletProvider, __connectWithWalletProvider_wrapped as connectWithWalletProvider, __consumeMfaToken_wrapped as consumeMfaToken, __createCheckoutTransaction_wrapped as createCheckoutTransaction, __createCoinbaseOnrampOrder_wrapped as createCoinbaseOnrampOrder, __createCryptoDotComPayment_wrapped as createCryptoDotComPayment, __createDynamicClient_wrapped as createDynamicClient, __createKrakenExchangeTransfer_wrapped as createKrakenExchangeTransfer, __createNewMfaRecoveryCodes_wrapped as createNewMfaRecoveryCodes, __deleteMfaDevice_wrapped as deleteMfaDevice, __deletePasskey_wrapped as deletePasskey, __deleteUser_wrapped as deleteUser, detectDeviceRegistrationRedirect, detectOAuthRedirect, detectSocialRedirectUrl, excludeInstalledFromCatalog, __executeSwapTransaction_wrapped as executeSwapTransaction, fetchProjectSettings, findMissingGoogleDriveBackupScopes, getActiveNetworkData, getActiveNetworkId, getAvailableWalletProvidersData, getBalance, getBalanceForAddress, getBalances, getCheckoutTransaction, getCheckoutTransactionQuote, getCoinbaseBuyUrl, getConnectedAddresses, getDefaultClient, getDeviceRegistrationTokenFromUrl, __getElevatedAccessToken_wrapped as getElevatedAccessToken, getFlow, getFlowQuote, __getGoogleDriveBackupReadiness_wrapped as getGoogleDriveBackupReadiness, getInstallationLinkForCurrentPlatform, getKrakenAccounts, getKrakenWhitelistedAddresses, getMfaDevices, getMfaMethods, getMfaRecoveryCodes, getMissingVerificationForCoinbaseOnrampOrder, __getMoonPayCurrencies_wrapped as getMoonPayCurrencies, __getMoonPayUrl_wrapped as getMoonPayUrl, getMultichainBalances, getMultichainTokenBalances, getNativeBalance, getNetworksData, getOwnerWalletAccountForSmartWalletAccount, getPasskeys, getPrimaryWalletAccount, getRegisteredDevices, getSwapQuote, getSwapStatus, getTokenBalances, getTransactionHistory, getUserSocialAccounts, getWalletAccountAddressByType, getWalletAccountFromAddress, getWalletAccounts, getWalletConnectCatalog, getWalletConnectCatalogWalletByWalletProviderKey, getWalletOptionsCatalogue, getWalletProviderDataByKey, hasAllGoogleDriveBackupScopes, hasExtension, __initializeClient_wrapped as initializeClient, isAnyWalletAccountConnected, isCaptchaRequired, isDeeplinkWalletProvider, isDeviceRegistrationRequired, isHardwareWalletAccount, isInsufficientGoogleDriveScopesError, isMfaRequiredForAction, isMobile, isPendingRecoveryCodesAcknowledgment, isProgrammaticNetworkSwitchAvailable, isSignedIn, isUserMissingMfaAuth, isUserOnboardingComplete, isWalletAccountVerified, logout, matchWalletProvidersToCatalogGroup, offEvent, offWalletProviderEvent, onEvent, onWalletProviderEvent, onceEvent, parseUserAgent, __prepareCheckoutTransaction_wrapped as prepareCheckoutTransaction, __prepareFlowSigning_wrapped as prepareFlowSigning, __proveWalletAccountOwnership_wrapped as proveWalletAccountOwnership, __refreshAuth_wrapped as refreshAuth, __refreshUser_wrapped as refreshUser, __registerPasskey_wrapped as registerPasskey, __registerTotpMfaDevice_wrapped as registerTotpMfaDevice, __removeWalletAccount_wrapped as removeWalletAccount, __requestExternalAuthElevatedToken_wrapped as requestExternalAuthElevatedToken, requiresConversion, __revokeAllRegisteredDevices_wrapped as revokeAllRegisteredDevices, __revokeRegisteredDevice_wrapped as revokeRegisteredDevice, __selectPrimaryWalletAccount_wrapped as selectPrimaryWalletAccount, __sendEmailOTP_wrapped as sendEmailOTP, __sendSmsOTP_wrapped as sendSmsOTP, __setCaptchaToken_wrapped as setCaptchaToken, __setDefaultMfaDevice_wrapped as setDefaultMfaDevice, __setInstrumentationEnabled_wrapped as setInstrumentationEnabled, __signInWithExternalJwt_wrapped as signInWithExternalJwt, __signInWithPasskey_wrapped as signInWithPasskey, __signInWithSocialPopUp_wrapped as signInWithSocialPopUp, __signInWithSocialRedirect_wrapped as signInWithSocialRedirect, __signMessage_wrapped as signMessage, __submitCheckoutTransaction_wrapped as submitCheckoutTransaction, __submitFlowTransaction_wrapped as submitFlowTransaction, supportedCountries, __switchActiveNetwork_wrapped as switchActiveNetwork, trackCheckoutTransaction, __transferAmount_wrapped as transferAmount, __transferWalletAccount_wrapped as transferWalletAccount, __unlinkSocialAccount_wrapped as unlinkSocialAccount, __updateUser_wrapped as updateUser, __verifyOTP_wrapped as verifyOTP, __verifyWalletAccount_wrapped as verifyWalletAccount, waitForClientInitialized };
 //# sourceMappingURL=index.esm.js.map