@dynamic-labs-sdk/client 1.31.2 → 1.32.0

package/dist/index.cjs

@@ -1,10 +1,10 @@
-const require_logoutWithReason = require('./logoutWithReason-C_T7KddM.cjs');
-const require_migrateFromFireblocks = require('./migrateFromFireblocks-C9Kuke5V.cjs');
-const require_waas = require('./waas-Bxsd0-HG.cjs');
-const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-DueBnAl6.cjs');
-const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-Bx0HlvfW.cjs');
-const require_isUserOnboardingComplete = require('./isUserOnboardingComplete-7GzNYU2g.cjs');
-const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-DnKzPDZk.cjs');
+const require_logoutWithReason = require('./logoutWithReason-yDqQ0UIt.cjs');
+const require_migrateFromFireblocks = require('./migrateFromFireblocks-qYPrnWF8.cjs');
+const require_waas = require('./waas-WID2Fy_N.cjs');
+const require_getNetworkProviderFromNetworkId = require('./getNetworkProviderFromNetworkId-5UBZwUg2.cjs');
+const require_getVerifiedCredentialForWalletAccount = require('./getVerifiedCredentialForWalletAccount-BSxiaaVp.cjs');
+const require_isUserOnboardingComplete = require('./isUserOnboardingComplete-DtxIznZD.cjs');
+const require_isMfaRequiredForAction = require('./isMfaRequiredForAction-62zh3W-2.cjs');
 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");
@@ -1208,7 +1208,7 @@ const __createDynamicClient_wrapped = require_logoutWithReason.instrumentFunctio
 //#region src/errors/AmbiguousWalletChainError.ts
 /**
 * Thrown when a wallet can be connected on more than one of the client's
-* enabled chains and no chain was passed to `connectWallet`.
+* enabled chains and no chain was passed to `connectWalletOption`.
 *
 * Multi-chain wallets such as MetaMask or Phantom connect to a different
 * account per chain, so the chain has to be an explicit choice rather than one
@@ -1216,15 +1216,13 @@ const __createDynamicClient_wrapped = require_logoutWithReason.instrumentFunctio
 *
 * @example
 * ```ts
-* try {
-*   await connectWallet({ walletKey: 'phantom' });
-* } catch (error) {
-*   if (error instanceof AmbiguousWalletChainError) {
-*     await connectWallet({ chain: 'SOL', walletKey: 'phantom' });
-*   }
-* }
+* // Throws, since Phantom connects on both SOL and EVM
+* await connectWalletOption({ walletKey: 'phantom' });
+*
+* // Connects the wallet's Solana account
+* await connectWalletOption({ chain: 'SOL', walletKey: 'phantom' });
 * ```
-* @see connectWallet
+* @see connectWalletOption
 * @see getWalletOptionsCatalogue
 */
 var AmbiguousWalletChainError = class extends require_logoutWithReason.BaseError {
@@ -1402,6 +1400,48 @@ var CoinbaseTravelRuleRequiredError = class extends require_logoutWithReason.Bas
 	}
 };
 
+//#endregion
+//#region src/errors/ConnectionUriHandlerMissingError.ts
+/**
+* Thrown when the only connection path for a wallet is a URI pairing and no
+* `onConnectionUri` handler was passed to `connectWalletOption`.
+*
+* The pairing URI has to reach the user — as a QR code on desktop, or by opening
+* the wallet's deeplink on mobile — for the wallet to be able to
+* approve the connection.
+*
+* @example
+* ```ts
+* // Throws, since the wallet can only be reached through a URI pairing
+* await connectWalletOption({ walletKey: 'trust' });
+*
+* // Connects, once the user approves the pairing
+* await connectWalletOption({
+*   onConnectionUri: ({ uri }) => renderQrCode(uri),
+*   walletKey: 'trust',
+* });
+* ```
+* @see connectWalletOption
+* @see ConnectionUriHandlerParams
+*/
+var ConnectionUriHandlerMissingError = class extends require_logoutWithReason.BaseError {
+	constructor({ chain, type, walletKey }) {
+		super({
+			cause: null,
+			code: "connection_uri_handler_missing",
+			docsUrl: null,
+			metaMessages: [
+				`Wallet key: ${walletKey}`,
+				`Chain: ${chain}`,
+				`URI connection type: ${type}`,
+				"Pass onConnectionUri to render the pairing URI it hands you as a QR code, or to open it as a link on mobile."
+			],
+			name: "ConnectionUriHandlerMissingError",
+			shortMessage: `Connecting to ${walletKey} requires a URI pairing, so the onConnectionUri param is required.`
+		});
+	}
+};
+
 //#endregion
 //#region src/errors/DeeplinkConnectAndVerifyUnsupportedError.ts
 var DeeplinkConnectAndVerifyUnsupportedError = class extends require_logoutWithReason.BaseError {
@@ -1656,14 +1696,14 @@ var NoAddressFoundError = class extends require_logoutWithReason.BaseError {
 * @example
 * ```ts
 * try {
-*   await connectWallet({ walletKey: 'rainbow' });
+*   await connectWalletOption({ walletKey: 'rainbow' });
 * } catch (error) {
 *   if (error instanceof NoConnectionOptionAvailableError) {
 *     promptWalletInstall(error.installationUrls);
 *   }
 * }
 * ```
-* @see connectWallet
+* @see connectWalletOption
 * @see getWalletOptionsCatalogue
 */
 var NoConnectionOptionAvailableError = class extends require_logoutWithReason.BaseError {
@@ -1885,10 +1925,57 @@ var WalletAccountNotSelectedError = class extends require_logoutWithReason.BaseE
 	}
 };
 
+//#endregion
+//#region src/errors/WalletBrowserRedirectHandlerMissingError.ts
+/**
+* Thrown when the connection option resolved for a wallet is its in-app
+* browser, no `handleWalletBrowserRedirect` handler was passed to
+* `connectWalletOption`, and there is no current page URL to redirect into
+* that browser — as on React Native and during server-side rendering.
+*
+* That path connects by reloading your app inside the wallet's own browser,
+* so it needs the URL of the page to reload.
+*
+* @example
+* ```ts
+* // Throws on React Native, where there is no page URL to reuse
+* await connectWalletOption({ walletKey: 'coinbase' });
+*
+* // Connects, redirecting into the wallet's browser
+* await connectWalletOption({
+*   handleWalletBrowserRedirect: ({ chain, walletKey }) =>
+*     redirectToInAppBrowser({
+*       appUrl: 'https://mydapp.xyz/login',
+*       chain,
+*       walletKey,
+*     }),
+*   walletKey: 'coinbase',
+* });
+* ```
+* @see connectWalletOption
+* @see redirectToInAppBrowser
+*/
+var WalletBrowserRedirectHandlerMissingError = class extends require_logoutWithReason.BaseError {
+	constructor({ chain, walletKey }) {
+		super({
+			cause: null,
+			code: "wallet_browser_redirect_handler_missing",
+			docsUrl: null,
+			metaMessages: [
+				`Wallet key: ${walletKey}`,
+				`Chain: ${chain}`,
+				"Pass handleWalletBrowserRedirect and call redirectToInAppBrowser from it with the URL of the page to reload inside the wallet's browser."
+			],
+			name: "WalletBrowserRedirectHandlerMissingError",
+			shortMessage: `Connecting to ${walletKey} requires opening its in-app browser, so the handleWalletBrowserRedirect param is required where there is no page URL to redirect.`
+		});
+	}
+};
+
 //#endregion
 //#region src/errors/WalletOptionNotFoundError.ts
 /**
-* Thrown when `connectWallet` is given a wallet key that no wallet option in
+* Thrown when `connectWalletOption` is given a wallet key that no wallet option in
 * the catalogue matches.
 *
 * A wallet is only surfaced for the chains this client has an extension for, so
@@ -1898,14 +1985,14 @@ var WalletAccountNotSelectedError = class extends require_logoutWithReason.BaseE
 * @example
 * ```ts
 * try {
-*   await connectWallet({ walletKey: 'metmask' });
+*   await connectWalletOption({ walletKey: 'metmask' });
 * } catch (error) {
 *   if (error instanceof WalletOptionNotFoundError) {
 *     showUnknownWalletMessage();
 *   }
 * }
 * ```
-* @see connectWallet
+* @see connectWalletOption
 * @see getWalletOptionsCatalogue
 */
 var WalletOptionNotFoundError = class extends require_logoutWithReason.BaseError {
@@ -9075,6 +9162,457 @@ const __connectAndVerifyWithWalletProvider_wrapped = require_logoutWithReason.in
 	}
 });
 
+//#endregion
+//#region src/utils/appendConnectionUriToDeeplink/appendConnectionUriToDeeplink.ts
+/**
+* Appends a wallet connection URI to a deeplink URL.
+*
+* Generic across URI-deeplink connection options — works for both
+* WalletConnect pairing URIs and MetaMask SDK URIs. Determines the
+* appropriate query parameter separator based on whether the deeplink
+* already contains query parameters.
+*
+* @param params.deeplinkUrl - The base deeplink URL (e.g., `walletapp://wc` or `walletapp://wc?param=value`).
+* @param params.connectionUri - The connection URI to append.
+* @returns The deeplink URL with the connection URI appended as a query parameter.
+*
+* @example
+* ```ts
+* appendConnectionUriToDeeplink({ deeplinkUrl: 'walletapp://wc', connectionUri: 'wc:123-456' })
+* // Returns: 'walletapp://wc?uri=wc%3A123-456'
+*
+* appendConnectionUriToDeeplink({ deeplinkUrl: 'walletapp://wc?param=value', connectionUri: 'wc:123-456' })
+* // Returns: 'walletapp://wc?param=value&uri=wc%3A123-456'
+* ```
+* @notInstrumented
+*/
+const appendConnectionUriToDeeplink = ({ connectionUri, deeplinkUrl }) => {
+	const url = new URL(deeplinkUrl);
+	url.searchParams.set("uri", connectionUri);
+	return url.href;
+};
+
+//#endregion
+//#region src/utils/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts
+/**
+* Picks the most appropriate deep link variant for the current platform.
+*
+* Mobile (Android, iOS, tablets) prefers `native` because the OS treats
+* custom URL schemes as first-class app links and gives the wallet a faster
+* round-trip back to the dApp. Desktop prefers `universal` because browsers
+* cannot resolve mobile-only custom schemes and need an `https://` link
+* that opens the wallet's web flow.
+*
+* In either case, the alternative is used as a fallback when the preferred
+* variant is missing. Returns `undefined` only when both variants are
+* absent.
+*
+* @example
+* ```ts
+* const deepLink = getPreferredWalletDeepLink({
+*   deeplinks: wallet.deeplinks,
+* });
+* ```
+*
+* @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).
+* @returns The preferred deep link URL, or `undefined` if neither variant is available.
+* @see appendConnectionUriToDeeplink
+* @see getConnectionUriDeeplink
+* @notInstrumented
+*/
+const getPreferredWalletDeepLink = ({ deeplinks }) => {
+	const { native, universal } = deeplinks;
+	if (isMobile()) return native ?? universal;
+	return universal ?? native;
+};
+
+//#endregion
+//#region src/modules/wallets/connectWithUriConnectionOption/getConnectionUriDeeplink/getConnectionUriDeeplink.ts
+/**
+* Builds the single deeplink that hands a pairing URI to the wallet, picking
+* the shape the URI's protocol expects.
+*
+* A WalletConnect URI travels as the `uri` query parameter of the wallet's own
+* deeplink, whereas the MetaMask SDK mints a launch link that already targets
+* MetaMask, so it is handed over untouched.
+*
+* @example
+* ```ts
+* const deeplink = getConnectionUriDeeplink({
+*   deeplinks: connectionOption.deeplinks,
+*   type: connectionOption.type,
+*   uri,
+* });
+* ```
+*
+* @param params.deeplinks - The wallet's deeplink variants, as carried by the wallet book.
+* @param params.type - The URI connection type that minted the URI.
+* @param params.uri - The pairing URI.
+* @returns The deeplink to open, or `undefined` when the wallet publishes no deeplink to carry the URI.
+* @see getPreferredWalletDeepLink
+* @see appendConnectionUriToDeeplink
+* @notInstrumented
+*/
+const getConnectionUriDeeplink = ({ deeplinks, type, uri }) => {
+	if (type === "metamaskSdkUri") return uri;
+	const deeplinkUrl = getPreferredWalletDeepLink({ deeplinks });
+	if (!deeplinkUrl) return;
+	return appendConnectionUriToDeeplink({
+		connectionUri: uri,
+		deeplinkUrl
+	});
+};
+
+//#endregion
+//#region src/modules/wallets/connectWithUriConnectionOption/connectWithUriConnectionOption.ts
+/**
+* Connects to a wallet through a URI pairing and returns the connected wallet
+* account.
+*
+* Mints the pairing URI with the starter the chain extension registered for
+* the option's chain and URI type, hands it to `onConnectionUri` as the
+* wallet's deeplink carrying the pairing so the customer can render a QR code
+* or open the wallet app, then waits for the user to approve the pairing on
+* the wallet side.
+*
+* The handler is awaited, so an async handler that fails to open the wallet
+* rejects the connection rather than letting the pairing resolve into an
+* account nobody asked for.
+*
+* @example
+* ```ts
+* const walletAccount = await connectWithUriConnectionOption(
+*   {
+*     addToDynamicWalletAccounts: true,
+*     connectionOption,
+*     onConnectionUri: ({ uri }) => renderQrCode(uri),
+*     walletKey: 'trust',
+*   },
+*   client
+* );
+* ```
+*
+* @param params.addToDynamicWalletAccounts - Whether the connected wallet account should be added to the client's wallet accounts.
+* @param params.connectionOption - The URI deeplink connection option to drive.
+* @param params.onConnectionUri - Called with the pairing URI once it is minted. Awaited before the approval is waited on.
+* @param params.walletKey - The wallet being connected, keyed as in the wallet options catalogue.
+* @param client - The Dynamic client instance.
+* @returns A promise that resolves to the connected wallet account.
+* @throws ConnectionUriHandlerMissingError If no onConnectionUri handler was passed.
+* @throws NoConnectionOptionAvailableError If no URI connection starter is registered for the option's chain and type.
+* @throws NoAddressFoundError If the pairing was approved but no address was shared with your app.
+* @see getUriConnectionStarterRegistry
+* @see getWalletOptionsCatalogue
+* @notInstrumented
+*/
+const connectWithUriConnectionOption = async ({ addToDynamicWalletAccounts, connectionOption, onConnectionUri, walletKey }, client) => {
+	const { chain, deeplinks, type } = connectionOption;
+	if (!onConnectionUri) throw new ConnectionUriHandlerMissingError({
+		chain,
+		type,
+		walletKey
+	});
+	const starter = require_getNetworkProviderFromNetworkId.getUriConnectionStarterRegistry(client).get({
+		chain,
+		type
+	});
+	if (!starter) throw new NoConnectionOptionAvailableError({
+		chain,
+		walletKey
+	});
+	const { approval, uri } = await starter.start({ addToDynamicWalletAccounts });
+	const walletAccountsPromise = approval();
+	walletAccountsPromise.catch(() => void 0);
+	await onConnectionUri({ uri: getConnectionUriDeeplink({
+		deeplinks,
+		type,
+		uri
+	}) ?? uri });
+	const { walletAccounts } = await walletAccountsPromise;
+	const [walletAccount] = walletAccounts;
+	if (!walletAccount) throw new NoAddressFoundError();
+	return walletAccount;
+};
+
+//#endregion
+//#region src/utils/buildInAppBrowserUrl/buildInAppBrowserUrl.ts
+/**
+* Placeholder the wallet book leaves in in-app-browser URLs for the app URL
+* the wallet should open.
+*/
+const DAPP_URL_PLACEHOLDER = "{{encodedDappURI}}";
+/**
+* Fills a wallet's in-app-browser URL template with the app URL to open.
+*
+* Wallet book entries carry the entry point as a template (e.g.
+* `https://go.base.app/dapp?cb_url={{encodedDappURI}}`), so the URL is only
+* usable once every occurrence of the placeholder is substituted in,
+* percent-encoded. Templates without the placeholder are returned untouched —
+* some wallets open a fixed landing page.
+*
+* @example
+* ```ts
+* buildInAppBrowserUrl({
+*   appUrl: 'https://myapp.xyz/login',
+*   inAppBrowserUrl: 'https://go.base.app/dapp?cb_url={{encodedDappURI}}',
+* });
+* // Returns: 'https://go.base.app/dapp?cb_url=https%3A%2F%2Fmyapp.xyz%2Flogin'
+* ```
+*
+* @param params.appUrl - The URL of your app for the wallet's browser to open.
+* @param params.inAppBrowserUrl - The wallet's in-app-browser URL template.
+* @returns The in-app-browser URL to open.
+* @see redirectToInAppBrowser
+* @see getWalletOptionsCatalogue
+* @notInstrumented
+*/
+const buildInAppBrowserUrl = ({ appUrl, inAppBrowserUrl }) => inAppBrowserUrl.replaceAll(DAPP_URL_PLACEHOLDER, encodeURIComponent(appUrl));
+
+//#endregion
+//#region src/modules/wallets/redirectToInAppBrowser/redirectToInAppBrowser.ts
+/**
+* Leaves your app for a wallet's in-app browser, which reloads `appUrl`
+* inside it.
+*
+* Call this from `handleWalletBrowserRedirect` with the URL of the page the
+* wallet should reload. The wallet's in-app-browser entry point is read from
+* the wallet options catalogue, so you only need the wallet's key. The wallet
+* is only injected on that reload, so the connection is made on the next page
+* load rather than in the current one.
+*
+* @example
+* ```ts
+* await connectWalletOption({
+*   handleWalletBrowserRedirect: ({ chain, walletKey }) =>
+*     redirectToInAppBrowser({ appUrl: window.location.href, chain, walletKey }),
+*   walletKey: 'coinbase',
+* });
+* ```
+*
+* @param params.appUrl - The URL of your app for the wallet's browser to open.
+* @param params.walletKey - The wallet to open, keyed as in the wallet options catalogue.
+* @param [params.chain] - The chain to open the wallet's browser for. Required only when the wallet exposes an in-app browser on more than one enabled chain.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise that resolves once the redirect is triggered.
+* @throws WalletOptionNotFoundError If no wallet option matches the key.
+* @throws NoConnectionOptionAvailableError If the wallet exposes no in-app browser on the requested chain.
+* @throws AmbiguousWalletChainError If the wallet exposes an in-app browser on more than one chain and no chain was passed.
+* @throws UnsafeDeeplinkUrlError If the wallet's in-app-browser URL has a scheme that can execute script.
+* @see connectWalletOption
+* @see WalletBrowserRedirectHandlerParams
+* @instrumented
+*/
+const redirectToInAppBrowser = async ({ appUrl, chain, walletKey }, client = require_logoutWithReason.getDefaultClient()) => {
+	const walletOption = (await getWalletOptionsCatalogue({ includeMobileOptions: true }, client)).find(({ key }) => key === walletKey);
+	if (!walletOption) throw new WalletOptionNotFoundError({ walletKey });
+	const inAppBrowserOptions = walletOption.connectionOptions.filter((option) => option.type === "inAppBrowser" && (!chain || option.chain === chain));
+	if (inAppBrowserOptions.length === 0) throw new NoConnectionOptionAvailableError({
+		chain,
+		installationUrls: walletOption.installationUrls,
+		walletKey
+	});
+	const availableChains = [...new Set(inAppBrowserOptions.map((option) => option.chain))];
+	if (!chain && availableChains.length > 1) throw new AmbiguousWalletChainError({
+		chains: availableChains,
+		walletKey
+	});
+	const [inAppBrowserOption] = inAppBrowserOptions;
+	const urlToOpen = buildInAppBrowserUrl({
+		appUrl,
+		inAppBrowserUrl: inAppBrowserOption.url
+	});
+	require_getNetworkProviderFromNetworkId.assertSafeDeeplinkUrl(urlToOpen);
+	await require_logoutWithReason.getCore(client).openDeeplink(urlToOpen);
+};
+const __redirectToInAppBrowser_impl = redirectToInAppBrowser;
+const __redirectToInAppBrowser_wrapped = require_logoutWithReason.instrumentFunction({
+	fn: __redirectToInAppBrowser_impl,
+	functionName: "redirectToInAppBrowser",
+	getCore: () => {
+		try {
+			return require_logoutWithReason.getCore(require_logoutWithReason.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
+//#endregion
+//#region src/modules/wallets/resolveWalletConnectionOption/resolveWalletConnectionOption.ts
+/**
+* Picks the connection option `connectWalletOption` should drive for a wallet.
+*
+* Reads the wallet options catalogue, keeps the options this client can
+* actually drive — a registered wallet provider, an in-app-browser entry, or
+* a URI pairing whose starter a chain extension has registered — and returns
+* the best one by the catalogue's ordering.
+*
+* @example
+* ```ts
+* const connectionOption = await resolveWalletConnectionOption(
+*   { walletKey: 'metamask' },
+*   client
+* );
+* ```
+*
+* @param params.walletKey - The wallet to connect, keyed as in the wallet options catalogue.
+* @param [params.chain] - The chain to connect on. Required only when the wallet resolves on more than one enabled chain.
+* @param client - The Dynamic client instance.
+* @returns A promise that resolves to the connection option to drive.
+* @throws WalletOptionNotFoundError If no wallet option matches the key.
+* @throws AmbiguousWalletChainError If the wallet resolves on more than one chain and no chain was passed.
+* @throws NoConnectionOptionAvailableError If the wallet has no connection option this client can drive on the requested chain.
+* @see connectWalletOption
+* @see getWalletOptionsCatalogue
+* @notInstrumented
+*/
+const resolveWalletConnectionOption = async ({ walletKey, chain }, client) => {
+	const walletOption = (await getWalletOptionsCatalogue({ includeMobileOptions: true }, client)).find(({ key }) => key === walletKey);
+	if (!walletOption) throw new WalletOptionNotFoundError({ walletKey });
+	const uriConnectionStarterRegistry = require_getNetworkProviderFromNetworkId.getUriConnectionStarterRegistry(client);
+	const availableOptions = walletOption.connectionOptions.filter((option) => !chain || option.chain === chain).filter((option) => {
+		if (option.type !== "walletConnect" && option.type !== "metamaskSdkUri") return true;
+		const starter = uriConnectionStarterRegistry.get({
+			chain: option.chain,
+			type: option.type
+		});
+		return Boolean(starter);
+	});
+	if (availableOptions.length === 0) throw new NoConnectionOptionAvailableError({
+		chain,
+		installationUrls: walletOption.installationUrls,
+		walletKey
+	});
+	const availableChains = [...new Set(availableOptions.map((option) => option.chain))];
+	if (!chain && availableChains.length > 1) throw new AmbiguousWalletChainError({
+		chains: availableChains,
+		walletKey
+	});
+	const [connectionOption] = availableOptions;
+	return connectionOption;
+};
+
+//#endregion
+//#region src/utils/getCurrentPageUrl/getCurrentPageUrl.ts
+/**
+* Returns the URL of the page the app is running in.
+*
+* @example
+* ```ts
+* const appUrl = getCurrentPageUrl() ?? 'https://mydapp.xyz';
+* ```
+*
+* @returns The current page URL, or null where there is no page to read it from, such as on React Native and during server-side rendering.
+* @see isServerSideRendering
+* @see redirectToInAppBrowser
+* @notInstrumented
+*/
+const getCurrentPageUrl = () => {
+	if (typeof window === "undefined") return null;
+	const href = window.location?.href;
+	if (typeof href !== "string") return null;
+	return href;
+};
+
+//#endregion
+//#region src/highLevelFunctions/connectWalletOption/connectWalletOption.ts
+/**
+* Connects to an external wallet by its wallet options catalogue key and
+* returns the connected wallet account.
+*
+* Picks the connection path for the wallet so the customer does not have to:
+* a registered wallet provider when the user has the wallet installed,
+* otherwise a URI pairing (WalletConnect or the MetaMask SDK), with the
+* pairing URI handed to `onConnectionUri` while the returned promise waits for
+* the user to approve on the wallet side.
+*
+* Wallets that can only be reached through their own in-app browser — no
+* extension, no URI pairing — resolve to a redirect instead: the wallet and
+* chain are handed to `handleWalletBrowserRedirect`, which leaves for that
+* browser with `redirectToInAppBrowser`. Without that handler, the current
+* page is redirected into the wallet's browser directly, so the handler is
+* only needed to pick a different page to come back to, or where there is no
+* page URL to reuse (React Native, server-side rendering). The returned
+* promise never settles either way, since the connection completes on the
+* next page load inside the wallet's browser.
+*
+* Note: This function does not verify the wallet account — use
+* `verifyWalletAccount` afterwards to link it to the user.
+*
+* @example
+* ```ts
+* const walletAccount = await connectWalletOption({
+*   handleWalletBrowserRedirect: ({ chain, walletKey }) =>
+*     redirectToInAppBrowser({ appUrl: 'https://mydapp.xyz', chain, walletKey }),
+*   onConnectionUri: ({ uri }) => renderQrCode(uri),
+*   walletKey: 'metamask',
+* });
+* console.log(walletAccount.address);
+* ```
+*
+* @param params.walletKey - The wallet to connect, keyed as in the wallet options catalogue (e.g. 'metamask', 'phantom').
+* @param [params.chain] - The chain to connect on. Required only when the wallet resolves on more than one enabled chain.
+* @param [params.onConnectionUri] - Called with the pairing URI when the connection runs through a URI pairing.
+* @param [params.handleWalletBrowserRedirect] - Called with the wallet and chain when the wallet can only be connected through its own in-app browser. Defaults to redirecting the current page into that browser.
+* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
+* @returns A promise that resolves to the connected wallet account, or that never settles on the in-app-browser path.
+* @throws WalletOptionNotFoundError If no wallet option matches the key.
+* @throws AmbiguousWalletChainError If the wallet resolves on more than one chain and no chain was passed.
+* @throws NoConnectionOptionAvailableError If the wallet has no connection option this client can drive on the requested chain.
+* @throws ConnectionUriHandlerMissingError If the wallet resolves to a URI pairing and no onConnectionUri handler was passed.
+* @throws WalletBrowserRedirectHandlerMissingError If the wallet resolves to its in-app browser, no handleWalletBrowserRedirect handler was passed, and there is no current page URL to redirect.
+* @throws UnsafeDeeplinkUrlError If the wallet's in-app-browser URL has a scheme that can execute script.
+* @see verifyWalletAccount
+* @see redirectToInAppBrowser
+* @see getWalletOptionsCatalogue
+* @instrumented
+*/
+const connectWalletOption = async ({ walletKey, chain, handleWalletBrowserRedirect, onConnectionUri }, client = require_logoutWithReason.getDefaultClient()) => {
+	const connectionOption = await resolveWalletConnectionOption({
+		chain,
+		walletKey
+	}, client);
+	if (connectionOption.type === "withWalletProvider") return __connectWithWalletProvider_wrapped({ walletProviderKey: connectionOption.walletProviderKey }, client);
+	if (connectionOption.type === "inAppBrowser") {
+		const { chain: inAppBrowserChain } = connectionOption;
+		if (handleWalletBrowserRedirect) handleWalletBrowserRedirect({
+			chain: inAppBrowserChain,
+			walletKey
+		});
+		else {
+			const currentPageUrl = getCurrentPageUrl();
+			if (!currentPageUrl) throw new WalletBrowserRedirectHandlerMissingError({
+				chain: inAppBrowserChain,
+				walletKey
+			});
+			await __redirectToInAppBrowser_wrapped({
+				appUrl: currentPageUrl,
+				chain: inAppBrowserChain,
+				walletKey
+			}, client);
+		}
+		return new Promise(() => void 0);
+	}
+	return connectWithUriConnectionOption({
+		addToDynamicWalletAccounts: true,
+		connectionOption,
+		onConnectionUri,
+		walletKey
+	}, client);
+};
+const __connectWalletOption_impl = connectWalletOption;
+const __connectWalletOption_wrapped = require_logoutWithReason.instrumentFunction({
+	fn: __connectWalletOption_impl,
+	functionName: "connectWalletOption",
+	getCore: () => {
+		try {
+			return require_logoutWithReason.getCore(require_logoutWithReason.getDefaultClient());
+		} catch {
+			return;
+		}
+	}
+});
+
 //#endregion
 //#region src/modules/wallets/getAvailableWalletProvidersData/getAvailableWalletProvidersData.ts
 /**
@@ -9672,109 +10210,6 @@ const __selectPrimaryWalletAccount_wrapped = require_logoutWithReason.instrument
 	}
 });
 
-//#endregion
-//#region src/utils/buildInAppBrowserUrl/buildInAppBrowserUrl.ts
-/**
-* Placeholder the wallet book leaves in in-app-browser URLs for the app URL
-* the wallet should open.
-*/
-const DAPP_URL_PLACEHOLDER = "{{encodedDappURI}}";
-/**
-* Fills a wallet's in-app-browser URL template with the app URL to open.
-*
-* Wallet book entries carry the entry point as a template (e.g.
-* `https://go.base.app/dapp?cb_url={{encodedDappURI}}`), so the URL is only
-* usable once every occurrence of the placeholder is substituted in,
-* percent-encoded. Templates without the placeholder are returned untouched —
-* some wallets open a fixed landing page.
-*
-* @example
-* ```ts
-* buildInAppBrowserUrl({
-*   appUrl: 'https://myapp.xyz/login',
-*   inAppBrowserUrl: 'https://go.base.app/dapp?cb_url={{encodedDappURI}}',
-* });
-* // Returns: 'https://go.base.app/dapp?cb_url=https%3A%2F%2Fmyapp.xyz%2Flogin'
-* ```
-*
-* @param params.appUrl - The URL of your app for the wallet's browser to open.
-* @param params.inAppBrowserUrl - The wallet's in-app-browser URL template.
-* @returns The in-app-browser URL to open.
-* @see redirectToInAppBrowser
-* @see getWalletOptionsCatalogue
-* @notInstrumented
-*/
-const buildInAppBrowserUrl = ({ appUrl, inAppBrowserUrl }) => inAppBrowserUrl.replaceAll(DAPP_URL_PLACEHOLDER, encodeURIComponent(appUrl));
-
-//#endregion
-//#region src/modules/wallets/redirectToInAppBrowser/redirectToInAppBrowser.ts
-/**
-* Leaves your app for a wallet's in-app browser, which reloads `appUrl`
-* inside it.
-*
-* Call this from `handleWalletBrowserRedirect` with the URL of the page the
-* wallet should reload. The wallet's in-app-browser entry point is read from
-* the wallet options catalogue, so you only need the wallet's key. The wallet
-* is only injected on that reload, so the connection is made on the next page
-* load rather than in the current one.
-*
-* @example
-* ```ts
-* await connectWallet({
-*   handleWalletBrowserRedirect: ({ chain, walletKey }) =>
-*     redirectToInAppBrowser({ appUrl: window.location.href, chain, walletKey }),
-*   walletKey: 'coinbase',
-* });
-* ```
-*
-* @param params.appUrl - The URL of your app for the wallet's browser to open.
-* @param params.walletKey - The wallet to open, keyed as in the wallet options catalogue.
-* @param [params.chain] - The chain to open the wallet's browser for. Required only when the wallet exposes an in-app browser on more than one enabled chain.
-* @param [client] - The Dynamic client instance. Only required when using multiple Dynamic clients.
-* @returns A promise that resolves once the redirect is triggered.
-* @throws WalletOptionNotFoundError If no wallet option matches the key.
-* @throws NoConnectionOptionAvailableError If the wallet exposes no in-app browser on the requested chain.
-* @throws AmbiguousWalletChainError If the wallet exposes an in-app browser on more than one chain and no chain was passed.
-* @throws UnsafeDeeplinkUrlError If the wallet's in-app-browser URL has a scheme that can execute script.
-* @see connectWallet
-* @see WalletBrowserRedirectHandlerParams
-* @instrumented
-*/
-const redirectToInAppBrowser = async ({ appUrl, chain, walletKey }, client = require_logoutWithReason.getDefaultClient()) => {
-	const walletOption = (await getWalletOptionsCatalogue({ includeMobileOptions: true }, client)).find(({ key }) => key === walletKey);
-	if (!walletOption) throw new WalletOptionNotFoundError({ walletKey });
-	const inAppBrowserOptions = walletOption.connectionOptions.filter((option) => option.type === "inAppBrowser" && (!chain || option.chain === chain));
-	if (inAppBrowserOptions.length === 0) throw new NoConnectionOptionAvailableError({
-		chain,
-		installationUrls: walletOption.installationUrls,
-		walletKey
-	});
-	const availableChains = [...new Set(inAppBrowserOptions.map((option) => option.chain))];
-	if (!chain && availableChains.length > 1) throw new AmbiguousWalletChainError({
-		chains: availableChains,
-		walletKey
-	});
-	const [inAppBrowserOption] = inAppBrowserOptions;
-	const urlToOpen = buildInAppBrowserUrl({
-		appUrl,
-		inAppBrowserUrl: inAppBrowserOption.url
-	});
-	require_getNetworkProviderFromNetworkId.assertSafeDeeplinkUrl(urlToOpen);
-	await require_logoutWithReason.getCore(client).openDeeplink(urlToOpen);
-};
-const __redirectToInAppBrowser_impl = redirectToInAppBrowser;
-const __redirectToInAppBrowser_wrapped = require_logoutWithReason.instrumentFunction({
-	fn: __redirectToInAppBrowser_impl,
-	functionName: "redirectToInAppBrowser",
-	getCore: () => {
-		try {
-			return require_logoutWithReason.getCore(require_logoutWithReason.getDefaultClient());
-		} catch {
-			return;
-		}
-	}
-});
-
 //#endregion
 //#region src/modules/wallets/disconnectWalletAccount/disconnectWalletAccount.ts
 /**
@@ -10376,70 +10811,6 @@ const __withdrawFromYieldVault_wrapped = require_logoutWithReason.instrumentFunc
 	}
 });
 
-//#endregion
-//#region src/utils/appendConnectionUriToDeeplink/appendConnectionUriToDeeplink.ts
-/**
-* Appends a wallet connection URI to a deeplink URL.
-*
-* Generic across URI-deeplink connection options — works for both
-* WalletConnect pairing URIs and MetaMask SDK URIs. Determines the
-* appropriate query parameter separator based on whether the deeplink
-* already contains query parameters.
-*
-* @param params.deeplinkUrl - The base deeplink URL (e.g., `walletapp://wc` or `walletapp://wc?param=value`).
-* @param params.connectionUri - The connection URI to append.
-* @returns The deeplink URL with the connection URI appended as a query parameter.
-*
-* @example
-* ```ts
-* appendConnectionUriToDeeplink({ deeplinkUrl: 'walletapp://wc', connectionUri: 'wc:123-456' })
-* // Returns: 'walletapp://wc?uri=wc%3A123-456'
-*
-* appendConnectionUriToDeeplink({ deeplinkUrl: 'walletapp://wc?param=value', connectionUri: 'wc:123-456' })
-* // Returns: 'walletapp://wc?param=value&uri=wc%3A123-456'
-* ```
-* @notInstrumented
-*/
-const appendConnectionUriToDeeplink = ({ connectionUri, deeplinkUrl }) => {
-	const url = new URL(deeplinkUrl);
-	url.searchParams.set("uri", connectionUri);
-	return url.href;
-};
-
-//#endregion
-//#region src/utils/getPreferredWalletDeepLink/getPreferredWalletDeepLink.ts
-/**
-* Picks the most appropriate deep link variant for the current platform.
-*
-* Mobile (Android, iOS, tablets) prefers `native` because the OS treats
-* custom URL schemes as first-class app links and gives the wallet a faster
-* round-trip back to the dApp. Desktop prefers `universal` because browsers
-* cannot resolve mobile-only custom schemes and need an `https://` link
-* that opens the wallet's web flow.
-*
-* In either case, the alternative is used as a fallback when the preferred
-* variant is missing. Returns `undefined` only when both variants are
-* absent.
-*
-* @example
-* ```ts
-* const deepLink = getPreferredWalletDeepLink({
-*   deeplinks: wallet.deeplinks,
-* });
-* ```
-*
-* @param params.deeplinks - The deep link variants for a wallet (typically `WalletConnectCatalogWallet.deeplinks`).
-* @returns The preferred deep link URL, or `undefined` if neither variant is available.
-* @see appendConnectionUriToDeeplink
-* @see getConnectionUriDeeplink
-* @notInstrumented
-*/
-const getPreferredWalletDeepLink = ({ deeplinks }) => {
-	const { native, universal } = deeplinks;
-	if (isMobile()) return native ?? universal;
-	return universal ?? native;
-};
-
 //#endregion
 //#region src/utils/parseUserAgent/parseUserAgent.ts
 const browserMatchers = [
@@ -10533,6 +10904,7 @@ exports.CoinbaseTransferMfaFailedError = CoinbaseTransferMfaFailedError;
 exports.CoinbaseTransferMfaRequiredError = CoinbaseTransferMfaRequiredError;
 exports.CoinbaseTravelRuleFieldName = CoinbaseTravelRuleFieldName;
 exports.CoinbaseTravelRuleRequiredError = CoinbaseTravelRuleRequiredError;
+exports.ConnectionUriHandlerMissingError = ConnectionUriHandlerMissingError;
 exports.DeeplinkConnectAndVerifyUnsupportedError = DeeplinkConnectAndVerifyUnsupportedError;
 exports.DeviceRegistrationIdentityMismatchError = DeviceRegistrationIdentityMismatchError;
 exports.FeeEstimationFailedError = FeeEstimationFailedError;
@@ -10582,6 +10954,7 @@ exports.WaasRbacStaleRetryUnsafeError = require_isUserOnboardingComplete.WaasRba
 exports.WalletAccountAlreadyVerifiedError = WalletAccountAlreadyVerifiedError;
 exports.WalletAccountNotSelectedError = WalletAccountNotSelectedError;
 exports.WalletAlreadyLinkedToAnotherUserError = require_getNetworkProviderFromNetworkId.WalletAlreadyLinkedToAnotherUserError;
+exports.WalletBrowserRedirectHandlerMissingError = WalletBrowserRedirectHandlerMissingError;
 exports.WalletOptionNotFoundError = WalletOptionNotFoundError;
 exports.WalletProviderMethodUnavailableError = WalletProviderMethodUnavailableError;
 exports.WalletScreeningBlockedError = require_getNetworkProviderFromNetworkId.WalletScreeningBlockedError;
@@ -10612,6 +10985,7 @@ exports.completeSocialAuthentication = __completeSocialAuthentication_wrapped;
 exports.completeSocialRedirect = __completeSocialRedirect_wrapped;
 exports.confirmTransaction = __confirmTransaction_wrapped;
 exports.connectAndVerifyWithWalletProvider = __connectAndVerifyWithWalletProvider_wrapped;
+exports.connectWalletOption = __connectWalletOption_wrapped;
 exports.connectWithWalletProvider = __connectWithWalletProvider_wrapped;
 exports.consumeMfaToken = require_isMfaRequiredForAction.__consumeMfaToken_wrapped;
 exports.createCheckoutTransaction = __createCheckoutTransaction_wrapped;