@dynamic-labs-sdk/client 0.24.1 → 0.25.1

package/dist/index.cjs.js

@@ -1,8 +1,8 @@
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-COxYamJy.cjs.js');
-const require_InvalidParamError = require('./InvalidParamError-9IR2C0up.cjs.js');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-Df_wN20i.cjs.js');
-const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-DpRIY6Pd.cjs.js');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-cfGmMd_g.cjs.js');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-ClfETwqS.cjs.js');
+const require_InvalidParamError = require('./InvalidParamError-BqDEZ6er.cjs.js');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-DEiU9FZG.cjs.js');
+const require_NotWaasWalletAccountError = require('./NotWaasWalletAccountError-ftYfHk_N.cjs.js');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-mZub0YwI.cjs.js');
 let _dynamic_labs_sdk_assert_package_version = require("@dynamic-labs-sdk/assert-package-version");
 let _dynamic_labs_sdk_api_core = require("@dynamic-labs/sdk-api-core");
 let zod_mini = require("zod/mini");
@@ -35,113 +35,6 @@ const prefetchNoncesIfNeeded = async (client) => {
 	await require_InvalidParamError.fetchAndStoreNonces(client);
 };
 
-//#endregion
-//#region src/utils/retryOnFail/InvalidRetryOnFailCallError.ts
-/**
-* This error is thrown when the `retryOnFail` function is called with an invalid
-* number of retries (i.e. less than 0).
-*/
-var InvalidRetryOnFailCallError = class extends require_InvalidParamError.BaseError {
-	constructor(maxRetries) {
-		super({
-			cause: null,
-			code: "invalid_retry_on_fail_call_error",
-			docsUrl: null,
-			name: "InvalidRetryOnFailCallError",
-			shortMessage: `Invalid retries parameter for retryOnFail call: ${maxRetries}`
-		});
-	}
-};
-
-//#endregion
-//#region src/utils/retryOnFail/retryOnFail.ts
-/** @not-instrumented */
-const retryOnFail = async ({ delay = 0, fn, maxRetries }) => {
-	for (let retry = 0; retry <= maxRetries; retry++) try {
-		return await fn();
-	} catch (error) {
-		if (retry >= maxRetries) throw error;
-		if (delay > 0) await new Promise((resolve) => setTimeout(resolve, delay));
-	}
-	/**
-	* Reaching this point should never happen and this
-	* error is thrown to help us debug the issue.
-	*/
-	throw new InvalidRetryOnFailCallError(maxRetries);
-};
-
-//#endregion
-//#region src/modules/auth/isSignedIn/isSignedIn.ts
-/**
-* Checks if the user is currently signed in to the Dynamic client.
-*
-* The client is considered to be in a signed in state if a user has
-* authenticated or if the client has at least one wallet connected.
-*
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns True if the user is signed in, false otherwise.
-* @not-instrumented
-*/
-const isSignedIn = (client = require_InvalidParamError.getDefaultClient()) => Boolean(client.user || require_getVerifiedCredentialForWalletAccount.__getWalletAccounts_wrapped(client).length > 0);
-
-//#endregion
-//#region src/modules/projectSettings/fetchProjectSettings/projectSettingsExpirationScheme.ts
-/**
-* The schema to track the expiration time of the project settings.
-*/
-const projectSettingsExpirationStorageKeySchema = require_getNetworkProviderFromNetworkId.__createStorageKeySchema_wrapped({
-	key: "projectSettingsExpiration",
-	schema: zod_mini.number()
-});
-
-//#endregion
-//#region src/modules/projectSettings/fetchProjectSettings/fetchProjectSettings.ts
-/**
-* Expiration time of the project settings in milliseconds.
-*/
-const PROJECT_SETTINGS_EXPIRATION_TIME = 1e3 * 60 * 5;
-/**
-* Fetches and updates the project settings from the API.
-*
-* This function retrieves the latest project configuration settings
-* from Dynamic's servers, including authentication options, enabled chains,
-* and security configurations. The settings are cached for performance.
-*
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns A promise that resolves to the updated project settings.
-* @instrumented
-*/
-const fetchProjectSettings = async (client = require_InvalidParamError.getDefaultClient()) => {
-	const core = require_InvalidParamError.getCore(client);
-	const currentExpiration = await core.storage.getItem(projectSettingsExpirationStorageKeySchema);
-	if (Boolean(client.projectSettings) && !(currentExpiration && currentExpiration < Date.now()) && isSignedIn(client)) return client.projectSettings;
-	const apiClient = require_InvalidParamError.__createApiClient_wrapped({}, client);
-	core.logger.debug("[fetchProjectSettings] Fetching project settings...");
-	const doFetch = async () => apiClient.getEnvironmentSettings({
-		environmentId: core.environmentId,
-		sdkVersion: `${require_InvalidParamError.CLIENT_SDK_NAME}/${core.version}`
-	}, { credentials: "omit" });
-	const projectSettings = await retryOnFail({
-		fn: doFetch,
-		maxRetries: 2
-	});
-	core.state.set({ projectSettings: projectSettings ?? null });
-	await core.storage.setItem(projectSettingsExpirationStorageKeySchema, Date.now() + PROJECT_SETTINGS_EXPIRATION_TIME);
-	return projectSettings;
-};
-const __fetchProjectSettings_impl = fetchProjectSettings;
-const __fetchProjectSettings_wrapped = require_InvalidParamError.instrumentFunction({
-	fn: __fetchProjectSettings_impl,
-	functionName: "fetchProjectSettings",
-	getCore: () => {
-		try {
-			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/services/runtimeServices/createRuntimeServices/createRuntimeServices.ts
 /**
@@ -159,124 +52,13 @@ const createRuntimeServices = () => {
 	};
 };
 
-//#endregion
-//#region src/modules/wallets/utils/getAvailableWalletProvidersFromWalletAccounts/getAvailableWalletProvidersFromWalletAccounts.ts
-/** @not-instrumented */
-const getAvailableWalletProvidersFromWalletAccounts = (client) => {
-	const core = require_InvalidParamError.getCore(client);
-	const walletProvidersMap = /* @__PURE__ */ new Map();
-	require_getVerifiedCredentialForWalletAccount.__getWalletAccounts_wrapped(client).forEach((walletAccount) => {
-		if (walletProvidersMap.has(walletAccount.walletProviderKey)) return;
-		try {
-			const walletProvider = require_getVerifiedCredentialForWalletAccount.__getWalletProviderFromWalletAccount_wrapped({ walletAccount }, client);
-			walletProvidersMap.set(walletAccount.walletProviderKey, walletProvider);
-		} catch (error) {
-			core.logger.debug("Wallet provider not found for wallet account", {
-				error,
-				walletAccount: walletAccount.address
-			});
-		}
-	});
-	return Array.from(walletProvidersMap.values());
-};
-
-//#endregion
-//#region src/modules/wallets/disconnectAndTerminateWalletProviders/disconnectAndTerminateWalletProviders.ts
-/**
-* Disconnect and terminate each wallet provider, if available.
-* @not-instrumented
-*/
-const disconnectAndTerminateWalletProviders = async ({ reason }, client) => {
-	const core = require_InvalidParamError.getCore(client);
-	const walletProviders = getAvailableWalletProvidersFromWalletAccounts(client);
-	await Promise.all(walletProviders.map(async (walletProvider) => {
-		if (walletProvider.terminate) await walletProvider.terminate({ reason });
-		if (walletProvider.disconnect) try {
-			await walletProvider.disconnect();
-		} catch (err) {
-			core.logger.error(`Error disconnecting from wallet ${walletProvider.key}`, err);
-		}
-	}));
-};
-
-//#endregion
-//#region src/modules/auth/performLogout/performLogout.ts
-/**
-* Shared logout implementation that revokes the session, clears auth state,
-* terminates wallet providers, and emits the logout event with the given reason.
-*
-* @not-instrumented
-*/
-const performLogout = async ({ reason }, client) => {
-	const core = require_InvalidParamError.getCore(client);
-	core.logger.debug("[logout] Logging out...");
-	await disconnectAndTerminateWalletProviders({ reason }, client);
-	if (client.user !== null) {
-		const apiClient = require_InvalidParamError.__createApiClient_wrapped({}, client);
-		try {
-			await apiClient.revokeSession({ environmentId: core.environmentId });
-		} catch (error) {
-			core.logger.error("Failed to revoke session", error);
-		}
-		/**
-		* This deletes the auth cookie if it exists.
-		* If the cookie doesn't exist, this sets a new cookie that expires immediately.
-		*/
-		if (require_InvalidParamError.isCookieEnabled(client)) require_getVerifiedCredentialForWalletAccount.setCookie(`${require_getVerifiedCredentialForWalletAccount.DYNAMIC_AUTH_COOKIE_NAME}=; Max-Age=-99999999; path=/; SameSite=Lax`);
-	}
-	await core.keychain.removeKey("session");
-	core.state.set({
-		captchaToken: null,
-		elevatedAccessTokens: [],
-		legacyToken: null,
-		mfaToken: null,
-		sessionExpiresAt: null,
-		sessionKeys: null,
-		token: null,
-		unverifiedWalletAccounts: [],
-		user: null
-	});
-	require_getVerifiedCredentialForWalletAccount.emitEvent({
-		args: { reason },
-		event: "logout"
-	}, client);
-	__fetchProjectSettings_wrapped(client);
-	require_getNetworkProviderFromNetworkId.__generateSessionKeys_wrapped(client);
-};
-
-//#endregion
-//#region src/modules/auth/handleSessionExpiration/handleSessionExpiration.ts
-/**
-* Logs out due to session expiry with a token-expired reason,
-* allowing downstream providers to decide their own cleanup behavior.
-*
-* @param client - The Dynamic client instance.
-* @returns A promise that resolves when the logout process is complete.
-* @instrumented
-*/
-const handleSessionExpiration = async (client) => {
-	return performLogout({ reason: "token-expired" }, client);
-};
-const __handleSessionExpiration_impl = handleSessionExpiration;
-const __handleSessionExpiration_wrapped = require_InvalidParamError.instrumentFunction({
-	fn: __handleSessionExpiration_impl,
-	functionName: "handleSessionExpiration",
-	getCore: () => {
-		try {
-			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/auth/initializeAuth/setLongTimeout/setLongTimeout.ts
 /**
 * A replacement for setTimeout that supports delays longer than 2147483647ms (~24.8 days).
 * @not-instrumented
 */
-const setLongTimeout = (callback, delay) => {
+const setLongTimeout = ({ callback, delay }) => {
 	const MAX_DELAY = 2147483647;
 	let timeoutId = null;
 	let remaining = delay;
@@ -310,40 +92,18 @@ const initializeAuth = (client) => {
 		const now = /* @__PURE__ */ new Date();
 		const timeUntilExpiration = expiration.getTime() - now.getTime();
 		if (timeUntilExpiration <= 0) {
-			__handleSessionExpiration_wrapped(client);
+			require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "token-expired" }, client);
 			return;
 		}
-		clearExpirationTimeout = setLongTimeout(checkExpiration, timeUntilExpiration);
+		clearExpirationTimeout = setLongTimeout({
+			callback: checkExpiration,
+			delay: timeUntilExpiration
+		});
 	};
 	onChangeExpiration(checkExpiration);
 	checkExpiration();
 };
 
-//#endregion
-//#region src/modules/auth/logout/logout.ts
-/**
-* Logs out the current user and clears all authentication data.
-*
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns A promise that resolves when the logout process is complete.
-* @instrumented
-*/
-const logout = async (client = require_InvalidParamError.getDefaultClient()) => {
-	return performLogout({ reason: "user-intent" }, client);
-};
-const __logout_impl = logout;
-const __logout_wrapped = require_InvalidParamError.instrumentFunction({
-	fn: __logout_impl,
-	functionName: "logout",
-	getCore: () => {
-		try {
-			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/crossTabEventSync/setupCrossTabEventSync/setupCrossTabEventSync.ts
 /**
@@ -410,6 +170,7 @@ const stateStorageKeySchema = require_getNetworkProviderFromNetworkId.__createSt
 	})
 });
 const sessionStorageKeySchema = require_getNetworkProviderFromNetworkId.__createStorageKeySchema_wrapped({
+	config: { storageTier: "secure" },
 	key: "session",
 	schema: zod_mini.object({
 		captchaToken: zod_mini.nullable(zod_mini.string()),
@@ -668,10 +429,10 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 			logger: core.logger,
 			state: core.state,
 			storage: core.storage
-		}).catch(() => __logout_wrapped(client));
-		if (core.state.get().sessionKeys && !await core.keychain.hasKey("session")) await __logout_wrapped(client);
+		}).catch(() => require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "keychain-migration-failed" }, client));
+		if (core.state.get().sessionKeys && !await core.keychain.hasKey("session")) await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "keychain-key-missing" }, client);
 	}).then(async () => {
-		if (!core.state.get().projectSettings) await __fetchProjectSettings_wrapped(client);
+		if (!core.state.get().projectSettings) await require_getNetworkProviderFromNetworkId.__fetchProjectSettings_wrapped(client);
 	});
 	fetchProjectSettingsPromise.then(() => prefetchNoncesIfNeeded(client)).catch((error) => {
 		core.logger.error("Failed to prefetch nonces:", error);
@@ -705,7 +466,7 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 		if (require_InvalidParamError.isCookieEnabled(client)) await require_NotWaasWalletAccountError.__refreshAuth_wrapped(client).catch(async (error) => {
 			if (error.status === 401) {
 				core.logger.error("Session expired during initialization", error);
-				if (client.user) await __logout_wrapped(client);
+				if (client.user) await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "session-refresh-unauthorized" }, client);
 			} else throw error;
 		});
 	});
@@ -716,7 +477,7 @@ const initializeClient = async (client = require_InvalidParamError.getDefaultCli
 	*/
 	const refreshUserStateFromValidTokenPromise = refreshUserStateFromCookiePromise.then(async () => {
 		if (core.state.get().token && !core.state.get().user) await __refreshUser_wrapped(client).catch(async () => {
-			await __logout_wrapped(client);
+			await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "user-refresh-failed" }, client);
 		});
 	});
 	core.initTrack.track({
@@ -1206,7 +967,7 @@ const createCore = (config) => {
 	const passkey = config.coreConfig?.passkey ?? createWebPasskeyService();
 	const realtime = config.coreConfig?.realtime ?? require_getNetworkProviderFromNetworkId.__createRealtimeService_wrapped();
 	const deviceSigner = config.coreConfig?.deviceSigner;
-	const keychain = config.coreConfig?.keychain ?? require_getNetworkProviderFromNetworkId.__createIndexedDBKeychainService_wrapped({ dbName: `dynamic_${config.environmentId}_keychain` });
+	const keychain = config.coreConfig?.keychain ?? require_getNetworkProviderFromNetworkId.createKeychainService({ dbName: `dynamic_${config.environmentId}_keychain` });
 	return {
 		apiBaseUrl,
 		crossTabBroadcast: config.coreConfig?.crossTabBroadcast ?? require_getNetworkProviderFromNetworkId.__createCrossTabBroadcast_wrapped({ channelName: `dynamic_${config.environmentId}_broadcast` }),
@@ -1234,7 +995,8 @@ const createCore = (config) => {
 		state,
 		storage,
 		transformers: config.transformers,
-		version: require_InvalidParamError.version
+		version: require_InvalidParamError.version,
+		waas: config.waas
 	};
 };
 
@@ -1750,7 +1512,7 @@ const requestExternalAuthElevatedToken = async ({ externalJwt }, client = requir
 		environmentId: core.environmentId,
 		externalAuthSigninRequest: { jwt: externalJwt }
 	});
-	const parsedToken = require_getVerifiedCredentialForWalletAccount.parseElevatedAccessToken(response.elevatedAccessToken);
+	const parsedToken = require_getVerifiedCredentialForWalletAccount.parseElevatedAccessToken({ token: response.elevatedAccessToken });
 	if (parsedToken) {
 		const currentTokens = core.state.get().elevatedAccessTokens || [];
 		core.state.set({ elevatedAccessTokens: require_getVerifiedCredentialForWalletAccount.upsertElevatedAccessToken({
@@ -1785,7 +1547,6 @@ const __requestExternalAuthElevatedToken_wrapped = require_InvalidParamError.ins
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to the authentication response from the server.
 * @instrumented
-
 * @redact-params
 */
 const signInWithExternalJwt = async ({ externalJwt, sessionPublicKey } = {}, client = require_InvalidParamError.getDefaultClient()) => {
@@ -1814,6 +1575,25 @@ const __signInWithExternalJwt_wrapped = require_InvalidParamError.instrumentFunc
 	redactAll: true
 });
 
+//#endregion
+//#region src/modules/auth/logout/logout.ts
+/**
+* Logs out the current user and clears all authentication data.
+*
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise that resolves when the logout process is complete.
+* @not-instrumented
+*/
+const logout = async (client = require_InvalidParamError.getDefaultClient()) => {
+	/**
+	* Delegates to `logoutWithReason` with `'user-intent'` so telemetry correctly
+	* attributes the logout to an explicit user action. Instrumentation lives on
+	* `logoutWithReason` — this wrapper is intentionally not instrumented so that
+	* Datadog sees a single function name per logout regardless of entry point.
+	*/
+	return require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "user-intent" }, client);
+};
+
 //#endregion
 //#region src/modules/auth/passkeys/deletePasskey/deletePasskey.ts
 /**
@@ -2091,7 +1871,7 @@ const APPLE_RESPONSE_MODE = "form_post";
 const APPLE_RESPONSE_TYPE = "code id_token";
 /** Helper function to add OAuth URL parameters to a given base URL.  * @not-instrumented
 */
-const addOAuthUrlParams = (provider, baseUrl, options = {}) => {
+const addOAuthUrlParams = ({ baseUrl, isGoogleDriveBackupEnabled, provider }) => {
 	require_InvalidParamError.assertDefined(provider.clientId, "Client ID not found");
 	require_InvalidParamError.assertDefined(provider.provider, "Provider type not found");
 	require_InvalidParamError.assertDefined(provider.redirectUrl, "Redirect URL not found");
@@ -2105,7 +1885,7 @@ const addOAuthUrlParams = (provider, baseUrl, options = {}) => {
 	}
 	if (providerType === _dynamic_labs_sdk_api_core.ProviderEnum.Google) {
 		baseUrl.searchParams.set("access_type", "offline");
-		if (options.isGoogleDriveBackupEnabled) baseUrl.searchParams.set("prompt", "consent");
+		if (isGoogleDriveBackupEnabled) baseUrl.searchParams.set("prompt", "consent");
 	}
 	if (providerType === _dynamic_labs_sdk_api_core.ProviderEnum.Apple) {
 		baseUrl.searchParams.set("response_mode", APPLE_RESPONSE_MODE);
@@ -2147,7 +1927,11 @@ const buildOAuthUrl = async (core, provider) => {
 	const socialProvider = projectSettings.providers.find((p) => p.provider === provider);
 	require_InvalidParamError.assertDefined(socialProvider, `Social provider ${provider} not supported`);
 	const isGoogleDriveBackupEnabled = projectSettings.sdk.waas?.backupOptions?.includes(_dynamic_labs_sdk_api_core.WaasBackupOptionsEnum.GoogleDrive);
-	const socialProviderUrl = addOAuthUrlParams(socialProvider, getOAuthBaseUrl(socialProvider), { isGoogleDriveBackupEnabled });
+	const socialProviderUrl = addOAuthUrlParams({
+		baseUrl: getOAuthBaseUrl(socialProvider),
+		isGoogleDriveBackupEnabled,
+		provider: socialProvider
+	});
 	const usingPkce = providersRequiringPkce.includes(provider);
 	const state = require_InvalidParamError.randomString({ length: 32 });
 	const codeVerifier = require_InvalidParamError.randomString({ length: 43 });
@@ -2487,22 +2271,29 @@ const createCheckoutApiClient = async ({ transactionId }, client) => {
 //#endregion
 //#region src/modules/checkout/attachCheckoutTransactionSource/attachCheckoutTransactionSource.ts
 /**
-* Attaches a wallet source to a checkout transaction
+* Attaches a payment source to a checkout transaction.
+*
+* For exchange sources, the backend generates the buy URL and creates the
+* exchange source record. The response includes `exchangeSource.metadata.url`
+* which can be embedded in an iframe for the user to complete payment.
 *
 * @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
+* @returns The updated checkout transaction (with exchangeSource if sourceType is 'exchange')
 * @instrumented
 */
-const attachCheckoutTransactionSource = async ({ fromAddress, fromChainId, fromChainName, transactionId }, client = require_InvalidParamError.getDefaultClient()) => {
+const attachCheckoutTransactionSource = async (params, client = require_InvalidParamError.getDefaultClient()) => {
+	const { transactionId, sourceType = "wallet" } = params;
 	const { apiClient, environmentId, sessionToken } = await createCheckoutApiClient({ transactionId }, client);
+	const attachSourceRequest = { sourceType };
+	if (params.sourceType === "exchange") attachSourceRequest.exchangeProvider = params.exchangeProvider;
+	else {
+		attachSourceRequest.fromAddress = params.fromAddress;
+		attachSourceRequest.fromChainId = params.fromChainId;
+		attachSourceRequest.fromChainName = params.fromChainName;
+	}
 	return apiClient.attachSource({
-		attachSourceRequest: {
-			fromAddress,
-			fromChainId,
-			fromChainName,
-			sourceType: "wallet"
-		},
+		attachSourceRequest,
 		environmentId,
 		transactionId,
 		xDynamicCheckoutSessionToken: sessionToken
@@ -2524,9 +2315,13 @@ const __attachCheckoutTransactionSource_wrapped = require_InvalidParamError.inst
 //#endregion
 //#region src/modules/checkout/broadcastCheckoutTransaction/broadcastCheckoutTransaction.ts
 /**
-* Records the on-chain broadcast of a checkout transaction
+* Records that a checkout 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 transaction moves to `broadcasted`.
 *
-* @param params BroadcastCheckoutTransactionParams - The transaction ID and tx hash.
+* @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
 * @instrumented
@@ -2641,8 +2436,20 @@ const isTerminalEvent = (data) => {
 * @not-instrumented
 */
 const subscribeToCheckoutTransaction = async ({ transactionId }, client) => {
-	const { realtime } = require_InvalidParamError.getCore(client);
-	if (realtime.getConnectionState() === "idle") await realtime.connect({ client });
+	const core = require_InvalidParamError.getCore(client);
+	const { realtime } = core;
+	if (realtime.getConnectionState() === "idle") {
+		const sessionToken = await core.storage.getItem(createCheckoutSessionTokenStorageKey(transactionId));
+		const headers = {};
+		if (sessionToken) {
+			headers["x-dynamic-checkout-session-token"] = sessionToken;
+			headers["x-dynamic-checkout-transaction-id"] = transactionId;
+		}
+		await realtime.connect({
+			client,
+			headers
+		});
+	}
 	const channelSchema = createCheckoutTransactionChannelSchema(transactionId);
 	const handler = ({ data }) => {
 		if (data.axis === "execution") require_getVerifiedCredentialForWalletAccount.emitEvent({
@@ -2945,6 +2752,36 @@ const __submitCheckoutTransaction_wrapped = require_InvalidParamError.instrument
 	}
 });
 
+//#endregion
+//#region src/modules/checkout/trackCheckoutTransaction/trackCheckoutTransaction.ts
+/**
+* Subscribes to realtime `checkoutTransactionExecutionStateChanged` and
+* `checkoutTransactionSettlementStateChanged` events for an existing
+* checkout transaction.
+*
+* This is only needed after a page refresh to re-establish the subscription.
+* Transactions created with {@link createCheckoutTransaction} are automatically
+* subscribed — calling this again for those is unnecessary unless the page
+* has been reloaded.
+*
+* @param params.transactionId - The ID of the checkout transaction to track.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @instrumented
+*/
+const trackCheckoutTransaction = ({ transactionId }, client = require_InvalidParamError.getDefaultClient()) => subscribeToCheckoutTransaction({ transactionId }, client);
+const __trackCheckoutTransaction_impl = trackCheckoutTransaction;
+const __trackCheckoutTransaction_wrapped = require_InvalidParamError.instrumentFunction({
+	fn: __trackCheckoutTransaction_impl,
+	functionName: "trackCheckoutTransaction",
+	getCore: () => {
+		try {
+			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/checkout/utils/requiresConversion/requiresConversion.ts
 /**
@@ -2980,32 +2817,6 @@ const __requiresConversion_wrapped = require_InvalidParamError.instrumentFunctio
 	}
 });
 
-//#endregion
-//#region src/modules/checkout/trackCheckoutTransaction/trackCheckoutTransaction.ts
-/**
-* Subscribes to realtime state change events for an existing checkout transaction.
-*
-* Call this after a page refresh to resume receiving transaction events
-* for a transaction that was created in a previous page session.
-*
-* @param params.transactionId - The ID of the checkout transaction to track.
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @instrumented
-*/
-const trackCheckoutTransaction = ({ transactionId }, client = require_InvalidParamError.getDefaultClient()) => subscribeToCheckoutTransaction({ transactionId }, client);
-const __trackCheckoutTransaction_impl = trackCheckoutTransaction;
-const __trackCheckoutTransaction_wrapped = require_InvalidParamError.instrumentFunction({
-	fn: __trackCheckoutTransaction_impl,
-	functionName: "trackCheckoutTransaction",
-	getCore: () => {
-		try {
-			return require_InvalidParamError.getCore(require_InvalidParamError.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/deviceRegistration/completeDeviceRegistration/completeDeviceRegistration.ts
 const DEVICE_REGISTRATION_TOKEN_HEADER = "x-dynamic-device-registration-token";
@@ -3149,7 +2960,7 @@ const isDeviceRegistrationRequired = (user) => Boolean(user.scope?.includes("dev
 const revokeAllRegisteredDevices = async (client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
 	await require_InvalidParamError.__createApiClient_wrapped({}, client).deleteAllDeviceRegistrations({ environmentId: core.environmentId });
-	await __logout_wrapped(client);
+	await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "all-devices-revoked" }, client);
 };
 const __revokeAllRegisteredDevices_impl = revokeAllRegisteredDevices;
 const __revokeAllRegisteredDevices_wrapped = require_InvalidParamError.instrumentFunction({
@@ -3173,7 +2984,7 @@ const revokeRegisteredDevice = async ({ deviceRegistrationId }, client = require
 	if ((await require_InvalidParamError.__createApiClient_wrapped({}, client).deleteDeviceRegistration({
 		deviceRegistrationId,
 		environmentId: core.environmentId
-	})).currentDeviceRevoked) await __logout_wrapped(client);
+	})).currentDeviceRevoked) await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "device-revoked" }, client);
 };
 const __revokeRegisteredDevice_impl = revokeRegisteredDevice;
 const __revokeRegisteredDevice_wrapped = require_InvalidParamError.instrumentFunction({
@@ -3561,7 +3372,7 @@ const __waitForClientInitialized_wrapped = require_InvalidParamError.instrumentF
 * normally but emit no telemetry.
 * @instrumented
 */
-const setInstrumentationEnabled = (enabled, client = require_InvalidParamError.getDefaultClient()) => {
+const setInstrumentationEnabled = ({ enabled }, client = require_InvalidParamError.getDefaultClient()) => {
 	require_InvalidParamError.getCore(client).instrumentation.setEnabled(enabled);
 };
 const __setInstrumentationEnabled_impl = setInstrumentationEnabled;
@@ -3670,7 +3481,7 @@ const fetchLegacyWalletBook = async (client) => {
 	const core = require_InvalidParamError.getCore(client);
 	core.logger.debug("[fetchLegacyWalletBook] Fetching wallet book...");
 	try {
-		const walletBook = await retryOnFail({
+		const walletBook = await require_getNetworkProviderFromNetworkId.retryOnFail({
 			delay: RETRY_DELAY_MS,
 			fn: async () => fetchWithTimeout(client),
 			maxRetries: MAX_RETRIES
@@ -3712,12 +3523,10 @@ const EMBEDDED_WALLET_KEYS = [
 /**
 * Checks if a wallet should be filtered out from the WalletConnect catalog.
 *
-* @param walletKey - The wallet key identifier.
-* @param wallet - The wallet schema to check.
 * @returns True if the wallet should be filtered out, false otherwise.
 * @not-instrumented
 */
-const shouldFilterWallet = (walletKey, wallet) => {
+const shouldFilterWallet = ({ wallet, walletKey }) => {
 	if (EMBEDDED_WALLET_KEYS.includes(walletKey)) return true;
 	if (!wallet.walletConnect || !wallet.walletConnect.sdks.includes("sign_v2")) return true;
 	const hasInjectedConfig = wallet.injectedConfig && wallet.injectedConfig.length > 0;
@@ -3932,7 +3741,10 @@ const transformWalletBook = ({ walletBook }) => {
 	for (const [groupKey, group] of Object.entries(walletBook.groups)) groups[groupKey] = transformGroup({ group });
 	const wallets = {};
 	for (const [walletKey, wallet] of Object.entries(walletBook.wallets)) {
-		if (shouldFilterWallet(walletKey, wallet)) continue;
+		if (shouldFilterWallet({
+			wallet,
+			walletKey
+		})) continue;
 		wallets[walletKey] = transformWallet({
 			wallet,
 			walletKey
@@ -4044,7 +3856,6 @@ const __getWalletConnectCatalogWalletByWalletProviderKey_wrapped = require_Inval
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to OTP verification details if verification is required, or undefined.
 * @instrumented
-
 * @redact-params
 */
 const updateUser = async ({ userFields }, client = require_InvalidParamError.getDefaultClient()) => {
@@ -4559,7 +4370,6 @@ const __setDefaultMfaDevice_wrapped = require_InvalidParamError.instrumentFuncti
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to an OTPVerification object containing the email and verification UUID.
 * @instrumented
-
 * @redact-params
 */
 const sendEmailOTP = async ({ email }, client = require_InvalidParamError.getDefaultClient()) => {
@@ -5521,7 +5331,6 @@ const supportedCountries = {
 * @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
 * @returns A promise that resolves to an OTPVerification object containing the phone details and verification UUID.
 * @instrumented
-
 * @redact-params
 */
 const sendSmsOTP = async ({ isoCountryCode, phoneNumber }, client = require_InvalidParamError.getDefaultClient()) => {
@@ -5758,7 +5567,7 @@ const __getSwapStatus_wrapped = require_InvalidParamError.instrumentFunction({
 const deleteUser = async (client = require_InvalidParamError.getDefaultClient()) => {
 	const core = require_InvalidParamError.getCore(client);
 	await require_InvalidParamError.__createApiClient_wrapped({ includeMfaToken: true }, client).hardDeleteUser({ environmentId: core.environmentId });
-	await __logout_wrapped(client);
+	await require_getNetworkProviderFromNetworkId.__logoutWithReason_wrapped({ reason: "user-deleted" }, client);
 };
 const __deleteUser_impl = deleteUser;
 const __deleteUser_wrapped = require_InvalidParamError.instrumentFunction({
@@ -6062,7 +5871,13 @@ const __proveWalletAccountOwnership_wrapped = require_InvalidParamError.instrume
 //#endregion
 //#region src/modules/wallets/utils/isSameAddress/isSameAddress.ts
 /** @not-instrumented */
-const isSameAddress = (left, right, chain) => require_getVerifiedCredentialForWalletAccount.normalizeAddress(left, chain) === require_getVerifiedCredentialForWalletAccount.normalizeAddress(right, chain);
+const isSameAddress = ({ chain, left, right }) => require_getVerifiedCredentialForWalletAccount.normalizeAddress({
+	address: left,
+	chain
+}) === require_getVerifiedCredentialForWalletAccount.normalizeAddress({
+	address: right,
+	chain
+});
 
 //#endregion
 //#region src/modules/wallets/verifyWalletAccountForSignInOrTransfer/verifyWalletAccountForSignInOrTransfer.ts
@@ -6088,7 +5903,11 @@ const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfe
 		walletDisplayName: walletProvider.metadata.displayName,
 		walletProviderType: walletProvider.walletProviderType
 	}, client);
-	const walletVerifiedCredential = response.user?.verifiedCredentials.find((verifiedCredential) => isSameAddress(verifiedCredential.address ?? "", walletAccount.address, walletAccount.chain));
+	const walletVerifiedCredential = response.user?.verifiedCredentials.find((verifiedCredential) => isSameAddress({
+		chain: walletAccount.chain,
+		left: verifiedCredential.address ?? "",
+		right: walletAccount.address
+	}));
 	require_InvalidParamError.assertDefined(walletVerifiedCredential, `After verifying, still unable to find verified wallet credential for wallet account ${walletAccount.address} on chain ${walletAccount.chain}`);
 	require_getNetworkProviderFromNetworkId.__updateWalletProviderKeysForVerifiedCredentials_wrapped({ keysToUpdate: { [walletVerifiedCredential.id]: walletProvider.key } }, client);
 	/**
@@ -6100,7 +5919,11 @@ const verifyWalletAccountForSignInOrTransfer = async ({ walletAccount, isTransfe
 	* Remove the now verified wallet account from the unverified wallet accounts
 	*/
 	require_getNetworkProviderFromNetworkId.__removeUnverifiedWalletAccount_wrapped({ unverifiedWalletAccount: walletAccount }, client);
-	const verifiedWalletAccount = require_getVerifiedCredentialForWalletAccount.__getWalletAccounts_wrapped(client).find(({ address }) => isSameAddress(address, walletAccount.address, walletAccount.chain));
+	const verifiedWalletAccount = require_getVerifiedCredentialForWalletAccount.__getWalletAccounts_wrapped(client).find(({ address }) => isSameAddress({
+		chain: walletAccount.chain,
+		left: address,
+		right: walletAccount.address
+	}));
 	require_InvalidParamError.assertDefined(verifiedWalletAccount, `Unable to find wallet account ${walletAccount.address} on chain ${walletAccount.chain} for verified credential ${walletVerifiedCredential.id}`);
 	return verifiedWalletAccount;
 };
@@ -7048,7 +6871,7 @@ exports.deleteUser = __deleteUser_wrapped;
 exports.detectDeviceRegistrationRedirect = __detectDeviceRegistrationRedirect_wrapped;
 exports.detectOAuthRedirect = __detectOAuthRedirect_wrapped;
 exports.executeSwapTransaction = __executeSwapTransaction_wrapped;
-exports.fetchProjectSettings = __fetchProjectSettings_wrapped;
+exports.fetchProjectSettings = require_getNetworkProviderFromNetworkId.__fetchProjectSettings_wrapped;
 exports.getActiveNetworkData = __getActiveNetworkData_wrapped;
 exports.getActiveNetworkId = __getActiveNetworkId_wrapped;
 exports.getAvailableWalletProvidersData = __getAvailableWalletProvidersData_wrapped;
@@ -7094,11 +6917,11 @@ exports.isMfaRequiredForAction = require_isMfaRequiredForAction.isMfaRequiredFor
 exports.isMobile = isMobile;
 exports.isPendingRecoveryCodesAcknowledgment = isPendingRecoveryCodesAcknowledgment;
 exports.isProgrammaticNetworkSwitchAvailable = isProgrammaticNetworkSwitchAvailable;
-exports.isSignedIn = isSignedIn;
+exports.isSignedIn = require_getNetworkProviderFromNetworkId.isSignedIn;
 exports.isUserMissingMfaAuth = isUserMissingMfaAuth;
 exports.isUserOnboardingComplete = isUserOnboardingComplete;
 exports.isWalletAccountVerified = isWalletAccountVerified;
-exports.logout = __logout_wrapped;
+exports.logout = logout;
 exports.offEvent = require_getVerifiedCredentialForWalletAccount.__offEvent_wrapped;
 exports.offWalletProviderEvent = __offWalletProviderEvent_wrapped;
 exports.onEvent = require_getVerifiedCredentialForWalletAccount.__onEvent_wrapped;